From 6cc7b341d2c594d07409027e6f663a035f634aaa Mon Sep 17 00:00:00 2001 From: SevenEarth <391613297@qq.com> Date: Tue, 23 Sep 2025 11:16:29 +0800 Subject: [PATCH 1/2] add --- go.mod | 2 +- go.sum | 2 + .../cdb/resource_tc_mysql_instance.go | 316 ++ .../cdb/resource_tc_mysql_instance.md | 49 + .../cdb/service_tencentcloud_mysql.go | 55 +- .../tencentcloud/cdb/v20170320/client.go | 1470 +++++-- .../tencentcloud/cdb/v20170320/errors.go | 17 +- .../tencentcloud/cdb/v20170320/models.go | 3368 ++++++++++++----- vendor/modules.txt | 2 +- website/docs/r/mysql_instance.html.markdown | 66 + .../r/mysql_readonly_instance.html.markdown | 17 + 11 files changed, 4039 insertions(+), 1325 deletions(-) diff --git a/go.mod b/go.mod index 1a15513f38..b966030bbe 100644 --- a/go.mod +++ b/go.mod @@ -35,7 +35,7 @@ require ( github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cam v1.0.1071 github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cat v1.0.825 github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cbs v1.1.0 - github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cdb v1.0.944 + github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cdb v1.1.27 github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cdn v1.0.1010 github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cdwch v1.1.7 github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cfs v1.0.627 diff --git a/go.sum b/go.sum index bec9f3c3cf..82cce2ecae 100644 --- a/go.sum +++ b/go.sum @@ -841,6 +841,8 @@ github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cbs v1.1.0 h1:XhA8+gNAk github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cbs v1.1.0/go.mod h1:fxQECHc6BhgubNmnBFMohy2GNdbPvL5nrToQS3zdC8s= github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cdb v1.0.944 h1:+PGoNHlZE/WY6KWWNOByL0sYVv1ZJtSx7yXMUJNYV1Y= github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cdb v1.0.944/go.mod h1:+VHcZ4Cnzpt6vtCvNROz8xWfNWUkoAZ9UPSonbA3NWM= +github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cdb v1.1.27 h1:WcOPanoXwPwLf0DW7HcPL0vWBBRvZzh44sOF14rksr0= +github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cdb v1.1.27/go.mod h1:lljFAiBuUusv/K6wzLs1HMVLGJ8lBncCIfOPQKBpo6I= github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cdc v1.0.1149 h1:lW1auC8TdFa4NkE6ORzslUrP3lcGigdd0X8/4T+pY40= github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cdc v1.0.1149/go.mod h1:LDcZtoh9sKi/2/Tze53H64C4G3CzzHN22AWsflf3Cn4= github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cdn v1.0.1010 h1:sO0vW6E09xFQ5+I8mfvAyIlRZvWBWPf6ilZU5LI4lmE= diff --git a/tencentcloud/services/cdb/resource_tc_mysql_instance.go b/tencentcloud/services/cdb/resource_tc_mysql_instance.go index 2de27509f7..8c7c16090b 100644 --- a/tencentcloud/services/cdb/resource_tc_mysql_instance.go +++ b/tencentcloud/services/cdb/resource_tc_mysql_instance.go @@ -179,6 +179,64 @@ func TencentMsyqlBasicInfo() map[string]*schema.Schema { Optional: true, Description: "Switch the method of accessing new instances, default is `0`. Supported values include: `0` - switch immediately, `1` - switch in time window.", }, + "cluster_topology": { + Type: schema.TypeList, + Optional: true, + MaxItems: 1, + Description: "Cluster Edition node topology configuration. Note: If you purchased a cluster edition instance, this parameter is required. You need to set the RW and RO node topology of the cluster edition instance. The RO node range is 1-5. Please set at least 1 RO node.", + Elem: &schema.Resource{ + Schema: map[string]*schema.Schema{ + "read_write_node": { + Type: schema.TypeList, + Optional: true, + MaxItems: 1, + Description: "RW Node Topology.", + Elem: &schema.Resource{ + Schema: map[string]*schema.Schema{ + "zone": { + Type: schema.TypeString, + Required: true, + Description: "The availability zone where the RW node is located.", + }, + "node_id": { + Type: schema.TypeString, + Optional: true, + Computed: true, + Description: "When upgrading a cluster instance, if you want to adjust the availability zone of a read-only node, you need to specify the node ID.", + }, + }, + }, + }, + "read_only_nodes": { + Type: schema.TypeSet, + Optional: true, + Description: "RO Node Topology.", + Elem: &schema.Resource{ + Schema: map[string]*schema.Schema{ + "is_random_zone": { + Type: schema.TypeBool, + Optional: true, + Computed: true, + Description: "Whether to distribute in random availability zones. Enter `true` to specify a random availability zone. Otherwise, use the availability zone specified by Zone.", + }, + "zone": { + Type: schema.TypeString, + Optional: true, + Computed: true, + Description: "Specifies the availability zone where the node is distributed.", + }, + "node_id": { + Type: schema.TypeString, + Optional: true, + Computed: true, + Description: "When upgrading a cluster instance, if you want to adjust the availability zone of a read-only node, you need to specify the node ID.", + }, + }, + }, + }, + }, + }, + }, // Computed values "intranet_ip": { Type: schema.TypeString, @@ -560,6 +618,64 @@ func mysqlMasterInstanceRoleSet(ctx context.Context, requestInter interface{}, d } else { requestByUse.ProtectMode = &slaveSyncMode } + + if v, ok := d.GetOk("cluster_topology"); ok { + clusterTopologyList := v.([]interface{}) + if len(clusterTopologyList) > 0 { + clusterTopology := clusterTopologyList[0].(map[string]interface{}) + tmpObj := cdb.ClusterTopology{} + if readWriteNodeList, ok := clusterTopology["read_write_node"].([]interface{}); ok { + if len(readWriteNodeList) > 0 { + item := readWriteNodeList[0].(map[string]interface{}) + readWriteNode := cdb.ReadWriteNode{} + if item["zone"] != nil && item["zone"].(string) != "" { + readWriteNode.Zone = helper.String(item["zone"].(string)) + } + + if item["node_id"] != nil && item["node_id"].(string) != "" { + readWriteNode.NodeId = helper.String(item["node_id"].(string)) + } + + tmpObj.ReadWriteNode = &readWriteNode + } + } + + if readOnlyNodesSet, ok := clusterTopology["read_only_nodes"].(*schema.Set); ok { + readOnlyNodes := readOnlyNodesSet.List() + if len(readOnlyNodes) > 0 { + requestRoList := make([]*cdb.ReadonlyNode, 0, len(readOnlyNodes)) + for _, v := range readOnlyNodes { + item := v.(map[string]interface{}) + readonlyNode := cdb.ReadonlyNode{} + if item["is_random_zone"] != nil { + if item["is_random_zone"].(bool) == true { + readonlyNode.IsRandomZone = helper.String("YES") + } + } + + if item["zone"] != nil && item["zone"].(string) != "" { + readonlyNode.Zone = helper.String(item["zone"].(string)) + } + + if item["node_id"] != nil && item["node_id"].(string) != "" { + readonlyNode.NodeId = helper.String(item["node_id"].(string)) + } + + requestRoList = append(requestRoList, &readonlyNode) + } + + tmpObj.ReadOnlyNodes = requestRoList + } + } + + if okByMonth { + requestByMonth.ClusterTopology = &tmpObj + } else { + requestByUse.ClusterTopology = &tmpObj + } + } + } + return nil } @@ -869,6 +985,60 @@ func tencentMsyqlBasicInfoRead(ctx context.Context, d *schema.ResourceData, meta } _ = d.Set("status", mysqlInfo.Status) _ = d.Set("task_status", mysqlInfo.TaskStatus) + + if mysqlInfo.MasterInfo != nil || mysqlInfo.ClusterInfo != nil { + ctTmpList := make([]map[string]interface{}, 0, 1) + ctMap := make(map[string]interface{}) + if mysqlInfo.ClusterInfo != nil { + var masterZone string + rwTmpList := make([]map[string]interface{}, 0, 1) + for _, item := range mysqlInfo.ClusterInfo { + dMap := make(map[string]interface{}) + if item.Role != nil && *item.Role == "master" { + if item.Zone != nil { + dMap["zone"] = *item.Zone + masterZone = *item.Zone + } + + if item.NodeId != nil { + dMap["node_id"] = *item.NodeId + } + + rwTmpList = append(rwTmpList, dMap) + break + } + } + + ctMap["read_write_node"] = rwTmpList + + roTmpList := make([]map[string]interface{}, 0, len(mysqlInfo.ClusterInfo)) + for _, item := range mysqlInfo.ClusterInfo { + dMap := make(map[string]interface{}) + if item.Role != nil && *item.Role == "slave" { + if item.Zone != nil { + dMap["zone"] = *item.Zone + if masterZone == *item.Zone { + dMap["is_random_zone"] = false + } else { + dMap["is_random_zone"] = true + } + } + + if item.NodeId != nil { + dMap["node_id"] = *item.NodeId + } + + roTmpList = append(roTmpList, dMap) + } + } + + ctMap["read_only_nodes"] = roTmpList + } + + ctTmpList = append(ctTmpList, ctMap) + _ = d.Set("cluster_topology", ctTmpList) + } + return } @@ -1333,6 +1503,152 @@ func mysqlAllInstanceRoleUpdate(ctx context.Context, d *schema.ResourceData, met } } + if d.HasChange("cluster_topology") { + var ( + waitSwitch int64 + asyncRequestId string + ) + + if v, ok := d.GetOkExists("wait_switch"); ok { + waitSwitch = int64(v.(int)) + } + + request := cdb.NewUpgradeDBInstanceRequest() + response := cdb.NewUpgradeDBInstanceResponse() + if v, ok := d.GetOk("cluster_topology"); ok { + clusterTopologyList := v.([]interface{}) + if len(clusterTopologyList) > 0 { + clusterTopology := clusterTopologyList[0].(map[string]interface{}) + tmpObj := cdb.ClusterTopology{} + if readWriteNodeList, ok := clusterTopology["read_write_node"].([]interface{}); ok { + if len(readWriteNodeList) > 0 { + item := readWriteNodeList[0].(map[string]interface{}) + readWriteNode := cdb.ReadWriteNode{} + if item["zone"] != nil && item["zone"].(string) != "" { + readWriteNode.Zone = helper.String(item["zone"].(string)) + } + + if item["node_id"] != nil && item["node_id"].(string) != "" { + readWriteNode.NodeId = helper.String(item["node_id"].(string)) + } + + tmpObj.ReadWriteNode = &readWriteNode + } + } + + if readOnlyNodesSet, ok := clusterTopology["read_only_nodes"].(*schema.Set); ok { + readOnlyNodes := readOnlyNodesSet.List() + if len(readOnlyNodes) > 0 { + requestRoList := make([]*cdb.ReadonlyNode, 0, len(readOnlyNodes)) + for _, v := range readOnlyNodes { + item := v.(map[string]interface{}) + readonlyNode := cdb.ReadonlyNode{} + if item["is_random_zone"] != nil { + if item["is_random_zone"].(bool) == true { + readonlyNode.IsRandomZone = helper.String("YES") + } + } + + if item["zone"] != nil && item["zone"].(string) != "" { + readonlyNode.Zone = helper.String(item["zone"].(string)) + } + + if item["node_id"] != nil && item["node_id"].(string) != "" { + readonlyNode.NodeId = helper.String(item["node_id"].(string)) + } + + requestRoList = append(requestRoList, &readonlyNode) + } + + tmpObj.ReadOnlyNodes = requestRoList + } + } + + request.ClusterTopology = &tmpObj + } + } + + // required parameter + memSize := int64(d.Get("mem_size").(int)) + volumeSize := int64(d.Get("volume_size").(int)) + request.Memory = &memSize + request.Volume = &volumeSize + + request.InstanceId = helper.String(d.Id()) + err := resource.Retry(tccommon.WriteRetryTimeout, func() *resource.RetryError { + result, e := meta.(tccommon.ProviderMeta).GetAPIV3Conn().UseMysqlClient().UpgradeDBInstance(request) + if e != nil { + return tccommon.RetryError(e) + } else { + log.Printf("[DEBUG]%s api[%s] success, request body [%s], response body [%s]\n", logId, request.GetAction(), request.ToJsonString(), result.ToJsonString()) + } + + if result == nil || result.Response == nil || result.Response.AsyncRequestId == nil { + return resource.NonRetryableError(fmt.Errorf("update mysql cluster topology failed, response is nil.")) + } + + response = result + return nil + }) + + if err != nil { + log.Printf("[CRITAL]%s Update mysql cluster topology failed, reason:%s\n", logId, err.Error()) + return err + } + + asyncRequestId = *response.Response.AsyncRequestId + if waitSwitch != InWindow { + err = resource.Retry(6*time.Hour, func() *resource.RetryError { + taskStatus, message, err := mysqlService.DescribeAsyncRequestInfo(ctx, asyncRequestId) + if err != nil { + if _, ok := err.(*errors.TencentCloudSDKError); !ok { + return resource.RetryableError(err) + } else { + return resource.NonRetryableError(err) + } + } + + if taskStatus == MYSQL_TASK_STATUS_SUCCESS { + return nil + } + + if taskStatus == MYSQL_TASK_STATUS_INITIAL || taskStatus == MYSQL_TASK_STATUS_RUNNING { + return resource.RetryableError(fmt.Errorf("update mysql cluster topology status is %s", taskStatus)) + } + + err = fmt.Errorf("update mysql cluster topology task status is %s, we won't wait for it finish, it show message:%s", taskStatus, message) + return resource.NonRetryableError(err) + }) + + if err != nil { + log.Printf("[CRITAL]%s update mysql cluster topology fail, reason:%s\n ", logId, err.Error()) + return err + } + } else { + err = resource.Retry(tccommon.ReadRetryTimeout*5, func() *resource.RetryError { + mysqlInfo, err := mysqlService.DescribeDBInstanceById(ctx, d.Id()) + if err != nil { + if _, ok := err.(*errors.TencentCloudSDKError); !ok { + return resource.RetryableError(err) + } else { + return resource.NonRetryableError(err) + } + } + + if *mysqlInfo.TaskStatus == 15 { + return nil + } + + return resource.RetryableError(fmt.Errorf("update mysql cluster topology task status is %v", mysqlInfo.TaskStatus)) + }) + + if err != nil { + log.Printf("[CRITAL]%s update mysql cluster topology fail, reason:%s\n", logId, err.Error()) + return err + } + } + } + if d.HasChange("tags") { oldValue, newValue := d.GetChange("tags") diff --git a/tencentcloud/services/cdb/resource_tc_mysql_instance.md b/tencentcloud/services/cdb/resource_tc_mysql_instance.md index 0673cb888e..0cdd0692f0 100644 --- a/tencentcloud/services/cdb/resource_tc_mysql_instance.md +++ b/tencentcloud/services/cdb/resource_tc_mysql_instance.md @@ -137,6 +137,55 @@ resource "tencentcloud_mysql_instance" "example" { } ``` +Create instance by custom cluster_topology + +```hcl +resource "tencentcloud_mysql_instance" "example" { + instance_name = "tf-example" + internet_service = 1 + engine_version = "5.7" + charge_type = "POSTPAID" + root_password = "PassWord@123" + slave_deploy_mode = 1 + slave_sync_mode = 1 + device_type = "CLOUD_NATIVE_CLUSTER" + availability_zone = "ap-guangzhou-6" + cpu = 2 + mem_size = 4000 + volume_size = 200 + vpc_id = "vpc-i5yyodl9" + subnet_id = "subnet-hhi88a58" + intranet_port = 3306 + security_groups = ["sg-e6a8xxib"] + parameters = { + character_set_server = "utf8" + max_connections = "1000" + } + tags = { + createBy = "Terraform" + } + + cluster_topology { + read_write_node { + zone = "ap-guangzhou-6" + } + + read_only_nodes { + is_random_zone = true + } + + read_only_nodes { + zone = "ap-guangzhou-7" + } + } + + timeouts { + create = "30m" + delete = "30m" + } +} +``` + Import MySQL instance can be imported using the id, e.g. diff --git a/tencentcloud/services/cdb/service_tencentcloud_mysql.go b/tencentcloud/services/cdb/service_tencentcloud_mysql.go index 20e22e31c7..5fb0314994 100644 --- a/tencentcloud/services/cdb/service_tencentcloud_mysql.go +++ b/tencentcloud/services/cdb/service_tencentcloud_mysql.go @@ -857,6 +857,7 @@ func (me *MysqlService) _innerDescribeDBInstanceById(ctx context.Context, mysqlI logId := tccommon.GetLogId(ctx) request := cdb.NewDescribeDBInstancesRequest() request.InstanceIds = []*string{&mysqlId} + request.QueryClusterInfo = helper.Bool(true) defer func() { if errRet != nil { @@ -1096,60 +1097,6 @@ func (me *MysqlService) DescribeDBInstanceConfig(ctx context.Context, mysqlId st return } -// DEPRECATED: Specify these arguments while creating. -func (me *MysqlService) InitDBInstances(ctx context.Context, mysqlId, password, charset, lowerCase string, port int) (asyncRequestId string, errRet error) { - logId := tccommon.GetLogId(ctx) - request := cdb.NewInitDBInstancesRequest() - request.InstanceIds = []*string{&mysqlId} - if password != "" { - request.NewPassword = &password - } - - if port != 0 { - request.Vport = helper.IntInt64(port) - } - - paramsMap := map[string]string{ - "character_set_server": "LATIN1", // ["utf8","latin1","gbk","utf8mb4"] - } - - if charset != "" { - paramsMap["character_set_server"] = charset // ["utf8","latin1","gbk","utf8mb4"] - } - - if lowerCase != "" { - paramsMap["lower_case_table_names"] = lowerCase // ["0","1"] - } - - for k, v := range paramsMap { - name := k - value := v - param := cdb.ParamInfo{Name: &name, Value: &value} - request.Parameters = append(request.Parameters, ¶m) - } - - defer func() { - if errRet != nil { - log.Printf("[CRITAL]%s api[%s] fail, request body [%s], reason[%s]\n", - logId, request.GetAction(), request.ToJsonString(), errRet.Error()) - } - }() - ratelimit.Check(request.GetAction()) - response, err := me.client.UseMysqlClient().InitDBInstances(request) - - if err != nil { - errRet = err - return - } - if len(response.Response.AsyncRequestIds) != 1 { - errRet = fmt.Errorf("init one mysql id got %d async ids", len(response.Response.AsyncRequestIds)) - return - } - - asyncRequestId = *response.Response.AsyncRequestIds[0] - return -} - func (me *MysqlService) OpenWanService(ctx context.Context, mysqlId string) (asyncRequestId string, errRet error) { logId := tccommon.GetLogId(ctx) diff --git a/vendor/github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cdb/v20170320/client.go b/vendor/github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cdb/v20170320/client.go index 118a467d37..e6ca0fac8c 100644 --- a/vendor/github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cdb/v20170320/client.go +++ b/vendor/github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cdb/v20170320/client.go @@ -1,4 +1,4 @@ -// Copyright (c) 2017-2018 THL A29 Limited, a Tencent company. All Rights Reserved. +// Copyright (c) 2017-2025 Tencent. All Rights Reserved. // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -65,7 +65,7 @@ func NewAddTimeWindowResponse() (response *AddTimeWindowResponse) { } // AddTimeWindow -// 本接口(AddTimeWindow)用于添加云数据库实例的维护时间窗口,以指定实例在哪些时间段可以自动执行切换访问操作。 +// 本接口(AddTimeWindow)用于添加云数据库实例的维护时间窗口,以指定实例在哪些时间段可以自动执行切换访问操作。 // // 可能返回的错误码: // AUTHFAILURE = "AuthFailure" @@ -77,7 +77,7 @@ func (c *Client) AddTimeWindow(request *AddTimeWindowRequest) (response *AddTime } // AddTimeWindow -// 本接口(AddTimeWindow)用于添加云数据库实例的维护时间窗口,以指定实例在哪些时间段可以自动执行切换访问操作。 +// 本接口(AddTimeWindow)用于添加云数据库实例的维护时间窗口,以指定实例在哪些时间段可以自动执行切换访问操作。 // // 可能返回的错误码: // AUTHFAILURE = "AuthFailure" @@ -88,6 +88,7 @@ func (c *Client) AddTimeWindowWithContext(ctx context.Context, request *AddTimeW if request == nil { request = NewAddTimeWindowRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "AddTimeWindow") if c.GetCredential() == nil { return nil, errors.New("AddTimeWindow require credential") @@ -120,7 +121,7 @@ func NewAdjustCdbProxyResponse() (response *AdjustCdbProxyResponse) { } // AdjustCdbProxy -// 调整数据库代理配置 +// 本接口(AdjustCdbProxy)用于调整数据库代理配置。 // // 可能返回的错误码: // FAILEDOPERATION_DESCRIBEPROXYGROUPERROR = "FailedOperation.DescribeProxyGroupError" @@ -132,7 +133,7 @@ func (c *Client) AdjustCdbProxy(request *AdjustCdbProxyRequest) (response *Adjus } // AdjustCdbProxy -// 调整数据库代理配置 +// 本接口(AdjustCdbProxy)用于调整数据库代理配置。 // // 可能返回的错误码: // FAILEDOPERATION_DESCRIBEPROXYGROUPERROR = "FailedOperation.DescribeProxyGroupError" @@ -143,6 +144,7 @@ func (c *Client) AdjustCdbProxyWithContext(ctx context.Context, request *AdjustC if request == nil { request = NewAdjustCdbProxyRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "AdjustCdbProxy") if c.GetCredential() == nil { return nil, errors.New("AdjustCdbProxy require credential") @@ -175,7 +177,7 @@ func NewAdjustCdbProxyAddressResponse() (response *AdjustCdbProxyAddressResponse } // AdjustCdbProxyAddress -// 调整数据库代理地址配置 +// 本接口(AdjustCdbProxyAddress)用于调整数据库代理地址配置。 // // 可能返回的错误码: // FAILEDOPERATION_DESCRIBEPROXYGROUPERROR = "FailedOperation.DescribeProxyGroupError" @@ -185,13 +187,13 @@ func NewAdjustCdbProxyAddressResponse() (response *AdjustCdbProxyAddressResponse // INVALIDPARAMETERVALUE_INVALIDPARAMETERVALUEERROR = "InvalidParameterValue.InvalidParameterValueError" // OPERATIONDENIED_PROXYUPGRADETASKSTATUSERROR = "OperationDenied.ProxyUpgradeTaskStatusError" // OPERATIONDENIED_UNSUPPORTCREATEADDRESSERROR = "OperationDenied.UnsupportCreateAddressError" -// RESOURCENOTFOUND_INSTANCENOTFUNDERROR = "ResourceNotFound.InstanceNotFundError" +// RESOURCENOTFOUND_INSTANCENOTFOUNDERROR = "ResourceNotFound.InstanceNotFoundError" func (c *Client) AdjustCdbProxyAddress(request *AdjustCdbProxyAddressRequest) (response *AdjustCdbProxyAddressResponse, err error) { return c.AdjustCdbProxyAddressWithContext(context.Background(), request) } // AdjustCdbProxyAddress -// 调整数据库代理地址配置 +// 本接口(AdjustCdbProxyAddress)用于调整数据库代理地址配置。 // // 可能返回的错误码: // FAILEDOPERATION_DESCRIBEPROXYGROUPERROR = "FailedOperation.DescribeProxyGroupError" @@ -201,11 +203,12 @@ func (c *Client) AdjustCdbProxyAddress(request *AdjustCdbProxyAddressRequest) (r // INVALIDPARAMETERVALUE_INVALIDPARAMETERVALUEERROR = "InvalidParameterValue.InvalidParameterValueError" // OPERATIONDENIED_PROXYUPGRADETASKSTATUSERROR = "OperationDenied.ProxyUpgradeTaskStatusError" // OPERATIONDENIED_UNSUPPORTCREATEADDRESSERROR = "OperationDenied.UnsupportCreateAddressError" -// RESOURCENOTFOUND_INSTANCENOTFUNDERROR = "ResourceNotFound.InstanceNotFundError" +// RESOURCENOTFOUND_INSTANCENOTFOUNDERROR = "ResourceNotFound.InstanceNotFoundError" func (c *Client) AdjustCdbProxyAddressWithContext(ctx context.Context, request *AdjustCdbProxyAddressRequest) (response *AdjustCdbProxyAddressResponse, err error) { if request == nil { request = NewAdjustCdbProxyAddressRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "AdjustCdbProxyAddress") if c.GetCredential() == nil { return nil, errors.New("AdjustCdbProxyAddress require credential") @@ -238,9 +241,10 @@ func NewAnalyzeAuditLogsResponse() (response *AnalyzeAuditLogsResponse) { } // AnalyzeAuditLogs -// 在不同过滤条件下的审计日志结果集中,选定特定的数据列进行聚合统计。 +// 本接口(AnalyzeAuditLogs)用于在不同过滤条件下的审计日志结果集中,选定特定的数据列进行聚合统计。 // // 可能返回的错误码: +// INTERNALERROR_INTERNALINNERSERVICEERROR = "InternalError.InternalInnerServiceError" // INVALIDPARAMETER_CONTROLLERNOTFOUNDERROR = "InvalidParameter.ControllerNotFoundError" // INVALIDPARAMETER_EXCEPTIONPARAM = "InvalidParameter.ExceptionParam" // INVALIDPARAMETER_INVALIDPARAMETERERROR = "InvalidParameter.InvalidParameterError" @@ -250,9 +254,10 @@ func (c *Client) AnalyzeAuditLogs(request *AnalyzeAuditLogsRequest) (response *A } // AnalyzeAuditLogs -// 在不同过滤条件下的审计日志结果集中,选定特定的数据列进行聚合统计。 +// 本接口(AnalyzeAuditLogs)用于在不同过滤条件下的审计日志结果集中,选定特定的数据列进行聚合统计。 // // 可能返回的错误码: +// INTERNALERROR_INTERNALINNERSERVICEERROR = "InternalError.InternalInnerServiceError" // INVALIDPARAMETER_CONTROLLERNOTFOUNDERROR = "InvalidParameter.ControllerNotFoundError" // INVALIDPARAMETER_EXCEPTIONPARAM = "InvalidParameter.ExceptionParam" // INVALIDPARAMETER_INVALIDPARAMETERERROR = "InvalidParameter.InvalidParameterError" @@ -261,6 +266,7 @@ func (c *Client) AnalyzeAuditLogsWithContext(ctx context.Context, request *Analy if request == nil { request = NewAnalyzeAuditLogsRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "AnalyzeAuditLogs") if c.GetCredential() == nil { return nil, errors.New("AnalyzeAuditLogs require credential") @@ -324,6 +330,7 @@ func (c *Client) AssociateSecurityGroupsWithContext(ctx context.Context, request if request == nil { request = NewAssociateSecurityGroupsRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "AssociateSecurityGroups") if c.GetCredential() == nil { return nil, errors.New("AssociateSecurityGroups require credential") @@ -385,6 +392,7 @@ func (c *Client) BalanceRoGroupLoadWithContext(ctx context.Context, request *Bal if request == nil { request = NewBalanceRoGroupLoadRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "BalanceRoGroupLoad") if c.GetCredential() == nil { return nil, errors.New("BalanceRoGroupLoad require credential") @@ -417,7 +425,7 @@ func NewCheckMigrateClusterResponse() (response *CheckMigrateClusterResponse) { } // CheckMigrateCluster -// 高可用实例一键迁移到集群版校验 +// 本接口(CheckMigrateCluster)用于高可用实例一键迁移到云盘版校验。 // // 可能返回的错误码: // FAILEDOPERATION_STATUSCONFLICT = "FailedOperation.StatusConflict" @@ -432,7 +440,7 @@ func (c *Client) CheckMigrateCluster(request *CheckMigrateClusterRequest) (respo } // CheckMigrateCluster -// 高可用实例一键迁移到集群版校验 +// 本接口(CheckMigrateCluster)用于高可用实例一键迁移到云盘版校验。 // // 可能返回的错误码: // FAILEDOPERATION_STATUSCONFLICT = "FailedOperation.StatusConflict" @@ -446,6 +454,7 @@ func (c *Client) CheckMigrateClusterWithContext(ctx context.Context, request *Ch if request == nil { request = NewCheckMigrateClusterRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "CheckMigrateCluster") if c.GetCredential() == nil { return nil, errors.New("CheckMigrateCluster require credential") @@ -501,6 +510,7 @@ func (c *Client) CloseAuditServiceWithContext(ctx context.Context, request *Clos if request == nil { request = NewCloseAuditServiceRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "CloseAuditService") if c.GetCredential() == nil { return nil, errors.New("CloseAuditService require credential") @@ -533,7 +543,7 @@ func NewCloseCDBProxyResponse() (response *CloseCDBProxyResponse) { } // CloseCDBProxy -// 关闭数据库代理 +// 本接口(CloseCDBProxy)用于关闭数据库代理。 // // 可能返回的错误码: // FAILEDOPERATION_DESCRIBEPROXYGROUPERROR = "FailedOperation.DescribeProxyGroupError" @@ -545,7 +555,7 @@ func (c *Client) CloseCDBProxy(request *CloseCDBProxyRequest) (response *CloseCD } // CloseCDBProxy -// 关闭数据库代理 +// 本接口(CloseCDBProxy)用于关闭数据库代理。 // // 可能返回的错误码: // FAILEDOPERATION_DESCRIBEPROXYGROUPERROR = "FailedOperation.DescribeProxyGroupError" @@ -556,6 +566,7 @@ func (c *Client) CloseCDBProxyWithContext(ctx context.Context, request *CloseCDB if request == nil { request = NewCloseCDBProxyRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "CloseCDBProxy") if c.GetCredential() == nil { return nil, errors.New("CloseCDBProxy require credential") @@ -588,7 +599,7 @@ func NewCloseCdbProxyAddressResponse() (response *CloseCdbProxyAddressResponse) } // CloseCdbProxyAddress -// 请求关闭数据库代理地址 +// 本接口(CloseCdbProxyAddress)用于请求关闭数据库代理地址。 // // 可能返回的错误码: // FAILEDOPERATION_DESCRIBEPROXYGROUPERROR = "FailedOperation.DescribeProxyGroupError" @@ -601,7 +612,7 @@ func (c *Client) CloseCdbProxyAddress(request *CloseCdbProxyAddressRequest) (res } // CloseCdbProxyAddress -// 请求关闭数据库代理地址 +// 本接口(CloseCdbProxyAddress)用于请求关闭数据库代理地址。 // // 可能返回的错误码: // FAILEDOPERATION_DESCRIBEPROXYGROUPERROR = "FailedOperation.DescribeProxyGroupError" @@ -613,6 +624,7 @@ func (c *Client) CloseCdbProxyAddressWithContext(ctx context.Context, request *C if request == nil { request = NewCloseCdbProxyAddressRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "CloseCdbProxyAddress") if c.GetCredential() == nil { return nil, errors.New("CloseCdbProxyAddress require credential") @@ -645,7 +657,7 @@ func NewCloseSSLResponse() (response *CloseSSLResponse) { } // CloseSSL -// 关闭SSL连接功能。 +// 本接口(CloseSSL)用于关闭 SSL 连接功能。 // // 可能返回的错误码: // INTERNALERROR_UNKNOWNERROR = "InternalError.UnknownError" @@ -656,7 +668,7 @@ func (c *Client) CloseSSL(request *CloseSSLRequest) (response *CloseSSLResponse, } // CloseSSL -// 关闭SSL连接功能。 +// 本接口(CloseSSL)用于关闭 SSL 连接功能。 // // 可能返回的错误码: // INTERNALERROR_UNKNOWNERROR = "InternalError.UnknownError" @@ -666,6 +678,7 @@ func (c *Client) CloseSSLWithContext(ctx context.Context, request *CloseSSLReque if request == nil { request = NewCloseSSLRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "CloseSSL") if c.GetCredential() == nil { return nil, errors.New("CloseSSL require credential") @@ -725,6 +738,7 @@ func (c *Client) CloseWanServiceWithContext(ctx context.Context, request *CloseW if request == nil { request = NewCloseWanServiceRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "CloseWanService") if c.GetCredential() == nil { return nil, errors.New("CloseWanService require credential") @@ -757,7 +771,7 @@ func NewCreateAccountsResponse() (response *CreateAccountsResponse) { } // CreateAccounts -// 本接口(CreateAccounts)用于创建云数据库的账户,需要指定新的账户名和域名,以及所对应的密码,同时可以设置账号的备注信息以及最大可用连接数。 +// 本接口(CreateAccounts)用于创建云数据库的账户,需要指定新的账户名和域名,以及所对应的密码,同时可以设置账号的备注信息以及最大可用连接数。 // // 可能返回的错误码: // FAILEDOPERATION_CREATEACCOUNTERROR = "FailedOperation.CreateAccountError" @@ -798,7 +812,7 @@ func (c *Client) CreateAccounts(request *CreateAccountsRequest) (response *Creat } // CreateAccounts -// 本接口(CreateAccounts)用于创建云数据库的账户,需要指定新的账户名和域名,以及所对应的密码,同时可以设置账号的备注信息以及最大可用连接数。 +// 本接口(CreateAccounts)用于创建云数据库的账户,需要指定新的账户名和域名,以及所对应的密码,同时可以设置账号的备注信息以及最大可用连接数。 // // 可能返回的错误码: // FAILEDOPERATION_CREATEACCOUNTERROR = "FailedOperation.CreateAccountError" @@ -838,6 +852,7 @@ func (c *Client) CreateAccountsWithContext(ctx context.Context, request *CreateA if request == nil { request = NewCreateAccountsRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "CreateAccounts") if c.GetCredential() == nil { return nil, errors.New("CreateAccounts require credential") @@ -870,7 +885,7 @@ func NewCreateAuditLogFileResponse() (response *CreateAuditLogFileResponse) { } // CreateAuditLogFile -// 本接口(CreateAuditLogFile)用于创建云数据库实例的审计日志文件。 +// 本接口(CreateAuditLogFile)用于创建云数据库实例的审计日志文件。 // // 可能返回的错误码: // FAILEDOPERATION_CREATEAUDITLOGFILEERROR = "FailedOperation.CreateAuditLogFileError" @@ -899,7 +914,7 @@ func (c *Client) CreateAuditLogFile(request *CreateAuditLogFileRequest) (respons } // CreateAuditLogFile -// 本接口(CreateAuditLogFile)用于创建云数据库实例的审计日志文件。 +// 本接口(CreateAuditLogFile)用于创建云数据库实例的审计日志文件。 // // 可能返回的错误码: // FAILEDOPERATION_CREATEAUDITLOGFILEERROR = "FailedOperation.CreateAuditLogFileError" @@ -927,6 +942,7 @@ func (c *Client) CreateAuditLogFileWithContext(ctx context.Context, request *Cre if request == nil { request = NewCreateAuditLogFileRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "CreateAuditLogFile") if c.GetCredential() == nil { return nil, errors.New("CreateAuditLogFile require credential") @@ -1042,6 +1058,7 @@ func (c *Client) CreateAuditPolicyWithContext(ctx context.Context, request *Crea if request == nil { request = NewCreateAuditPolicyRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "CreateAuditPolicy") if c.GetCredential() == nil { return nil, errors.New("CreateAuditPolicy require credential") @@ -1074,6 +1091,10 @@ func NewCreateAuditRuleResponse() (response *CreateAuditRuleResponse) { } // CreateAuditRule +// 不再支持审计规则创建 +// +// +// // 本接口(CreateAuditRule)用于创建用户在当前地域的审计规则。 // // 可能返回的错误码: @@ -1094,6 +1115,10 @@ func (c *Client) CreateAuditRule(request *CreateAuditRuleRequest) (response *Cre } // CreateAuditRule +// 不再支持审计规则创建 +// +// +// // 本接口(CreateAuditRule)用于创建用户在当前地域的审计规则。 // // 可能返回的错误码: @@ -1113,6 +1138,7 @@ func (c *Client) CreateAuditRuleWithContext(ctx context.Context, request *Create if request == nil { request = NewCreateAuditRuleRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "CreateAuditRule") if c.GetCredential() == nil { return nil, errors.New("CreateAuditRule require credential") @@ -1145,7 +1171,7 @@ func NewCreateAuditRuleTemplateResponse() (response *CreateAuditRuleTemplateResp } // CreateAuditRuleTemplate -// 创建审计规则模板 +// 本接口(CreateAuditRuleTemplate)用于创建审计规则模板。 // // 可能返回的错误码: // INVALIDPARAMETER_EXCEPTIONPARAM = "InvalidParameter.ExceptionParam" @@ -1155,7 +1181,7 @@ func (c *Client) CreateAuditRuleTemplate(request *CreateAuditRuleTemplateRequest } // CreateAuditRuleTemplate -// 创建审计规则模板 +// 本接口(CreateAuditRuleTemplate)用于创建审计规则模板。 // // 可能返回的错误码: // INVALIDPARAMETER_EXCEPTIONPARAM = "InvalidParameter.ExceptionParam" @@ -1164,6 +1190,7 @@ func (c *Client) CreateAuditRuleTemplateWithContext(ctx context.Context, request if request == nil { request = NewCreateAuditRuleTemplateRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "CreateAuditRuleTemplate") if c.GetCredential() == nil { return nil, errors.New("CreateAuditRuleTemplate require credential") @@ -1196,12 +1223,14 @@ func NewCreateBackupResponse() (response *CreateBackupResponse) { } // CreateBackup -// 本接口(CreateBackup)用于创建数据库备份。 +// 本接口(CreateBackup)用于创建数据库备份。 // // 可能返回的错误码: // AUTHFAILURE = "AuthFailure" // CDBERROR = "CdbError" +// FAILEDOPERATION = "FailedOperation" // FAILEDOPERATION_STATUSCONFLICT = "FailedOperation.StatusConflict" +// FAILEDOPERATION_TASKCONFLICTERROR = "FailedOperation.TaskConflictError" // INTERNALERROR_CDBERROR = "InternalError.CdbError" // INTERNALERROR_DATABASEACCESSERROR = "InternalError.DatabaseAccessError" // INTERNALERROR_DESERROR = "InternalError.DesError" @@ -1222,12 +1251,14 @@ func (c *Client) CreateBackup(request *CreateBackupRequest) (response *CreateBac } // CreateBackup -// 本接口(CreateBackup)用于创建数据库备份。 +// 本接口(CreateBackup)用于创建数据库备份。 // // 可能返回的错误码: // AUTHFAILURE = "AuthFailure" // CDBERROR = "CdbError" +// FAILEDOPERATION = "FailedOperation" // FAILEDOPERATION_STATUSCONFLICT = "FailedOperation.StatusConflict" +// FAILEDOPERATION_TASKCONFLICTERROR = "FailedOperation.TaskConflictError" // INTERNALERROR_CDBERROR = "InternalError.CdbError" // INTERNALERROR_DATABASEACCESSERROR = "InternalError.DatabaseAccessError" // INTERNALERROR_DESERROR = "InternalError.DesError" @@ -1247,6 +1278,7 @@ func (c *Client) CreateBackupWithContext(ctx context.Context, request *CreateBac if request == nil { request = NewCreateBackupRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "CreateBackup") if c.GetCredential() == nil { return nil, errors.New("CreateBackup require credential") @@ -1279,29 +1311,30 @@ func NewCreateCdbProxyResponse() (response *CreateCdbProxyResponse) { } // CreateCdbProxy -// 主实例创建数据库代理 +// 本接口(CreateCdbProxy)用于主实例创建数据库代理。 // // 可能返回的错误码: // FAILEDOPERATION_REPEATCREATEPROXYERROR = "FailedOperation.RepeatCreateProxyError" // INTERNALERROR_UNKNOWNERROR = "InternalError.UnknownError" // OPERATIONDENIED_INSTANCESTATUSERROR = "OperationDenied.InstanceStatusError" -// RESOURCENOTFOUND_INSTANCENOTFUNDERROR = "ResourceNotFound.InstanceNotFundError" +// RESOURCENOTFOUND_INSTANCENOTFOUNDERROR = "ResourceNotFound.InstanceNotFoundError" func (c *Client) CreateCdbProxy(request *CreateCdbProxyRequest) (response *CreateCdbProxyResponse, err error) { return c.CreateCdbProxyWithContext(context.Background(), request) } // CreateCdbProxy -// 主实例创建数据库代理 +// 本接口(CreateCdbProxy)用于主实例创建数据库代理。 // // 可能返回的错误码: // FAILEDOPERATION_REPEATCREATEPROXYERROR = "FailedOperation.RepeatCreateProxyError" // INTERNALERROR_UNKNOWNERROR = "InternalError.UnknownError" // OPERATIONDENIED_INSTANCESTATUSERROR = "OperationDenied.InstanceStatusError" -// RESOURCENOTFOUND_INSTANCENOTFUNDERROR = "ResourceNotFound.InstanceNotFundError" +// RESOURCENOTFOUND_INSTANCENOTFOUNDERROR = "ResourceNotFound.InstanceNotFoundError" func (c *Client) CreateCdbProxyWithContext(ctx context.Context, request *CreateCdbProxyRequest) (response *CreateCdbProxyResponse, err error) { if request == nil { request = NewCreateCdbProxyRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "CreateCdbProxy") if c.GetCredential() == nil { return nil, errors.New("CreateCdbProxy require credential") @@ -1334,7 +1367,7 @@ func NewCreateCdbProxyAddressResponse() (response *CreateCdbProxyAddressResponse } // CreateCdbProxyAddress -// 数据库代理增加代理地址 +// 本接口(CreateCdbProxyAddress)用于数据库代理增加代理地址。 // // 可能返回的错误码: // FAILEDOPERATION_DESCRIBEPROXYGROUPERROR = "FailedOperation.DescribeProxyGroupError" @@ -1349,7 +1382,7 @@ func (c *Client) CreateCdbProxyAddress(request *CreateCdbProxyAddressRequest) (r } // CreateCdbProxyAddress -// 数据库代理增加代理地址 +// 本接口(CreateCdbProxyAddress)用于数据库代理增加代理地址。 // // 可能返回的错误码: // FAILEDOPERATION_DESCRIBEPROXYGROUPERROR = "FailedOperation.DescribeProxyGroupError" @@ -1363,6 +1396,7 @@ func (c *Client) CreateCdbProxyAddressWithContext(ctx context.Context, request * if request == nil { request = NewCreateCdbProxyAddressRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "CreateCdbProxyAddress") if c.GetCredential() == nil { return nil, errors.New("CreateCdbProxyAddress require credential") @@ -1395,7 +1429,7 @@ func NewCreateCloneInstanceResponse() (response *CreateCloneInstanceResponse) { } // CreateCloneInstance -// 本接口(CreateCloneInstance) 用于从目标源实例创建一个克隆实例,可以指定克隆实例回档到源实例的指定物理备份文件或者指定的回档时间点。 +// 本接口(CreateCloneInstance)用于从目标源实例创建一个克隆实例,可以指定克隆实例回档到源实例的指定物理备份文件或者指定的回档时间点。 // // 可能返回的错误码: // CDBERROR = "CdbError" @@ -1416,7 +1450,7 @@ func (c *Client) CreateCloneInstance(request *CreateCloneInstanceRequest) (respo } // CreateCloneInstance -// 本接口(CreateCloneInstance) 用于从目标源实例创建一个克隆实例,可以指定克隆实例回档到源实例的指定物理备份文件或者指定的回档时间点。 +// 本接口(CreateCloneInstance)用于从目标源实例创建一个克隆实例,可以指定克隆实例回档到源实例的指定物理备份文件或者指定的回档时间点。 // // 可能返回的错误码: // CDBERROR = "CdbError" @@ -1436,6 +1470,7 @@ func (c *Client) CreateCloneInstanceWithContext(ctx context.Context, request *Cr if request == nil { request = NewCreateCloneInstanceRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "CreateCloneInstance") if c.GetCredential() == nil { return nil, errors.New("CreateCloneInstance require credential") @@ -1468,9 +1503,7 @@ func NewCreateDBImportJobResponse() (response *CreateDBImportJobResponse) { } // CreateDBImportJob -// 本接口(CreateDBImportJob)用于创建云数据库数据导入任务。 -// -// +// 本接口(CreateDBImportJob)用于创建云数据库数据导入任务。 // // 注意,用户进行数据导入任务的文件,必须提前上传到腾讯云。用户须在控制台进行文件导入。 // @@ -1495,9 +1528,7 @@ func (c *Client) CreateDBImportJob(request *CreateDBImportJobRequest) (response } // CreateDBImportJob -// 本接口(CreateDBImportJob)用于创建云数据库数据导入任务。 -// -// +// 本接口(CreateDBImportJob)用于创建云数据库数据导入任务。 // // 注意,用户进行数据导入任务的文件,必须提前上传到腾讯云。用户须在控制台进行文件导入。 // @@ -1521,6 +1552,7 @@ func (c *Client) CreateDBImportJobWithContext(ctx context.Context, request *Crea if request == nil { request = NewCreateDBImportJobRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "CreateDBImportJob") if c.GetCredential() == nil { return nil, errors.New("CreateDBImportJob require credential") @@ -1553,7 +1585,7 @@ func NewCreateDBInstanceResponse() (response *CreateDBInstanceResponse) { } // CreateDBInstance -// 本接口(CreateDBInstance)用于创建包年包月的云数据库实例(包括主实例、灾备实例和只读实例),可通过传入实例规格、MySQL 版本号、购买时长和数量等信息创建云数据库实例。 +// 本接口(CreateDBInstance)用于创建包年包月的云数据库实例(包括主实例、灾备实例和只读实例),可通过传入实例规格、MySQL 版本号、购买时长和数量等信息创建云数据库实例。 // // // @@ -1569,9 +1601,7 @@ func NewCreateDBInstanceResponse() (response *CreateDBInstanceResponse) { // // 4. 支持创建主实例、只读实例、灾备实例; // -// 5. 当入参指定 Port 和 ParamTemplateType 参数模板,相关参数才会自动初始化(不支持基础版实例); -// -// 6. 当入参指定 ParamTemplateId 或 AlarmPolicyList 时,需将SDK提升至最新版本方可支持; +// 5. 当入参指定 ParamTemplateId 或 AlarmPolicyList 时,需将SDK提升至最新版本方可支持; // // 可能返回的错误码: // CDBERROR = "CdbError" @@ -1596,7 +1626,7 @@ func (c *Client) CreateDBInstance(request *CreateDBInstanceRequest) (response *C } // CreateDBInstance -// 本接口(CreateDBInstance)用于创建包年包月的云数据库实例(包括主实例、灾备实例和只读实例),可通过传入实例规格、MySQL 版本号、购买时长和数量等信息创建云数据库实例。 +// 本接口(CreateDBInstance)用于创建包年包月的云数据库实例(包括主实例、灾备实例和只读实例),可通过传入实例规格、MySQL 版本号、购买时长和数量等信息创建云数据库实例。 // // // @@ -1612,9 +1642,7 @@ func (c *Client) CreateDBInstance(request *CreateDBInstanceRequest) (response *C // // 4. 支持创建主实例、只读实例、灾备实例; // -// 5. 当入参指定 Port 和 ParamTemplateType 参数模板,相关参数才会自动初始化(不支持基础版实例); -// -// 6. 当入参指定 ParamTemplateId 或 AlarmPolicyList 时,需将SDK提升至最新版本方可支持; +// 5. 当入参指定 ParamTemplateId 或 AlarmPolicyList 时,需将SDK提升至最新版本方可支持; // // 可能返回的错误码: // CDBERROR = "CdbError" @@ -1638,6 +1666,7 @@ func (c *Client) CreateDBInstanceWithContext(ctx context.Context, request *Creat if request == nil { request = NewCreateDBInstanceRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "CreateDBInstance") if c.GetCredential() == nil { return nil, errors.New("CreateDBInstance require credential") @@ -1670,7 +1699,7 @@ func NewCreateDBInstanceHourResponse() (response *CreateDBInstanceHourResponse) } // CreateDBInstanceHour -// 本接口(CreateDBInstanceHour)用于创建按量计费的实例,可通过传入实例规格、MySQL 版本号和数量等信息创建云数据库实例,支持主实例、灾备实例和只读实例的创建。 +// 本接口(CreateDBInstanceHour)用于创建按量计费的实例,可通过传入实例规格、MySQL 版本号和数量等信息创建云数据库实例,支持主实例、灾备实例和只读实例的创建。 // // // @@ -1686,8 +1715,6 @@ func NewCreateDBInstanceHourResponse() (response *CreateDBInstanceHourResponse) // // 4. 支持创建主实例、灾备实例和只读实例; // -// 5. 当入参指定 Port,ParamTemplateType 或 Password 时,该实例会进行初始化操作; -// // 可能返回的错误码: // CDBERROR = "CdbError" // FAILEDOPERATION_STATUSCONFLICT = "FailedOperation.StatusConflict" @@ -1709,7 +1736,7 @@ func (c *Client) CreateDBInstanceHour(request *CreateDBInstanceHourRequest) (res } // CreateDBInstanceHour -// 本接口(CreateDBInstanceHour)用于创建按量计费的实例,可通过传入实例规格、MySQL 版本号和数量等信息创建云数据库实例,支持主实例、灾备实例和只读实例的创建。 +// 本接口(CreateDBInstanceHour)用于创建按量计费的实例,可通过传入实例规格、MySQL 版本号和数量等信息创建云数据库实例,支持主实例、灾备实例和只读实例的创建。 // // // @@ -1725,8 +1752,6 @@ func (c *Client) CreateDBInstanceHour(request *CreateDBInstanceHourRequest) (res // // 4. 支持创建主实例、灾备实例和只读实例; // -// 5. 当入参指定 Port,ParamTemplateType 或 Password 时,该实例会进行初始化操作; -// // 可能返回的错误码: // CDBERROR = "CdbError" // FAILEDOPERATION_STATUSCONFLICT = "FailedOperation.StatusConflict" @@ -1747,6 +1772,7 @@ func (c *Client) CreateDBInstanceHourWithContext(ctx context.Context, request *C if request == nil { request = NewCreateDBInstanceHourRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "CreateDBInstanceHour") if c.GetCredential() == nil { return nil, errors.New("CreateDBInstanceHour require credential") @@ -1824,6 +1850,7 @@ func (c *Client) CreateDatabaseWithContext(ctx context.Context, request *CreateD if request == nil { request = NewCreateDatabaseRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "CreateDatabase") if c.GetCredential() == nil { return nil, errors.New("CreateDatabase require credential") @@ -1856,7 +1883,7 @@ func NewCreateDeployGroupResponse() (response *CreateDeployGroupResponse) { } // CreateDeployGroup -// 本接口(CreateDeployGroup)用于创建放置实例的置放群组 +// 本接口(CreateDeployGroup)用于创建放置实例的置放群组。 // // 可能返回的错误码: // INTERNALERROR_CDBERROR = "InternalError.CdbError" @@ -1871,7 +1898,7 @@ func (c *Client) CreateDeployGroup(request *CreateDeployGroupRequest) (response } // CreateDeployGroup -// 本接口(CreateDeployGroup)用于创建放置实例的置放群组 +// 本接口(CreateDeployGroup)用于创建放置实例的置放群组。 // // 可能返回的错误码: // INTERNALERROR_CDBERROR = "InternalError.CdbError" @@ -1885,6 +1912,7 @@ func (c *Client) CreateDeployGroupWithContext(ctx context.Context, request *Crea if request == nil { request = NewCreateDeployGroupRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "CreateDeployGroup") if c.GetCredential() == nil { return nil, errors.New("CreateDeployGroup require credential") @@ -1917,7 +1945,9 @@ func NewCreateParamTemplateResponse() (response *CreateParamTemplateResponse) { } // CreateParamTemplate -// 该接口(CreateParamTemplate)用于创建参数模板,全地域公共参数Region均为ap-guangzhou。 +// 该接口(CreateParamTemplate)用于创建参数模板。 +// +// 说明:参数模板为公共组件,配置完成后全地域生效。接口调用配置地域可选择广州、新加坡。 // // 可能返回的错误码: // AUTHFAILURE = "AuthFailure" @@ -1934,7 +1964,9 @@ func (c *Client) CreateParamTemplate(request *CreateParamTemplateRequest) (respo } // CreateParamTemplate -// 该接口(CreateParamTemplate)用于创建参数模板,全地域公共参数Region均为ap-guangzhou。 +// 该接口(CreateParamTemplate)用于创建参数模板。 +// +// 说明:参数模板为公共组件,配置完成后全地域生效。接口调用配置地域可选择广州、新加坡。 // // 可能返回的错误码: // AUTHFAILURE = "AuthFailure" @@ -1950,6 +1982,7 @@ func (c *Client) CreateParamTemplateWithContext(ctx context.Context, request *Cr if request == nil { request = NewCreateParamTemplateRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "CreateParamTemplate") if c.GetCredential() == nil { return nil, errors.New("CreateParamTemplate require credential") @@ -2031,6 +2064,7 @@ func (c *Client) CreateRoInstanceIpWithContext(ctx context.Context, request *Cre if request == nil { request = NewCreateRoInstanceIpRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "CreateRoInstanceIp") if c.GetCredential() == nil { return nil, errors.New("CreateRoInstanceIp require credential") @@ -2043,6 +2077,88 @@ func (c *Client) CreateRoInstanceIpWithContext(ctx context.Context, request *Cre return } +func NewCreateRotationPasswordRequest() (request *CreateRotationPasswordRequest) { + request = &CreateRotationPasswordRequest{ + BaseRequest: &tchttp.BaseRequest{}, + } + + request.Init().WithApiInfo("cdb", APIVersion, "CreateRotationPassword") + + + return +} + +func NewCreateRotationPasswordResponse() (response *CreateRotationPasswordResponse) { + response = &CreateRotationPasswordResponse{ + BaseResponse: &tchttp.BaseResponse{}, + } + return + +} + +// CreateRotationPassword +// 本接口(CreateRotationPassword)用于开启密码轮转。 +// +// 可能返回的错误码: +// CDBERROR = "CdbError" +// FAILEDOPERATION_CREATEROVIPERROR = "FailedOperation.CreateRoVipError" +// FAILEDOPERATION_STATUSCONFLICT = "FailedOperation.StatusConflict" +// INTERNALERROR_CDBERROR = "InternalError.CdbError" +// INTERNALERROR_DATABASEACCESSERROR = "InternalError.DatabaseAccessError" +// INTERNALERROR_DESERROR = "InternalError.DesError" +// INTERNALERROR_HTTPERROR = "InternalError.HttpError" +// INTERNALERROR_INTERNALHTTPSERVERERROR = "InternalError.InternalHttpServerError" +// INTERNALERROR_UNKNOWNERROR = "InternalError.UnknownError" +// INVALIDPARAMETER = "InvalidParameter" +// INVALIDPARAMETER_INSTANCENOTFOUND = "InvalidParameter.InstanceNotFound" +// INVALIDPARAMETER_RESOURCENOTFOUND = "InvalidParameter.ResourceNotFound" +// INVALIDPARAMETERVALUE_INVALIDPARAMETERVALUEERROR = "InvalidParameterValue.InvalidParameterValueError" +// OPERATIONDENIED = "OperationDenied" +// OPERATIONDENIED_ACTIONINPROCESS = "OperationDenied.ActionInProcess" +// OPERATIONDENIED_WRONGSTATUS = "OperationDenied.WrongStatus" +// RESOURCENOTFOUND_CDBINSTANCENOTFOUNDERROR = "ResourceNotFound.CdbInstanceNotFoundError" +func (c *Client) CreateRotationPassword(request *CreateRotationPasswordRequest) (response *CreateRotationPasswordResponse, err error) { + return c.CreateRotationPasswordWithContext(context.Background(), request) +} + +// CreateRotationPassword +// 本接口(CreateRotationPassword)用于开启密码轮转。 +// +// 可能返回的错误码: +// CDBERROR = "CdbError" +// FAILEDOPERATION_CREATEROVIPERROR = "FailedOperation.CreateRoVipError" +// FAILEDOPERATION_STATUSCONFLICT = "FailedOperation.StatusConflict" +// INTERNALERROR_CDBERROR = "InternalError.CdbError" +// INTERNALERROR_DATABASEACCESSERROR = "InternalError.DatabaseAccessError" +// INTERNALERROR_DESERROR = "InternalError.DesError" +// INTERNALERROR_HTTPERROR = "InternalError.HttpError" +// INTERNALERROR_INTERNALHTTPSERVERERROR = "InternalError.InternalHttpServerError" +// INTERNALERROR_UNKNOWNERROR = "InternalError.UnknownError" +// INVALIDPARAMETER = "InvalidParameter" +// INVALIDPARAMETER_INSTANCENOTFOUND = "InvalidParameter.InstanceNotFound" +// INVALIDPARAMETER_RESOURCENOTFOUND = "InvalidParameter.ResourceNotFound" +// INVALIDPARAMETERVALUE_INVALIDPARAMETERVALUEERROR = "InvalidParameterValue.InvalidParameterValueError" +// OPERATIONDENIED = "OperationDenied" +// OPERATIONDENIED_ACTIONINPROCESS = "OperationDenied.ActionInProcess" +// OPERATIONDENIED_WRONGSTATUS = "OperationDenied.WrongStatus" +// RESOURCENOTFOUND_CDBINSTANCENOTFOUNDERROR = "ResourceNotFound.CdbInstanceNotFoundError" +func (c *Client) CreateRotationPasswordWithContext(ctx context.Context, request *CreateRotationPasswordRequest) (response *CreateRotationPasswordResponse, err error) { + if request == nil { + request = NewCreateRotationPasswordRequest() + } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "CreateRotationPassword") + + if c.GetCredential() == nil { + return nil, errors.New("CreateRotationPassword require credential") + } + + request.SetContext(ctx) + + response = NewCreateRotationPasswordResponse() + err = c.Send(request, response) + return +} + func NewDeleteAccountsRequest() (request *DeleteAccountsRequest) { request = &DeleteAccountsRequest{ BaseRequest: &tchttp.BaseRequest{}, @@ -2063,7 +2179,7 @@ func NewDeleteAccountsResponse() (response *DeleteAccountsResponse) { } // DeleteAccounts -// 本接口(DeleteAccounts)用于删除云数据库的账户。 +// 本接口(DeleteAccounts)用于删除云数据库的账户。 // // 可能返回的错误码: // FAILEDOPERATION_CREATEACCOUNTERROR = "FailedOperation.CreateAccountError" @@ -2101,7 +2217,7 @@ func (c *Client) DeleteAccounts(request *DeleteAccountsRequest) (response *Delet } // DeleteAccounts -// 本接口(DeleteAccounts)用于删除云数据库的账户。 +// 本接口(DeleteAccounts)用于删除云数据库的账户。 // // 可能返回的错误码: // FAILEDOPERATION_CREATEACCOUNTERROR = "FailedOperation.CreateAccountError" @@ -2138,6 +2254,7 @@ func (c *Client) DeleteAccountsWithContext(ctx context.Context, request *DeleteA if request == nil { request = NewDeleteAccountsRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "DeleteAccounts") if c.GetCredential() == nil { return nil, errors.New("DeleteAccounts require credential") @@ -2193,6 +2310,7 @@ func (c *Client) DeleteAuditLogFileWithContext(ctx context.Context, request *Del if request == nil { request = NewDeleteAuditLogFileRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "DeleteAuditLogFile") if c.GetCredential() == nil { return nil, errors.New("DeleteAuditLogFile require credential") @@ -2270,6 +2388,7 @@ func (c *Client) DeleteAuditPolicyWithContext(ctx context.Context, request *Dele if request == nil { request = NewDeleteAuditPolicyRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "DeleteAuditPolicy") if c.GetCredential() == nil { return nil, errors.New("DeleteAuditPolicy require credential") @@ -2302,6 +2421,10 @@ func NewDeleteAuditRuleResponse() (response *DeleteAuditRuleResponse) { } // DeleteAuditRule +// 不再支持审计规则创建 +// +// +// // 本接口(DeleteAuditRule)用于删除用户的审计规则。 // // 可能返回的错误码: @@ -2321,6 +2444,10 @@ func (c *Client) DeleteAuditRule(request *DeleteAuditRuleRequest) (response *Del } // DeleteAuditRule +// 不再支持审计规则创建 +// +// +// // 本接口(DeleteAuditRule)用于删除用户的审计规则。 // // 可能返回的错误码: @@ -2339,6 +2466,7 @@ func (c *Client) DeleteAuditRuleWithContext(ctx context.Context, request *Delete if request == nil { request = NewDeleteAuditRuleRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "DeleteAuditRule") if c.GetCredential() == nil { return nil, errors.New("DeleteAuditRule require credential") @@ -2371,7 +2499,7 @@ func NewDeleteAuditRuleTemplatesResponse() (response *DeleteAuditRuleTemplatesRe } // DeleteAuditRuleTemplates -// 删除审计规则模板 +// 本接口(DeleteAuditRuleTemplates)用于删除审计规则模板。 // // 可能返回的错误码: // INVALIDPARAMETER_EXCEPTIONPARAM = "InvalidParameter.ExceptionParam" @@ -2381,7 +2509,7 @@ func (c *Client) DeleteAuditRuleTemplates(request *DeleteAuditRuleTemplatesReque } // DeleteAuditRuleTemplates -// 删除审计规则模板 +// 本接口(DeleteAuditRuleTemplates)用于删除审计规则模板。 // // 可能返回的错误码: // INVALIDPARAMETER_EXCEPTIONPARAM = "InvalidParameter.ExceptionParam" @@ -2390,6 +2518,7 @@ func (c *Client) DeleteAuditRuleTemplatesWithContext(ctx context.Context, reques if request == nil { request = NewDeleteAuditRuleTemplatesRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "DeleteAuditRuleTemplates") if c.GetCredential() == nil { return nil, errors.New("DeleteAuditRuleTemplates require credential") @@ -2422,7 +2551,7 @@ func NewDeleteBackupResponse() (response *DeleteBackupResponse) { } // DeleteBackup -// 本接口(DeleteBackup)用于删除数据库备份。本接口只支持删除手动发起的备份。 +// 本接口(DeleteBackup)用于删除数据库备份。本接口只支持删除手动发起的备份。 // // 可能返回的错误码: // CDBERROR_BACKUPERROR = "CdbError.BackupError" @@ -2436,7 +2565,7 @@ func (c *Client) DeleteBackup(request *DeleteBackupRequest) (response *DeleteBac } // DeleteBackup -// 本接口(DeleteBackup)用于删除数据库备份。本接口只支持删除手动发起的备份。 +// 本接口(DeleteBackup)用于删除数据库备份。本接口只支持删除手动发起的备份。 // // 可能返回的错误码: // CDBERROR_BACKUPERROR = "CdbError.BackupError" @@ -2449,6 +2578,7 @@ func (c *Client) DeleteBackupWithContext(ctx context.Context, request *DeleteBac if request == nil { request = NewDeleteBackupRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "DeleteBackup") if c.GetCredential() == nil { return nil, errors.New("DeleteBackup require credential") @@ -2528,6 +2658,7 @@ func (c *Client) DeleteDatabaseWithContext(ctx context.Context, request *DeleteD if request == nil { request = NewDeleteDatabaseRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "DeleteDatabase") if c.GetCredential() == nil { return nil, errors.New("DeleteDatabase require credential") @@ -2589,6 +2720,7 @@ func (c *Client) DeleteDeployGroupsWithContext(ctx context.Context, request *Del if request == nil { request = NewDeleteDeployGroupsRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "DeleteDeployGroups") if c.GetCredential() == nil { return nil, errors.New("DeleteDeployGroups require credential") @@ -2621,7 +2753,9 @@ func NewDeleteParamTemplateResponse() (response *DeleteParamTemplateResponse) { } // DeleteParamTemplate -// 该接口(DeleteParamTemplate)用于删除参数模板,全地域公共参数Region均为ap-guangzhou。 +// 该接口(DeleteParamTemplate)用于删除参数模板。 +// +// 说明:参数模板为公共组件,配置完成后全地域生效。接口调用配置地域可选择广州、新加坡。 // // 可能返回的错误码: // AUTHFAILURE = "AuthFailure" @@ -2633,7 +2767,9 @@ func (c *Client) DeleteParamTemplate(request *DeleteParamTemplateRequest) (respo } // DeleteParamTemplate -// 该接口(DeleteParamTemplate)用于删除参数模板,全地域公共参数Region均为ap-guangzhou。 +// 该接口(DeleteParamTemplate)用于删除参数模板。 +// +// 说明:参数模板为公共组件,配置完成后全地域生效。接口调用配置地域可选择广州、新加坡。 // // 可能返回的错误码: // AUTHFAILURE = "AuthFailure" @@ -2644,6 +2780,7 @@ func (c *Client) DeleteParamTemplateWithContext(ctx context.Context, request *De if request == nil { request = NewDeleteParamTemplateRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "DeleteParamTemplate") if c.GetCredential() == nil { return nil, errors.New("DeleteParamTemplate require credential") @@ -2656,6 +2793,62 @@ func (c *Client) DeleteParamTemplateWithContext(ctx context.Context, request *De return } +func NewDeleteRotationPasswordRequest() (request *DeleteRotationPasswordRequest) { + request = &DeleteRotationPasswordRequest{ + BaseRequest: &tchttp.BaseRequest{}, + } + + request.Init().WithApiInfo("cdb", APIVersion, "DeleteRotationPassword") + + + return +} + +func NewDeleteRotationPasswordResponse() (response *DeleteRotationPasswordResponse) { + response = &DeleteRotationPasswordResponse{ + BaseResponse: &tchttp.BaseResponse{}, + } + return + +} + +// DeleteRotationPassword +// 本接口(DeleteRotationPassword)用于关闭实例账户密码轮转。 +// +// 可能返回的错误码: +// AUTHFAILURE = "AuthFailure" +// INTERNALERROR_DATABASEACCESSERROR = "InternalError.DatabaseAccessError" +// INTERNALERROR_PARAMERROR = "InternalError.ParamError" +// INVALIDPARAMETER = "InvalidParameter" +func (c *Client) DeleteRotationPassword(request *DeleteRotationPasswordRequest) (response *DeleteRotationPasswordResponse, err error) { + return c.DeleteRotationPasswordWithContext(context.Background(), request) +} + +// DeleteRotationPassword +// 本接口(DeleteRotationPassword)用于关闭实例账户密码轮转。 +// +// 可能返回的错误码: +// AUTHFAILURE = "AuthFailure" +// INTERNALERROR_DATABASEACCESSERROR = "InternalError.DatabaseAccessError" +// INTERNALERROR_PARAMERROR = "InternalError.ParamError" +// INVALIDPARAMETER = "InvalidParameter" +func (c *Client) DeleteRotationPasswordWithContext(ctx context.Context, request *DeleteRotationPasswordRequest) (response *DeleteRotationPasswordResponse, err error) { + if request == nil { + request = NewDeleteRotationPasswordRequest() + } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "DeleteRotationPassword") + + if c.GetCredential() == nil { + return nil, errors.New("DeleteRotationPassword require credential") + } + + request.SetContext(ctx) + + response = NewDeleteRotationPasswordResponse() + err = c.Send(request, response) + return +} + func NewDeleteTimeWindowRequest() (request *DeleteTimeWindowRequest) { request = &DeleteTimeWindowRequest{ BaseRequest: &tchttp.BaseRequest{}, @@ -2676,7 +2869,7 @@ func NewDeleteTimeWindowResponse() (response *DeleteTimeWindowResponse) { } // DeleteTimeWindow -// 本接口(DeleteTimeWindow)用于删除云数据库实例的维护时间窗口。删除实例维护时间窗口之后,默认的维护时间窗为 03:00-04:00,即当选择在维护时间窗口内切换访问新实例时,默认会在 03:00-04:00 点进行切换访问新实例。 +// 本接口(DeleteTimeWindow)用于删除云数据库实例的维护时间窗口。删除实例维护时间窗口之后,默认的维护时间窗为每天的03:00-04:00,数据校验延迟阈值为10秒,即当选择在维护时间窗口内切换访问新实例时,默认会在03:00-04:00点进行切换访问新实例。 // // 可能返回的错误码: // AUTHFAILURE = "AuthFailure" @@ -2687,7 +2880,7 @@ func (c *Client) DeleteTimeWindow(request *DeleteTimeWindowRequest) (response *D } // DeleteTimeWindow -// 本接口(DeleteTimeWindow)用于删除云数据库实例的维护时间窗口。删除实例维护时间窗口之后,默认的维护时间窗为 03:00-04:00,即当选择在维护时间窗口内切换访问新实例时,默认会在 03:00-04:00 点进行切换访问新实例。 +// 本接口(DeleteTimeWindow)用于删除云数据库实例的维护时间窗口。删除实例维护时间窗口之后,默认的维护时间窗为每天的03:00-04:00,数据校验延迟阈值为10秒,即当选择在维护时间窗口内切换访问新实例时,默认会在03:00-04:00点进行切换访问新实例。 // // 可能返回的错误码: // AUTHFAILURE = "AuthFailure" @@ -2697,6 +2890,7 @@ func (c *Client) DeleteTimeWindowWithContext(ctx context.Context, request *Delet if request == nil { request = NewDeleteTimeWindowRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "DeleteTimeWindow") if c.GetCredential() == nil { return nil, errors.New("DeleteTimeWindow require credential") @@ -2729,7 +2923,7 @@ func NewDescribeAccountPrivilegesResponse() (response *DescribeAccountPrivileges } // DescribeAccountPrivileges -// 本接口(DescribeAccountPrivileges)用于查询云数据库账户支持的权限信息。 +// 本接口(DescribeAccountPrivileges)用于查询云数据库账户支持的权限信息。 // // 可能返回的错误码: // CDBERROR = "CdbError" @@ -2764,14 +2958,14 @@ func NewDescribeAccountPrivilegesResponse() (response *DescribeAccountPrivileges // OPERATIONDENIED_INSTANCESTATUSERROR = "OperationDenied.InstanceStatusError" // OPERATIONDENIED_NOTSUPPORTMODIFYLOCALROOTHOSTERROR = "OperationDenied.NotSupportModifyLocalRootHostError" // RESOURCENOTFOUND_CDBINSTANCENOTFOUNDERROR = "ResourceNotFound.CdbInstanceNotFoundError" -// RESOURCENOTFOUND_INSTANCENOTFUNDERROR = "ResourceNotFound.InstanceNotFundError" +// RESOURCENOTFOUND_INSTANCENOTFOUNDERROR = "ResourceNotFound.InstanceNotFoundError" // UNSUPPORTEDOPERATION_PRIVILEGESUNSUPPORTEDERROR = "UnsupportedOperation.PrivilegesUnsupportedError" func (c *Client) DescribeAccountPrivileges(request *DescribeAccountPrivilegesRequest) (response *DescribeAccountPrivilegesResponse, err error) { return c.DescribeAccountPrivilegesWithContext(context.Background(), request) } // DescribeAccountPrivileges -// 本接口(DescribeAccountPrivileges)用于查询云数据库账户支持的权限信息。 +// 本接口(DescribeAccountPrivileges)用于查询云数据库账户支持的权限信息。 // // 可能返回的错误码: // CDBERROR = "CdbError" @@ -2806,12 +3000,13 @@ func (c *Client) DescribeAccountPrivileges(request *DescribeAccountPrivilegesReq // OPERATIONDENIED_INSTANCESTATUSERROR = "OperationDenied.InstanceStatusError" // OPERATIONDENIED_NOTSUPPORTMODIFYLOCALROOTHOSTERROR = "OperationDenied.NotSupportModifyLocalRootHostError" // RESOURCENOTFOUND_CDBINSTANCENOTFOUNDERROR = "ResourceNotFound.CdbInstanceNotFoundError" -// RESOURCENOTFOUND_INSTANCENOTFUNDERROR = "ResourceNotFound.InstanceNotFundError" +// RESOURCENOTFOUND_INSTANCENOTFOUNDERROR = "ResourceNotFound.InstanceNotFoundError" // UNSUPPORTEDOPERATION_PRIVILEGESUNSUPPORTEDERROR = "UnsupportedOperation.PrivilegesUnsupportedError" func (c *Client) DescribeAccountPrivilegesWithContext(ctx context.Context, request *DescribeAccountPrivilegesRequest) (response *DescribeAccountPrivilegesResponse, err error) { if request == nil { request = NewDescribeAccountPrivilegesRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "DescribeAccountPrivileges") if c.GetCredential() == nil { return nil, errors.New("DescribeAccountPrivileges require credential") @@ -2844,7 +3039,7 @@ func NewDescribeAccountsResponse() (response *DescribeAccountsResponse) { } // DescribeAccounts -// 本接口(DescribeAccounts)用于查询云数据库的所有账户信息。 +// 本接口(DescribeAccounts)用于查询云数据库的所有账户信息。 // // 可能返回的错误码: // FAILEDOPERATION_CREATEACCOUNTERROR = "FailedOperation.CreateAccountError" @@ -2884,7 +3079,7 @@ func NewDescribeAccountsResponse() (response *DescribeAccountsResponse) { // OPERATIONDENIED_NOTSUPPORTMODIFYLOCALROOTHOSTERROR = "OperationDenied.NotSupportModifyLocalRootHostError" // OPERATIONDENIED_OPERATIONDENIEDERROR = "OperationDenied.OperationDeniedError" // RESOURCENOTFOUND_CDBINSTANCENOTFOUNDERROR = "ResourceNotFound.CdbInstanceNotFoundError" -// RESOURCENOTFOUND_INSTANCENOTFUNDERROR = "ResourceNotFound.InstanceNotFundError" +// RESOURCENOTFOUND_INSTANCENOTFOUNDERROR = "ResourceNotFound.InstanceNotFoundError" // UNSUPPORTEDOPERATION = "UnsupportedOperation" // UNSUPPORTEDOPERATION_PRIVILEGESUNSUPPORTEDERROR = "UnsupportedOperation.PrivilegesUnsupportedError" func (c *Client) DescribeAccounts(request *DescribeAccountsRequest) (response *DescribeAccountsResponse, err error) { @@ -2892,7 +3087,7 @@ func (c *Client) DescribeAccounts(request *DescribeAccountsRequest) (response *D } // DescribeAccounts -// 本接口(DescribeAccounts)用于查询云数据库的所有账户信息。 +// 本接口(DescribeAccounts)用于查询云数据库的所有账户信息。 // // 可能返回的错误码: // FAILEDOPERATION_CREATEACCOUNTERROR = "FailedOperation.CreateAccountError" @@ -2932,13 +3127,14 @@ func (c *Client) DescribeAccounts(request *DescribeAccountsRequest) (response *D // OPERATIONDENIED_NOTSUPPORTMODIFYLOCALROOTHOSTERROR = "OperationDenied.NotSupportModifyLocalRootHostError" // OPERATIONDENIED_OPERATIONDENIEDERROR = "OperationDenied.OperationDeniedError" // RESOURCENOTFOUND_CDBINSTANCENOTFOUNDERROR = "ResourceNotFound.CdbInstanceNotFoundError" -// RESOURCENOTFOUND_INSTANCENOTFUNDERROR = "ResourceNotFound.InstanceNotFundError" +// RESOURCENOTFOUND_INSTANCENOTFOUNDERROR = "ResourceNotFound.InstanceNotFoundError" // UNSUPPORTEDOPERATION = "UnsupportedOperation" // UNSUPPORTEDOPERATION_PRIVILEGESUNSUPPORTEDERROR = "UnsupportedOperation.PrivilegesUnsupportedError" func (c *Client) DescribeAccountsWithContext(ctx context.Context, request *DescribeAccountsRequest) (response *DescribeAccountsResponse, err error) { if request == nil { request = NewDescribeAccountsRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "DescribeAccounts") if c.GetCredential() == nil { return nil, errors.New("DescribeAccounts require credential") @@ -3000,6 +3196,7 @@ func (c *Client) DescribeAsyncRequestInfoWithContext(ctx context.Context, reques if request == nil { request = NewDescribeAsyncRequestInfoRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "DescribeAsyncRequestInfo") if c.GetCredential() == nil { return nil, errors.New("DescribeAsyncRequestInfo require credential") @@ -3061,6 +3258,7 @@ func (c *Client) DescribeAuditConfigWithContext(ctx context.Context, request *De if request == nil { request = NewDescribeAuditConfigRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "DescribeAuditConfig") if c.GetCredential() == nil { return nil, errors.New("DescribeAuditConfig require credential") @@ -3093,7 +3291,7 @@ func NewDescribeAuditInstanceListResponse() (response *DescribeAuditInstanceList } // DescribeAuditInstanceList -// 获取审计实例列表 +// 本接口(DescribeAuditInstanceList)用于获取审计实例列表。 // // 可能返回的错误码: // FAILEDOPERATION_AUDITCONFIGNOTEXIST = "FailedOperation.AuditConfigNotExist" @@ -3108,7 +3306,7 @@ func (c *Client) DescribeAuditInstanceList(request *DescribeAuditInstanceListReq } // DescribeAuditInstanceList -// 获取审计实例列表 +// 本接口(DescribeAuditInstanceList)用于获取审计实例列表。 // // 可能返回的错误码: // FAILEDOPERATION_AUDITCONFIGNOTEXIST = "FailedOperation.AuditConfigNotExist" @@ -3122,6 +3320,7 @@ func (c *Client) DescribeAuditInstanceListWithContext(ctx context.Context, reque if request == nil { request = NewDescribeAuditInstanceListRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "DescribeAuditInstanceList") if c.GetCredential() == nil { return nil, errors.New("DescribeAuditInstanceList require credential") @@ -3154,10 +3353,11 @@ func NewDescribeAuditLogFilesResponse() (response *DescribeAuditLogFilesResponse } // DescribeAuditLogFiles -// 本接口(DescribeAuditLogFiles)用于查询云数据库实例的审计日志文件。 +// 本接口(DescribeAuditLogFiles)用于查询云数据库实例的审计日志文件。 // // 可能返回的错误码: // INTERNALERROR_DATABASEACCESSERROR = "InternalError.DatabaseAccessError" +// INTERNALERROR_TRANSACTIOBEGINERROR = "InternalError.TransactioBeginError" // INTERNALERROR_TRANSACTIONBEGINERROR = "InternalError.TransactionBeginError" // INVALIDPARAMETER = "InvalidParameter" // INVALIDPARAMETER_CONTROLLERNOTFOUNDERROR = "InvalidParameter.ControllerNotFoundError" @@ -3167,10 +3367,11 @@ func (c *Client) DescribeAuditLogFiles(request *DescribeAuditLogFilesRequest) (r } // DescribeAuditLogFiles -// 本接口(DescribeAuditLogFiles)用于查询云数据库实例的审计日志文件。 +// 本接口(DescribeAuditLogFiles)用于查询云数据库实例的审计日志文件。 // // 可能返回的错误码: // INTERNALERROR_DATABASEACCESSERROR = "InternalError.DatabaseAccessError" +// INTERNALERROR_TRANSACTIOBEGINERROR = "InternalError.TransactioBeginError" // INTERNALERROR_TRANSACTIONBEGINERROR = "InternalError.TransactionBeginError" // INVALIDPARAMETER = "InvalidParameter" // INVALIDPARAMETER_CONTROLLERNOTFOUNDERROR = "InvalidParameter.ControllerNotFoundError" @@ -3179,6 +3380,7 @@ func (c *Client) DescribeAuditLogFilesWithContext(ctx context.Context, request * if request == nil { request = NewDescribeAuditLogFilesRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "DescribeAuditLogFiles") if c.GetCredential() == nil { return nil, errors.New("DescribeAuditLogFiles require credential") @@ -3211,7 +3413,7 @@ func NewDescribeAuditLogsResponse() (response *DescribeAuditLogsResponse) { } // DescribeAuditLogs -// 本接口(DescribeAuditLogs)用于查询数据库审计日志。 +// 本接口(DescribeAuditLogs)用于查询数据库审计日志。 // // 可能返回的错误码: // FAILEDOPERATION_QUERYAUDITTASKFAILERROR = "FailedOperation.QueryAuditTaskFailError" @@ -3236,7 +3438,7 @@ func (c *Client) DescribeAuditLogs(request *DescribeAuditLogsRequest) (response } // DescribeAuditLogs -// 本接口(DescribeAuditLogs)用于查询数据库审计日志。 +// 本接口(DescribeAuditLogs)用于查询数据库审计日志。 // // 可能返回的错误码: // FAILEDOPERATION_QUERYAUDITTASKFAILERROR = "FailedOperation.QueryAuditTaskFailError" @@ -3260,6 +3462,7 @@ func (c *Client) DescribeAuditLogsWithContext(ctx context.Context, request *Desc if request == nil { request = NewDescribeAuditLogsRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "DescribeAuditLogs") if c.GetCredential() == nil { return nil, errors.New("DescribeAuditLogs require credential") @@ -3292,7 +3495,7 @@ func NewDescribeAuditPoliciesResponse() (response *DescribeAuditPoliciesResponse } // DescribeAuditPolicies -// 本接口(DescribeAuditPolicies)用于查询云数据库实例的审计策略。 +// 本接口(DescribeAuditPolicies)用于查询云数据库实例的审计策略。 // // 可能返回的错误码: // INTERNALERROR_DATABASEACCESSERROR = "InternalError.DatabaseAccessError" @@ -3309,7 +3512,7 @@ func (c *Client) DescribeAuditPolicies(request *DescribeAuditPoliciesRequest) (r } // DescribeAuditPolicies -// 本接口(DescribeAuditPolicies)用于查询云数据库实例的审计策略。 +// 本接口(DescribeAuditPolicies)用于查询云数据库实例的审计策略。 // // 可能返回的错误码: // INTERNALERROR_DATABASEACCESSERROR = "InternalError.DatabaseAccessError" @@ -3325,6 +3528,7 @@ func (c *Client) DescribeAuditPoliciesWithContext(ctx context.Context, request * if request == nil { request = NewDescribeAuditPoliciesRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "DescribeAuditPolicies") if c.GetCredential() == nil { return nil, errors.New("DescribeAuditPolicies require credential") @@ -3357,7 +3561,7 @@ func NewDescribeAuditRuleTemplateModifyHistoryResponse() (response *DescribeAudi } // DescribeAuditRuleTemplateModifyHistory -// 查询规则模板变更记录 +// 本接口(DescribeAuditRuleTemplateModifyHistory)用于查询规则模板变更记录。 // // 可能返回的错误码: // INVALIDPARAMETER_CONTROLLERNOTFOUNDERROR = "InvalidParameter.ControllerNotFoundError" @@ -3366,7 +3570,7 @@ func (c *Client) DescribeAuditRuleTemplateModifyHistory(request *DescribeAuditRu } // DescribeAuditRuleTemplateModifyHistory -// 查询规则模板变更记录 +// 本接口(DescribeAuditRuleTemplateModifyHistory)用于查询规则模板变更记录。 // // 可能返回的错误码: // INVALIDPARAMETER_CONTROLLERNOTFOUNDERROR = "InvalidParameter.ControllerNotFoundError" @@ -3374,6 +3578,7 @@ func (c *Client) DescribeAuditRuleTemplateModifyHistoryWithContext(ctx context.C if request == nil { request = NewDescribeAuditRuleTemplateModifyHistoryRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "DescribeAuditRuleTemplateModifyHistory") if c.GetCredential() == nil { return nil, errors.New("DescribeAuditRuleTemplateModifyHistory require credential") @@ -3406,7 +3611,7 @@ func NewDescribeAuditRuleTemplatesResponse() (response *DescribeAuditRuleTemplat } // DescribeAuditRuleTemplates -// 查询审计规则模板信息 +// 本接口(DescribeAuditRuleTemplates)用于查询审计规则模板信息。 // // 可能返回的错误码: // FAILEDOPERATION_DBOPERATIONACTIONERROR = "FailedOperation.DBOperationActionError" @@ -3416,7 +3621,7 @@ func (c *Client) DescribeAuditRuleTemplates(request *DescribeAuditRuleTemplatesR } // DescribeAuditRuleTemplates -// 查询审计规则模板信息 +// 本接口(DescribeAuditRuleTemplates)用于查询审计规则模板信息。 // // 可能返回的错误码: // FAILEDOPERATION_DBOPERATIONACTIONERROR = "FailedOperation.DBOperationActionError" @@ -3425,6 +3630,7 @@ func (c *Client) DescribeAuditRuleTemplatesWithContext(ctx context.Context, requ if request == nil { request = NewDescribeAuditRuleTemplatesRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "DescribeAuditRuleTemplates") if c.GetCredential() == nil { return nil, errors.New("DescribeAuditRuleTemplates require credential") @@ -3457,6 +3663,10 @@ func NewDescribeAuditRulesResponse() (response *DescribeAuditRulesResponse) { } // DescribeAuditRules +// 不再支持审计规则创建 +// +// +// // 本接口(DescribeAuditRules)用于查询用户在当前地域的审计规则。 // // 可能返回的错误码: @@ -3471,6 +3681,10 @@ func (c *Client) DescribeAuditRules(request *DescribeAuditRulesRequest) (respons } // DescribeAuditRules +// 不再支持审计规则创建 +// +// +// // 本接口(DescribeAuditRules)用于查询用户在当前地域的审计规则。 // // 可能返回的错误码: @@ -3484,6 +3698,7 @@ func (c *Client) DescribeAuditRulesWithContext(ctx context.Context, request *Des if request == nil { request = NewDescribeAuditRulesRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "DescribeAuditRules") if c.GetCredential() == nil { return nil, errors.New("DescribeAuditRules require credential") @@ -3516,7 +3731,7 @@ func NewDescribeBackupConfigResponse() (response *DescribeBackupConfigResponse) } // DescribeBackupConfig -// 本接口(DescribeBackupConfig)用于查询数据库备份配置信息。 +// 本接口(DescribeBackupConfig)用于查询数据库备份配置信息。 // // 可能返回的错误码: // INTERNALERROR_CDBCGWERROR = "InternalError.CdbCgwError" @@ -3533,7 +3748,7 @@ func (c *Client) DescribeBackupConfig(request *DescribeBackupConfigRequest) (res } // DescribeBackupConfig -// 本接口(DescribeBackupConfig)用于查询数据库备份配置信息。 +// 本接口(DescribeBackupConfig)用于查询数据库备份配置信息。 // // 可能返回的错误码: // INTERNALERROR_CDBCGWERROR = "InternalError.CdbCgwError" @@ -3549,6 +3764,7 @@ func (c *Client) DescribeBackupConfigWithContext(ctx context.Context, request *D if request == nil { request = NewDescribeBackupConfigRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "DescribeBackupConfig") if c.GetCredential() == nil { return nil, errors.New("DescribeBackupConfig require credential") @@ -3581,7 +3797,7 @@ func NewDescribeBackupDecryptionKeyResponse() (response *DescribeBackupDecryptio } // DescribeBackupDecryptionKey -// 本接口(DescribeBackupDecryptionKey)用于查询备份文件解密密钥。 +// 本接口(DescribeBackupDecryptionKey)用于查询备份文件解密密钥。 // // 可能返回的错误码: // INTERNALERROR_DBRECORDNOTEXISTERROR = "InternalError.DBRecordNotExistError" @@ -3592,7 +3808,7 @@ func (c *Client) DescribeBackupDecryptionKey(request *DescribeBackupDecryptionKe } // DescribeBackupDecryptionKey -// 本接口(DescribeBackupDecryptionKey)用于查询备份文件解密密钥。 +// 本接口(DescribeBackupDecryptionKey)用于查询备份文件解密密钥。 // // 可能返回的错误码: // INTERNALERROR_DBRECORDNOTEXISTERROR = "InternalError.DBRecordNotExistError" @@ -3602,6 +3818,7 @@ func (c *Client) DescribeBackupDecryptionKeyWithContext(ctx context.Context, req if request == nil { request = NewDescribeBackupDecryptionKeyRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "DescribeBackupDecryptionKey") if c.GetCredential() == nil { return nil, errors.New("DescribeBackupDecryptionKey require credential") @@ -3655,6 +3872,7 @@ func (c *Client) DescribeBackupDownloadRestrictionWithContext(ctx context.Contex if request == nil { request = NewDescribeBackupDownloadRestrictionRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "DescribeBackupDownloadRestriction") if c.GetCredential() == nil { return nil, errors.New("DescribeBackupDownloadRestriction require credential") @@ -3706,6 +3924,7 @@ func (c *Client) DescribeBackupEncryptionStatusWithContext(ctx context.Context, if request == nil { request = NewDescribeBackupEncryptionStatusRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "DescribeBackupEncryptionStatus") if c.GetCredential() == nil { return nil, errors.New("DescribeBackupEncryptionStatus require credential") @@ -3765,6 +3984,7 @@ func (c *Client) DescribeBackupOverviewWithContext(ctx context.Context, request if request == nil { request = NewDescribeBackupOverviewRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "DescribeBackupOverview") if c.GetCredential() == nil { return nil, errors.New("DescribeBackupOverview require credential") @@ -3797,7 +4017,7 @@ func NewDescribeBackupSummariesResponse() (response *DescribeBackupSummariesResp } // DescribeBackupSummaries -// 本接口(DescribeBackupSummaries)用于查询备份的统计情况,返回以实例为维度的备份占用容量,以及每个实例的数据备份和日志备份的个数和容量(容量单位为字节)。 +// 本接口(DescribeBackupSummaries)用于查询备份的统计情况,返回以实例为维度的备份占用容量,以及每个实例的数据备份和日志备份的个数和容量(容量单位为字节)。 // // 可能返回的错误码: // AUTHFAILURE = "AuthFailure" @@ -3813,7 +4033,7 @@ func (c *Client) DescribeBackupSummaries(request *DescribeBackupSummariesRequest } // DescribeBackupSummaries -// 本接口(DescribeBackupSummaries)用于查询备份的统计情况,返回以实例为维度的备份占用容量,以及每个实例的数据备份和日志备份的个数和容量(容量单位为字节)。 +// 本接口(DescribeBackupSummaries)用于查询备份的统计情况,返回以实例为维度的备份占用容量,以及每个实例的数据备份和日志备份的个数和容量(容量单位为字节)。 // // 可能返回的错误码: // AUTHFAILURE = "AuthFailure" @@ -3828,6 +4048,7 @@ func (c *Client) DescribeBackupSummariesWithContext(ctx context.Context, request if request == nil { request = NewDescribeBackupSummariesRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "DescribeBackupSummaries") if c.GetCredential() == nil { return nil, errors.New("DescribeBackupSummaries require credential") @@ -3911,6 +4132,7 @@ func (c *Client) DescribeBackupsWithContext(ctx context.Context, request *Descri if request == nil { request = NewDescribeBackupsRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "DescribeBackups") if c.GetCredential() == nil { return nil, errors.New("DescribeBackups require credential") @@ -3968,6 +4190,7 @@ func (c *Client) DescribeBinlogBackupOverviewWithContext(ctx context.Context, re if request == nil { request = NewDescribeBinlogBackupOverviewRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "DescribeBinlogBackupOverview") if c.GetCredential() == nil { return nil, errors.New("DescribeBinlogBackupOverview require credential") @@ -4037,6 +4260,7 @@ func (c *Client) DescribeBinlogsWithContext(ctx context.Context, request *Descri if request == nil { request = NewDescribeBinlogsRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "DescribeBinlogs") if c.GetCredential() == nil { return nil, errors.New("DescribeBinlogs require credential") @@ -4049,6 +4273,64 @@ func (c *Client) DescribeBinlogsWithContext(ctx context.Context, request *Descri return } +func NewDescribeCPUExpandStrategyInfoRequest() (request *DescribeCPUExpandStrategyInfoRequest) { + request = &DescribeCPUExpandStrategyInfoRequest{ + BaseRequest: &tchttp.BaseRequest{}, + } + + request.Init().WithApiInfo("cdb", APIVersion, "DescribeCPUExpandStrategyInfo") + + + return +} + +func NewDescribeCPUExpandStrategyInfoResponse() (response *DescribeCPUExpandStrategyInfoResponse) { + response = &DescribeCPUExpandStrategyInfoResponse{ + BaseResponse: &tchttp.BaseResponse{}, + } + return + +} + +// DescribeCPUExpandStrategyInfo +// 通过该 API 可以查询实例的 CPU 弹性扩容信息 +// +// 可能返回的错误码: +// FAILEDOPERATION_REMOTECALLUNMARSHALERROR = "FailedOperation.RemoteCallUnmarshalError" +// INTERNALERROR_DBRECORDNOTEXISTERROR = "InternalError.DBRecordNotExistError" +// INTERNALERROR_EXECHTTPREQUESTERROR = "InternalError.ExecHttpRequestError" +// INTERNALERROR_UNKNOWNERROR = "InternalError.UnknownError" +// INVALIDPARAMETER_JSONUNMARSHALERROR = "InvalidParameter.JsonUnmarshalError" +func (c *Client) DescribeCPUExpandStrategyInfo(request *DescribeCPUExpandStrategyInfoRequest) (response *DescribeCPUExpandStrategyInfoResponse, err error) { + return c.DescribeCPUExpandStrategyInfoWithContext(context.Background(), request) +} + +// DescribeCPUExpandStrategyInfo +// 通过该 API 可以查询实例的 CPU 弹性扩容信息 +// +// 可能返回的错误码: +// FAILEDOPERATION_REMOTECALLUNMARSHALERROR = "FailedOperation.RemoteCallUnmarshalError" +// INTERNALERROR_DBRECORDNOTEXISTERROR = "InternalError.DBRecordNotExistError" +// INTERNALERROR_EXECHTTPREQUESTERROR = "InternalError.ExecHttpRequestError" +// INTERNALERROR_UNKNOWNERROR = "InternalError.UnknownError" +// INVALIDPARAMETER_JSONUNMARSHALERROR = "InvalidParameter.JsonUnmarshalError" +func (c *Client) DescribeCPUExpandStrategyInfoWithContext(ctx context.Context, request *DescribeCPUExpandStrategyInfoRequest) (response *DescribeCPUExpandStrategyInfoResponse, err error) { + if request == nil { + request = NewDescribeCPUExpandStrategyInfoRequest() + } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "DescribeCPUExpandStrategyInfo") + + if c.GetCredential() == nil { + return nil, errors.New("DescribeCPUExpandStrategyInfo require credential") + } + + request.SetContext(ctx) + + response = NewDescribeCPUExpandStrategyInfoResponse() + err = c.Send(request, response) + return +} + func NewDescribeCdbProxyInfoRequest() (request *DescribeCdbProxyInfoRequest) { request = &DescribeCdbProxyInfoRequest{ BaseRequest: &tchttp.BaseRequest{}, @@ -4069,7 +4351,7 @@ func NewDescribeCdbProxyInfoResponse() (response *DescribeCdbProxyInfoResponse) } // DescribeCdbProxyInfo -// 查询数据库代理详情信息 +// 本接口(DescribeCdbProxyInfo)用于查询数据库代理详情信息。 // // 可能返回的错误码: // FAILEDOPERATION_DESCRIBEPROXYGROUPERROR = "FailedOperation.DescribeProxyGroupError" @@ -4082,7 +4364,7 @@ func (c *Client) DescribeCdbProxyInfo(request *DescribeCdbProxyInfoRequest) (res } // DescribeCdbProxyInfo -// 查询数据库代理详情信息 +// 本接口(DescribeCdbProxyInfo)用于查询数据库代理详情信息。 // // 可能返回的错误码: // FAILEDOPERATION_DESCRIBEPROXYGROUPERROR = "FailedOperation.DescribeProxyGroupError" @@ -4094,6 +4376,7 @@ func (c *Client) DescribeCdbProxyInfoWithContext(ctx context.Context, request *D if request == nil { request = NewDescribeCdbProxyInfoRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "DescribeCdbProxyInfo") if c.GetCredential() == nil { return nil, errors.New("DescribeCdbProxyInfo require credential") @@ -4151,6 +4434,7 @@ func (c *Client) DescribeCdbZoneConfigWithContext(ctx context.Context, request * if request == nil { request = NewDescribeCdbZoneConfigRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "DescribeCdbZoneConfig") if c.GetCredential() == nil { return nil, errors.New("DescribeCdbZoneConfig require credential") @@ -4183,7 +4467,7 @@ func NewDescribeCloneListResponse() (response *DescribeCloneListResponse) { } // DescribeCloneList -// 本接口(DescribeCloneList) 用于查询用户实例的克隆任务列表。 +// 本接口(DescribeCloneList)用于查询用户实例的克隆任务列表。 // // 可能返回的错误码: // CDBERROR = "CdbError" @@ -4194,7 +4478,7 @@ func (c *Client) DescribeCloneList(request *DescribeCloneListRequest) (response } // DescribeCloneList -// 本接口(DescribeCloneList) 用于查询用户实例的克隆任务列表。 +// 本接口(DescribeCloneList)用于查询用户实例的克隆任务列表。 // // 可能返回的错误码: // CDBERROR = "CdbError" @@ -4204,6 +4488,7 @@ func (c *Client) DescribeCloneListWithContext(ctx context.Context, request *Desc if request == nil { request = NewDescribeCloneListRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "DescribeCloneList") if c.GetCredential() == nil { return nil, errors.New("DescribeCloneList require credential") @@ -4236,7 +4521,7 @@ func NewDescribeClusterInfoResponse() (response *DescribeClusterInfoResponse) { } // DescribeClusterInfo -// 本接口(DescribeClusterInfo)用于查询集群版实例信息。 +// 本接口(DescribeClusterInfo)用于查询云盘版实例信息。 // // 可能返回的错误码: // INTERNALERROR_DBOPERATIONERROR = "InternalError.DBOperationError" @@ -4247,7 +4532,7 @@ func (c *Client) DescribeClusterInfo(request *DescribeClusterInfoRequest) (respo } // DescribeClusterInfo -// 本接口(DescribeClusterInfo)用于查询集群版实例信息。 +// 本接口(DescribeClusterInfo)用于查询云盘版实例信息。 // // 可能返回的错误码: // INTERNALERROR_DBOPERATIONERROR = "InternalError.DBOperationError" @@ -4257,6 +4542,7 @@ func (c *Client) DescribeClusterInfoWithContext(ctx context.Context, request *De if request == nil { request = NewDescribeClusterInfoRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "DescribeClusterInfo") if c.GetCredential() == nil { return nil, errors.New("DescribeClusterInfo require credential") @@ -4269,59 +4555,56 @@ func (c *Client) DescribeClusterInfoWithContext(ctx context.Context, request *De return } -func NewDescribeCpuExpandStrategyRequest() (request *DescribeCpuExpandStrategyRequest) { - request = &DescribeCpuExpandStrategyRequest{ +func NewDescribeCpuExpandHistoryRequest() (request *DescribeCpuExpandHistoryRequest) { + request = &DescribeCpuExpandHistoryRequest{ BaseRequest: &tchttp.BaseRequest{}, } - request.Init().WithApiInfo("cdb", APIVersion, "DescribeCpuExpandStrategy") + request.Init().WithApiInfo("cdb", APIVersion, "DescribeCpuExpandHistory") return } -func NewDescribeCpuExpandStrategyResponse() (response *DescribeCpuExpandStrategyResponse) { - response = &DescribeCpuExpandStrategyResponse{ +func NewDescribeCpuExpandHistoryResponse() (response *DescribeCpuExpandHistoryResponse) { + response = &DescribeCpuExpandHistoryResponse{ BaseResponse: &tchttp.BaseResponse{}, } return } -// DescribeCpuExpandStrategy -// 通过该 API 可以查询实例的 CPU 弹性扩容策略 +// DescribeCpuExpandHistory +// 本接口(DescribeCpuExpandHistory)用于查询扩容历史。 // // 可能返回的错误码: -// FAILEDOPERATION_REMOTECALLUNMARSHALERROR = "FailedOperation.RemoteCallUnmarshalError" -// INTERNALERROR_DBRECORDNOTEXISTERROR = "InternalError.DBRecordNotExistError" -// INTERNALERROR_EXECHTTPREQUESTERROR = "InternalError.ExecHttpRequestError" -// INTERNALERROR_UNKNOWNERROR = "InternalError.UnknownError" -// INVALIDPARAMETER_JSONUNMARSHALERROR = "InvalidParameter.JsonUnmarshalError" -func (c *Client) DescribeCpuExpandStrategy(request *DescribeCpuExpandStrategyRequest) (response *DescribeCpuExpandStrategyResponse, err error) { - return c.DescribeCpuExpandStrategyWithContext(context.Background(), request) +// INTERNALERROR_DBOPERATIONERROR = "InternalError.DBOperationError" +// INTERNALERROR_NETWORKERROR = "InternalError.NetworkError" +// UNAUTHORIZEDOPERATION = "UnauthorizedOperation" +func (c *Client) DescribeCpuExpandHistory(request *DescribeCpuExpandHistoryRequest) (response *DescribeCpuExpandHistoryResponse, err error) { + return c.DescribeCpuExpandHistoryWithContext(context.Background(), request) } -// DescribeCpuExpandStrategy -// 通过该 API 可以查询实例的 CPU 弹性扩容策略 +// DescribeCpuExpandHistory +// 本接口(DescribeCpuExpandHistory)用于查询扩容历史。 // // 可能返回的错误码: -// FAILEDOPERATION_REMOTECALLUNMARSHALERROR = "FailedOperation.RemoteCallUnmarshalError" -// INTERNALERROR_DBRECORDNOTEXISTERROR = "InternalError.DBRecordNotExistError" -// INTERNALERROR_EXECHTTPREQUESTERROR = "InternalError.ExecHttpRequestError" -// INTERNALERROR_UNKNOWNERROR = "InternalError.UnknownError" -// INVALIDPARAMETER_JSONUNMARSHALERROR = "InvalidParameter.JsonUnmarshalError" -func (c *Client) DescribeCpuExpandStrategyWithContext(ctx context.Context, request *DescribeCpuExpandStrategyRequest) (response *DescribeCpuExpandStrategyResponse, err error) { +// INTERNALERROR_DBOPERATIONERROR = "InternalError.DBOperationError" +// INTERNALERROR_NETWORKERROR = "InternalError.NetworkError" +// UNAUTHORIZEDOPERATION = "UnauthorizedOperation" +func (c *Client) DescribeCpuExpandHistoryWithContext(ctx context.Context, request *DescribeCpuExpandHistoryRequest) (response *DescribeCpuExpandHistoryResponse, err error) { if request == nil { - request = NewDescribeCpuExpandStrategyRequest() + request = NewDescribeCpuExpandHistoryRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "DescribeCpuExpandHistory") if c.GetCredential() == nil { - return nil, errors.New("DescribeCpuExpandStrategy require credential") + return nil, errors.New("DescribeCpuExpandHistory require credential") } request.SetContext(ctx) - response = NewDescribeCpuExpandStrategyResponse() + response = NewDescribeCpuExpandHistoryResponse() err = c.Send(request, response) return } @@ -4346,7 +4629,7 @@ func NewDescribeDBFeaturesResponse() (response *DescribeDBFeaturesResponse) { } // DescribeDBFeatures -// 本接口(DescribeDBFeatures)用于查询云数据库版本属性,包括是否支持数据库加密、数据库审计等功能。 +// 本接口(DescribeDBFeatures)用于查询云数据库版本属性,包括是否支持数据库加密、数据库审计等功能。 // // 可能返回的错误码: // AUTHFAILURE = "AuthFailure" @@ -4363,7 +4646,7 @@ func (c *Client) DescribeDBFeatures(request *DescribeDBFeaturesRequest) (respons } // DescribeDBFeatures -// 本接口(DescribeDBFeatures)用于查询云数据库版本属性,包括是否支持数据库加密、数据库审计等功能。 +// 本接口(DescribeDBFeatures)用于查询云数据库版本属性,包括是否支持数据库加密、数据库审计等功能。 // // 可能返回的错误码: // AUTHFAILURE = "AuthFailure" @@ -4379,6 +4662,7 @@ func (c *Client) DescribeDBFeaturesWithContext(ctx context.Context, request *Des if request == nil { request = NewDescribeDBFeaturesRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "DescribeDBFeatures") if c.GetCredential() == nil { return nil, errors.New("DescribeDBFeatures require credential") @@ -4434,6 +4718,7 @@ func (c *Client) DescribeDBImportRecordsWithContext(ctx context.Context, request if request == nil { request = NewDescribeDBImportRecordsRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "DescribeDBImportRecords") if c.GetCredential() == nil { return nil, errors.New("DescribeDBImportRecords require credential") @@ -4503,6 +4788,7 @@ func (c *Client) DescribeDBInstanceCharsetWithContext(ctx context.Context, reque if request == nil { request = NewDescribeDBInstanceCharsetRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "DescribeDBInstanceCharset") if c.GetCredential() == nil { return nil, errors.New("DescribeDBInstanceCharset require credential") @@ -4535,7 +4821,7 @@ func NewDescribeDBInstanceConfigResponse() (response *DescribeDBInstanceConfigRe } // DescribeDBInstanceConfig -// 本接口(DescribeDBInstanceConfig)用于云数据库实例的配置信息,包括同步模式,部署模式等。 +// 本接口(DescribeDBInstanceConfig)用于查询云数据库实例的配置信息,包括同步模式,部署模式等。 // // 可能返回的错误码: // AUTHFAILURE = "AuthFailure" @@ -4557,7 +4843,7 @@ func (c *Client) DescribeDBInstanceConfig(request *DescribeDBInstanceConfigReque } // DescribeDBInstanceConfig -// 本接口(DescribeDBInstanceConfig)用于云数据库实例的配置信息,包括同步模式,部署模式等。 +// 本接口(DescribeDBInstanceConfig)用于查询云数据库实例的配置信息,包括同步模式,部署模式等。 // // 可能返回的错误码: // AUTHFAILURE = "AuthFailure" @@ -4578,6 +4864,7 @@ func (c *Client) DescribeDBInstanceConfigWithContext(ctx context.Context, reques if request == nil { request = NewDescribeDBInstanceConfigRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "DescribeDBInstanceConfig") if c.GetCredential() == nil { return nil, errors.New("DescribeDBInstanceConfig require credential") @@ -4639,6 +4926,7 @@ func (c *Client) DescribeDBInstanceGTIDWithContext(ctx context.Context, request if request == nil { request = NewDescribeDBInstanceGTIDRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "DescribeDBInstanceGTID") if c.GetCredential() == nil { return nil, errors.New("DescribeDBInstanceGTID require credential") @@ -4671,7 +4959,7 @@ func NewDescribeDBInstanceInfoResponse() (response *DescribeDBInstanceInfoRespon } // DescribeDBInstanceInfo -// 查询实例基本信息(实例 ID ,实例名称,是否开通加密 ) +// 本接口(DescribeDBInstanceInfo)用于查询实例基本信息(实例 ID,实例名称,是否开通加密),只读实例不支持查询。 // // 可能返回的错误码: // AUTHFAILURE = "AuthFailure" @@ -4687,7 +4975,7 @@ func (c *Client) DescribeDBInstanceInfo(request *DescribeDBInstanceInfoRequest) } // DescribeDBInstanceInfo -// 查询实例基本信息(实例 ID ,实例名称,是否开通加密 ) +// 本接口(DescribeDBInstanceInfo)用于查询实例基本信息(实例 ID,实例名称,是否开通加密),只读实例不支持查询。 // // 可能返回的错误码: // AUTHFAILURE = "AuthFailure" @@ -4702,6 +4990,7 @@ func (c *Client) DescribeDBInstanceInfoWithContext(ctx context.Context, request if request == nil { request = NewDescribeDBInstanceInfoRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "DescribeDBInstanceInfo") if c.GetCredential() == nil { return nil, errors.New("DescribeDBInstanceInfo require credential") @@ -4734,7 +5023,7 @@ func NewDescribeDBInstanceLogToCLSResponse() (response *DescribeDBInstanceLogToC } // DescribeDBInstanceLogToCLS -// 本接口(DescribeDBInstanceLogToCLS)用于查询实例慢日志、错误日志投递CLS的配置,通过AppId、Region以及实例ID过滤出当前实例日志投递CLS的配置。 +// 本接口(DescribeDBInstanceLogToCLS)用于查询实例慢日志、错误日志投递CLS的配置,通过AppId、Region以及实例ID过滤出当前实例日志投递CLS的配置。 // // 可能返回的错误码: // FAILEDOPERATION_TIMEOUTERROR = "FailedOperation.TimeoutError" @@ -4750,7 +5039,7 @@ func (c *Client) DescribeDBInstanceLogToCLS(request *DescribeDBInstanceLogToCLSR } // DescribeDBInstanceLogToCLS -// 本接口(DescribeDBInstanceLogToCLS)用于查询实例慢日志、错误日志投递CLS的配置,通过AppId、Region以及实例ID过滤出当前实例日志投递CLS的配置。 +// 本接口(DescribeDBInstanceLogToCLS)用于查询实例慢日志、错误日志投递CLS的配置,通过AppId、Region以及实例ID过滤出当前实例日志投递CLS的配置。 // // 可能返回的错误码: // FAILEDOPERATION_TIMEOUTERROR = "FailedOperation.TimeoutError" @@ -4765,6 +5054,7 @@ func (c *Client) DescribeDBInstanceLogToCLSWithContext(ctx context.Context, requ if request == nil { request = NewDescribeDBInstanceLogToCLSRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "DescribeDBInstanceLogToCLS") if c.GetCredential() == nil { return nil, errors.New("DescribeDBInstanceLogToCLS require credential") @@ -4797,7 +5087,7 @@ func NewDescribeDBInstanceRebootTimeResponse() (response *DescribeDBInstanceRebo } // DescribeDBInstanceRebootTime -// 本接口(DescribeDBInstanceRebootTime)用于查询云数据库实例重启预计所需的时间。 +// 本接口(DescribeDBInstanceRebootTime)用于查询云数据库实例重启预计所需的时间。 // // 可能返回的错误码: // AUTHFAILURE = "AuthFailure" @@ -4808,7 +5098,7 @@ func (c *Client) DescribeDBInstanceRebootTime(request *DescribeDBInstanceRebootT } // DescribeDBInstanceRebootTime -// 本接口(DescribeDBInstanceRebootTime)用于查询云数据库实例重启预计所需的时间。 +// 本接口(DescribeDBInstanceRebootTime)用于查询云数据库实例重启预计所需的时间。 // // 可能返回的错误码: // AUTHFAILURE = "AuthFailure" @@ -4818,6 +5108,7 @@ func (c *Client) DescribeDBInstanceRebootTimeWithContext(ctx context.Context, re if request == nil { request = NewDescribeDBInstanceRebootTimeRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "DescribeDBInstanceRebootTime") if c.GetCredential() == nil { return nil, errors.New("DescribeDBInstanceRebootTime require credential") @@ -4850,7 +5141,7 @@ func NewDescribeDBInstancesResponse() (response *DescribeDBInstancesResponse) { } // DescribeDBInstances -// 本接口(DescribeDBInstances)用于查询云数据库实例列表,支持通过项目 ID、实例 ID、访问地址、实例状态等过滤条件来筛选实例。支持查询主实例、灾备实例和只读实例信息列表。 +// 本接口(DescribeDBInstances)用于查询云数据库实例列表,支持通过项目 ID、实例 ID、访问地址、实例状态等过滤条件来筛选实例。支持查询主实例、灾备实例和只读实例信息列表。 // // 可能返回的错误码: // AUTHFAILURE = "AuthFailure" @@ -4876,7 +5167,7 @@ func (c *Client) DescribeDBInstances(request *DescribeDBInstancesRequest) (respo } // DescribeDBInstances -// 本接口(DescribeDBInstances)用于查询云数据库实例列表,支持通过项目 ID、实例 ID、访问地址、实例状态等过滤条件来筛选实例。支持查询主实例、灾备实例和只读实例信息列表。 +// 本接口(DescribeDBInstances)用于查询云数据库实例列表,支持通过项目 ID、实例 ID、访问地址、实例状态等过滤条件来筛选实例。支持查询主实例、灾备实例和只读实例信息列表。 // // 可能返回的错误码: // AUTHFAILURE = "AuthFailure" @@ -4901,6 +5192,7 @@ func (c *Client) DescribeDBInstancesWithContext(ctx context.Context, request *De if request == nil { request = NewDescribeDBInstancesRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "DescribeDBInstances") if c.GetCredential() == nil { return nil, errors.New("DescribeDBInstances require credential") @@ -4933,7 +5225,7 @@ func NewDescribeDBPriceResponse() (response *DescribeDBPriceResponse) { } // DescribeDBPrice -// 本接口(DescribeDBPrice)用于查询购买或续费云数据库实例的价格,支持查询按量计费或者包年包月的价格。可传入实例类型、购买时长、购买数量、内存大小、硬盘大小和可用区信息等来查询实例价格。可传入实例名称来查询实例续费价格。 +// 本接口(DescribeDBPrice)用于查询购买或续费云数据库实例的价格,支持查询按量计费或者包年包月的价格。可传入实例类型、购买时长、购买数量、内存大小、硬盘大小和可用区信息等来查询实例价格。可传入实例名称来查询实例续费价格。 // // // @@ -4951,7 +5243,7 @@ func (c *Client) DescribeDBPrice(request *DescribeDBPriceRequest) (response *Des } // DescribeDBPrice -// 本接口(DescribeDBPrice)用于查询购买或续费云数据库实例的价格,支持查询按量计费或者包年包月的价格。可传入实例类型、购买时长、购买数量、内存大小、硬盘大小和可用区信息等来查询实例价格。可传入实例名称来查询实例续费价格。 +// 本接口(DescribeDBPrice)用于查询购买或续费云数据库实例的价格,支持查询按量计费或者包年包月的价格。可传入实例类型、购买时长、购买数量、内存大小、硬盘大小和可用区信息等来查询实例价格。可传入实例名称来查询实例续费价格。 // // // @@ -4968,6 +5260,7 @@ func (c *Client) DescribeDBPriceWithContext(ctx context.Context, request *Descri if request == nil { request = NewDescribeDBPriceRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "DescribeDBPrice") if c.GetCredential() == nil { return nil, errors.New("DescribeDBPrice require credential") @@ -5047,6 +5340,7 @@ func (c *Client) DescribeDBSecurityGroupsWithContext(ctx context.Context, reques if request == nil { request = NewDescribeDBSecurityGroupsRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "DescribeDBSecurityGroups") if c.GetCredential() == nil { return nil, errors.New("DescribeDBSecurityGroups require credential") @@ -5108,6 +5402,7 @@ func (c *Client) DescribeDBSwitchRecordsWithContext(ctx context.Context, request if request == nil { request = NewDescribeDBSwitchRecordsRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "DescribeDBSwitchRecords") if c.GetCredential() == nil { return nil, errors.New("DescribeDBSwitchRecords require credential") @@ -5163,6 +5458,7 @@ func (c *Client) DescribeDataBackupOverviewWithContext(ctx context.Context, requ if request == nil { request = NewDescribeDataBackupOverviewRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "DescribeDataBackupOverview") if c.GetCredential() == nil { return nil, errors.New("DescribeDataBackupOverview require credential") @@ -5238,6 +5534,7 @@ func (c *Client) DescribeDatabasesWithContext(ctx context.Context, request *Desc if request == nil { request = NewDescribeDatabasesRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "DescribeDatabases") if c.GetCredential() == nil { return nil, errors.New("DescribeDatabases require credential") @@ -5299,6 +5596,7 @@ func (c *Client) DescribeDefaultParamsWithContext(ctx context.Context, request * if request == nil { request = NewDescribeDefaultParamsRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "DescribeDefaultParams") if c.GetCredential() == nil { return nil, errors.New("DescribeDefaultParams require credential") @@ -5360,6 +5658,7 @@ func (c *Client) DescribeDeployGroupListWithContext(ctx context.Context, request if request == nil { request = NewDescribeDeployGroupListRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "DescribeDeployGroupList") if c.GetCredential() == nil { return nil, errors.New("DescribeDeployGroupList require credential") @@ -5431,6 +5730,7 @@ func (c *Client) DescribeDeviceMonitorInfoWithContext(ctx context.Context, reque if request == nil { request = NewDescribeDeviceMonitorInfoRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "DescribeDeviceMonitorInfo") if c.GetCredential() == nil { return nil, errors.New("DescribeDeviceMonitorInfo require credential") @@ -5510,6 +5810,7 @@ func (c *Client) DescribeErrorLogDataWithContext(ctx context.Context, request *D if request == nil { request = NewDescribeErrorLogDataRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "DescribeErrorLogData") if c.GetCredential() == nil { return nil, errors.New("DescribeErrorLogData require credential") @@ -5542,7 +5843,7 @@ func NewDescribeInstanceAlarmEventsResponse() (response *DescribeInstanceAlarmEv } // DescribeInstanceAlarmEvents -// 查询实例发生的事件信息 +// 本接口(DescribeInstanceAlarmEvents)用于查询实例发生的事件信息。 // // 可能返回的错误码: // FAILEDOPERATION_QUERYLOGERROR = "FailedOperation.QueryLogError" @@ -5564,7 +5865,7 @@ func (c *Client) DescribeInstanceAlarmEvents(request *DescribeInstanceAlarmEvent } // DescribeInstanceAlarmEvents -// 查询实例发生的事件信息 +// 本接口(DescribeInstanceAlarmEvents)用于查询实例发生的事件信息。 // // 可能返回的错误码: // FAILEDOPERATION_QUERYLOGERROR = "FailedOperation.QueryLogError" @@ -5585,6 +5886,7 @@ func (c *Client) DescribeInstanceAlarmEventsWithContext(ctx context.Context, req if request == nil { request = NewDescribeInstanceAlarmEventsRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "DescribeInstanceAlarmEvents") if c.GetCredential() == nil { return nil, errors.New("DescribeInstanceAlarmEvents require credential") @@ -5646,6 +5948,7 @@ func (c *Client) DescribeInstanceParamRecordsWithContext(ctx context.Context, re if request == nil { request = NewDescribeInstanceParamRecordsRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "DescribeInstanceParamRecords") if c.GetCredential() == nil { return nil, errors.New("DescribeInstanceParamRecords require credential") @@ -5715,6 +6018,7 @@ func (c *Client) DescribeInstanceParamsWithContext(ctx context.Context, request if request == nil { request = NewDescribeInstanceParamsRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "DescribeInstanceParams") if c.GetCredential() == nil { return nil, errors.New("DescribeInstanceParams require credential") @@ -5727,96 +6031,213 @@ func (c *Client) DescribeInstanceParamsWithContext(ctx context.Context, request return } -func NewDescribeLocalBinlogConfigRequest() (request *DescribeLocalBinlogConfigRequest) { - request = &DescribeLocalBinlogConfigRequest{ +func NewDescribeInstanceUpgradeCheckJobRequest() (request *DescribeInstanceUpgradeCheckJobRequest) { + request = &DescribeInstanceUpgradeCheckJobRequest{ BaseRequest: &tchttp.BaseRequest{}, } - request.Init().WithApiInfo("cdb", APIVersion, "DescribeLocalBinlogConfig") + request.Init().WithApiInfo("cdb", APIVersion, "DescribeInstanceUpgradeCheckJob") return } -func NewDescribeLocalBinlogConfigResponse() (response *DescribeLocalBinlogConfigResponse) { - response = &DescribeLocalBinlogConfigResponse{ +func NewDescribeInstanceUpgradeCheckJobResponse() (response *DescribeInstanceUpgradeCheckJobResponse) { + response = &DescribeInstanceUpgradeCheckJobResponse{ BaseResponse: &tchttp.BaseResponse{}, } return } -// DescribeLocalBinlogConfig -// 该接口用于查询实例本地binlog保留策略。 +// DescribeInstanceUpgradeCheckJob +// 该接口(DescribeInstanceUpgradeCheckJob)查询实例版本升级校验任务。 // // 可能返回的错误码: -// INTERNALERROR_DBRECORDNOTEXISTERROR = "InternalError.DBRecordNotExistError" -// INTERNALERROR_HTTPERROR = "InternalError.HttpError" +// FAILEDOPERATION_FAILEDOPERATIONERROR = "FailedOperation.FailedOperationError" // INTERNALERROR_UNKNOWNERROR = "InternalError.UnknownError" -func (c *Client) DescribeLocalBinlogConfig(request *DescribeLocalBinlogConfigRequest) (response *DescribeLocalBinlogConfigResponse, err error) { - return c.DescribeLocalBinlogConfigWithContext(context.Background(), request) +// OPERATIONDENIED_INSTANCETASKSTATUSERROR = "OperationDenied.InstanceTaskStatusError" +// RESOURCENOTFOUND_CDBINSTANCENOTFOUNDERROR = "ResourceNotFound.CdbInstanceNotFoundError" +func (c *Client) DescribeInstanceUpgradeCheckJob(request *DescribeInstanceUpgradeCheckJobRequest) (response *DescribeInstanceUpgradeCheckJobResponse, err error) { + return c.DescribeInstanceUpgradeCheckJobWithContext(context.Background(), request) } -// DescribeLocalBinlogConfig -// 该接口用于查询实例本地binlog保留策略。 +// DescribeInstanceUpgradeCheckJob +// 该接口(DescribeInstanceUpgradeCheckJob)查询实例版本升级校验任务。 // // 可能返回的错误码: -// INTERNALERROR_DBRECORDNOTEXISTERROR = "InternalError.DBRecordNotExistError" -// INTERNALERROR_HTTPERROR = "InternalError.HttpError" +// FAILEDOPERATION_FAILEDOPERATIONERROR = "FailedOperation.FailedOperationError" // INTERNALERROR_UNKNOWNERROR = "InternalError.UnknownError" -func (c *Client) DescribeLocalBinlogConfigWithContext(ctx context.Context, request *DescribeLocalBinlogConfigRequest) (response *DescribeLocalBinlogConfigResponse, err error) { +// OPERATIONDENIED_INSTANCETASKSTATUSERROR = "OperationDenied.InstanceTaskStatusError" +// RESOURCENOTFOUND_CDBINSTANCENOTFOUNDERROR = "ResourceNotFound.CdbInstanceNotFoundError" +func (c *Client) DescribeInstanceUpgradeCheckJobWithContext(ctx context.Context, request *DescribeInstanceUpgradeCheckJobRequest) (response *DescribeInstanceUpgradeCheckJobResponse, err error) { if request == nil { - request = NewDescribeLocalBinlogConfigRequest() + request = NewDescribeInstanceUpgradeCheckJobRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "DescribeInstanceUpgradeCheckJob") if c.GetCredential() == nil { - return nil, errors.New("DescribeLocalBinlogConfig require credential") + return nil, errors.New("DescribeInstanceUpgradeCheckJob require credential") } request.SetContext(ctx) - response = NewDescribeLocalBinlogConfigResponse() + response = NewDescribeInstanceUpgradeCheckJobResponse() err = c.Send(request, response) return } -func NewDescribeParamTemplateInfoRequest() (request *DescribeParamTemplateInfoRequest) { - request = &DescribeParamTemplateInfoRequest{ +func NewDescribeInstanceUpgradeTypeRequest() (request *DescribeInstanceUpgradeTypeRequest) { + request = &DescribeInstanceUpgradeTypeRequest{ BaseRequest: &tchttp.BaseRequest{}, } - request.Init().WithApiInfo("cdb", APIVersion, "DescribeParamTemplateInfo") + request.Init().WithApiInfo("cdb", APIVersion, "DescribeInstanceUpgradeType") return } -func NewDescribeParamTemplateInfoResponse() (response *DescribeParamTemplateInfoResponse) { - response = &DescribeParamTemplateInfoResponse{ +func NewDescribeInstanceUpgradeTypeResponse() (response *DescribeInstanceUpgradeTypeResponse) { + response = &DescribeInstanceUpgradeTypeResponse{ BaseResponse: &tchttp.BaseResponse{}, } return } -// DescribeParamTemplateInfo -// 该接口(DescribeParamTemplateInfo)用于查询参数模板详情,全地域公共参数Region均为ap-guangzhou。 +// DescribeInstanceUpgradeType +// 本接口(DescribeInstanceUpgradeType)用于查询数据库实例升级类型。 // // 可能返回的错误码: -// AUTHFAILURE = "AuthFailure" -// CDBERROR = "CdbError" -// INTERNALERROR_DATABASEACCESSERROR = "InternalError.DatabaseAccessError" -// INTERNALERROR_PARAMERROR = "InternalError.ParamError" -// INVALIDPARAMETER = "InvalidParameter" -func (c *Client) DescribeParamTemplateInfo(request *DescribeParamTemplateInfoRequest) (response *DescribeParamTemplateInfoResponse, err error) { - return c.DescribeParamTemplateInfoWithContext(context.Background(), request) +// FAILEDOPERATION_FAILEDOPERATIONERROR = "FailedOperation.FailedOperationError" +// INTERNALERROR_UNKNOWNERROR = "InternalError.UnknownError" +// OPERATIONDENIED_INSTANCETASKSTATUSERROR = "OperationDenied.InstanceTaskStatusError" +// RESOURCENOTFOUND_CDBINSTANCENOTFOUNDERROR = "ResourceNotFound.CdbInstanceNotFoundError" +func (c *Client) DescribeInstanceUpgradeType(request *DescribeInstanceUpgradeTypeRequest) (response *DescribeInstanceUpgradeTypeResponse, err error) { + return c.DescribeInstanceUpgradeTypeWithContext(context.Background(), request) } -// DescribeParamTemplateInfo -// 该接口(DescribeParamTemplateInfo)用于查询参数模板详情,全地域公共参数Region均为ap-guangzhou。 +// DescribeInstanceUpgradeType +// 本接口(DescribeInstanceUpgradeType)用于查询数据库实例升级类型。 // // 可能返回的错误码: -// AUTHFAILURE = "AuthFailure" +// FAILEDOPERATION_FAILEDOPERATIONERROR = "FailedOperation.FailedOperationError" +// INTERNALERROR_UNKNOWNERROR = "InternalError.UnknownError" +// OPERATIONDENIED_INSTANCETASKSTATUSERROR = "OperationDenied.InstanceTaskStatusError" +// RESOURCENOTFOUND_CDBINSTANCENOTFOUNDERROR = "ResourceNotFound.CdbInstanceNotFoundError" +func (c *Client) DescribeInstanceUpgradeTypeWithContext(ctx context.Context, request *DescribeInstanceUpgradeTypeRequest) (response *DescribeInstanceUpgradeTypeResponse, err error) { + if request == nil { + request = NewDescribeInstanceUpgradeTypeRequest() + } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "DescribeInstanceUpgradeType") + + if c.GetCredential() == nil { + return nil, errors.New("DescribeInstanceUpgradeType require credential") + } + + request.SetContext(ctx) + + response = NewDescribeInstanceUpgradeTypeResponse() + err = c.Send(request, response) + return +} + +func NewDescribeLocalBinlogConfigRequest() (request *DescribeLocalBinlogConfigRequest) { + request = &DescribeLocalBinlogConfigRequest{ + BaseRequest: &tchttp.BaseRequest{}, + } + + request.Init().WithApiInfo("cdb", APIVersion, "DescribeLocalBinlogConfig") + + + return +} + +func NewDescribeLocalBinlogConfigResponse() (response *DescribeLocalBinlogConfigResponse) { + response = &DescribeLocalBinlogConfigResponse{ + BaseResponse: &tchttp.BaseResponse{}, + } + return + +} + +// DescribeLocalBinlogConfig +// 该接口用于查询实例本地binlog保留策略。 +// +// 可能返回的错误码: +// INTERNALERROR_DBRECORDNOTEXISTERROR = "InternalError.DBRecordNotExistError" +// INTERNALERROR_HTTPERROR = "InternalError.HttpError" +// INTERNALERROR_UNKNOWNERROR = "InternalError.UnknownError" +func (c *Client) DescribeLocalBinlogConfig(request *DescribeLocalBinlogConfigRequest) (response *DescribeLocalBinlogConfigResponse, err error) { + return c.DescribeLocalBinlogConfigWithContext(context.Background(), request) +} + +// DescribeLocalBinlogConfig +// 该接口用于查询实例本地binlog保留策略。 +// +// 可能返回的错误码: +// INTERNALERROR_DBRECORDNOTEXISTERROR = "InternalError.DBRecordNotExistError" +// INTERNALERROR_HTTPERROR = "InternalError.HttpError" +// INTERNALERROR_UNKNOWNERROR = "InternalError.UnknownError" +func (c *Client) DescribeLocalBinlogConfigWithContext(ctx context.Context, request *DescribeLocalBinlogConfigRequest) (response *DescribeLocalBinlogConfigResponse, err error) { + if request == nil { + request = NewDescribeLocalBinlogConfigRequest() + } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "DescribeLocalBinlogConfig") + + if c.GetCredential() == nil { + return nil, errors.New("DescribeLocalBinlogConfig require credential") + } + + request.SetContext(ctx) + + response = NewDescribeLocalBinlogConfigResponse() + err = c.Send(request, response) + return +} + +func NewDescribeParamTemplateInfoRequest() (request *DescribeParamTemplateInfoRequest) { + request = &DescribeParamTemplateInfoRequest{ + BaseRequest: &tchttp.BaseRequest{}, + } + + request.Init().WithApiInfo("cdb", APIVersion, "DescribeParamTemplateInfo") + + + return +} + +func NewDescribeParamTemplateInfoResponse() (response *DescribeParamTemplateInfoResponse) { + response = &DescribeParamTemplateInfoResponse{ + BaseResponse: &tchttp.BaseResponse{}, + } + return + +} + +// DescribeParamTemplateInfo +// 该接口(DescribeParamTemplateInfo)用于查询参数模板详情。 +// +// 说明:参数模板为公共组件,配置完成后全地域生效。接口调用配置地域可选择广州、新加坡。 +// +// 可能返回的错误码: +// AUTHFAILURE = "AuthFailure" +// CDBERROR = "CdbError" +// INTERNALERROR_DATABASEACCESSERROR = "InternalError.DatabaseAccessError" +// INTERNALERROR_PARAMERROR = "InternalError.ParamError" +// INVALIDPARAMETER = "InvalidParameter" +func (c *Client) DescribeParamTemplateInfo(request *DescribeParamTemplateInfoRequest) (response *DescribeParamTemplateInfoResponse, err error) { + return c.DescribeParamTemplateInfoWithContext(context.Background(), request) +} + +// DescribeParamTemplateInfo +// 该接口(DescribeParamTemplateInfo)用于查询参数模板详情。 +// +// 说明:参数模板为公共组件,配置完成后全地域生效。接口调用配置地域可选择广州、新加坡。 +// +// 可能返回的错误码: +// AUTHFAILURE = "AuthFailure" // CDBERROR = "CdbError" // INTERNALERROR_DATABASEACCESSERROR = "InternalError.DatabaseAccessError" // INTERNALERROR_PARAMERROR = "InternalError.ParamError" @@ -5825,6 +6246,7 @@ func (c *Client) DescribeParamTemplateInfoWithContext(ctx context.Context, reque if request == nil { request = NewDescribeParamTemplateInfoRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "DescribeParamTemplateInfo") if c.GetCredential() == nil { return nil, errors.New("DescribeParamTemplateInfo require credential") @@ -5857,7 +6279,9 @@ func NewDescribeParamTemplatesResponse() (response *DescribeParamTemplatesRespon } // DescribeParamTemplates -// 该接口(DescribeParamTemplates)查询参数模板列表,全地域公共参数Region均为ap-guangzhou。 +// 该接口(DescribeParamTemplates)查询参数模板列表。 +// +// 说明:参数模板为公共组件,配置完成后全地域生效。接口调用配置地域可选择广州、新加坡。 // // 可能返回的错误码: // AUTHFAILURE = "AuthFailure" @@ -5871,7 +6295,9 @@ func (c *Client) DescribeParamTemplates(request *DescribeParamTemplatesRequest) } // DescribeParamTemplates -// 该接口(DescribeParamTemplates)查询参数模板列表,全地域公共参数Region均为ap-guangzhou。 +// 该接口(DescribeParamTemplates)查询参数模板列表。 +// +// 说明:参数模板为公共组件,配置完成后全地域生效。接口调用配置地域可选择广州、新加坡。 // // 可能返回的错误码: // AUTHFAILURE = "AuthFailure" @@ -5884,6 +6310,7 @@ func (c *Client) DescribeParamTemplatesWithContext(ctx context.Context, request if request == nil { request = NewDescribeParamTemplatesRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "DescribeParamTemplates") if c.GetCredential() == nil { return nil, errors.New("DescribeParamTemplates require credential") @@ -5945,6 +6372,7 @@ func (c *Client) DescribeProjectSecurityGroupsWithContext(ctx context.Context, r if request == nil { request = NewDescribeProjectSecurityGroupsRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "DescribeProjectSecurityGroups") if c.GetCredential() == nil { return nil, errors.New("DescribeProjectSecurityGroups require credential") @@ -5996,6 +6424,7 @@ func (c *Client) DescribeProxyCustomConfWithContext(ctx context.Context, request if request == nil { request = NewDescribeProxyCustomConfRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "DescribeProxyCustomConf") if c.GetCredential() == nil { return nil, errors.New("DescribeProxyCustomConf require credential") @@ -6028,7 +6457,7 @@ func NewDescribeProxySupportParamResponse() (response *DescribeProxySupportParam } // DescribeProxySupportParam -// 查询实例支持代理版本和参数 +// 本接口(DescribeProxySupportParam)用于查询实例支持代理版本和参数。 // // 可能返回的错误码: // INTERNALERROR_DBRECORDNOTEXISTERROR = "InternalError.DBRecordNotExistError" @@ -6042,7 +6471,7 @@ func (c *Client) DescribeProxySupportParam(request *DescribeProxySupportParamReq } // DescribeProxySupportParam -// 查询实例支持代理版本和参数 +// 本接口(DescribeProxySupportParam)用于查询实例支持代理版本和参数。 // // 可能返回的错误码: // INTERNALERROR_DBRECORDNOTEXISTERROR = "InternalError.DBRecordNotExistError" @@ -6055,6 +6484,7 @@ func (c *Client) DescribeProxySupportParamWithContext(ctx context.Context, reque if request == nil { request = NewDescribeProxySupportParamRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "DescribeProxySupportParam") if c.GetCredential() == nil { return nil, errors.New("DescribeProxySupportParam require credential") @@ -6106,6 +6536,7 @@ func (c *Client) DescribeRemoteBackupConfigWithContext(ctx context.Context, requ if request == nil { request = NewDescribeRemoteBackupConfigRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "DescribeRemoteBackupConfig") if c.GetCredential() == nil { return nil, errors.New("DescribeRemoteBackupConfig require credential") @@ -6138,7 +6569,7 @@ func NewDescribeRoGroupsResponse() (response *DescribeRoGroupsResponse) { } // DescribeRoGroups -// 本接口(DescribeRoGroups)用于查询云数据库实例的所有的RO组的信息。 +// 本接口(DescribeRoGroups)用于查询云数据库实例的所有的 RO 组的信息。 // // 可能返回的错误码: // CDBERROR = "CdbError" @@ -6156,7 +6587,7 @@ func (c *Client) DescribeRoGroups(request *DescribeRoGroupsRequest) (response *D } // DescribeRoGroups -// 本接口(DescribeRoGroups)用于查询云数据库实例的所有的RO组的信息。 +// 本接口(DescribeRoGroups)用于查询云数据库实例的所有的 RO 组的信息。 // // 可能返回的错误码: // CDBERROR = "CdbError" @@ -6173,6 +6604,7 @@ func (c *Client) DescribeRoGroupsWithContext(ctx context.Context, request *Descr if request == nil { request = NewDescribeRoGroupsRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "DescribeRoGroups") if c.GetCredential() == nil { return nil, errors.New("DescribeRoGroups require credential") @@ -6232,6 +6664,7 @@ func (c *Client) DescribeRoMinScaleWithContext(ctx context.Context, request *Des if request == nil { request = NewDescribeRoMinScaleRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "DescribeRoMinScale") if c.GetCredential() == nil { return nil, errors.New("DescribeRoMinScale require credential") @@ -6291,6 +6724,7 @@ func (c *Client) DescribeRollbackRangeTimeWithContext(ctx context.Context, reque if request == nil { request = NewDescribeRollbackRangeTimeRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "DescribeRollbackRangeTime") if c.GetCredential() == nil { return nil, errors.New("DescribeRollbackRangeTime require credential") @@ -6323,7 +6757,7 @@ func NewDescribeRollbackTaskDetailResponse() (response *DescribeRollbackTaskDeta } // DescribeRollbackTaskDetail -// 本接口(DescribeRollbackTaskDetail)用于查询云数据库实例回档任务详情。 +// 本接口(DescribeRollbackTaskDetail)用于查询云数据库实例回档任务详情。 // // 可能返回的错误码: // CDBERROR_DATABASEERROR = "CdbError.DatabaseError" @@ -6335,7 +6769,7 @@ func (c *Client) DescribeRollbackTaskDetail(request *DescribeRollbackTaskDetailR } // DescribeRollbackTaskDetail -// 本接口(DescribeRollbackTaskDetail)用于查询云数据库实例回档任务详情。 +// 本接口(DescribeRollbackTaskDetail)用于查询云数据库实例回档任务详情。 // // 可能返回的错误码: // CDBERROR_DATABASEERROR = "CdbError.DatabaseError" @@ -6346,6 +6780,7 @@ func (c *Client) DescribeRollbackTaskDetailWithContext(ctx context.Context, requ if request == nil { request = NewDescribeRollbackTaskDetailRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "DescribeRollbackTaskDetail") if c.GetCredential() == nil { return nil, errors.New("DescribeRollbackTaskDetail require credential") @@ -6378,7 +6813,7 @@ func NewDescribeSSLStatusResponse() (response *DescribeSSLStatusResponse) { } // DescribeSSLStatus -// 查询 SSL 开通情况。如果已经开通 SSL ,会同步返回证书下载链接。 +// 本接口(DescribeSSLStatus)用于查询 SSL 开通情况。如果已经开通 SSL ,会同步返回证书下载链接。 // // 可能返回的错误码: // INTERNALERROR_DBRECORDNOTEXISTERROR = "InternalError.DBRecordNotExistError" @@ -6393,7 +6828,7 @@ func (c *Client) DescribeSSLStatus(request *DescribeSSLStatusRequest) (response } // DescribeSSLStatus -// 查询 SSL 开通情况。如果已经开通 SSL ,会同步返回证书下载链接。 +// 本接口(DescribeSSLStatus)用于查询 SSL 开通情况。如果已经开通 SSL ,会同步返回证书下载链接。 // // 可能返回的错误码: // INTERNALERROR_DBRECORDNOTEXISTERROR = "InternalError.DBRecordNotExistError" @@ -6407,6 +6842,7 @@ func (c *Client) DescribeSSLStatusWithContext(ctx context.Context, request *Desc if request == nil { request = NewDescribeSSLStatusRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "DescribeSSLStatus") if c.GetCredential() == nil { return nil, errors.New("DescribeSSLStatus require credential") @@ -6439,7 +6875,7 @@ func NewDescribeSlowLogDataResponse() (response *DescribeSlowLogDataResponse) { } // DescribeSlowLogData -// 条件检索实例的慢日志。只允许查看一个月之内的慢日志。 +// 本接口(DescribeSlowLogData)用于使用条件检索实例的慢日志。只允许查看一个月之内的慢日志。 // // 使用时需要注意:可能存在单条慢日志太大,导致整个http请求的回包太大,进而引发接口超时。一旦发生超时,建议您缩小查询时的Limit参数值,从而降低包的大小,让接口能够及时返回内容。 // @@ -6465,7 +6901,7 @@ func (c *Client) DescribeSlowLogData(request *DescribeSlowLogDataRequest) (respo } // DescribeSlowLogData -// 条件检索实例的慢日志。只允许查看一个月之内的慢日志。 +// 本接口(DescribeSlowLogData)用于使用条件检索实例的慢日志。只允许查看一个月之内的慢日志。 // // 使用时需要注意:可能存在单条慢日志太大,导致整个http请求的回包太大,进而引发接口超时。一旦发生超时,建议您缩小查询时的Limit参数值,从而降低包的大小,让接口能够及时返回内容。 // @@ -6490,6 +6926,7 @@ func (c *Client) DescribeSlowLogDataWithContext(ctx context.Context, request *De if request == nil { request = NewDescribeSlowLogDataRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "DescribeSlowLogData") if c.GetCredential() == nil { return nil, errors.New("DescribeSlowLogData require credential") @@ -6522,7 +6959,9 @@ func NewDescribeSlowLogsResponse() (response *DescribeSlowLogsResponse) { } // DescribeSlowLogs -// 本接口(DescribeSlowLogs)用于获取云数据库实例的慢查询日志。说明:若单次查询数据量过大,则有可能响应超时,建议缩短单次查询时间范围,如一小时,避免导致超时。 +// 本接口(DescribeSlowLogs)用于获取云数据库实例的慢查询日志。 +// +// 说明:若单次查询数据量过大,则有可能响应超时,建议缩短单次查询时间范围,如一小时,避免导致超时。 // // 可能返回的错误码: // AUTHFAILURE = "AuthFailure" @@ -6541,7 +6980,9 @@ func (c *Client) DescribeSlowLogs(request *DescribeSlowLogsRequest) (response *D } // DescribeSlowLogs -// 本接口(DescribeSlowLogs)用于获取云数据库实例的慢查询日志。说明:若单次查询数据量过大,则有可能响应超时,建议缩短单次查询时间范围,如一小时,避免导致超时。 +// 本接口(DescribeSlowLogs)用于获取云数据库实例的慢查询日志。 +// +// 说明:若单次查询数据量过大,则有可能响应超时,建议缩短单次查询时间范围,如一小时,避免导致超时。 // // 可能返回的错误码: // AUTHFAILURE = "AuthFailure" @@ -6559,6 +7000,7 @@ func (c *Client) DescribeSlowLogsWithContext(ctx context.Context, request *Descr if request == nil { request = NewDescribeSlowLogsRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "DescribeSlowLogs") if c.GetCredential() == nil { return nil, errors.New("DescribeSlowLogs require credential") @@ -6660,6 +7102,7 @@ func (c *Client) DescribeSupportedPrivilegesWithContext(ctx context.Context, req if request == nil { request = NewDescribeSupportedPrivilegesRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "DescribeSupportedPrivileges") if c.GetCredential() == nil { return nil, errors.New("DescribeSupportedPrivileges require credential") @@ -6672,6 +7115,58 @@ func (c *Client) DescribeSupportedPrivilegesWithContext(ctx context.Context, req return } +func NewDescribeTableColumnsRequest() (request *DescribeTableColumnsRequest) { + request = &DescribeTableColumnsRequest{ + BaseRequest: &tchttp.BaseRequest{}, + } + + request.Init().WithApiInfo("cdb", APIVersion, "DescribeTableColumns") + + + return +} + +func NewDescribeTableColumnsResponse() (response *DescribeTableColumnsResponse) { + response = &DescribeTableColumnsResponse{ + BaseResponse: &tchttp.BaseResponse{}, + } + return + +} + +// DescribeTableColumns +// 本接口(DescribeTableColumns)用于查询云数据库实例的指定数据库表的列信息,仅支持主实例和灾备实例。 +// +// 可能返回的错误码: +// INTERNALERROR_UNKNOWNERROR = "InternalError.UnknownError" +// INVALIDPARAMETERVALUE_INVALIDPARAMETERVALUEERROR = "InvalidParameterValue.InvalidParameterValueError" +func (c *Client) DescribeTableColumns(request *DescribeTableColumnsRequest) (response *DescribeTableColumnsResponse, err error) { + return c.DescribeTableColumnsWithContext(context.Background(), request) +} + +// DescribeTableColumns +// 本接口(DescribeTableColumns)用于查询云数据库实例的指定数据库表的列信息,仅支持主实例和灾备实例。 +// +// 可能返回的错误码: +// INTERNALERROR_UNKNOWNERROR = "InternalError.UnknownError" +// INVALIDPARAMETERVALUE_INVALIDPARAMETERVALUEERROR = "InvalidParameterValue.InvalidParameterValueError" +func (c *Client) DescribeTableColumnsWithContext(ctx context.Context, request *DescribeTableColumnsRequest) (response *DescribeTableColumnsResponse, err error) { + if request == nil { + request = NewDescribeTableColumnsRequest() + } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "DescribeTableColumns") + + if c.GetCredential() == nil { + return nil, errors.New("DescribeTableColumns require credential") + } + + request.SetContext(ctx) + + response = NewDescribeTableColumnsResponse() + err = c.Send(request, response) + return +} + func NewDescribeTablesRequest() (request *DescribeTablesRequest) { request = &DescribeTablesRequest{ BaseRequest: &tchttp.BaseRequest{}, @@ -6725,6 +7220,7 @@ func (c *Client) DescribeTablesWithContext(ctx context.Context, request *Describ if request == nil { request = NewDescribeTablesRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "DescribeTables") if c.GetCredential() == nil { return nil, errors.New("DescribeTables require credential") @@ -6757,7 +7253,7 @@ func NewDescribeTagsOfInstanceIdsResponse() (response *DescribeTagsOfInstanceIds } // DescribeTagsOfInstanceIds -// 本接口(DescribeTagsOfInstanceIds)用于获取云数据库实例的标签信息。 +// 本接口(DescribeTagsOfInstanceIds)用于获取云数据库实例的标签信息。 // // 可能返回的错误码: // AUTHFAILURE = "AuthFailure" @@ -6776,7 +7272,7 @@ func (c *Client) DescribeTagsOfInstanceIds(request *DescribeTagsOfInstanceIdsReq } // DescribeTagsOfInstanceIds -// 本接口(DescribeTagsOfInstanceIds)用于获取云数据库实例的标签信息。 +// 本接口(DescribeTagsOfInstanceIds)用于获取云数据库实例的标签信息。 // // 可能返回的错误码: // AUTHFAILURE = "AuthFailure" @@ -6794,6 +7290,7 @@ func (c *Client) DescribeTagsOfInstanceIdsWithContext(ctx context.Context, reque if request == nil { request = NewDescribeTagsOfInstanceIdsRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "DescribeTagsOfInstanceIds") if c.GetCredential() == nil { return nil, errors.New("DescribeTagsOfInstanceIds require credential") @@ -6867,6 +7364,7 @@ func (c *Client) DescribeTasksWithContext(ctx context.Context, request *Describe if request == nil { request = NewDescribeTasksRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "DescribeTasks") if c.GetCredential() == nil { return nil, errors.New("DescribeTasks require credential") @@ -6924,6 +7422,7 @@ func (c *Client) DescribeTimeWindowWithContext(ctx context.Context, request *Des if request == nil { request = NewDescribeTimeWindowRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "DescribeTimeWindow") if c.GetCredential() == nil { return nil, errors.New("DescribeTimeWindow require credential") @@ -6979,6 +7478,7 @@ func (c *Client) DescribeUploadedFilesWithContext(ctx context.Context, request * if request == nil { request = NewDescribeUploadedFilesRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "DescribeUploadedFiles") if c.GetCredential() == nil { return nil, errors.New("DescribeUploadedFiles require credential") @@ -7044,6 +7544,7 @@ func (c *Client) DisassociateSecurityGroupsWithContext(ctx context.Context, requ if request == nil { request = NewDisassociateSecurityGroupsRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "DisassociateSecurityGroups") if c.GetCredential() == nil { return nil, errors.New("DisassociateSecurityGroups require credential") @@ -7056,73 +7557,6 @@ func (c *Client) DisassociateSecurityGroupsWithContext(ctx context.Context, requ return } -func NewInitDBInstancesRequest() (request *InitDBInstancesRequest) { - request = &InitDBInstancesRequest{ - BaseRequest: &tchttp.BaseRequest{}, - } - - request.Init().WithApiInfo("cdb", APIVersion, "InitDBInstances") - - - return -} - -func NewInitDBInstancesResponse() (response *InitDBInstancesResponse) { - response = &InitDBInstancesResponse{ - BaseResponse: &tchttp.BaseResponse{}, - } - return - -} - -// InitDBInstances -// 该接口不再维护,参考CreateDBInstance+API文档,在发货时即可完成初始化。 -// -// -// -// 本接口(InitDBInstances)用于初始化云数据库实例,包括初始化密码、默认字符集、实例端口号等。该接口已经废弃,在发货接口CreateDBInstance、CreateDBInstanceHour可以直接使用参数Password设置密码,使用参数ParamList设置字符集,使用参数Port设置端口号。 -// -// 可能返回的错误码: -// INTERNALERROR_UNDEFINEDERROR = "InternalError.UndefinedError" -// INVALIDPARAMETER = "InvalidParameter" -// INVALIDPARAMETER_INSTANCENOTFOUND = "InvalidParameter.InstanceNotFound" -// OPERATIONDENIED = "OperationDenied" -// OPERATIONDENIED_USERHASNOSTRATEGY = "OperationDenied.UserHasNoStrategy" -// OPERATIONDENIED_WRONGPASSWORD = "OperationDenied.WrongPassword" -func (c *Client) InitDBInstances(request *InitDBInstancesRequest) (response *InitDBInstancesResponse, err error) { - return c.InitDBInstancesWithContext(context.Background(), request) -} - -// InitDBInstances -// 该接口不再维护,参考CreateDBInstance+API文档,在发货时即可完成初始化。 -// -// -// -// 本接口(InitDBInstances)用于初始化云数据库实例,包括初始化密码、默认字符集、实例端口号等。该接口已经废弃,在发货接口CreateDBInstance、CreateDBInstanceHour可以直接使用参数Password设置密码,使用参数ParamList设置字符集,使用参数Port设置端口号。 -// -// 可能返回的错误码: -// INTERNALERROR_UNDEFINEDERROR = "InternalError.UndefinedError" -// INVALIDPARAMETER = "InvalidParameter" -// INVALIDPARAMETER_INSTANCENOTFOUND = "InvalidParameter.InstanceNotFound" -// OPERATIONDENIED = "OperationDenied" -// OPERATIONDENIED_USERHASNOSTRATEGY = "OperationDenied.UserHasNoStrategy" -// OPERATIONDENIED_WRONGPASSWORD = "OperationDenied.WrongPassword" -func (c *Client) InitDBInstancesWithContext(ctx context.Context, request *InitDBInstancesRequest) (response *InitDBInstancesResponse, err error) { - if request == nil { - request = NewInitDBInstancesRequest() - } - - if c.GetCredential() == nil { - return nil, errors.New("InitDBInstances require credential") - } - - request.SetContext(ctx) - - response = NewInitDBInstancesResponse() - err = c.Send(request, response) - return -} - func NewInquiryPriceUpgradeInstancesRequest() (request *InquiryPriceUpgradeInstancesRequest) { request = &InquiryPriceUpgradeInstancesRequest{ BaseRequest: &tchttp.BaseRequest{}, @@ -7143,7 +7577,7 @@ func NewInquiryPriceUpgradeInstancesResponse() (response *InquiryPriceUpgradeIns } // InquiryPriceUpgradeInstances -// 本接口(InquiryPriceUpgradeInstances)用于查询云数据库实例升级的价格,支持查询按量计费或者包年包月实例的升级价格,实例类型支持主实例、灾备实例和只读实例。 +// 本接口(InquiryPriceUpgradeInstances)用于查询云数据库实例升级的价格,支持查询按量计费或者包年包月实例的升级价格,实例类型支持主实例、灾备实例和只读实例。 // // 可能返回的错误码: // INTERNALERROR_DATABASEACCESSERROR = "InternalError.DatabaseAccessError" @@ -7157,7 +7591,7 @@ func (c *Client) InquiryPriceUpgradeInstances(request *InquiryPriceUpgradeInstan } // InquiryPriceUpgradeInstances -// 本接口(InquiryPriceUpgradeInstances)用于查询云数据库实例升级的价格,支持查询按量计费或者包年包月实例的升级价格,实例类型支持主实例、灾备实例和只读实例。 +// 本接口(InquiryPriceUpgradeInstances)用于查询云数据库实例升级的价格,支持查询按量计费或者包年包月实例的升级价格,实例类型支持主实例、灾备实例和只读实例。 // // 可能返回的错误码: // INTERNALERROR_DATABASEACCESSERROR = "InternalError.DatabaseAccessError" @@ -7170,6 +7604,7 @@ func (c *Client) InquiryPriceUpgradeInstancesWithContext(ctx context.Context, re if request == nil { request = NewInquiryPriceUpgradeInstancesRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "InquiryPriceUpgradeInstances") if c.GetCredential() == nil { return nil, errors.New("InquiryPriceUpgradeInstances require credential") @@ -7202,7 +7637,7 @@ func NewIsolateDBInstanceResponse() (response *IsolateDBInstanceResponse) { } // IsolateDBInstance -// 本接口(IsolateDBInstance)用于隔离云数据库实例,隔离后不能通过IP和端口访问数据库。隔离的实例可在回收站中进行开机。若为欠费隔离,请尽快进行充值。 +// 本接口(IsolateDBInstance)用于隔离云数据库实例,隔离后不能通过IP和端口访问数据库。隔离的实例可在回收站中进行开机。若为欠费隔离,请尽快进行充值。 // // 可能返回的错误码: // FAILEDOPERATION_CDBINSTANCELOCKFAILERROR = "FailedOperation.CdbInstanceLockFailError" @@ -7229,7 +7664,7 @@ func (c *Client) IsolateDBInstance(request *IsolateDBInstanceRequest) (response } // IsolateDBInstance -// 本接口(IsolateDBInstance)用于隔离云数据库实例,隔离后不能通过IP和端口访问数据库。隔离的实例可在回收站中进行开机。若为欠费隔离,请尽快进行充值。 +// 本接口(IsolateDBInstance)用于隔离云数据库实例,隔离后不能通过IP和端口访问数据库。隔离的实例可在回收站中进行开机。若为欠费隔离,请尽快进行充值。 // // 可能返回的错误码: // FAILEDOPERATION_CDBINSTANCELOCKFAILERROR = "FailedOperation.CdbInstanceLockFailError" @@ -7255,6 +7690,7 @@ func (c *Client) IsolateDBInstanceWithContext(ctx context.Context, request *Isol if request == nil { request = NewIsolateDBInstanceRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "IsolateDBInstance") if c.GetCredential() == nil { return nil, errors.New("IsolateDBInstance require credential") @@ -7360,6 +7796,7 @@ func (c *Client) ModifyAccountDescriptionWithContext(ctx context.Context, reques if request == nil { request = NewModifyAccountDescriptionRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "ModifyAccountDescription") if c.GetCredential() == nil { return nil, errors.New("ModifyAccountDescription require credential") @@ -7453,6 +7890,7 @@ func (c *Client) ModifyAccountHostWithContext(ctx context.Context, request *Modi if request == nil { request = NewModifyAccountHostRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "ModifyAccountHost") if c.GetCredential() == nil { return nil, errors.New("ModifyAccountHost require credential") @@ -7485,7 +7923,7 @@ func NewModifyAccountMaxUserConnectionsResponse() (response *ModifyAccountMaxUse } // ModifyAccountMaxUserConnections -// 本接口(ModifyAccountMaxUserConnections)用于修改云数据库账户最大可用连接数。 +// 本接口(ModifyAccountMaxUserConnections)用于修改云数据库账户最大可用连接数。 // // 可能返回的错误码: // FAILEDOPERATION_ASYNCTASKSTATUSERROR = "FailedOperation.AsyncTaskStatusError" @@ -7499,7 +7937,7 @@ func (c *Client) ModifyAccountMaxUserConnections(request *ModifyAccountMaxUserCo } // ModifyAccountMaxUserConnections -// 本接口(ModifyAccountMaxUserConnections)用于修改云数据库账户最大可用连接数。 +// 本接口(ModifyAccountMaxUserConnections)用于修改云数据库账户最大可用连接数。 // // 可能返回的错误码: // FAILEDOPERATION_ASYNCTASKSTATUSERROR = "FailedOperation.AsyncTaskStatusError" @@ -7512,6 +7950,7 @@ func (c *Client) ModifyAccountMaxUserConnectionsWithContext(ctx context.Context, if request == nil { request = NewModifyAccountMaxUserConnectionsRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "ModifyAccountMaxUserConnections") if c.GetCredential() == nil { return nil, errors.New("ModifyAccountMaxUserConnections require credential") @@ -7623,6 +8062,7 @@ func (c *Client) ModifyAccountPasswordWithContext(ctx context.Context, request * if request == nil { request = NewModifyAccountPasswordRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "ModifyAccountPassword") if c.GetCredential() == nil { return nil, errors.New("ModifyAccountPassword require credential") @@ -7744,6 +8184,7 @@ func (c *Client) ModifyAccountPrivilegesWithContext(ctx context.Context, request if request == nil { request = NewModifyAccountPrivilegesRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "ModifyAccountPrivileges") if c.GetCredential() == nil { return nil, errors.New("ModifyAccountPrivileges require credential") @@ -7815,6 +8256,7 @@ func (c *Client) ModifyAuditConfigWithContext(ctx context.Context, request *Modi if request == nil { request = NewModifyAuditConfigRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "ModifyAuditConfig") if c.GetCredential() == nil { return nil, errors.New("ModifyAuditConfig require credential") @@ -7847,6 +8289,10 @@ func NewModifyAuditRuleResponse() (response *ModifyAuditRuleResponse) { } // ModifyAuditRule +// 不再支持审计规则创建 +// +// +// // 本接口(ModifyAuditRule)用于修改用户的审计规则。 // // 可能返回的错误码: @@ -7867,6 +8313,10 @@ func (c *Client) ModifyAuditRule(request *ModifyAuditRuleRequest) (response *Mod } // ModifyAuditRule +// 不再支持审计规则创建 +// +// +// // 本接口(ModifyAuditRule)用于修改用户的审计规则。 // // 可能返回的错误码: @@ -7886,6 +8336,7 @@ func (c *Client) ModifyAuditRuleWithContext(ctx context.Context, request *Modify if request == nil { request = NewModifyAuditRuleRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "ModifyAuditRule") if c.GetCredential() == nil { return nil, errors.New("ModifyAuditRule require credential") @@ -7937,6 +8388,7 @@ func (c *Client) ModifyAuditRuleTemplatesWithContext(ctx context.Context, reques if request == nil { request = NewModifyAuditRuleTemplatesRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "ModifyAuditRuleTemplates") if c.GetCredential() == nil { return nil, errors.New("ModifyAuditRuleTemplates require credential") @@ -8002,6 +8454,7 @@ func (c *Client) ModifyAuditServiceWithContext(ctx context.Context, request *Mod if request == nil { request = NewModifyAuditServiceRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "ModifyAuditService") if c.GetCredential() == nil { return nil, errors.New("ModifyAuditService require credential") @@ -8034,7 +8487,7 @@ func NewModifyAutoRenewFlagResponse() (response *ModifyAutoRenewFlagResponse) { } // ModifyAutoRenewFlag -// 本接口(ModifyAutoRenewFlag)用于修改云数据库实例的自动续费标记。仅支持包年包月的实例设置自动续费标记。 +// 本接口(ModifyAutoRenewFlag)用于修改云数据库实例的自动续费标记。仅支持包年包月的实例设置自动续费标记。 // // 可能返回的错误码: // AUTHFAILURE = "AuthFailure" @@ -8051,7 +8504,7 @@ func (c *Client) ModifyAutoRenewFlag(request *ModifyAutoRenewFlagRequest) (respo } // ModifyAutoRenewFlag -// 本接口(ModifyAutoRenewFlag)用于修改云数据库实例的自动续费标记。仅支持包年包月的实例设置自动续费标记。 +// 本接口(ModifyAutoRenewFlag)用于修改云数据库实例的自动续费标记。仅支持包年包月的实例设置自动续费标记。 // // 可能返回的错误码: // AUTHFAILURE = "AuthFailure" @@ -8067,6 +8520,7 @@ func (c *Client) ModifyAutoRenewFlagWithContext(ctx context.Context, request *Mo if request == nil { request = NewModifyAutoRenewFlagRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "ModifyAutoRenewFlag") if c.GetCredential() == nil { return nil, errors.New("ModifyAutoRenewFlag require credential") @@ -8099,7 +8553,7 @@ func NewModifyBackupConfigResponse() (response *ModifyBackupConfigResponse) { } // ModifyBackupConfig -// 本接口(ModifyBackupConfig)用于修改数据库备份配置信息。 +// 本接口(ModifyBackupConfig)用于修改数据库备份配置信息。 // // 可能返回的错误码: // CDBERROR = "CdbError" @@ -8115,7 +8569,7 @@ func (c *Client) ModifyBackupConfig(request *ModifyBackupConfigRequest) (respons } // ModifyBackupConfig -// 本接口(ModifyBackupConfig)用于修改数据库备份配置信息。 +// 本接口(ModifyBackupConfig)用于修改数据库备份配置信息。 // // 可能返回的错误码: // CDBERROR = "CdbError" @@ -8130,6 +8584,7 @@ func (c *Client) ModifyBackupConfigWithContext(ctx context.Context, request *Mod if request == nil { request = NewModifyBackupConfigRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "ModifyBackupConfig") if c.GetCredential() == nil { return nil, errors.New("ModifyBackupConfig require credential") @@ -8191,6 +8646,7 @@ func (c *Client) ModifyBackupDownloadRestrictionWithContext(ctx context.Context, if request == nil { request = NewModifyBackupDownloadRestrictionRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "ModifyBackupDownloadRestriction") if c.GetCredential() == nil { return nil, errors.New("ModifyBackupDownloadRestriction require credential") @@ -8262,6 +8718,7 @@ func (c *Client) ModifyBackupEncryptionStatusWithContext(ctx context.Context, re if request == nil { request = NewModifyBackupEncryptionStatusRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "ModifyBackupEncryptionStatus") if c.GetCredential() == nil { return nil, errors.New("ModifyBackupEncryptionStatus require credential") @@ -8294,7 +8751,7 @@ func NewModifyCdbProxyAddressDescResponse() (response *ModifyCdbProxyAddressDesc } // ModifyCdbProxyAddressDesc -// 修改代理地址描述信息 +// 本接口(ModifyCdbProxyAddressDesc)用于修改代理地址描述信息。 // // 可能返回的错误码: // INTERNALERROR_UNKNOWNERROR = "InternalError.UnknownError" @@ -8303,7 +8760,7 @@ func (c *Client) ModifyCdbProxyAddressDesc(request *ModifyCdbProxyAddressDescReq } // ModifyCdbProxyAddressDesc -// 修改代理地址描述信息 +// 本接口(ModifyCdbProxyAddressDesc)用于修改代理地址描述信息。 // // 可能返回的错误码: // INTERNALERROR_UNKNOWNERROR = "InternalError.UnknownError" @@ -8311,6 +8768,7 @@ func (c *Client) ModifyCdbProxyAddressDescWithContext(ctx context.Context, reque if request == nil { request = NewModifyCdbProxyAddressDescRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "ModifyCdbProxyAddressDesc") if c.GetCredential() == nil { return nil, errors.New("ModifyCdbProxyAddressDesc require credential") @@ -8343,7 +8801,7 @@ func NewModifyCdbProxyAddressVipAndVPortResponse() (response *ModifyCdbProxyAddr } // ModifyCdbProxyAddressVipAndVPort -// 修改数据库代理地址VPC信息 +// 本接口(ModifyCdbProxyAddressVipAndVPort)用于修改数据库代理地址VPC信息。 // // 可能返回的错误码: // FAILEDOPERATION_DESCRIBEPROXYGROUPERROR = "FailedOperation.DescribeProxyGroupError" @@ -8357,7 +8815,7 @@ func (c *Client) ModifyCdbProxyAddressVipAndVPort(request *ModifyCdbProxyAddress } // ModifyCdbProxyAddressVipAndVPort -// 修改数据库代理地址VPC信息 +// 本接口(ModifyCdbProxyAddressVipAndVPort)用于修改数据库代理地址VPC信息。 // // 可能返回的错误码: // FAILEDOPERATION_DESCRIBEPROXYGROUPERROR = "FailedOperation.DescribeProxyGroupError" @@ -8370,6 +8828,7 @@ func (c *Client) ModifyCdbProxyAddressVipAndVPortWithContext(ctx context.Context if request == nil { request = NewModifyCdbProxyAddressVipAndVPortRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "ModifyCdbProxyAddressVipAndVPort") if c.GetCredential() == nil { return nil, errors.New("ModifyCdbProxyAddressVipAndVPort require credential") @@ -8402,7 +8861,7 @@ func NewModifyCdbProxyParamResponse() (response *ModifyCdbProxyParamResponse) { } // ModifyCdbProxyParam -// 配置数据库代理参数 +// 本接口(ModifyCdbProxyParam)用于配置数据库代理参数。 // // 可能返回的错误码: // FAILEDOPERATION_DESCRIBEPROXYGROUPERROR = "FailedOperation.DescribeProxyGroupError" @@ -8413,7 +8872,7 @@ func (c *Client) ModifyCdbProxyParam(request *ModifyCdbProxyParamRequest) (respo } // ModifyCdbProxyParam -// 配置数据库代理参数 +// 本接口(ModifyCdbProxyParam)用于配置数据库代理参数。 // // 可能返回的错误码: // FAILEDOPERATION_DESCRIBEPROXYGROUPERROR = "FailedOperation.DescribeProxyGroupError" @@ -8423,6 +8882,7 @@ func (c *Client) ModifyCdbProxyParamWithContext(ctx context.Context, request *Mo if request == nil { request = NewModifyCdbProxyParamRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "ModifyCdbProxyParam") if c.GetCredential() == nil { return nil, errors.New("ModifyCdbProxyParam require credential") @@ -8480,6 +8940,7 @@ func (c *Client) ModifyDBInstanceLogToCLSWithContext(ctx context.Context, reques if request == nil { request = NewModifyDBInstanceLogToCLSRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "ModifyDBInstanceLogToCLS") if c.GetCredential() == nil { return nil, errors.New("ModifyDBInstanceLogToCLS require credential") @@ -8537,6 +8998,7 @@ func (c *Client) ModifyDBInstanceNameWithContext(ctx context.Context, request *M if request == nil { request = NewModifyDBInstanceNameRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "ModifyDBInstanceName") if c.GetCredential() == nil { return nil, errors.New("ModifyDBInstanceName require credential") @@ -8598,6 +9060,7 @@ func (c *Client) ModifyDBInstanceProjectWithContext(ctx context.Context, request if request == nil { request = NewModifyDBInstanceProjectRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "ModifyDBInstanceProject") if c.GetCredential() == nil { return nil, errors.New("ModifyDBInstanceProject require credential") @@ -8610,6 +9073,68 @@ func (c *Client) ModifyDBInstanceProjectWithContext(ctx context.Context, request return } +func NewModifyDBInstanceReadOnlyStatusRequest() (request *ModifyDBInstanceReadOnlyStatusRequest) { + request = &ModifyDBInstanceReadOnlyStatusRequest{ + BaseRequest: &tchttp.BaseRequest{}, + } + + request.Init().WithApiInfo("cdb", APIVersion, "ModifyDBInstanceReadOnlyStatus") + + + return +} + +func NewModifyDBInstanceReadOnlyStatusResponse() (response *ModifyDBInstanceReadOnlyStatusResponse) { + response = &ModifyDBInstanceReadOnlyStatusResponse{ + BaseResponse: &tchttp.BaseResponse{}, + } + return + +} + +// ModifyDBInstanceReadOnlyStatus +// 本接口(ModifyDBInstanceReadOnlyStatus)用户设置MySQL云数据库实例为只读 +// +// 可能返回的错误码: +// INTERNALERROR_CDBCGWERROR = "InternalError.CdbCgwError" +// INTERNALERROR_DBRECORDNOTEXISTERROR = "InternalError.DBRecordNotExistError" +// INTERNALERROR_HTTPERROR = "InternalError.HttpError" +// INTERNALERROR_UNKNOWNERROR = "InternalError.UnknownError" +// INVALIDPARAMETER = "InvalidParameter" +// INVALIDPARAMETER_INSTANCENOTFOUND = "InvalidParameter.InstanceNotFound" +// OPERATIONDENIED = "OperationDenied" +func (c *Client) ModifyDBInstanceReadOnlyStatus(request *ModifyDBInstanceReadOnlyStatusRequest) (response *ModifyDBInstanceReadOnlyStatusResponse, err error) { + return c.ModifyDBInstanceReadOnlyStatusWithContext(context.Background(), request) +} + +// ModifyDBInstanceReadOnlyStatus +// 本接口(ModifyDBInstanceReadOnlyStatus)用户设置MySQL云数据库实例为只读 +// +// 可能返回的错误码: +// INTERNALERROR_CDBCGWERROR = "InternalError.CdbCgwError" +// INTERNALERROR_DBRECORDNOTEXISTERROR = "InternalError.DBRecordNotExistError" +// INTERNALERROR_HTTPERROR = "InternalError.HttpError" +// INTERNALERROR_UNKNOWNERROR = "InternalError.UnknownError" +// INVALIDPARAMETER = "InvalidParameter" +// INVALIDPARAMETER_INSTANCENOTFOUND = "InvalidParameter.InstanceNotFound" +// OPERATIONDENIED = "OperationDenied" +func (c *Client) ModifyDBInstanceReadOnlyStatusWithContext(ctx context.Context, request *ModifyDBInstanceReadOnlyStatusRequest) (response *ModifyDBInstanceReadOnlyStatusResponse, err error) { + if request == nil { + request = NewModifyDBInstanceReadOnlyStatusRequest() + } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "ModifyDBInstanceReadOnlyStatus") + + if c.GetCredential() == nil { + return nil, errors.New("ModifyDBInstanceReadOnlyStatus require credential") + } + + request.SetContext(ctx) + + response = NewModifyDBInstanceReadOnlyStatusResponse() + err = c.Send(request, response) + return +} + func NewModifyDBInstanceSecurityGroupsRequest() (request *ModifyDBInstanceSecurityGroupsRequest) { request = &ModifyDBInstanceSecurityGroupsRequest{ BaseRequest: &tchttp.BaseRequest{}, @@ -8659,6 +9184,7 @@ func (c *Client) ModifyDBInstanceSecurityGroupsWithContext(ctx context.Context, if request == nil { request = NewModifyDBInstanceSecurityGroupsRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "ModifyDBInstanceSecurityGroups") if c.GetCredential() == nil { return nil, errors.New("ModifyDBInstanceSecurityGroups require credential") @@ -8691,7 +9217,7 @@ func NewModifyDBInstanceVipVportResponse() (response *ModifyDBInstanceVipVportRe } // ModifyDBInstanceVipVport -// 本接口(ModifyDBInstanceVipVport)用于修改云数据库实例的IP和端口号,也可进行基础网络转 VPC 网络和 VPC 网络下的子网变更。 +// 本接口(ModifyDBInstanceVipVport)用于修改云数据库实例的IP和端口号,也可进行基础网络转 VPC 网络和 VPC 网络下的子网变更。 // // 可能返回的错误码: // AUTHFAILURE = "AuthFailure" @@ -8708,7 +9234,7 @@ func (c *Client) ModifyDBInstanceVipVport(request *ModifyDBInstanceVipVportReque } // ModifyDBInstanceVipVport -// 本接口(ModifyDBInstanceVipVport)用于修改云数据库实例的IP和端口号,也可进行基础网络转 VPC 网络和 VPC 网络下的子网变更。 +// 本接口(ModifyDBInstanceVipVport)用于修改云数据库实例的IP和端口号,也可进行基础网络转 VPC 网络和 VPC 网络下的子网变更。 // // 可能返回的错误码: // AUTHFAILURE = "AuthFailure" @@ -8724,6 +9250,7 @@ func (c *Client) ModifyDBInstanceVipVportWithContext(ctx context.Context, reques if request == nil { request = NewModifyDBInstanceVipVportRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "ModifyDBInstanceVipVport") if c.GetCredential() == nil { return nil, errors.New("ModifyDBInstanceVipVport require credential") @@ -8805,6 +9332,7 @@ func (c *Client) ModifyInstanceParamWithContext(ctx context.Context, request *Mo if request == nil { request = NewModifyInstanceParamRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "ModifyInstanceParam") if c.GetCredential() == nil { return nil, errors.New("ModifyInstanceParam require credential") @@ -8837,7 +9365,7 @@ func NewModifyInstancePasswordComplexityResponse() (response *ModifyInstancePass } // ModifyInstancePasswordComplexity -// 本接口(ModifyInstancePasswordComplexity)用于修改云数据库实例的密码复杂度。 +// 本接口(ModifyInstancePasswordComplexity)用于修改云数据库实例的密码复杂度。 // // 可能返回的错误码: // AUTHFAILURE = "AuthFailure" @@ -8862,7 +9390,7 @@ func (c *Client) ModifyInstancePasswordComplexity(request *ModifyInstancePasswor } // ModifyInstancePasswordComplexity -// 本接口(ModifyInstancePasswordComplexity)用于修改云数据库实例的密码复杂度。 +// 本接口(ModifyInstancePasswordComplexity)用于修改云数据库实例的密码复杂度。 // // 可能返回的错误码: // AUTHFAILURE = "AuthFailure" @@ -8886,6 +9414,7 @@ func (c *Client) ModifyInstancePasswordComplexityWithContext(ctx context.Context if request == nil { request = NewModifyInstancePasswordComplexityRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "ModifyInstancePasswordComplexity") if c.GetCredential() == nil { return nil, errors.New("ModifyInstancePasswordComplexity require credential") @@ -8963,6 +9492,7 @@ func (c *Client) ModifyInstanceTagWithContext(ctx context.Context, request *Modi if request == nil { request = NewModifyInstanceTagRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "ModifyInstanceTag") if c.GetCredential() == nil { return nil, errors.New("ModifyInstanceTag require credential") @@ -8995,7 +9525,7 @@ func NewModifyLocalBinlogConfigResponse() (response *ModifyLocalBinlogConfigResp } // ModifyLocalBinlogConfig -// 该接口用于修改实例本地binlog保留策略。 +// 本接口(ModifyLocalBinlogConfig)用于修改实例本地 binlog 保留策略。 // // 可能返回的错误码: // INTERNALERROR_DBRECORDNOTEXISTERROR = "InternalError.DBRecordNotExistError" @@ -9008,7 +9538,7 @@ func (c *Client) ModifyLocalBinlogConfig(request *ModifyLocalBinlogConfigRequest } // ModifyLocalBinlogConfig -// 该接口用于修改实例本地binlog保留策略。 +// 本接口(ModifyLocalBinlogConfig)用于修改实例本地 binlog 保留策略。 // // 可能返回的错误码: // INTERNALERROR_DBRECORDNOTEXISTERROR = "InternalError.DBRecordNotExistError" @@ -9020,6 +9550,7 @@ func (c *Client) ModifyLocalBinlogConfigWithContext(ctx context.Context, request if request == nil { request = NewModifyLocalBinlogConfigRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "ModifyLocalBinlogConfig") if c.GetCredential() == nil { return nil, errors.New("ModifyLocalBinlogConfig require credential") @@ -9079,6 +9610,7 @@ func (c *Client) ModifyNameOrDescByDpIdWithContext(ctx context.Context, request if request == nil { request = NewModifyNameOrDescByDpIdRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "ModifyNameOrDescByDpId") if c.GetCredential() == nil { return nil, errors.New("ModifyNameOrDescByDpId require credential") @@ -9111,7 +9643,9 @@ func NewModifyParamTemplateResponse() (response *ModifyParamTemplateResponse) { } // ModifyParamTemplate -// 该接口(ModifyParamTemplate)用于修改参数模板,全地域公共参数Region均为ap-guangzhou。 +// 该接口(ModifyParamTemplate)用于修改参数模板。 +// +// 说明:参数模板为公共组件,配置完成后全地域生效。接口调用配置地域可选择广州、新加坡。 // // 可能返回的错误码: // AUTHFAILURE = "AuthFailure" @@ -9126,7 +9660,9 @@ func (c *Client) ModifyParamTemplate(request *ModifyParamTemplateRequest) (respo } // ModifyParamTemplate -// 该接口(ModifyParamTemplate)用于修改参数模板,全地域公共参数Region均为ap-guangzhou。 +// 该接口(ModifyParamTemplate)用于修改参数模板。 +// +// 说明:参数模板为公共组件,配置完成后全地域生效。接口调用配置地域可选择广州、新加坡。 // // 可能返回的错误码: // AUTHFAILURE = "AuthFailure" @@ -9140,6 +9676,7 @@ func (c *Client) ModifyParamTemplateWithContext(ctx context.Context, request *Mo if request == nil { request = NewModifyParamTemplateRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "ModifyParamTemplate") if c.GetCredential() == nil { return nil, errors.New("ModifyParamTemplate require credential") @@ -9152,6 +9689,66 @@ func (c *Client) ModifyParamTemplateWithContext(ctx context.Context, request *Mo return } +func NewModifyProtectModeRequest() (request *ModifyProtectModeRequest) { + request = &ModifyProtectModeRequest{ + BaseRequest: &tchttp.BaseRequest{}, + } + + request.Init().WithApiInfo("cdb", APIVersion, "ModifyProtectMode") + + + return +} + +func NewModifyProtectModeResponse() (response *ModifyProtectModeResponse) { + response = &ModifyProtectModeResponse{ + BaseResponse: &tchttp.BaseResponse{}, + } + return + +} + +// ModifyProtectMode +// 该接口(ModifyProtectMode)用于修改实例的同步方式。 +// +// 说明:仅专属集群可调用,该接口即将下线。 +// +// 可能返回的错误码: +// INVALIDPARAMETER = "InvalidParameter" +// INVALIDPARAMETER_INSTANCENOTFOUND = "InvalidParameter.InstanceNotFound" +// OPERATIONDENIED_ACTIONINPROCESS = "OperationDenied.ActionInProcess" +// OPERATIONDENIED_USERHASNOSTRATEGY = "OperationDenied.UserHasNoStrategy" +func (c *Client) ModifyProtectMode(request *ModifyProtectModeRequest) (response *ModifyProtectModeResponse, err error) { + return c.ModifyProtectModeWithContext(context.Background(), request) +} + +// ModifyProtectMode +// 该接口(ModifyProtectMode)用于修改实例的同步方式。 +// +// 说明:仅专属集群可调用,该接口即将下线。 +// +// 可能返回的错误码: +// INVALIDPARAMETER = "InvalidParameter" +// INVALIDPARAMETER_INSTANCENOTFOUND = "InvalidParameter.InstanceNotFound" +// OPERATIONDENIED_ACTIONINPROCESS = "OperationDenied.ActionInProcess" +// OPERATIONDENIED_USERHASNOSTRATEGY = "OperationDenied.UserHasNoStrategy" +func (c *Client) ModifyProtectModeWithContext(ctx context.Context, request *ModifyProtectModeRequest) (response *ModifyProtectModeResponse, err error) { + if request == nil { + request = NewModifyProtectModeRequest() + } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "ModifyProtectMode") + + if c.GetCredential() == nil { + return nil, errors.New("ModifyProtectMode require credential") + } + + request.SetContext(ctx) + + response = NewModifyProtectModeResponse() + err = c.Send(request, response) + return +} + func NewModifyRemoteBackupConfigRequest() (request *ModifyRemoteBackupConfigRequest) { request = &ModifyRemoteBackupConfigRequest{ BaseRequest: &tchttp.BaseRequest{}, @@ -9197,6 +9794,7 @@ func (c *Client) ModifyRemoteBackupConfigWithContext(ctx context.Context, reques if request == nil { request = NewModifyRemoteBackupConfigRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "ModifyRemoteBackupConfig") if c.GetCredential() == nil { return nil, errors.New("ModifyRemoteBackupConfig require credential") @@ -9276,6 +9874,7 @@ func (c *Client) ModifyRoGroupInfoWithContext(ctx context.Context, request *Modi if request == nil { request = NewModifyRoGroupInfoRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "ModifyRoGroupInfo") if c.GetCredential() == nil { return nil, errors.New("ModifyRoGroupInfo require credential") @@ -9288,6 +9887,64 @@ func (c *Client) ModifyRoGroupInfoWithContext(ctx context.Context, request *Modi return } +func NewModifyRoGroupVipVportRequest() (request *ModifyRoGroupVipVportRequest) { + request = &ModifyRoGroupVipVportRequest{ + BaseRequest: &tchttp.BaseRequest{}, + } + + request.Init().WithApiInfo("cdb", APIVersion, "ModifyRoGroupVipVport") + + + return +} + +func NewModifyRoGroupVipVportResponse() (response *ModifyRoGroupVipVportResponse) { + response = &ModifyRoGroupVipVportResponse{ + BaseResponse: &tchttp.BaseResponse{}, + } + return + +} + +// ModifyRoGroupVipVport +// 该接口(ModifyRoGroupVipVport)用于修改Ro组的vip和vport。 +// +// 可能返回的错误码: +// AUTHFAILURE = "AuthFailure" +// INTERNALERROR_VPCERROR = "InternalError.VpcError" +// INVALIDPARAMETER = "InvalidParameter" +// INVALIDPARAMETER_INSTANCENOTFOUND = "InvalidParameter.InstanceNotFound" +// OPERATIONDENIED = "OperationDenied" +func (c *Client) ModifyRoGroupVipVport(request *ModifyRoGroupVipVportRequest) (response *ModifyRoGroupVipVportResponse, err error) { + return c.ModifyRoGroupVipVportWithContext(context.Background(), request) +} + +// ModifyRoGroupVipVport +// 该接口(ModifyRoGroupVipVport)用于修改Ro组的vip和vport。 +// +// 可能返回的错误码: +// AUTHFAILURE = "AuthFailure" +// INTERNALERROR_VPCERROR = "InternalError.VpcError" +// INVALIDPARAMETER = "InvalidParameter" +// INVALIDPARAMETER_INSTANCENOTFOUND = "InvalidParameter.InstanceNotFound" +// OPERATIONDENIED = "OperationDenied" +func (c *Client) ModifyRoGroupVipVportWithContext(ctx context.Context, request *ModifyRoGroupVipVportRequest) (response *ModifyRoGroupVipVportResponse, err error) { + if request == nil { + request = NewModifyRoGroupVipVportRequest() + } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "ModifyRoGroupVipVport") + + if c.GetCredential() == nil { + return nil, errors.New("ModifyRoGroupVipVport require credential") + } + + request.SetContext(ctx) + + response = NewModifyRoGroupVipVportResponse() + err = c.Send(request, response) + return +} + func NewModifyTimeWindowRequest() (request *ModifyTimeWindowRequest) { request = &ModifyTimeWindowRequest{ BaseRequest: &tchttp.BaseRequest{}, @@ -9339,6 +9996,7 @@ func (c *Client) ModifyTimeWindowWithContext(ctx context.Context, request *Modif if request == nil { request = NewModifyTimeWindowRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "ModifyTimeWindow") if c.GetCredential() == nil { return nil, errors.New("ModifyTimeWindow require credential") @@ -9375,7 +10033,7 @@ func NewOfflineIsolatedInstancesResponse() (response *OfflineIsolatedInstancesRe // // // -// 该接口为异步操作,部分资源的回收可能存在延迟。您可以通过使用 [查询实例列表](https://cloud.tencent.com/document/api/236/15872) 接口,指定实例 InstanceId 和状态 Status 为 [5,6,7] 进行查询,若返回实例为空,则实例资源已全部释放。 +// 该接口为异步操作,部分资源的回收可能存在延迟。您可以通过使用 [查询实例列表](https://cloud.tencent.com/document/api/236/15872) 接口,指定实例 InstanceId 和状态 Status 为 [5,6,7] 进行查询,其中5代表已隔离,6代表下线中,7代表已下线。若返回实例为空,则实例资源已全部释放。 // // // @@ -9396,7 +10054,7 @@ func (c *Client) OfflineIsolatedInstances(request *OfflineIsolatedInstancesReque // // // -// 该接口为异步操作,部分资源的回收可能存在延迟。您可以通过使用 [查询实例列表](https://cloud.tencent.com/document/api/236/15872) 接口,指定实例 InstanceId 和状态 Status 为 [5,6,7] 进行查询,若返回实例为空,则实例资源已全部释放。 +// 该接口为异步操作,部分资源的回收可能存在延迟。您可以通过使用 [查询实例列表](https://cloud.tencent.com/document/api/236/15872) 接口,指定实例 InstanceId 和状态 Status 为 [5,6,7] 进行查询,其中5代表已隔离,6代表下线中,7代表已下线。若返回实例为空,则实例资源已全部释放。 // // // @@ -9412,6 +10070,7 @@ func (c *Client) OfflineIsolatedInstancesWithContext(ctx context.Context, reques if request == nil { request = NewOfflineIsolatedInstancesRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "OfflineIsolatedInstances") if c.GetCredential() == nil { return nil, errors.New("OfflineIsolatedInstances require credential") @@ -9444,7 +10103,7 @@ func NewOpenAuditServiceResponse() (response *OpenAuditServiceResponse) { } // OpenAuditService -// CDB实例开通审计服务 +// 本接口(OpenAuditService)用 CDB 实例开通审计服务。 // // 可能返回的错误码: // FAILEDOPERATION_CREATEAUDITFAILERROR = "FailedOperation.CreateAuditFailError" @@ -9465,7 +10124,7 @@ func (c *Client) OpenAuditService(request *OpenAuditServiceRequest) (response *O } // OpenAuditService -// CDB实例开通审计服务 +// 本接口(OpenAuditService)用 CDB 实例开通审计服务。 // // 可能返回的错误码: // FAILEDOPERATION_CREATEAUDITFAILERROR = "FailedOperation.CreateAuditFailError" @@ -9485,6 +10144,7 @@ func (c *Client) OpenAuditServiceWithContext(ctx context.Context, request *OpenA if request == nil { request = NewOpenAuditServiceRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "OpenAuditService") if c.GetCredential() == nil { return nil, errors.New("OpenAuditService require credential") @@ -9517,7 +10177,7 @@ func NewOpenDBInstanceEncryptionResponse() (response *OpenDBInstanceEncryptionRe } // OpenDBInstanceEncryption -// 本接口(OpenDBInstanceEncryption)用于启用实例数据存储加密功能,支持用户指定自定义密钥。 +// 本接口(OpenDBInstanceEncryption)用于启用实例数据存储加密功能,支持用户指定自定义密钥。 // // // @@ -9535,9 +10195,11 @@ func NewOpenDBInstanceEncryptionResponse() (response *OpenDBInstanceEncryptionRe // // 3、对云数据库(MySQL)[授予访问KMS密钥的权限](https://console.cloud.tencent.com/cam/role),角色名为MySQL_QCSRole,预设策略名为QcloudAccessForMySQLRole; // +// 4、开启加密后不允许关闭。 +// // // -// 该 API 耗时可能到10s,客户端可能超时,如果调用 API 返回 InternalError ,请您调用DescribeDBInstanceInfo 确认后端加密是否开通成功。 +// 该 API 耗时可能到10s,客户端可能超时,如果调用 API 返回 InternalError ,请您调用 [DescribeDBInstanceInfo](https://cloud.tencent.com/document/product/236/44160) 确认后端加密是否开通成功,调用后参数 Encryption 为 YES 表示已开通成功。 // // 可能返回的错误码: // AUTHFAILURE = "AuthFailure" @@ -9553,7 +10215,7 @@ func (c *Client) OpenDBInstanceEncryption(request *OpenDBInstanceEncryptionReque } // OpenDBInstanceEncryption -// 本接口(OpenDBInstanceEncryption)用于启用实例数据存储加密功能,支持用户指定自定义密钥。 +// 本接口(OpenDBInstanceEncryption)用于启用实例数据存储加密功能,支持用户指定自定义密钥。 // // // @@ -9571,9 +10233,11 @@ func (c *Client) OpenDBInstanceEncryption(request *OpenDBInstanceEncryptionReque // // 3、对云数据库(MySQL)[授予访问KMS密钥的权限](https://console.cloud.tencent.com/cam/role),角色名为MySQL_QCSRole,预设策略名为QcloudAccessForMySQLRole; // +// 4、开启加密后不允许关闭。 +// // // -// 该 API 耗时可能到10s,客户端可能超时,如果调用 API 返回 InternalError ,请您调用DescribeDBInstanceInfo 确认后端加密是否开通成功。 +// 该 API 耗时可能到10s,客户端可能超时,如果调用 API 返回 InternalError ,请您调用 [DescribeDBInstanceInfo](https://cloud.tencent.com/document/product/236/44160) 确认后端加密是否开通成功,调用后参数 Encryption 为 YES 表示已开通成功。 // // 可能返回的错误码: // AUTHFAILURE = "AuthFailure" @@ -9588,6 +10252,7 @@ func (c *Client) OpenDBInstanceEncryptionWithContext(ctx context.Context, reques if request == nil { request = NewOpenDBInstanceEncryptionRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "OpenDBInstanceEncryption") if c.GetCredential() == nil { return nil, errors.New("OpenDBInstanceEncryption require credential") @@ -9643,6 +10308,7 @@ func (c *Client) OpenDBInstanceGTIDWithContext(ctx context.Context, request *Ope if request == nil { request = NewOpenDBInstanceGTIDRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "OpenDBInstanceGTID") if c.GetCredential() == nil { return nil, errors.New("OpenDBInstanceGTID require credential") @@ -9675,11 +10341,11 @@ func NewOpenSSLResponse() (response *OpenSSLResponse) { } // OpenSSL -// 开启SSL连接功能。 +// 本接口(OpenSSL)用于开启 SSL 连接功能。 // // 可能返回的错误码: // FAILEDOPERATION_DBOPERATIONACTIONERROR = "FailedOperation.DBOperationActionError" -// FAILEDOPERATION_OPERATIONINCONFLICTERR = "FailedOperation.OperationInConflictErr" +// FAILEDOPERATION_OPERATIONINCONFLICTERROR = "FailedOperation.OperationInConflictError" // INTERNALERROR_UNKNOWNERROR = "InternalError.UnknownError" // MISSINGPARAMETER_MISSINGPARAMERROR = "MissingParameter.MissingParamError" // OPERATIONDENIED_INSTANCELOCKERCONFLICT = "OperationDenied.InstanceLockerConflict" @@ -9688,11 +10354,11 @@ func (c *Client) OpenSSL(request *OpenSSLRequest) (response *OpenSSLResponse, er } // OpenSSL -// 开启SSL连接功能。 +// 本接口(OpenSSL)用于开启 SSL 连接功能。 // // 可能返回的错误码: // FAILEDOPERATION_DBOPERATIONACTIONERROR = "FailedOperation.DBOperationActionError" -// FAILEDOPERATION_OPERATIONINCONFLICTERR = "FailedOperation.OperationInConflictErr" +// FAILEDOPERATION_OPERATIONINCONFLICTERROR = "FailedOperation.OperationInConflictError" // INTERNALERROR_UNKNOWNERROR = "InternalError.UnknownError" // MISSINGPARAMETER_MISSINGPARAMERROR = "MissingParameter.MissingParamError" // OPERATIONDENIED_INSTANCELOCKERCONFLICT = "OperationDenied.InstanceLockerConflict" @@ -9700,6 +10366,7 @@ func (c *Client) OpenSSLWithContext(ctx context.Context, request *OpenSSLRequest if request == nil { request = NewOpenSSLRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "OpenSSL") if c.GetCredential() == nil { return nil, errors.New("OpenSSL require credential") @@ -9771,6 +10438,7 @@ func (c *Client) OpenWanServiceWithContext(ctx context.Context, request *OpenWan if request == nil { request = NewOpenWanServiceRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "OpenWanService") if c.GetCredential() == nil { return nil, errors.New("OpenWanService require credential") @@ -9806,7 +10474,7 @@ func NewReleaseIsolatedDBInstancesResponse() (response *ReleaseIsolatedDBInstanc // 本接口(ReleaseIsolatedDBInstances)用于恢复已隔离云数据库实例。仅用于按量计费实例的解隔离,包年包月实例的解隔离请使用 RenewDBInstance 。 // // 可能返回的错误码: -// FAILEDOPERATION_OPERATIONINCONFLICTERR = "FailedOperation.OperationInConflictErr" +// FAILEDOPERATION_OPERATIONINCONFLICTERROR = "FailedOperation.OperationInConflictError" // INTERNALERROR_DATABASEACCESSERROR = "InternalError.DatabaseAccessError" // INTERNALERROR_HTTPERROR = "InternalError.HttpError" // INTERNALERROR_UNKNOWNERROR = "InternalError.UnknownError" @@ -9826,7 +10494,7 @@ func (c *Client) ReleaseIsolatedDBInstances(request *ReleaseIsolatedDBInstancesR // 本接口(ReleaseIsolatedDBInstances)用于恢复已隔离云数据库实例。仅用于按量计费实例的解隔离,包年包月实例的解隔离请使用 RenewDBInstance 。 // // 可能返回的错误码: -// FAILEDOPERATION_OPERATIONINCONFLICTERR = "FailedOperation.OperationInConflictErr" +// FAILEDOPERATION_OPERATIONINCONFLICTERROR = "FailedOperation.OperationInConflictError" // INTERNALERROR_DATABASEACCESSERROR = "InternalError.DatabaseAccessError" // INTERNALERROR_HTTPERROR = "InternalError.HttpError" // INTERNALERROR_UNKNOWNERROR = "InternalError.UnknownError" @@ -9842,6 +10510,7 @@ func (c *Client) ReleaseIsolatedDBInstancesWithContext(ctx context.Context, requ if request == nil { request = NewReleaseIsolatedDBInstancesRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "ReleaseIsolatedDBInstances") if c.GetCredential() == nil { return nil, errors.New("ReleaseIsolatedDBInstances require credential") @@ -9895,6 +10564,7 @@ func (c *Client) ReloadBalanceProxyNodeWithContext(ctx context.Context, request if request == nil { request = NewReloadBalanceProxyNodeRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "ReloadBalanceProxyNode") if c.GetCredential() == nil { return nil, errors.New("ReloadBalanceProxyNode require credential") @@ -9927,7 +10597,7 @@ func NewRenewDBInstanceResponse() (response *RenewDBInstanceResponse) { } // RenewDBInstance -// 本接口(RenewDBInstance)用于续费云数据库实例,支持付费模式为包年包月的实例。按量计费实例可通过该接口续费为包年包月的实例。 +// 本接口(RenewDBInstance)用于续费云数据库实例,支持付费模式为包年包月的实例。按量计费实例可通过该接口续费为包年包月的实例。 // // 可能返回的错误码: // INTERNALERROR_CDBCGWERROR = "InternalError.CdbCgwError" @@ -9942,7 +10612,7 @@ func (c *Client) RenewDBInstance(request *RenewDBInstanceRequest) (response *Ren } // RenewDBInstance -// 本接口(RenewDBInstance)用于续费云数据库实例,支持付费模式为包年包月的实例。按量计费实例可通过该接口续费为包年包月的实例。 +// 本接口(RenewDBInstance)用于续费云数据库实例,支持付费模式为包年包月的实例。按量计费实例可通过该接口续费为包年包月的实例。 // // 可能返回的错误码: // INTERNALERROR_CDBCGWERROR = "InternalError.CdbCgwError" @@ -9956,6 +10626,7 @@ func (c *Client) RenewDBInstanceWithContext(ctx context.Context, request *RenewD if request == nil { request = NewRenewDBInstanceRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "RenewDBInstance") if c.GetCredential() == nil { return nil, errors.New("RenewDBInstance require credential") @@ -9968,6 +10639,68 @@ func (c *Client) RenewDBInstanceWithContext(ctx context.Context, request *RenewD return } +func NewResetPasswordRequest() (request *ResetPasswordRequest) { + request = &ResetPasswordRequest{ + BaseRequest: &tchttp.BaseRequest{}, + } + + request.Init().WithApiInfo("cdb", APIVersion, "ResetPassword") + + + return +} + +func NewResetPasswordResponse() (response *ResetPasswordResponse) { + response = &ResetPasswordResponse{ + BaseResponse: &tchttp.BaseResponse{}, + } + return + +} + +// ResetPassword +// 手动刷新轮转密码 +// +// 可能返回的错误码: +// INTERNALERROR_CDBCGWERROR = "InternalError.CdbCgwError" +// INTERNALERROR_TRADEERROR = "InternalError.TradeError" +// INTERNALERROR_UNDEFINEDERROR = "InternalError.UndefinedError" +// INVALIDPARAMETER = "InvalidParameter" +// INVALIDPARAMETER_INSTANCENOTFOUND = "InvalidParameter.InstanceNotFound" +// OPERATIONDENIED_ACTIONNOTSUPPORT = "OperationDenied.ActionNotSupport" +// OPERATIONDENIED_USERHASNOSTRATEGY = "OperationDenied.UserHasNoStrategy" +func (c *Client) ResetPassword(request *ResetPasswordRequest) (response *ResetPasswordResponse, err error) { + return c.ResetPasswordWithContext(context.Background(), request) +} + +// ResetPassword +// 手动刷新轮转密码 +// +// 可能返回的错误码: +// INTERNALERROR_CDBCGWERROR = "InternalError.CdbCgwError" +// INTERNALERROR_TRADEERROR = "InternalError.TradeError" +// INTERNALERROR_UNDEFINEDERROR = "InternalError.UndefinedError" +// INVALIDPARAMETER = "InvalidParameter" +// INVALIDPARAMETER_INSTANCENOTFOUND = "InvalidParameter.InstanceNotFound" +// OPERATIONDENIED_ACTIONNOTSUPPORT = "OperationDenied.ActionNotSupport" +// OPERATIONDENIED_USERHASNOSTRATEGY = "OperationDenied.UserHasNoStrategy" +func (c *Client) ResetPasswordWithContext(ctx context.Context, request *ResetPasswordRequest) (response *ResetPasswordResponse, err error) { + if request == nil { + request = NewResetPasswordRequest() + } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "ResetPassword") + + if c.GetCredential() == nil { + return nil, errors.New("ResetPassword require credential") + } + + request.SetContext(ctx) + + response = NewResetPasswordResponse() + err = c.Send(request, response) + return +} + func NewResetRootAccountRequest() (request *ResetRootAccountRequest) { request = &ResetRootAccountRequest{ BaseRequest: &tchttp.BaseRequest{}, @@ -10011,6 +10744,7 @@ func (c *Client) ResetRootAccountWithContext(ctx context.Context, request *Reset if request == nil { request = NewResetRootAccountRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "ResetRootAccount") if c.GetCredential() == nil { return nil, errors.New("ResetRootAccount require credential") @@ -10043,13 +10777,13 @@ func NewRestartDBInstancesResponse() (response *RestartDBInstancesResponse) { } // RestartDBInstances -// 本接口(RestartDBInstances)用于重启云数据库实例。 +// 本接口(RestartDBInstances)用于重启云数据库实例。 // // // // 注意: // -// 1、本接口只支持主实例进行重启操作; +// 1、本接口支持主实例、只读实例、灾备实例进行重启操作。 // // 2、实例状态必须为正常,并且没有其他异步任务在执行中。 // @@ -10068,13 +10802,13 @@ func (c *Client) RestartDBInstances(request *RestartDBInstancesRequest) (respons } // RestartDBInstances -// 本接口(RestartDBInstances)用于重启云数据库实例。 +// 本接口(RestartDBInstances)用于重启云数据库实例。 // // // // 注意: // -// 1、本接口只支持主实例进行重启操作; +// 1、本接口支持主实例、只读实例、灾备实例进行重启操作。 // // 2、实例状态必须为正常,并且没有其他异步任务在执行中。 // @@ -10092,6 +10826,7 @@ func (c *Client) RestartDBInstancesWithContext(ctx context.Context, request *Res if request == nil { request = NewRestartDBInstancesRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "RestartDBInstances") if c.GetCredential() == nil { return nil, errors.New("RestartDBInstances require credential") @@ -10159,6 +10894,7 @@ func (c *Client) StartBatchRollbackWithContext(ctx context.Context, request *Sta if request == nil { request = NewStartBatchRollbackRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "StartBatchRollback") if c.GetCredential() == nil { return nil, errors.New("StartBatchRollback require credential") @@ -10191,7 +10927,7 @@ func NewStartCpuExpandResponse() (response *StartCpuExpandResponse) { } // StartCpuExpand -// 通过该API,可以开启CPU弹性扩容,包括一次性的手动扩容以及自动弹性扩容。 +// 通过该 API,可以开启 CPU 弹性扩容,包括一次性的手动扩容以及自动弹性扩容。 // // 可能返回的错误码: // FAILEDOPERATION_INSTANCETASKCONFLICTERROR = "FailedOperation.InstanceTaskConflictError" @@ -10206,7 +10942,7 @@ func (c *Client) StartCpuExpand(request *StartCpuExpandRequest) (response *Start } // StartCpuExpand -// 通过该API,可以开启CPU弹性扩容,包括一次性的手动扩容以及自动弹性扩容。 +// 通过该 API,可以开启 CPU 弹性扩容,包括一次性的手动扩容以及自动弹性扩容。 // // 可能返回的错误码: // FAILEDOPERATION_INSTANCETASKCONFLICTERROR = "FailedOperation.InstanceTaskConflictError" @@ -10220,6 +10956,7 @@ func (c *Client) StartCpuExpandWithContext(ctx context.Context, request *StartCp if request == nil { request = NewStartCpuExpandRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "StartCpuExpand") if c.GetCredential() == nil { return nil, errors.New("StartCpuExpand require credential") @@ -10252,7 +10989,7 @@ func NewStartReplicationResponse() (response *StartReplicationResponse) { } // StartReplication -// 开启 RO 复制,从主实例同步数据。 +// 本接口(StartReplication)用于开启 RO 复制,从主实例同步数据。 // // 可能返回的错误码: // FAILEDOPERATION = "FailedOperation" @@ -10260,13 +10997,13 @@ func NewStartReplicationResponse() (response *StartReplicationResponse) { // INTERNALERROR_DBERROR = "InternalError.DBError" // INTERNALERROR_UNKNOWNERROR = "InternalError.UnknownError" // OPERATIONDENIED_INSTANCETASKRUNNING = "OperationDenied.InstanceTaskRunning" -// RESOURCENOTFOUND_INSTANCENOTFUNDERROR = "ResourceNotFound.InstanceNotFundError" +// RESOURCENOTFOUND_INSTANCENOTFOUNDERROR = "ResourceNotFound.InstanceNotFoundError" func (c *Client) StartReplication(request *StartReplicationRequest) (response *StartReplicationResponse, err error) { return c.StartReplicationWithContext(context.Background(), request) } // StartReplication -// 开启 RO 复制,从主实例同步数据。 +// 本接口(StartReplication)用于开启 RO 复制,从主实例同步数据。 // // 可能返回的错误码: // FAILEDOPERATION = "FailedOperation" @@ -10274,11 +11011,12 @@ func (c *Client) StartReplication(request *StartReplicationRequest) (response *S // INTERNALERROR_DBERROR = "InternalError.DBError" // INTERNALERROR_UNKNOWNERROR = "InternalError.UnknownError" // OPERATIONDENIED_INSTANCETASKRUNNING = "OperationDenied.InstanceTaskRunning" -// RESOURCENOTFOUND_INSTANCENOTFUNDERROR = "ResourceNotFound.InstanceNotFundError" +// RESOURCENOTFOUND_INSTANCENOTFOUNDERROR = "ResourceNotFound.InstanceNotFoundError" func (c *Client) StartReplicationWithContext(ctx context.Context, request *StartReplicationRequest) (response *StartReplicationResponse, err error) { if request == nil { request = NewStartReplicationRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "StartReplication") if c.GetCredential() == nil { return nil, errors.New("StartReplication require credential") @@ -10336,6 +11074,7 @@ func (c *Client) StopCpuExpandWithContext(ctx context.Context, request *StopCpuE if request == nil { request = NewStopCpuExpandRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "StopCpuExpand") if c.GetCredential() == nil { return nil, errors.New("StopCpuExpand require credential") @@ -10368,7 +11107,9 @@ func NewStopDBImportJobResponse() (response *StopDBImportJobResponse) { } // StopDBImportJob -// 本接口(StopDBImportJob)用于终止数据导入任务。 +// 本接口(StopDBImportJob)用于终止数据导入任务。 +// +// 说明:只有未完成的导入任务支持被终止,且终止后已执行的 SQL 部分会被保留。 // // 可能返回的错误码: // CDBERROR_IMPORTERROR = "CdbError.ImportError" @@ -10382,7 +11123,9 @@ func (c *Client) StopDBImportJob(request *StopDBImportJobRequest) (response *Sto } // StopDBImportJob -// 本接口(StopDBImportJob)用于终止数据导入任务。 +// 本接口(StopDBImportJob)用于终止数据导入任务。 +// +// 说明:只有未完成的导入任务支持被终止,且终止后已执行的 SQL 部分会被保留。 // // 可能返回的错误码: // CDBERROR_IMPORTERROR = "CdbError.ImportError" @@ -10395,6 +11138,7 @@ func (c *Client) StopDBImportJobWithContext(ctx context.Context, request *StopDB if request == nil { request = NewStopDBImportJobRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "StopDBImportJob") if c.GetCredential() == nil { return nil, errors.New("StopDBImportJob require credential") @@ -10427,7 +11171,7 @@ func NewStopReplicationResponse() (response *StopReplicationResponse) { } // StopReplication -// 停止 RO 复制,中断从主实例同步数据。 +// 本接口(StopReplication)用于停止 RO 复制,中断从主实例同步数据。 // // 可能返回的错误码: // FAILEDOPERATION = "FailedOperation" @@ -10436,13 +11180,13 @@ func NewStopReplicationResponse() (response *StopReplicationResponse) { // INTERNALERROR_DBERROR = "InternalError.DBError" // INTERNALERROR_UNKNOWNERROR = "InternalError.UnknownError" // OPERATIONDENIED_INSTANCETASKRUNNING = "OperationDenied.InstanceTaskRunning" -// RESOURCENOTFOUND_INSTANCENOTFUNDERROR = "ResourceNotFound.InstanceNotFundError" +// RESOURCENOTFOUND_INSTANCENOTFOUNDERROR = "ResourceNotFound.InstanceNotFoundError" func (c *Client) StopReplication(request *StopReplicationRequest) (response *StopReplicationResponse, err error) { return c.StopReplicationWithContext(context.Background(), request) } // StopReplication -// 停止 RO 复制,中断从主实例同步数据。 +// 本接口(StopReplication)用于停止 RO 复制,中断从主实例同步数据。 // // 可能返回的错误码: // FAILEDOPERATION = "FailedOperation" @@ -10451,11 +11195,12 @@ func (c *Client) StopReplication(request *StopReplicationRequest) (response *Sto // INTERNALERROR_DBERROR = "InternalError.DBError" // INTERNALERROR_UNKNOWNERROR = "InternalError.UnknownError" // OPERATIONDENIED_INSTANCETASKRUNNING = "OperationDenied.InstanceTaskRunning" -// RESOURCENOTFOUND_INSTANCENOTFUNDERROR = "ResourceNotFound.InstanceNotFundError" +// RESOURCENOTFOUND_INSTANCENOTFOUNDERROR = "ResourceNotFound.InstanceNotFoundError" func (c *Client) StopReplicationWithContext(ctx context.Context, request *StopReplicationRequest) (response *StopReplicationResponse, err error) { if request == nil { request = NewStopReplicationRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "StopReplication") if c.GetCredential() == nil { return nil, errors.New("StopReplication require credential") @@ -10488,7 +11233,7 @@ func NewStopRollbackResponse() (response *StopRollbackResponse) { } // StopRollback -// 本接口(StopRollback) 用于撤销实例正在进行的回档任务,该接口返回一个异步任务id。 撤销结果可以通过 DescribeAsyncRequestInfo 查询任务的执行情况。 +// 本接口(StopRollback)用于撤销实例正在进行的回档任务,该接口返回一个异步任务 ID。撤销结果可以通过 [DescribeAsyncRequestInfo](https://cloud.tencent.com/document/api/236/20410) 查询任务的执行情况。 // // 可能返回的错误码: // AUTHFAILURE = "AuthFailure" @@ -10504,7 +11249,7 @@ func (c *Client) StopRollback(request *StopRollbackRequest) (response *StopRollb } // StopRollback -// 本接口(StopRollback) 用于撤销实例正在进行的回档任务,该接口返回一个异步任务id。 撤销结果可以通过 DescribeAsyncRequestInfo 查询任务的执行情况。 +// 本接口(StopRollback)用于撤销实例正在进行的回档任务,该接口返回一个异步任务 ID。撤销结果可以通过 [DescribeAsyncRequestInfo](https://cloud.tencent.com/document/api/236/20410) 查询任务的执行情况。 // // 可能返回的错误码: // AUTHFAILURE = "AuthFailure" @@ -10519,6 +11264,7 @@ func (c *Client) StopRollbackWithContext(ctx context.Context, request *StopRollb if request == nil { request = NewStopRollbackRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "StopRollback") if c.GetCredential() == nil { return nil, errors.New("StopRollback require credential") @@ -10531,6 +11277,64 @@ func (c *Client) StopRollbackWithContext(ctx context.Context, request *StopRollb return } +func NewSubmitInstanceUpgradeCheckJobRequest() (request *SubmitInstanceUpgradeCheckJobRequest) { + request = &SubmitInstanceUpgradeCheckJobRequest{ + BaseRequest: &tchttp.BaseRequest{}, + } + + request.Init().WithApiInfo("cdb", APIVersion, "SubmitInstanceUpgradeCheckJob") + + + return +} + +func NewSubmitInstanceUpgradeCheckJobResponse() (response *SubmitInstanceUpgradeCheckJobResponse) { + response = &SubmitInstanceUpgradeCheckJobResponse{ + BaseResponse: &tchttp.BaseResponse{}, + } + return + +} + +// SubmitInstanceUpgradeCheckJob +// 该接口(SubmitInstanceUpgradeCheckJob)提交实例版本升级校验任务。 +// +// 可能返回的错误码: +// FAILEDOPERATION_FAILEDOPERATIONERROR = "FailedOperation.FailedOperationError" +// INTERNALERROR_UNKNOWNERROR = "InternalError.UnknownError" +// INVALIDPARAMETER_EXCEPTIONPARAM = "InvalidParameter.ExceptionParam" +// OPERATIONDENIED_INSTANCETASKSTATUSERROR = "OperationDenied.InstanceTaskStatusError" +// RESOURCENOTFOUND_CDBINSTANCENOTFOUNDERROR = "ResourceNotFound.CdbInstanceNotFoundError" +func (c *Client) SubmitInstanceUpgradeCheckJob(request *SubmitInstanceUpgradeCheckJobRequest) (response *SubmitInstanceUpgradeCheckJobResponse, err error) { + return c.SubmitInstanceUpgradeCheckJobWithContext(context.Background(), request) +} + +// SubmitInstanceUpgradeCheckJob +// 该接口(SubmitInstanceUpgradeCheckJob)提交实例版本升级校验任务。 +// +// 可能返回的错误码: +// FAILEDOPERATION_FAILEDOPERATIONERROR = "FailedOperation.FailedOperationError" +// INTERNALERROR_UNKNOWNERROR = "InternalError.UnknownError" +// INVALIDPARAMETER_EXCEPTIONPARAM = "InvalidParameter.ExceptionParam" +// OPERATIONDENIED_INSTANCETASKSTATUSERROR = "OperationDenied.InstanceTaskStatusError" +// RESOURCENOTFOUND_CDBINSTANCENOTFOUNDERROR = "ResourceNotFound.CdbInstanceNotFoundError" +func (c *Client) SubmitInstanceUpgradeCheckJobWithContext(ctx context.Context, request *SubmitInstanceUpgradeCheckJobRequest) (response *SubmitInstanceUpgradeCheckJobResponse, err error) { + if request == nil { + request = NewSubmitInstanceUpgradeCheckJobRequest() + } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "SubmitInstanceUpgradeCheckJob") + + if c.GetCredential() == nil { + return nil, errors.New("SubmitInstanceUpgradeCheckJob require credential") + } + + request.SetContext(ctx) + + response = NewSubmitInstanceUpgradeCheckJobResponse() + err = c.Send(request, response) + return +} + func NewSwitchCDBProxyRequest() (request *SwitchCDBProxyRequest) { request = &SwitchCDBProxyRequest{ BaseRequest: &tchttp.BaseRequest{}, @@ -10551,7 +11355,7 @@ func NewSwitchCDBProxyResponse() (response *SwitchCDBProxyResponse) { } // SwitchCDBProxy -// 数据库代理配置变更或则升级版本后手动发起立即切换 +// 本接口(SwitchCDBProxy)用于数据库代理配置变更或者升级版本后手动发起立即切换。 // // 可能返回的错误码: // FAILEDOPERATION_DESCRIBEPROXYGROUPERROR = "FailedOperation.DescribeProxyGroupError" @@ -10563,7 +11367,7 @@ func (c *Client) SwitchCDBProxy(request *SwitchCDBProxyRequest) (response *Switc } // SwitchCDBProxy -// 数据库代理配置变更或则升级版本后手动发起立即切换 +// 本接口(SwitchCDBProxy)用于数据库代理配置变更或者升级版本后手动发起立即切换。 // // 可能返回的错误码: // FAILEDOPERATION_DESCRIBEPROXYGROUPERROR = "FailedOperation.DescribeProxyGroupError" @@ -10574,6 +11378,7 @@ func (c *Client) SwitchCDBProxyWithContext(ctx context.Context, request *SwitchC if request == nil { request = NewSwitchCDBProxyRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "SwitchCDBProxy") if c.GetCredential() == nil { return nil, errors.New("SwitchCDBProxy require credential") @@ -10639,6 +11444,7 @@ func (c *Client) SwitchDBInstanceMasterSlaveWithContext(ctx context.Context, req if request == nil { request = NewSwitchDBInstanceMasterSlaveRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "SwitchDBInstanceMasterSlave") if c.GetCredential() == nil { return nil, errors.New("SwitchDBInstanceMasterSlave require credential") @@ -10671,7 +11477,7 @@ func NewSwitchDrInstanceToMasterResponse() (response *SwitchDrInstanceToMasterRe } // SwitchDrInstanceToMaster -// 本接口(SwitchDrInstanceToMaster)用于将云数据库灾备实例切换为主实例,注意请求必须发到灾备实例所在的地域。 +// 本接口(SwitchDrInstanceToMaster)用于将云数据库灾备实例切换为主实例,注意请求必须发到灾备实例所在的地域。 // // 可能返回的错误码: // FAILEDOPERATION_STATUSCONFLICT = "FailedOperation.StatusConflict" @@ -10684,7 +11490,7 @@ func (c *Client) SwitchDrInstanceToMaster(request *SwitchDrInstanceToMasterReque } // SwitchDrInstanceToMaster -// 本接口(SwitchDrInstanceToMaster)用于将云数据库灾备实例切换为主实例,注意请求必须发到灾备实例所在的地域。 +// 本接口(SwitchDrInstanceToMaster)用于将云数据库灾备实例切换为主实例,注意请求必须发到灾备实例所在的地域。 // // 可能返回的错误码: // FAILEDOPERATION_STATUSCONFLICT = "FailedOperation.StatusConflict" @@ -10696,6 +11502,7 @@ func (c *Client) SwitchDrInstanceToMasterWithContext(ctx context.Context, reques if request == nil { request = NewSwitchDrInstanceToMasterRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "SwitchDrInstanceToMaster") if c.GetCredential() == nil { return nil, errors.New("SwitchDrInstanceToMaster require credential") @@ -10753,6 +11560,7 @@ func (c *Client) SwitchForUpgradeWithContext(ctx context.Context, request *Switc if request == nil { request = NewSwitchForUpgradeRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "SwitchForUpgrade") if c.GetCredential() == nil { return nil, errors.New("SwitchForUpgrade require credential") @@ -10785,7 +11593,7 @@ func NewUpgradeCDBProxyVersionResponse() (response *UpgradeCDBProxyVersionRespon } // UpgradeCDBProxyVersion -// 升级数据库代理版本 +// 本接口(UpgradeCDBProxyVersion)用于升级数据库代理版本。 // // 可能返回的错误码: // FAILEDOPERATION_DESCRIBEPROXYGROUPERROR = "FailedOperation.DescribeProxyGroupError" @@ -10796,7 +11604,7 @@ func (c *Client) UpgradeCDBProxyVersion(request *UpgradeCDBProxyVersionRequest) } // UpgradeCDBProxyVersion -// 升级数据库代理版本 +// 本接口(UpgradeCDBProxyVersion)用于升级数据库代理版本。 // // 可能返回的错误码: // FAILEDOPERATION_DESCRIBEPROXYGROUPERROR = "FailedOperation.DescribeProxyGroupError" @@ -10806,6 +11614,7 @@ func (c *Client) UpgradeCDBProxyVersionWithContext(ctx context.Context, request if request == nil { request = NewUpgradeCDBProxyVersionRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "UpgradeCDBProxyVersion") if c.GetCredential() == nil { return nil, errors.New("UpgradeCDBProxyVersion require credential") @@ -10838,7 +11647,7 @@ func NewUpgradeDBInstanceResponse() (response *UpgradeDBInstanceResponse) { } // UpgradeDBInstance -// 本接口(UpgradeDBInstance)用于升级或降级云数据库实例的配置,实例类型支持主实例、灾备实例和只读实例。如果进行迁移业务,请一定填写实例规格(CPU、内存),不然系统会默认以最小允许规格传参。 +// 本接口(UpgradeDBInstance)用于升级或降级云数据库实例的配置,实例类型支持主实例、灾备实例和只读实例。如果进行迁移业务,请一定填写实例规格(CPU、内存),不然系统会默认以最小允许规格传参。 // // 可能返回的错误码: // CDBERROR = "CdbError" @@ -10858,7 +11667,7 @@ func (c *Client) UpgradeDBInstance(request *UpgradeDBInstanceRequest) (response } // UpgradeDBInstance -// 本接口(UpgradeDBInstance)用于升级或降级云数据库实例的配置,实例类型支持主实例、灾备实例和只读实例。如果进行迁移业务,请一定填写实例规格(CPU、内存),不然系统会默认以最小允许规格传参。 +// 本接口(UpgradeDBInstance)用于升级或降级云数据库实例的配置,实例类型支持主实例、灾备实例和只读实例。如果进行迁移业务,请一定填写实例规格(CPU、内存),不然系统会默认以最小允许规格传参。 // // 可能返回的错误码: // CDBERROR = "CdbError" @@ -10877,6 +11686,7 @@ func (c *Client) UpgradeDBInstanceWithContext(ctx context.Context, request *Upgr if request == nil { request = NewUpgradeDBInstanceRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "UpgradeDBInstance") if c.GetCredential() == nil { return nil, errors.New("UpgradeDBInstance require credential") @@ -10909,7 +11719,7 @@ func NewUpgradeDBInstanceEngineVersionResponse() (response *UpgradeDBInstanceEng } // UpgradeDBInstanceEngineVersion -// 本接口(UpgradeDBInstanceEngineVersion)用于升级云数据库实例版本,实例类型支持主实例、灾备实例和只读实例。 +// 本接口(UpgradeDBInstanceEngineVersion)用于升级云数据库实例版本,实例类型支持主实例、灾备实例和只读实例等。升级前请通过 [SubmitInstanceUpgradeCheckJob](https://cloud.tencent.com/document/product/236/110468) 提交升级检查任务,通过后才能升级。 // // 可能返回的错误码: // FAILEDOPERATION_STATUSCONFLICT = "FailedOperation.StatusConflict" @@ -10928,7 +11738,7 @@ func (c *Client) UpgradeDBInstanceEngineVersion(request *UpgradeDBInstanceEngine } // UpgradeDBInstanceEngineVersion -// 本接口(UpgradeDBInstanceEngineVersion)用于升级云数据库实例版本,实例类型支持主实例、灾备实例和只读实例。 +// 本接口(UpgradeDBInstanceEngineVersion)用于升级云数据库实例版本,实例类型支持主实例、灾备实例和只读实例等。升级前请通过 [SubmitInstanceUpgradeCheckJob](https://cloud.tencent.com/document/product/236/110468) 提交升级检查任务,通过后才能升级。 // // 可能返回的错误码: // FAILEDOPERATION_STATUSCONFLICT = "FailedOperation.StatusConflict" @@ -10946,6 +11756,7 @@ func (c *Client) UpgradeDBInstanceEngineVersionWithContext(ctx context.Context, if request == nil { request = NewUpgradeDBInstanceEngineVersionRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "UpgradeDBInstanceEngineVersion") if c.GetCredential() == nil { return nil, errors.New("UpgradeDBInstanceEngineVersion require credential") @@ -11053,6 +11864,7 @@ func (c *Client) VerifyRootAccountWithContext(ctx context.Context, request *Veri if request == nil { request = NewVerifyRootAccountRequest() } + c.InitBaseRequest(&request.BaseRequest, "cdb", APIVersion, "VerifyRootAccount") if c.GetCredential() == nil { return nil, errors.New("VerifyRootAccount require credential") diff --git a/vendor/github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cdb/v20170320/errors.go b/vendor/github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cdb/v20170320/errors.go index 8c218c55dd..4af9ca91c7 100644 --- a/vendor/github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cdb/v20170320/errors.go +++ b/vendor/github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cdb/v20170320/errors.go @@ -1,4 +1,4 @@ -// Copyright (c) 2017-2018 THL A29 Limited, a Tencent company. All Rights Reserved. +// Copyright (c) 2017-2025 Tencent. All Rights Reserved. // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -102,7 +102,7 @@ const ( FAILEDOPERATION_NOTDELAYRO = "FailedOperation.NotDelayRo" // 实例正在执行其他操作,请稍后重试。 - FAILEDOPERATION_OPERATIONINCONFLICTERR = "FailedOperation.OperationInConflictErr" + FAILEDOPERATION_OPERATIONINCONFLICTERROR = "FailedOperation.OperationInConflictError" // 执行的权限修改操作非法。您可以参照产品文档,了解当前实例支持哪些权限修改操作,如有疑问,请您咨询客服进行处理。 FAILEDOPERATION_PRIVILEGEDATAILLEGAL = "FailedOperation.PrivilegeDataIllegal" @@ -137,6 +137,9 @@ const ( // 提交任务失败,请稍后重试。如果持续提交失败,请您联系客服进行处理。 FAILEDOPERATION_SUBMITASYNCTASKERROR = "FailedOperation.SubmitAsyncTaskError" + // 任务冲突 + FAILEDOPERATION_TASKCONFLICTERROR = "FailedOperation.TaskConflictError" + // 查询超时。 FAILEDOPERATION_TIMEOUTERROR = "FailedOperation.TimeoutError" @@ -200,7 +203,7 @@ const ( // 数据库操作失败。 INTERNALERROR_DBOPERATIONERROR = "InternalError.DBOperationError" - // 数据库记录不存在。 + // 数据库实例不存在。 INTERNALERROR_DBRECORDNOTEXISTERROR = "InternalError.DBRecordNotExistError" // 数据库内部错误。 @@ -242,6 +245,9 @@ const ( // 请求执行异常。 INTERNALERROR_INTERNALHTTPSERVERERROR = "InternalError.InternalHttpServerError" + // 内部服务异常,请稍后重试 + INTERNALERROR_INTERNALINNERSERVICEERROR = "InternalError.InternalInnerServiceError" + // 后台请求服务失败,请稍后重试。 INTERNALERROR_INTERNALREQUESTERROR = "InternalError.InternalRequestError" @@ -296,6 +302,9 @@ const ( // 交易系统错误。 INTERNALERROR_TRADEERROR = "InternalError.TradeError" + // 开启事务失败 + INTERNALERROR_TRANSACTIOBEGINERROR = "InternalError.TransactioBeginError" + // 操作失败。 INTERNALERROR_TRANSACTIONBEGINERROR = "InternalError.TransactionBeginError" @@ -569,7 +578,7 @@ const ( // 未找到数据库实例,请确认您的实例状态是否正常。 RESOURCENOTFOUND_CDBINSTANCENOTFOUNDERROR = "ResourceNotFound.CdbInstanceNotFoundError" - // 高可用版实例不存在。 + // 该实例不存在。 RESOURCENOTFOUND_INSTANCENOTFOUNDERROR = "ResourceNotFound.InstanceNotFoundError" // 该实例不存在。 diff --git a/vendor/github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cdb/v20170320/models.go b/vendor/github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cdb/v20170320/models.go index 9b27aad39e..e099eda9f3 100644 --- a/vendor/github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cdb/v20170320/models.go +++ b/vendor/github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cdb/v20170320/models.go @@ -1,4 +1,4 @@ -// Copyright (c) 2017-2018 THL A29 Limited, a Tencent company. All Rights Reserved. +// Copyright (c) 2017-2025 Tencent. All Rights Reserved. // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -21,10 +21,13 @@ import ( ) type Account struct { - // 新账户的名称 + // 账号名,可输入1 - 32个字符。 User *string `json:"User,omitnil,omitempty" name:"User"` - // 新账户的域名 + // 账号的主机。 + // 说明: + // 1. IP 形式,支持填入%。 + // 2. 多个主机以分隔符分隔,分隔符支持;,|换行符和空格。 Host *string `json:"Host,omitnil,omitempty" name:"Host"` } @@ -45,15 +48,20 @@ type AccountInfo struct { ModifyPasswordTime *string `json:"ModifyPasswordTime,omitnil,omitempty" name:"ModifyPasswordTime"` // 该值已废弃 + // + // Deprecated: CreateTime is deprecated. CreateTime *string `json:"CreateTime,omitnil,omitempty" name:"CreateTime"` // 用户最大可用实例连接数 MaxUserConnections *int64 `json:"MaxUserConnections,omitnil,omitempty" name:"MaxUserConnections"` + + // 用户账号是否开启了密码轮转 + OpenCam *bool `json:"OpenCam,omitnil,omitempty" name:"OpenCam"` } // Predefined struct for user type AddTimeWindowRequestParams struct { - // 实例ID,格式如:cdb-c1nl9rpv 或者 cdbro-c1nl9rpv,与云数据库控制台页面中显示的实例 ID 相同。 + // 实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` // 星期一的可维护时间段,其中每一个时间段的格式形如:10:00-12:00;起始时间按半个小时对齐;最短半个小时,最长三个小时;可设置多个时间段。 一周中应至少设置一天的时间窗。下同。 @@ -77,14 +85,14 @@ type AddTimeWindowRequestParams struct { // 星期日的可维护时间窗口。 一周中应至少设置一天的时间窗。 Sunday []*string `json:"Sunday,omitnil,omitempty" name:"Sunday"` - // 最大延迟阈值,仅对主实例和灾备实例有效 + // 最大延迟阈值(秒),仅对主实例和灾备实例有效。默认值:10,取值范围:1-10的整数。 MaxDelayTime *uint64 `json:"MaxDelayTime,omitnil,omitempty" name:"MaxDelayTime"` } type AddTimeWindowRequest struct { *tchttp.BaseRequest - // 实例ID,格式如:cdb-c1nl9rpv 或者 cdbro-c1nl9rpv,与云数据库控制台页面中显示的实例 ID 相同。 + // 实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` // 星期一的可维护时间段,其中每一个时间段的格式形如:10:00-12:00;起始时间按半个小时对齐;最短半个小时,最长三个小时;可设置多个时间段。 一周中应至少设置一天的时间窗。下同。 @@ -108,7 +116,7 @@ type AddTimeWindowRequest struct { // 星期日的可维护时间窗口。 一周中应至少设置一天的时间窗。 Sunday []*string `json:"Sunday,omitnil,omitempty" name:"Sunday"` - // 最大延迟阈值,仅对主实例和灾备实例有效 + // 最大延迟阈值(秒),仅对主实例和灾备实例有效。默认值:10,取值范围:1-10的整数。 MaxDelayTime *uint64 `json:"MaxDelayTime,omitnil,omitempty" name:"MaxDelayTime"` } @@ -186,7 +194,7 @@ type AddressInfo struct { // Predefined struct for user type AdjustCdbProxyAddressRequestParams struct { - // 代理组ID + // 代理组 ID。可通过 [DescribeCdbProxyInfo](https://cloud.tencent.com/document/api/236/90585) 接口获取。 ProxyGroupId *string `json:"ProxyGroupId,omitnil,omitempty" name:"ProxyGroupId"` // 权重分配模式, @@ -196,10 +204,11 @@ type AdjustCdbProxyAddressRequestParams struct { // 是否开启延迟剔除,取值:"true" | "false" IsKickOut *bool `json:"IsKickOut,omitnil,omitempty" name:"IsKickOut"` - // 最小保留数量,最小取值:0 + // 最小保留数量,最小取值:0。 + // 说明:当 IsKickOut 为 true 时才有效。 MinCount *uint64 `json:"MinCount,omitnil,omitempty" name:"MinCount"` - // 延迟剔除阈值,最小取值:0 + // 延迟剔除阈值,最小取值:1,取值范围:[1,10000],整数。 MaxDelay *uint64 `json:"MaxDelay,omitnil,omitempty" name:"MaxDelay"` // 是否开启故障转移,取值:"true" | "false" @@ -211,30 +220,36 @@ type AdjustCdbProxyAddressRequestParams struct { // 是否是只读,取值:"true" | "false" ReadOnly *bool `json:"ReadOnly,omitnil,omitempty" name:"ReadOnly"` - // 代理组地址ID + // 代理组地址 ID。可通过 [DescribeCdbProxyInfo](https://cloud.tencent.com/document/api/236/90585) 接口获取。 ProxyAddressId *string `json:"ProxyAddressId,omitnil,omitempty" name:"ProxyAddressId"` - // 是否开启事务分离,取值:"true" | "false" + // 是否开启事务分离,取值:"true" | "false",默认值 false。 TransSplit *bool `json:"TransSplit,omitnil,omitempty" name:"TransSplit"` - // 是否开启连接池 + // 是否开启连接池。默认关闭。 // 注意:如需使用数据库代理连接池能力,MySQL 8.0 主实例的内核小版本要大于等于 MySQL 8.0 20230630。 ConnectionPool *bool `json:"ConnectionPool,omitnil,omitempty" name:"ConnectionPool"` // 读写权重分配。如果 WeightMode 传的是 system ,则传入的权重不生效,由系统分配默认权重。 ProxyAllocation []*ProxyAllocation `json:"ProxyAllocation,omitnil,omitempty" name:"ProxyAllocation"` - // 是否开启自适应负载均衡 + // 是否开启自适应负载均衡。默认关闭。 AutoLoadBalance *bool `json:"AutoLoadBalance,omitnil,omitempty" name:"AutoLoadBalance"` - // 访问模式:就近访问,均衡分配 + // 访问模式:nearby - 就近访问,balance - 均衡分配,默认就近访问。 AccessMode *string `json:"AccessMode,omitnil,omitempty" name:"AccessMode"` + + // 是否将libra节点当作普通RO节点 + ApNodeAsRoNode *string `json:"ApNodeAsRoNode,omitnil,omitempty" name:"ApNodeAsRoNode"` + + // libra节点故障,是否转发给其他节点 + ApQueryToOtherNode *string `json:"ApQueryToOtherNode,omitnil,omitempty" name:"ApQueryToOtherNode"` } type AdjustCdbProxyAddressRequest struct { *tchttp.BaseRequest - // 代理组ID + // 代理组 ID。可通过 [DescribeCdbProxyInfo](https://cloud.tencent.com/document/api/236/90585) 接口获取。 ProxyGroupId *string `json:"ProxyGroupId,omitnil,omitempty" name:"ProxyGroupId"` // 权重分配模式, @@ -244,10 +259,11 @@ type AdjustCdbProxyAddressRequest struct { // 是否开启延迟剔除,取值:"true" | "false" IsKickOut *bool `json:"IsKickOut,omitnil,omitempty" name:"IsKickOut"` - // 最小保留数量,最小取值:0 + // 最小保留数量,最小取值:0。 + // 说明:当 IsKickOut 为 true 时才有效。 MinCount *uint64 `json:"MinCount,omitnil,omitempty" name:"MinCount"` - // 延迟剔除阈值,最小取值:0 + // 延迟剔除阈值,最小取值:1,取值范围:[1,10000],整数。 MaxDelay *uint64 `json:"MaxDelay,omitnil,omitempty" name:"MaxDelay"` // 是否开启故障转移,取值:"true" | "false" @@ -259,24 +275,30 @@ type AdjustCdbProxyAddressRequest struct { // 是否是只读,取值:"true" | "false" ReadOnly *bool `json:"ReadOnly,omitnil,omitempty" name:"ReadOnly"` - // 代理组地址ID + // 代理组地址 ID。可通过 [DescribeCdbProxyInfo](https://cloud.tencent.com/document/api/236/90585) 接口获取。 ProxyAddressId *string `json:"ProxyAddressId,omitnil,omitempty" name:"ProxyAddressId"` - // 是否开启事务分离,取值:"true" | "false" + // 是否开启事务分离,取值:"true" | "false",默认值 false。 TransSplit *bool `json:"TransSplit,omitnil,omitempty" name:"TransSplit"` - // 是否开启连接池 + // 是否开启连接池。默认关闭。 // 注意:如需使用数据库代理连接池能力,MySQL 8.0 主实例的内核小版本要大于等于 MySQL 8.0 20230630。 ConnectionPool *bool `json:"ConnectionPool,omitnil,omitempty" name:"ConnectionPool"` // 读写权重分配。如果 WeightMode 传的是 system ,则传入的权重不生效,由系统分配默认权重。 ProxyAllocation []*ProxyAllocation `json:"ProxyAllocation,omitnil,omitempty" name:"ProxyAllocation"` - // 是否开启自适应负载均衡 + // 是否开启自适应负载均衡。默认关闭。 AutoLoadBalance *bool `json:"AutoLoadBalance,omitnil,omitempty" name:"AutoLoadBalance"` - // 访问模式:就近访问,均衡分配 + // 访问模式:nearby - 就近访问,balance - 均衡分配,默认就近访问。 AccessMode *string `json:"AccessMode,omitnil,omitempty" name:"AccessMode"` + + // 是否将libra节点当作普通RO节点 + ApNodeAsRoNode *string `json:"ApNodeAsRoNode,omitnil,omitempty" name:"ApNodeAsRoNode"` + + // libra节点故障,是否转发给其他节点 + ApQueryToOtherNode *string `json:"ApQueryToOtherNode,omitnil,omitempty" name:"ApQueryToOtherNode"` } func (r *AdjustCdbProxyAddressRequest) ToJsonString() string { @@ -305,6 +327,8 @@ func (r *AdjustCdbProxyAddressRequest) FromJsonString(s string) error { delete(f, "ProxyAllocation") delete(f, "AutoLoadBalance") delete(f, "AccessMode") + delete(f, "ApNodeAsRoNode") + delete(f, "ApQueryToOtherNode") if len(f) > 0 { return tcerr.NewTencentCloudSDKError("ClientError.BuildRequestError", "AdjustCdbProxyAddressRequest has unknown keys!", "") } @@ -314,7 +338,6 @@ func (r *AdjustCdbProxyAddressRequest) FromJsonString(s string) error { // Predefined struct for user type AdjustCdbProxyAddressResponseParams struct { // 异步任务ID - // 注意:此字段可能返回 null,表示取不到有效值。 AsyncRequestId *string `json:"AsyncRequestId,omitnil,omitempty" name:"AsyncRequestId"` // 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 @@ -339,10 +362,10 @@ func (r *AdjustCdbProxyAddressResponse) FromJsonString(s string) error { // Predefined struct for user type AdjustCdbProxyRequestParams struct { - // 实例ID + // 实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` - // 代理组ID + // 代理组 ID。可通过 [DescribeCdbProxyInfo](https://cloud.tencent.com/document/api/236/90585) 接口获取。 ProxyGroupId *string `json:"ProxyGroupId,omitnil,omitempty" name:"ProxyGroupId"` // 节点规格配置 @@ -365,10 +388,10 @@ type AdjustCdbProxyRequestParams struct { type AdjustCdbProxyRequest struct { *tchttp.BaseRequest - // 实例ID + // 实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` - // 代理组ID + // 代理组 ID。可通过 [DescribeCdbProxyInfo](https://cloud.tencent.com/document/api/236/90585) 接口获取。 ProxyGroupId *string `json:"ProxyGroupId,omitnil,omitempty" name:"ProxyGroupId"` // 节点规格配置 @@ -414,7 +437,6 @@ func (r *AdjustCdbProxyRequest) FromJsonString(s string) error { // Predefined struct for user type AdjustCdbProxyResponseParams struct { // 异步任务ID - // 注意:此字段可能返回 null,表示取不到有效值。 AsyncRequestId *string `json:"AsyncRequestId,omitnil,omitempty" name:"AsyncRequestId"` // 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 @@ -448,9 +470,35 @@ type AggregationCondition struct { Limit *uint64 `json:"Limit,omitnil,omitempty" name:"Limit"` } +type AnalysisNodeInfo struct { + // 节点ID + NodeId *string `json:"NodeId,omitnil,omitempty" name:"NodeId"` + + // 节点状态 + Status *string `json:"Status,omitnil,omitempty" name:"Status"` + + // 数据加载状态 + DataStatus *string `json:"DataStatus,omitnil,omitempty" name:"DataStatus"` + + // cpu核数,单位:核 + Cpu *uint64 `json:"Cpu,omitnil,omitempty" name:"Cpu"` + + // 内存大小,单位: MB + Memory *uint64 `json:"Memory,omitnil,omitempty" name:"Memory"` + + // 磁盘大小,单位:GB + Storage *uint64 `json:"Storage,omitnil,omitempty" name:"Storage"` + + // 节点所在可用区 + Zone *string `json:"Zone,omitnil,omitempty" name:"Zone"` + + // 数据同步错误信息 + Message *string `json:"Message,omitnil,omitempty" name:"Message"` +} + // Predefined struct for user type AnalyzeAuditLogsRequestParams struct { - // 实例ID。 + // 实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` // 要分析的日志开始时间,格式为:"2023-02-16 00:00:20"。 @@ -462,7 +510,9 @@ type AnalyzeAuditLogsRequestParams struct { // 聚合维度的排序条件。 AggregationConditions []*AggregationCondition `json:"AggregationConditions,omitnil,omitempty" name:"AggregationConditions"` - // 已废弃。该过滤条件下的审计日志结果集作为分析日志。 + // 已废弃。 + // + // Deprecated: AuditLogFilter is deprecated. AuditLogFilter *AuditLogFilter `json:"AuditLogFilter,omitnil,omitempty" name:"AuditLogFilter"` // 该过滤条件下的审计日志结果集作为分析日志。 @@ -472,7 +522,7 @@ type AnalyzeAuditLogsRequestParams struct { type AnalyzeAuditLogsRequest struct { *tchttp.BaseRequest - // 实例ID。 + // 实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` // 要分析的日志开始时间,格式为:"2023-02-16 00:00:20"。 @@ -484,7 +534,7 @@ type AnalyzeAuditLogsRequest struct { // 聚合维度的排序条件。 AggregationConditions []*AggregationCondition `json:"AggregationConditions,omitnil,omitempty" name:"AggregationConditions"` - // 已废弃。该过滤条件下的审计日志结果集作为分析日志。 + // 已废弃。 AuditLogFilter *AuditLogFilter `json:"AuditLogFilter,omitnil,omitempty" name:"AuditLogFilter"` // 该过滤条件下的审计日志结果集作为分析日志。 @@ -518,11 +568,9 @@ func (r *AnalyzeAuditLogsRequest) FromJsonString(s string) error { // Predefined struct for user type AnalyzeAuditLogsResponseParams struct { // 返回的聚合桶信息集 - // 注意:此字段可能返回 null,表示取不到有效值。 Items []*AuditLogAggregationResult `json:"Items,omitnil,omitempty" name:"Items"` // 扫描的日志条数 - // 注意:此字段可能返回 null,表示取不到有效值。 TotalCount *int64 `json:"TotalCount,omitnil,omitempty" name:"TotalCount"` // 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 @@ -547,10 +595,10 @@ func (r *AnalyzeAuditLogsResponse) FromJsonString(s string) error { // Predefined struct for user type AssociateSecurityGroupsRequestParams struct { - // 安全组 ID。 + // 安全组 ID。可通过 [DescribeDBSecurityGroups](https://cloud.tencent.com/document/api/236/15854) 接口获取。 SecurityGroupId *string `json:"SecurityGroupId,omitnil,omitempty" name:"SecurityGroupId"` - // 实例 ID 列表,一个或者多个实例 ID 组成的数组。 + // 实例 ID 列表,一个或者多个实例 ID 组成的数组。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 InstanceIds []*string `json:"InstanceIds,omitnil,omitempty" name:"InstanceIds"` // 当传入只读实例ID时,默认操作的是对应只读组的安全组。如果需要操作只读实例ID的安全组, 需要将该入参置为True @@ -560,10 +608,10 @@ type AssociateSecurityGroupsRequestParams struct { type AssociateSecurityGroupsRequest struct { *tchttp.BaseRequest - // 安全组 ID。 + // 安全组 ID。可通过 [DescribeDBSecurityGroups](https://cloud.tencent.com/document/api/236/15854) 接口获取。 SecurityGroupId *string `json:"SecurityGroupId,omitnil,omitempty" name:"SecurityGroupId"` - // 实例 ID 列表,一个或者多个实例 ID 组成的数组。 + // 实例 ID 列表,一个或者多个实例 ID 组成的数组。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 InstanceIds []*string `json:"InstanceIds,omitnil,omitempty" name:"InstanceIds"` // 当传入只读实例ID时,默认操作的是对应只读组的安全组。如果需要操作只读实例ID的安全组, 需要将该入参置为True @@ -644,19 +692,15 @@ type AuditInstanceFilters struct { type AuditInstanceInfo struct { // 项目ID - // 注意:此字段可能返回 null,表示取不到有效值。 ProjectId *int64 `json:"ProjectId,omitnil,omitempty" name:"ProjectId"` // 标签信息 - // 注意:此字段可能返回 null,表示取不到有效值。 TagList []*TagInfoUnit `json:"TagList,omitnil,omitempty" name:"TagList"` // 数据库内核类型 - // 注意:此字段可能返回 null,表示取不到有效值。 DbType *string `json:"DbType,omitnil,omitempty" name:"DbType"` // 数据库内核版本 - // 注意:此字段可能返回 null,表示取不到有效值。 DbVersion *string `json:"DbVersion,omitnil,omitempty" name:"DbVersion"` } @@ -698,41 +742,35 @@ type AuditLog struct { ThreadId *int64 `json:"ThreadId,omitnil,omitempty" name:"ThreadId"` // 扫描行数。 - // 注意:此字段可能返回 null,表示取不到有效值。 CheckRows *int64 `json:"CheckRows,omitnil,omitempty" name:"CheckRows"` // cpu执行时间,微秒。 - // 注意:此字段可能返回 null,表示取不到有效值。 CpuTime *float64 `json:"CpuTime,omitnil,omitempty" name:"CpuTime"` // IO等待时间,微秒。 - // 注意:此字段可能返回 null,表示取不到有效值。 IoWaitTime *uint64 `json:"IoWaitTime,omitnil,omitempty" name:"IoWaitTime"` // 锁等待时间,微秒。 - // 注意:此字段可能返回 null,表示取不到有效值。 LockWaitTime *uint64 `json:"LockWaitTime,omitnil,omitempty" name:"LockWaitTime"` // 开始时间,与timestamp构成一个精确到纳秒的时间。 - // 注意:此字段可能返回 null,表示取不到有效值。 NsTime *uint64 `json:"NsTime,omitnil,omitempty" name:"NsTime"` // 事物持续时间,微秒。 - // 注意:此字段可能返回 null,表示取不到有效值。 TrxLivingTime *uint64 `json:"TrxLivingTime,omitnil,omitempty" name:"TrxLivingTime"` // 日志命中规则模板的基本信息 - // 注意:此字段可能返回 null,表示取不到有效值。 TemplateInfo []*LogRuleTemplateInfo `json:"TemplateInfo,omitnil,omitempty" name:"TemplateInfo"` + + // 事务ID + TrxId *int64 `json:"TrxId,omitnil,omitempty" name:"TrxId"` } type AuditLogAggregationResult struct { // 聚合维度 - // 注意:此字段可能返回 null,表示取不到有效值。 AggregationField *string `json:"AggregationField,omitnil,omitempty" name:"AggregationField"` // 聚合桶的结果集 - // 注意:此字段可能返回 null,表示取不到有效值。 Buckets []*Bucket `json:"Buckets,omitnil,omitempty" name:"Buckets"` } @@ -750,15 +788,12 @@ type AuditLogFile struct { Status *string `json:"Status,omitnil,omitempty" name:"Status"` // 文件大小,单位为 KB。 - // 注意:此字段可能返回 null,表示取不到有效值。 FileSize *int64 `json:"FileSize,omitnil,omitempty" name:"FileSize"` // 审计日志下载地址。 - // 注意:此字段可能返回 null,表示取不到有效值。 DownloadUrl *string `json:"DownloadUrl,omitnil,omitempty" name:"DownloadUrl"` // 错误信息。 - // 注意:此字段可能返回 null,表示取不到有效值。 ErrMsg *string `json:"ErrMsg,omitnil,omitempty" name:"ErrMsg"` } @@ -851,11 +886,9 @@ type AuditPolicy struct { RuleId *string `json:"RuleId,omitnil,omitempty" name:"RuleId"` // 审计规则名称。 - // 注意:此字段可能返回 null,表示取不到有效值。 RuleName *string `json:"RuleName,omitnil,omitempty" name:"RuleName"` // 数据库实例名称 - // 注意:此字段可能返回 null,表示取不到有效值。 InstanceName *string `json:"InstanceName,omitnil,omitempty" name:"InstanceName"` } @@ -887,7 +920,6 @@ type AuditRule struct { type AuditRuleFilters struct { // 单条审计规则。 - // 注意:此字段可能返回 null,表示取不到有效值。 RuleFilters []*RuleFilters `json:"RuleFilters,omitnil,omitempty" name:"RuleFilters"` } @@ -902,45 +934,51 @@ type AuditRuleTemplateInfo struct { RuleFilters []*RuleFilters `json:"RuleFilters,omitnil,omitempty" name:"RuleFilters"` // 规则模板描述。 - // 注意:此字段可能返回 null,表示取不到有效值。 Description *string `json:"Description,omitnil,omitempty" name:"Description"` // 规则模板创建时间。 CreateAt *string `json:"CreateAt,omitnil,omitempty" name:"CreateAt"` // 告警等级。1-低风险,2-中风险,3-高风险。 - // 注意:此字段可能返回 null,表示取不到有效值。 AlarmLevel *uint64 `json:"AlarmLevel,omitnil,omitempty" name:"AlarmLevel"` // 告警策略。0-不告警,1-告警。 - // 注意:此字段可能返回 null,表示取不到有效值。 AlarmPolicy *uint64 `json:"AlarmPolicy,omitnil,omitempty" name:"AlarmPolicy"` // 规则模板应用在哪些在实例。 - // 注意:此字段可能返回 null,表示取不到有效值。 AffectedInstances []*string `json:"AffectedInstances,omitnil,omitempty" name:"AffectedInstances"` // 模板状态。0-无任务 ,1-修改中。 - // 注意:此字段可能返回 null,表示取不到有效值。 Status *uint64 `json:"Status,omitnil,omitempty" name:"Status"` // 模板更新时间。 - // 注意:此字段可能返回 null,表示取不到有效值。 UpdateAt *string `json:"UpdateAt,omitnil,omitempty" name:"UpdateAt"` } type AutoStrategy struct { - // 自动扩容阈值,可选值70、80、90,代表CPU利用率达到70%、80%、90%时后台进行自动扩容 + // 自动扩容阈值,可选值40、50、60、70、80、90,代表 CPU 利用率达到40%、50%、60%、70%、80%、90%时后台进行自动扩容。 ExpandThreshold *int64 `json:"ExpandThreshold,omitnil,omitempty" name:"ExpandThreshold"` - // 自动扩容观测周期,单位是分钟,可选值1、3、5、10、15、30。后台会按照配置的周期进行扩容判断。 - ExpandPeriod *int64 `json:"ExpandPeriod,omitnil,omitempty" name:"ExpandPeriod"` - // 自动缩容阈值,可选值10、20、30,代表CPU利用率达到10%、20%、30%时后台进行自动缩容 ShrinkThreshold *int64 `json:"ShrinkThreshold,omitnil,omitempty" name:"ShrinkThreshold"` + // 自动扩容观测周期,单位是分钟,可选值1、3、5、10、15、30。后台会按照配置的周期进行扩容判断。 + // 注意:此字段可能返回 null,表示取不到有效值。 + // + // Deprecated: ExpandPeriod is deprecated. + ExpandPeriod *int64 `json:"ExpandPeriod,omitnil,omitempty" name:"ExpandPeriod"` + // 自动缩容观测周期,单位是分钟,可选值5、10、15、30。后台会按照配置的周期进行缩容判断。 + // 注意:此字段可能返回 null,表示取不到有效值。 + // + // Deprecated: ShrinkPeriod is deprecated. ShrinkPeriod *int64 `json:"ShrinkPeriod,omitnil,omitempty" name:"ShrinkPeriod"` + + // 弹性扩容观测周期(秒级),可取值为:15,30,45,60,180,300,600,900,1800。 + ExpandSecondPeriod *int64 `json:"ExpandSecondPeriod,omitnil,omitempty" name:"ExpandSecondPeriod"` + + // 缩容观测周期(秒级),可取值为:300、600、900、1800。 + ShrinkSecondPeriod *int64 `json:"ShrinkSecondPeriod,omitnil,omitempty" name:"ShrinkSecondPeriod"` } type BackupConfig struct { @@ -1009,19 +1047,20 @@ type BackupInfo struct { // 异地备份详细信息 RemoteInfo []*RemoteBackupInfo `json:"RemoteInfo,omitnil,omitempty" name:"RemoteInfo"` - // 存储方式,0-常规存储,1-归档存储,默认为0 + // 存储方式,0-常规存储,1-归档存储,2-标准存储,默认为0 CosStorageType *int64 `json:"CosStorageType,omitnil,omitempty" name:"CosStorageType"` // 实例 ID,格式如:cdb-c1nl9rpv。与云数据库控制台页面中显示的实例 ID 相同。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` // 备份文件是否加密, on-加密, off-未加密 - // 注意:此字段可能返回 null,表示取不到有效值。 EncryptionFlag *string `json:"EncryptionFlag,omitnil,omitempty" name:"EncryptionFlag"` // 备份GTID点位 - // 注意:此字段可能返回 null,表示取不到有效值。 ExecutedGTIDSet *string `json:"ExecutedGTIDSet,omitnil,omitempty" name:"ExecutedGTIDSet"` + + // 备份文件MD5值 + MD5 *string `json:"MD5,omitnil,omitempty" name:"MD5"` } type BackupItem struct { @@ -1074,14 +1113,14 @@ type BackupSummaryItem struct { // Predefined struct for user type BalanceRoGroupLoadRequestParams struct { - // RO 组的 ID,格式如:cdbrg-c1nl9rpv。 + // RO 组的 ID,格式如:cdbrg-c1nl9rpv。可通过 [DescribeRoGroups](https://cloud.tencent.com/document/api/236/40939) 获取。 RoGroupId *string `json:"RoGroupId,omitnil,omitempty" name:"RoGroupId"` } type BalanceRoGroupLoadRequest struct { *tchttp.BaseRequest - // RO 组的 ID,格式如:cdbrg-c1nl9rpv。 + // RO 组的 ID,格式如:cdbrg-c1nl9rpv。可通过 [DescribeRoGroups](https://cloud.tencent.com/document/api/236/40939) 获取。 RoGroupId *string `json:"RoGroupId,omitnil,omitempty" name:"RoGroupId"` } @@ -1137,9 +1176,11 @@ type BinlogInfo struct { Date *string `json:"Date,omitnil,omitempty" name:"Date"` // 下载地址 + // 说明:此下载地址和参数 InternetUrl 的下载地址一样。 IntranetUrl *string `json:"IntranetUrl,omitnil,omitempty" name:"IntranetUrl"` // 下载地址 + // 说明:此下载地址和参数 IntranetUrl 的下载地址一样。 InternetUrl *string `json:"InternetUrl,omitnil,omitempty" name:"InternetUrl"` // 日志具体类型,可能的值有:binlog - 二进制日志 @@ -1160,16 +1201,17 @@ type BinlogInfo struct { // binlog异地备份详细信息 RemoteInfo []*RemoteBackupInfo `json:"RemoteInfo,omitnil,omitempty" name:"RemoteInfo"` - // 存储方式,0-常规存储,1-归档存储,默认为0 + // 存储方式,0-常规存储,1-归档存储,2-标准存储,默认为0 CosStorageType *int64 `json:"CosStorageType,omitnil,omitempty" name:"CosStorageType"` // 实例 ID,格式如:cdb-c1nl9rpv。与云数据库控制台页面中显示的实例 ID 相同。 + // + // Deprecated: InstanceId is deprecated. InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` } type Bucket struct { // 无 - // 注意:此字段可能返回 null,表示取不到有效值。 Key *string `json:"Key,omitnil,omitempty" name:"Key"` // key值出现的次数。 @@ -1219,7 +1261,6 @@ type CdbSellConfig struct { Status *int64 `json:"Status,omitnil,omitempty" name:"Status"` // 实例类型,可能的取值范围有:UNIVERSAL (通用型), EXCLUSIVE (独享型), BASIC (基础型), BASIC_V2 (基础型v2) - // 注意:此字段可能返回 null,表示取不到有效值。 DeviceType *string `json:"DeviceType,omitnil,omitempty" name:"DeviceType"` // 引擎类型描述,可能的取值范围有:Innodb,RocksDB @@ -1314,16 +1355,67 @@ type CdbZoneSellConf struct { // 可支持的售卖数据库引擎类型 EngineType []*string `json:"EngineType,omitnil,omitempty" name:"EngineType"` + + // 集群版实例在当前可用区的售卖状态。可能的返回值为:1-上线;3-停售;4-不展示 + CloudNativeClusterStatus *int64 `json:"CloudNativeClusterStatus,omitnil,omitempty" name:"CloudNativeClusterStatus"` + + // 集群版或者单节点基础型支持的磁盘类型。 + DiskTypeConf []*DiskTypeConfigItem `json:"DiskTypeConf,omitnil,omitempty" name:"DiskTypeConf"` } // Predefined struct for user type CheckMigrateClusterRequestParams struct { + // 实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 + InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` + + // 实例 CPU 核数。当 InstanceId 为主实例时必传。 + Cpu *int64 `json:"Cpu,omitnil,omitempty" name:"Cpu"` + // 实例内存大小,单位:MB。当 InstanceId 为主实例时必传。 + Memory *int64 `json:"Memory,omitnil,omitempty" name:"Memory"` + + // 实例硬盘大小,单位:GB。 + Volume *int64 `json:"Volume,omitnil,omitempty" name:"Volume"` + + // 磁盘类型。 CLOUD_SSD: SSD 云硬盘; CLOUD_HSSD: 增强型 SSD 云硬盘。 + DiskType *string `json:"DiskType,omitnil,omitempty" name:"DiskType"` + + // 云盘版节点拓扑配置。当 InstanceId 为主实例时必传。 + ClusterTopology *ClusterTopology `json:"ClusterTopology,omitnil,omitempty" name:"ClusterTopology"` + + // 迁移实例类型。支持值包括: "CLOUD_NATIVE_CLUSTER" - 标准型云盘版实例, "CLOUD_NATIVE_CLUSTER_EXCLUSIVE" - 加强型云盘版实例。 + DeviceType *string `json:"DeviceType,omitnil,omitempty" name:"DeviceType"` + + // 只读实例信息。 + RoInfo []*MigrateClusterRoInfo `json:"RoInfo,omitnil,omitempty" name:"RoInfo"` } type CheckMigrateClusterRequest struct { *tchttp.BaseRequest + // 实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 + InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` + + // 实例 CPU 核数。当 InstanceId 为主实例时必传。 + Cpu *int64 `json:"Cpu,omitnil,omitempty" name:"Cpu"` + + // 实例内存大小,单位:MB。当 InstanceId 为主实例时必传。 + Memory *int64 `json:"Memory,omitnil,omitempty" name:"Memory"` + + // 实例硬盘大小,单位:GB。 + Volume *int64 `json:"Volume,omitnil,omitempty" name:"Volume"` + + // 磁盘类型。 CLOUD_SSD: SSD 云硬盘; CLOUD_HSSD: 增强型 SSD 云硬盘。 + DiskType *string `json:"DiskType,omitnil,omitempty" name:"DiskType"` + + // 云盘版节点拓扑配置。当 InstanceId 为主实例时必传。 + ClusterTopology *ClusterTopology `json:"ClusterTopology,omitnil,omitempty" name:"ClusterTopology"` + + // 迁移实例类型。支持值包括: "CLOUD_NATIVE_CLUSTER" - 标准型云盘版实例, "CLOUD_NATIVE_CLUSTER_EXCLUSIVE" - 加强型云盘版实例。 + DeviceType *string `json:"DeviceType,omitnil,omitempty" name:"DeviceType"` + + // 只读实例信息。 + RoInfo []*MigrateClusterRoInfo `json:"RoInfo,omitnil,omitempty" name:"RoInfo"` } func (r *CheckMigrateClusterRequest) ToJsonString() string { @@ -1338,7 +1430,14 @@ func (r *CheckMigrateClusterRequest) FromJsonString(s string) error { if err := json.Unmarshal([]byte(s), &f); err != nil { return err } - + delete(f, "InstanceId") + delete(f, "Cpu") + delete(f, "Memory") + delete(f, "Volume") + delete(f, "DiskType") + delete(f, "ClusterTopology") + delete(f, "DeviceType") + delete(f, "RoInfo") if len(f) > 0 { return tcerr.NewTencentCloudSDKError("ClientError.BuildRequestError", "CheckMigrateClusterRequest has unknown keys!", "") } @@ -1347,6 +1446,12 @@ func (r *CheckMigrateClusterRequest) FromJsonString(s string) error { // Predefined struct for user type CheckMigrateClusterResponseParams struct { + // 校验是否通过,通过为pass,失败为fail + CheckResult *string `json:"CheckResult,omitnil,omitempty" name:"CheckResult"` + + // 校验项 + Items []*CheckMigrateResult `json:"Items,omitnil,omitempty" name:"Items"` + // 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 RequestId *string `json:"RequestId,omitnil,omitempty" name:"RequestId"` } @@ -1367,6 +1472,17 @@ func (r *CheckMigrateClusterResponse) FromJsonString(s string) error { return json.Unmarshal([]byte(s), &r) } +type CheckMigrateResult struct { + // 校验名称 + Name *string `json:"Name,omitnil,omitempty" name:"Name"` + + // 校验结果,通过为pass,失败为fail + Status *string `json:"Status,omitnil,omitempty" name:"Status"` + + // 校验结果描述 + Desc *string `json:"Desc,omitnil,omitempty" name:"Desc"` +} + type CloneItem struct { // 克隆任务的源实例Id。 SrcInstanceId *string `json:"SrcInstanceId,omitnil,omitempty" name:"SrcInstanceId"` @@ -1401,14 +1517,14 @@ type CloneItem struct { // Predefined struct for user type CloseAuditServiceRequestParams struct { - // 实例ID。 + // 实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` } type CloseAuditServiceRequest struct { *tchttp.BaseRequest - // 实例ID。 + // 实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` } @@ -1455,10 +1571,10 @@ func (r *CloseAuditServiceResponse) FromJsonString(s string) error { // Predefined struct for user type CloseCDBProxyRequestParams struct { - // 实例ID + // 实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` - // 代理组ID + // 代理组 ID。可通过 [DescribeCdbProxyInfo](https://cloud.tencent.com/document/api/236/90585) 接口获取。 ProxyGroupId *string `json:"ProxyGroupId,omitnil,omitempty" name:"ProxyGroupId"` // 是否只关闭读写分离,取值:"true" | "false",默认为"false" @@ -1468,10 +1584,10 @@ type CloseCDBProxyRequestParams struct { type CloseCDBProxyRequest struct { *tchttp.BaseRequest - // 实例ID + // 实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` - // 代理组ID + // 代理组 ID。可通过 [DescribeCdbProxyInfo](https://cloud.tencent.com/document/api/236/90585) 接口获取。 ProxyGroupId *string `json:"ProxyGroupId,omitnil,omitempty" name:"ProxyGroupId"` // 是否只关闭读写分离,取值:"true" | "false",默认为"false" @@ -1523,20 +1639,20 @@ func (r *CloseCDBProxyResponse) FromJsonString(s string) error { // Predefined struct for user type CloseCdbProxyAddressRequestParams struct { - // 代理组ID + // 代理组 ID。可通过 [DescribeCdbProxyInfo](https://cloud.tencent.com/document/api/236/90585) 接口获取。 ProxyGroupId *string `json:"ProxyGroupId,omitnil,omitempty" name:"ProxyGroupId"` - // 代理组地址ID + // 代理组地址 ID。可通过 [DescribeCdbProxyInfo](https://cloud.tencent.com/document/api/236/90585) 接口获取。 ProxyAddressId *string `json:"ProxyAddressId,omitnil,omitempty" name:"ProxyAddressId"` } type CloseCdbProxyAddressRequest struct { *tchttp.BaseRequest - // 代理组ID + // 代理组 ID。可通过 [DescribeCdbProxyInfo](https://cloud.tencent.com/document/api/236/90585) 接口获取。 ProxyGroupId *string `json:"ProxyGroupId,omitnil,omitempty" name:"ProxyGroupId"` - // 代理组地址ID + // 代理组地址 ID。可通过 [DescribeCdbProxyInfo](https://cloud.tencent.com/document/api/236/90585) 接口获取。 ProxyAddressId *string `json:"ProxyAddressId,omitnil,omitempty" name:"ProxyAddressId"` } @@ -1584,20 +1700,20 @@ func (r *CloseCdbProxyAddressResponse) FromJsonString(s string) error { // Predefined struct for user type CloseSSLRequestParams struct { - // 实例 ID 。只读组 ID为空时必填。 + // 实例 ID。只读组 ID 为空时必填。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` - // 只读组 ID。实例 ID为空时必填。 + // 只读组 ID。实例 ID 为空时必填。可通过 [DescribeRoGroups](https://cloud.tencent.com/document/api/236/40939) 接口获取。 RoGroupId *string `json:"RoGroupId,omitnil,omitempty" name:"RoGroupId"` } type CloseSSLRequest struct { *tchttp.BaseRequest - // 实例 ID 。只读组 ID为空时必填。 + // 实例 ID。只读组 ID 为空时必填。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` - // 只读组 ID。实例 ID为空时必填。 + // 只读组 ID。实例 ID 为空时必填。可通过 [DescribeRoGroups](https://cloud.tencent.com/document/api/236/40939) 接口获取。 RoGroupId *string `json:"RoGroupId,omitnil,omitempty" name:"RoGroupId"` } @@ -1648,15 +1764,21 @@ func (r *CloseSSLResponse) FromJsonString(s string) error { // Predefined struct for user type CloseWanServiceRequestParams struct { - // 实例 ID,格式如:cdb-c1nl9rpv,与云数据库控制台页面中显示的实例 ID 相同,可使用 [查询实例列表](https://cloud.tencent.com/document/api/236/15872) 接口获取,其值为输出参数中字段 InstanceId 的值。 + // 实例 ID,格式如:cdb-c1nl9rpv,与云数据库控制台页面中显示的实例 ID 相同,可使用 [查询实例列表](https://cloud.tencent.com/document/api/236/15872) 接口获取,其值为输出参数中字段 InstanceId 的值。可传入只读组 ID 关闭只读组外网访问。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` + + // 变更云盘版实例只读组时,InstanceId 传实例 ID,需要额外指定该参数表示操作只读组。如果操作读写节点则不需指定该参数。 + OpResourceId *string `json:"OpResourceId,omitnil,omitempty" name:"OpResourceId"` } type CloseWanServiceRequest struct { *tchttp.BaseRequest - // 实例 ID,格式如:cdb-c1nl9rpv,与云数据库控制台页面中显示的实例 ID 相同,可使用 [查询实例列表](https://cloud.tencent.com/document/api/236/15872) 接口获取,其值为输出参数中字段 InstanceId 的值。 + // 实例 ID,格式如:cdb-c1nl9rpv,与云数据库控制台页面中显示的实例 ID 相同,可使用 [查询实例列表](https://cloud.tencent.com/document/api/236/15872) 接口获取,其值为输出参数中字段 InstanceId 的值。可传入只读组 ID 关闭只读组外网访问。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` + + // 变更云盘版实例只读组时,InstanceId 传实例 ID,需要额外指定该参数表示操作只读组。如果操作读写节点则不需指定该参数。 + OpResourceId *string `json:"OpResourceId,omitnil,omitempty" name:"OpResourceId"` } func (r *CloseWanServiceRequest) ToJsonString() string { @@ -1672,6 +1794,7 @@ func (r *CloseWanServiceRequest) FromJsonString(s string) error { return err } delete(f, "InstanceId") + delete(f, "OpResourceId") if len(f) > 0 { return tcerr.NewTencentCloudSDKError("ClientError.BuildRequestError", "CloseWanServiceRequest has unknown keys!", "") } @@ -1703,6 +1826,17 @@ func (r *CloseWanServiceResponse) FromJsonString(s string) error { return json.Unmarshal([]byte(s), &r) } +type ClusterInfo struct { + // 节点id + NodeId *string `json:"NodeId,omitnil,omitempty" name:"NodeId"` + + // 节点类型:主节点,从节点 + Role *string `json:"Role,omitnil,omitempty" name:"Role"` + + // 地域 + Zone *string `json:"Zone,omitnil,omitempty" name:"Zone"` +} + type ClusterNodeInfo struct { // 节点id。 NodeId *string `json:"NodeId,omitnil,omitempty" name:"NodeId"` @@ -1717,10 +1851,19 @@ type ClusterNodeInfo struct { Weight *uint64 `json:"Weight,omitnil,omitempty" name:"Weight"` // 节点状态。 - // 注意:此字段可能返回 null,表示取不到有效值。 Status *string `json:"Status,omitnil,omitempty" name:"Status"` } +type ClusterTopology struct { + // RW 节点拓扑。 + // 说明:NodeId 可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 获取。 + ReadWriteNode *ReadWriteNode `json:"ReadWriteNode,omitnil,omitempty" name:"ReadWriteNode"` + + // RO 节点拓扑。 + // 说明:NodeId 可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 获取。 + ReadOnlyNodes []*ReadonlyNode `json:"ReadOnlyNodes,omitnil,omitempty" name:"ReadOnlyNodes"` +} + type ColumnPrivilege struct { // 数据库名 Database *string `json:"Database,omitnil,omitempty" name:"Database"` @@ -1776,9 +1919,13 @@ type CreateAccountsRequestParams struct { Accounts []*Account `json:"Accounts,omitnil,omitempty" name:"Accounts"` // 新账户的密码。 + // 说明: + // 1. 在8 ~ 64位字符数以内(推荐12位以上)。 + // 2. 至少包含其中两项:小写字母 a ~ z 或 大写字母 A ~ Z。数字0 ~ 9。_+-,&=!@#$%^*().|。 + // 3. 不能包含非法字符。 Password *string `json:"Password,omitnil,omitempty" name:"Password"` - // 备注信息。 + // 备注信息。最多支持输入255个字符。 Description *string `json:"Description,omitnil,omitempty" name:"Description"` // 新账户最大可用连接数,默认值为10240,最大可设置值为10240。 @@ -1795,9 +1942,13 @@ type CreateAccountsRequest struct { Accounts []*Account `json:"Accounts,omitnil,omitempty" name:"Accounts"` // 新账户的密码。 + // 说明: + // 1. 在8 ~ 64位字符数以内(推荐12位以上)。 + // 2. 至少包含其中两项:小写字母 a ~ z 或 大写字母 A ~ Z。数字0 ~ 9。_+-,&=!@#$%^*().|。 + // 3. 不能包含非法字符。 Password *string `json:"Password,omitnil,omitempty" name:"Password"` - // 备注信息。 + // 备注信息。最多支持输入255个字符。 Description *string `json:"Description,omitnil,omitempty" name:"Description"` // 新账户最大可用连接数,默认值为10240,最大可设置值为10240。 @@ -1854,50 +2005,49 @@ func (r *CreateAccountsResponse) FromJsonString(s string) error { // Predefined struct for user type CreateAuditLogFileRequestParams struct { - // 实例 ID,与云数据库控制台页面中显示的实例 ID 相同。 + // 实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` - // 开始时间。 + // 开始时间(建议开始到结束时间区间最大7天)。 StartTime *string `json:"StartTime,omitnil,omitempty" name:"StartTime"` - // 结束时间。 + // 结束时间(建议开始到结束时间区间最大7天)。 EndTime *string `json:"EndTime,omitnil,omitempty" name:"EndTime"` - // 排序方式。支持值包括:"ASC" - 升序,"DESC" - 降序。 + // 排序方式。支持值包括:"ASC" - 升序,"DESC" - 降序,默认降序排序。 Order *string `json:"Order,omitnil,omitempty" name:"Order"` - // 排序字段。支持值包括: - // "timestamp" - 时间戳; - // "affectRows" - 影响行数; - // "execTime" - 执行时间。 + // 排序字段。支持值包括(默认按照时间戳排序): "timestamp" - 时间戳; "affectRows" - 影响行数; "execTime" - 执行时间。 OrderBy *string `json:"OrderBy,omitnil,omitempty" name:"OrderBy"` // 已废弃。 + // + // Deprecated: Filter is deprecated. Filter *AuditLogFilter `json:"Filter,omitnil,omitempty" name:"Filter"` // 过滤条件。可按设置的过滤条件过滤日志。 LogFilter []*InstanceAuditLogFilters `json:"LogFilter,omitnil,omitempty" name:"LogFilter"` + + // 下载筛选列 + ColumnFilter []*string `json:"ColumnFilter,omitnil,omitempty" name:"ColumnFilter"` } type CreateAuditLogFileRequest struct { *tchttp.BaseRequest - // 实例 ID,与云数据库控制台页面中显示的实例 ID 相同。 + // 实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` - // 开始时间。 + // 开始时间(建议开始到结束时间区间最大7天)。 StartTime *string `json:"StartTime,omitnil,omitempty" name:"StartTime"` - // 结束时间。 + // 结束时间(建议开始到结束时间区间最大7天)。 EndTime *string `json:"EndTime,omitnil,omitempty" name:"EndTime"` - // 排序方式。支持值包括:"ASC" - 升序,"DESC" - 降序。 + // 排序方式。支持值包括:"ASC" - 升序,"DESC" - 降序,默认降序排序。 Order *string `json:"Order,omitnil,omitempty" name:"Order"` - // 排序字段。支持值包括: - // "timestamp" - 时间戳; - // "affectRows" - 影响行数; - // "execTime" - 执行时间。 + // 排序字段。支持值包括(默认按照时间戳排序): "timestamp" - 时间戳; "affectRows" - 影响行数; "execTime" - 执行时间。 OrderBy *string `json:"OrderBy,omitnil,omitempty" name:"OrderBy"` // 已废弃。 @@ -1905,6 +2055,9 @@ type CreateAuditLogFileRequest struct { // 过滤条件。可按设置的过滤条件过滤日志。 LogFilter []*InstanceAuditLogFilters `json:"LogFilter,omitnil,omitempty" name:"LogFilter"` + + // 下载筛选列 + ColumnFilter []*string `json:"ColumnFilter,omitnil,omitempty" name:"ColumnFilter"` } func (r *CreateAuditLogFileRequest) ToJsonString() string { @@ -1926,6 +2079,7 @@ func (r *CreateAuditLogFileRequest) FromJsonString(s string) error { delete(f, "OrderBy") delete(f, "Filter") delete(f, "LogFilter") + delete(f, "ColumnFilter") if len(f) > 0 { return tcerr.NewTencentCloudSDKError("ClientError.BuildRequestError", "CreateAuditLogFileRequest has unknown keys!", "") } @@ -2129,38 +2283,38 @@ func (r *CreateAuditRuleResponse) FromJsonString(s string) error { // Predefined struct for user type CreateAuditRuleTemplateRequestParams struct { - // 审计规则 + // 审计规则。 RuleFilters []*RuleFilters `json:"RuleFilters,omitnil,omitempty" name:"RuleFilters"` - // 规则模板名称 + // 规则模板名称。最多支持输入30个字符。 RuleTemplateName *string `json:"RuleTemplateName,omitnil,omitempty" name:"RuleTemplateName"` - // 规则模板描述 + // 规则模板描述。最多支持输入200个字符。 Description *string `json:"Description,omitnil,omitempty" name:"Description"` - // 告警等级。1-低风险,2-中风险,3-高风险 + // 告警等级。1 - 低风险,2 - 中风险,3 - 高风险。默认值为1。 AlarmLevel *uint64 `json:"AlarmLevel,omitnil,omitempty" name:"AlarmLevel"` - // 告警策略。0-不告警,1-告警 + // 告警策略。0 - 不告警,1 - 告警。默认值为0。 AlarmPolicy *uint64 `json:"AlarmPolicy,omitnil,omitempty" name:"AlarmPolicy"` } type CreateAuditRuleTemplateRequest struct { *tchttp.BaseRequest - // 审计规则 + // 审计规则。 RuleFilters []*RuleFilters `json:"RuleFilters,omitnil,omitempty" name:"RuleFilters"` - // 规则模板名称 + // 规则模板名称。最多支持输入30个字符。 RuleTemplateName *string `json:"RuleTemplateName,omitnil,omitempty" name:"RuleTemplateName"` - // 规则模板描述 + // 规则模板描述。最多支持输入200个字符。 Description *string `json:"Description,omitnil,omitempty" name:"Description"` - // 告警等级。1-低风险,2-中风险,3-高风险 + // 告警等级。1 - 低风险,2 - 中风险,3 - 高风险。默认值为1。 AlarmLevel *uint64 `json:"AlarmLevel,omitnil,omitempty" name:"AlarmLevel"` - // 告警策略。0-不告警,1-告警 + // 告警策略。0 - 不告警,1 - 告警。默认值为0。 AlarmPolicy *uint64 `json:"AlarmPolicy,omitnil,omitempty" name:"AlarmPolicy"` } @@ -2190,7 +2344,6 @@ func (r *CreateAuditRuleTemplateRequest) FromJsonString(s string) error { // Predefined struct for user type CreateAuditRuleTemplateResponseParams struct { // 生成的规则模板ID。 - // 注意:此字段可能返回 null,表示取不到有效值。 RuleTemplateId *string `json:"RuleTemplateId,omitnil,omitempty" name:"RuleTemplateId"` // 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 @@ -2222,11 +2375,14 @@ type CreateBackupRequestParams struct { BackupMethod *string `json:"BackupMethod,omitnil,omitempty" name:"BackupMethod"` // 需要备份的库表信息,如果不设置该参数,则默认整实例备份。在 BackupMethod=logical 逻辑备份中才可设置该参数。指定的库表必须存在,否则可能导致备份失败。 - // 例:如果需要备份 db1 库的 tb1、tb2 表 和 db2 库。则该参数设置为 [{"Db": "db1", "Table": "tb1"}, {"Db": "db1", "Table": "tb2"}, {"Db": "db2"} ]。 + // 例:如果需要备份 db1 库的 tb1、tb2 表 和 db2 库。则该参数设置为 [{"Db": "db1", "Table": "tb1"}, {"Db": "db1", "Table": "tb2"}, {"Db": "db2"}]。 BackupDBTableList []*BackupItem `json:"BackupDBTableList,omitnil,omitempty" name:"BackupDBTableList"` - // 手动备份别名 + // 手动备份别名,输入长度请在60个字符内。 ManualBackupName *string `json:"ManualBackupName,omitnil,omitempty" name:"ManualBackupName"` + + // 是否需要加密物理备份,可选值为:on - 是,off - 否。当 BackupMethod 为 physical 时,该值才有意义。不指定则使用实例备份默认加密策略,这里的默认加密策略指通过 [DescribeBackupEncryptionStatus](https://cloud.tencent.com/document/product/236/86508) 接口查询出的实例当前加密策略。 + EncryptionFlag *string `json:"EncryptionFlag,omitnil,omitempty" name:"EncryptionFlag"` } type CreateBackupRequest struct { @@ -2239,11 +2395,14 @@ type CreateBackupRequest struct { BackupMethod *string `json:"BackupMethod,omitnil,omitempty" name:"BackupMethod"` // 需要备份的库表信息,如果不设置该参数,则默认整实例备份。在 BackupMethod=logical 逻辑备份中才可设置该参数。指定的库表必须存在,否则可能导致备份失败。 - // 例:如果需要备份 db1 库的 tb1、tb2 表 和 db2 库。则该参数设置为 [{"Db": "db1", "Table": "tb1"}, {"Db": "db1", "Table": "tb2"}, {"Db": "db2"} ]。 + // 例:如果需要备份 db1 库的 tb1、tb2 表 和 db2 库。则该参数设置为 [{"Db": "db1", "Table": "tb1"}, {"Db": "db1", "Table": "tb2"}, {"Db": "db2"}]。 BackupDBTableList []*BackupItem `json:"BackupDBTableList,omitnil,omitempty" name:"BackupDBTableList"` - // 手动备份别名 + // 手动备份别名,输入长度请在60个字符内。 ManualBackupName *string `json:"ManualBackupName,omitnil,omitempty" name:"ManualBackupName"` + + // 是否需要加密物理备份,可选值为:on - 是,off - 否。当 BackupMethod 为 physical 时,该值才有意义。不指定则使用实例备份默认加密策略,这里的默认加密策略指通过 [DescribeBackupEncryptionStatus](https://cloud.tencent.com/document/product/236/86508) 接口查询出的实例当前加密策略。 + EncryptionFlag *string `json:"EncryptionFlag,omitnil,omitempty" name:"EncryptionFlag"` } func (r *CreateBackupRequest) ToJsonString() string { @@ -2262,6 +2421,7 @@ func (r *CreateBackupRequest) FromJsonString(s string) error { delete(f, "BackupMethod") delete(f, "BackupDBTableList") delete(f, "ManualBackupName") + delete(f, "EncryptionFlag") if len(f) > 0 { return tcerr.NewTencentCloudSDKError("ClientError.BuildRequestError", "CreateBackupRequest has unknown keys!", "") } @@ -2295,7 +2455,7 @@ func (r *CreateBackupResponse) FromJsonString(s string) error { // Predefined struct for user type CreateCdbProxyAddressRequestParams struct { - // 代理组ID + // 代理组 ID。可通过 [DescribeCdbProxyInfo](https://cloud.tencent.com/document/api/236/90585) 接口获取。 ProxyGroupId *string `json:"ProxyGroupId,omitnil,omitempty" name:"ProxyGroupId"` // 权重分配模式, @@ -2308,7 +2468,7 @@ type CreateCdbProxyAddressRequestParams struct { // 最小保留数量,最小取值:0 MinCount *uint64 `json:"MinCount,omitnil,omitempty" name:"MinCount"` - // 延迟剔除阈值,最小取值:0 + // 延迟剔除阈值,最小取值:1,范围:1 - 10000,整数。 MaxDelay *uint64 `json:"MaxDelay,omitnil,omitempty" name:"MaxDelay"` // 是否开启故障转移,取值:"true" | "false" @@ -2326,42 +2486,42 @@ type CreateCdbProxyAddressRequestParams struct { // 读写权重分配 ProxyAllocation []*ProxyAllocation `json:"ProxyAllocation,omitnil,omitempty" name:"ProxyAllocation"` - // 私有网络ID + // 私有网络 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 UniqVpcId *string `json:"UniqVpcId,omitnil,omitempty" name:"UniqVpcId"` - // 私有子网ID + // 私有子网 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 UniqSubnetId *string `json:"UniqSubnetId,omitnil,omitempty" name:"UniqSubnetId"` - // 是否开启连接池 + // 是否开启连接池。默认关闭。 // 注意:如需使用数据库代理连接池能力,MySQL 8.0 主实例的内核小版本要大于等于 MySQL 8.0 20230630。 ConnectionPool *bool `json:"ConnectionPool,omitnil,omitempty" name:"ConnectionPool"` // 描述 Desc *string `json:"Desc,omitnil,omitempty" name:"Desc"` - // IP地址 + // IP 地址。不填则默认为所选 VPC 下支持的随机一个 IP。 Vip *string `json:"Vip,omitnil,omitempty" name:"Vip"` - // 端口 + // 端口。默认值3306。 VPort *uint64 `json:"VPort,omitnil,omitempty" name:"VPort"` // 安全组 SecurityGroup []*string `json:"SecurityGroup,omitnil,omitempty" name:"SecurityGroup"` - // 连接池类型。可选值 transaction(事务级别连接池),connection(会话级别连接池),ConnectionPool为true时生效。 + // 连接池类型。可选值 transaction(事务级别连接池),connection(会话级别连接池),ConnectionPool 为 true 时生效。默认值:connection。 ConnectionPoolType *string `json:"ConnectionPoolType,omitnil,omitempty" name:"ConnectionPoolType"` - // 是否自适应负载均衡 + // 是否开启自适应负载均衡。默认关闭。 AutoLoadBalance *bool `json:"AutoLoadBalance,omitnil,omitempty" name:"AutoLoadBalance"` - // 接入模式 + // 接入模式。nearBy - 就近访问,balance - 均衡分配,默认值:nearBy。 AccessMode *string `json:"AccessMode,omitnil,omitempty" name:"AccessMode"` } type CreateCdbProxyAddressRequest struct { *tchttp.BaseRequest - // 代理组ID + // 代理组 ID。可通过 [DescribeCdbProxyInfo](https://cloud.tencent.com/document/api/236/90585) 接口获取。 ProxyGroupId *string `json:"ProxyGroupId,omitnil,omitempty" name:"ProxyGroupId"` // 权重分配模式, @@ -2374,7 +2534,7 @@ type CreateCdbProxyAddressRequest struct { // 最小保留数量,最小取值:0 MinCount *uint64 `json:"MinCount,omitnil,omitempty" name:"MinCount"` - // 延迟剔除阈值,最小取值:0 + // 延迟剔除阈值,最小取值:1,范围:1 - 10000,整数。 MaxDelay *uint64 `json:"MaxDelay,omitnil,omitempty" name:"MaxDelay"` // 是否开启故障转移,取值:"true" | "false" @@ -2392,35 +2552,35 @@ type CreateCdbProxyAddressRequest struct { // 读写权重分配 ProxyAllocation []*ProxyAllocation `json:"ProxyAllocation,omitnil,omitempty" name:"ProxyAllocation"` - // 私有网络ID + // 私有网络 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 UniqVpcId *string `json:"UniqVpcId,omitnil,omitempty" name:"UniqVpcId"` - // 私有子网ID + // 私有子网 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 UniqSubnetId *string `json:"UniqSubnetId,omitnil,omitempty" name:"UniqSubnetId"` - // 是否开启连接池 + // 是否开启连接池。默认关闭。 // 注意:如需使用数据库代理连接池能力,MySQL 8.0 主实例的内核小版本要大于等于 MySQL 8.0 20230630。 ConnectionPool *bool `json:"ConnectionPool,omitnil,omitempty" name:"ConnectionPool"` // 描述 Desc *string `json:"Desc,omitnil,omitempty" name:"Desc"` - // IP地址 + // IP 地址。不填则默认为所选 VPC 下支持的随机一个 IP。 Vip *string `json:"Vip,omitnil,omitempty" name:"Vip"` - // 端口 + // 端口。默认值3306。 VPort *uint64 `json:"VPort,omitnil,omitempty" name:"VPort"` // 安全组 SecurityGroup []*string `json:"SecurityGroup,omitnil,omitempty" name:"SecurityGroup"` - // 连接池类型。可选值 transaction(事务级别连接池),connection(会话级别连接池),ConnectionPool为true时生效。 + // 连接池类型。可选值 transaction(事务级别连接池),connection(会话级别连接池),ConnectionPool 为 true 时生效。默认值:connection。 ConnectionPoolType *string `json:"ConnectionPoolType,omitnil,omitempty" name:"ConnectionPoolType"` - // 是否自适应负载均衡 + // 是否开启自适应负载均衡。默认关闭。 AutoLoadBalance *bool `json:"AutoLoadBalance,omitnil,omitempty" name:"AutoLoadBalance"` - // 接入模式 + // 接入模式。nearBy - 就近访问,balance - 均衡分配,默认值:nearBy。 AccessMode *string `json:"AccessMode,omitnil,omitempty" name:"AccessMode"` } @@ -2465,7 +2625,6 @@ func (r *CreateCdbProxyAddressRequest) FromJsonString(s string) error { // Predefined struct for user type CreateCdbProxyAddressResponseParams struct { // 异步任务ID - // 注意:此字段可能返回 null,表示取不到有效值。 AsyncRequestId *string `json:"AsyncRequestId,omitnil,omitempty" name:"AsyncRequestId"` // 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 @@ -2490,23 +2649,25 @@ func (r *CreateCdbProxyAddressResponse) FromJsonString(s string) error { // Predefined struct for user type CreateCdbProxyRequestParams struct { - // 实例ID + // 实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` - // 私有网络ID + // 私有网络 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 UniqVpcId *string `json:"UniqVpcId,omitnil,omitempty" name:"UniqVpcId"` - // 私有子网ID + // 私有子网 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 UniqSubnetId *string `json:"UniqSubnetId,omitnil,omitempty" name:"UniqSubnetId"` - // 节点规格配置 - // 备注:数据库代理支持的节点规格为:2C4000MB、4C8000MB、8C16000MB。 + // 节点规格配置。 // 示例中参数说明: // NodeCount:节点个数。 // Region:节点地域。 // Zone:节点可用区。 // Cpu:单个代理节点核数(单位:核)。 // Mem:单个代理节点内存数(单位:MB)。 + // 备注: + // 1. 数据库代理支持的节点规格为:2C4000MB、4C8000MB、8C16000MB。 + // 2. 上述参数项(如节点个数、可用区等)均为必填,在调用接口时如未填写完整,可能会创建失败。 ProxyNodeCustom []*ProxyNodeCustom `json:"ProxyNodeCustom,omitnil,omitempty" name:"ProxyNodeCustom"` // 安全组 @@ -2526,23 +2687,25 @@ type CreateCdbProxyRequestParams struct { type CreateCdbProxyRequest struct { *tchttp.BaseRequest - // 实例ID + // 实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` - // 私有网络ID + // 私有网络 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 UniqVpcId *string `json:"UniqVpcId,omitnil,omitempty" name:"UniqVpcId"` - // 私有子网ID + // 私有子网 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 UniqSubnetId *string `json:"UniqSubnetId,omitnil,omitempty" name:"UniqSubnetId"` - // 节点规格配置 - // 备注:数据库代理支持的节点规格为:2C4000MB、4C8000MB、8C16000MB。 + // 节点规格配置。 // 示例中参数说明: // NodeCount:节点个数。 // Region:节点地域。 // Zone:节点可用区。 // Cpu:单个代理节点核数(单位:核)。 // Mem:单个代理节点内存数(单位:MB)。 + // 备注: + // 1. 数据库代理支持的节点规格为:2C4000MB、4C8000MB、8C16000MB。 + // 2. 上述参数项(如节点个数、可用区等)均为必填,在调用接口时如未填写完整,可能会创建失败。 ProxyNodeCustom []*ProxyNodeCustom `json:"ProxyNodeCustom,omitnil,omitempty" name:"ProxyNodeCustom"` // 安全组 @@ -2588,7 +2751,6 @@ func (r *CreateCdbProxyRequest) FromJsonString(s string) error { // Predefined struct for user type CreateCdbProxyResponseParams struct { // 异步任务ID - // 注意:此字段可能返回 null,表示取不到有效值。 AsyncRequestId *string `json:"AsyncRequestId,omitnil,omitempty" name:"AsyncRequestId"` // 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 @@ -2613,16 +2775,18 @@ func (r *CreateCdbProxyResponse) FromJsonString(s string) error { // Predefined struct for user type CreateCloneInstanceRequestParams struct { - // 克隆源实例Id。 + // 克隆源实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/api/236/15872) 接口获取。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` - // 如果需要克隆实例回档到指定时间,则指定该值。时间格式为: yyyy-mm-dd hh:mm:ss 。 + // 如果需要克隆实例回档到指定时间,则指定该值。时间格式为:yyyy-mm-dd hh:mm:ss。 + // 说明:此参数和 SpecifiedBackupId 参数需要2选1进行设置。 SpecifiedRollbackTime *string `json:"SpecifiedRollbackTime,omitnil,omitempty" name:"SpecifiedRollbackTime"` - // 如果需要克隆实例回档到指定备份的时间点,则指定该值为物理备份的Id。请使用 [查询数据备份文件列表](/document/api/236/15842) 。 + // 如果需要克隆实例回档到指定备份集,则指定该值为备份文件的 Id。请使用 [查询数据备份文件列表](/document/api/236/15842)。 + // 说明:如果是克隆双节点、三节点实例,备份文件为物理备份,如果是克隆单节点、集群版实例,备份文件为快照备份。 SpecifiedBackupId *int64 `json:"SpecifiedBackupId,omitnil,omitempty" name:"SpecifiedBackupId"` - // 私有网络 ID,如果不传则默认选择基础网络,请使用 [查询私有网络列表](/document/api/215/15778) 。 + // 私有网络 ID,请使用 [查询私有网络列表](/document/api/215/15778)。 UniqVpcId *string `json:"UniqVpcId,omitnil,omitempty" name:"UniqVpcId"` // 私有网络下的子网 ID,如果设置了 UniqVpcId,则 UniqSubnetId 必填,请使用 [查询子网列表](/document/api/215/15784)。 @@ -2634,7 +2798,7 @@ type CreateCloneInstanceRequestParams struct { // 实例硬盘大小,单位:GB,需要不低于克隆源实例,默认和源实例相同。 Volume *int64 `json:"Volume,omitnil,omitempty" name:"Volume"` - // 新产生的克隆实例名称。 + // 新产生的克隆实例名称。支持输入最大60个字符。 InstanceName *string `json:"InstanceName,omitnil,omitempty" name:"InstanceName"` // 安全组参数,可使用 [查询项目安全组信息](https://cloud.tencent.com/document/api/236/15850) 接口查询某个项目的安全组详情。 @@ -2658,7 +2822,7 @@ type CreateCloneInstanceRequestParams struct { // 备库 2 的可用区信息,默认为空,克隆强同步主实例时可指定该参数。 BackupZone *string `json:"BackupZone,omitnil,omitempty" name:"BackupZone"` - // 克隆实例类型。支持值包括: "UNIVERSAL" - 通用型实例, "EXCLUSIVE" - 独享型实例。 不指定则默认为通用型。 + // 克隆实例类型。支持值包括:"UNIVERSAL" - 通用型实例,"EXCLUSIVE" - 独享型实例,"CLOUD_NATIVE_CLUSTER" - 集群版标准型,"CLOUD_NATIVE_CLUSTER_EXCLUSIVE" - 集群版加强型。不指定则默认为通用型。 DeviceType *string `json:"DeviceType,omitnil,omitempty" name:"DeviceType"` // 新克隆实例节点数。如果需要克隆出三节点实例, 请将该值设置为3 或指定 BackupZone 参数。如果需要克隆出两节点实例,请将该值设置为2。默认克隆出两节点实例。 @@ -2681,21 +2845,32 @@ type CreateCloneInstanceRequestParams struct { // 实例时长,PayType为PRE_PAID时必传,单位:月,可选值包括 [1,2,3,4,5,6,7,8,9,10,11,12,24,36]。 Period *int64 `json:"Period,omitnil,omitempty" name:"Period"` + + // 集群版节点拓扑配置。 + ClusterTopology *ClusterTopology `json:"ClusterTopology,omitnil,omitempty" name:"ClusterTopology"` + + // 原实例所在地域名,当传入异地备份时为必选项,例:ap-guangzhou + SrcRegion *string `json:"SrcRegion,omitnil,omitempty" name:"SrcRegion"` + + // 异地数据备份id + SpecifiedSubBackupId *int64 `json:"SpecifiedSubBackupId,omitnil,omitempty" name:"SpecifiedSubBackupId"` } type CreateCloneInstanceRequest struct { *tchttp.BaseRequest - // 克隆源实例Id。 + // 克隆源实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/api/236/15872) 接口获取。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` - // 如果需要克隆实例回档到指定时间,则指定该值。时间格式为: yyyy-mm-dd hh:mm:ss 。 + // 如果需要克隆实例回档到指定时间,则指定该值。时间格式为:yyyy-mm-dd hh:mm:ss。 + // 说明:此参数和 SpecifiedBackupId 参数需要2选1进行设置。 SpecifiedRollbackTime *string `json:"SpecifiedRollbackTime,omitnil,omitempty" name:"SpecifiedRollbackTime"` - // 如果需要克隆实例回档到指定备份的时间点,则指定该值为物理备份的Id。请使用 [查询数据备份文件列表](/document/api/236/15842) 。 + // 如果需要克隆实例回档到指定备份集,则指定该值为备份文件的 Id。请使用 [查询数据备份文件列表](/document/api/236/15842)。 + // 说明:如果是克隆双节点、三节点实例,备份文件为物理备份,如果是克隆单节点、集群版实例,备份文件为快照备份。 SpecifiedBackupId *int64 `json:"SpecifiedBackupId,omitnil,omitempty" name:"SpecifiedBackupId"` - // 私有网络 ID,如果不传则默认选择基础网络,请使用 [查询私有网络列表](/document/api/215/15778) 。 + // 私有网络 ID,请使用 [查询私有网络列表](/document/api/215/15778)。 UniqVpcId *string `json:"UniqVpcId,omitnil,omitempty" name:"UniqVpcId"` // 私有网络下的子网 ID,如果设置了 UniqVpcId,则 UniqSubnetId 必填,请使用 [查询子网列表](/document/api/215/15784)。 @@ -2707,7 +2882,7 @@ type CreateCloneInstanceRequest struct { // 实例硬盘大小,单位:GB,需要不低于克隆源实例,默认和源实例相同。 Volume *int64 `json:"Volume,omitnil,omitempty" name:"Volume"` - // 新产生的克隆实例名称。 + // 新产生的克隆实例名称。支持输入最大60个字符。 InstanceName *string `json:"InstanceName,omitnil,omitempty" name:"InstanceName"` // 安全组参数,可使用 [查询项目安全组信息](https://cloud.tencent.com/document/api/236/15850) 接口查询某个项目的安全组详情。 @@ -2731,7 +2906,7 @@ type CreateCloneInstanceRequest struct { // 备库 2 的可用区信息,默认为空,克隆强同步主实例时可指定该参数。 BackupZone *string `json:"BackupZone,omitnil,omitempty" name:"BackupZone"` - // 克隆实例类型。支持值包括: "UNIVERSAL" - 通用型实例, "EXCLUSIVE" - 独享型实例。 不指定则默认为通用型。 + // 克隆实例类型。支持值包括:"UNIVERSAL" - 通用型实例,"EXCLUSIVE" - 独享型实例,"CLOUD_NATIVE_CLUSTER" - 集群版标准型,"CLOUD_NATIVE_CLUSTER_EXCLUSIVE" - 集群版加强型。不指定则默认为通用型。 DeviceType *string `json:"DeviceType,omitnil,omitempty" name:"DeviceType"` // 新克隆实例节点数。如果需要克隆出三节点实例, 请将该值设置为3 或指定 BackupZone 参数。如果需要克隆出两节点实例,请将该值设置为2。默认克隆出两节点实例。 @@ -2754,6 +2929,15 @@ type CreateCloneInstanceRequest struct { // 实例时长,PayType为PRE_PAID时必传,单位:月,可选值包括 [1,2,3,4,5,6,7,8,9,10,11,12,24,36]。 Period *int64 `json:"Period,omitnil,omitempty" name:"Period"` + + // 集群版节点拓扑配置。 + ClusterTopology *ClusterTopology `json:"ClusterTopology,omitnil,omitempty" name:"ClusterTopology"` + + // 原实例所在地域名,当传入异地备份时为必选项,例:ap-guangzhou + SrcRegion *string `json:"SrcRegion,omitnil,omitempty" name:"SrcRegion"` + + // 异地数据备份id + SpecifiedSubBackupId *int64 `json:"SpecifiedSubBackupId,omitnil,omitempty" name:"SpecifiedSubBackupId"` } func (r *CreateCloneInstanceRequest) ToJsonString() string { @@ -2791,6 +2975,9 @@ func (r *CreateCloneInstanceRequest) FromJsonString(s string) error { delete(f, "ProjectId") delete(f, "PayType") delete(f, "Period") + delete(f, "ClusterTopology") + delete(f, "SrcRegion") + delete(f, "SpecifiedSubBackupId") if len(f) > 0 { return tcerr.NewTencentCloudSDKError("ClientError.BuildRequestError", "CreateCloneInstanceRequest has unknown keys!", "") } @@ -2925,38 +3112,44 @@ type CreateDBInstanceHourRequestParams struct { // 实例硬盘大小,单位:GB,请使用 [获取云数据库可售卖规格](https://cloud.tencent.com/document/api/236/17229) 接口获取可创建的硬盘范围。 Volume *int64 `json:"Volume,omitnil,omitempty" name:"Volume"` - // MySQL 版本,值包括:5.5、5.6、5.7、8.0,请使用 [获取云数据库可售卖规格](https://cloud.tencent.com/document/api/236/17229) 接口获取可创建的实例版本。 - // 说明:若此参数不填,则默认值为5.6。 + // MySQL 版本,值包括:5.5、5.6、5.7和8.0,请使用 [获取云数据库可售卖规格](https://cloud.tencent.com/document/api/236/17229) 接口获取可创建的实例版本。 + // 说明:创建非集群版实例时,请根据需要指定实例版本(推荐5.7或8.0),若此参数不填,则默认值为5.6;若创建的是集群版实例,则此参数仅能指定为5.7或8.0。 EngineVersion *string `json:"EngineVersion,omitnil,omitempty" name:"EngineVersion"` - // 私有网络 ID,如果不传则默认选择基础网络,请使用 [查询私有网络列表](/document/api/215/15778) 。 + // 私有网络 ID,请使用 [查询私有网络列表](/document/api/215/15778)。 + // 说明:如果创建的是集群版实例,此参数为必填且为私有网络类型。若此项不填,则系统会选择默认的 VPC。 UniqVpcId *string `json:"UniqVpcId,omitnil,omitempty" name:"UniqVpcId"` - // 私有网络下的子网 ID,如果设置了 UniqVpcId,则 UniqSubnetId 必填,请使用[查询子网列表](/document/api/215/15784)。 + // 私有网络下的子网 ID,如果设置了 UniqVpcId,则 UniqSubnetId 必填,请使用 [查询子网列表](/document/api/215/15784)。 + // 说明:若此项不填,则系统会选择默认 VPC 下的默认子网。 UniqSubnetId *string `json:"UniqSubnetId,omitnil,omitempty" name:"UniqSubnetId"` // 项目 ID,不填为默认项目。 ProjectId *int64 `json:"ProjectId,omitnil,omitempty" name:"ProjectId"` - // 可用区信息,该参数缺省时,系统会自动选择一个可用区,请使用 [获取云数据库可售卖规格](https://cloud.tencent.com/document/api/236/17229) 接口获取可创建的可用区。 + // 可用区信息,请使用 [获取云数据库可售卖规格](https://cloud.tencent.com/document/api/236/17229) 接口获取可创建的可用区。 + // 说明:若您创建单节点、双节点、三节点实例,此参数为必填项,请指定可用区,若不指定可用区,则系统会自动选择一个可用区(可能不是您希望部署的可用区);若您创建集群版实例,此参数不填,请通过参数 ClusterTopology 进行读写节点和只读节点的可用区配置。 Zone *string `json:"Zone,omitnil,omitempty" name:"Zone"` // 实例 ID,购买只读实例或者灾备实例时必填,该字段表示只读实例或者灾备实例的主实例 ID,请使用 [查询实例列表](https://cloud.tencent.com/document/api/236/15872) 接口查询云数据库实例 ID。 MasterInstanceId *string `json:"MasterInstanceId,omitnil,omitempty" name:"MasterInstanceId"` - // 实例类型,默认为 master,支持值包括:master - 表示主实例,dr - 表示灾备实例,ro - 表示只读实例。 + // 实例类型,支持值包括:master - 表示主实例,dr - 表示灾备实例,ro - 表示只读实例。 + // 说明:请选择实例类型,不填会默认选择 master。 InstanceRole *string `json:"InstanceRole,omitnil,omitempty" name:"InstanceRole"` // 主实例地域信息,购买灾备、RO实例时,该字段必填。 MasterRegion *string `json:"MasterRegion,omitnil,omitempty" name:"MasterRegion"` - // 自定义端口,端口支持范围:[ 1024-65535 ] 。 + // 自定义端口,端口支持范围:[1024 - 65535]。 + // 说明:不填则默认为3306。 Port *int64 `json:"Port,omitnil,omitempty" name:"Port"` // 设置 root 账号密码,密码规则:8 - 64 个字符,至少包含字母、数字、字符(支持的字符:_+-&=!@#$%^*())中的两种,购买主实例时可指定该参数,购买只读实例或者灾备实例时指定该参数无意义。 Password *string `json:"Password,omitnil,omitempty" name:"Password"` // 参数列表,参数格式如 ParamList.0.Name=auto_increment&ParamList.0.Value=1。可通过 [查询默认的可设置参数列表](https://cloud.tencent.com/document/api/236/32662) 查询支持设置的参数。 + // 说明:表名大小写敏感的开启和关闭可通过参数 lower_case_table_names 进行设置,参数值为0表示开启,参数值为1表示关闭,若不设置则此参数默认值为0。若您创建的是 MySQL 8.0 版本的实例,则需要在创建实例时通过设置 lower_case_table_names 参数来开启或关闭表名大小写敏感,创建实例后无法修改参数,即创建后无法修改表名大小写敏感。其他数据库版本的实例支持在创建实例后修改 lower_case_table_names 参数。创建实例时设置表名大小写敏感的 API 调用方法请参见本文中的示例2。 ParamList []*ParamInfo `json:"ParamList,omitnil,omitempty" name:"ParamList"` // 数据复制方式,默认为 0,支持值包括:0 - 表示异步复制,1 - 表示半同步复制,2 - 表示强同步复制,购买主实例时可指定该参数,购买只读实例或者灾备实例时指定该参数无意义。 @@ -2965,7 +3158,8 @@ type CreateDBInstanceHourRequestParams struct { // 多可用区域,默认为 0,支持值包括:0 - 表示单可用区,1 - 表示多可用区,购买主实例时可指定该参数,购买只读实例或者灾备实例时指定该参数无意义。 DeployMode *int64 `json:"DeployMode,omitnil,omitempty" name:"DeployMode"` - // 备库 1 的可用区信息,默认为 Zone 的值,购买主实例时可指定该参数,购买只读实例或者灾备实例时指定该参数无意义。 + // 备库 1 的可用区信息。 + // 说明:双节点、三节点实例请指定此参数值,若不指定,则默认为 Zone 的值;集群版实例此参数可不填,请通过参数 ClusterTopology 进行读写节点和只读节点的可用区配置;单节点实例为单可用区,无需指定此参数。 SlaveZone *string `json:"SlaveZone,omitnil,omitempty" name:"SlaveZone"` // 备库 2 的可用区信息,默认为空,购买三节点主实例时可指定该参数。 @@ -2992,7 +3186,8 @@ type CreateDBInstanceHourRequestParams struct { // 用于保证请求幂等性的字符串。该字符串由客户生成,需保证不同请求之间在48小时内唯一,最大值不超过64个ASCII字符。若不指定该参数,则无法保证请求的幂等性。 ClientToken *string `json:"ClientToken,omitnil,omitempty" name:"ClientToken"` - // 实例隔离类型。支持值包括: "UNIVERSAL" - 通用型实例, "EXCLUSIVE" - 独享型实例, "BASIC_V2" - ONTKE单节点实例。 不指定则默认为通用型实例。 + // 实例隔离类型。支持值包括:"UNIVERSAL" - 通用型实例,"EXCLUSIVE" - 独享型实例,"BASIC_V2" - ONTKE 单节点实例,"CLOUD_NATIVE_CLUSTER" - 集群版标准型,"CLOUD_NATIVE_CLUSTER_EXCLUSIVE" - 集群版加强型。不指定则默认为通用型实例。 + // 说明:如果创建的是集群版实例,此参数为必填。 DeviceType *string `json:"DeviceType,omitnil,omitempty" name:"DeviceType"` // 参数模板 id。 @@ -3029,6 +3224,20 @@ type CreateDBInstanceHourRequestParams struct { // 指定实例的IP列表。仅支持主实例指定,按实例顺序,不足则按未指定处理。 Vips []*string `json:"Vips,omitnil,omitempty" name:"Vips"` + + // 集群版实例的数据保护空间大小,单位 GB,设置范围1 - 10。 + DataProtectVolume *int64 `json:"DataProtectVolume,omitnil,omitempty" name:"DataProtectVolume"` + + // 集群版节点拓扑配置。 + // 说明:若购买的是集群版实例,此参数为必填,需设置集群版实例的 RW 和 RO 节点拓扑,RO 节点范围是1 - 5个,请至少设置1个 RO 节点。 + ClusterTopology *ClusterTopology `json:"ClusterTopology,omitnil,omitempty" name:"ClusterTopology"` + + // 硬盘类型,单节点(云盘版)或者集群版实例可以指定此参数。CLOUD_SSD 表示 SSD 云硬盘,CLOUD_HSSD 表示增强型 SSD 云硬盘。 + // 说明:单节点(云盘版)、集群版实例硬盘类型所支持的地域略有不同,具体支持情况请参考 [地域和可用区](https://cloud.tencent.com/document/product/236/8458)。 + DiskType *string `json:"DiskType,omitnil,omitempty" name:"DiskType"` + + // 集群类型:cage——金融围拢,cdc——CDB ON CDC;dedicate——独享集群 + ClusterType *string `json:"ClusterType,omitnil,omitempty" name:"ClusterType"` } type CreateDBInstanceHourRequest struct { @@ -3043,38 +3252,44 @@ type CreateDBInstanceHourRequest struct { // 实例硬盘大小,单位:GB,请使用 [获取云数据库可售卖规格](https://cloud.tencent.com/document/api/236/17229) 接口获取可创建的硬盘范围。 Volume *int64 `json:"Volume,omitnil,omitempty" name:"Volume"` - // MySQL 版本,值包括:5.5、5.6、5.7、8.0,请使用 [获取云数据库可售卖规格](https://cloud.tencent.com/document/api/236/17229) 接口获取可创建的实例版本。 - // 说明:若此参数不填,则默认值为5.6。 + // MySQL 版本,值包括:5.5、5.6、5.7和8.0,请使用 [获取云数据库可售卖规格](https://cloud.tencent.com/document/api/236/17229) 接口获取可创建的实例版本。 + // 说明:创建非集群版实例时,请根据需要指定实例版本(推荐5.7或8.0),若此参数不填,则默认值为5.6;若创建的是集群版实例,则此参数仅能指定为5.7或8.0。 EngineVersion *string `json:"EngineVersion,omitnil,omitempty" name:"EngineVersion"` - // 私有网络 ID,如果不传则默认选择基础网络,请使用 [查询私有网络列表](/document/api/215/15778) 。 + // 私有网络 ID,请使用 [查询私有网络列表](/document/api/215/15778)。 + // 说明:如果创建的是集群版实例,此参数为必填且为私有网络类型。若此项不填,则系统会选择默认的 VPC。 UniqVpcId *string `json:"UniqVpcId,omitnil,omitempty" name:"UniqVpcId"` - // 私有网络下的子网 ID,如果设置了 UniqVpcId,则 UniqSubnetId 必填,请使用[查询子网列表](/document/api/215/15784)。 + // 私有网络下的子网 ID,如果设置了 UniqVpcId,则 UniqSubnetId 必填,请使用 [查询子网列表](/document/api/215/15784)。 + // 说明:若此项不填,则系统会选择默认 VPC 下的默认子网。 UniqSubnetId *string `json:"UniqSubnetId,omitnil,omitempty" name:"UniqSubnetId"` // 项目 ID,不填为默认项目。 ProjectId *int64 `json:"ProjectId,omitnil,omitempty" name:"ProjectId"` - // 可用区信息,该参数缺省时,系统会自动选择一个可用区,请使用 [获取云数据库可售卖规格](https://cloud.tencent.com/document/api/236/17229) 接口获取可创建的可用区。 + // 可用区信息,请使用 [获取云数据库可售卖规格](https://cloud.tencent.com/document/api/236/17229) 接口获取可创建的可用区。 + // 说明:若您创建单节点、双节点、三节点实例,此参数为必填项,请指定可用区,若不指定可用区,则系统会自动选择一个可用区(可能不是您希望部署的可用区);若您创建集群版实例,此参数不填,请通过参数 ClusterTopology 进行读写节点和只读节点的可用区配置。 Zone *string `json:"Zone,omitnil,omitempty" name:"Zone"` // 实例 ID,购买只读实例或者灾备实例时必填,该字段表示只读实例或者灾备实例的主实例 ID,请使用 [查询实例列表](https://cloud.tencent.com/document/api/236/15872) 接口查询云数据库实例 ID。 MasterInstanceId *string `json:"MasterInstanceId,omitnil,omitempty" name:"MasterInstanceId"` - // 实例类型,默认为 master,支持值包括:master - 表示主实例,dr - 表示灾备实例,ro - 表示只读实例。 + // 实例类型,支持值包括:master - 表示主实例,dr - 表示灾备实例,ro - 表示只读实例。 + // 说明:请选择实例类型,不填会默认选择 master。 InstanceRole *string `json:"InstanceRole,omitnil,omitempty" name:"InstanceRole"` // 主实例地域信息,购买灾备、RO实例时,该字段必填。 MasterRegion *string `json:"MasterRegion,omitnil,omitempty" name:"MasterRegion"` - // 自定义端口,端口支持范围:[ 1024-65535 ] 。 + // 自定义端口,端口支持范围:[1024 - 65535]。 + // 说明:不填则默认为3306。 Port *int64 `json:"Port,omitnil,omitempty" name:"Port"` // 设置 root 账号密码,密码规则:8 - 64 个字符,至少包含字母、数字、字符(支持的字符:_+-&=!@#$%^*())中的两种,购买主实例时可指定该参数,购买只读实例或者灾备实例时指定该参数无意义。 Password *string `json:"Password,omitnil,omitempty" name:"Password"` // 参数列表,参数格式如 ParamList.0.Name=auto_increment&ParamList.0.Value=1。可通过 [查询默认的可设置参数列表](https://cloud.tencent.com/document/api/236/32662) 查询支持设置的参数。 + // 说明:表名大小写敏感的开启和关闭可通过参数 lower_case_table_names 进行设置,参数值为0表示开启,参数值为1表示关闭,若不设置则此参数默认值为0。若您创建的是 MySQL 8.0 版本的实例,则需要在创建实例时通过设置 lower_case_table_names 参数来开启或关闭表名大小写敏感,创建实例后无法修改参数,即创建后无法修改表名大小写敏感。其他数据库版本的实例支持在创建实例后修改 lower_case_table_names 参数。创建实例时设置表名大小写敏感的 API 调用方法请参见本文中的示例2。 ParamList []*ParamInfo `json:"ParamList,omitnil,omitempty" name:"ParamList"` // 数据复制方式,默认为 0,支持值包括:0 - 表示异步复制,1 - 表示半同步复制,2 - 表示强同步复制,购买主实例时可指定该参数,购买只读实例或者灾备实例时指定该参数无意义。 @@ -3083,7 +3298,8 @@ type CreateDBInstanceHourRequest struct { // 多可用区域,默认为 0,支持值包括:0 - 表示单可用区,1 - 表示多可用区,购买主实例时可指定该参数,购买只读实例或者灾备实例时指定该参数无意义。 DeployMode *int64 `json:"DeployMode,omitnil,omitempty" name:"DeployMode"` - // 备库 1 的可用区信息,默认为 Zone 的值,购买主实例时可指定该参数,购买只读实例或者灾备实例时指定该参数无意义。 + // 备库 1 的可用区信息。 + // 说明:双节点、三节点实例请指定此参数值,若不指定,则默认为 Zone 的值;集群版实例此参数可不填,请通过参数 ClusterTopology 进行读写节点和只读节点的可用区配置;单节点实例为单可用区,无需指定此参数。 SlaveZone *string `json:"SlaveZone,omitnil,omitempty" name:"SlaveZone"` // 备库 2 的可用区信息,默认为空,购买三节点主实例时可指定该参数。 @@ -3110,7 +3326,8 @@ type CreateDBInstanceHourRequest struct { // 用于保证请求幂等性的字符串。该字符串由客户生成,需保证不同请求之间在48小时内唯一,最大值不超过64个ASCII字符。若不指定该参数,则无法保证请求的幂等性。 ClientToken *string `json:"ClientToken,omitnil,omitempty" name:"ClientToken"` - // 实例隔离类型。支持值包括: "UNIVERSAL" - 通用型实例, "EXCLUSIVE" - 独享型实例, "BASIC_V2" - ONTKE单节点实例。 不指定则默认为通用型实例。 + // 实例隔离类型。支持值包括:"UNIVERSAL" - 通用型实例,"EXCLUSIVE" - 独享型实例,"BASIC_V2" - ONTKE 单节点实例,"CLOUD_NATIVE_CLUSTER" - 集群版标准型,"CLOUD_NATIVE_CLUSTER_EXCLUSIVE" - 集群版加强型。不指定则默认为通用型实例。 + // 说明:如果创建的是集群版实例,此参数为必填。 DeviceType *string `json:"DeviceType,omitnil,omitempty" name:"DeviceType"` // 参数模板 id。 @@ -3147,6 +3364,20 @@ type CreateDBInstanceHourRequest struct { // 指定实例的IP列表。仅支持主实例指定,按实例顺序,不足则按未指定处理。 Vips []*string `json:"Vips,omitnil,omitempty" name:"Vips"` + + // 集群版实例的数据保护空间大小,单位 GB,设置范围1 - 10。 + DataProtectVolume *int64 `json:"DataProtectVolume,omitnil,omitempty" name:"DataProtectVolume"` + + // 集群版节点拓扑配置。 + // 说明:若购买的是集群版实例,此参数为必填,需设置集群版实例的 RW 和 RO 节点拓扑,RO 节点范围是1 - 5个,请至少设置1个 RO 节点。 + ClusterTopology *ClusterTopology `json:"ClusterTopology,omitnil,omitempty" name:"ClusterTopology"` + + // 硬盘类型,单节点(云盘版)或者集群版实例可以指定此参数。CLOUD_SSD 表示 SSD 云硬盘,CLOUD_HSSD 表示增强型 SSD 云硬盘。 + // 说明:单节点(云盘版)、集群版实例硬盘类型所支持的地域略有不同,具体支持情况请参考 [地域和可用区](https://cloud.tencent.com/document/product/236/8458)。 + DiskType *string `json:"DiskType,omitnil,omitempty" name:"DiskType"` + + // 集群类型:cage——金融围拢,cdc——CDB ON CDC;dedicate——独享集群 + ClusterType *string `json:"ClusterType,omitnil,omitempty" name:"ClusterType"` } func (r *CreateDBInstanceHourRequest) ToJsonString() string { @@ -3198,6 +3429,10 @@ func (r *CreateDBInstanceHourRequest) FromJsonString(s string) error { delete(f, "DryRun") delete(f, "EngineType") delete(f, "Vips") + delete(f, "DataProtectVolume") + delete(f, "ClusterTopology") + delete(f, "DiskType") + delete(f, "ClusterType") if len(f) > 0 { return tcerr.NewTencentCloudSDKError("ClientError.BuildRequestError", "CreateDBInstanceHourRequest has unknown keys!", "") } @@ -3246,29 +3481,34 @@ type CreateDBInstanceRequestParams struct { // 实例数量,默认值为1, 最小值1,最大值为100。 GoodsNum *int64 `json:"GoodsNum,omitnil,omitempty" name:"GoodsNum"` - // 可用区信息,该参数缺省时,系统会自动选择一个可用区,请使用 [获取云数据库可售卖规格](https://cloud.tencent.com/document/api/236/17229) 接口获取可创建的可用区。 + // 可用区信息,请使用 [获取云数据库可售卖规格](https://cloud.tencent.com/document/api/236/17229) 接口获取可创建的可用区。 + // 说明:若您创建单节点、双节点、三节点实例,此参数为必填项,请指定可用区,若不指定可用区,则系统会自动选择一个可用区(可能不是您希望部署的可用区);若您创建集群版实例,此参数不填,请通过参数 ClusterTopology 进行读写节点和只读节点的可用区配置。 Zone *string `json:"Zone,omitnil,omitempty" name:"Zone"` - // 私有网络 ID,如果不传则默认选择基础网络,请使用 [查询私有网络列表](/document/api/215/15778) 。 + // 私有网络 ID,请使用 [查询私有网络列表](/document/api/215/15778)。 + // 说明:如果创建的是集群版实例,此参数为必填且为私有网络类型。若此项不填,则系统会选择默认的 VPC。 UniqVpcId *string `json:"UniqVpcId,omitnil,omitempty" name:"UniqVpcId"` // 私有网络下的子网 ID,如果设置了 UniqVpcId,则 UniqSubnetId 必填,请使用 [查询子网列表](/document/api/215/15784)。 + // 说明:若此项不填,则系统会选择默认 VPC 下的默认子网。 UniqSubnetId *string `json:"UniqSubnetId,omitnil,omitempty" name:"UniqSubnetId"` // 项目 ID,不填为默认项目。购买只读实例和灾备实例时,项目 ID 默认和主实例保持一致。 ProjectId *int64 `json:"ProjectId,omitnil,omitempty" name:"ProjectId"` // 自定义端口,端口支持范围:[ 1024-65535 ]。 + // 说明:若此项不填,则默认为3306。 Port *int64 `json:"Port,omitnil,omitempty" name:"Port"` - // 实例类型,默认为 master,支持值包括:master - 表示主实例,dr - 表示灾备实例,ro - 表示只读实例。 + // 实例类型,支持值包括:master - 表示主实例,dr - 表示灾备实例,ro - 表示只读实例。 + // 说明:请选择实例类型,不填会默认选择 master。 InstanceRole *string `json:"InstanceRole,omitnil,omitempty" name:"InstanceRole"` - // 实例 ID,购买只读实例时必填,该字段表示只读实例的主实例ID,请使用 [查询实例列表](https://cloud.tencent.com/document/api/236/15872) 接口查询云数据库实例 ID。 + // 实例 ID,购买只读实例或灾备实例时必填,该字段表示只读实例或灾备实例的主实例 ID,请使用 [查询实例列表](https://cloud.tencent.com/document/api/236/15872) 接口查询云数据库实例 ID。 MasterInstanceId *string `json:"MasterInstanceId,omitnil,omitempty" name:"MasterInstanceId"` // MySQL 版本,值包括:5.5、5.6、5.7和8.0,请使用 [获取云数据库可售卖规格](https://cloud.tencent.com/document/api/236/17229) 接口获取可创建的实例版本。 - // 说明:若此参数不填,则默认值为5.6。 + // 说明:创建非集群版实例时,请根据需要指定实例版本(推荐5.7或8.0),若此参数不填,则默认值为5.6;若创建的是集群版实例,则此参数仅能指定为5.7或8.0。 EngineVersion *string `json:"EngineVersion,omitnil,omitempty" name:"EngineVersion"` // 设置 root 账号密码,密码规则:8 - 64 个字符,至少包含字母、数字、字符(支持的字符:_+-&=!@#$%^*())中的两种,购买主实例时可指定该参数,购买只读实例或者灾备实例时指定该参数无意义。 @@ -3280,16 +3520,18 @@ type CreateDBInstanceRequestParams struct { // 多可用区域,默认为 0,支持值包括:0 - 表示单可用区,1 - 表示多可用区。 DeployMode *int64 `json:"DeployMode,omitnil,omitempty" name:"DeployMode"` - // 备库 1 的可用区信息,默认为 Zone 的值。 + // 备库 1 的可用区信息。 + // 说明:双节点、三节点实例请指定此参数值,若不指定,则默认为 Zone 的值;集群版实例此参数可不填,请通过参数 ClusterTopology 进行读写节点和只读节点的可用区配置;单节点实例为单可用区,无需指定此参数。 SlaveZone *string `json:"SlaveZone,omitnil,omitempty" name:"SlaveZone"` // 参数列表,参数格式如 ParamList.0.Name=auto_increment&ParamList.0.Value=1。可通过 [查询默认的可设置参数列表](https://cloud.tencent.com/document/api/236/32662) 查询支持设置的参数。 + // 说明:表名大小写敏感的开启和关闭可通过参数 lower_case_table_names 进行设置,参数值为0表示开启,参数值为1表示关闭,若不设置则此参数默认值为0。若您创建的是 MySQL 8.0 版本的实例,则需要在创建实例时通过设置 lower_case_table_names 参数来开启或关闭表名大小写敏感,创建实例后无法修改参数,即创建后无法修改表名大小写敏感。其他数据库版本的实例支持在创建实例后修改 lower_case_table_names 参数。创建实例时设置表名大小写敏感的 API 调用方法请参见本文中的示例3。 ParamList []*ParamInfo `json:"ParamList,omitnil,omitempty" name:"ParamList"` // 备库 2 的可用区信息,默认为空,购买三节点主实例时可指定该参数。 BackupZone *string `json:"BackupZone,omitnil,omitempty" name:"BackupZone"` - // 自动续费标记,可选值为:0 - 不自动续费;1 - 自动续费。 + // 自动续费标记,可选值为:0 - 不自动续费;1 - 自动续费。默认为0。 AutoRenewFlag *int64 `json:"AutoRenewFlag,omitnil,omitempty" name:"AutoRenewFlag"` // 主实例地域信息,购买灾备、RO实例时,该字段必填。 @@ -3313,7 +3555,8 @@ type CreateDBInstanceRequestParams struct { // 用于保证请求幂等性的字符串。该字符串由客户生成,需保证不同请求之间在48小时内唯一,最大值不超过64个ASCII字符。若不指定该参数,则无法保证请求的幂等性。 ClientToken *string `json:"ClientToken,omitnil,omitempty" name:"ClientToken"` - // 实例隔离类型。支持值包括: "UNIVERSAL" - 通用型实例, "EXCLUSIVE" - 独享型实例, "BASIC_V2" - ONTKE单节点实例。 不指定则默认为通用型实例。 + // 实例隔离类型。支持值包括:"UNIVERSAL" - 通用型实例,"EXCLUSIVE" - 独享型实例,"BASIC_V2" - ONTKE 单节点实例,"CLOUD_NATIVE_CLUSTER" - 集群版标准型,"CLOUD_NATIVE_CLUSTER_EXCLUSIVE" - 集群版加强型。不指定则默认为通用型实例。 + // 说明:如果创建的是集群版实例,此参数为必填。 DeviceType *string `json:"DeviceType,omitnil,omitempty" name:"DeviceType"` // 参数模板 id。 @@ -3342,7 +3585,8 @@ type CreateDBInstanceRequestParams struct { // 告警策略名数组,例如:["policy-uyoee9wg"],AlarmPolicyList不为空时该参数无效。 AlarmPolicyIdList []*string `json:"AlarmPolicyIdList,omitnil,omitempty" name:"AlarmPolicyIdList"` - // 是否只预检此次请求。true:发送检查请求,不会创建实例。检查项包括是否填写了必需参数,请求格式,业务限制等。如果检查不通过,则返回对应错误码;如果检查通过,则返回RequestId.默认为false:发送正常请求,通过检查后直接创建实例。 + // 是否只预检此次请求。true:发送检查请求,不会创建实例。检查项包括是否填写了必需参数,请求格式,业务限制等。如果检查不通过,则返回对应错误码;如果检查通过,则返回 RequestId。false:发送正常请求,通过检查后直接创建实例。 + // 默认为 false。 DryRun *bool `json:"DryRun,omitnil,omitempty" name:"DryRun"` // 实例引擎类型,默认为"InnoDB",支持值包括:"InnoDB","RocksDB"。 @@ -3350,6 +3594,17 @@ type CreateDBInstanceRequestParams struct { // 指定实例的IP列表。仅支持主实例指定,按实例顺序,不足则按未指定处理。 Vips []*string `json:"Vips,omitnil,omitempty" name:"Vips"` + + // 集群版实例的数据保护空间大小,单位 GB,设置范围1 - 10。 + DataProtectVolume *int64 `json:"DataProtectVolume,omitnil,omitempty" name:"DataProtectVolume"` + + // 集群版节点拓扑配置。 + // 说明:若购买的是集群版实例,此参数为必填,需设置集群版实例的 RW 和 RO 节点拓扑,RO 节点范围是1 - 5个,请至少设置1个 RO 节点。 + ClusterTopology *ClusterTopology `json:"ClusterTopology,omitnil,omitempty" name:"ClusterTopology"` + + // 磁盘类型,单节点(云盘版)或者集群版实例可以指定此参数。CLOUD_SSD 表示 SSD 云硬盘,CLOUD_HSSD 表示增强型 SSD 云硬盘。 + // 说明:单节点(云盘版)、集群版实例硬盘类型所支持的地域略有不同,具体支持情况请参考 [地域和可用区](https://cloud.tencent.com/document/product/236/8458)。 + DiskType *string `json:"DiskType,omitnil,omitempty" name:"DiskType"` } type CreateDBInstanceRequest struct { @@ -3367,29 +3622,34 @@ type CreateDBInstanceRequest struct { // 实例数量,默认值为1, 最小值1,最大值为100。 GoodsNum *int64 `json:"GoodsNum,omitnil,omitempty" name:"GoodsNum"` - // 可用区信息,该参数缺省时,系统会自动选择一个可用区,请使用 [获取云数据库可售卖规格](https://cloud.tencent.com/document/api/236/17229) 接口获取可创建的可用区。 + // 可用区信息,请使用 [获取云数据库可售卖规格](https://cloud.tencent.com/document/api/236/17229) 接口获取可创建的可用区。 + // 说明:若您创建单节点、双节点、三节点实例,此参数为必填项,请指定可用区,若不指定可用区,则系统会自动选择一个可用区(可能不是您希望部署的可用区);若您创建集群版实例,此参数不填,请通过参数 ClusterTopology 进行读写节点和只读节点的可用区配置。 Zone *string `json:"Zone,omitnil,omitempty" name:"Zone"` - // 私有网络 ID,如果不传则默认选择基础网络,请使用 [查询私有网络列表](/document/api/215/15778) 。 + // 私有网络 ID,请使用 [查询私有网络列表](/document/api/215/15778)。 + // 说明:如果创建的是集群版实例,此参数为必填且为私有网络类型。若此项不填,则系统会选择默认的 VPC。 UniqVpcId *string `json:"UniqVpcId,omitnil,omitempty" name:"UniqVpcId"` // 私有网络下的子网 ID,如果设置了 UniqVpcId,则 UniqSubnetId 必填,请使用 [查询子网列表](/document/api/215/15784)。 + // 说明:若此项不填,则系统会选择默认 VPC 下的默认子网。 UniqSubnetId *string `json:"UniqSubnetId,omitnil,omitempty" name:"UniqSubnetId"` // 项目 ID,不填为默认项目。购买只读实例和灾备实例时,项目 ID 默认和主实例保持一致。 ProjectId *int64 `json:"ProjectId,omitnil,omitempty" name:"ProjectId"` // 自定义端口,端口支持范围:[ 1024-65535 ]。 + // 说明:若此项不填,则默认为3306。 Port *int64 `json:"Port,omitnil,omitempty" name:"Port"` - // 实例类型,默认为 master,支持值包括:master - 表示主实例,dr - 表示灾备实例,ro - 表示只读实例。 + // 实例类型,支持值包括:master - 表示主实例,dr - 表示灾备实例,ro - 表示只读实例。 + // 说明:请选择实例类型,不填会默认选择 master。 InstanceRole *string `json:"InstanceRole,omitnil,omitempty" name:"InstanceRole"` - // 实例 ID,购买只读实例时必填,该字段表示只读实例的主实例ID,请使用 [查询实例列表](https://cloud.tencent.com/document/api/236/15872) 接口查询云数据库实例 ID。 + // 实例 ID,购买只读实例或灾备实例时必填,该字段表示只读实例或灾备实例的主实例 ID,请使用 [查询实例列表](https://cloud.tencent.com/document/api/236/15872) 接口查询云数据库实例 ID。 MasterInstanceId *string `json:"MasterInstanceId,omitnil,omitempty" name:"MasterInstanceId"` // MySQL 版本,值包括:5.5、5.6、5.7和8.0,请使用 [获取云数据库可售卖规格](https://cloud.tencent.com/document/api/236/17229) 接口获取可创建的实例版本。 - // 说明:若此参数不填,则默认值为5.6。 + // 说明:创建非集群版实例时,请根据需要指定实例版本(推荐5.7或8.0),若此参数不填,则默认值为5.6;若创建的是集群版实例,则此参数仅能指定为5.7或8.0。 EngineVersion *string `json:"EngineVersion,omitnil,omitempty" name:"EngineVersion"` // 设置 root 账号密码,密码规则:8 - 64 个字符,至少包含字母、数字、字符(支持的字符:_+-&=!@#$%^*())中的两种,购买主实例时可指定该参数,购买只读实例或者灾备实例时指定该参数无意义。 @@ -3401,16 +3661,18 @@ type CreateDBInstanceRequest struct { // 多可用区域,默认为 0,支持值包括:0 - 表示单可用区,1 - 表示多可用区。 DeployMode *int64 `json:"DeployMode,omitnil,omitempty" name:"DeployMode"` - // 备库 1 的可用区信息,默认为 Zone 的值。 + // 备库 1 的可用区信息。 + // 说明:双节点、三节点实例请指定此参数值,若不指定,则默认为 Zone 的值;集群版实例此参数可不填,请通过参数 ClusterTopology 进行读写节点和只读节点的可用区配置;单节点实例为单可用区,无需指定此参数。 SlaveZone *string `json:"SlaveZone,omitnil,omitempty" name:"SlaveZone"` // 参数列表,参数格式如 ParamList.0.Name=auto_increment&ParamList.0.Value=1。可通过 [查询默认的可设置参数列表](https://cloud.tencent.com/document/api/236/32662) 查询支持设置的参数。 + // 说明:表名大小写敏感的开启和关闭可通过参数 lower_case_table_names 进行设置,参数值为0表示开启,参数值为1表示关闭,若不设置则此参数默认值为0。若您创建的是 MySQL 8.0 版本的实例,则需要在创建实例时通过设置 lower_case_table_names 参数来开启或关闭表名大小写敏感,创建实例后无法修改参数,即创建后无法修改表名大小写敏感。其他数据库版本的实例支持在创建实例后修改 lower_case_table_names 参数。创建实例时设置表名大小写敏感的 API 调用方法请参见本文中的示例3。 ParamList []*ParamInfo `json:"ParamList,omitnil,omitempty" name:"ParamList"` // 备库 2 的可用区信息,默认为空,购买三节点主实例时可指定该参数。 BackupZone *string `json:"BackupZone,omitnil,omitempty" name:"BackupZone"` - // 自动续费标记,可选值为:0 - 不自动续费;1 - 自动续费。 + // 自动续费标记,可选值为:0 - 不自动续费;1 - 自动续费。默认为0。 AutoRenewFlag *int64 `json:"AutoRenewFlag,omitnil,omitempty" name:"AutoRenewFlag"` // 主实例地域信息,购买灾备、RO实例时,该字段必填。 @@ -3434,7 +3696,8 @@ type CreateDBInstanceRequest struct { // 用于保证请求幂等性的字符串。该字符串由客户生成,需保证不同请求之间在48小时内唯一,最大值不超过64个ASCII字符。若不指定该参数,则无法保证请求的幂等性。 ClientToken *string `json:"ClientToken,omitnil,omitempty" name:"ClientToken"` - // 实例隔离类型。支持值包括: "UNIVERSAL" - 通用型实例, "EXCLUSIVE" - 独享型实例, "BASIC_V2" - ONTKE单节点实例。 不指定则默认为通用型实例。 + // 实例隔离类型。支持值包括:"UNIVERSAL" - 通用型实例,"EXCLUSIVE" - 独享型实例,"BASIC_V2" - ONTKE 单节点实例,"CLOUD_NATIVE_CLUSTER" - 集群版标准型,"CLOUD_NATIVE_CLUSTER_EXCLUSIVE" - 集群版加强型。不指定则默认为通用型实例。 + // 说明:如果创建的是集群版实例,此参数为必填。 DeviceType *string `json:"DeviceType,omitnil,omitempty" name:"DeviceType"` // 参数模板 id。 @@ -3463,7 +3726,8 @@ type CreateDBInstanceRequest struct { // 告警策略名数组,例如:["policy-uyoee9wg"],AlarmPolicyList不为空时该参数无效。 AlarmPolicyIdList []*string `json:"AlarmPolicyIdList,omitnil,omitempty" name:"AlarmPolicyIdList"` - // 是否只预检此次请求。true:发送检查请求,不会创建实例。检查项包括是否填写了必需参数,请求格式,业务限制等。如果检查不通过,则返回对应错误码;如果检查通过,则返回RequestId.默认为false:发送正常请求,通过检查后直接创建实例。 + // 是否只预检此次请求。true:发送检查请求,不会创建实例。检查项包括是否填写了必需参数,请求格式,业务限制等。如果检查不通过,则返回对应错误码;如果检查通过,则返回 RequestId。false:发送正常请求,通过检查后直接创建实例。 + // 默认为 false。 DryRun *bool `json:"DryRun,omitnil,omitempty" name:"DryRun"` // 实例引擎类型,默认为"InnoDB",支持值包括:"InnoDB","RocksDB"。 @@ -3471,6 +3735,17 @@ type CreateDBInstanceRequest struct { // 指定实例的IP列表。仅支持主实例指定,按实例顺序,不足则按未指定处理。 Vips []*string `json:"Vips,omitnil,omitempty" name:"Vips"` + + // 集群版实例的数据保护空间大小,单位 GB,设置范围1 - 10。 + DataProtectVolume *int64 `json:"DataProtectVolume,omitnil,omitempty" name:"DataProtectVolume"` + + // 集群版节点拓扑配置。 + // 说明:若购买的是集群版实例,此参数为必填,需设置集群版实例的 RW 和 RO 节点拓扑,RO 节点范围是1 - 5个,请至少设置1个 RO 节点。 + ClusterTopology *ClusterTopology `json:"ClusterTopology,omitnil,omitempty" name:"ClusterTopology"` + + // 磁盘类型,单节点(云盘版)或者集群版实例可以指定此参数。CLOUD_SSD 表示 SSD 云硬盘,CLOUD_HSSD 表示增强型 SSD 云硬盘。 + // 说明:单节点(云盘版)、集群版实例硬盘类型所支持的地域略有不同,具体支持情况请参考 [地域和可用区](https://cloud.tencent.com/document/product/236/8458)。 + DiskType *string `json:"DiskType,omitnil,omitempty" name:"DiskType"` } func (r *CreateDBInstanceRequest) ToJsonString() string { @@ -3523,6 +3798,9 @@ func (r *CreateDBInstanceRequest) FromJsonString(s string) error { delete(f, "DryRun") delete(f, "EngineType") delete(f, "Vips") + delete(f, "DataProtectVolume") + delete(f, "ClusterTopology") + delete(f, "DiskType") if len(f) > 0 { return tcerr.NewTencentCloudSDKError("ClientError.BuildRequestError", "CreateDBInstanceRequest has unknown keys!", "") } @@ -3712,16 +3990,16 @@ func (r *CreateDeployGroupResponse) FromJsonString(s string) error { // Predefined struct for user type CreateParamTemplateRequestParams struct { - // 参数模板名称。 + // 参数模板名称。支持输入最大60个字符。 Name *string `json:"Name,omitnil,omitempty" name:"Name"` // 参数模板描述。 Description *string `json:"Description,omitnil,omitempty" name:"Description"` - // MySQL 版本号。 + // MySQL 版本号。可选值:5.6、5.7、8.0。 EngineVersion *string `json:"EngineVersion,omitnil,omitempty" name:"EngineVersion"` - // 源参数模板 ID。 + // 源参数模板 ID。可通过 [DescribeParamTemplates](https://cloud.tencent.com/document/api/236/32659) 接口获取。 TemplateId *int64 `json:"TemplateId,omitnil,omitempty" name:"TemplateId"` // 参数列表。 @@ -3731,22 +4009,23 @@ type CreateParamTemplateRequestParams struct { TemplateType *string `json:"TemplateType,omitnil,omitempty" name:"TemplateType"` // 实例引擎类型,默认为"InnoDB",支持值包括:"InnoDB","RocksDB"。 + // 说明:数据库版本 MySQL 5.7、MySQL 8.0才支持 RocksDB。 EngineType *string `json:"EngineType,omitnil,omitempty" name:"EngineType"` } type CreateParamTemplateRequest struct { *tchttp.BaseRequest - // 参数模板名称。 + // 参数模板名称。支持输入最大60个字符。 Name *string `json:"Name,omitnil,omitempty" name:"Name"` // 参数模板描述。 Description *string `json:"Description,omitnil,omitempty" name:"Description"` - // MySQL 版本号。 + // MySQL 版本号。可选值:5.6、5.7、8.0。 EngineVersion *string `json:"EngineVersion,omitnil,omitempty" name:"EngineVersion"` - // 源参数模板 ID。 + // 源参数模板 ID。可通过 [DescribeParamTemplates](https://cloud.tencent.com/document/api/236/32659) 接口获取。 TemplateId *int64 `json:"TemplateId,omitnil,omitempty" name:"TemplateId"` // 参数列表。 @@ -3756,6 +4035,7 @@ type CreateParamTemplateRequest struct { TemplateType *string `json:"TemplateType,omitnil,omitempty" name:"TemplateType"` // 实例引擎类型,默认为"InnoDB",支持值包括:"InnoDB","RocksDB"。 + // 说明:数据库版本 MySQL 5.7、MySQL 8.0才支持 RocksDB。 EngineType *string `json:"EngineType,omitnil,omitempty" name:"EngineType"` } @@ -3889,25 +4169,81 @@ func (r *CreateRoInstanceIpResponse) FromJsonString(s string) error { return json.Unmarshal([]byte(s), &r) } -type CustomConfig struct { - // 设备 - // 注意:此字段可能返回 null,表示取不到有效值。 - Device *string `json:"Device,omitnil,omitempty" name:"Device"` +// Predefined struct for user +type CreateRotationPasswordRequestParams struct { + // 实例 ID,格式如:cdb-c1nl9rpv,与云数据库控制台页面中显示的实例 ID 相同。 + InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` - // 类型 - // 注意:此字段可能返回 null,表示取不到有效值。 + // 当前需开启密码轮转的账号信息,包含账户名与主机名 + Accounts []*Account `json:"Accounts,omitnil,omitempty" name:"Accounts"` +} + +type CreateRotationPasswordRequest struct { + *tchttp.BaseRequest + + // 实例 ID,格式如:cdb-c1nl9rpv,与云数据库控制台页面中显示的实例 ID 相同。 + InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` + + // 当前需开启密码轮转的账号信息,包含账户名与主机名 + Accounts []*Account `json:"Accounts,omitnil,omitempty" name:"Accounts"` +} + +func (r *CreateRotationPasswordRequest) ToJsonString() string { + b, _ := json.Marshal(r) + return string(b) +} + +// FromJsonString It is highly **NOT** recommended to use this function +// because it has no param check, nor strict type check +func (r *CreateRotationPasswordRequest) FromJsonString(s string) error { + f := make(map[string]interface{}) + if err := json.Unmarshal([]byte(s), &f); err != nil { + return err + } + delete(f, "InstanceId") + delete(f, "Accounts") + if len(f) > 0 { + return tcerr.NewTencentCloudSDKError("ClientError.BuildRequestError", "CreateRotationPasswordRequest has unknown keys!", "") + } + return json.Unmarshal([]byte(s), &r) +} + +// Predefined struct for user +type CreateRotationPasswordResponseParams struct { + // 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 + RequestId *string `json:"RequestId,omitnil,omitempty" name:"RequestId"` +} + +type CreateRotationPasswordResponse struct { + *tchttp.BaseResponse + Response *CreateRotationPasswordResponseParams `json:"Response"` +} + +func (r *CreateRotationPasswordResponse) ToJsonString() string { + b, _ := json.Marshal(r) + return string(b) +} + +// FromJsonString It is highly **NOT** recommended to use this function +// because it has no param check, nor strict type check +func (r *CreateRotationPasswordResponse) FromJsonString(s string) error { + return json.Unmarshal([]byte(s), &r) +} + +type CustomConfig struct { + // 设备 + Device *string `json:"Device,omitnil,omitempty" name:"Device"` + + // 类型 Type *string `json:"Type,omitnil,omitempty" name:"Type"` // 设备类型 - // 注意:此字段可能返回 null,表示取不到有效值。 DeviceType *string `json:"DeviceType,omitnil,omitempty" name:"DeviceType"` - // 内存 - // 注意:此字段可能返回 null,表示取不到有效值。 + // 内存,单位为MB Memory *uint64 `json:"Memory,omitnil,omitempty" name:"Memory"` // 核数 - // 注意:此字段可能返回 null,表示取不到有效值。 Cpu *uint64 `json:"Cpu,omitnil,omitempty" name:"Cpu"` } @@ -4001,20 +4337,20 @@ func (r *DeleteAccountsResponse) FromJsonString(s string) error { // Predefined struct for user type DeleteAuditLogFileRequestParams struct { - // 审计日志文件名称。 + // 审计日志文件名称。可通过 [DescribeAuditLogFiles](https://cloud.tencent.com/document/api/236/45454) 接口获取。 FileName *string `json:"FileName,omitnil,omitempty" name:"FileName"` - // 实例 ID。 + // 实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` } type DeleteAuditLogFileRequest struct { *tchttp.BaseRequest - // 审计日志文件名称。 + // 审计日志文件名称。可通过 [DescribeAuditLogFiles](https://cloud.tencent.com/document/api/236/45454) 接口获取。 FileName *string `json:"FileName,omitnil,omitempty" name:"FileName"` - // 实例 ID。 + // 实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` } @@ -4177,14 +4513,14 @@ func (r *DeleteAuditRuleResponse) FromJsonString(s string) error { // Predefined struct for user type DeleteAuditRuleTemplatesRequestParams struct { - // 审计规则模板ID。 + // 审计规则模板 ID,可通过 [DescribeAuditRuleTemplates](https://cloud.tencent.com/document/api/236/101811) 接口获取,单次允许最多删除5个规则模板。 RuleTemplateIds []*string `json:"RuleTemplateIds,omitnil,omitempty" name:"RuleTemplateIds"` } type DeleteAuditRuleTemplatesRequest struct { *tchttp.BaseRequest - // 审计规则模板ID。 + // 审计规则模板 ID,可通过 [DescribeAuditRuleTemplates](https://cloud.tencent.com/document/api/236/101811) 接口获取,单次允许最多删除5个规则模板。 RuleTemplateIds []*string `json:"RuleTemplateIds,omitnil,omitempty" name:"RuleTemplateIds"` } @@ -4234,7 +4570,7 @@ type DeleteBackupRequestParams struct { // 实例 ID,格式如:cdb-c1nl9rpv。与云数据库控制台页面中显示的实例 ID 相同。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` - // 备份任务 ID。该任务 ID 为 [创建云数据库备份](https://cloud.tencent.com/document/api/236/15844) 接口返回的任务 ID。 + // 备份任务 ID。您可通过 [查询数据备份文件列表](https://cloud.tencent.com/document/api/236/15842) 来获取目标备份任务 ID。 BackupId *int64 `json:"BackupId,omitnil,omitempty" name:"BackupId"` } @@ -4244,7 +4580,7 @@ type DeleteBackupRequest struct { // 实例 ID,格式如:cdb-c1nl9rpv。与云数据库控制台页面中显示的实例 ID 相同。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` - // 备份任务 ID。该任务 ID 为 [创建云数据库备份](https://cloud.tencent.com/document/api/236/15844) 接口返回的任务 ID。 + // 备份任务 ID。您可通过 [查询数据备份文件列表](https://cloud.tencent.com/document/api/236/15842) 来获取目标备份任务 ID。 BackupId *int64 `json:"BackupId,omitnil,omitempty" name:"BackupId"` } @@ -4407,14 +4743,14 @@ func (r *DeleteDeployGroupsResponse) FromJsonString(s string) error { // Predefined struct for user type DeleteParamTemplateRequestParams struct { - // 参数模板ID。 + // 参数模板 ID。可通过 [DescribeParamTemplates](https://cloud.tencent.com/document/api/236/32659) 接口获取。 TemplateId *int64 `json:"TemplateId,omitnil,omitempty" name:"TemplateId"` } type DeleteParamTemplateRequest struct { *tchttp.BaseRequest - // 参数模板ID。 + // 参数模板 ID。可通过 [DescribeParamTemplates](https://cloud.tencent.com/document/api/236/32659) 接口获取。 TemplateId *int64 `json:"TemplateId,omitnil,omitempty" name:"TemplateId"` } @@ -4459,6 +4795,88 @@ func (r *DeleteParamTemplateResponse) FromJsonString(s string) error { return json.Unmarshal([]byte(s), &r) } +// Predefined struct for user +type DeleteRotationPasswordRequestParams struct { + // 实例 ID,格式如:cdb-c1nl9rpv,与云数据库控制台页面中显示的实例 ID 相同 + InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` + + // 关闭密码轮转的实例账户名,例如root + User *string `json:"User,omitnil,omitempty" name:"User"` + + // 关闭密码轮转的实例账户域名,例如% + Host *string `json:"Host,omitnil,omitempty" name:"Host"` + + // 关闭密码轮转后实例账户的最新密码 + Password *string `json:"Password,omitnil,omitempty" name:"Password"` + + // 传入不为空则对密码进行了加密处理 + EncryptMethod *string `json:"EncryptMethod,omitnil,omitempty" name:"EncryptMethod"` +} + +type DeleteRotationPasswordRequest struct { + *tchttp.BaseRequest + + // 实例 ID,格式如:cdb-c1nl9rpv,与云数据库控制台页面中显示的实例 ID 相同 + InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` + + // 关闭密码轮转的实例账户名,例如root + User *string `json:"User,omitnil,omitempty" name:"User"` + + // 关闭密码轮转的实例账户域名,例如% + Host *string `json:"Host,omitnil,omitempty" name:"Host"` + + // 关闭密码轮转后实例账户的最新密码 + Password *string `json:"Password,omitnil,omitempty" name:"Password"` + + // 传入不为空则对密码进行了加密处理 + EncryptMethod *string `json:"EncryptMethod,omitnil,omitempty" name:"EncryptMethod"` +} + +func (r *DeleteRotationPasswordRequest) ToJsonString() string { + b, _ := json.Marshal(r) + return string(b) +} + +// FromJsonString It is highly **NOT** recommended to use this function +// because it has no param check, nor strict type check +func (r *DeleteRotationPasswordRequest) FromJsonString(s string) error { + f := make(map[string]interface{}) + if err := json.Unmarshal([]byte(s), &f); err != nil { + return err + } + delete(f, "InstanceId") + delete(f, "User") + delete(f, "Host") + delete(f, "Password") + delete(f, "EncryptMethod") + if len(f) > 0 { + return tcerr.NewTencentCloudSDKError("ClientError.BuildRequestError", "DeleteRotationPasswordRequest has unknown keys!", "") + } + return json.Unmarshal([]byte(s), &r) +} + +// Predefined struct for user +type DeleteRotationPasswordResponseParams struct { + // 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 + RequestId *string `json:"RequestId,omitnil,omitempty" name:"RequestId"` +} + +type DeleteRotationPasswordResponse struct { + *tchttp.BaseResponse + Response *DeleteRotationPasswordResponseParams `json:"Response"` +} + +func (r *DeleteRotationPasswordResponse) ToJsonString() string { + b, _ := json.Marshal(r) + return string(b) +} + +// FromJsonString It is highly **NOT** recommended to use this function +// because it has no param check, nor strict type check +func (r *DeleteRotationPasswordResponse) FromJsonString(s string) error { + return json.Unmarshal([]byte(s), &r) +} + // Predefined struct for user type DeleteTimeWindowRequestParams struct { // 实例 ID,格式如:cdb-c1nl9rpv 或者 cdbro-c1nl9rpv,与云数据库控制台页面中显示的实例 ID 相同。 @@ -4527,18 +4945,15 @@ type DeployGroupInfo struct { Quota *int64 `json:"Quota,omitnil,omitempty" name:"Quota"` // 置放群组亲和性策略,目前仅支持策略1,即在物理机纬度打散实例的分布。 - // 注意:此字段可能返回 null,表示取不到有效值。 Affinity *string `json:"Affinity,omitnil,omitempty" name:"Affinity"` // 置放群组亲和性策略1中,同台物理机上同个置放群组实例的限制个数。 - // 注意:此字段可能返回 null,表示取不到有效值。 LimitNum *int64 `json:"LimitNum,omitnil,omitempty" name:"LimitNum"` // 置放群组详细信息。 Description *string `json:"Description,omitnil,omitempty" name:"Description"` // 置放群组物理机型属性。 - // 注意:此字段可能返回 null,表示取不到有效值。 DevClass *string `json:"DevClass,omitnil,omitempty" name:"DevClass"` } @@ -4547,10 +4962,10 @@ type DescribeAccountPrivilegesRequestParams struct { // 实例 ID,格式如:cdb-c1nl9rpv,与云数据库控制台页面中显示的实例 ID 相同。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` - // 数据库的账号名称。 + // 数据库的账号名称。可通过 [DescribeAccounts](https://cloud.tencent.com/document/api/236/17499) 接口获取。 User *string `json:"User,omitnil,omitempty" name:"User"` - // 数据库的账号域名。 + // 数据库的账号域名。可通过 [DescribeAccounts](https://cloud.tencent.com/document/api/236/17499) 接口获取。 Host *string `json:"Host,omitnil,omitempty" name:"Host"` } @@ -4560,10 +4975,10 @@ type DescribeAccountPrivilegesRequest struct { // 实例 ID,格式如:cdb-c1nl9rpv,与云数据库控制台页面中显示的实例 ID 相同。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` - // 数据库的账号名称。 + // 数据库的账号名称。可通过 [DescribeAccounts](https://cloud.tencent.com/document/api/236/17499) 接口获取。 User *string `json:"User,omitnil,omitempty" name:"User"` - // 数据库的账号域名。 + // 数据库的账号域名。可通过 [DescribeAccounts](https://cloud.tencent.com/document/api/236/17499) 接口获取。 Host *string `json:"Host,omitnil,omitempty" name:"Host"` } @@ -4741,11 +5156,9 @@ func (r *DescribeAsyncRequestInfoRequest) FromJsonString(s string) error { // Predefined struct for user type DescribeAsyncRequestInfoResponseParams struct { // 任务执行结果。可能的取值:INITIAL - 初始化,RUNNING - 运行中,SUCCESS - 执行成功,FAILED - 执行失败,KILLED - 已终止,REMOVED - 已删除,PAUSED - 终止中。 - // 注意:此字段可能返回 null,表示取不到有效值。 Status *string `json:"Status,omitnil,omitempty" name:"Status"` // 任务执行信息描述。 - // 注意:此字段可能返回 null,表示取不到有效值。 Info *string `json:"Info,omitnil,omitempty" name:"Info"` // 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 @@ -4803,7 +5216,6 @@ func (r *DescribeAuditConfigRequest) FromJsonString(s string) error { // Predefined struct for user type DescribeAuditConfigResponseParams struct { // 审计日志保存时长。目前支持的值包括:[0,7,30,180,365,1095,1825]。 - // 注意:此字段可能返回 null,表示取不到有效值。 LogExpireDay *int64 `json:"LogExpireDay,omitnil,omitempty" name:"LogExpireDay"` // 审计日志存储类型。目前支持的值包括:"storage" - 存储型。 @@ -4813,7 +5225,6 @@ type DescribeAuditConfigResponseParams struct { IsClosing *string `json:"IsClosing,omitnil,omitempty" name:"IsClosing"` // 审计服务开通时间。 - // 注意:此字段可能返回 null,表示取不到有效值。 CreateTime *string `json:"CreateTime,omitnil,omitempty" name:"CreateTime"` // 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 @@ -4930,7 +5341,7 @@ type DescribeAuditLogFilesRequestParams struct { // 实例 ID,格式如:cdb-c1nl9rpv 或者 cdbro-c1nl9rpv,与云数据库控制台页面中显示的实例 ID 相同。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` - // 分页大小参数。默认值为 20,最小值为 1,最大值为 100。 + // 分页大小参数。默认值为20,最小值为1,最大值为300。 Limit *int64 `json:"Limit,omitnil,omitempty" name:"Limit"` // 分页偏移量。 @@ -4946,7 +5357,7 @@ type DescribeAuditLogFilesRequest struct { // 实例 ID,格式如:cdb-c1nl9rpv 或者 cdbro-c1nl9rpv,与云数据库控制台页面中显示的实例 ID 相同。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` - // 分页大小参数。默认值为 20,最小值为 1,最大值为 100。 + // 分页大小参数。默认值为20,最小值为1,最大值为300。 Limit *int64 `json:"Limit,omitnil,omitempty" name:"Limit"` // 分页偏移量。 @@ -4984,7 +5395,6 @@ type DescribeAuditLogFilesResponseParams struct { TotalCount *int64 `json:"TotalCount,omitnil,omitempty" name:"TotalCount"` // 审计日志文件详情。 - // 注意:此字段可能返回 null,表示取不到有效值。 Items []*AuditLogFile `json:"Items,omitnil,omitempty" name:"Items"` // 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 @@ -5009,25 +5419,25 @@ func (r *DescribeAuditLogFilesResponse) FromJsonString(s string) error { // Predefined struct for user type DescribeAuditLogsRequestParams struct { - // 实例 ID。 + // 实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` - // 开始时间。 + // 开始时间(建议开始到结束时间区间最大7天)。 StartTime *string `json:"StartTime,omitnil,omitempty" name:"StartTime"` - // 结束时间。 + // 结束时间(建议开始到结束时间区间最大7天)。 EndTime *string `json:"EndTime,omitnil,omitempty" name:"EndTime"` // 分页参数,单次返回的数据条数。默认值为100,最大值为100。 Limit *int64 `json:"Limit,omitnil,omitempty" name:"Limit"` - // 分页偏移量。 + // 日志偏移量,最多支持偏移查询65535条日志。可填写范围:0 - 65535。 Offset *int64 `json:"Offset,omitnil,omitempty" name:"Offset"` - // 排序方式。支持值包括:"ASC" - 升序,"DESC" - 降序。 + // 排序方式。支持值包括:"ASC" - 升序,"DESC" - 降序,默认降序排序。 Order *string `json:"Order,omitnil,omitempty" name:"Order"` - // 排序字段。支持值包括: + // 排序字段。支持值包括(默认按照时间戳排序): // "timestamp" - 时间戳; // "affectRows" - 影响行数; // "execTime" - 执行时间。 @@ -5040,25 +5450,25 @@ type DescribeAuditLogsRequestParams struct { type DescribeAuditLogsRequest struct { *tchttp.BaseRequest - // 实例 ID。 + // 实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` - // 开始时间。 + // 开始时间(建议开始到结束时间区间最大7天)。 StartTime *string `json:"StartTime,omitnil,omitempty" name:"StartTime"` - // 结束时间。 + // 结束时间(建议开始到结束时间区间最大7天)。 EndTime *string `json:"EndTime,omitnil,omitempty" name:"EndTime"` // 分页参数,单次返回的数据条数。默认值为100,最大值为100。 Limit *int64 `json:"Limit,omitnil,omitempty" name:"Limit"` - // 分页偏移量。 + // 日志偏移量,最多支持偏移查询65535条日志。可填写范围:0 - 65535。 Offset *int64 `json:"Offset,omitnil,omitempty" name:"Offset"` - // 排序方式。支持值包括:"ASC" - 升序,"DESC" - 降序。 + // 排序方式。支持值包括:"ASC" - 升序,"DESC" - 降序,默认降序排序。 Order *string `json:"Order,omitnil,omitempty" name:"Order"` - // 排序字段。支持值包括: + // 排序字段。支持值包括(默认按照时间戳排序): // "timestamp" - 时间戳; // "affectRows" - 影响行数; // "execTime" - 执行时间。 @@ -5205,7 +5615,6 @@ type DescribeAuditPoliciesResponseParams struct { TotalCount *int64 `json:"TotalCount,omitnil,omitempty" name:"TotalCount"` // 审计策略详情。 - // 注意:此字段可能返回 null,表示取不到有效值。 Items []*AuditPolicy `json:"Items,omitnil,omitempty" name:"Items"` // 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 @@ -5230,7 +5639,7 @@ func (r *DescribeAuditPoliciesResponse) FromJsonString(s string) error { // Predefined struct for user type DescribeAuditRuleTemplateModifyHistoryRequestParams struct { - // 模板ID + // 审计规则模板ID,可通过[DescribeAuditRuleTemplates](https://cloud.tencent.com/document/api/236/101811)接口获取。 RuleTemplateIds []*string `json:"RuleTemplateIds,omitnil,omitempty" name:"RuleTemplateIds"` // 查询范围的开始时间。 @@ -5239,20 +5648,20 @@ type DescribeAuditRuleTemplateModifyHistoryRequestParams struct { // 查询范围的结束时间。 EndTime *string `json:"EndTime,omitnil,omitempty" name:"EndTime"` - // 返回条数。 + // 返回条数,默认值-20,最大值-1000。 Limit *uint64 `json:"Limit,omitnil,omitempty" name:"Limit"` // 偏移量。 Offset *uint64 `json:"Offset,omitnil,omitempty" name:"Offset"` - // 排序方式。DESC-按修改时间倒排,ASC-正序。 + // 排序方式,DESC-按修改时间倒排,ASC-正序,默认:DESC。 Order *string `json:"Order,omitnil,omitempty" name:"Order"` } type DescribeAuditRuleTemplateModifyHistoryRequest struct { *tchttp.BaseRequest - // 模板ID + // 审计规则模板ID,可通过[DescribeAuditRuleTemplates](https://cloud.tencent.com/document/api/236/101811)接口获取。 RuleTemplateIds []*string `json:"RuleTemplateIds,omitnil,omitempty" name:"RuleTemplateIds"` // 查询范围的开始时间。 @@ -5261,13 +5670,13 @@ type DescribeAuditRuleTemplateModifyHistoryRequest struct { // 查询范围的结束时间。 EndTime *string `json:"EndTime,omitnil,omitempty" name:"EndTime"` - // 返回条数。 + // 返回条数,默认值-20,最大值-1000。 Limit *uint64 `json:"Limit,omitnil,omitempty" name:"Limit"` // 偏移量。 Offset *uint64 `json:"Offset,omitnil,omitempty" name:"Offset"` - // 排序方式。DESC-按修改时间倒排,ASC-正序。 + // 排序方式,DESC-按修改时间倒排,ASC-正序,默认:DESC。 Order *string `json:"Order,omitnil,omitempty" name:"Order"` } @@ -5298,11 +5707,9 @@ func (r *DescribeAuditRuleTemplateModifyHistoryRequest) FromJsonString(s string) // Predefined struct for user type DescribeAuditRuleTemplateModifyHistoryResponseParams struct { // 总的条数。 - // 注意:此字段可能返回 null,表示取不到有效值。 TotalCount *int64 `json:"TotalCount,omitnil,omitempty" name:"TotalCount"` // 变更详情。 - // 注意:此字段可能返回 null,表示取不到有效值。 Items []*RuleTemplateRecordInfo `json:"Items,omitnil,omitempty" name:"Items"` // 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 @@ -5333,7 +5740,7 @@ type DescribeAuditRuleTemplatesRequestParams struct { // 规则模板名称。 RuleTemplateNames []*string `json:"RuleTemplateNames,omitnil,omitempty" name:"RuleTemplateNames"` - // 单次请求返回的数量。默认值20。 + // 单次请求返回的数量。默认值20,最大值为1000。 Limit *uint64 `json:"Limit,omitnil,omitempty" name:"Limit"` // 偏移量,默认值为 0。 @@ -5355,7 +5762,7 @@ type DescribeAuditRuleTemplatesRequest struct { // 规则模板名称。 RuleTemplateNames []*string `json:"RuleTemplateNames,omitnil,omitempty" name:"RuleTemplateNames"` - // 单次请求返回的数量。默认值20。 + // 单次请求返回的数量。默认值20,最大值为1000。 Limit *uint64 `json:"Limit,omitnil,omitempty" name:"Limit"` // 偏移量,默认值为 0。 @@ -5398,7 +5805,6 @@ type DescribeAuditRuleTemplatesResponseParams struct { TotalCount *uint64 `json:"TotalCount,omitnil,omitempty" name:"TotalCount"` // 规则模板详细信息列表。 - // 注意:此字段可能返回 null,表示取不到有效值。 Items []*AuditRuleTemplateInfo `json:"Items,omitnil,omitempty" name:"Items"` // 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 @@ -5538,9 +5944,13 @@ func (r *DescribeBackupConfigRequest) FromJsonString(s string) error { // Predefined struct for user type DescribeBackupConfigResponseParams struct { // 自动备份开始的最早时间点,单位为时刻。例如,2 - 凌晨 2:00。(该字段已废弃,建议使用 BackupTimeWindow 字段) + // + // Deprecated: StartTimeMin is deprecated. StartTimeMin *int64 `json:"StartTimeMin,omitnil,omitempty" name:"StartTimeMin"` // 自动备份开始的最晚时间点,单位为时刻。例如,6 - 凌晨 6:00。(该字段已废弃,建议使用 BackupTimeWindow 字段) + // + // Deprecated: StartTimeMax is deprecated. StartTimeMax *int64 `json:"StartTimeMax,omitnil,omitempty" name:"StartTimeMax"` // 备份文件保留时间,单位为天。 @@ -5616,26 +6026,26 @@ func (r *DescribeBackupConfigResponse) FromJsonString(s string) error { // Predefined struct for user type DescribeBackupDecryptionKeyRequestParams struct { - // 实例ID,格式如:cdb-XXXX。与云数据库控制台页面中显示的实例 ID 相同。 + // 实例 ID,格式如:cdb-fybaegd8。与云数据库控制台页面中显示的实例 ID 相同。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` - // 实例的备份ID,可通过DescribeBackups接口查询备份的ID。 + // 实例的备份 ID,可通过 [DescribeBackups](https://cloud.tencent.com/document/api/236/15842) 接口查询备份的 ID。 BackupId *int64 `json:"BackupId,omitnil,omitempty" name:"BackupId"` - // 备份类型 data: 数据备份 binlog:日志备份,默认为data + // 备份类型。data-数据备份,binlog-日志备份,默认为 data。 BackupType *string `json:"BackupType,omitnil,omitempty" name:"BackupType"` } type DescribeBackupDecryptionKeyRequest struct { *tchttp.BaseRequest - // 实例ID,格式如:cdb-XXXX。与云数据库控制台页面中显示的实例 ID 相同。 + // 实例 ID,格式如:cdb-fybaegd8。与云数据库控制台页面中显示的实例 ID 相同。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` - // 实例的备份ID,可通过DescribeBackups接口查询备份的ID。 + // 实例的备份 ID,可通过 [DescribeBackups](https://cloud.tencent.com/document/api/236/15842) 接口查询备份的 ID。 BackupId *int64 `json:"BackupId,omitnil,omitempty" name:"BackupId"` - // 备份类型 data: 数据备份 binlog:日志备份,默认为data + // 备份类型。data-数据备份,binlog-日志备份,默认为 data。 BackupType *string `json:"BackupType,omitnil,omitempty" name:"BackupType"` } @@ -5810,14 +6220,14 @@ func (r *DescribeBackupEncryptionStatusResponse) FromJsonString(s string) error // Predefined struct for user type DescribeBackupOverviewRequestParams struct { - // 需要查询的云数据库产品类型,目前仅支持 "mysql"。 + // 需要查询备份概览的云数据库产品类型。可取值为:mysql 指双节点/三节点的高可用实例,mysql-basic 指单节点云盘版实例,mysql-cluster 指云盘版(原集群版)实例。 Product *string `json:"Product,omitnil,omitempty" name:"Product"` } type DescribeBackupOverviewRequest struct { *tchttp.BaseRequest - // 需要查询的云数据库产品类型,目前仅支持 "mysql"。 + // 需要查询备份概览的云数据库产品类型。可取值为:mysql 指双节点/三节点的高可用实例,mysql-basic 指单节点云盘版实例,mysql-cluster 指云盘版(原集群版)实例。 Product *string `json:"Product,omitnil,omitempty" name:"Product"` } @@ -5855,15 +6265,12 @@ type DescribeBackupOverviewResponseParams struct { FreeVolume *int64 `json:"FreeVolume,omitnil,omitempty" name:"FreeVolume"` // 用户在当前地域的异地备份总容量。 - // 注意:此字段可能返回 null,表示取不到有效值。 RemoteBackupVolume *int64 `json:"RemoteBackupVolume,omitnil,omitempty" name:"RemoteBackupVolume"` // 归档备份容量,包含数据备份以及日志备份。 - // 注意:此字段可能返回 null,表示取不到有效值。 BackupArchiveVolume *int64 `json:"BackupArchiveVolume,omitnil,omitempty" name:"BackupArchiveVolume"` // 标准存储备份容量,包含数据备份以及日志备份。 - // 注意:此字段可能返回 null,表示取不到有效值。 BackupStandbyVolume *int64 `json:"BackupStandbyVolume,omitnil,omitempty" name:"BackupStandbyVolume"` // 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 @@ -5888,7 +6295,7 @@ func (r *DescribeBackupOverviewResponse) FromJsonString(s string) error { // Predefined struct for user type DescribeBackupSummariesRequestParams struct { - // 需要查询的云数据库产品类型,目前仅支持 "mysql"。 + // 需要查询备份实时统计的云数据库产品类型。可取值为:mysql 指双节点/三节点的高可用实例,mysql-basic 指单节点云盘版实例,mysql-cluster 指云盘版(原集群版)实例。 Product *string `json:"Product,omitnil,omitempty" name:"Product"` // 分页查询数据的偏移量,默认为0。 @@ -5907,7 +6314,7 @@ type DescribeBackupSummariesRequestParams struct { type DescribeBackupSummariesRequest struct { *tchttp.BaseRequest - // 需要查询的云数据库产品类型,目前仅支持 "mysql"。 + // 需要查询备份实时统计的云数据库产品类型。可取值为:mysql 指双节点/三节点的高可用实例,mysql-basic 指单节点云盘版实例,mysql-cluster 指云盘版(原集群版)实例。 Product *string `json:"Product,omitnil,omitempty" name:"Product"` // 分页查询数据的偏移量,默认为0。 @@ -5976,26 +6383,26 @@ func (r *DescribeBackupSummariesResponse) FromJsonString(s string) error { // Predefined struct for user type DescribeBackupsRequestParams struct { - // 实例ID,格式如:cdb-c1nl9rpv。与云数据库控制台页面中显示的实例 ID 相同。 + // 实例 ID,格式如:cdb-c1nl9rpv。与云数据库控制台页面中显示的实例 ID 相同。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` // 偏移量,最小值为0。 Offset *int64 `json:"Offset,omitnil,omitempty" name:"Offset"` - // 分页大小,默认值为20,最小值为1,最大值为100。 + // 分页大小,默认值为20,最小值为1,最大值为1000。 Limit *int64 `json:"Limit,omitnil,omitempty" name:"Limit"` } type DescribeBackupsRequest struct { *tchttp.BaseRequest - // 实例ID,格式如:cdb-c1nl9rpv。与云数据库控制台页面中显示的实例 ID 相同。 + // 实例 ID,格式如:cdb-c1nl9rpv。与云数据库控制台页面中显示的实例 ID 相同。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` // 偏移量,最小值为0。 Offset *int64 `json:"Offset,omitnil,omitempty" name:"Offset"` - // 分页大小,默认值为20,最小值为1,最大值为100。 + // 分页大小,默认值为20,最小值为1,最大值为1000。 Limit *int64 `json:"Limit,omitnil,omitempty" name:"Limit"` } @@ -6050,14 +6457,14 @@ func (r *DescribeBackupsResponse) FromJsonString(s string) error { // Predefined struct for user type DescribeBinlogBackupOverviewRequestParams struct { - // 需要查询的云数据库产品类型,目前仅支持 "mysql"。 + // 需要查询日志备份概览的云数据库产品类型。可取值为:mysql 指双节点/三节点的高可用实例,mysql-basic 指单节点云盘版实例,mysql-cluster 指云盘版(原集群版)实例。 Product *string `json:"Product,omitnil,omitempty" name:"Product"` } type DescribeBinlogBackupOverviewRequest struct { *tchttp.BaseRequest - // 需要查询的云数据库产品类型,目前仅支持 "mysql"。 + // 需要查询日志备份概览的云数据库产品类型。可取值为:mysql 指双节点/三节点的高可用实例,mysql-basic 指单节点云盘版实例,mysql-cluster 指云盘版(原集群版)实例。 Product *string `json:"Product,omitnil,omitempty" name:"Product"` } @@ -6134,7 +6541,7 @@ type DescribeBinlogsRequestParams struct { // 偏移量,最小值为0。 Offset *int64 `json:"Offset,omitnil,omitempty" name:"Offset"` - // 分页大小,默认值为20,最小值为1,最大值为100。 + // 分页大小,默认值为20,最小值为1,最大值为1000。 Limit *int64 `json:"Limit,omitnil,omitempty" name:"Limit"` // binlog最早开始时间,时间格式:2016-03-17 02:10:37 @@ -6156,7 +6563,7 @@ type DescribeBinlogsRequest struct { // 偏移量,最小值为0。 Offset *int64 `json:"Offset,omitnil,omitempty" name:"Offset"` - // 分页大小,默认值为20,最小值为1,最大值为100。 + // 分页大小,默认值为20,最小值为1,最大值为1000。 Limit *int64 `json:"Limit,omitnil,omitempty" name:"Limit"` // binlog最早开始时间,时间格式:2016-03-17 02:10:37 @@ -6221,22 +6628,95 @@ func (r *DescribeBinlogsResponse) FromJsonString(s string) error { return json.Unmarshal([]byte(s), &r) } +// Predefined struct for user +type DescribeCPUExpandStrategyInfoRequestParams struct { + // 实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 + InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` +} + +type DescribeCPUExpandStrategyInfoRequest struct { + *tchttp.BaseRequest + + // 实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 + InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` +} + +func (r *DescribeCPUExpandStrategyInfoRequest) ToJsonString() string { + b, _ := json.Marshal(r) + return string(b) +} + +// FromJsonString It is highly **NOT** recommended to use this function +// because it has no param check, nor strict type check +func (r *DescribeCPUExpandStrategyInfoRequest) FromJsonString(s string) error { + f := make(map[string]interface{}) + if err := json.Unmarshal([]byte(s), &f); err != nil { + return err + } + delete(f, "InstanceId") + if len(f) > 0 { + return tcerr.NewTencentCloudSDKError("ClientError.BuildRequestError", "DescribeCPUExpandStrategyInfoRequest has unknown keys!", "") + } + return json.Unmarshal([]byte(s), &r) +} + +// Predefined struct for user +type DescribeCPUExpandStrategyInfoResponseParams struct { + // 策略类型。输出值:auto、manual、timeInterval、period。 + // 说明:1. auto 表示自动扩容。2. manual 表示自定义扩容,扩容时间为立即生效。3. timeInterval 表示自定义扩容,扩容时间为按时间段。4. period 表示自定义扩容,扩容时间为按周期。5. 如果返回为 NULL 说明尚未开通弹性扩容策略。 + // 注意:此字段可能返回 null,表示取不到有效值。 + Type *string `json:"Type,omitnil,omitempty" name:"Type"` + + // 自定义扩容,且扩容时间为立即生效时的 CPU。Type 为 manual 时有效。 + // 注意:此字段可能返回 null,表示取不到有效值。 + ExpandCpu *int64 `json:"ExpandCpu,omitnil,omitempty" name:"ExpandCpu"` + + // 自动扩容策略。Type 为 auto 时有效。 + // 注意:此字段可能返回 null,表示取不到有效值。 + AutoStrategy *AutoStrategy `json:"AutoStrategy,omitnil,omitempty" name:"AutoStrategy"` + + // 按周期扩容策略。当 Type 为 period 时有效。 + PeriodStrategy *PeriodStrategy `json:"PeriodStrategy,omitnil,omitempty" name:"PeriodStrategy"` + + // 按时间段扩容策略。当 Type 为 timeInterval 时有效。 + TimeIntervalStrategy *TimeIntervalStrategy `json:"TimeIntervalStrategy,omitnil,omitempty" name:"TimeIntervalStrategy"` + + // 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 + RequestId *string `json:"RequestId,omitnil,omitempty" name:"RequestId"` +} + +type DescribeCPUExpandStrategyInfoResponse struct { + *tchttp.BaseResponse + Response *DescribeCPUExpandStrategyInfoResponseParams `json:"Response"` +} + +func (r *DescribeCPUExpandStrategyInfoResponse) ToJsonString() string { + b, _ := json.Marshal(r) + return string(b) +} + +// FromJsonString It is highly **NOT** recommended to use this function +// because it has no param check, nor strict type check +func (r *DescribeCPUExpandStrategyInfoResponse) FromJsonString(s string) error { + return json.Unmarshal([]byte(s), &r) +} + // Predefined struct for user type DescribeCdbProxyInfoRequestParams struct { - // 实例ID + // 实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` - // 代理组ID + // 代理组 ID。 ProxyGroupId *string `json:"ProxyGroupId,omitnil,omitempty" name:"ProxyGroupId"` } type DescribeCdbProxyInfoRequest struct { *tchttp.BaseRequest - // 实例ID + // 实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` - // 代理组ID + // 代理组 ID。 ProxyGroupId *string `json:"ProxyGroupId,omitnil,omitempty" name:"ProxyGroupId"` } @@ -6263,11 +6743,9 @@ func (r *DescribeCdbProxyInfoRequest) FromJsonString(s string) error { // Predefined struct for user type DescribeCdbProxyInfoResponseParams struct { // 代理组数量 - // 注意:此字段可能返回 null,表示取不到有效值。 Count *uint64 `json:"Count,omitnil,omitempty" name:"Count"` // 代理组信息 - // 注意:此字段可能返回 null,表示取不到有效值。 ProxyInfos []*ProxyGroupInfo `json:"ProxyInfos,omitnil,omitempty" name:"ProxyInfos"` // 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 @@ -6346,26 +6824,26 @@ func (r *DescribeCdbZoneConfigResponse) FromJsonString(s string) error { // Predefined struct for user type DescribeCloneListRequestParams struct { - // 查询指定源实例的克隆任务列表。 + // 查询指定源实例的克隆任务列表。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/api/236/15872) 接口获取实例 ID。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` // 分页查询时的偏移量,默认值为0。 Offset *int64 `json:"Offset,omitnil,omitempty" name:"Offset"` - // 分页查询时的每页条目数,默认值为20。 + // 分页查询时的每页条目数,默认值为20,建议最大取值100。 Limit *int64 `json:"Limit,omitnil,omitempty" name:"Limit"` } type DescribeCloneListRequest struct { *tchttp.BaseRequest - // 查询指定源实例的克隆任务列表。 + // 查询指定源实例的克隆任务列表。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/api/236/15872) 接口获取实例 ID。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` // 分页查询时的偏移量,默认值为0。 Offset *int64 `json:"Offset,omitnil,omitempty" name:"Offset"` - // 分页查询时的每页条目数,默认值为20。 + // 分页查询时的每页条目数,默认值为20,建议最大取值100。 Limit *int64 `json:"Limit,omitnil,omitempty" name:"Limit"` } @@ -6420,14 +6898,16 @@ func (r *DescribeCloneListResponse) FromJsonString(s string) error { // Predefined struct for user type DescribeClusterInfoRequestParams struct { - // 实例id。 + // 实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 + // 说明:仅能输入实例架构为云盘版的实例 ID,对应控制台实例配置显示为“云盘版(云盘)”的实例。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` } type DescribeClusterInfoRequest struct { *tchttp.BaseRequest - // 实例id。 + // 实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 + // 说明:仅能输入实例架构为云盘版的实例 ID,对应控制台实例配置显示为“云盘版(云盘)”的实例。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` } @@ -6455,13 +6935,13 @@ type DescribeClusterInfoResponseParams struct { // 实例名称。 ClusterName *string `json:"ClusterName,omitnil,omitempty" name:"ClusterName"` - // 集群读写地址信息。 + // 云盘版实例的读写地址信息。 ReadWriteAddress *AddressInfo `json:"ReadWriteAddress,omitnil,omitempty" name:"ReadWriteAddress"` - // 集群只读地址信息。 + // 云盘版实例的只读地址信息。 ReadOnlyAddress []*AddressInfo `json:"ReadOnlyAddress,omitnil,omitempty" name:"ReadOnlyAddress"` - // 集群节点列表信息。 + // 云盘版实例的节点列表信息。 NodeList []*ClusterNodeInfo `json:"NodeList,omitnil,omitempty" name:"NodeList"` // 只读空间保护阈值,单位GB @@ -6491,68 +6971,104 @@ func (r *DescribeClusterInfoResponse) FromJsonString(s string) error { } // Predefined struct for user -type DescribeCpuExpandStrategyRequestParams struct { - // 实例 ID 。 +type DescribeCpuExpandHistoryRequestParams struct { + // 实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` + + // 扩容策略,值包括:all,manual,auto + ExpandStrategy *string `json:"ExpandStrategy,omitnil,omitempty" name:"ExpandStrategy"` + + // 扩容状态,值包括:all,extend,reduce,extend_failed + Status *string `json:"Status,omitnil,omitempty" name:"Status"` + + // 查询的开始时间。只能查看30天内的扩容历史,格式为 Integer 的时间戳(秒级)。 + StartTime *int64 `json:"StartTime,omitnil,omitempty" name:"StartTime"` + + // 查询的结束时间。只能查看30天内的扩容历史,格式为 Integer 的时间戳(秒级)。 + EndTime *int64 `json:"EndTime,omitnil,omitempty" name:"EndTime"` + + // 分页入参 + Offset *uint64 `json:"Offset,omitnil,omitempty" name:"Offset"` + + // 分页入参 + Limit *uint64 `json:"Limit,omitnil,omitempty" name:"Limit"` } -type DescribeCpuExpandStrategyRequest struct { +type DescribeCpuExpandHistoryRequest struct { *tchttp.BaseRequest - // 实例 ID 。 + // 实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` + + // 扩容策略,值包括:all,manual,auto + ExpandStrategy *string `json:"ExpandStrategy,omitnil,omitempty" name:"ExpandStrategy"` + + // 扩容状态,值包括:all,extend,reduce,extend_failed + Status *string `json:"Status,omitnil,omitempty" name:"Status"` + + // 查询的开始时间。只能查看30天内的扩容历史,格式为 Integer 的时间戳(秒级)。 + StartTime *int64 `json:"StartTime,omitnil,omitempty" name:"StartTime"` + + // 查询的结束时间。只能查看30天内的扩容历史,格式为 Integer 的时间戳(秒级)。 + EndTime *int64 `json:"EndTime,omitnil,omitempty" name:"EndTime"` + + // 分页入参 + Offset *uint64 `json:"Offset,omitnil,omitempty" name:"Offset"` + + // 分页入参 + Limit *uint64 `json:"Limit,omitnil,omitempty" name:"Limit"` } -func (r *DescribeCpuExpandStrategyRequest) ToJsonString() string { +func (r *DescribeCpuExpandHistoryRequest) ToJsonString() string { b, _ := json.Marshal(r) return string(b) } // FromJsonString It is highly **NOT** recommended to use this function // because it has no param check, nor strict type check -func (r *DescribeCpuExpandStrategyRequest) FromJsonString(s string) error { +func (r *DescribeCpuExpandHistoryRequest) FromJsonString(s string) error { f := make(map[string]interface{}) if err := json.Unmarshal([]byte(s), &f); err != nil { return err } delete(f, "InstanceId") + delete(f, "ExpandStrategy") + delete(f, "Status") + delete(f, "StartTime") + delete(f, "EndTime") + delete(f, "Offset") + delete(f, "Limit") if len(f) > 0 { - return tcerr.NewTencentCloudSDKError("ClientError.BuildRequestError", "DescribeCpuExpandStrategyRequest has unknown keys!", "") + return tcerr.NewTencentCloudSDKError("ClientError.BuildRequestError", "DescribeCpuExpandHistoryRequest has unknown keys!", "") } return json.Unmarshal([]byte(s), &r) } // Predefined struct for user -type DescribeCpuExpandStrategyResponseParams struct { - // 策略类型。可选值 auto、manual。 - // 注意:此字段可能返回 null,表示取不到有效值。 - Type *string `json:"Type,omitnil,omitempty" name:"Type"` - - // 手动扩容的 CPU 。Type为 manual 时有效。 - // 注意:此字段可能返回 null,表示取不到有效值。 - ExpandCpu *string `json:"ExpandCpu,omitnil,omitempty" name:"ExpandCpu"` +type DescribeCpuExpandHistoryResponseParams struct { + // 满足查询要求的扩容历史 + Items []*HistoryJob `json:"Items,omitnil,omitempty" name:"Items"` - // 自动扩容策略。Type 为 auto 时有效 - // 注意:此字段可能返回 null,表示取不到有效值。 - AutoStrategy *string `json:"AutoStrategy,omitnil,omitempty" name:"AutoStrategy"` + // 总数出参 + TotalCount *int64 `json:"TotalCount,omitnil,omitempty" name:"TotalCount"` // 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 RequestId *string `json:"RequestId,omitnil,omitempty" name:"RequestId"` } -type DescribeCpuExpandStrategyResponse struct { +type DescribeCpuExpandHistoryResponse struct { *tchttp.BaseResponse - Response *DescribeCpuExpandStrategyResponseParams `json:"Response"` + Response *DescribeCpuExpandHistoryResponseParams `json:"Response"` } -func (r *DescribeCpuExpandStrategyResponse) ToJsonString() string { +func (r *DescribeCpuExpandHistoryResponse) ToJsonString() string { b, _ := json.Marshal(r) return string(b) } // FromJsonString It is highly **NOT** recommended to use this function // because it has no param check, nor strict type check -func (r *DescribeCpuExpandStrategyResponse) FromJsonString(s string) error { +func (r *DescribeCpuExpandHistoryResponse) FromJsonString(s string) error { return json.Unmarshal([]byte(s), &r) } @@ -6606,6 +7122,7 @@ type DescribeDBFeaturesResponseParams struct { IsRemoteRo *bool `json:"IsRemoteRo,omitnil,omitempty" name:"IsRemoteRo"` // 主实例所在地域。 + // 说明:此参数可能返回空值,您可忽略此出参返回值。如需获取实例所在地域详情,您可调用 [查询实例列表](https://cloud.tencent.com/document/product/236/15872) 接口查询。 MasterRegion *string `json:"MasterRegion,omitnil,omitempty" name:"MasterRegion"` // 是否支持小版本升级。 @@ -6915,14 +7432,16 @@ func (r *DescribeDBInstanceGTIDResponse) FromJsonString(s string) error { // Predefined struct for user type DescribeDBInstanceInfoRequestParams struct { - // 实例 ID 。 + // 实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 + // 说明:仅主实例支持查询,此项仅支持输入主实例 ID。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` } type DescribeDBInstanceInfoRequest struct { *tchttp.BaseRequest - // 实例 ID 。 + // 实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 + // 说明:仅主实例支持查询,此项仅支持输入主实例 ID。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` } @@ -6957,15 +7476,12 @@ type DescribeDBInstanceInfoResponseParams struct { Encryption *string `json:"Encryption,omitnil,omitempty" name:"Encryption"` // 加密使用的密钥 ID 。 - // 注意:此字段可能返回 null,表示取不到有效值。 KeyId *string `json:"KeyId,omitnil,omitempty" name:"KeyId"` // 密钥所在地域。 - // 注意:此字段可能返回 null,表示取不到有效值。 KeyRegion *string `json:"KeyRegion,omitnil,omitempty" name:"KeyRegion"` // 当前 CDB 后端服务使用的 KMS 服务的默认地域。 - // 注意:此字段可能返回 null,表示取不到有效值。 DefaultKmsRegion *string `json:"DefaultKmsRegion,omitnil,omitempty" name:"DefaultKmsRegion"` // 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 @@ -6990,7 +7506,7 @@ func (r *DescribeDBInstanceInfoResponse) FromJsonString(s string) error { // Predefined struct for user type DescribeDBInstanceLogToCLSRequestParams struct { - // 实例ID + // 实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` // CLS服务所在地域 @@ -7000,7 +7516,7 @@ type DescribeDBInstanceLogToCLSRequestParams struct { type DescribeDBInstanceLogToCLSRequest struct { *tchttp.BaseRequest - // 实例ID + // 实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` // CLS服务所在地域 @@ -7030,11 +7546,9 @@ func (r *DescribeDBInstanceLogToCLSRequest) FromJsonString(s string) error { // Predefined struct for user type DescribeDBInstanceLogToCLSResponseParams struct { // 错误日志投递CLS配置 - // 注意:此字段可能返回 null,表示取不到有效值。 ErrorLog *LogToCLSConfig `json:"ErrorLog,omitnil,omitempty" name:"ErrorLog"` // 慢日志投递CLS配置 - // 注意:此字段可能返回 null,表示取不到有效值。 SlowLog *LogToCLSConfig `json:"SlowLog,omitnil,omitempty" name:"SlowLog"` // 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 @@ -7060,6 +7574,11 @@ func (r *DescribeDBInstanceLogToCLSResponse) FromJsonString(s string) error { // Predefined struct for user type DescribeDBInstanceRebootTimeRequestParams struct { // 实例的 ID,格式如:cdb-c1nl9rpv,与云数据库控制台页面中显示的实例 ID 相同。 + // 说明:可输入多个实例 ID 进行查询,json 格式如下。 + // [ + // "cdb-30z11v8s", + // "cdb-93h11efg" + // ] InstanceIds []*string `json:"InstanceIds,omitnil,omitempty" name:"InstanceIds"` } @@ -7067,6 +7586,11 @@ type DescribeDBInstanceRebootTimeRequest struct { *tchttp.BaseRequest // 实例的 ID,格式如:cdb-c1nl9rpv,与云数据库控制台页面中显示的实例 ID 相同。 + // 说明:可输入多个实例 ID 进行查询,json 格式如下。 + // [ + // "cdb-30z11v8s", + // "cdb-93h11efg" + // ] InstanceIds []*string `json:"InstanceIds,omitnil,omitempty" name:"InstanceIds"` } @@ -7146,7 +7670,7 @@ type DescribeDBInstancesRequestParams struct { // 实例名称。 InstanceNames []*string `json:"InstanceNames,omitnil,omitempty" name:"InstanceNames"` - // 实例任务状态,可能取值:
0 - 没有任务
1 - 升级中
2 - 数据导入中
3 - 开放Slave中
4 - 外网访问开通中
5 - 批量操作执行中
6 - 回档中
7 - 外网访问关闭中
8 - 密码修改中
9 - 实例名修改中
10 - 重启中
12 - 自建迁移中
13 - 删除库表中
14 - 灾备实例创建同步中
15 - 升级待切换
16 - 升级切换中
17 - 升级切换完成
19 - 参数设置待执行 + // 实例任务状态,可能取值:
0 - 没有任务
1 - 升级中
2 - 数据导入中
3 - 开放Slave中
4 - 外网访问开通中
5 - 批量操作执行中
6 - 回档中
7 - 外网访问关闭中
8 - 密码修改中
9 - 实例名修改中
10 - 重启中
12 - 自建迁移中
13 - 删除库表中
14 - 灾备实例创建同步中
15 - 升级待切换
16 - 升级切换中
17 - 升级切换完成
19 - 参数设置待执行
34 - 原地升级待执行 TaskStatus []*uint64 `json:"TaskStatus,omitnil,omitempty" name:"TaskStatus"` // 实例数据库引擎版本,可能取值:5.1、5.5、5.6 和 5.7。 @@ -7167,10 +7691,11 @@ type DescribeDBInstancesRequestParams struct { // 返回结果集排序的字段,目前支持:"InstanceId","InstanceName","CreateTime","DeadlineTime"。 OrderBy *string `json:"OrderBy,omitnil,omitempty" name:"OrderBy"` - // 返回结果集排序方式,目前支持:"ASC" 或者 "DESC"。 + // 返回结果集排序方式。目前支持值:"ASC" - 表示升序,"DESC" - 表示降序,默认为 "DESC"。 OrderDirection *string `json:"OrderDirection,omitnil,omitempty" name:"OrderDirection"` // 是否以安全组 ID 为过滤条件。 + // 说明:0表示否,1表示是。 WithSecurityGroup *int64 `json:"WithSecurityGroup,omitnil,omitempty" name:"WithSecurityGroup"` // 是否包含独享集群详细信息,可取值:0 - 不包含,1 - 包含。 @@ -7213,6 +7738,7 @@ type DescribeDBInstancesRequestParams struct { UniqSubnetIds []*string `json:"UniqSubnetIds,omitnil,omitempty" name:"UniqSubnetIds"` // 标签键值 + // 请注意,创建中的实例无法查询到标签。 Tags []*Tag `json:"Tags,omitnil,omitempty" name:"Tags"` // 数据库代理 IP 。 @@ -7221,8 +7747,11 @@ type DescribeDBInstancesRequestParams struct { // 数据库代理 ID 。 ProxyIds []*string `json:"ProxyIds,omitnil,omitempty" name:"ProxyIds"` - // 数据库引擎类型。 + // 数据库引擎类型。可选值为:InnoDB、RocksDB。 EngineTypes []*string `json:"EngineTypes,omitnil,omitempty" name:"EngineTypes"` + + // 是否获取集群版实例节点信息,可填:true 或 false。默认为 false。 + QueryClusterInfo *bool `json:"QueryClusterInfo,omitnil,omitempty" name:"QueryClusterInfo"` } type DescribeDBInstancesRequest struct { @@ -7255,7 +7784,7 @@ type DescribeDBInstancesRequest struct { // 实例名称。 InstanceNames []*string `json:"InstanceNames,omitnil,omitempty" name:"InstanceNames"` - // 实例任务状态,可能取值:
0 - 没有任务
1 - 升级中
2 - 数据导入中
3 - 开放Slave中
4 - 外网访问开通中
5 - 批量操作执行中
6 - 回档中
7 - 外网访问关闭中
8 - 密码修改中
9 - 实例名修改中
10 - 重启中
12 - 自建迁移中
13 - 删除库表中
14 - 灾备实例创建同步中
15 - 升级待切换
16 - 升级切换中
17 - 升级切换完成
19 - 参数设置待执行 + // 实例任务状态,可能取值:
0 - 没有任务
1 - 升级中
2 - 数据导入中
3 - 开放Slave中
4 - 外网访问开通中
5 - 批量操作执行中
6 - 回档中
7 - 外网访问关闭中
8 - 密码修改中
9 - 实例名修改中
10 - 重启中
12 - 自建迁移中
13 - 删除库表中
14 - 灾备实例创建同步中
15 - 升级待切换
16 - 升级切换中
17 - 升级切换完成
19 - 参数设置待执行
34 - 原地升级待执行 TaskStatus []*uint64 `json:"TaskStatus,omitnil,omitempty" name:"TaskStatus"` // 实例数据库引擎版本,可能取值:5.1、5.5、5.6 和 5.7。 @@ -7276,10 +7805,11 @@ type DescribeDBInstancesRequest struct { // 返回结果集排序的字段,目前支持:"InstanceId","InstanceName","CreateTime","DeadlineTime"。 OrderBy *string `json:"OrderBy,omitnil,omitempty" name:"OrderBy"` - // 返回结果集排序方式,目前支持:"ASC" 或者 "DESC"。 + // 返回结果集排序方式。目前支持值:"ASC" - 表示升序,"DESC" - 表示降序,默认为 "DESC"。 OrderDirection *string `json:"OrderDirection,omitnil,omitempty" name:"OrderDirection"` // 是否以安全组 ID 为过滤条件。 + // 说明:0表示否,1表示是。 WithSecurityGroup *int64 `json:"WithSecurityGroup,omitnil,omitempty" name:"WithSecurityGroup"` // 是否包含独享集群详细信息,可取值:0 - 不包含,1 - 包含。 @@ -7322,6 +7852,7 @@ type DescribeDBInstancesRequest struct { UniqSubnetIds []*string `json:"UniqSubnetIds,omitnil,omitempty" name:"UniqSubnetIds"` // 标签键值 + // 请注意,创建中的实例无法查询到标签。 Tags []*Tag `json:"Tags,omitnil,omitempty" name:"Tags"` // 数据库代理 IP 。 @@ -7330,8 +7861,11 @@ type DescribeDBInstancesRequest struct { // 数据库代理 ID 。 ProxyIds []*string `json:"ProxyIds,omitnil,omitempty" name:"ProxyIds"` - // 数据库引擎类型。 + // 数据库引擎类型。可选值为:InnoDB、RocksDB。 EngineTypes []*string `json:"EngineTypes,omitnil,omitempty" name:"EngineTypes"` + + // 是否获取集群版实例节点信息,可填:true 或 false。默认为 false。 + QueryClusterInfo *bool `json:"QueryClusterInfo,omitnil,omitempty" name:"QueryClusterInfo"` } func (r *DescribeDBInstancesRequest) ToJsonString() string { @@ -7381,6 +7915,7 @@ func (r *DescribeDBInstancesRequest) FromJsonString(s string) error { delete(f, "ProxyVips") delete(f, "ProxyIds") delete(f, "EngineTypes") + delete(f, "QueryClusterInfo") if len(f) > 0 { return tcerr.NewTencentCloudSDKError("ClientError.BuildRequestError", "DescribeDBInstancesRequest has unknown keys!", "") } @@ -7426,10 +7961,10 @@ type DescribeDBPriceRequestParams struct { // 实例数量,默认值为 1,最小值 1,最大值为 100。InstanceId为空时该参数为必填项。 GoodsNum *int64 `json:"GoodsNum,omitnil,omitempty" name:"GoodsNum"` - // 实例内存大小,单位:MB。InstanceId为空时该参数为必填项。 + // 实例内存大小,单位:MB。InstanceId 为空时该参数为必填项。为保证传入值有效,请使用 [获取云数据库可售卖规格](https://cloud.tencent.com/document/product/236/17229) 接口获取可售卖的实例内存大小范围。 Memory *int64 `json:"Memory,omitnil,omitempty" name:"Memory"` - // 实例硬盘大小,单位:GB。InstanceId为空时该参数为必填项。 + // 实例硬盘大小,单位:GB。InstanceId 为空时该参数为必填项。为保证传入值有效,请使用 [获取云数据库可售卖规格](https://cloud.tencent.com/document/product/236/17229) 接口获取可售卖的硬盘大小范围。 Volume *int64 `json:"Volume,omitnil,omitempty" name:"Volume"` // 实例类型,默认为 master,支持值包括:master - 表示主实例,ro - 表示只读实例,dr - 表示灾备实例。InstanceId为空时该参数为必填项。 @@ -7441,7 +7976,7 @@ type DescribeDBPriceRequestParams struct { // 数据复制方式,默认为 0,支持值包括:0 - 表示异步复制,1 - 表示半同步复制,2 - 表示强同步复制。 ProtectMode *int64 `json:"ProtectMode,omitnil,omitempty" name:"ProtectMode"` - // 实例隔离类型。支持值包括: "UNIVERSAL" - 通用型实例, "EXCLUSIVE" - 独享型实例, "BASIC_V2" - 单节点云盘版实例。 不指定则默认为通用型实例。 + // 实例隔离类型。支持值包括: "UNIVERSAL" - 通用型实例, "EXCLUSIVE" - 独享型实例, "BASIC_V2" - 单节点云盘版实例。 "CLOUD_NATIVE_CLUSTER" - 集群版标准型, "CLOUD_NATIVE_CLUSTER_EXCLUSIVE" - 集群版加强型。 不指定则默认为通用型实例。 DeviceType *string `json:"DeviceType,omitnil,omitempty" name:"DeviceType"` // 实例节点数。对于 RO 和 基础版实例, 该值默认为1。 如果需要询价三节点实例, 请将该值设置为3。其余主实例该值默认为2。 @@ -7455,6 +7990,9 @@ type DescribeDBPriceRequestParams struct { // 按量计费阶梯。仅PayType=HOUR_PAID有效,支持值包括:1,2,3。阶梯时长见https://cloud.tencent.com/document/product/236/18335。 Ladder *uint64 `json:"Ladder,omitnil,omitempty" name:"Ladder"` + + // 磁盘类型,查询集群版、单节点云盘版实例价格可以指定该参数。支持值包括: "CLOUD_SSD" - SSD云硬盘, "CLOUD_HSSD" - 增强型SSD云硬盘。 默认为 SSD云硬盘。 + DiskType *string `json:"DiskType,omitnil,omitempty" name:"DiskType"` } type DescribeDBPriceRequest struct { @@ -7469,10 +8007,10 @@ type DescribeDBPriceRequest struct { // 实例数量,默认值为 1,最小值 1,最大值为 100。InstanceId为空时该参数为必填项。 GoodsNum *int64 `json:"GoodsNum,omitnil,omitempty" name:"GoodsNum"` - // 实例内存大小,单位:MB。InstanceId为空时该参数为必填项。 + // 实例内存大小,单位:MB。InstanceId 为空时该参数为必填项。为保证传入值有效,请使用 [获取云数据库可售卖规格](https://cloud.tencent.com/document/product/236/17229) 接口获取可售卖的实例内存大小范围。 Memory *int64 `json:"Memory,omitnil,omitempty" name:"Memory"` - // 实例硬盘大小,单位:GB。InstanceId为空时该参数为必填项。 + // 实例硬盘大小,单位:GB。InstanceId 为空时该参数为必填项。为保证传入值有效,请使用 [获取云数据库可售卖规格](https://cloud.tencent.com/document/product/236/17229) 接口获取可售卖的硬盘大小范围。 Volume *int64 `json:"Volume,omitnil,omitempty" name:"Volume"` // 实例类型,默认为 master,支持值包括:master - 表示主实例,ro - 表示只读实例,dr - 表示灾备实例。InstanceId为空时该参数为必填项。 @@ -7484,7 +8022,7 @@ type DescribeDBPriceRequest struct { // 数据复制方式,默认为 0,支持值包括:0 - 表示异步复制,1 - 表示半同步复制,2 - 表示强同步复制。 ProtectMode *int64 `json:"ProtectMode,omitnil,omitempty" name:"ProtectMode"` - // 实例隔离类型。支持值包括: "UNIVERSAL" - 通用型实例, "EXCLUSIVE" - 独享型实例, "BASIC_V2" - 单节点云盘版实例。 不指定则默认为通用型实例。 + // 实例隔离类型。支持值包括: "UNIVERSAL" - 通用型实例, "EXCLUSIVE" - 独享型实例, "BASIC_V2" - 单节点云盘版实例。 "CLOUD_NATIVE_CLUSTER" - 集群版标准型, "CLOUD_NATIVE_CLUSTER_EXCLUSIVE" - 集群版加强型。 不指定则默认为通用型实例。 DeviceType *string `json:"DeviceType,omitnil,omitempty" name:"DeviceType"` // 实例节点数。对于 RO 和 基础版实例, 该值默认为1。 如果需要询价三节点实例, 请将该值设置为3。其余主实例该值默认为2。 @@ -7498,6 +8036,9 @@ type DescribeDBPriceRequest struct { // 按量计费阶梯。仅PayType=HOUR_PAID有效,支持值包括:1,2,3。阶梯时长见https://cloud.tencent.com/document/product/236/18335。 Ladder *uint64 `json:"Ladder,omitnil,omitempty" name:"Ladder"` + + // 磁盘类型,查询集群版、单节点云盘版实例价格可以指定该参数。支持值包括: "CLOUD_SSD" - SSD云硬盘, "CLOUD_HSSD" - 增强型SSD云硬盘。 默认为 SSD云硬盘。 + DiskType *string `json:"DiskType,omitnil,omitempty" name:"DiskType"` } func (r *DescribeDBPriceRequest) ToJsonString() string { @@ -7525,6 +8066,7 @@ func (r *DescribeDBPriceRequest) FromJsonString(s string) error { delete(f, "Cpu") delete(f, "InstanceId") delete(f, "Ladder") + delete(f, "DiskType") if len(f) > 0 { return tcerr.NewTencentCloudSDKError("ClientError.BuildRequestError", "DescribeDBPriceRequest has unknown keys!", "") } @@ -7641,7 +8183,7 @@ type DescribeDBSwitchRecordsRequestParams struct { // 分页偏移量。 Offset *int64 `json:"Offset,omitnil,omitempty" name:"Offset"` - // 分页大小,默认值为 50,最小值为 1,最大值为 2000。 + // 分页大小,默认值为50,最小值为1,最大值为1000。 Limit *int64 `json:"Limit,omitnil,omitempty" name:"Limit"` } @@ -7654,7 +8196,7 @@ type DescribeDBSwitchRecordsRequest struct { // 分页偏移量。 Offset *int64 `json:"Offset,omitnil,omitempty" name:"Offset"` - // 分页大小,默认值为 50,最小值为 1,最大值为 2000。 + // 分页大小,默认值为50,最小值为1,最大值为1000。 Limit *int64 `json:"Limit,omitnil,omitempty" name:"Limit"` } @@ -7709,14 +8251,14 @@ func (r *DescribeDBSwitchRecordsResponse) FromJsonString(s string) error { // Predefined struct for user type DescribeDataBackupOverviewRequestParams struct { - // 需要查询的云数据库产品类型,目前仅支持 "mysql"。 + // 需要查询数据备份概览的云数据库产品类型。可取值为:mysql 指双节点/三节点的高可用实例,mysql-basic 指单节点云盘版实例,mysql-cluster 指云盘版(原集群版)实例。 Product *string `json:"Product,omitnil,omitempty" name:"Product"` } type DescribeDataBackupOverviewRequest struct { *tchttp.BaseRequest - // 需要查询的云数据库产品类型,目前仅支持 "mysql"。 + // 需要查询数据备份概览的云数据库产品类型。可取值为:mysql 指双节点/三节点的高可用实例,mysql-basic 指单节点云盘版实例,mysql-cluster 指云盘版(原集群版)实例。 Product *string `json:"Product,omitnil,omitempty" name:"Product"` } @@ -7805,7 +8347,7 @@ type DescribeDatabasesRequestParams struct { // 偏移量,最小值为0。 Offset *int64 `json:"Offset,omitnil,omitempty" name:"Offset"` - // 单次请求数量,默认值为20,最小值为1,最大值为100。 + // 单次请求数量,默认值为20,最小值为1,最大值为5000。 Limit *int64 `json:"Limit,omitnil,omitempty" name:"Limit"` // 匹配数据库库名的正则表达式。 @@ -7821,7 +8363,7 @@ type DescribeDatabasesRequest struct { // 偏移量,最小值为0。 Offset *int64 `json:"Offset,omitnil,omitempty" name:"Offset"` - // 单次请求数量,默认值为20,最小值为1,最大值为100。 + // 单次请求数量,默认值为20,最小值为1,最大值为5000。 Limit *int64 `json:"Limit,omitnil,omitempty" name:"Limit"` // 匹配数据库库名的正则表达式。 @@ -7855,7 +8397,7 @@ type DescribeDatabasesResponseParams struct { // 符合查询条件的实例总数。 TotalCount *int64 `json:"TotalCount,omitnil,omitempty" name:"TotalCount"` - // 返回的实例信息。 + // 实例中的数据库名称列表。 Items []*string `json:"Items,omitnil,omitempty" name:"Items"` // 数据库名以及字符集 @@ -7883,26 +8425,28 @@ func (r *DescribeDatabasesResponse) FromJsonString(s string) error { // Predefined struct for user type DescribeDefaultParamsRequestParams struct { - // 引擎版本,目前支持 ["5.1", "5.5", "5.6", "5.7", "8.0"] + // 引擎版本,目前支持 ["5.1", "5.5", "5.6", "5.7", "8.0"]。 + // 说明:引擎版本为必填。 EngineVersion *string `json:"EngineVersion,omitnil,omitempty" name:"EngineVersion"` - // 默认参数模板类型。支持值包括:"HIGH_STABILITY" - 高稳定模板,"HIGH_PERFORMANCE" - 高性能模板。 + // 默认参数模板类型。支持值包括:"HIGH_STABILITY" - 高稳定模板,"HIGH_PERFORMANCE" - 高性能模板。默认值为:HIGH_STABILITY。 TemplateType *string `json:"TemplateType,omitnil,omitempty" name:"TemplateType"` - // 参数模板引擎,默认值:InnoDB + // 参数模板引擎,默认值:InnoDB,可取值:InnoDB、RocksDB。 EngineType *string `json:"EngineType,omitnil,omitempty" name:"EngineType"` } type DescribeDefaultParamsRequest struct { *tchttp.BaseRequest - // 引擎版本,目前支持 ["5.1", "5.5", "5.6", "5.7", "8.0"] + // 引擎版本,目前支持 ["5.1", "5.5", "5.6", "5.7", "8.0"]。 + // 说明:引擎版本为必填。 EngineVersion *string `json:"EngineVersion,omitnil,omitempty" name:"EngineVersion"` - // 默认参数模板类型。支持值包括:"HIGH_STABILITY" - 高稳定模板,"HIGH_PERFORMANCE" - 高性能模板。 + // 默认参数模板类型。支持值包括:"HIGH_STABILITY" - 高稳定模板,"HIGH_PERFORMANCE" - 高性能模板。默认值为:HIGH_STABILITY。 TemplateType *string `json:"TemplateType,omitnil,omitempty" name:"TemplateType"` - // 参数模板引擎,默认值:InnoDB + // 参数模板引擎,默认值:InnoDB,可取值:InnoDB、RocksDB。 EngineType *string `json:"EngineType,omitnil,omitempty" name:"EngineType"` } @@ -8014,7 +8558,6 @@ type DescribeDeployGroupListResponseParams struct { Total *int64 `json:"Total,omitnil,omitempty" name:"Total"` // 返回列表。 - // 注意:此字段可能返回 null,表示取不到有效值。 Items []*DeployGroupInfo `json:"Items,omitnil,omitempty" name:"Items"` // 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 @@ -8112,16 +8655,16 @@ func (r *DescribeDeviceMonitorInfoResponse) FromJsonString(s string) error { // Predefined struct for user type DescribeErrorLogDataRequestParams struct { - // 实例 ID 。 + // 实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` - // 开始时间戳。例如 1585142640 。 + // 开始时间戳。例如1585142640,秒级。 StartTime *uint64 `json:"StartTime,omitnil,omitempty" name:"StartTime"` - // 结束时间戳。例如 1585142640 。 + // 结束时间戳。例如1585142640,秒级。 EndTime *uint64 `json:"EndTime,omitnil,omitempty" name:"EndTime"` - // 要匹配的关键字列表,最多支持15个关键字。 + // 要匹配的关键字列表,最多支持15个关键字,支持模糊匹配。 KeyWords []*string `json:"KeyWords,omitnil,omitempty" name:"KeyWords"` // 分页的返回数量,默认为100,最大为400。 @@ -8137,16 +8680,16 @@ type DescribeErrorLogDataRequestParams struct { type DescribeErrorLogDataRequest struct { *tchttp.BaseRequest - // 实例 ID 。 + // 实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` - // 开始时间戳。例如 1585142640 。 + // 开始时间戳。例如1585142640,秒级。 StartTime *uint64 `json:"StartTime,omitnil,omitempty" name:"StartTime"` - // 结束时间戳。例如 1585142640 。 + // 结束时间戳。例如1585142640,秒级。 EndTime *uint64 `json:"EndTime,omitnil,omitempty" name:"EndTime"` - // 要匹配的关键字列表,最多支持15个关键字。 + // 要匹配的关键字列表,最多支持15个关键字,支持模糊匹配。 KeyWords []*string `json:"KeyWords,omitnil,omitempty" name:"KeyWords"` // 分页的返回数量,默认为100,最大为400。 @@ -8190,7 +8733,6 @@ type DescribeErrorLogDataResponseParams struct { TotalCount *int64 `json:"TotalCount,omitnil,omitempty" name:"TotalCount"` // 返回的记录。 - // 注意:此字段可能返回 null,表示取不到有效值。 Items []*ErrlogItem `json:"Items,omitnil,omitempty" name:"Items"` // 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 @@ -8215,12 +8757,63 @@ func (r *DescribeErrorLogDataResponse) FromJsonString(s string) error { // Predefined struct for user type DescribeInstanceAlarmEventsRequestParams struct { + // 实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 + InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` + + // 事件查询范围开始时间,闭区间。 + StartTime *string `json:"StartTime,omitnil,omitempty" name:"StartTime"` + + // 事件查询范围截止时间,闭区间。 + EndTime *string `json:"EndTime,omitnil,omitempty" name:"EndTime"` + // 事件名称。 Outofmemory - 内存OOM(有状态事件); Switch - 主从切换(有状态事件); Roremove - 只读实例剔除(有状态事件); MemoryUsedHigh - 内存使用率过高(有状态事件); CPUExpansion - CPU性能扩容(无状态事件); CPUExpansionFailed - CPU性能扩容失败(无状态事件); CPUContraction - CPU性能回缩(无状态事件); Restart - 实例重启(有状态事件); ServerFailureNodeMigration - ServerFailureNodeMigration(有状态事件); PlannedSwitch - 计划内主备切换(无状态事件); OverusedReadonlySet - 实例将被锁定(无状态事件); OverusedReadWriteSet - 实例解除锁定(无状态事件)。 + EventName []*string `json:"EventName,omitnil,omitempty" name:"EventName"` + + // 事件状态。"1" - 发生事件;"0" - 恢复事件;"-" - 无状态事件。 + EventStatus *string `json:"EventStatus,omitnil,omitempty" name:"EventStatus"` + + // 排序方式。按事件发生事件进行排序,"DESC"-倒排;”ASC“-正序,默认倒排。 + Order *string `json:"Order,omitnil,omitempty" name:"Order"` + + // 事件展示数量。默认为100,最大为200。 + Limit *string `json:"Limit,omitnil,omitempty" name:"Limit"` + + // 偏移量。 + Offset *string `json:"Offset,omitnil,omitempty" name:"Offset"` + + // 节点 ID。 + NodeId *string `json:"NodeId,omitnil,omitempty" name:"NodeId"` } type DescribeInstanceAlarmEventsRequest struct { *tchttp.BaseRequest + // 实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 + InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` + + // 事件查询范围开始时间,闭区间。 + StartTime *string `json:"StartTime,omitnil,omitempty" name:"StartTime"` + + // 事件查询范围截止时间,闭区间。 + EndTime *string `json:"EndTime,omitnil,omitempty" name:"EndTime"` + + // 事件名称。 Outofmemory - 内存OOM(有状态事件); Switch - 主从切换(有状态事件); Roremove - 只读实例剔除(有状态事件); MemoryUsedHigh - 内存使用率过高(有状态事件); CPUExpansion - CPU性能扩容(无状态事件); CPUExpansionFailed - CPU性能扩容失败(无状态事件); CPUContraction - CPU性能回缩(无状态事件); Restart - 实例重启(有状态事件); ServerFailureNodeMigration - ServerFailureNodeMigration(有状态事件); PlannedSwitch - 计划内主备切换(无状态事件); OverusedReadonlySet - 实例将被锁定(无状态事件); OverusedReadWriteSet - 实例解除锁定(无状态事件)。 + EventName []*string `json:"EventName,omitnil,omitempty" name:"EventName"` + + // 事件状态。"1" - 发生事件;"0" - 恢复事件;"-" - 无状态事件。 + EventStatus *string `json:"EventStatus,omitnil,omitempty" name:"EventStatus"` + + // 排序方式。按事件发生事件进行排序,"DESC"-倒排;”ASC“-正序,默认倒排。 + Order *string `json:"Order,omitnil,omitempty" name:"Order"` + + // 事件展示数量。默认为100,最大为200。 + Limit *string `json:"Limit,omitnil,omitempty" name:"Limit"` + + // 偏移量。 + Offset *string `json:"Offset,omitnil,omitempty" name:"Offset"` + + // 节点 ID。 + NodeId *string `json:"NodeId,omitnil,omitempty" name:"NodeId"` } func (r *DescribeInstanceAlarmEventsRequest) ToJsonString() string { @@ -8235,7 +8828,15 @@ func (r *DescribeInstanceAlarmEventsRequest) FromJsonString(s string) error { if err := json.Unmarshal([]byte(s), &f); err != nil { return err } - + delete(f, "InstanceId") + delete(f, "StartTime") + delete(f, "EndTime") + delete(f, "EventName") + delete(f, "EventStatus") + delete(f, "Order") + delete(f, "Limit") + delete(f, "Offset") + delete(f, "NodeId") if len(f) > 0 { return tcerr.NewTencentCloudSDKError("ClientError.BuildRequestError", "DescribeInstanceAlarmEventsRequest has unknown keys!", "") } @@ -8244,6 +8845,12 @@ func (r *DescribeInstanceAlarmEventsRequest) FromJsonString(s string) error { // Predefined struct for user type DescribeInstanceAlarmEventsResponseParams struct { + // 事件数。 + TotalCount *int64 `json:"TotalCount,omitnil,omitempty" name:"TotalCount"` + + // 事件信息。查询不到信息时,Items为null。 + Items []*InstEventInfo `json:"Items,omitnil,omitempty" name:"Items"` + // 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 RequestId *string `json:"RequestId,omitnil,omitempty" name:"RequestId"` } @@ -8272,7 +8879,7 @@ type DescribeInstanceParamRecordsRequestParams struct { // 分页偏移量,默认值:0。 Offset *int64 `json:"Offset,omitnil,omitempty" name:"Offset"` - // 分页大小,默认值:20。 + // 分页大小,默认值:20,最大值为100。 Limit *int64 `json:"Limit,omitnil,omitempty" name:"Limit"` } @@ -8285,7 +8892,7 @@ type DescribeInstanceParamRecordsRequest struct { // 分页偏移量,默认值:0。 Offset *int64 `json:"Offset,omitnil,omitempty" name:"Offset"` - // 分页大小,默认值:20。 + // 分页大小,默认值:20,最大值为100。 Limit *int64 `json:"Limit,omitnil,omitempty" name:"Limit"` } @@ -8398,6 +9005,219 @@ func (r *DescribeInstanceParamsResponse) FromJsonString(s string) error { return json.Unmarshal([]byte(s), &r) } +// Predefined struct for user +type DescribeInstanceUpgradeCheckJobRequestParams struct { + // 实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 + InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` + + // 目标数据库版本。 + // 说明:可选值5.6、5.7、8.0,不支持跨版本升级,升级后不支持版本降级。 + DstMysqlVersion *string `json:"DstMysqlVersion,omitnil,omitempty" name:"DstMysqlVersion"` +} + +type DescribeInstanceUpgradeCheckJobRequest struct { + *tchttp.BaseRequest + + // 实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 + InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` + + // 目标数据库版本。 + // 说明:可选值5.6、5.7、8.0,不支持跨版本升级,升级后不支持版本降级。 + DstMysqlVersion *string `json:"DstMysqlVersion,omitnil,omitempty" name:"DstMysqlVersion"` +} + +func (r *DescribeInstanceUpgradeCheckJobRequest) ToJsonString() string { + b, _ := json.Marshal(r) + return string(b) +} + +// FromJsonString It is highly **NOT** recommended to use this function +// because it has no param check, nor strict type check +func (r *DescribeInstanceUpgradeCheckJobRequest) FromJsonString(s string) error { + f := make(map[string]interface{}) + if err := json.Unmarshal([]byte(s), &f); err != nil { + return err + } + delete(f, "InstanceId") + delete(f, "DstMysqlVersion") + if len(f) > 0 { + return tcerr.NewTencentCloudSDKError("ClientError.BuildRequestError", "DescribeInstanceUpgradeCheckJobRequest has unknown keys!", "") + } + return json.Unmarshal([]byte(s), &r) +} + +// Predefined struct for user +type DescribeInstanceUpgradeCheckJobResponseParams struct { + // 24小时内是否存在历史升级校验任务 + ExistUpgradeCheckJob *bool `json:"ExistUpgradeCheckJob,omitnil,omitempty" name:"ExistUpgradeCheckJob"` + + // 任务id + JobId *int64 `json:"JobId,omitnil,omitempty" name:"JobId"` + + // 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 + RequestId *string `json:"RequestId,omitnil,omitempty" name:"RequestId"` +} + +type DescribeInstanceUpgradeCheckJobResponse struct { + *tchttp.BaseResponse + Response *DescribeInstanceUpgradeCheckJobResponseParams `json:"Response"` +} + +func (r *DescribeInstanceUpgradeCheckJobResponse) ToJsonString() string { + b, _ := json.Marshal(r) + return string(b) +} + +// FromJsonString It is highly **NOT** recommended to use this function +// because it has no param check, nor strict type check +func (r *DescribeInstanceUpgradeCheckJobResponse) FromJsonString(s string) error { + return json.Unmarshal([]byte(s), &r) +} + +// Predefined struct for user +type DescribeInstanceUpgradeTypeRequestParams struct { + // 实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 + InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` + + // 目标实例 CPU 的核数。为保证传入值有效,请使用 [DescribeCdbZoneConfig](https://cloud.tencent.com/document/product/236/80281) 获取实例可售卖的 CPU 值范围。 + DstCpu *float64 `json:"DstCpu,omitnil,omitempty" name:"DstCpu"` + + // 目标实例内存大小,单位:MB。为保证传入值有效,请使用 [DescribeCdbZoneConfig](https://cloud.tencent.com/document/product/236/80281) 获取实例可售卖的内存大小范围。 + DstMemory *uint64 `json:"DstMemory,omitnil,omitempty" name:"DstMemory"` + + // 目标实例磁盘大小,单位:GB。为保证传入值有效,请使用 [DescribeCdbZoneConfig](https://cloud.tencent.com/document/product/236/80281) 获取实例可售卖的磁盘大小范围。 + DstDisk *uint64 `json:"DstDisk,omitnil,omitempty" name:"DstDisk"` + + // 目标实例数据库版本。可选值:5.6,5.7,8.0。 + DstVersion *string `json:"DstVersion,omitnil,omitempty" name:"DstVersion"` + + // 目标实例部署模型。默认为0,支持值包括:0 - 表示单可用区,1 - 表示多可用区。 + DstDeployMode *int64 `json:"DstDeployMode,omitnil,omitempty" name:"DstDeployMode"` + + // 目标实例复制类型,支持值包括:0 - 表示异步复制,1 - 表示半同步复制,2 - 表示强同步复制。 + DstProtectMode *int64 `json:"DstProtectMode,omitnil,omitempty" name:"DstProtectMode"` + + // 目标实例备机1可用区 ID。可使用 [DescribeCdbZoneConfig](https://cloud.tencent.com/document/product/236/80281) 获取可用区 ID。 + DstSlaveZone *int64 `json:"DstSlaveZone,omitnil,omitempty" name:"DstSlaveZone"` + + // 目标实例备机2可用区 ID。可使用 [DescribeCdbZoneConfig](https://cloud.tencent.com/document/product/236/80281) 获取可用区 ID。 + DstBackupZone *int64 `json:"DstBackupZone,omitnil,omitempty" name:"DstBackupZone"` + + // 目标实例类型。支持值包括:"CUSTOM" - 通用型实例,"EXCLUSIVE" - 独享型实例,"ONTKE" - ONTKE 单节点实例,"CLOUD_NATIVE_CLUSTER" - 云盘版标准型,"CLOUD_NATIVE_CLUSTER_EXCLUSIVE" - 云盘版加强型。 + DstCdbType *string `json:"DstCdbType,omitnil,omitempty" name:"DstCdbType"` + + // 目标实例主可用区 ID。可使用 [DescribeCdbZoneConfig](https://cloud.tencent.com/document/product/236/80281) 获取可用区 ID。 + DstZoneId *int64 `json:"DstZoneId,omitnil,omitempty" name:"DstZoneId"` + + // 独享集群 CDB 实例的节点分布情况。 + NodeDistribution *NodeDistribution `json:"NodeDistribution,omitnil,omitempty" name:"NodeDistribution"` + + // 集群版的节点拓扑配置。Nodeld信息可通过 [DescribeClusterInfo](https://cloud.tencent.com/document/api/236/105116) 接口获取。 + ClusterTopology *ClusterTopology `json:"ClusterTopology,omitnil,omitempty" name:"ClusterTopology"` +} + +type DescribeInstanceUpgradeTypeRequest struct { + *tchttp.BaseRequest + + // 实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 + InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` + + // 目标实例 CPU 的核数。为保证传入值有效,请使用 [DescribeCdbZoneConfig](https://cloud.tencent.com/document/product/236/80281) 获取实例可售卖的 CPU 值范围。 + DstCpu *float64 `json:"DstCpu,omitnil,omitempty" name:"DstCpu"` + + // 目标实例内存大小,单位:MB。为保证传入值有效,请使用 [DescribeCdbZoneConfig](https://cloud.tencent.com/document/product/236/80281) 获取实例可售卖的内存大小范围。 + DstMemory *uint64 `json:"DstMemory,omitnil,omitempty" name:"DstMemory"` + + // 目标实例磁盘大小,单位:GB。为保证传入值有效,请使用 [DescribeCdbZoneConfig](https://cloud.tencent.com/document/product/236/80281) 获取实例可售卖的磁盘大小范围。 + DstDisk *uint64 `json:"DstDisk,omitnil,omitempty" name:"DstDisk"` + + // 目标实例数据库版本。可选值:5.6,5.7,8.0。 + DstVersion *string `json:"DstVersion,omitnil,omitempty" name:"DstVersion"` + + // 目标实例部署模型。默认为0,支持值包括:0 - 表示单可用区,1 - 表示多可用区。 + DstDeployMode *int64 `json:"DstDeployMode,omitnil,omitempty" name:"DstDeployMode"` + + // 目标实例复制类型,支持值包括:0 - 表示异步复制,1 - 表示半同步复制,2 - 表示强同步复制。 + DstProtectMode *int64 `json:"DstProtectMode,omitnil,omitempty" name:"DstProtectMode"` + + // 目标实例备机1可用区 ID。可使用 [DescribeCdbZoneConfig](https://cloud.tencent.com/document/product/236/80281) 获取可用区 ID。 + DstSlaveZone *int64 `json:"DstSlaveZone,omitnil,omitempty" name:"DstSlaveZone"` + + // 目标实例备机2可用区 ID。可使用 [DescribeCdbZoneConfig](https://cloud.tencent.com/document/product/236/80281) 获取可用区 ID。 + DstBackupZone *int64 `json:"DstBackupZone,omitnil,omitempty" name:"DstBackupZone"` + + // 目标实例类型。支持值包括:"CUSTOM" - 通用型实例,"EXCLUSIVE" - 独享型实例,"ONTKE" - ONTKE 单节点实例,"CLOUD_NATIVE_CLUSTER" - 云盘版标准型,"CLOUD_NATIVE_CLUSTER_EXCLUSIVE" - 云盘版加强型。 + DstCdbType *string `json:"DstCdbType,omitnil,omitempty" name:"DstCdbType"` + + // 目标实例主可用区 ID。可使用 [DescribeCdbZoneConfig](https://cloud.tencent.com/document/product/236/80281) 获取可用区 ID。 + DstZoneId *int64 `json:"DstZoneId,omitnil,omitempty" name:"DstZoneId"` + + // 独享集群 CDB 实例的节点分布情况。 + NodeDistribution *NodeDistribution `json:"NodeDistribution,omitnil,omitempty" name:"NodeDistribution"` + + // 集群版的节点拓扑配置。Nodeld信息可通过 [DescribeClusterInfo](https://cloud.tencent.com/document/api/236/105116) 接口获取。 + ClusterTopology *ClusterTopology `json:"ClusterTopology,omitnil,omitempty" name:"ClusterTopology"` +} + +func (r *DescribeInstanceUpgradeTypeRequest) ToJsonString() string { + b, _ := json.Marshal(r) + return string(b) +} + +// FromJsonString It is highly **NOT** recommended to use this function +// because it has no param check, nor strict type check +func (r *DescribeInstanceUpgradeTypeRequest) FromJsonString(s string) error { + f := make(map[string]interface{}) + if err := json.Unmarshal([]byte(s), &f); err != nil { + return err + } + delete(f, "InstanceId") + delete(f, "DstCpu") + delete(f, "DstMemory") + delete(f, "DstDisk") + delete(f, "DstVersion") + delete(f, "DstDeployMode") + delete(f, "DstProtectMode") + delete(f, "DstSlaveZone") + delete(f, "DstBackupZone") + delete(f, "DstCdbType") + delete(f, "DstZoneId") + delete(f, "NodeDistribution") + delete(f, "ClusterTopology") + if len(f) > 0 { + return tcerr.NewTencentCloudSDKError("ClientError.BuildRequestError", "DescribeInstanceUpgradeTypeRequest has unknown keys!", "") + } + return json.Unmarshal([]byte(s), &r) +} + +// Predefined struct for user +type DescribeInstanceUpgradeTypeResponseParams struct { + // 实例 ID。 + InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` + + // 实例升级类型。Trsf - 迁移升级,InPlace - 原地升级,Topology - 架构升级。 + UpgradeType *string `json:"UpgradeType,omitnil,omitempty" name:"UpgradeType"` + + // 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 + RequestId *string `json:"RequestId,omitnil,omitempty" name:"RequestId"` +} + +type DescribeInstanceUpgradeTypeResponse struct { + *tchttp.BaseResponse + Response *DescribeInstanceUpgradeTypeResponseParams `json:"Response"` +} + +func (r *DescribeInstanceUpgradeTypeResponse) ToJsonString() string { + b, _ := json.Marshal(r) + return string(b) +} + +// FromJsonString It is highly **NOT** recommended to use this function +// because it has no param check, nor strict type check +func (r *DescribeInstanceUpgradeTypeResponse) FromJsonString(s string) error { + return json.Unmarshal([]byte(s), &r) +} + // Predefined struct for user type DescribeLocalBinlogConfigRequestParams struct { // 实例 ID,格式如:cdb-c1nl9rpv。与云数据库控制台页面中显示的实例ID相同。 @@ -8460,14 +9280,14 @@ func (r *DescribeLocalBinlogConfigResponse) FromJsonString(s string) error { // Predefined struct for user type DescribeParamTemplateInfoRequestParams struct { - // 参数模板 ID。 + // 参数模板 ID。可通过 [DescribeParamTemplates](https://cloud.tencent.com/document/api/236/32659) 接口获取。 TemplateId *int64 `json:"TemplateId,omitnil,omitempty" name:"TemplateId"` } type DescribeParamTemplateInfoRequest struct { *tchttp.BaseRequest - // 参数模板 ID。 + // 参数模板 ID。可通过 [DescribeParamTemplates](https://cloud.tencent.com/document/api/236/32659) 接口获取。 TemplateId *int64 `json:"TemplateId,omitnil,omitempty" name:"TemplateId"` } @@ -8498,7 +9318,7 @@ type DescribeParamTemplateInfoResponseParams struct { // 参数模板名称。 Name *string `json:"Name,omitnil,omitempty" name:"Name"` - // 参数模板对应实例版本 + // 参数模板对应实例版本,可取值:5.5、5.6、5.7、8.0。 EngineVersion *string `json:"EngineVersion,omitnil,omitempty" name:"EngineVersion"` // 参数模板中的参数数量 @@ -8514,7 +9334,6 @@ type DescribeParamTemplateInfoResponseParams struct { TemplateType *string `json:"TemplateType,omitnil,omitempty" name:"TemplateType"` // 参数模板引擎。支持值包括:"InnoDB","RocksDB"。 - // 注意:此字段可能返回 null,表示取不到有效值。 EngineType *string `json:"EngineType,omitnil,omitempty" name:"EngineType"` // 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 @@ -8539,32 +9358,32 @@ func (r *DescribeParamTemplateInfoResponse) FromJsonString(s string) error { // Predefined struct for user type DescribeParamTemplatesRequestParams struct { - // 引擎版本,缺省则查询所有 + // 引擎版本,缺省则查询所有。可取值为:5.5、5.6、5.7、8.0。 EngineVersions []*string `json:"EngineVersions,omitnil,omitempty" name:"EngineVersions"` - // 引擎类型,缺省则查询所有 + // 引擎类型,缺省则查询所有。可取值为:InnoDB、RocksDB,不区分大小写。 EngineTypes []*string `json:"EngineTypes,omitnil,omitempty" name:"EngineTypes"` - // 模板名称,缺省则查询所有 + // 模板名称,缺省则查询所有。支持模糊匹配。 TemplateNames []*string `json:"TemplateNames,omitnil,omitempty" name:"TemplateNames"` - // 模板id,缺省则查询所有 + // 模板 ID,缺省则查询所有。 TemplateIds []*int64 `json:"TemplateIds,omitnil,omitempty" name:"TemplateIds"` } type DescribeParamTemplatesRequest struct { *tchttp.BaseRequest - // 引擎版本,缺省则查询所有 + // 引擎版本,缺省则查询所有。可取值为:5.5、5.6、5.7、8.0。 EngineVersions []*string `json:"EngineVersions,omitnil,omitempty" name:"EngineVersions"` - // 引擎类型,缺省则查询所有 + // 引擎类型,缺省则查询所有。可取值为:InnoDB、RocksDB,不区分大小写。 EngineTypes []*string `json:"EngineTypes,omitnil,omitempty" name:"EngineTypes"` - // 模板名称,缺省则查询所有 + // 模板名称,缺省则查询所有。支持模糊匹配。 TemplateNames []*string `json:"TemplateNames,omitnil,omitempty" name:"TemplateNames"` - // 模板id,缺省则查询所有 + // 模板 ID,缺省则查询所有。 TemplateIds []*int64 `json:"TemplateIds,omitnil,omitempty" name:"TemplateIds"` } @@ -8620,14 +9439,14 @@ func (r *DescribeParamTemplatesResponse) FromJsonString(s string) error { // Predefined struct for user type DescribeProjectSecurityGroupsRequestParams struct { - // 项目ID。 + // 项目 ID。可通过 [DescribeProjects](https://cloud.tencent.com/document/api/651/78725) 接口获取。 ProjectId *int64 `json:"ProjectId,omitnil,omitempty" name:"ProjectId"` } type DescribeProjectSecurityGroupsRequest struct { *tchttp.BaseRequest - // 项目ID。 + // 项目 ID。可通过 [DescribeProjects](https://cloud.tencent.com/document/api/651/78725) 接口获取。 ProjectId *int64 `json:"ProjectId,omitnil,omitempty" name:"ProjectId"` } @@ -8680,7 +9499,7 @@ func (r *DescribeProjectSecurityGroupsResponse) FromJsonString(s string) error { // Predefined struct for user type DescribeProxyCustomConfRequestParams struct { - // 实例ID + // 实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` // 分页 @@ -8693,7 +9512,7 @@ type DescribeProxyCustomConfRequestParams struct { type DescribeProxyCustomConfRequest struct { *tchttp.BaseRequest - // 实例ID + // 实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` // 分页 @@ -8727,17 +9546,19 @@ func (r *DescribeProxyCustomConfRequest) FromJsonString(s string) error { // Predefined struct for user type DescribeProxyCustomConfResponseParams struct { // 代理配置数 - // 注意:此字段可能返回 null,表示取不到有效值。 Count *uint64 `json:"Count,omitnil,omitempty" name:"Count"` // 代理配置 - // 注意:此字段可能返回 null,表示取不到有效值。 + // + // Deprecated: CustomConf is deprecated. CustomConf *CustomConfig `json:"CustomConf,omitnil,omitempty" name:"CustomConf"` // 权重限制 - // 注意:此字段可能返回 null,表示取不到有效值。 WeightRule *Rule `json:"WeightRule,omitnil,omitempty" name:"WeightRule"` + // 代理配置 + CustomConfInfo []*CustomConfig `json:"CustomConfInfo,omitnil,omitempty" name:"CustomConfInfo"` + // 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 RequestId *string `json:"RequestId,omitnil,omitempty" name:"RequestId"` } @@ -8760,14 +9581,14 @@ func (r *DescribeProxyCustomConfResponse) FromJsonString(s string) error { // Predefined struct for user type DescribeProxySupportParamRequestParams struct { - // 实例ID + // 实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` } type DescribeProxySupportParamRequest struct { *tchttp.BaseRequest - // 实例ID + // 实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` } @@ -8793,43 +9614,33 @@ func (r *DescribeProxySupportParamRequest) FromJsonString(s string) error { // Predefined struct for user type DescribeProxySupportParamResponseParams struct { // 支持最大代理版本 - // 注意:此字段可能返回 null,表示取不到有效值。 ProxyVersion *string `json:"ProxyVersion,omitnil,omitempty" name:"ProxyVersion"` // 是否支持连接池 - // 注意:此字段可能返回 null,表示取不到有效值。 SupportPool *bool `json:"SupportPool,omitnil,omitempty" name:"SupportPool"` // 连接池最小值 - // 注意:此字段可能返回 null,表示取不到有效值。 PoolMin *uint64 `json:"PoolMin,omitnil,omitempty" name:"PoolMin"` // 连接池最大值 - // 注意:此字段可能返回 null,表示取不到有效值。 PoolMax *uint64 `json:"PoolMax,omitnil,omitempty" name:"PoolMax"` // 是否支持事务拆分 - // 注意:此字段可能返回 null,表示取不到有效值。 SupportTransSplit *bool `json:"SupportTransSplit,omitnil,omitempty" name:"SupportTransSplit"` // 支持连接池的最小代理版本 - // 注意:此字段可能返回 null,表示取不到有效值。 SupportPoolMinVersion *string `json:"SupportPoolMinVersion,omitnil,omitempty" name:"SupportPoolMinVersion"` // 支持事务拆分的最小代理版本 - // 注意:此字段可能返回 null,表示取不到有效值。 SupportTransSplitMinVersion *string `json:"SupportTransSplitMinVersion,omitnil,omitempty" name:"SupportTransSplitMinVersion"` // 是否支持设置只读 - // 注意:此字段可能返回 null,表示取不到有效值。 SupportReadOnly *bool `json:"SupportReadOnly,omitnil,omitempty" name:"SupportReadOnly"` // 是否自动均衡负载 - // 注意:此字段可能返回 null,表示取不到有效值。 SupportAutoLoadBalance *bool `json:"SupportAutoLoadBalance,omitnil,omitempty" name:"SupportAutoLoadBalance"` // 是否支持接入模式 - // 注意:此字段可能返回 null,表示取不到有效值。 SupportAccessMode *bool `json:"SupportAccessMode,omitnil,omitempty" name:"SupportAccessMode"` // 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 @@ -8923,14 +9734,14 @@ func (r *DescribeRemoteBackupConfigResponse) FromJsonString(s string) error { // Predefined struct for user type DescribeRoGroupsRequestParams struct { - // 实例ID,格式如:cdb-c1nl9rpv或者cdb-c1nl9rpv,与云数据库控制台页面中显示的实例ID相同。 + // 实例 ID,格式如:cdb-c1nl9rpv,与云数据库控制台页面中显示的实例 ID 相同。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` } type DescribeRoGroupsRequest struct { *tchttp.BaseRequest - // 实例ID,格式如:cdb-c1nl9rpv或者cdb-c1nl9rpv,与云数据库控制台页面中显示的实例ID相同。 + // 实例 ID,格式如:cdb-c1nl9rpv,与云数据库控制台页面中显示的实例 ID 相同。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` } @@ -8955,7 +9766,7 @@ func (r *DescribeRoGroupsRequest) FromJsonString(s string) error { // Predefined struct for user type DescribeRoGroupsResponseParams struct { - // RO组信息数组,一个实例可关联多个RO组。 + // RO 组信息数组,一个实例可关联多个 RO 组。 RoGroups []*RoGroup `json:"RoGroups,omitnil,omitempty" name:"RoGroups"` // 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 @@ -9127,7 +9938,7 @@ type DescribeRollbackTaskDetailRequestParams struct { // 异步任务 ID。 AsyncRequestId *string `json:"AsyncRequestId,omitnil,omitempty" name:"AsyncRequestId"` - // 分页参数,每次请求返回的记录数。默认值为 20,最大值为 100。 + // 分页参数,每次请求返回的记录数。默认值为20,建议最大取值为100。 Limit *int64 `json:"Limit,omitnil,omitempty" name:"Limit"` // 分页偏移量。默认为 0。 @@ -9143,7 +9954,7 @@ type DescribeRollbackTaskDetailRequest struct { // 异步任务 ID。 AsyncRequestId *string `json:"AsyncRequestId,omitnil,omitempty" name:"AsyncRequestId"` - // 分页参数,每次请求返回的记录数。默认值为 20,最大值为 100。 + // 分页参数,每次请求返回的记录数。默认值为20,建议最大取值为100。 Limit *int64 `json:"Limit,omitnil,omitempty" name:"Limit"` // 分页偏移量。默认为 0。 @@ -9178,7 +9989,6 @@ type DescribeRollbackTaskDetailResponseParams struct { TotalCount *int64 `json:"TotalCount,omitnil,omitempty" name:"TotalCount"` // 回档任务详情。 - // 注意:此字段可能返回 null,表示取不到有效值。 Items []*RollbackTask `json:"Items,omitnil,omitempty" name:"Items"` // 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 @@ -9203,20 +10013,24 @@ func (r *DescribeRollbackTaskDetailResponse) FromJsonString(s string) error { // Predefined struct for user type DescribeSSLStatusRequestParams struct { - // 实例 ID 。只读组 ID为空时必填。 + // 实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 + // 说明:实例 ID 和只读组 ID 两个参数选其一填写即可。若要查询双节点、三节点实例 SSL 开通情况,请填写实例 ID 参数进行查询。单节点(云盘)、云盘版实例不支持开启 SSL,因此不支持查询。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` - // 只读组 ID。实例 ID为空时必填。 + // 只读组 ID。可通过 [DescribeRoGroups](https://cloud.tencent.com/document/api/236/40939) 接口获取。 + // 说明:实例 ID 和只读组 ID 两个参数选其一填写即可。若要查询只读实例或只读组 SSL 开通情况,请填写 RoGroupId 参数,并注意填写的都是只读组 ID。单节点(云盘)、云盘版实例不支持开启 SSL,因此不支持查询。 RoGroupId *string `json:"RoGroupId,omitnil,omitempty" name:"RoGroupId"` } type DescribeSSLStatusRequest struct { *tchttp.BaseRequest - // 实例 ID 。只读组 ID为空时必填。 + // 实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 + // 说明:实例 ID 和只读组 ID 两个参数选其一填写即可。若要查询双节点、三节点实例 SSL 开通情况,请填写实例 ID 参数进行查询。单节点(云盘)、云盘版实例不支持开启 SSL,因此不支持查询。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` - // 只读组 ID。实例 ID为空时必填。 + // 只读组 ID。可通过 [DescribeRoGroups](https://cloud.tencent.com/document/api/236/40939) 接口获取。 + // 说明:实例 ID 和只读组 ID 两个参数选其一填写即可。若要查询只读实例或只读组 SSL 开通情况,请填写 RoGroupId 参数,并注意填写的都是只读组 ID。单节点(云盘)、云盘版实例不支持开启 SSL,因此不支持查询。 RoGroupId *string `json:"RoGroupId,omitnil,omitempty" name:"RoGroupId"` } @@ -9270,13 +10084,15 @@ func (r *DescribeSSLStatusResponse) FromJsonString(s string) error { // Predefined struct for user type DescribeSlowLogDataRequestParams struct { - // 实例 ID。 + // 实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` - // 开始时间戳。例如 1585142640 。 + // 开始时间戳。例如 1585142640。 + // 说明:此参数单位为秒的时间戳。 StartTime *uint64 `json:"StartTime,omitnil,omitempty" name:"StartTime"` - // 结束时间戳。例如 1585142640 。 + // 结束时间戳。例如 1585142640。 + // 说明:此参数单位为秒的时间戳。 EndTime *uint64 `json:"EndTime,omitnil,omitempty" name:"EndTime"` // 客户端 Host 列表。 @@ -9288,32 +10104,42 @@ type DescribeSlowLogDataRequestParams struct { // 访问的 数据库 列表。 DataBases []*string `json:"DataBases,omitnil,omitempty" name:"DataBases"` - // 排序字段。当前支持:Timestamp,QueryTime,LockTime,RowsExamined,RowsSent 。 + // 排序字段,当前支持字段及含义如下,默认值为 Timestamp。 + // 1. Timestamp:SQL 的执行时间 + // 2. QueryTime:SQL 的执行时长(秒) + // 3. LockTime:锁时长(秒) + // 4. RowsExamined:扫描行数 + // 5. RowsSent:结果集行数 SortBy *string `json:"SortBy,omitnil,omitempty" name:"SortBy"` - // 升序还是降序排列。当前支持:ASC,DESC 。 + // 升序还是降序排列。当前支持值为 ASC - 升序,DESC - 降序 ,默认值为 ASC。 OrderBy *string `json:"OrderBy,omitnil,omitempty" name:"OrderBy"` // 偏移量,默认为0,最大为9999。 Offset *int64 `json:"Offset,omitnil,omitempty" name:"Offset"` - // 一次性返回的记录数量,默认为100,最大为400。 + // 一次性返回的记录数量,默认为100,最大为800。 Limit *int64 `json:"Limit,omitnil,omitempty" name:"Limit"` // 仅在实例为主实例或者灾备实例时生效,可选值:slave,代表拉取从机的日志。 InstType *string `json:"InstType,omitnil,omitempty" name:"InstType"` + + // 节点ID + OpResourceId *string `json:"OpResourceId,omitnil,omitempty" name:"OpResourceId"` } type DescribeSlowLogDataRequest struct { *tchttp.BaseRequest - // 实例 ID。 + // 实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` - // 开始时间戳。例如 1585142640 。 + // 开始时间戳。例如 1585142640。 + // 说明:此参数单位为秒的时间戳。 StartTime *uint64 `json:"StartTime,omitnil,omitempty" name:"StartTime"` - // 结束时间戳。例如 1585142640 。 + // 结束时间戳。例如 1585142640。 + // 说明:此参数单位为秒的时间戳。 EndTime *uint64 `json:"EndTime,omitnil,omitempty" name:"EndTime"` // 客户端 Host 列表。 @@ -9325,20 +10151,28 @@ type DescribeSlowLogDataRequest struct { // 访问的 数据库 列表。 DataBases []*string `json:"DataBases,omitnil,omitempty" name:"DataBases"` - // 排序字段。当前支持:Timestamp,QueryTime,LockTime,RowsExamined,RowsSent 。 + // 排序字段,当前支持字段及含义如下,默认值为 Timestamp。 + // 1. Timestamp:SQL 的执行时间 + // 2. QueryTime:SQL 的执行时长(秒) + // 3. LockTime:锁时长(秒) + // 4. RowsExamined:扫描行数 + // 5. RowsSent:结果集行数 SortBy *string `json:"SortBy,omitnil,omitempty" name:"SortBy"` - // 升序还是降序排列。当前支持:ASC,DESC 。 + // 升序还是降序排列。当前支持值为 ASC - 升序,DESC - 降序 ,默认值为 ASC。 OrderBy *string `json:"OrderBy,omitnil,omitempty" name:"OrderBy"` // 偏移量,默认为0,最大为9999。 Offset *int64 `json:"Offset,omitnil,omitempty" name:"Offset"` - // 一次性返回的记录数量,默认为100,最大为400。 + // 一次性返回的记录数量,默认为100,最大为800。 Limit *int64 `json:"Limit,omitnil,omitempty" name:"Limit"` // 仅在实例为主实例或者灾备实例时生效,可选值:slave,代表拉取从机的日志。 InstType *string `json:"InstType,omitnil,omitempty" name:"InstType"` + + // 节点ID + OpResourceId *string `json:"OpResourceId,omitnil,omitempty" name:"OpResourceId"` } func (r *DescribeSlowLogDataRequest) ToJsonString() string { @@ -9364,6 +10198,7 @@ func (r *DescribeSlowLogDataRequest) FromJsonString(s string) error { delete(f, "Offset") delete(f, "Limit") delete(f, "InstType") + delete(f, "OpResourceId") if len(f) > 0 { return tcerr.NewTencentCloudSDKError("ClientError.BuildRequestError", "DescribeSlowLogDataRequest has unknown keys!", "") } @@ -9376,7 +10211,6 @@ type DescribeSlowLogDataResponseParams struct { TotalCount *int64 `json:"TotalCount,omitnil,omitempty" name:"TotalCount"` // 查询到的记录。 - // 注意:此字段可能返回 null,表示取不到有效值。 Items []*SlowLogItem `json:"Items,omitnil,omitempty" name:"Items"` // 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 @@ -9407,7 +10241,7 @@ type DescribeSlowLogsRequestParams struct { // 偏移量,默认值为0,最小值为0。 Offset *int64 `json:"Offset,omitnil,omitempty" name:"Offset"` - // 分页大小,默认值为20,最小值为1,最大值为100。 + // 分页大小,默认值为20,最小值为1,最大值为1000。 Limit *int64 `json:"Limit,omitnil,omitempty" name:"Limit"` } @@ -9420,7 +10254,7 @@ type DescribeSlowLogsRequest struct { // 偏移量,默认值为0,最小值为0。 Offset *int64 `json:"Offset,omitnil,omitempty" name:"Offset"` - // 分页大小,默认值为20,最小值为1,最大值为100。 + // 分页大小,默认值为20,最小值为1,最大值为1000。 Limit *int64 `json:"Limit,omitnil,omitempty" name:"Limit"` } @@ -9539,6 +10373,80 @@ func (r *DescribeSupportedPrivilegesResponse) FromJsonString(s string) error { return json.Unmarshal([]byte(s), &r) } +// Predefined struct for user +type DescribeTableColumnsRequestParams struct { + // 实例 ID,格式如:cdb-c1nl9rpv,与云数据库控制台页面中显示的实例ID相同,可使用[查询实例列表](https://cloud.tencent.com/document/api/236/15872) 接口获取,其值为输出参数中字段 InstanceId 的值。 + InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` + + // 数据库名称,可使用 [查询数据库](https://cloud.tencent.com/document/api/236/17493) 接口获得。 + Database *string `json:"Database,omitnil,omitempty" name:"Database"` + + // 数据库中的表的名称。 + Table *string `json:"Table,omitnil,omitempty" name:"Table"` +} + +type DescribeTableColumnsRequest struct { + *tchttp.BaseRequest + + // 实例 ID,格式如:cdb-c1nl9rpv,与云数据库控制台页面中显示的实例ID相同,可使用[查询实例列表](https://cloud.tencent.com/document/api/236/15872) 接口获取,其值为输出参数中字段 InstanceId 的值。 + InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` + + // 数据库名称,可使用 [查询数据库](https://cloud.tencent.com/document/api/236/17493) 接口获得。 + Database *string `json:"Database,omitnil,omitempty" name:"Database"` + + // 数据库中的表的名称。 + Table *string `json:"Table,omitnil,omitempty" name:"Table"` +} + +func (r *DescribeTableColumnsRequest) ToJsonString() string { + b, _ := json.Marshal(r) + return string(b) +} + +// FromJsonString It is highly **NOT** recommended to use this function +// because it has no param check, nor strict type check +func (r *DescribeTableColumnsRequest) FromJsonString(s string) error { + f := make(map[string]interface{}) + if err := json.Unmarshal([]byte(s), &f); err != nil { + return err + } + delete(f, "InstanceId") + delete(f, "Database") + delete(f, "Table") + if len(f) > 0 { + return tcerr.NewTencentCloudSDKError("ClientError.BuildRequestError", "DescribeTableColumnsRequest has unknown keys!", "") + } + return json.Unmarshal([]byte(s), &r) +} + +// Predefined struct for user +type DescribeTableColumnsResponseParams struct { + // 符合查询条件的实例总数。 + TotalCount *int64 `json:"TotalCount,omitnil,omitempty" name:"TotalCount"` + + // 返回的数据库列信息。 + Items []*string `json:"Items,omitnil,omitempty" name:"Items"` + + // 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 + RequestId *string `json:"RequestId,omitnil,omitempty" name:"RequestId"` +} + +type DescribeTableColumnsResponse struct { + *tchttp.BaseResponse + Response *DescribeTableColumnsResponseParams `json:"Response"` +} + +func (r *DescribeTableColumnsResponse) ToJsonString() string { + b, _ := json.Marshal(r) + return string(b) +} + +// FromJsonString It is highly **NOT** recommended to use this function +// because it has no param check, nor strict type check +func (r *DescribeTableColumnsResponse) FromJsonString(s string) error { + return json.Unmarshal([]byte(s), &r) +} + // Predefined struct for user type DescribeTablesRequestParams struct { // 实例 ID,格式如:cdb-c1nl9rpv,与云数据库控制台页面中显示的实例 ID 相同。 @@ -9550,7 +10458,7 @@ type DescribeTablesRequestParams struct { // 记录偏移量,默认值为0。 Offset *int64 `json:"Offset,omitnil,omitempty" name:"Offset"` - // 单次请求返回的数量,默认值为20,最大值为2000。 + // 单次请求返回的数量,默认值为20,最大值为5000。 Limit *int64 `json:"Limit,omitnil,omitempty" name:"Limit"` // 匹配数据库表名的正则表达式,规则同 MySQL 官网 @@ -9569,7 +10477,7 @@ type DescribeTablesRequest struct { // 记录偏移量,默认值为0。 Offset *int64 `json:"Offset,omitnil,omitempty" name:"Offset"` - // 单次请求返回的数量,默认值为20,最大值为2000。 + // 单次请求返回的数量,默认值为20,最大值为5000。 Limit *int64 `json:"Limit,omitnil,omitempty" name:"Limit"` // 匹配数据库表名的正则表达式,规则同 MySQL 官网 @@ -9629,26 +10537,26 @@ func (r *DescribeTablesResponse) FromJsonString(s string) error { // Predefined struct for user type DescribeTagsOfInstanceIdsRequestParams struct { - // 实例列表。 + // 实例列表。实例 ID 可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。可传入的数组长度暂无限制。 InstanceIds []*string `json:"InstanceIds,omitnil,omitempty" name:"InstanceIds"` // 分页偏移量。 Offset *int64 `json:"Offset,omitnil,omitempty" name:"Offset"` - // 分页大小。 + // 分页大小。默认为15。 Limit *int64 `json:"Limit,omitnil,omitempty" name:"Limit"` } type DescribeTagsOfInstanceIdsRequest struct { *tchttp.BaseRequest - // 实例列表。 + // 实例列表。实例 ID 可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。可传入的数组长度暂无限制。 InstanceIds []*string `json:"InstanceIds,omitnil,omitempty" name:"InstanceIds"` // 分页偏移量。 Offset *int64 `json:"Offset,omitnil,omitempty" name:"Offset"` - // 分页大小。 + // 分页大小。默认为15。 Limit *int64 `json:"Limit,omitnil,omitempty" name:"Limit"` } @@ -10065,26 +10973,26 @@ type DeviceNetInfo struct { // Predefined struct for user type DisassociateSecurityGroupsRequestParams struct { - // 安全组 ID。 + // 安全组 ID。可通过 [DescribeDBSecurityGroups](https://cloud.tencent.com/document/api/236/15854) 接口获取。 SecurityGroupId *string `json:"SecurityGroupId,omitnil,omitempty" name:"SecurityGroupId"` - // 实例 ID 列表,一个或者多个实例 ID 组成的数组。 + // 实例 ID 列表,一个或者多个实例 ID 组成的数组。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 InstanceIds []*string `json:"InstanceIds,omitnil,omitempty" name:"InstanceIds"` - // 当传入只读实例ID时,默认操作的是对应只读组的安全组。如果需要操作只读实例ID的安全组, 需要将该入参置为True + // 当传入只读实例 ID 时,默认操作的是对应只读组的安全组。如果需要操作只读实例 ID 的安全组,需要将该入参置为 True,默认为 False。 ForReadonlyInstance *bool `json:"ForReadonlyInstance,omitnil,omitempty" name:"ForReadonlyInstance"` } type DisassociateSecurityGroupsRequest struct { *tchttp.BaseRequest - // 安全组 ID。 + // 安全组 ID。可通过 [DescribeDBSecurityGroups](https://cloud.tencent.com/document/api/236/15854) 接口获取。 SecurityGroupId *string `json:"SecurityGroupId,omitnil,omitempty" name:"SecurityGroupId"` - // 实例 ID 列表,一个或者多个实例 ID 组成的数组。 + // 实例 ID 列表,一个或者多个实例 ID 组成的数组。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 InstanceIds []*string `json:"InstanceIds,omitnil,omitempty" name:"InstanceIds"` - // 当传入只读实例ID时,默认操作的是对应只读组的安全组。如果需要操作只读实例ID的安全组, 需要将该入参置为True + // 当传入只读实例 ID 时,默认操作的是对应只读组的安全组。如果需要操作只读实例 ID 的安全组,需要将该入参置为 True,默认为 False。 ForReadonlyInstance *bool `json:"ForReadonlyInstance,omitnil,omitempty" name:"ForReadonlyInstance"` } @@ -10131,6 +11039,14 @@ func (r *DisassociateSecurityGroupsResponse) FromJsonString(s string) error { return json.Unmarshal([]byte(s), &r) } +type DiskTypeConfigItem struct { + // 磁盘对应的实例类型。仅支持单节点基础型和集群版。 + DeviceType *string `json:"DeviceType,omitnil,omitempty" name:"DeviceType"` + + // 可以选择的磁盘类型列表。 + DiskType []*string `json:"DiskType,omitnil,omitempty" name:"DiskType"` +} + type DrInfo struct { // 灾备实例状态 Status *int64 `json:"Status,omitnil,omitempty" name:"Status"` @@ -10160,23 +11076,49 @@ type DrInfo struct { } type ErrlogItem struct { - // 错误发生时间。 - // 注意:此字段可能返回 null,表示取不到有效值。 + // 错误发生时间。时间戳,秒级 Timestamp *uint64 `json:"Timestamp,omitnil,omitempty" name:"Timestamp"` // 错误详情 - // 注意:此字段可能返回 null,表示取不到有效值。 Content *string `json:"Content,omitnil,omitempty" name:"Content"` } +type HistoryJob struct { + // 操作类型 + OperationType *string `json:"OperationType,omitnil,omitempty" name:"OperationType"` + + // 扩容类型 + ExpandType *string `json:"ExpandType,omitnil,omitempty" name:"ExpandType"` + + // 扩容开始时间 + // 说明:此项显示的格式是 int 类型的 unix 时间戳 + StartTime *int64 `json:"StartTime,omitnil,omitempty" name:"StartTime"` + + // 扩容结束时间 + // 说明:此项显示的格式是 int 类型的 unix 时间戳 + EndTime *int64 `json:"EndTime,omitnil,omitempty" name:"EndTime"` + + // 扩容前核数 + OldCpu *int64 `json:"OldCpu,omitnil,omitempty" name:"OldCpu"` + + // 扩容后核数 + NewCpu *int64 `json:"NewCpu,omitnil,omitempty" name:"NewCpu"` + + // 增减的cpu数 + ExtendCPUNum *int64 `json:"ExtendCPUNum,omitnil,omitempty" name:"ExtendCPUNum"` + + // extend_failed操作上报 + Error *string `json:"Error,omitnil,omitempty" name:"Error"` +} + type ImportRecord struct { - // 状态值 + // 状态值。0 - 初始化中,1 - 运行中,2 - 运行成功,3 - 运行失败。 Status *int64 `json:"Status,omitnil,omitempty" name:"Status"` - // 状态值 + // 状态值,为负数时任务异常。 Code *int64 `json:"Code,omitnil,omitempty" name:"Code"` - // 执行时间 + // 执行时间,单位:秒。 CostTime *int64 `json:"CostTime,omitnil,omitempty" name:"CostTime"` // 实例ID @@ -10188,13 +11130,13 @@ type ImportRecord struct { // 导入文件名 FileName *string `json:"FileName,omitnil,omitempty" name:"FileName"` - // 执行进度 + // 执行进度,单位:百分比。 Process *int64 `json:"Process,omitnil,omitempty" name:"Process"` // 任务创建时间 CreateTime *string `json:"CreateTime,omitnil,omitempty" name:"CreateTime"` - // 文件大小 + // 文件大小,单位:byte。 FileSize *string `json:"FileSize,omitnil,omitempty" name:"FileSize"` // 任务执行信息 @@ -10229,88 +11171,13 @@ type Inbound struct { // 地址模块 AddressModule *string `json:"AddressModule,omitnil,omitempty" name:"AddressModule"` + // 规则ID,嵌套安全组的规则ID + Id *string `json:"Id,omitnil,omitempty" name:"Id"` + // 规则描述 Desc *string `json:"Desc,omitnil,omitempty" name:"Desc"` } -// Predefined struct for user -type InitDBInstancesRequestParams struct { - // 实例ID,格式如:cdb-c1nl9rpv,与云数据库控制台页面中显示的实例ID相同,可使用[查询实例列表](https://cloud.tencent.com/document/api/236/15872) 接口获取,其值为输出参数中字段 InstanceId 的值。 - InstanceIds []*string `json:"InstanceIds,omitnil,omitempty" name:"InstanceIds"` - - // 实例新的密码,密码规则:8-64个字符,至少包含字母、数字、字符(支持的字符:!@#$%^*())中的两种。 - NewPassword *string `json:"NewPassword,omitnil,omitempty" name:"NewPassword"` - - // 实例的参数列表,目前支持设置“character_set_server”、“lower_case_table_names”参数。其中,“character_set_server”参数可选值为["utf8","latin1","gbk","utf8mb4"];“lower_case_table_names”可选值为[“0”,“1”]。 - Parameters []*ParamInfo `json:"Parameters,omitnil,omitempty" name:"Parameters"` - - // 实例的端口,取值范围为[1024, 65535] - Vport *int64 `json:"Vport,omitnil,omitempty" name:"Vport"` -} - -type InitDBInstancesRequest struct { - *tchttp.BaseRequest - - // 实例ID,格式如:cdb-c1nl9rpv,与云数据库控制台页面中显示的实例ID相同,可使用[查询实例列表](https://cloud.tencent.com/document/api/236/15872) 接口获取,其值为输出参数中字段 InstanceId 的值。 - InstanceIds []*string `json:"InstanceIds,omitnil,omitempty" name:"InstanceIds"` - - // 实例新的密码,密码规则:8-64个字符,至少包含字母、数字、字符(支持的字符:!@#$%^*())中的两种。 - NewPassword *string `json:"NewPassword,omitnil,omitempty" name:"NewPassword"` - - // 实例的参数列表,目前支持设置“character_set_server”、“lower_case_table_names”参数。其中,“character_set_server”参数可选值为["utf8","latin1","gbk","utf8mb4"];“lower_case_table_names”可选值为[“0”,“1”]。 - Parameters []*ParamInfo `json:"Parameters,omitnil,omitempty" name:"Parameters"` - - // 实例的端口,取值范围为[1024, 65535] - Vport *int64 `json:"Vport,omitnil,omitempty" name:"Vport"` -} - -func (r *InitDBInstancesRequest) ToJsonString() string { - b, _ := json.Marshal(r) - return string(b) -} - -// FromJsonString It is highly **NOT** recommended to use this function -// because it has no param check, nor strict type check -func (r *InitDBInstancesRequest) FromJsonString(s string) error { - f := make(map[string]interface{}) - if err := json.Unmarshal([]byte(s), &f); err != nil { - return err - } - delete(f, "InstanceIds") - delete(f, "NewPassword") - delete(f, "Parameters") - delete(f, "Vport") - if len(f) > 0 { - return tcerr.NewTencentCloudSDKError("ClientError.BuildRequestError", "InitDBInstancesRequest has unknown keys!", "") - } - return json.Unmarshal([]byte(s), &r) -} - -// Predefined struct for user -type InitDBInstancesResponseParams struct { - // 异步任务的请求ID数组,可使用此ID查询异步任务的执行结果 - AsyncRequestIds []*string `json:"AsyncRequestIds,omitnil,omitempty" name:"AsyncRequestIds"` - - // 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 - RequestId *string `json:"RequestId,omitnil,omitempty" name:"RequestId"` -} - -type InitDBInstancesResponse struct { - *tchttp.BaseResponse - Response *InitDBInstancesResponseParams `json:"Response"` -} - -func (r *InitDBInstancesResponse) ToJsonString() string { - b, _ := json.Marshal(r) - return string(b) -} - -// FromJsonString It is highly **NOT** recommended to use this function -// because it has no param check, nor strict type check -func (r *InitDBInstancesResponse) FromJsonString(s string) error { - return json.Unmarshal([]byte(s), &r) -} - // Predefined struct for user type InquiryPriceUpgradeInstancesRequestParams struct { // 实例 ID,格式如:cdb-c1nl9rpv 或者 cdbro-c1nl9rpv。与云数据库控制台页面中显示的实例 ID 相同,可使用 [查询实例列表](https://cloud.tencent.com/document/api/236/15872) 接口获取,其值为输出参数中字段 InstanceId 的值。 @@ -10413,6 +11280,23 @@ func (r *InquiryPriceUpgradeInstancesResponse) FromJsonString(s string) error { return json.Unmarshal([]byte(s), &r) } +type InstEventInfo struct { + // 事件名称。 + EventName *string `json:"EventName,omitnil,omitempty" name:"EventName"` + + // 事件状态。 + EventStatus *string `json:"EventStatus,omitnil,omitempty" name:"EventStatus"` + + // 事件发生时间。 + OccurTime *string `json:"OccurTime,omitnil,omitempty" name:"OccurTime"` + + // 实例ID。 + InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` + + // 节点ID + NodeId *string `json:"NodeId,omitnil,omitempty" name:"NodeId"` +} + type InstanceAuditLogFilters struct { // 过滤项。目前支持以下搜索条件: // @@ -10462,55 +11346,57 @@ type InstanceDbAuditStatus struct { AuditStatus *string `json:"AuditStatus,omitnil,omitempty" name:"AuditStatus"` // 任务状态。0-无任务;1-审计开启中,2-审计关闭中。 - // 注意:此字段可能返回 null,表示取不到有效值。 AuditTask *uint64 `json:"AuditTask,omitnil,omitempty" name:"AuditTask"` - // 日志保留时长。 - // 注意:此字段可能返回 null,表示取不到有效值。 + // 日志保留时长。支持值包括: + // 7 - 一周; + // 30 - 一个月; + // 90 - 三个月; + // 180 - 六个月; + // 365 - 一年; + // 1095 - 三年; + // 1825 - 五年。 LogExpireDay *uint64 `json:"LogExpireDay,omitnil,omitempty" name:"LogExpireDay"` - // 高频存储时长。 - // 注意:此字段可能返回 null,表示取不到有效值。 + // 高频存储时长。支持值包括: + // 3 - 3天; + // 7 - 一周; + // 30 - 一个月; + // 90 - 三个月; + // 180 - 六个月; + // 365 - 一年; + // 1095 - 三年; + // 1825 - 五年。 HighLogExpireDay *uint64 `json:"HighLogExpireDay,omitnil,omitempty" name:"HighLogExpireDay"` - // 低频存储时长。 - // 注意:此字段可能返回 null,表示取不到有效值。 + // 低频存储时长。单位:天,等于日志保存时长减去高频存储时长。 LowLogExpireDay *uint64 `json:"LowLogExpireDay,omitnil,omitempty" name:"LowLogExpireDay"` - // 日志存储量。 - // 注意:此字段可能返回 null,表示取不到有效值。 + // 日志存储量(单位:GB)。 BillingAmount *float64 `json:"BillingAmount,omitnil,omitempty" name:"BillingAmount"` - // 高频存储量。 - // 注意:此字段可能返回 null,表示取不到有效值。 + // 高频存储量(单位:GB)。 HighRealStorage *float64 `json:"HighRealStorage,omitnil,omitempty" name:"HighRealStorage"` - // 低频存储量。 - // 注意:此字段可能返回 null,表示取不到有效值。 + // 低频存储量(单位:GB)。 LowRealStorage *float64 `json:"LowRealStorage,omitnil,omitempty" name:"LowRealStorage"` // 是否为全审计。true-表示全审计。 - // 注意:此字段可能返回 null,表示取不到有效值。 AuditAll *bool `json:"AuditAll,omitnil,omitempty" name:"AuditAll"` // 审计开通时间。 - // 注意:此字段可能返回 null,表示取不到有效值。 CreateAt *string `json:"CreateAt,omitnil,omitempty" name:"CreateAt"` // 实例相关信息 - // 注意:此字段可能返回 null,表示取不到有效值。 InstanceInfo *AuditInstanceInfo `json:"InstanceInfo,omitnil,omitempty" name:"InstanceInfo"` - // 总存储量。 - // 注意:此字段可能返回 null,表示取不到有效值。 + // 总存储量(单位:GB)。 RealStorage *float64 `json:"RealStorage,omitnil,omitempty" name:"RealStorage"` // 是否包含审计策略 - // 注意:此字段可能返回 null,表示取不到有效值。 OldRule *bool `json:"OldRule,omitnil,omitempty" name:"OldRule"` // 实例所应用的规则模板。 - // 注意:此字段可能返回 null,表示取不到有效值。 RuleTemplateIds []*string `json:"RuleTemplateIds,omitnil,omitempty" name:"RuleTemplateIds"` } @@ -10525,7 +11411,6 @@ type InstanceInfo struct { InitFlag *int64 `json:"InitFlag,omitnil,omitempty" name:"InitFlag"` // 只读vip信息。单独开通只读实例访问的只读实例才有该字段 - // 注意:此字段可能返回 null,表示取不到有效值。 RoVipInfo *RoVipInfo `json:"RoVipInfo,omitnil,omitempty" name:"RoVipInfo"` // 内存容量,单位为 MB @@ -10538,7 +11423,6 @@ type InstanceInfo struct { VpcId *int64 `json:"VpcId,omitnil,omitempty" name:"VpcId"` // 备机信息 - // 注意:此字段可能返回 null,表示取不到有效值。 SlaveInfo *SlaveInfo `json:"SlaveInfo,omitnil,omitempty" name:"SlaveInfo"` // 实例 ID @@ -10554,7 +11438,6 @@ type InstanceInfo struct { ProtectMode *int64 `json:"ProtectMode,omitnil,omitempty" name:"ProtectMode"` // 只读组详细信息 - // 注意:此字段可能返回 null,表示取不到有效值。 RoGroups []*RoGroup `json:"RoGroups,omitnil,omitempty" name:"RoGroups"` // 子网 ID,例如:2333 @@ -10579,7 +11462,6 @@ type InstanceInfo struct { TaskStatus *int64 `json:"TaskStatus,omitnil,omitempty" name:"TaskStatus"` // 主实例详细信息 - // 注意:此字段可能返回 null,表示取不到有效值。 MasterInfo *MasterInfo `json:"MasterInfo,omitnil,omitempty" name:"MasterInfo"` // 实例类型 @@ -10592,7 +11474,6 @@ type InstanceInfo struct { InstanceName *string `json:"InstanceName,omitnil,omitempty" name:"InstanceName"` // 灾备实例详细信息 - // 注意:此字段可能返回 null,表示取不到有效值。 DrInfo []*DrInfo `json:"DrInfo,omitnil,omitempty" name:"DrInfo"` // 外网域名 @@ -10635,50 +11516,52 @@ type InstanceInfo struct { ZoneName *string `json:"ZoneName,omitnil,omitempty" name:"ZoneName"` // 物理机型 - // 注意:此字段可能返回 null,表示取不到有效值。 DeviceClass *string `json:"DeviceClass,omitnil,omitempty" name:"DeviceClass"` // 置放群组 ID - // 注意:此字段可能返回 null,表示取不到有效值。 DeployGroupId *string `json:"DeployGroupId,omitnil,omitempty" name:"DeployGroupId"` // 可用区 ID - // 注意:此字段可能返回 null,表示取不到有效值。 ZoneId *int64 `json:"ZoneId,omitnil,omitempty" name:"ZoneId"` // 节点数 InstanceNodes *int64 `json:"InstanceNodes,omitnil,omitempty" name:"InstanceNodes"` // 标签列表 - // 注意:此字段可能返回 null,表示取不到有效值。 TagList []*TagInfoItem `json:"TagList,omitnil,omitempty" name:"TagList"` // 引擎类型 - // 注意:此字段可能返回 null,表示取不到有效值。 EngineType *string `json:"EngineType,omitnil,omitempty" name:"EngineType"` // 最大延迟阈值 - // 注意:此字段可能返回 null,表示取不到有效值。 MaxDelayTime *int64 `json:"MaxDelayTime,omitnil,omitempty" name:"MaxDelayTime"` // 实例磁盘类型,仅云盘版实例才返回该值。可能的值为 CLOUD_SSD:SSD云硬盘, CLOUD_HSSD:增强型SSD云硬盘 DiskType *string `json:"DiskType,omitnil,omitempty" name:"DiskType"` // 当前扩容的CPU核心数。 - // 注意:此字段可能返回 null,表示取不到有效值。 ExpandCpu *int64 `json:"ExpandCpu,omitnil,omitempty" name:"ExpandCpu"` + + // 实例集群版节点信息 + ClusterInfo []*ClusterInfo `json:"ClusterInfo,omitnil,omitempty" name:"ClusterInfo"` + + // 分析引擎节点列表 + AnalysisNodeInfos []*AnalysisNodeInfo `json:"AnalysisNodeInfos,omitnil,omitempty" name:"AnalysisNodeInfos"` + + // 设备带宽,单位G。当DeviceClass不为空时此参数才有效。例:25-表示当前设备带宽为25G;10-表示当前设备带宽为10G。 + DeviceBandwidth *uint64 `json:"DeviceBandwidth,omitnil,omitempty" name:"DeviceBandwidth"` } type InstanceRebootTime struct { - // 实例ID,格式如:cdb-c1nl9rpv,与云数据库控制台页面中显示的实例ID相同 + // 实例 ID,格式如:cdb-c1nl9rpv,与云数据库控制台页面中显示的实例 ID 相同。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` - // 预期重启时间 + // 预期重启时间,单位:秒。 TimeInSeconds *int64 `json:"TimeInSeconds,omitnil,omitempty" name:"TimeInSeconds"` } type InstanceRollbackRangeTime struct { - // 查询数据库错误码 + // 查询数据库错误码。0 - 正常,1600001 - 内部错误,1600003 - 入参异常,1600009 - 实例不存在,1624001 - DB 访问异常。 Code *int64 `json:"Code,omitnil,omitempty" name:"Code"` // 查询数据库错误信息 @@ -10726,7 +11609,8 @@ func (r *IsolateDBInstanceRequest) FromJsonString(s string) error { // Predefined struct for user type IsolateDBInstanceResponseParams struct { // 异步任务的请求 ID,可使用此 ID 查询异步任务的执行结果。(该返回字段目前已废弃,可以通过 DescribeDBInstances 接口查询实例的隔离状态) - // 注意:此字段可能返回 null,表示取不到有效值。 + // + // Deprecated: AsyncRequestId is deprecated. AsyncRequestId *string `json:"AsyncRequestId,omitnil,omitempty" name:"AsyncRequestId"` // 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 @@ -10750,54 +11634,46 @@ func (r *IsolateDBInstanceResponse) FromJsonString(s string) error { } type LocalBinlogConfig struct { - // 本地binlog保留时长,可取值范围:[72,168]。 + // 本地 binlog 保留时长,可取值范围:[6,168]。 SaveHours *int64 `json:"SaveHours,omitnil,omitempty" name:"SaveHours"` - // 本地binlog空间使用率,可取值范围:[30,50]。 + // 本地 binlog 空间使用率,可取值范围:[30,50]。 MaxUsage *int64 `json:"MaxUsage,omitnil,omitempty" name:"MaxUsage"` } type LocalBinlogConfigDefault struct { - // 本地binlog保留时长,可取值范围:[72,168]。 + // 本地 binlog 保留时长,可取值范围:[6,168]。 SaveHours *int64 `json:"SaveHours,omitnil,omitempty" name:"SaveHours"` - // 本地binlog空间使用率,可取值范围:[30,50]。 + // 本地 binlog 空间使用率,可取值范围:[30,50]。 MaxUsage *int64 `json:"MaxUsage,omitnil,omitempty" name:"MaxUsage"` } type LogRuleTemplateInfo struct { // 模板ID。 - // 注意:此字段可能返回 null,表示取不到有效值。 RuleTemplateId *string `json:"RuleTemplateId,omitnil,omitempty" name:"RuleTemplateId"` // 规则模板名 - // 注意:此字段可能返回 null,表示取不到有效值。 RuleTemplateName *string `json:"RuleTemplateName,omitnil,omitempty" name:"RuleTemplateName"` // 告警等级。1-低风险,2-中风险,3-高风险。 - // 注意:此字段可能返回 null,表示取不到有效值。 AlarmLevel *string `json:"AlarmLevel,omitnil,omitempty" name:"AlarmLevel"` // 规则模板变更状态:0-未变更;1-已变更;2-已删除 - // 注意:此字段可能返回 null,表示取不到有效值。 RuleTemplateStatus *int64 `json:"RuleTemplateStatus,omitnil,omitempty" name:"RuleTemplateStatus"` } type LogToCLSConfig struct { // 投递状态打开或者关闭 - // 注意:此字段可能返回 null,表示取不到有效值。 Status *string `json:"Status,omitnil,omitempty" name:"Status"` // CLS日志集ID - // 注意:此字段可能返回 null,表示取不到有效值。 LogSetId *string `json:"LogSetId,omitnil,omitempty" name:"LogSetId"` // 日志主题ID - // 注意:此字段可能返回 null,表示取不到有效值。 LogTopicId *string `json:"LogTopicId,omitnil,omitempty" name:"LogTopicId"` // CLS服务所在地域 - // 注意:此字段可能返回 null,表示取不到有效值。 ClsRegion *string `json:"ClsRegion,omitnil,omitempty" name:"ClsRegion"` } @@ -10857,15 +11733,44 @@ type MasterInfo struct { ExClusterName *string `json:"ExClusterName,omitnil,omitempty" name:"ExClusterName"` } +type MigrateClusterRoInfo struct { + // 只读实例名称 + RoInstanceId *string `json:"RoInstanceId,omitnil,omitempty" name:"RoInstanceId"` + + // 只读实例CPU核数 + Cpu *int64 `json:"Cpu,omitnil,omitempty" name:"Cpu"` + + // 只读实例内存大小,单位:MB + Memory *int64 `json:"Memory,omitnil,omitempty" name:"Memory"` + + // 只读实例硬盘大小,单位:GB + Volume *int64 `json:"Volume,omitnil,omitempty" name:"Volume"` + + // 磁盘类型。 CLOUD_SSD: SSD云硬盘; CLOUD_HSSD: 增强型SSD云硬盘 + DiskType *string `json:"DiskType,omitnil,omitempty" name:"DiskType"` + + // 可用区 + Zone *string `json:"Zone,omitnil,omitempty" name:"Zone"` + + // 迁移实例类型。支持值包括: "CLOUD_NATIVE_CLUSTER" - 标准型集群版实例, "CLOUD_NATIVE_CLUSTER_EXCLUSIVE" - 加强型集群版实例。 + DeviceType *string `json:"DeviceType,omitnil,omitempty" name:"DeviceType"` + + // 只读实例所在ro组,例:cdbrg-xxx + RoGroupId *string `json:"RoGroupId,omitnil,omitempty" name:"RoGroupId"` + + // 实例当前告警策略id数组 + SrcAlarmPolicyList []*int64 `json:"SrcAlarmPolicyList,omitnil,omitempty" name:"SrcAlarmPolicyList"` +} + // Predefined struct for user type ModifyAccountDescriptionRequestParams struct { // 实例 ID,格式如:cdb-c1nl9rpv,与云数据库控制台页面中显示的实例 ID 相同。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` - // 云数据库账号。 + // 云数据库账号。可通过 [DescribeAccounts](https://cloud.tencent.com/document/api/236/17499) 接口获取。 Accounts []*Account `json:"Accounts,omitnil,omitempty" name:"Accounts"` - // 数据库账号的备注信息。 + // 数据库账号的备注信息。最多支持输入255个字符。 Description *string `json:"Description,omitnil,omitempty" name:"Description"` } @@ -10875,10 +11780,10 @@ type ModifyAccountDescriptionRequest struct { // 实例 ID,格式如:cdb-c1nl9rpv,与云数据库控制台页面中显示的实例 ID 相同。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` - // 云数据库账号。 + // 云数据库账号。可通过 [DescribeAccounts](https://cloud.tencent.com/document/api/236/17499) 接口获取。 Accounts []*Account `json:"Accounts,omitnil,omitempty" name:"Accounts"` - // 数据库账号的备注信息。 + // 数据库账号的备注信息。最多支持输入255个字符。 Description *string `json:"Description,omitnil,omitempty" name:"Description"` } @@ -10933,13 +11838,13 @@ type ModifyAccountHostRequestParams struct { // 实例 ID,格式如:cdb-c1nl9rpv,与云数据库控制台页面中显示的实例 ID 相同。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` - // 账户的名称 + // 账户的名称。可通过 [DescribeAccounts](https://cloud.tencent.com/document/api/236/17499) 接口获取。 User *string `json:"User,omitnil,omitempty" name:"User"` - // 账户的旧主机 + // 账户的旧主机。格式:IP 形式,支持单个 IP 地址或者%。 Host *string `json:"Host,omitnil,omitempty" name:"Host"` - // 账户的新主机 + // 账户的新主机。格式:IP 形式,支持单个 IP 地址或者%。 NewHost *string `json:"NewHost,omitnil,omitempty" name:"NewHost"` } @@ -10949,13 +11854,13 @@ type ModifyAccountHostRequest struct { // 实例 ID,格式如:cdb-c1nl9rpv,与云数据库控制台页面中显示的实例 ID 相同。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` - // 账户的名称 + // 账户的名称。可通过 [DescribeAccounts](https://cloud.tencent.com/document/api/236/17499) 接口获取。 User *string `json:"User,omitnil,omitempty" name:"User"` - // 账户的旧主机 + // 账户的旧主机。格式:IP 形式,支持单个 IP 地址或者%。 Host *string `json:"Host,omitnil,omitempty" name:"Host"` - // 账户的新主机 + // 账户的新主机。格式:IP 形式,支持单个 IP 地址或者%。 NewHost *string `json:"NewHost,omitnil,omitempty" name:"NewHost"` } @@ -11008,7 +11913,7 @@ func (r *ModifyAccountHostResponse) FromJsonString(s string) error { // Predefined struct for user type ModifyAccountMaxUserConnectionsRequestParams struct { - // 云数据库账号。 + // 云数据库账号。可通过 [DescribeAccounts](https://cloud.tencent.com/document/api/236/17499) 接口获取。 Accounts []*Account `json:"Accounts,omitnil,omitempty" name:"Accounts"` // 实例 ID,格式如:cdb-c1nl9rpv,与云数据库控制台页面中显示的实例 ID 相同。 @@ -11021,7 +11926,7 @@ type ModifyAccountMaxUserConnectionsRequestParams struct { type ModifyAccountMaxUserConnectionsRequest struct { *tchttp.BaseRequest - // 云数据库账号。 + // 云数据库账号。可通过 [DescribeAccounts](https://cloud.tencent.com/document/api/236/17499) 接口获取。 Accounts []*Account `json:"Accounts,omitnil,omitempty" name:"Accounts"` // 实例 ID,格式如:cdb-c1nl9rpv,与云数据库控制台页面中显示的实例 ID 相同。 @@ -11085,7 +11990,7 @@ type ModifyAccountPasswordRequestParams struct { // 数据库账号的新密码。密码应至少包含字母、数字和字符(_+-&=!@#$%^*())中的两种,长度为8-64个字符。 NewPassword *string `json:"NewPassword,omitnil,omitempty" name:"NewPassword"` - // 云数据库账号。 + // 云数据库账号。可通过 [DescribeAccounts](https://cloud.tencent.com/document/api/236/17499) 接口获取。 Accounts []*Account `json:"Accounts,omitnil,omitempty" name:"Accounts"` } @@ -11098,7 +12003,7 @@ type ModifyAccountPasswordRequest struct { // 数据库账号的新密码。密码应至少包含字母、数字和字符(_+-&=!@#$%^*())中的两种,长度为8-64个字符。 NewPassword *string `json:"NewPassword,omitnil,omitempty" name:"NewPassword"` - // 云数据库账号。 + // 云数据库账号。可通过 [DescribeAccounts](https://cloud.tencent.com/document/api/236/17499) 接口获取。 Accounts []*Account `json:"Accounts,omitnil,omitempty" name:"Accounts"` } @@ -11153,7 +12058,7 @@ type ModifyAccountPrivilegesRequestParams struct { // 实例 ID,格式如:cdb-c1nl9rpv,与云数据库控制台页面中显示的实例 ID 相同。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` - // 数据库的账号,包括用户名和域名。 + // 数据库的账号,包括用户名和域名。可通过 [DescribeAccounts](https://cloud.tencent.com/document/api/236/17499) 接口获取。 Accounts []*Account `json:"Accounts,omitnil,omitempty" name:"Accounts"` // 全局权限。其中,GlobalPrivileges 中权限的可选值为:"SELECT","INSERT","UPDATE","DELETE","CREATE", "PROCESS", "DROP","REFERENCES","INDEX","ALTER","SHOW DATABASES","CREATE TEMPORARY TABLES","LOCK TABLES","EXECUTE","CREATE VIEW","SHOW VIEW","CREATE ROUTINE","ALTER ROUTINE","EVENT","TRIGGER","CREATE USER","RELOAD","REPLICATION CLIENT","REPLICATION SLAVE"。 @@ -11182,7 +12087,7 @@ type ModifyAccountPrivilegesRequest struct { // 实例 ID,格式如:cdb-c1nl9rpv,与云数据库控制台页面中显示的实例 ID 相同。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` - // 数据库的账号,包括用户名和域名。 + // 数据库的账号,包括用户名和域名。可通过 [DescribeAccounts](https://cloud.tencent.com/document/api/236/17499) 接口获取。 Accounts []*Account `json:"Accounts,omitnil,omitempty" name:"Accounts"` // 全局权限。其中,GlobalPrivileges 中权限的可选值为:"SELECT","INSERT","UPDATE","DELETE","CREATE", "PROCESS", "DROP","REFERENCES","INDEX","ALTER","SHOW DATABASES","CREATE TEMPORARY TABLES","LOCK TABLES","EXECUTE","CREATE VIEW","SHOW VIEW","CREATE ROUTINE","ALTER ROUTINE","EVENT","TRIGGER","CREATE USER","RELOAD","REPLICATION CLIENT","REPLICATION SLAVE"。 @@ -11257,7 +12162,7 @@ func (r *ModifyAccountPrivilegesResponse) FromJsonString(s string) error { // Predefined struct for user type ModifyAuditConfigRequestParams struct { - // 实例 ID。 + // 实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` // 审计日志保存时长。支持值包括: @@ -11270,8 +12175,10 @@ type ModifyAuditConfigRequestParams struct { LogExpireDay *int64 `json:"LogExpireDay,omitnil,omitempty" name:"LogExpireDay"` // 是否关闭审计服务。可选值:true - 关闭审计服务;false - 不关闭审计服务。默认值为 false。 - // 当关闭审计服务时,会删除用户的审计日志和文件,并删除该实例的所有审计策略。 - // CloseAudit、LogExpireDay必须至少提供一个,如果两个都提供则按照CloseAudit优先的逻辑处理。 + // 说明: + // 1. 当关闭审计服务时,会删除用户的审计日志和文件,并删除该实例的所有审计策略。 + // 2. CloseAudit、LogExpireDay 必须至少提供一个,如果两个都提供则按照 CloseAudit 优先的逻辑处理。 + // 3. 可通过设置此参数来关闭审计服务,已关闭后不能通过此接口来开启审计服务。 CloseAudit *bool `json:"CloseAudit,omitnil,omitempty" name:"CloseAudit"` // 高频审计日志保存时长。支持值包括: @@ -11287,7 +12194,7 @@ type ModifyAuditConfigRequestParams struct { type ModifyAuditConfigRequest struct { *tchttp.BaseRequest - // 实例 ID。 + // 实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` // 审计日志保存时长。支持值包括: @@ -11300,8 +12207,10 @@ type ModifyAuditConfigRequest struct { LogExpireDay *int64 `json:"LogExpireDay,omitnil,omitempty" name:"LogExpireDay"` // 是否关闭审计服务。可选值:true - 关闭审计服务;false - 不关闭审计服务。默认值为 false。 - // 当关闭审计服务时,会删除用户的审计日志和文件,并删除该实例的所有审计策略。 - // CloseAudit、LogExpireDay必须至少提供一个,如果两个都提供则按照CloseAudit优先的逻辑处理。 + // 说明: + // 1. 当关闭审计服务时,会删除用户的审计日志和文件,并删除该实例的所有审计策略。 + // 2. CloseAudit、LogExpireDay 必须至少提供一个,如果两个都提供则按照 CloseAudit 优先的逻辑处理。 + // 3. 可通过设置此参数来关闭审计服务,已关闭后不能通过此接口来开启审计服务。 CloseAudit *bool `json:"CloseAudit,omitnil,omitempty" name:"CloseAudit"` // 高频审计日志保存时长。支持值包括: @@ -11442,7 +12351,7 @@ func (r *ModifyAuditRuleResponse) FromJsonString(s string) error { // Predefined struct for user type ModifyAuditRuleTemplatesRequestParams struct { - // 审计规则模板ID。 + // 审计规则模板 ID。可通过 [DescribeAuditRuleTemplates](https://cloud.tencent.com/document/api/236/101811) 接口获取。 RuleTemplateIds []*string `json:"RuleTemplateIds,omitnil,omitempty" name:"RuleTemplateIds"` // 修改后的审计规则。 @@ -11464,7 +12373,7 @@ type ModifyAuditRuleTemplatesRequestParams struct { type ModifyAuditRuleTemplatesRequest struct { *tchttp.BaseRequest - // 审计规则模板ID。 + // 审计规则模板 ID。可通过 [DescribeAuditRuleTemplates](https://cloud.tencent.com/document/api/236/101811) 接口获取。 RuleTemplateIds []*string `json:"RuleTemplateIds,omitnil,omitempty" name:"RuleTemplateIds"` // 修改后的审计规则。 @@ -11531,44 +12440,76 @@ func (r *ModifyAuditRuleTemplatesResponse) FromJsonString(s string) error { // Predefined struct for user type ModifyAuditServiceRequestParams struct { - // 实例ID。 + // 实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` - // 日志保留时长。 + // 日志保留时长。支持值包括: + // 7 - 一周; + // 30 - 一个月; + // 90 - 三个月; + // 180 - 六个月; + // 365 - 一年; + // 1095 - 三年; + // 1825 - 五年。 LogExpireDay *uint64 `json:"LogExpireDay,omitnil,omitempty" name:"LogExpireDay"` - // 高频日志保留时长。 + // 高频日志保留时长。默认值为7,此项取值需小于等于 LogExpireDay,支持值包括: + // 3 - 3天; + // 7 - 一周; + // 30 - 一个月; + // 90 - 三个月; + // 180 - 六个月; + // 365 - 一年; + // 1095 - 三年; + // 1825 - 五年。 HighLogExpireDay *uint64 `json:"HighLogExpireDay,omitnil,omitempty" name:"HighLogExpireDay"` // 修改实例审计规则为全审计。 AuditAll *bool `json:"AuditAll,omitnil,omitempty" name:"AuditAll"` - // 审计规则。 + // 废弃。 + // + // Deprecated: AuditRuleFilters is deprecated. AuditRuleFilters []*AuditRuleFilters `json:"AuditRuleFilters,omitnil,omitempty" name:"AuditRuleFilters"` - // 规则模板ID。 + // 规则模板 ID。可通过 [DescribeAuditRuleTemplates](https://cloud.tencent.com/document/api/236/101811) 接口获取。 RuleTemplateIds []*string `json:"RuleTemplateIds,omitnil,omitempty" name:"RuleTemplateIds"` } type ModifyAuditServiceRequest struct { *tchttp.BaseRequest - // 实例ID。 + // 实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` - // 日志保留时长。 + // 日志保留时长。支持值包括: + // 7 - 一周; + // 30 - 一个月; + // 90 - 三个月; + // 180 - 六个月; + // 365 - 一年; + // 1095 - 三年; + // 1825 - 五年。 LogExpireDay *uint64 `json:"LogExpireDay,omitnil,omitempty" name:"LogExpireDay"` - // 高频日志保留时长。 + // 高频日志保留时长。默认值为7,此项取值需小于等于 LogExpireDay,支持值包括: + // 3 - 3天; + // 7 - 一周; + // 30 - 一个月; + // 90 - 三个月; + // 180 - 六个月; + // 365 - 一年; + // 1095 - 三年; + // 1825 - 五年。 HighLogExpireDay *uint64 `json:"HighLogExpireDay,omitnil,omitempty" name:"HighLogExpireDay"` // 修改实例审计规则为全审计。 AuditAll *bool `json:"AuditAll,omitnil,omitempty" name:"AuditAll"` - // 审计规则。 + // 废弃。 AuditRuleFilters []*AuditRuleFilters `json:"AuditRuleFilters,omitnil,omitempty" name:"AuditRuleFilters"` - // 规则模板ID。 + // 规则模板 ID。可通过 [DescribeAuditRuleTemplates](https://cloud.tencent.com/document/api/236/101811) 接口获取。 RuleTemplateIds []*string `json:"RuleTemplateIds,omitnil,omitempty" name:"RuleTemplateIds"` } @@ -11621,6 +12562,11 @@ func (r *ModifyAuditServiceResponse) FromJsonString(s string) error { // Predefined struct for user type ModifyAutoRenewFlagRequestParams struct { // 实例的 ID,格式如:cdb-c1nl9rpv,与云数据库控制台页面中显示的实例 ID 相同。 + // 说明:可输入多个实例 ID 进行修改,json 格式如下。 + // [ + // "cdb-30z11v8s", + // "cdb-93h11efg" + // ] InstanceIds []*string `json:"InstanceIds,omitnil,omitempty" name:"InstanceIds"` // 自动续费标记,可取值的有:0 - 不自动续费,1 - 自动续费。 @@ -11631,6 +12577,11 @@ type ModifyAutoRenewFlagRequest struct { *tchttp.BaseRequest // 实例的 ID,格式如:cdb-c1nl9rpv,与云数据库控制台页面中显示的实例 ID 相同。 + // 说明:可输入多个实例 ID 进行修改,json 格式如下。 + // [ + // "cdb-30z11v8s", + // "cdb-93h11efg" + // ] InstanceIds []*string `json:"InstanceIds,omitnil,omitempty" name:"InstanceIds"` // 自动续费标记,可取值的有:0 - 不自动续费,1 - 自动续费。 @@ -11681,10 +12632,12 @@ func (r *ModifyAutoRenewFlagResponse) FromJsonString(s string) error { // Predefined struct for user type ModifyBackupConfigRequestParams struct { - // 实例 ID,格式如:cdb-c1nl9rpv。与云数据库控制台页面中显示的实例ID相同。 + // 实例 ID,格式如:cdb-c1nl9rpv。与云数据库控制台页面中显示的实例 ID 相同。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` - // 备份文件的保留时间,单位为天。最小值为7天,最大值为1830天。 + // 数据备份文件的保留时间,单位为天。 + // 1. MySQL 双节点、三节点、云盘版数据备份文件可以保留7天 - 1830天。 + // 2. MySQL 单节点(云盘)数据备份文件可以保留7天 - 30天。 ExpireDays *int64 `json:"ExpireDays,omitnil,omitempty" name:"ExpireDays"` // (将废弃,建议使用 BackupTimeWindow 参数) 备份时间范围,格式为:02:00-06:00,起点和终点时间目前限制为整点,目前可以选择的范围为: 00:00-12:00,02:00-06:00,06:00-10:00,10:00-14:00,14:00-18:00,18:00-22:00,22:00-02:00。 @@ -11693,13 +12646,15 @@ type ModifyBackupConfigRequestParams struct { // 自动备份方式,仅支持:physical - 物理冷备 BackupMethod *string `json:"BackupMethod,omitnil,omitempty" name:"BackupMethod"` - // binlog的保留时间,单位为天。最小值为7天,最大值为1830天。该值的设置不能大于备份文件的保留时间。 + // binlog 的保留时间,单位为天。 + // 1. MySQL 双节点、三节点、云盘版日志备份文件可以保留7天 - 3650天。 + // 2. MySQL 单节点(云盘)日志备份文件可以保留7天 - 30天。 BinlogExpireDays *int64 `json:"BinlogExpireDays,omitnil,omitempty" name:"BinlogExpireDays"` // 备份时间窗,比如要设置每周二和周日 10:00-14:00之间备份,该参数如下:{"Monday": "", "Tuesday": "10:00-14:00", "Wednesday": "", "Thursday": "", "Friday": "", "Saturday": "", "Sunday": "10:00-14:00"} (注:可以设置一周的某几天备份,但是每天的备份时间需要设置为相同的时间段。 如果设置了该字段,将忽略StartTime字段的设置) BackupTimeWindow *CommonTimeWindow `json:"BackupTimeWindow,omitnil,omitempty" name:"BackupTimeWindow"` - // 定期保留开关,off - 不开启定期保留策略,on - 开启定期保留策略,默认为off。首次开启定期保留策略时,BackupPeriodSaveDays,BackupPeriodSaveInterval,BackupPeriodSaveCount,StartBackupPeriodSaveDate参数为必填项,否则定期保留策略不会生效 + // 定期保留开关,off - 不开启定期保留策略,on - 开启定期保留策略,默认为off。 EnableBackupPeriodSave *string `json:"EnableBackupPeriodSave,omitnil,omitempty" name:"EnableBackupPeriodSave"` // 长期保留开关,该字段功能暂未上线,可忽略。off - 不开启长期保留策略,on - 开启长期保留策略,默认为off,如果开启,则BackupPeriodSaveDays,BackupPeriodSaveInterval,BackupPeriodSaveCount参数无效 @@ -11745,10 +12700,12 @@ type ModifyBackupConfigRequestParams struct { type ModifyBackupConfigRequest struct { *tchttp.BaseRequest - // 实例 ID,格式如:cdb-c1nl9rpv。与云数据库控制台页面中显示的实例ID相同。 + // 实例 ID,格式如:cdb-c1nl9rpv。与云数据库控制台页面中显示的实例 ID 相同。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` - // 备份文件的保留时间,单位为天。最小值为7天,最大值为1830天。 + // 数据备份文件的保留时间,单位为天。 + // 1. MySQL 双节点、三节点、云盘版数据备份文件可以保留7天 - 1830天。 + // 2. MySQL 单节点(云盘)数据备份文件可以保留7天 - 30天。 ExpireDays *int64 `json:"ExpireDays,omitnil,omitempty" name:"ExpireDays"` // (将废弃,建议使用 BackupTimeWindow 参数) 备份时间范围,格式为:02:00-06:00,起点和终点时间目前限制为整点,目前可以选择的范围为: 00:00-12:00,02:00-06:00,06:00-10:00,10:00-14:00,14:00-18:00,18:00-22:00,22:00-02:00。 @@ -11757,13 +12714,15 @@ type ModifyBackupConfigRequest struct { // 自动备份方式,仅支持:physical - 物理冷备 BackupMethod *string `json:"BackupMethod,omitnil,omitempty" name:"BackupMethod"` - // binlog的保留时间,单位为天。最小值为7天,最大值为1830天。该值的设置不能大于备份文件的保留时间。 + // binlog 的保留时间,单位为天。 + // 1. MySQL 双节点、三节点、云盘版日志备份文件可以保留7天 - 3650天。 + // 2. MySQL 单节点(云盘)日志备份文件可以保留7天 - 30天。 BinlogExpireDays *int64 `json:"BinlogExpireDays,omitnil,omitempty" name:"BinlogExpireDays"` // 备份时间窗,比如要设置每周二和周日 10:00-14:00之间备份,该参数如下:{"Monday": "", "Tuesday": "10:00-14:00", "Wednesday": "", "Thursday": "", "Friday": "", "Saturday": "", "Sunday": "10:00-14:00"} (注:可以设置一周的某几天备份,但是每天的备份时间需要设置为相同的时间段。 如果设置了该字段,将忽略StartTime字段的设置) BackupTimeWindow *CommonTimeWindow `json:"BackupTimeWindow,omitnil,omitempty" name:"BackupTimeWindow"` - // 定期保留开关,off - 不开启定期保留策略,on - 开启定期保留策略,默认为off。首次开启定期保留策略时,BackupPeriodSaveDays,BackupPeriodSaveInterval,BackupPeriodSaveCount,StartBackupPeriodSaveDate参数为必填项,否则定期保留策略不会生效 + // 定期保留开关,off - 不开启定期保留策略,on - 开启定期保留策略,默认为off。 EnableBackupPeriodSave *string `json:"EnableBackupPeriodSave,omitnil,omitempty" name:"EnableBackupPeriodSave"` // 长期保留开关,该字段功能暂未上线,可忽略。off - 不开启长期保留策略,on - 开启长期保留策略,默认为off,如果开启,则BackupPeriodSaveDays,BackupPeriodSaveInterval,BackupPeriodSaveCount参数无效 @@ -12011,10 +12970,10 @@ func (r *ModifyBackupEncryptionStatusResponse) FromJsonString(s string) error { // Predefined struct for user type ModifyCdbProxyAddressDescRequestParams struct { - // 代理组ID + // 代理组 ID。可通过 [DescribeCdbProxyInfo](https://cloud.tencent.com/document/api/236/90585) 接口获取。 ProxyGroupId *string `json:"ProxyGroupId,omitnil,omitempty" name:"ProxyGroupId"` - // 代理组地址ID + // 代理组地址 ID。可通过 [DescribeCdbProxyInfo](https://cloud.tencent.com/document/api/236/90585) 接口获取。 ProxyAddressId *string `json:"ProxyAddressId,omitnil,omitempty" name:"ProxyAddressId"` // 描述 @@ -12024,10 +12983,10 @@ type ModifyCdbProxyAddressDescRequestParams struct { type ModifyCdbProxyAddressDescRequest struct { *tchttp.BaseRequest - // 代理组ID + // 代理组 ID。可通过 [DescribeCdbProxyInfo](https://cloud.tencent.com/document/api/236/90585) 接口获取。 ProxyGroupId *string `json:"ProxyGroupId,omitnil,omitempty" name:"ProxyGroupId"` - // 代理组地址ID + // 代理组地址 ID。可通过 [DescribeCdbProxyInfo](https://cloud.tencent.com/document/api/236/90585) 接口获取。 ProxyAddressId *string `json:"ProxyAddressId,omitnil,omitempty" name:"ProxyAddressId"` // 描述 @@ -12079,50 +13038,50 @@ func (r *ModifyCdbProxyAddressDescResponse) FromJsonString(s string) error { // Predefined struct for user type ModifyCdbProxyAddressVipAndVPortRequestParams struct { - // 代理组ID + // 代理组 ID。可通过 [DescribeCdbProxyInfo](https://cloud.tencent.com/document/api/236/90585) 接口获取。 ProxyGroupId *string `json:"ProxyGroupId,omitnil,omitempty" name:"ProxyGroupId"` - // 代理组地址ID + // 代理组地址 ID。可通过 [DescribeCdbProxyInfo](https://cloud.tencent.com/document/api/236/90585) 接口获取。 ProxyAddressId *string `json:"ProxyAddressId,omitnil,omitempty" name:"ProxyAddressId"` - // 私有网络ID + // 私有网络 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 UniqVpcId *string `json:"UniqVpcId,omitnil,omitempty" name:"UniqVpcId"` - // 私有子网ID + // 私有子网 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 UniqSubnetId *string `json:"UniqSubnetId,omitnil,omitempty" name:"UniqSubnetId"` - // IP地址 + // IP 地址。若不填写则自动分配子网下的可用 IP。 Vip *string `json:"Vip,omitnil,omitempty" name:"Vip"` - // 端口 + // 端口。默认值3306,取值范围:1024 - 65535。 VPort *uint64 `json:"VPort,omitnil,omitempty" name:"VPort"` - // 旧IP地址回收时间 + // 旧 IP 地址回收时间。单位:小时,默认值:24,取值范围:0 - 168。 ReleaseDuration *uint64 `json:"ReleaseDuration,omitnil,omitempty" name:"ReleaseDuration"` } type ModifyCdbProxyAddressVipAndVPortRequest struct { *tchttp.BaseRequest - // 代理组ID + // 代理组 ID。可通过 [DescribeCdbProxyInfo](https://cloud.tencent.com/document/api/236/90585) 接口获取。 ProxyGroupId *string `json:"ProxyGroupId,omitnil,omitempty" name:"ProxyGroupId"` - // 代理组地址ID + // 代理组地址 ID。可通过 [DescribeCdbProxyInfo](https://cloud.tencent.com/document/api/236/90585) 接口获取。 ProxyAddressId *string `json:"ProxyAddressId,omitnil,omitempty" name:"ProxyAddressId"` - // 私有网络ID + // 私有网络 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 UniqVpcId *string `json:"UniqVpcId,omitnil,omitempty" name:"UniqVpcId"` - // 私有子网ID + // 私有子网 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 UniqSubnetId *string `json:"UniqSubnetId,omitnil,omitempty" name:"UniqSubnetId"` - // IP地址 + // IP 地址。若不填写则自动分配子网下的可用 IP。 Vip *string `json:"Vip,omitnil,omitempty" name:"Vip"` - // 端口 + // 端口。默认值3306,取值范围:1024 - 65535。 VPort *uint64 `json:"VPort,omitnil,omitempty" name:"VPort"` - // 旧IP地址回收时间 + // 旧 IP 地址回收时间。单位:小时,默认值:24,取值范围:0 - 168。 ReleaseDuration *uint64 `json:"ReleaseDuration,omitnil,omitempty" name:"ReleaseDuration"` } @@ -12175,13 +13134,13 @@ func (r *ModifyCdbProxyAddressVipAndVPortResponse) FromJsonString(s string) erro // Predefined struct for user type ModifyCdbProxyParamRequestParams struct { - // 实例ID + // 实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` - // 代理组ID + // 代理组 ID。可通过 [DescribeCdbProxyInfo](https://cloud.tencent.com/document/api/236/90585) 接口获取。 ProxyGroupId *string `json:"ProxyGroupId,omitnil,omitempty" name:"ProxyGroupId"` - // 连接池阈值 + // 连接池阈值。取值范围:大于0,小于等于300。 // 注意:如需使用数据库代理连接池能力,MySQL 8.0 主实例的内核小版本要大于等于 MySQL 8.0 20230630。 ConnectionPoolLimit *uint64 `json:"ConnectionPoolLimit,omitnil,omitempty" name:"ConnectionPoolLimit"` } @@ -12189,13 +13148,13 @@ type ModifyCdbProxyParamRequestParams struct { type ModifyCdbProxyParamRequest struct { *tchttp.BaseRequest - // 实例ID + // 实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` - // 代理组ID + // 代理组 ID。可通过 [DescribeCdbProxyInfo](https://cloud.tencent.com/document/api/236/90585) 接口获取。 ProxyGroupId *string `json:"ProxyGroupId,omitnil,omitempty" name:"ProxyGroupId"` - // 连接池阈值 + // 连接池阈值。取值范围:大于0,小于等于300。 // 注意:如需使用数据库代理连接池能力,MySQL 8.0 主实例的内核小版本要大于等于 MySQL 8.0 20230630。 ConnectionPoolLimit *uint64 `json:"ConnectionPoolLimit,omitnil,omitempty" name:"ConnectionPoolLimit"` } @@ -12245,68 +13204,72 @@ func (r *ModifyCdbProxyParamResponse) FromJsonString(s string) error { // Predefined struct for user type ModifyDBInstanceLogToCLSRequestParams struct { - // 实例ID + // 实例 ID,可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` - // 日志类型:error/slowlog + // 日志类型。error:错误日志,slowlog:慢日志。 LogType *string `json:"LogType,omitnil,omitempty" name:"LogType"` - // 投递状态:ON/OFF + // 投递状态。ON:开启,OFF:关闭。 Status *string `json:"Status,omitnil,omitempty" name:"Status"` - // 是否需要创建日志集 + // 是否需要创建日志集。默认为 false。 CreateLogset *bool `json:"CreateLogset,omitnil,omitempty" name:"CreateLogset"` - // 需要创建日志集时为日志集名称;选择已有日志集时,为日志集ID + // 需要创建日志集时为日志集名称;选择已有日志集时,为日志集 ID。默认为空。 + // 说明:当参数 Status 的值为 ON 时,Logset 和 LogTopic 参数必须填一个。 Logset *string `json:"Logset,omitnil,omitempty" name:"Logset"` - // 是否需要创建日志主题 + // 是否需要创建日志主题。默认为 false。 CreateLogTopic *bool `json:"CreateLogTopic,omitnil,omitempty" name:"CreateLogTopic"` - // 需要创建日志主题时为日志主题名称;选择已有日志主题时,为日志主题ID + // 需要创建日志主题时为日志主题名称;选择已有日志主题时,为日志主题 ID。默认为空。 + // 说明:当参数 Status 的值为 ON 时,Logset 和 LogTopic 参数必须填一个。 LogTopic *string `json:"LogTopic,omitnil,omitempty" name:"LogTopic"` - // 日志主题有效期,不填写时,默认30天 + // 日志主题有效期,不填写时,默认30天,最大值3600。 Period *int64 `json:"Period,omitnil,omitempty" name:"Period"` - // 创建日志主题时,是否创建索引 + // 创建日志主题时,是否创建索引,默认为 false。 CreateIndex *bool `json:"CreateIndex,omitnil,omitempty" name:"CreateIndex"` - // CLS所在地域 + // CLS 所在地域,不填择默认为 Region 的参数值。 ClsRegion *string `json:"ClsRegion,omitnil,omitempty" name:"ClsRegion"` } type ModifyDBInstanceLogToCLSRequest struct { *tchttp.BaseRequest - // 实例ID + // 实例 ID,可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` - // 日志类型:error/slowlog + // 日志类型。error:错误日志,slowlog:慢日志。 LogType *string `json:"LogType,omitnil,omitempty" name:"LogType"` - // 投递状态:ON/OFF + // 投递状态。ON:开启,OFF:关闭。 Status *string `json:"Status,omitnil,omitempty" name:"Status"` - // 是否需要创建日志集 + // 是否需要创建日志集。默认为 false。 CreateLogset *bool `json:"CreateLogset,omitnil,omitempty" name:"CreateLogset"` - // 需要创建日志集时为日志集名称;选择已有日志集时,为日志集ID + // 需要创建日志集时为日志集名称;选择已有日志集时,为日志集 ID。默认为空。 + // 说明:当参数 Status 的值为 ON 时,Logset 和 LogTopic 参数必须填一个。 Logset *string `json:"Logset,omitnil,omitempty" name:"Logset"` - // 是否需要创建日志主题 + // 是否需要创建日志主题。默认为 false。 CreateLogTopic *bool `json:"CreateLogTopic,omitnil,omitempty" name:"CreateLogTopic"` - // 需要创建日志主题时为日志主题名称;选择已有日志主题时,为日志主题ID + // 需要创建日志主题时为日志主题名称;选择已有日志主题时,为日志主题 ID。默认为空。 + // 说明:当参数 Status 的值为 ON 时,Logset 和 LogTopic 参数必须填一个。 LogTopic *string `json:"LogTopic,omitnil,omitempty" name:"LogTopic"` - // 日志主题有效期,不填写时,默认30天 + // 日志主题有效期,不填写时,默认30天,最大值3600。 Period *int64 `json:"Period,omitnil,omitempty" name:"Period"` - // 创建日志主题时,是否创建索引 + // 创建日志主题时,是否创建索引,默认为 false。 CreateIndex *bool `json:"CreateIndex,omitnil,omitempty" name:"CreateIndex"` - // CLS所在地域 + // CLS 所在地域,不填择默认为 Region 的参数值。 ClsRegion *string `json:"ClsRegion,omitnil,omitempty" name:"ClsRegion"` } @@ -12365,7 +13328,7 @@ type ModifyDBInstanceNameRequestParams struct { // 实例 ID,格式如:cdb-c1nl9rpv,与云数据库控制台页面中显示的实例 ID 相同,可使用 [查询实例列表](https://cloud.tencent.com/document/api/236/15872) 接口获取,其值为输出参数中字段 InstanceId 的值。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` - // 修改后的实例名称。 + // 修改后的实例名称,仅支持数字,英文大小写字母、中文以及特殊字符-_./()[]()+=::@ 且长度不能超过60。 InstanceName *string `json:"InstanceName,omitnil,omitempty" name:"InstanceName"` } @@ -12375,7 +13338,7 @@ type ModifyDBInstanceNameRequest struct { // 实例 ID,格式如:cdb-c1nl9rpv,与云数据库控制台页面中显示的实例 ID 相同,可使用 [查询实例列表](https://cloud.tencent.com/document/api/236/15872) 接口获取,其值为输出参数中字段 InstanceId 的值。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` - // 修改后的实例名称。 + // 修改后的实例名称,仅支持数字,英文大小写字母、中文以及特殊字符-_./()[]()+=::@ 且长度不能超过60。 InstanceName *string `json:"InstanceName,omitnil,omitempty" name:"InstanceName"` } @@ -12423,20 +13386,32 @@ func (r *ModifyDBInstanceNameResponse) FromJsonString(s string) error { // Predefined struct for user type ModifyDBInstanceProjectRequestParams struct { - // 实例 ID 数组,格式如:cdb-c1nl9rpv,与云数据库控制台页面中显示的实例 ID 相同,可使用 [查询实例列表](https://cloud.tencent.com/document/api/236/15872) 接口获取,其值为输出参数中字段 InstanceId 的值。 + // 实例 ID,格式如:cdb-c1nl9rpv,与云数据库控制台页面中显示的实例 ID 相同,可使用 [查询实例列表](https://cloud.tencent.com/document/api/236/15872) 接口获取,其值为输出参数中字段 InstanceId 的值。 + // 说明:可输入多个实例 ID 进行修改,json 格式如下。 + // [ + // "cdb-30z11v8s", + // "cdb-93h11efg" + // ] InstanceIds []*string `json:"InstanceIds,omitnil,omitempty" name:"InstanceIds"` - // 项目的 ID。 + // 实例所属项目的 ID,可在账号中心下的项目管理页面查询。 + // 说明:此项为必填。 NewProjectId *int64 `json:"NewProjectId,omitnil,omitempty" name:"NewProjectId"` } type ModifyDBInstanceProjectRequest struct { *tchttp.BaseRequest - // 实例 ID 数组,格式如:cdb-c1nl9rpv,与云数据库控制台页面中显示的实例 ID 相同,可使用 [查询实例列表](https://cloud.tencent.com/document/api/236/15872) 接口获取,其值为输出参数中字段 InstanceId 的值。 + // 实例 ID,格式如:cdb-c1nl9rpv,与云数据库控制台页面中显示的实例 ID 相同,可使用 [查询实例列表](https://cloud.tencent.com/document/api/236/15872) 接口获取,其值为输出参数中字段 InstanceId 的值。 + // 说明:可输入多个实例 ID 进行修改,json 格式如下。 + // [ + // "cdb-30z11v8s", + // "cdb-93h11efg" + // ] InstanceIds []*string `json:"InstanceIds,omitnil,omitempty" name:"InstanceIds"` - // 项目的 ID。 + // 实例所属项目的 ID,可在账号中心下的项目管理页面查询。 + // 说明:此项为必填。 NewProjectId *int64 `json:"NewProjectId,omitnil,omitempty" name:"NewProjectId"` } @@ -12483,104 +13458,152 @@ func (r *ModifyDBInstanceProjectResponse) FromJsonString(s string) error { } // Predefined struct for user -type ModifyDBInstanceSecurityGroupsRequestParams struct { - // 实例 ID,格式如:cdb-c1nl9rpv 或者 cdbro-c1nl9rpv,与云数据库控制台页面中显示的实例 ID 相同。 +type ModifyDBInstanceReadOnlyStatusRequestParams struct { + // 实例ID,格式如:cdb-c1nl9rpv,与云数据库控制台页面中显示的实例ID相同,可使用[查询实例列表](https://cloud.tencent.com/document/api/236/15872) 接口获取,其值为输出参数中字段 InstanceId 的值。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` - // 要修改的安全组 ID 列表,一个或者多个安全组 ID 组成的数组。 - SecurityGroupIds []*string `json:"SecurityGroupIds,omitnil,omitempty" name:"SecurityGroupIds"` - - // 当传入只读实例ID时,默认操作的是对应只读组的安全组。如果需要操作只读实例ID的安全组, 需要将该入参置为True - ForReadonlyInstance *bool `json:"ForReadonlyInstance,omitnil,omitempty" name:"ForReadonlyInstance"` + // 是否设置为只读。其中:1表示设置实例为只读,0表示解除只读状态 + ReadOnly *int64 `json:"ReadOnly,omitnil,omitempty" name:"ReadOnly"` } -type ModifyDBInstanceSecurityGroupsRequest struct { +type ModifyDBInstanceReadOnlyStatusRequest struct { *tchttp.BaseRequest - // 实例 ID,格式如:cdb-c1nl9rpv 或者 cdbro-c1nl9rpv,与云数据库控制台页面中显示的实例 ID 相同。 + // 实例ID,格式如:cdb-c1nl9rpv,与云数据库控制台页面中显示的实例ID相同,可使用[查询实例列表](https://cloud.tencent.com/document/api/236/15872) 接口获取,其值为输出参数中字段 InstanceId 的值。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` - // 要修改的安全组 ID 列表,一个或者多个安全组 ID 组成的数组。 - SecurityGroupIds []*string `json:"SecurityGroupIds,omitnil,omitempty" name:"SecurityGroupIds"` - - // 当传入只读实例ID时,默认操作的是对应只读组的安全组。如果需要操作只读实例ID的安全组, 需要将该入参置为True - ForReadonlyInstance *bool `json:"ForReadonlyInstance,omitnil,omitempty" name:"ForReadonlyInstance"` + // 是否设置为只读。其中:1表示设置实例为只读,0表示解除只读状态 + ReadOnly *int64 `json:"ReadOnly,omitnil,omitempty" name:"ReadOnly"` } -func (r *ModifyDBInstanceSecurityGroupsRequest) ToJsonString() string { +func (r *ModifyDBInstanceReadOnlyStatusRequest) ToJsonString() string { b, _ := json.Marshal(r) return string(b) } // FromJsonString It is highly **NOT** recommended to use this function // because it has no param check, nor strict type check -func (r *ModifyDBInstanceSecurityGroupsRequest) FromJsonString(s string) error { +func (r *ModifyDBInstanceReadOnlyStatusRequest) FromJsonString(s string) error { f := make(map[string]interface{}) if err := json.Unmarshal([]byte(s), &f); err != nil { return err } delete(f, "InstanceId") - delete(f, "SecurityGroupIds") - delete(f, "ForReadonlyInstance") + delete(f, "ReadOnly") if len(f) > 0 { - return tcerr.NewTencentCloudSDKError("ClientError.BuildRequestError", "ModifyDBInstanceSecurityGroupsRequest has unknown keys!", "") + return tcerr.NewTencentCloudSDKError("ClientError.BuildRequestError", "ModifyDBInstanceReadOnlyStatusRequest has unknown keys!", "") } return json.Unmarshal([]byte(s), &r) } // Predefined struct for user -type ModifyDBInstanceSecurityGroupsResponseParams struct { +type ModifyDBInstanceReadOnlyStatusResponseParams struct { // 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 RequestId *string `json:"RequestId,omitnil,omitempty" name:"RequestId"` } -type ModifyDBInstanceSecurityGroupsResponse struct { +type ModifyDBInstanceReadOnlyStatusResponse struct { *tchttp.BaseResponse - Response *ModifyDBInstanceSecurityGroupsResponseParams `json:"Response"` + Response *ModifyDBInstanceReadOnlyStatusResponseParams `json:"Response"` } -func (r *ModifyDBInstanceSecurityGroupsResponse) ToJsonString() string { +func (r *ModifyDBInstanceReadOnlyStatusResponse) ToJsonString() string { b, _ := json.Marshal(r) return string(b) } // FromJsonString It is highly **NOT** recommended to use this function // because it has no param check, nor strict type check -func (r *ModifyDBInstanceSecurityGroupsResponse) FromJsonString(s string) error { +func (r *ModifyDBInstanceReadOnlyStatusResponse) FromJsonString(s string) error { return json.Unmarshal([]byte(s), &r) } // Predefined struct for user -type ModifyDBInstanceVipVportRequestParams struct { - // 实例 ID,格式如:cdb-c1nl9rpv 或者 cdbro-c2nl9rpv 或者 cdbrg-c3nl9rpv,与云数据库控制台页面中显示的实例 ID 相同,可使用 [查询实例列表](https://cloud.tencent.com/document/api/236/15872) 接口获取,其值为输出参数中字段 InstanceId 的值。 +type ModifyDBInstanceSecurityGroupsRequestParams struct { + // 实例 ID,格式如:cdb-c1nl9rpv 或者 cdbro-c1nl9rpv,与云数据库控制台页面中显示的实例 ID 相同。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` - // 目标 IP。该参数和 DstPort 参数,两者必传一个。 - DstIp *string `json:"DstIp,omitnil,omitempty" name:"DstIp"` - - // 目标端口,支持范围为:[1024-65535]。该参数和 DstIp 参数,两者必传一个。 - DstPort *int64 `json:"DstPort,omitnil,omitempty" name:"DstPort"` - - // 私有网络统一 ID。 - UniqVpcId *string `json:"UniqVpcId,omitnil,omitempty" name:"UniqVpcId"` + // 要修改的安全组 ID 列表,一个或者多个安全组 ID 组成的数组。可通过 [DescribeDBSecurityGroups](https://cloud.tencent.com/document/product/236/15854) 接口获取。输入的安全组 ID 数组无长度限制。 + // 注意:该入参会全量替换存量已有集合,非增量更新。修改需传入预期的全量集合。 + SecurityGroupIds []*string `json:"SecurityGroupIds,omitnil,omitempty" name:"SecurityGroupIds"` - // 子网统一 ID。 - UniqSubnetId *string `json:"UniqSubnetId,omitnil,omitempty" name:"UniqSubnetId"` + // 当传入只读实例 ID 时,默认操作的是对应只读组的安全组。如果需要操作只读实例 ID 的安全组, 需要将该入参置为 True。默认为 False。 + ForReadonlyInstance *bool `json:"ForReadonlyInstance,omitnil,omitempty" name:"ForReadonlyInstance"` - // 进行基础网络转 VPC 网络和 VPC 网络下的子网变更时,原网络中旧IP的回收时间,单位为小时,取值范围为0-168,默认值为24小时。 - ReleaseDuration *int64 `json:"ReleaseDuration,omitnil,omitempty" name:"ReleaseDuration"` + // 变更集群版实例只读组时,InstanceId 传实例 ID,需要额外指定该参数表示操作只读组。 如果操作读写节点则不需指定该参数。 + OpResourceId *string `json:"OpResourceId,omitnil,omitempty" name:"OpResourceId"` } -type ModifyDBInstanceVipVportRequest struct { +type ModifyDBInstanceSecurityGroupsRequest struct { *tchttp.BaseRequest - // 实例 ID,格式如:cdb-c1nl9rpv 或者 cdbro-c2nl9rpv 或者 cdbrg-c3nl9rpv,与云数据库控制台页面中显示的实例 ID 相同,可使用 [查询实例列表](https://cloud.tencent.com/document/api/236/15872) 接口获取,其值为输出参数中字段 InstanceId 的值。 + // 实例 ID,格式如:cdb-c1nl9rpv 或者 cdbro-c1nl9rpv,与云数据库控制台页面中显示的实例 ID 相同。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` - // 目标 IP。该参数和 DstPort 参数,两者必传一个。 - DstIp *string `json:"DstIp,omitnil,omitempty" name:"DstIp"` + // 要修改的安全组 ID 列表,一个或者多个安全组 ID 组成的数组。可通过 [DescribeDBSecurityGroups](https://cloud.tencent.com/document/product/236/15854) 接口获取。输入的安全组 ID 数组无长度限制。 + // 注意:该入参会全量替换存量已有集合,非增量更新。修改需传入预期的全量集合。 + SecurityGroupIds []*string `json:"SecurityGroupIds,omitnil,omitempty" name:"SecurityGroupIds"` + + // 当传入只读实例 ID 时,默认操作的是对应只读组的安全组。如果需要操作只读实例 ID 的安全组, 需要将该入参置为 True。默认为 False。 + ForReadonlyInstance *bool `json:"ForReadonlyInstance,omitnil,omitempty" name:"ForReadonlyInstance"` + + // 变更集群版实例只读组时,InstanceId 传实例 ID,需要额外指定该参数表示操作只读组。 如果操作读写节点则不需指定该参数。 + OpResourceId *string `json:"OpResourceId,omitnil,omitempty" name:"OpResourceId"` +} + +func (r *ModifyDBInstanceSecurityGroupsRequest) ToJsonString() string { + b, _ := json.Marshal(r) + return string(b) +} + +// FromJsonString It is highly **NOT** recommended to use this function +// because it has no param check, nor strict type check +func (r *ModifyDBInstanceSecurityGroupsRequest) FromJsonString(s string) error { + f := make(map[string]interface{}) + if err := json.Unmarshal([]byte(s), &f); err != nil { + return err + } + delete(f, "InstanceId") + delete(f, "SecurityGroupIds") + delete(f, "ForReadonlyInstance") + delete(f, "OpResourceId") + if len(f) > 0 { + return tcerr.NewTencentCloudSDKError("ClientError.BuildRequestError", "ModifyDBInstanceSecurityGroupsRequest has unknown keys!", "") + } + return json.Unmarshal([]byte(s), &r) +} - // 目标端口,支持范围为:[1024-65535]。该参数和 DstIp 参数,两者必传一个。 +// Predefined struct for user +type ModifyDBInstanceSecurityGroupsResponseParams struct { + // 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 + RequestId *string `json:"RequestId,omitnil,omitempty" name:"RequestId"` +} + +type ModifyDBInstanceSecurityGroupsResponse struct { + *tchttp.BaseResponse + Response *ModifyDBInstanceSecurityGroupsResponseParams `json:"Response"` +} + +func (r *ModifyDBInstanceSecurityGroupsResponse) ToJsonString() string { + b, _ := json.Marshal(r) + return string(b) +} + +// FromJsonString It is highly **NOT** recommended to use this function +// because it has no param check, nor strict type check +func (r *ModifyDBInstanceSecurityGroupsResponse) FromJsonString(s string) error { + return json.Unmarshal([]byte(s), &r) +} + +// Predefined struct for user +type ModifyDBInstanceVipVportRequestParams struct { + // 实例 ID,格式如:cdb-c1nl9rpv 或者 cdbro-c2nl9rpv 或者 cdbrg-c3nl9rpv,与云数据库控制台页面中显示的实例 ID 相同,可使用 [查询实例列表](https://cloud.tencent.com/document/api/236/15872) 接口获取,其值为输出参数中字段 InstanceId 的值。 + InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` + + // 目标 IP。 + DstIp *string `json:"DstIp,omitnil,omitempty" name:"DstIp"` + + // 目标端口,支持范围为:[1024-65535]。 DstPort *int64 `json:"DstPort,omitnil,omitempty" name:"DstPort"` // 私有网络统一 ID。 @@ -12591,6 +13614,34 @@ type ModifyDBInstanceVipVportRequest struct { // 进行基础网络转 VPC 网络和 VPC 网络下的子网变更时,原网络中旧IP的回收时间,单位为小时,取值范围为0-168,默认值为24小时。 ReleaseDuration *int64 `json:"ReleaseDuration,omitnil,omitempty" name:"ReleaseDuration"` + + // 变更集群版实例只读组时,InstanceId传实例id,需要额外指定该参数表示操作只读组。 如果操作读写节点则不需指定该参数。 + OpResourceId *string `json:"OpResourceId,omitnil,omitempty" name:"OpResourceId"` +} + +type ModifyDBInstanceVipVportRequest struct { + *tchttp.BaseRequest + + // 实例 ID,格式如:cdb-c1nl9rpv 或者 cdbro-c2nl9rpv 或者 cdbrg-c3nl9rpv,与云数据库控制台页面中显示的实例 ID 相同,可使用 [查询实例列表](https://cloud.tencent.com/document/api/236/15872) 接口获取,其值为输出参数中字段 InstanceId 的值。 + InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` + + // 目标 IP。 + DstIp *string `json:"DstIp,omitnil,omitempty" name:"DstIp"` + + // 目标端口,支持范围为:[1024-65535]。 + DstPort *int64 `json:"DstPort,omitnil,omitempty" name:"DstPort"` + + // 私有网络统一 ID。 + UniqVpcId *string `json:"UniqVpcId,omitnil,omitempty" name:"UniqVpcId"` + + // 子网统一 ID。 + UniqSubnetId *string `json:"UniqSubnetId,omitnil,omitempty" name:"UniqSubnetId"` + + // 进行基础网络转 VPC 网络和 VPC 网络下的子网变更时,原网络中旧IP的回收时间,单位为小时,取值范围为0-168,默认值为24小时。 + ReleaseDuration *int64 `json:"ReleaseDuration,omitnil,omitempty" name:"ReleaseDuration"` + + // 变更集群版实例只读组时,InstanceId传实例id,需要额外指定该参数表示操作只读组。 如果操作读写节点则不需指定该参数。 + OpResourceId *string `json:"OpResourceId,omitnil,omitempty" name:"OpResourceId"` } func (r *ModifyDBInstanceVipVportRequest) ToJsonString() string { @@ -12611,6 +13662,7 @@ func (r *ModifyDBInstanceVipVportRequest) FromJsonString(s string) error { delete(f, "UniqVpcId") delete(f, "UniqSubnetId") delete(f, "ReleaseDuration") + delete(f, "OpResourceId") if len(f) > 0 { return tcerr.NewTencentCloudSDKError("ClientError.BuildRequestError", "ModifyDBInstanceVipVportRequest has unknown keys!", "") } @@ -12620,7 +13672,8 @@ func (r *ModifyDBInstanceVipVportRequest) FromJsonString(s string) error { // Predefined struct for user type ModifyDBInstanceVipVportResponseParams struct { // 异步任务ID。(该返回字段目前已废弃) - // 注意:此字段可能返回 null,表示取不到有效值。 + // + // Deprecated: AsyncRequestId is deprecated. AsyncRequestId *string `json:"AsyncRequestId,omitnil,omitempty" name:"AsyncRequestId"` // 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 @@ -12645,13 +13698,13 @@ func (r *ModifyDBInstanceVipVportResponse) FromJsonString(s string) error { // Predefined struct for user type ModifyInstanceParamRequestParams struct { - // 实例短 ID 列表。 + // 实例 ID 列表。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 InstanceIds []*string `json:"InstanceIds,omitnil,omitempty" name:"InstanceIds"` // 要修改的参数列表。每一个元素是 Name 和 CurrentValue 的组合。Name 是参数名,CurrentValue 是要修改成的值。 ParamList []*Parameter `json:"ParamList,omitnil,omitempty" name:"ParamList"` - // 模板id,ParamList和TemplateId必须至少传其中之一 + // 模板 ID,ParamList 和 TemplateId 必须至少传其中之一。可通过 [DescribeParamTemplates](https://cloud.tencent.com/document/api/236/32659) 接口获取。 TemplateId *int64 `json:"TemplateId,omitnil,omitempty" name:"TemplateId"` // 执行参数调整任务的方式,默认为 0。支持值包括:0 - 立刻执行,1 - 时间窗执行;当该值为 1 时,每次只能传一个实例(InstanceIds数量为1) @@ -12667,13 +13720,13 @@ type ModifyInstanceParamRequestParams struct { type ModifyInstanceParamRequest struct { *tchttp.BaseRequest - // 实例短 ID 列表。 + // 实例 ID 列表。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 InstanceIds []*string `json:"InstanceIds,omitnil,omitempty" name:"InstanceIds"` // 要修改的参数列表。每一个元素是 Name 和 CurrentValue 的组合。Name 是参数名,CurrentValue 是要修改成的值。 ParamList []*Parameter `json:"ParamList,omitnil,omitempty" name:"ParamList"` - // 模板id,ParamList和TemplateId必须至少传其中之一 + // 模板 ID,ParamList 和 TemplateId 必须至少传其中之一。可通过 [DescribeParamTemplates](https://cloud.tencent.com/document/api/236/32659) 接口获取。 TemplateId *int64 `json:"TemplateId,omitnil,omitempty" name:"TemplateId"` // 执行参数调整任务的方式,默认为 0。支持值包括:0 - 立刻执行,1 - 时间窗执行;当该值为 1 时,每次只能传一个实例(InstanceIds数量为1) @@ -12737,20 +13790,48 @@ func (r *ModifyInstanceParamResponse) FromJsonString(s string) error { // Predefined struct for user type ModifyInstancePasswordComplexityRequestParams struct { - // 实例短 ID 列表。 + // 要修改密码复杂度的实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 + // 说明:支持输入多个实例 ID 进行修改。 InstanceIds []*string `json:"InstanceIds,omitnil,omitempty" name:"InstanceIds"` - // 要修改的参数列表。每一个元素是Name和CurrentValue的组合。Name是参数名,CurrentValue是要修改成的值。8.0版本Name支持范围:["validate_password.policy","validate_password.length","validate_password.mixed_case_count","validate_password.number_count","validate_password.special_char_count"],5.6和5.7版本支持范围:["validate_password_policy","validate_password_length","validate_password_mixed_case_count","validate_password_number_count","validate_password_special_char_count"] + // 要修改的密码复杂度的选项。每一个选项是以组合形式写入的,一个组合包括 Name 和 CurrentValue,其中 Name 表示对应选项的参数名,CurrentValue 表示参数值。例如:[{"Name": "validate_password.length", "CurrentValue": "10"}],表示将密码的最小字符数修改为10。 + // 说明:不同数据库版本的实例,支持修改的密码复杂度的选项如下。 + // 1. MySQL 8.0: + // 选项 validate_password.policy,表示密码复杂度的开关,值为 LOW 时表示关闭;值为 MEDIUM 时表示开启。 + // 选项 validate_password.length,表示密码总长度的最小字符数。 + // 选项 validate_password.mixed_case_count,表示小写和大写字母的最小字符数。 + // 选项 validate_password.number_count,表示数字的最小字符数。 + // 选项 validate_password.special_char_count,表示特殊字符的最小字符数。 + // 2. MySQL 5.6、MySQL 5.7: + // 选项 validate_password_policy,表示密码复杂度的开关,值为 LOW 时表示关闭;值为 MEDIUM 时表示开启。 + // 选项 validate_password_length,表示密码总长度的最小字符数。 + // 选项 validate_password_mixed_case_count,表示小写和大写字母的最小字符数。 + // 选项 validate_password_number_count,表示数字的最小字符数。 + // 选项 validate_password_special_char_count,表示特殊字符的最小字符数。 ParamList []*Parameter `json:"ParamList,omitnil,omitempty" name:"ParamList"` } type ModifyInstancePasswordComplexityRequest struct { *tchttp.BaseRequest - // 实例短 ID 列表。 + // 要修改密码复杂度的实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 + // 说明:支持输入多个实例 ID 进行修改。 InstanceIds []*string `json:"InstanceIds,omitnil,omitempty" name:"InstanceIds"` - // 要修改的参数列表。每一个元素是Name和CurrentValue的组合。Name是参数名,CurrentValue是要修改成的值。8.0版本Name支持范围:["validate_password.policy","validate_password.length","validate_password.mixed_case_count","validate_password.number_count","validate_password.special_char_count"],5.6和5.7版本支持范围:["validate_password_policy","validate_password_length","validate_password_mixed_case_count","validate_password_number_count","validate_password_special_char_count"] + // 要修改的密码复杂度的选项。每一个选项是以组合形式写入的,一个组合包括 Name 和 CurrentValue,其中 Name 表示对应选项的参数名,CurrentValue 表示参数值。例如:[{"Name": "validate_password.length", "CurrentValue": "10"}],表示将密码的最小字符数修改为10。 + // 说明:不同数据库版本的实例,支持修改的密码复杂度的选项如下。 + // 1. MySQL 8.0: + // 选项 validate_password.policy,表示密码复杂度的开关,值为 LOW 时表示关闭;值为 MEDIUM 时表示开启。 + // 选项 validate_password.length,表示密码总长度的最小字符数。 + // 选项 validate_password.mixed_case_count,表示小写和大写字母的最小字符数。 + // 选项 validate_password.number_count,表示数字的最小字符数。 + // 选项 validate_password.special_char_count,表示特殊字符的最小字符数。 + // 2. MySQL 5.6、MySQL 5.7: + // 选项 validate_password_policy,表示密码复杂度的开关,值为 LOW 时表示关闭;值为 MEDIUM 时表示开启。 + // 选项 validate_password_length,表示密码总长度的最小字符数。 + // 选项 validate_password_mixed_case_count,表示小写和大写字母的最小字符数。 + // 选项 validate_password_number_count,表示数字的最小字符数。 + // 选项 validate_password_special_char_count,表示特殊字符的最小字符数。 ParamList []*Parameter `json:"ParamList,omitnil,omitempty" name:"ParamList"` } @@ -12801,26 +13882,26 @@ func (r *ModifyInstancePasswordComplexityResponse) FromJsonString(s string) erro // Predefined struct for user type ModifyInstanceTagRequestParams struct { - // 实例 ID。 + // 实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` - // 要增加或修改的标签。 + // 要增加或修改的标签。ReplaceTags 和 DeleteTags 必填一个。 ReplaceTags []*TagInfo `json:"ReplaceTags,omitnil,omitempty" name:"ReplaceTags"` - // 要删除的标签。 + // 要删除的标签。ReplaceTags 和 DeleteTags 必填一个。 DeleteTags []*TagInfo `json:"DeleteTags,omitnil,omitempty" name:"DeleteTags"` } type ModifyInstanceTagRequest struct { *tchttp.BaseRequest - // 实例 ID。 + // 实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` - // 要增加或修改的标签。 + // 要增加或修改的标签。ReplaceTags 和 DeleteTags 必填一个。 ReplaceTags []*TagInfo `json:"ReplaceTags,omitnil,omitempty" name:"ReplaceTags"` - // 要删除的标签。 + // 要删除的标签。ReplaceTags 和 DeleteTags 必填一个。 DeleteTags []*TagInfo `json:"DeleteTags,omitnil,omitempty" name:"DeleteTags"` } @@ -12869,26 +13950,34 @@ func (r *ModifyInstanceTagResponse) FromJsonString(s string) error { // Predefined struct for user type ModifyLocalBinlogConfigRequestParams struct { - // 实例 ID,格式如:cdb-c1nl9rpv。与云数据库控制台页面中显示的实例ID相同。 + // 实例 ID,格式如:cdb-c1nl9rpv。与云数据库控制台页面中显示的实例 ID 相同。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` - // 本地binlog保留时长,可取值范围:[72,168],当实例存在灾备实例时,可取值范围:[120,168]。 + // 本地 binlog 保留时长。不同实例的可取值如下: + // 1. 云盘版实例、双节点实例、三节点实例的本地 binlog 保留时长(小时)默认为120,范围:6 - 168。 + // 2. 灾备实例的本地 binlog 保留时长(小时)默认为120,范围:120 - 168。 + // 3. 单节点云盘实例的本地 binlog 保留时长(小时)默认为120,范围:0 - 168。 + // 4. 若双节点实例、三节点实例下无灾备实例,则该主实例的本地 binlog 保留时长(小时)范围是:6 - 168;若双节点实例、三节点实例下有灾备实例,或者要为双节点实例、三节点实例添加灾备实例,为避免同步异常,该主实例的本地 binlog 保留时长(小时)不能设置低于120小时,范围是:120 - 168。 SaveHours *int64 `json:"SaveHours,omitnil,omitempty" name:"SaveHours"` - // 本地binlog空间使用率,可取值范围:[30,50]。 + // 本地 binlog 空间使用率,可取值范围:[30,50]。 MaxUsage *int64 `json:"MaxUsage,omitnil,omitempty" name:"MaxUsage"` } type ModifyLocalBinlogConfigRequest struct { *tchttp.BaseRequest - // 实例 ID,格式如:cdb-c1nl9rpv。与云数据库控制台页面中显示的实例ID相同。 + // 实例 ID,格式如:cdb-c1nl9rpv。与云数据库控制台页面中显示的实例 ID 相同。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` - // 本地binlog保留时长,可取值范围:[72,168],当实例存在灾备实例时,可取值范围:[120,168]。 + // 本地 binlog 保留时长。不同实例的可取值如下: + // 1. 云盘版实例、双节点实例、三节点实例的本地 binlog 保留时长(小时)默认为120,范围:6 - 168。 + // 2. 灾备实例的本地 binlog 保留时长(小时)默认为120,范围:120 - 168。 + // 3. 单节点云盘实例的本地 binlog 保留时长(小时)默认为120,范围:0 - 168。 + // 4. 若双节点实例、三节点实例下无灾备实例,则该主实例的本地 binlog 保留时长(小时)范围是:6 - 168;若双节点实例、三节点实例下有灾备实例,或者要为双节点实例、三节点实例添加灾备实例,为避免同步异常,该主实例的本地 binlog 保留时长(小时)不能设置低于120小时,范围是:120 - 168。 SaveHours *int64 `json:"SaveHours,omitnil,omitempty" name:"SaveHours"` - // 本地binlog空间使用率,可取值范围:[30,50]。 + // 本地 binlog 空间使用率,可取值范围:[30,50]。 MaxUsage *int64 `json:"MaxUsage,omitnil,omitempty" name:"MaxUsage"` } @@ -13005,10 +14094,10 @@ func (r *ModifyNameOrDescByDpIdResponse) FromJsonString(s string) error { // Predefined struct for user type ModifyParamTemplateRequestParams struct { - // 模板 ID。 + // 模板 ID。可通过 [DescribeParamTemplates](https://cloud.tencent.com/document/api/236/32659) 接口获取。 TemplateId *int64 `json:"TemplateId,omitnil,omitempty" name:"TemplateId"` - // 模板名称,长度不超过64。 + // 模板名称,仅支持数字、英文大小写字母、中文以及特殊字符_-./()()[]+=::@,且长度不能超过60。 Name *string `json:"Name,omitnil,omitempty" name:"Name"` // 模板描述,长度不超过255。 @@ -13021,10 +14110,10 @@ type ModifyParamTemplateRequestParams struct { type ModifyParamTemplateRequest struct { *tchttp.BaseRequest - // 模板 ID。 + // 模板 ID。可通过 [DescribeParamTemplates](https://cloud.tencent.com/document/api/236/32659) 接口获取。 TemplateId *int64 `json:"TemplateId,omitnil,omitempty" name:"TemplateId"` - // 模板名称,长度不超过64。 + // 模板名称,仅支持数字、英文大小写字母、中文以及特殊字符_-./()()[]+=::@,且长度不能超过60。 Name *string `json:"Name,omitnil,omitempty" name:"Name"` // 模板描述,长度不超过255。 @@ -13078,6 +14167,67 @@ func (r *ModifyParamTemplateResponse) FromJsonString(s string) error { return json.Unmarshal([]byte(s), &r) } +// Predefined struct for user +type ModifyProtectModeRequestParams struct { + // 数据复制方式,默认为 0,支持值包括:0 - 表示异步复制,1 - 表示半同步复制,2 - 表示强同步复制。 + ProtectMode *int64 `json:"ProtectMode,omitnil,omitempty" name:"ProtectMode"` + + // 实例ID。 + InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` +} + +type ModifyProtectModeRequest struct { + *tchttp.BaseRequest + + // 数据复制方式,默认为 0,支持值包括:0 - 表示异步复制,1 - 表示半同步复制,2 - 表示强同步复制。 + ProtectMode *int64 `json:"ProtectMode,omitnil,omitempty" name:"ProtectMode"` + + // 实例ID。 + InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` +} + +func (r *ModifyProtectModeRequest) ToJsonString() string { + b, _ := json.Marshal(r) + return string(b) +} + +// FromJsonString It is highly **NOT** recommended to use this function +// because it has no param check, nor strict type check +func (r *ModifyProtectModeRequest) FromJsonString(s string) error { + f := make(map[string]interface{}) + if err := json.Unmarshal([]byte(s), &f); err != nil { + return err + } + delete(f, "ProtectMode") + delete(f, "InstanceId") + if len(f) > 0 { + return tcerr.NewTencentCloudSDKError("ClientError.BuildRequestError", "ModifyProtectModeRequest has unknown keys!", "") + } + return json.Unmarshal([]byte(s), &r) +} + +// Predefined struct for user +type ModifyProtectModeResponseParams struct { + // 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 + RequestId *string `json:"RequestId,omitnil,omitempty" name:"RequestId"` +} + +type ModifyProtectModeResponse struct { + *tchttp.BaseResponse + Response *ModifyProtectModeResponseParams `json:"Response"` +} + +func (r *ModifyProtectModeResponse) ToJsonString() string { + b, _ := json.Marshal(r) + return string(b) +} + +// FromJsonString It is highly **NOT** recommended to use this function +// because it has no param check, nor strict type check +func (r *ModifyProtectModeResponse) FromJsonString(s string) error { + return json.Unmarshal([]byte(s), &r) +} + // Predefined struct for user type ModifyRemoteBackupConfigRequestParams struct { // 实例 ID,格式如:cdb-c1nl9rpv。与云数据库控制台页面中显示的实例 ID 相同。 @@ -13162,32 +14312,34 @@ func (r *ModifyRemoteBackupConfigResponse) FromJsonString(s string) error { // Predefined struct for user type ModifyRoGroupInfoRequestParams struct { - // RO 组的 ID。 + // RO 组的 ID。可通过 [DescribeRoGroups](https://cloud.tencent.com/document/api/236/40939) 接口获取。 RoGroupId *string `json:"RoGroupId,omitnil,omitempty" name:"RoGroupId"` // RO 组的详细信息。 RoGroupInfo *RoGroupAttr `json:"RoGroupInfo,omitnil,omitempty" name:"RoGroupInfo"` - // RO 组内实例的权重。若修改 RO 组的权重模式为用户自定义模式(custom),则必须设置该参数,且需要设置每个 RO 实例的权重值。 + // RO 组内实例的权重。若修改 RO 组的权重模式为用户自定义模式(custom),则必须设置该参数,且需要设置每个 RO 实例的权重值。RO 实例 ID 可通过 [DescribeRoGroups](https://cloud.tencent.com/document/api/236/40939) 接口获取。 RoWeightValues []*RoWeightValue `json:"RoWeightValues,omitnil,omitempty" name:"RoWeightValues"` // 是否重新均衡 RO 组内的 RO 实例的负载。支持值包括:1 - 重新均衡负载;0 - 不重新均衡负载。默认值为 0。注意,设置为重新均衡负载时,RO 组内 RO 实例会有一次数据库连接瞬断,请确保应用程序能重连数据库。 IsBalanceRoLoad *int64 `json:"IsBalanceRoLoad,omitnil,omitempty" name:"IsBalanceRoLoad"` // 废弃参数,无意义。 + // + // Deprecated: ReplicationDelayTime is deprecated. ReplicationDelayTime *int64 `json:"ReplicationDelayTime,omitnil,omitempty" name:"ReplicationDelayTime"` } type ModifyRoGroupInfoRequest struct { *tchttp.BaseRequest - // RO 组的 ID。 + // RO 组的 ID。可通过 [DescribeRoGroups](https://cloud.tencent.com/document/api/236/40939) 接口获取。 RoGroupId *string `json:"RoGroupId,omitnil,omitempty" name:"RoGroupId"` // RO 组的详细信息。 RoGroupInfo *RoGroupAttr `json:"RoGroupInfo,omitnil,omitempty" name:"RoGroupInfo"` - // RO 组内实例的权重。若修改 RO 组的权重模式为用户自定义模式(custom),则必须设置该参数,且需要设置每个 RO 实例的权重值。 + // RO 组内实例的权重。若修改 RO 组的权重模式为用户自定义模式(custom),则必须设置该参数,且需要设置每个 RO 实例的权重值。RO 实例 ID 可通过 [DescribeRoGroups](https://cloud.tencent.com/document/api/236/40939) 接口获取。 RoWeightValues []*RoWeightValue `json:"RoWeightValues,omitnil,omitempty" name:"RoWeightValues"` // 是否重新均衡 RO 组内的 RO 实例的负载。支持值包括:1 - 重新均衡负载;0 - 不重新均衡负载。默认值为 0。注意,设置为重新均衡负载时,RO 组内 RO 实例会有一次数据库连接瞬断,请确保应用程序能重连数据库。 @@ -13223,7 +14375,6 @@ func (r *ModifyRoGroupInfoRequest) FromJsonString(s string) error { // Predefined struct for user type ModifyRoGroupInfoResponseParams struct { // 异步任务 ID。 - // 注意:此字段可能返回 null,表示取不到有效值。 AsyncRequestId *string `json:"AsyncRequestId,omitnil,omitempty" name:"AsyncRequestId"` // 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 @@ -13246,34 +14397,122 @@ func (r *ModifyRoGroupInfoResponse) FromJsonString(s string) error { return json.Unmarshal([]byte(s), &r) } +// Predefined struct for user +type ModifyRoGroupVipVportRequestParams struct { + // RO组的ID。 + UGroupId *string `json:"UGroupId,omitnil,omitempty" name:"UGroupId"` + + // 目标IP。 + DstIp *string `json:"DstIp,omitnil,omitempty" name:"DstIp"` + + // 目标Port。 + DstPort *int64 `json:"DstPort,omitnil,omitempty" name:"DstPort"` +} + +type ModifyRoGroupVipVportRequest struct { + *tchttp.BaseRequest + + // RO组的ID。 + UGroupId *string `json:"UGroupId,omitnil,omitempty" name:"UGroupId"` + + // 目标IP。 + DstIp *string `json:"DstIp,omitnil,omitempty" name:"DstIp"` + + // 目标Port。 + DstPort *int64 `json:"DstPort,omitnil,omitempty" name:"DstPort"` +} + +func (r *ModifyRoGroupVipVportRequest) ToJsonString() string { + b, _ := json.Marshal(r) + return string(b) +} + +// FromJsonString It is highly **NOT** recommended to use this function +// because it has no param check, nor strict type check +func (r *ModifyRoGroupVipVportRequest) FromJsonString(s string) error { + f := make(map[string]interface{}) + if err := json.Unmarshal([]byte(s), &f); err != nil { + return err + } + delete(f, "UGroupId") + delete(f, "DstIp") + delete(f, "DstPort") + if len(f) > 0 { + return tcerr.NewTencentCloudSDKError("ClientError.BuildRequestError", "ModifyRoGroupVipVportRequest has unknown keys!", "") + } + return json.Unmarshal([]byte(s), &r) +} + +// Predefined struct for user +type ModifyRoGroupVipVportResponseParams struct { + // 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 + RequestId *string `json:"RequestId,omitnil,omitempty" name:"RequestId"` +} + +type ModifyRoGroupVipVportResponse struct { + *tchttp.BaseResponse + Response *ModifyRoGroupVipVportResponseParams `json:"Response"` +} + +func (r *ModifyRoGroupVipVportResponse) ToJsonString() string { + b, _ := json.Marshal(r) + return string(b) +} + +// FromJsonString It is highly **NOT** recommended to use this function +// because it has no param check, nor strict type check +func (r *ModifyRoGroupVipVportResponse) FromJsonString(s string) error { + return json.Unmarshal([]byte(s), &r) +} + // Predefined struct for user type ModifyTimeWindowRequestParams struct { - // 实例 ID,格式如:cdb-c1nl9rpv 或者 cdbro-c1nl9rpv,与云数据库控制台页面中显示的实例 ID 相同。 + // 实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` // 修改后的可维护时间段,其中每一个时间段的格式形如:10:00-12:00;起止时间按半个小时对齐;最短半个小时,最长三个小时;最多设置两个时间段;起止时间范围为:[00:00, 24:00]。 + // 说明:设置两个时间段的 json 示例如下。 + // [ + // "01:00-01:30", + // "02:00-02:30" + // ] TimeRanges []*string `json:"TimeRanges,omitnil,omitempty" name:"TimeRanges"` - // 指定修改哪一天的客户时间段,可能的取值为:monday,tuesday,wednesday,thursday,friday,saturday,sunday。如果不指定该值或者为空,则默认一周七天都修改。 + // 指定修改哪一天的可维护时间段,可能的取值为:monday,tuesday,wednesday,thursday,friday,saturday,sunday。如果不指定该值或者为空,则默认一周七天都修改。 + // 说明:指定修改多天的 json 示例如下。 + // [ + // "monday", + // "tuesday" + // ] Weekdays []*string `json:"Weekdays,omitnil,omitempty" name:"Weekdays"` - // 数据延迟阈值,仅对主实例和灾备实例有效,不传默认修改为10 + // 数据延迟阈值(秒),仅对主实例和灾备实例有效。不传默认不修改,保持原来的阈值,取值范围:1-10的整数。 MaxDelayTime *uint64 `json:"MaxDelayTime,omitnil,omitempty" name:"MaxDelayTime"` } type ModifyTimeWindowRequest struct { *tchttp.BaseRequest - // 实例 ID,格式如:cdb-c1nl9rpv 或者 cdbro-c1nl9rpv,与云数据库控制台页面中显示的实例 ID 相同。 + // 实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` // 修改后的可维护时间段,其中每一个时间段的格式形如:10:00-12:00;起止时间按半个小时对齐;最短半个小时,最长三个小时;最多设置两个时间段;起止时间范围为:[00:00, 24:00]。 + // 说明:设置两个时间段的 json 示例如下。 + // [ + // "01:00-01:30", + // "02:00-02:30" + // ] TimeRanges []*string `json:"TimeRanges,omitnil,omitempty" name:"TimeRanges"` - // 指定修改哪一天的客户时间段,可能的取值为:monday,tuesday,wednesday,thursday,friday,saturday,sunday。如果不指定该值或者为空,则默认一周七天都修改。 + // 指定修改哪一天的可维护时间段,可能的取值为:monday,tuesday,wednesday,thursday,friday,saturday,sunday。如果不指定该值或者为空,则默认一周七天都修改。 + // 说明:指定修改多天的 json 示例如下。 + // [ + // "monday", + // "tuesday" + // ] Weekdays []*string `json:"Weekdays,omitnil,omitempty" name:"Weekdays"` - // 数据延迟阈值,仅对主实例和灾备实例有效,不传默认修改为10 + // 数据延迟阈值(秒),仅对主实例和灾备实例有效。不传默认不修改,保持原来的阈值,取值范围:1-10的整数。 MaxDelayTime *uint64 `json:"MaxDelayTime,omitnil,omitempty" name:"MaxDelayTime"` } @@ -13321,6 +14560,17 @@ func (r *ModifyTimeWindowResponse) FromJsonString(s string) error { return json.Unmarshal([]byte(s), &r) } +type NodeDistribution struct { + // 主实例Master节点所在主机ID或者只读实例所在主机ID + Node *string `json:"Node,omitnil,omitempty" name:"Node"` + + // 主实例第一Slave节点所在主机ID + SlaveNodeOne *string `json:"SlaveNodeOne,omitnil,omitempty" name:"SlaveNodeOne"` + + // 主实例第二Slave节点所在主机ID + SlaveNodeTwo *string `json:"SlaveNodeTwo,omitnil,omitempty" name:"SlaveNodeTwo"` +} + // Predefined struct for user type OfflineIsolatedInstancesRequestParams struct { // 实例 ID,格式如:cdb-c1nl9rpv,与云数据库控制台页面中显示的实例 ID 相同。 @@ -13377,62 +14627,76 @@ func (r *OfflineIsolatedInstancesResponse) FromJsonString(s string) error { // Predefined struct for user type OpenAuditServiceRequestParams struct { - // CDB实例ID + // CDB 实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` // 审计日志保存时长。支持值包括: - // 7 - 一周 + // 7 - 一周; // 30 - 一个月; // 90 - 三个月; // 180 - 六个月; // 365 - 一年; // 1095 - 三年; - // 1825 - 五年; + // 1825 - 五年。 LogExpireDay *uint64 `json:"LogExpireDay,omitnil,omitempty" name:"LogExpireDay"` - // 高频审计日志保存时长。支持值包括: - // 7 - 一周 + // 高频审计日志保存时长。默认值为7,此项取值需小于等于 LogExpireDay,支持值包括: + // 3 - 3天; + // 7 - 一周; // 30 - 一个月; + // 90 - 三个月; + // 180 - 六个月; + // 365 - 一年; + // 1095 - 三年; + // 1825 - 五年。 HighLogExpireDay *uint64 `json:"HighLogExpireDay,omitnil,omitempty" name:"HighLogExpireDay"` - // 审计规则。同RuleTemplateIds都不填是全审计。 + // 审计规则(该参数已废弃,不再生效)。 + // + // Deprecated: AuditRuleFilters is deprecated. AuditRuleFilters []*AuditRuleFilters `json:"AuditRuleFilters,omitnil,omitempty" name:"AuditRuleFilters"` - // 规则模板ID。同AuditRuleFilters都不填是全审计。 + // 规则模板 ID。 RuleTemplateIds []*string `json:"RuleTemplateIds,omitnil,omitempty" name:"RuleTemplateIds"` - // 审计类型。true-全审计;默认false-规则审计。 + // 审计类型。true - 全审计;默认 false - 规则审计。 AuditAll *bool `json:"AuditAll,omitnil,omitempty" name:"AuditAll"` } type OpenAuditServiceRequest struct { *tchttp.BaseRequest - // CDB实例ID + // CDB 实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` // 审计日志保存时长。支持值包括: - // 7 - 一周 + // 7 - 一周; // 30 - 一个月; // 90 - 三个月; // 180 - 六个月; // 365 - 一年; // 1095 - 三年; - // 1825 - 五年; + // 1825 - 五年。 LogExpireDay *uint64 `json:"LogExpireDay,omitnil,omitempty" name:"LogExpireDay"` - // 高频审计日志保存时长。支持值包括: - // 7 - 一周 + // 高频审计日志保存时长。默认值为7,此项取值需小于等于 LogExpireDay,支持值包括: + // 3 - 3天; + // 7 - 一周; // 30 - 一个月; + // 90 - 三个月; + // 180 - 六个月; + // 365 - 一年; + // 1095 - 三年; + // 1825 - 五年。 HighLogExpireDay *uint64 `json:"HighLogExpireDay,omitnil,omitempty" name:"HighLogExpireDay"` - // 审计规则。同RuleTemplateIds都不填是全审计。 + // 审计规则(该参数已废弃,不再生效)。 AuditRuleFilters []*AuditRuleFilters `json:"AuditRuleFilters,omitnil,omitempty" name:"AuditRuleFilters"` - // 规则模板ID。同AuditRuleFilters都不填是全审计。 + // 规则模板 ID。 RuleTemplateIds []*string `json:"RuleTemplateIds,omitnil,omitempty" name:"RuleTemplateIds"` - // 审计类型。true-全审计;默认false-规则审计。 + // 审计类型。true - 全审计;默认 false - 规则审计。 AuditAll *bool `json:"AuditAll,omitnil,omitempty" name:"AuditAll"` } @@ -13484,26 +14748,26 @@ func (r *OpenAuditServiceResponse) FromJsonString(s string) error { // Predefined struct for user type OpenDBInstanceEncryptionRequestParams struct { - // 云数据库实例 ID。 + // 云数据库实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` - // 用户自定义密钥ID,CMK唯一标识符。该值为空时,将使用腾讯云自动生成的密钥KMS-CDB。 + // 用户自定义密钥 ID,CMK 唯一标识符。该值为空时,将使用腾讯云自动生成的密钥 KMS-CDB。 KeyId *string `json:"KeyId,omitnil,omitempty" name:"KeyId"` - // 用户自定义密钥的存储地域。如:ap-guangzhou 。KeyId不为空时,该参数必填。 + // 用户自定义密钥的存储地域。如:ap-guangzhou 。KeyId 不为空时,该参数必填。 KeyRegion *string `json:"KeyRegion,omitnil,omitempty" name:"KeyRegion"` } type OpenDBInstanceEncryptionRequest struct { *tchttp.BaseRequest - // 云数据库实例 ID。 + // 云数据库实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` - // 用户自定义密钥ID,CMK唯一标识符。该值为空时,将使用腾讯云自动生成的密钥KMS-CDB。 + // 用户自定义密钥 ID,CMK 唯一标识符。该值为空时,将使用腾讯云自动生成的密钥 KMS-CDB。 KeyId *string `json:"KeyId,omitnil,omitempty" name:"KeyId"` - // 用户自定义密钥的存储地域。如:ap-guangzhou 。KeyId不为空时,该参数必填。 + // 用户自定义密钥的存储地域。如:ap-guangzhou 。KeyId 不为空时,该参数必填。 KeyRegion *string `json:"KeyRegion,omitnil,omitempty" name:"KeyRegion"` } @@ -13609,20 +14873,20 @@ func (r *OpenDBInstanceGTIDResponse) FromJsonString(s string) error { // Predefined struct for user type OpenSSLRequestParams struct { - // 实例 ID 。 + // 实例 ID。只读组 ID 为空时必填。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` - // 只读组 ID。 + // 只读组 ID。实例 ID 为空时必填。可通过 [DescribeRoGroups](https://cloud.tencent.com/document/api/236/40939) 接口获取。 RoGroupId *string `json:"RoGroupId,omitnil,omitempty" name:"RoGroupId"` } type OpenSSLRequest struct { *tchttp.BaseRequest - // 实例 ID 。 + // 实例 ID。只读组 ID 为空时必填。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` - // 只读组 ID。 + // 只读组 ID。实例 ID 为空时必填。可通过 [DescribeRoGroups](https://cloud.tencent.com/document/api/236/40939) 接口获取。 RoGroupId *string `json:"RoGroupId,omitnil,omitempty" name:"RoGroupId"` } @@ -13673,15 +14937,21 @@ func (r *OpenSSLResponse) FromJsonString(s string) error { // Predefined struct for user type OpenWanServiceRequestParams struct { - // 实例 ID,格式如:cdb-c1nl9rpv,与云数据库控制台页面中显示的实例 ID 相同,可使用 [查询实例列表](https://cloud.tencent.com/document/api/236/15872) 接口获取,其值为输出参数中字段 InstanceId 的值。 + // 实例 ID,格式如:cdb-c1nl9rpv,与云数据库控制台页面中显示的实例 ID 相同,可使用 [查询实例列表](https://cloud.tencent.com/document/api/236/15872) 接口获取,其值为输出参数中字段 InstanceId 的值。可以传入只读组 ID。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` + + // 变更集群版实例只读组时,InstanceId传实例id,需要额外指定该参数表示操作只读组。 如果操作读写节点则不需指定该参数。 + OpResourceId *string `json:"OpResourceId,omitnil,omitempty" name:"OpResourceId"` } type OpenWanServiceRequest struct { *tchttp.BaseRequest - // 实例 ID,格式如:cdb-c1nl9rpv,与云数据库控制台页面中显示的实例 ID 相同,可使用 [查询实例列表](https://cloud.tencent.com/document/api/236/15872) 接口获取,其值为输出参数中字段 InstanceId 的值。 + // 实例 ID,格式如:cdb-c1nl9rpv,与云数据库控制台页面中显示的实例 ID 相同,可使用 [查询实例列表](https://cloud.tencent.com/document/api/236/15872) 接口获取,其值为输出参数中字段 InstanceId 的值。可以传入只读组 ID。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` + + // 变更集群版实例只读组时,InstanceId传实例id,需要额外指定该参数表示操作只读组。 如果操作读写节点则不需指定该参数。 + OpResourceId *string `json:"OpResourceId,omitnil,omitempty" name:"OpResourceId"` } func (r *OpenWanServiceRequest) ToJsonString() string { @@ -13697,6 +14967,7 @@ func (r *OpenWanServiceRequest) FromJsonString(s string) error { return err } delete(f, "InstanceId") + delete(f, "OpResourceId") if len(f) > 0 { return tcerr.NewTencentCloudSDKError("ClientError.BuildRequestError", "OpenWanServiceRequest has unknown keys!", "") } @@ -13785,7 +15056,7 @@ type ParamRecord struct { } type ParamTemplateInfo struct { - // 参数模板ID + // 参数模板 ID TemplateId *int64 `json:"TemplateId,omitnil,omitempty" name:"TemplateId"` // 参数模板名称 @@ -13794,14 +15065,13 @@ type ParamTemplateInfo struct { // 参数模板描述 Description *string `json:"Description,omitnil,omitempty" name:"Description"` - // 实例引擎版本 + // 实例引擎版本,值为:5.5、5.6、5.7、8.0。 EngineVersion *string `json:"EngineVersion,omitnil,omitempty" name:"EngineVersion"` - // 参数模板类型 + // 参数模板类型,值为:HIGH_STABILITY、HIGH_PERFORMANCE。 TemplateType *string `json:"TemplateType,omitnil,omitempty" name:"TemplateType"` - // 参数模板引擎 - // 注意:此字段可能返回 null,表示取不到有效值。 + // 参数模板引擎,值为:InnoDB、RocksDB。 EngineType *string `json:"EngineType,omitnil,omitempty" name:"EngineType"` } @@ -13848,10 +15118,17 @@ type ParameterDetail struct { MinFunc *string `json:"MinFunc,omitnil,omitempty" name:"MinFunc"` // 参数是否不支持修改 - // 注意:此字段可能返回 null,表示取不到有效值。 IsNotSupportEdit *bool `json:"IsNotSupportEdit,omitnil,omitempty" name:"IsNotSupportEdit"` } +type PeriodStrategy struct { + // 扩容周期 + TimeCycle *TImeCycle `json:"TimeCycle,omitnil,omitempty" name:"TimeCycle"` + + // 时间间隔 + TimeInterval *TimeInterval `json:"TimeInterval,omitnil,omitempty" name:"TimeInterval"` +} + type ProxyAddress struct { // 代理组地址ID ProxyAddressId *string `json:"ProxyAddressId,omitnil,omitempty" name:"ProxyAddressId"` @@ -13870,56 +15147,49 @@ type ProxyAddress struct { // 权重分配模式; // 系统自动分配:"system", 自定义:"custom" - // 注意:此字段可能返回 null,表示取不到有效值。 WeightMode *string `json:"WeightMode,omitnil,omitempty" name:"WeightMode"` // 是否开启延迟剔除,取值:"true" | "false" - // 注意:此字段可能返回 null,表示取不到有效值。 IsKickOut *bool `json:"IsKickOut,omitnil,omitempty" name:"IsKickOut"` // 最小保留数量,最小取值:0 - // 注意:此字段可能返回 null,表示取不到有效值。 MinCount *uint64 `json:"MinCount,omitnil,omitempty" name:"MinCount"` // 延迟剔除阈值,最小取值:0 - // 注意:此字段可能返回 null,表示取不到有效值。 MaxDelay *uint64 `json:"MaxDelay,omitnil,omitempty" name:"MaxDelay"` // 是否自动添加RO,取值:"true" | "false" - // 注意:此字段可能返回 null,表示取不到有效值。 AutoAddRo *bool `json:"AutoAddRo,omitnil,omitempty" name:"AutoAddRo"` // 是否是只读,取值:"true" | "false" - // 注意:此字段可能返回 null,表示取不到有效值。 ReadOnly *bool `json:"ReadOnly,omitnil,omitempty" name:"ReadOnly"` // 是否开启事务分离 - // 注意:此字段可能返回 null,表示取不到有效值。 TransSplit *bool `json:"TransSplit,omitnil,omitempty" name:"TransSplit"` // 是否开启故障转移 - // 注意:此字段可能返回 null,表示取不到有效值。 FailOver *bool `json:"FailOver,omitnil,omitempty" name:"FailOver"` // 是否开启连接池 - // 注意:此字段可能返回 null,表示取不到有效值。 ConnectionPool *bool `json:"ConnectionPool,omitnil,omitempty" name:"ConnectionPool"` // 描述 - // 注意:此字段可能返回 null,表示取不到有效值。 Desc *string `json:"Desc,omitnil,omitempty" name:"Desc"` // 实例读权重分配 - // 注意:此字段可能返回 null,表示取不到有效值。 ProxyAllocation []*ProxyAllocation `json:"ProxyAllocation,omitnil,omitempty" name:"ProxyAllocation"` // 接入模式 - // 注意:此字段可能返回 null,表示取不到有效值。 AccessMode *string `json:"AccessMode,omitnil,omitempty" name:"AccessMode"` // 是否开启自动负载均衡 - // 注意:此字段可能返回 null,表示取不到有效值。 AutoLoadBalance *bool `json:"AutoLoadBalance,omitnil,omitempty" name:"AutoLoadBalance"` + + // 是否把libra当作ro节点 + ApNodeAsRoNode *bool `json:"ApNodeAsRoNode,omitnil,omitempty" name:"ApNodeAsRoNode"` + + // libra节点故障,是否转发给其他节点 + ApQueryToOtherNode *bool `json:"ApQueryToOtherNode,omitnil,omitempty" name:"ApQueryToOtherNode"` } type ProxyAllocation struct { @@ -13938,107 +15208,82 @@ type ProxyGroupInfo struct { ProxyGroupId *string `json:"ProxyGroupId,omitnil,omitempty" name:"ProxyGroupId"` // 代理版本 - // 注意:此字段可能返回 null,表示取不到有效值。 ProxyVersion *string `json:"ProxyVersion,omitnil,omitempty" name:"ProxyVersion"` // 代理支持升级版本 - // 注意:此字段可能返回 null,表示取不到有效值。 SupportUpgradeProxyVersion *string `json:"SupportUpgradeProxyVersion,omitnil,omitempty" name:"SupportUpgradeProxyVersion"` - // 代理状态 - // 注意:此字段可能返回 null,表示取不到有效值。 + // 代理状态。0 - 初始化中,1 - 在线中,2 - 在线中-读写分离中,3 - 下线,4 - 销毁。 Status *string `json:"Status,omitnil,omitempty" name:"Status"` - // 代理任务状态 - // 注意:此字段可能返回 null,表示取不到有效值。 + // 代理任务状态,Upgrading - 升级中,UpgradeTo - 升级待切换,UpgradeSwitching - 升级切换中,ProxyCreateAddress - 配置地址中,ProxyModifyAddress - 修改地址中,ProxyCloseAddress - 关闭地址中。 TaskStatus *string `json:"TaskStatus,omitnil,omitempty" name:"TaskStatus"` // 代理组节点信息 - // 注意:此字段可能返回 null,表示取不到有效值。 ProxyNode []*ProxyNode `json:"ProxyNode,omitnil,omitempty" name:"ProxyNode"` // 代理组地址信息 - // 注意:此字段可能返回 null,表示取不到有效值。 ProxyAddress []*ProxyAddress `json:"ProxyAddress,omitnil,omitempty" name:"ProxyAddress"` // 连接池阈值 - // 注意:此字段可能返回 null,表示取不到有效值。 ConnectionPoolLimit *uint64 `json:"ConnectionPoolLimit,omitnil,omitempty" name:"ConnectionPoolLimit"` // 支持创建地址 - // 注意:此字段可能返回 null,表示取不到有效值。 SupportCreateProxyAddress *bool `json:"SupportCreateProxyAddress,omitnil,omitempty" name:"SupportCreateProxyAddress"` // 支持升级代理版本所需的cdb版本 - // 注意:此字段可能返回 null,表示取不到有效值。 SupportUpgradeProxyMysqlVersion *string `json:"SupportUpgradeProxyMysqlVersion,omitnil,omitempty" name:"SupportUpgradeProxyMysqlVersion"` } type ProxyInst struct { // 实例ID - // 注意:此字段可能返回 null,表示取不到有效值。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` // 实例名称 - // 注意:此字段可能返回 null,表示取不到有效值。 InstanceName *string `json:"InstanceName,omitnil,omitempty" name:"InstanceName"` // 实例类型:1 master 主实例; 2 ro 只读实例; 3 dr 灾备实例; 4 sdr 小灾备实例 - // 注意:此字段可能返回 null,表示取不到有效值。 InstanceType *int64 `json:"InstanceType,omitnil,omitempty" name:"InstanceType"` // 实例状态,可能的返回值:0-创建中;1-运行中;4-隔离中;5-已隔离 - // 注意:此字段可能返回 null,表示取不到有效值。 Status *int64 `json:"Status,omitnil,omitempty" name:"Status"` // 只读权重,如果权重为系统自动分配,改值不生效,只代表是否启用该实例 - // 注意:此字段可能返回 null,表示取不到有效值。 Weight *uint64 `json:"Weight,omitnil,omitempty" name:"Weight"` // 实例所属地域 - // 注意:此字段可能返回 null,表示取不到有效值。 Region *string `json:"Region,omitnil,omitempty" name:"Region"` // 实例所属可用区 - // 注意:此字段可能返回 null,表示取不到有效值。 Zone *string `json:"Zone,omitnil,omitempty" name:"Zone"` // 实例节点ID - // 注意:此字段可能返回 null,表示取不到有效值。 InstNodeId *string `json:"InstNodeId,omitnil,omitempty" name:"InstNodeId"` // 节点角色 - // 注意:此字段可能返回 null,表示取不到有效值。 InstNodeRole *string `json:"InstNodeRole,omitnil,omitempty" name:"InstNodeRole"` } type ProxyNode struct { // 代理节点ID - // 注意:此字段可能返回 null,表示取不到有效值。 ProxyId *string `json:"ProxyId,omitnil,omitempty" name:"ProxyId"` // CPU核数 - // 注意:此字段可能返回 null,表示取不到有效值。 Cpu *uint64 `json:"Cpu,omitnil,omitempty" name:"Cpu"` - // 内存大小 - // 注意:此字段可能返回 null,表示取不到有效值。 + // 内存大小,单位为 MB。 Mem *uint64 `json:"Mem,omitnil,omitempty" name:"Mem"` - // 节点状态 - // 注意:此字段可能返回 null,表示取不到有效值。 + // 节点状态,0 - 初始化中,1 - 在线中,2 - 下线中,3 - 销毁中,4 - 故障恢复中,5 - 节点故障,6 - 切换中。 Status *string `json:"Status,omitnil,omitempty" name:"Status"` // 代理节点可用区 - // 注意:此字段可能返回 null,表示取不到有效值。 Zone *string `json:"Zone,omitnil,omitempty" name:"Zone"` // 代理节点地域 - // 注意:此字段可能返回 null,表示取不到有效值。 Region *string `json:"Region,omitnil,omitempty" name:"Region"` // 连接数 - // 注意:此字段可能返回 null,表示取不到有效值。 Connection *uint64 `json:"Connection,omitnil,omitempty" name:"Connection"` } @@ -14059,16 +15304,45 @@ type ProxyNodeCustom struct { Zone *string `json:"Zone,omitnil,omitempty" name:"Zone"` } +type ReadWriteNode struct { + // RW 节点所在可用区。 + Zone *string `json:"Zone,omitnil,omitempty" name:"Zone"` + + // 升级集群版实例时,如果要调整只读节点可用区,需要指定节点id。 + NodeId *string `json:"NodeId,omitnil,omitempty" name:"NodeId"` +} + +type ReadonlyNode struct { + // 是否分布在随机可用区。传入YES表示随机可用区。否则使用Zone指定的可用区。 + IsRandomZone *string `json:"IsRandomZone,omitnil,omitempty" name:"IsRandomZone"` + + // 指定该节点分布在哪个可用区。 + Zone *string `json:"Zone,omitnil,omitempty" name:"Zone"` + + // 升级集群版实例时,如果要调整只读节点可用区,需要指定节点id。 + NodeId *string `json:"NodeId,omitnil,omitempty" name:"NodeId"` +} + // Predefined struct for user type ReleaseIsolatedDBInstancesRequestParams struct { - // 实例 ID 数组,单个实例 ID 格式如:cdb-c1nl9rpv,与云数据库控制台页面中显示的实例 ID 相同,可使用 [查询实例列表](https://cloud.tencent.com/document/api/236/15872) 接口获取,其值为输出参数中字段 InstanceId 的值。 + // 实例 ID,单个实例 ID 格式如:cdb-c1nl9rpv,与云数据库控制台页面中显示的实例 ID 相同,可使用 [查询实例列表](https://cloud.tencent.com/document/api/236/15872) 接口获取,其值为输出参数中字段 InstanceId 的值。 + // 说明:可输入多个实例 ID 进行操作,json 格式如下。 + // [ + // "cdb-30z11v8s", + // "cdb-93h11efg" + // ] InstanceIds []*string `json:"InstanceIds,omitnil,omitempty" name:"InstanceIds"` } type ReleaseIsolatedDBInstancesRequest struct { *tchttp.BaseRequest - // 实例 ID 数组,单个实例 ID 格式如:cdb-c1nl9rpv,与云数据库控制台页面中显示的实例 ID 相同,可使用 [查询实例列表](https://cloud.tencent.com/document/api/236/15872) 接口获取,其值为输出参数中字段 InstanceId 的值。 + // 实例 ID,单个实例 ID 格式如:cdb-c1nl9rpv,与云数据库控制台页面中显示的实例 ID 相同,可使用 [查询实例列表](https://cloud.tencent.com/document/api/236/15872) 接口获取,其值为输出参数中字段 InstanceId 的值。 + // 说明:可输入多个实例 ID 进行操作,json 格式如下。 + // [ + // "cdb-30z11v8s", + // "cdb-93h11efg" + // ] InstanceIds []*string `json:"InstanceIds,omitnil,omitempty" name:"InstanceIds"` } @@ -14129,20 +15403,20 @@ type ReleaseResult struct { // Predefined struct for user type ReloadBalanceProxyNodeRequestParams struct { - // 代理组ID + // 代理组 ID。可通过 [DescribeCdbProxyInfo](https://cloud.tencent.com/document/api/236/90585) 接口获取。 ProxyGroupId *string `json:"ProxyGroupId,omitnil,omitempty" name:"ProxyGroupId"` - // 代理组地址ID + // 代理组地址 ID。可通过 [DescribeCdbProxyInfo](https://cloud.tencent.com/document/api/236/90585) 接口获取。如果不传则会对所有代理组地址进行负载均衡。 ProxyAddressId *string `json:"ProxyAddressId,omitnil,omitempty" name:"ProxyAddressId"` } type ReloadBalanceProxyNodeRequest struct { *tchttp.BaseRequest - // 代理组ID + // 代理组 ID。可通过 [DescribeCdbProxyInfo](https://cloud.tencent.com/document/api/236/90585) 接口获取。 ProxyGroupId *string `json:"ProxyGroupId,omitnil,omitempty" name:"ProxyGroupId"` - // 代理组地址ID + // 代理组地址 ID。可通过 [DescribeCdbProxyInfo](https://cloud.tencent.com/document/api/236/90585) 接口获取。如果不传则会对所有代理组地址进行负载均衡。 ProxyAddressId *string `json:"ProxyAddressId,omitnil,omitempty" name:"ProxyAddressId"` } @@ -14286,16 +15560,84 @@ func (r *RenewDBInstanceResponse) FromJsonString(s string) error { return json.Unmarshal([]byte(s), &r) } +// Predefined struct for user +type ResetPasswordRequestParams struct { + // 实例 ID,格式如:cdb-c1nl9rpv,与云数据库控制台页面中显示的实例 ID 相同。 + InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` + + // 手动刷新轮转密码的实例账户名,例如root + User *string `json:"User,omitnil,omitempty" name:"User"` + + // 手动刷新轮转密码的实例账户域名,例如% + Host *string `json:"Host,omitnil,omitempty" name:"Host"` +} + +type ResetPasswordRequest struct { + *tchttp.BaseRequest + + // 实例 ID,格式如:cdb-c1nl9rpv,与云数据库控制台页面中显示的实例 ID 相同。 + InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` + + // 手动刷新轮转密码的实例账户名,例如root + User *string `json:"User,omitnil,omitempty" name:"User"` + + // 手动刷新轮转密码的实例账户域名,例如% + Host *string `json:"Host,omitnil,omitempty" name:"Host"` +} + +func (r *ResetPasswordRequest) ToJsonString() string { + b, _ := json.Marshal(r) + return string(b) +} + +// FromJsonString It is highly **NOT** recommended to use this function +// because it has no param check, nor strict type check +func (r *ResetPasswordRequest) FromJsonString(s string) error { + f := make(map[string]interface{}) + if err := json.Unmarshal([]byte(s), &f); err != nil { + return err + } + delete(f, "InstanceId") + delete(f, "User") + delete(f, "Host") + if len(f) > 0 { + return tcerr.NewTencentCloudSDKError("ClientError.BuildRequestError", "ResetPasswordRequest has unknown keys!", "") + } + return json.Unmarshal([]byte(s), &r) +} + +// Predefined struct for user +type ResetPasswordResponseParams struct { + // 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 + RequestId *string `json:"RequestId,omitnil,omitempty" name:"RequestId"` +} + +type ResetPasswordResponse struct { + *tchttp.BaseResponse + Response *ResetPasswordResponseParams `json:"Response"` +} + +func (r *ResetPasswordResponse) ToJsonString() string { + b, _ := json.Marshal(r) + return string(b) +} + +// FromJsonString It is highly **NOT** recommended to use this function +// because it has no param check, nor strict type check +func (r *ResetPasswordResponse) FromJsonString(s string) error { + return json.Unmarshal([]byte(s), &r) +} + // Predefined struct for user type ResetRootAccountRequestParams struct { - // 实例id + // 实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` } type ResetRootAccountRequest struct { *tchttp.BaseRequest - // 实例id + // 实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` } @@ -14402,6 +15744,7 @@ type RoGroup struct { RoGroupMode *string `json:"RoGroupMode,omitnil,omitempty" name:"RoGroupMode"` // 只读组 ID。 + // 说明:若此数据结构在购买实例操作中被使用,则当只读组模式选择 join 时,此项为必填。 RoGroupId *string `json:"RoGroupId,omitnil,omitempty" name:"RoGroupId"` // 只读组名称。 @@ -14410,7 +15753,7 @@ type RoGroup struct { // 是否启用延迟超限剔除功能,启用该功能后,只读实例与主实例的延迟超过延迟阈值,只读实例将被隔离。可选值:1-启用;0-不启用。 RoOfflineDelay *int64 `json:"RoOfflineDelay,omitnil,omitempty" name:"RoOfflineDelay"` - // 延迟阈值。 + // 延迟阈值。单位:秒。值范围:1-10000,整数。 RoMaxDelayTime *int64 `json:"RoMaxDelayTime,omitnil,omitempty" name:"RoMaxDelayTime"` // 最少实例保留个数,若购买只读实例数量小于设置数量将不做剔除。 @@ -14432,23 +15775,18 @@ type RoGroup struct { Vport *int64 `json:"Vport,omitnil,omitempty" name:"Vport"` // 私有网络 ID。 - // 注意:此字段可能返回 null,表示取不到有效值。 UniqVpcId *string `json:"UniqVpcId,omitnil,omitempty" name:"UniqVpcId"` // 子网 ID。 - // 注意:此字段可能返回 null,表示取不到有效值。 UniqSubnetId *string `json:"UniqSubnetId,omitnil,omitempty" name:"UniqSubnetId"` // 只读组所在的地域。 - // 注意:此字段可能返回 null,表示取不到有效值。 RoGroupRegion *string `json:"RoGroupRegion,omitnil,omitempty" name:"RoGroupRegion"` // 只读组所在的可用区。 - // 注意:此字段可能返回 null,表示取不到有效值。 RoGroupZone *string `json:"RoGroupZone,omitnil,omitempty" name:"RoGroupZone"` - // 延迟复制时间。 - // 注意:此字段可能返回 null,表示取不到有效值。 + // 延迟复制时间。单位:秒。值范围:1-259200,整数。 DelayReplicationTime *int64 `json:"DelayReplicationTime,omitnil,omitempty" name:"DelayReplicationTime"` } @@ -14456,19 +15794,21 @@ type RoGroupAttr struct { // RO 组名称。 RoGroupName *string `json:"RoGroupName,omitnil,omitempty" name:"RoGroupName"` - // RO 实例最大延迟阈值。单位为秒,最小值为 1。注意,RO 组必须设置了开启实例延迟剔除策略,该值才有效。 + // RO 实例最大延迟阈值。单位为秒,最小值为 1。范围:[1,10000],整数。 + // 注意:RO 组必须设置了开启实例延迟剔除策略,该值才有效。 RoMaxDelayTime *int64 `json:"RoMaxDelayTime,omitnil,omitempty" name:"RoMaxDelayTime"` // 是否开启实例延迟剔除。支持的值包括:1 - 开启;0 - 不开启。注意,若设置开启实例延迟剔除,则必须设置延迟阈值(RoMaxDelayTime)参数。 RoOfflineDelay *int64 `json:"RoOfflineDelay,omitnil,omitempty" name:"RoOfflineDelay"` - // 最少保留实例数。可设置为小于或等于该 RO 组下 RO 实例个数的任意值。注意,若设置值大于 RO 实例数量将不做剔除;若设置为 0,所有实例延迟超限都会被剔除。 + // 最少保留实例数。可设置为小于或等于该 RO 组下 RO 实例个数的任意值。默认值为1。 + // 注意:若设置值大于 RO 实例数量将不做剔除;若设置为 0,所有实例延迟超限都会被剔除。 MinRoInGroup *int64 `json:"MinRoInGroup,omitnil,omitempty" name:"MinRoInGroup"` // 权重模式。支持值包括:"system" - 系统自动分配; "custom" - 用户自定义设置。注意,若设置 "custom" 模式,则必须设置 RO 实例权重配置(RoWeightValues)参数。 WeightMode *string `json:"WeightMode,omitnil,omitempty" name:"WeightMode"` - // 延迟复制时间。 + // 延迟复制时间。单位:秒,范围:1 - 259200秒,不传此参数表示不开启实例延迟复制。 ReplicationDelayTime *int64 `json:"ReplicationDelayTime,omitnil,omitempty" name:"ReplicationDelayTime"` } @@ -14541,6 +15881,9 @@ type RoInstanceInfo struct { // RO实例计费类型,可能返回值:0-包年包月,1-按量计费,2-后付费月结 PayType *int64 `json:"PayType,omitnil,omitempty" name:"PayType"` + + // RO延迟复制状态。 + ReplicationStatus *string `json:"ReplicationStatus,omitnil,omitempty" name:"ReplicationStatus"` } type RoVipInfo struct { @@ -14570,51 +15913,42 @@ type RoWeightValue struct { type RollbackDBName struct { // 回档前的原数据库名 - // 注意:此字段可能返回 null,表示取不到有效值。 DatabaseName *string `json:"DatabaseName,omitnil,omitempty" name:"DatabaseName"` // 回档后的新数据库名 - // 注意:此字段可能返回 null,表示取不到有效值。 NewDatabaseName *string `json:"NewDatabaseName,omitnil,omitempty" name:"NewDatabaseName"` } type RollbackInstancesInfo struct { - // 云数据库实例ID - // 注意:此字段可能返回 null,表示取不到有效值。 + // 云数据库实例 ID。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` - // 回档策略。可选值为:table、db、full;默认值为full。table - 极速回档模式,仅导入所选中表级别的备份和binlog,如有跨表操作,且关联表未被同时选中,将会导致回档失败,该模式下参数Databases必须为空;db - 快速模式,仅导入所选中库级别的备份和binlog,如有跨库操作,且关联库未被同时选中,将会导致回档失败;full - 普通回档模式,将导入整个实例的备份和binlog,速度较慢。 + // 回档策略。可选值为:table、db、full。table - 极速回档模式,仅导入所选中表级别的备份和binlog,如有跨表操作,且关联表未被同时选中,将会导致回档失败,该模式下参数Databases必须为空;db - 快速模式,仅导入所选中库级别的备份和binlog,如有跨库操作,且关联库未被同时选中,将会导致回档失败;full - 普通回档模式,将导入整个实例的备份和 binlog,速度较慢。 Strategy *string `json:"Strategy,omitnil,omitempty" name:"Strategy"` - // 数据库回档时间,时间格式为:yyyy-mm-dd hh:mm:ss + // 数据库回档时间,时间格式为:yyyy-mm-dd hh:mm:ss。 RollbackTime *string `json:"RollbackTime,omitnil,omitempty" name:"RollbackTime"` - // 待回档的数据库信息,表示整库回档 - // 注意:此字段可能返回 null,表示取不到有效值。 + // 待回档的数据库信息,表示整库回档。 Databases []*RollbackDBName `json:"Databases,omitnil,omitempty" name:"Databases"` - // 待回档的数据库表信息,表示按表回档 - // 注意:此字段可能返回 null,表示取不到有效值。 + // 待回档的数据库表信息,表示按表回档。 Tables []*RollbackTables `json:"Tables,omitnil,omitempty" name:"Tables"` } type RollbackTableName struct { // 回档前的原数据库表名 - // 注意:此字段可能返回 null,表示取不到有效值。 TableName *string `json:"TableName,omitnil,omitempty" name:"TableName"` // 回档后的新数据库表名 - // 注意:此字段可能返回 null,表示取不到有效值。 NewTableName *string `json:"NewTableName,omitnil,omitempty" name:"NewTableName"` } type RollbackTables struct { // 数据库名 - // 注意:此字段可能返回 null,表示取不到有效值。 Database *string `json:"Database,omitnil,omitempty" name:"Database"` // 数据库表详情 - // 注意:此字段可能返回 null,表示取不到有效值。 Table []*RollbackTableName `json:"Table,omitnil,omitempty" name:"Table"` } @@ -14635,7 +15969,6 @@ type RollbackTask struct { EndTime *string `json:"EndTime,omitnil,omitempty" name:"EndTime"` // 回档任务详情。 - // 注意:此字段可能返回 null,表示取不到有效值。 Detail []*RollbackInstancesInfo `json:"Detail,omitnil,omitempty" name:"Detail"` } @@ -14649,11 +15982,9 @@ type RollbackTimeRange struct { type Rule struct { // 划分上限 - // 注意:此字段可能返回 null,表示取不到有效值。 LessThan *uint64 `json:"LessThan,omitnil,omitempty" name:"LessThan"` // 权重 - // 注意:此字段可能返回 null,表示取不到有效值。 Weight *uint64 `json:"Weight,omitnil,omitempty" name:"Weight"` } @@ -14670,53 +16001,41 @@ type RuleFilters struct { type RuleTemplateInfo struct { // 规则模板ID。 - // 注意:此字段可能返回 null,表示取不到有效值。 RuleTemplateId *string `json:"RuleTemplateId,omitnil,omitempty" name:"RuleTemplateId"` // 规则模板名称。 - // 注意:此字段可能返回 null,表示取不到有效值。 RuleTemplateName *string `json:"RuleTemplateName,omitnil,omitempty" name:"RuleTemplateName"` // 规则内容。 - // 注意:此字段可能返回 null,表示取不到有效值。 RuleFilters []*RuleFilters `json:"RuleFilters,omitnil,omitempty" name:"RuleFilters"` // 告警等级。1-低风险,2-中风险,3-高风险。 - // 注意:此字段可能返回 null,表示取不到有效值。 AlarmLevel *int64 `json:"AlarmLevel,omitnil,omitempty" name:"AlarmLevel"` // 告警策略。0-不告警,1-告警。 - // 注意:此字段可能返回 null,表示取不到有效值。 AlarmPolicy *int64 `json:"AlarmPolicy,omitnil,omitempty" name:"AlarmPolicy"` // 规则描述。 - // 注意:此字段可能返回 null,表示取不到有效值。 Description *string `json:"Description,omitnil,omitempty" name:"Description"` } type RuleTemplateRecordInfo struct { // 任务ID - // 注意:此字段可能返回 null,表示取不到有效值。 TaskId *int64 `json:"TaskId,omitnil,omitempty" name:"TaskId"` // 修改前规则模板的详情。 - // 注意:此字段可能返回 null,表示取不到有效值。 ModifyBeforeInfo *RuleTemplateInfo `json:"ModifyBeforeInfo,omitnil,omitempty" name:"ModifyBeforeInfo"` // 修改后规则模板的详情。 - // 注意:此字段可能返回 null,表示取不到有效值。 ModifyAfterInfo *RuleTemplateInfo `json:"ModifyAfterInfo,omitnil,omitempty" name:"ModifyAfterInfo"` // 影响的实例。 - // 注意:此字段可能返回 null,表示取不到有效值。 AffectedInstances []*string `json:"AffectedInstances,omitnil,omitempty" name:"AffectedInstances"` // 操作人,账号uin。 - // 注意:此字段可能返回 null,表示取不到有效值。 Operator *string `json:"Operator,omitnil,omitempty" name:"Operator"` // 变更的时间。 - // 注意:此字段可能返回 null,表示取不到有效值。 UpdateTime *string `json:"UpdateTime,omitnil,omitempty" name:"UpdateTime"` } @@ -14756,7 +16075,6 @@ type SlaveInfo struct { First *SlaveInstanceInfo `json:"First,omitnil,omitempty" name:"First"` // 第二备机信息 - // 注意:此字段可能返回 null,表示取不到有效值。 Second *SlaveInstanceInfo `json:"Second,omitnil,omitempty" name:"Second"` } @@ -14781,7 +16099,7 @@ type SlowLogInfo struct { // 备份文件大小,单位:Byte Size *int64 `json:"Size,omitnil,omitempty" name:"Size"` - // 备份快照时间,时间格式:2016-03-17 02:10:37 + // 备份快照时间,时间格式:2016-03-17 Date *string `json:"Date,omitnil,omitempty" name:"Date"` // 内网下载地址 @@ -14795,48 +16113,37 @@ type SlowLogInfo struct { } type SlowLogItem struct { - // Sql的执行时间。 - // 注意:此字段可能返回 null,表示取不到有效值。 + // Sql的执行时间。秒级时间戳。 Timestamp *uint64 `json:"Timestamp,omitnil,omitempty" name:"Timestamp"` // Sql的执行时长(秒)。 - // 注意:此字段可能返回 null,表示取不到有效值。 QueryTime *float64 `json:"QueryTime,omitnil,omitempty" name:"QueryTime"` // Sql语句。 - // 注意:此字段可能返回 null,表示取不到有效值。 SqlText *string `json:"SqlText,omitnil,omitempty" name:"SqlText"` // 客户端地址。 - // 注意:此字段可能返回 null,表示取不到有效值。 UserHost *string `json:"UserHost,omitnil,omitempty" name:"UserHost"` // 用户名。 - // 注意:此字段可能返回 null,表示取不到有效值。 UserName *string `json:"UserName,omitnil,omitempty" name:"UserName"` // 数据库名。 - // 注意:此字段可能返回 null,表示取不到有效值。 Database *string `json:"Database,omitnil,omitempty" name:"Database"` // 锁时长(秒)。 - // 注意:此字段可能返回 null,表示取不到有效值。 LockTime *float64 `json:"LockTime,omitnil,omitempty" name:"LockTime"` // 扫描行数。 - // 注意:此字段可能返回 null,表示取不到有效值。 RowsExamined *int64 `json:"RowsExamined,omitnil,omitempty" name:"RowsExamined"` // 结果集行数。 - // 注意:此字段可能返回 null,表示取不到有效值。 RowsSent *int64 `json:"RowsSent,omitnil,omitempty" name:"RowsSent"` // Sql模板。 - // 注意:此字段可能返回 null,表示取不到有效值。 SqlTemplate *string `json:"SqlTemplate,omitnil,omitempty" name:"SqlTemplate"` // Sql语句的md5。 - // 注意:此字段可能返回 null,表示取不到有效值。 Md5 *string `json:"Md5,omitnil,omitempty" name:"Md5"` } @@ -14919,35 +16226,53 @@ func (r *StartBatchRollbackResponse) FromJsonString(s string) error { // Predefined struct for user type StartCpuExpandRequestParams struct { - // 实例 ID 。 + // 实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` - // 扩容类型。可选值:auto:代表进行自动扩容 - // manual:代表进行手动扩容 + // 扩容类型,支持自动扩容和自定义扩容。 + // 说明:1. auto 表示自动扩容。2. manual 表示自定义扩容,扩容时间为立即生效。3. timeInterval 表示自定义扩容,扩容时间为按时间段。4. period 表示自定义扩容,扩容时间为按周期。 Type *string `json:"Type,omitnil,omitempty" name:"Type"` - // 手动扩容时,扩容的CPU核心数。Type 为 manual 时必传。 + // 自定义扩容时,扩容的 CPU 核心数。 + // 说明:1. Type 为 manual、timeInterval、period 时必传。2. 扩容的 CPU 核心数上限为当前实例 CPU 核心数,比如8核16G最大可手动扩容的 CPU 核心数为8,即范围为1 - 8。 ExpandCpu *int64 `json:"ExpandCpu,omitnil,omitempty" name:"ExpandCpu"` // 自动扩容策略。Type 为 auto 时必传。 AutoStrategy *AutoStrategy `json:"AutoStrategy,omitnil,omitempty" name:"AutoStrategy"` + + // 按时间段扩容策略。 + // 说明:当 Type 为 timeInterval 时,TimeIntervalStrategy 必填。 + TimeIntervalStrategy *TimeIntervalStrategy `json:"TimeIntervalStrategy,omitnil,omitempty" name:"TimeIntervalStrategy"` + + // 按周期扩容策略。 + // 说明:当 Type 为 period 时,PeriodStrategy 必填。 + PeriodStrategy *PeriodStrategy `json:"PeriodStrategy,omitnil,omitempty" name:"PeriodStrategy"` } type StartCpuExpandRequest struct { *tchttp.BaseRequest - // 实例 ID 。 + // 实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` - // 扩容类型。可选值:auto:代表进行自动扩容 - // manual:代表进行手动扩容 + // 扩容类型,支持自动扩容和自定义扩容。 + // 说明:1. auto 表示自动扩容。2. manual 表示自定义扩容,扩容时间为立即生效。3. timeInterval 表示自定义扩容,扩容时间为按时间段。4. period 表示自定义扩容,扩容时间为按周期。 Type *string `json:"Type,omitnil,omitempty" name:"Type"` - // 手动扩容时,扩容的CPU核心数。Type 为 manual 时必传。 + // 自定义扩容时,扩容的 CPU 核心数。 + // 说明:1. Type 为 manual、timeInterval、period 时必传。2. 扩容的 CPU 核心数上限为当前实例 CPU 核心数,比如8核16G最大可手动扩容的 CPU 核心数为8,即范围为1 - 8。 ExpandCpu *int64 `json:"ExpandCpu,omitnil,omitempty" name:"ExpandCpu"` // 自动扩容策略。Type 为 auto 时必传。 AutoStrategy *AutoStrategy `json:"AutoStrategy,omitnil,omitempty" name:"AutoStrategy"` + + // 按时间段扩容策略。 + // 说明:当 Type 为 timeInterval 时,TimeIntervalStrategy 必填。 + TimeIntervalStrategy *TimeIntervalStrategy `json:"TimeIntervalStrategy,omitnil,omitempty" name:"TimeIntervalStrategy"` + + // 按周期扩容策略。 + // 说明:当 Type 为 period 时,PeriodStrategy 必填。 + PeriodStrategy *PeriodStrategy `json:"PeriodStrategy,omitnil,omitempty" name:"PeriodStrategy"` } func (r *StartCpuExpandRequest) ToJsonString() string { @@ -14966,6 +16291,8 @@ func (r *StartCpuExpandRequest) FromJsonString(s string) error { delete(f, "Type") delete(f, "ExpandCpu") delete(f, "AutoStrategy") + delete(f, "TimeIntervalStrategy") + delete(f, "PeriodStrategy") if len(f) > 0 { return tcerr.NewTencentCloudSDKError("ClientError.BuildRequestError", "StartCpuExpandRequest has unknown keys!", "") } @@ -14974,7 +16301,7 @@ func (r *StartCpuExpandRequest) FromJsonString(s string) error { // Predefined struct for user type StartCpuExpandResponseParams struct { - // 异步任务 ID 。可以调用DescribeAsyncRequest 传入该 ID ,进行任务执行进度的查询 + // 异步任务 ID 。可以调用 DescribeAsyncRequest 传入该 ID,进行任务执行进度的查询。 AsyncRequestId *string `json:"AsyncRequestId,omitnil,omitempty" name:"AsyncRequestId"` // 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 @@ -14999,14 +16326,14 @@ func (r *StartCpuExpandResponse) FromJsonString(s string) error { // Predefined struct for user type StartReplicationRequestParams struct { - // 实例 ID。仅支持只读实例。 + // 实例 ID。仅支持只读实例。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` } type StartReplicationRequest struct { *tchttp.BaseRequest - // 实例 ID。仅支持只读实例。 + // 实例 ID。仅支持只读实例。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` } @@ -15032,7 +16359,6 @@ func (r *StartReplicationRequest) FromJsonString(s string) error { // Predefined struct for user type StartReplicationResponseParams struct { // 异步任务 ID。 - // 注意:此字段可能返回 null,表示取不到有效值。 AsyncRequestId *string `json:"AsyncRequestId,omitnil,omitempty" name:"AsyncRequestId"` // 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 @@ -15057,14 +16383,14 @@ func (r *StartReplicationResponse) FromJsonString(s string) error { // Predefined struct for user type StopCpuExpandRequestParams struct { - // 实例 ID 。 + // 实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` } type StopCpuExpandRequest struct { *tchttp.BaseRequest - // 实例 ID 。 + // 实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` } @@ -15089,7 +16415,7 @@ func (r *StopCpuExpandRequest) FromJsonString(s string) error { // Predefined struct for user type StopCpuExpandResponseParams struct { - // 异步任务 ID 。可以调用DescribeAsyncRequest 传入该 ID ,进行任务执行进度的查询 + // 异步任务 ID。在调用 [DescribeAsyncRequestInfo](https://cloud.tencent.com/document/api/236/20410) 进行任务执行进度的查询时,可以传入该 ID。 AsyncRequestId *string `json:"AsyncRequestId,omitnil,omitempty" name:"AsyncRequestId"` // 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 @@ -15168,14 +16494,14 @@ func (r *StopDBImportJobResponse) FromJsonString(s string) error { // Predefined struct for user type StopReplicationRequestParams struct { - // 实例 ID。仅支持只读实例。 + // 实例 ID。仅支持只读实例。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` } type StopReplicationRequest struct { *tchttp.BaseRequest - // 实例 ID。仅支持只读实例。 + // 实例 ID。仅支持只读实例。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` } @@ -15201,7 +16527,6 @@ func (r *StopReplicationRequest) FromJsonString(s string) error { // Predefined struct for user type StopReplicationResponseParams struct { // 异步任务 ID。 - // 注意:此字段可能返回 null,表示取不到有效值。 AsyncRequestId *string `json:"AsyncRequestId,omitnil,omitempty" name:"AsyncRequestId"` // 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 @@ -15226,14 +16551,14 @@ func (r *StopReplicationResponse) FromJsonString(s string) error { // Predefined struct for user type StopRollbackRequestParams struct { - // 撤销回档任务对应的实例Id。 + // 撤销回档任务对应的实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/api/236/15872) 接口获取。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` } type StopRollbackRequest struct { *tchttp.BaseRequest - // 撤销回档任务对应的实例Id。 + // 撤销回档任务对应的实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/api/236/15872) 接口获取。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` } @@ -15258,7 +16583,7 @@ func (r *StopRollbackRequest) FromJsonString(s string) error { // Predefined struct for user type StopRollbackResponseParams struct { - // 执行请求的异步任务ID + // 执行请求的异步任务 ID。 AsyncRequestId *string `json:"AsyncRequestId,omitnil,omitempty" name:"AsyncRequestId"` // 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 @@ -15281,22 +16606,88 @@ func (r *StopRollbackResponse) FromJsonString(s string) error { return json.Unmarshal([]byte(s), &r) } +// Predefined struct for user +type SubmitInstanceUpgradeCheckJobRequestParams struct { + // 实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 + InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` + + // 目标数据库版本。 + // 说明:可选值5.6、5.7、8.0,不支持跨版本升级,升级后不支持版本降级。 + DstMysqlVersion *string `json:"DstMysqlVersion,omitnil,omitempty" name:"DstMysqlVersion"` +} + +type SubmitInstanceUpgradeCheckJobRequest struct { + *tchttp.BaseRequest + + // 实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 + InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` + + // 目标数据库版本。 + // 说明:可选值5.6、5.7、8.0,不支持跨版本升级,升级后不支持版本降级。 + DstMysqlVersion *string `json:"DstMysqlVersion,omitnil,omitempty" name:"DstMysqlVersion"` +} + +func (r *SubmitInstanceUpgradeCheckJobRequest) ToJsonString() string { + b, _ := json.Marshal(r) + return string(b) +} + +// FromJsonString It is highly **NOT** recommended to use this function +// because it has no param check, nor strict type check +func (r *SubmitInstanceUpgradeCheckJobRequest) FromJsonString(s string) error { + f := make(map[string]interface{}) + if err := json.Unmarshal([]byte(s), &f); err != nil { + return err + } + delete(f, "InstanceId") + delete(f, "DstMysqlVersion") + if len(f) > 0 { + return tcerr.NewTencentCloudSDKError("ClientError.BuildRequestError", "SubmitInstanceUpgradeCheckJobRequest has unknown keys!", "") + } + return json.Unmarshal([]byte(s), &r) +} + +// Predefined struct for user +type SubmitInstanceUpgradeCheckJobResponseParams struct { + // 任务 ID + JobId *int64 `json:"JobId,omitnil,omitempty" name:"JobId"` + + // 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 + RequestId *string `json:"RequestId,omitnil,omitempty" name:"RequestId"` +} + +type SubmitInstanceUpgradeCheckJobResponse struct { + *tchttp.BaseResponse + Response *SubmitInstanceUpgradeCheckJobResponseParams `json:"Response"` +} + +func (r *SubmitInstanceUpgradeCheckJobResponse) ToJsonString() string { + b, _ := json.Marshal(r) + return string(b) +} + +// FromJsonString It is highly **NOT** recommended to use this function +// because it has no param check, nor strict type check +func (r *SubmitInstanceUpgradeCheckJobResponse) FromJsonString(s string) error { + return json.Unmarshal([]byte(s), &r) +} + // Predefined struct for user type SwitchCDBProxyRequestParams struct { - // 实例ID + // 实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` - // 数据库代理ID + // 数据库代理 ID。可通过 [DescribeCdbProxyInfo](https://cloud.tencent.com/document/api/236/90585) 接口获取。 ProxyGroupId *string `json:"ProxyGroupId,omitnil,omitempty" name:"ProxyGroupId"` } type SwitchCDBProxyRequest struct { *tchttp.BaseRequest - // 实例ID + // 实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` - // 数据库代理ID + // 数据库代理 ID。可通过 [DescribeCdbProxyInfo](https://cloud.tencent.com/document/api/236/90585) 接口获取。 ProxyGroupId *string `json:"ProxyGroupId,omitnil,omitempty" name:"ProxyGroupId"` } @@ -15355,6 +16746,9 @@ type SwitchDBInstanceMasterSlaveRequestParams struct { // 是否时间窗内切换。默认为 False,即不在时间窗内切换。注意,如果设置了 ForceSwitch 参数为 True,则该参数不生效。 WaitSwitch *bool `json:"WaitSwitch,omitnil,omitempty" name:"WaitSwitch"` + + // 集群版实例指定节点 ID 发起主从切换。 + DstNodeId *string `json:"DstNodeId,omitnil,omitempty" name:"DstNodeId"` } type SwitchDBInstanceMasterSlaveRequest struct { @@ -15371,6 +16765,9 @@ type SwitchDBInstanceMasterSlaveRequest struct { // 是否时间窗内切换。默认为 False,即不在时间窗内切换。注意,如果设置了 ForceSwitch 参数为 True,则该参数不生效。 WaitSwitch *bool `json:"WaitSwitch,omitnil,omitempty" name:"WaitSwitch"` + + // 集群版实例指定节点 ID 发起主从切换。 + DstNodeId *string `json:"DstNodeId,omitnil,omitempty" name:"DstNodeId"` } func (r *SwitchDBInstanceMasterSlaveRequest) ToJsonString() string { @@ -15389,6 +16786,7 @@ func (r *SwitchDBInstanceMasterSlaveRequest) FromJsonString(s string) error { delete(f, "DstSlave") delete(f, "ForceSwitch") delete(f, "WaitSwitch") + delete(f, "DstNodeId") if len(f) > 0 { return tcerr.NewTencentCloudSDKError("ClientError.BuildRequestError", "SwitchDBInstanceMasterSlaveRequest has unknown keys!", "") } @@ -15422,14 +16820,14 @@ func (r *SwitchDBInstanceMasterSlaveResponse) FromJsonString(s string) error { // Predefined struct for user type SwitchDrInstanceToMasterRequestParams struct { - // 灾备实例ID,格式如:cdb-c1nl9rpv,与云数据库控制台页面中显示的实例ID相同。 + // 灾备实例 ID,格式如:cdb-c1nl9rpv,与云数据库控制台页面中显示的实例 ID 相同。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` } type SwitchDrInstanceToMasterRequest struct { *tchttp.BaseRequest - // 灾备实例ID,格式如:cdb-c1nl9rpv,与云数据库控制台页面中显示的实例ID相同。 + // 灾备实例 ID,格式如:cdb-c1nl9rpv,与云数据库控制台页面中显示的实例 ID 相同。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` } @@ -15531,6 +16929,36 @@ func (r *SwitchForUpgradeResponse) FromJsonString(s string) error { return json.Unmarshal([]byte(s), &r) } +type TImeCycle struct { + // 按周期扩容时,是否选择周一扩容。 + // 说明:取值 true,表示选择,取值 false,表示不选择。 + Monday *bool `json:"Monday,omitnil,omitempty" name:"Monday"` + + // 按周期扩容时,是否选择周二扩容。 + // 说明:取值 true,表示选择,取值 false,表示不选择。 + Tuesday *bool `json:"Tuesday,omitnil,omitempty" name:"Tuesday"` + + // 按周期扩容时,是否选择周三扩容。 + // 说明:取值 true,表示选择,取值 false,表示不选择。 + Wednesday *bool `json:"Wednesday,omitnil,omitempty" name:"Wednesday"` + + // 按周期扩容时,是否选择周四扩容。 + // 说明:取值 true,表示选择,取值 false,表示不选择。 + Thursday *bool `json:"Thursday,omitnil,omitempty" name:"Thursday"` + + // 按周期扩容时,是否选择周五扩容。 + // 说明:取值 true,表示选择,取值 false,表示不选择。 + Friday *bool `json:"Friday,omitnil,omitempty" name:"Friday"` + + // 按周期扩容时,是否选择周六扩容。 + // 说明:取值 true,表示选择,取值 false,表示不选择。 + Saturday *bool `json:"Saturday,omitnil,omitempty" name:"Saturday"` + + // 按周期扩容时,是否选择周日扩容。 + // 说明:取值 true,表示选择,取值 false,表示不选择。 + Sunday *bool `json:"Sunday,omitnil,omitempty" name:"Sunday"` +} + type TablePrivilege struct { // 数据库名 Database *string `json:"Database,omitnil,omitempty" name:"Database"` @@ -15560,11 +16988,9 @@ type TagInfo struct { type TagInfoItem struct { // 标签键 - // 注意:此字段可能返回 null,表示取不到有效值。 TagKey *string `json:"TagKey,omitnil,omitempty" name:"TagKey"` // 标签值 - // 注意:此字段可能返回 null,表示取不到有效值。 TagValue *string `json:"TagValue,omitnil,omitempty" name:"TagValue"` } @@ -15587,17 +17013,15 @@ type TagsInfoOfInstance struct { type TaskAttachInfo struct { // 升级任务: // ”FastUpgradeStatus“:表示升级类型。1-原地升级;0-普通升级。 - // 注意:此字段可能返回 null,表示取不到有效值。 AttachKey *string `json:"AttachKey,omitnil,omitempty" name:"AttachKey"` // 升级任务: // ”FastUpgradeStatus“:表示升级类型。1-原地升级;0-普通升级。 - // 注意:此字段可能返回 null,表示取不到有效值。 AttachValue *string `json:"AttachValue,omitnil,omitempty" name:"AttachValue"` } type TaskDetail struct { - // 错误码。 + // 错误码。0代表成功,其他对应不同的报错场景。 Code *int64 `json:"Code,omitnil,omitempty" name:"Code"` // 错误信息。 @@ -15643,23 +17067,39 @@ type TaskDetail struct { EndTime *string `json:"EndTime,omitnil,omitempty" name:"EndTime"` // 任务关联的实例 ID。 - // 注意:此字段可能返回 null,表示取不到有效值。 InstanceIds []*string `json:"InstanceIds,omitnil,omitempty" name:"InstanceIds"` // 异步任务的请求 ID。 AsyncRequestId *string `json:"AsyncRequestId,omitnil,omitempty" name:"AsyncRequestId"` // 任务的附加信息。 - // 注意:此字段可能返回 null,表示取不到有效值。 TaskAttachInfo []*TaskAttachInfo `json:"TaskAttachInfo,omitnil,omitempty" name:"TaskAttachInfo"` } +type TimeInterval struct { + // 开始时间。 + StartTime *string `json:"StartTime,omitnil,omitempty" name:"StartTime"` + + // 结束时间。 + EndTime *string `json:"EndTime,omitnil,omitempty" name:"EndTime"` +} + +type TimeIntervalStrategy struct { + // 开始扩容时间。 + // 说明:此值的格式为 Integer 的时间戳(秒级)。 + StartTime *int64 `json:"StartTime,omitnil,omitempty" name:"StartTime"` + + // 结束扩容时间。 + // 说明:此值的格式为 Integer 的时间戳(秒级)。 + EndTime *int64 `json:"EndTime,omitnil,omitempty" name:"EndTime"` +} + // Predefined struct for user type UpgradeCDBProxyVersionRequestParams struct { - // 实例ID + // 实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` - // 数据库代理ID + // 数据库代理 ID。可通过 [DescribeCdbProxyInfo](https://cloud.tencent.com/document/api/236/90585) 接口获取。 ProxyGroupId *string `json:"ProxyGroupId,omitnil,omitempty" name:"ProxyGroupId"` // 数据库代理当前版本 @@ -15675,10 +17115,10 @@ type UpgradeCDBProxyVersionRequestParams struct { type UpgradeCDBProxyVersionRequest struct { *tchttp.BaseRequest - // 实例ID + // 实例 ID。可通过 [DescribeDBInstances](https://cloud.tencent.com/document/product/236/15872) 接口获取。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` - // 数据库代理ID + // 数据库代理 ID。可通过 [DescribeCdbProxyInfo](https://cloud.tencent.com/document/api/236/90585) 接口获取。 ProxyGroupId *string `json:"ProxyGroupId,omitnil,omitempty" name:"ProxyGroupId"` // 数据库代理当前版本 @@ -15717,7 +17157,6 @@ func (r *UpgradeCDBProxyVersionRequest) FromJsonString(s string) error { // Predefined struct for user type UpgradeCDBProxyVersionResponseParams struct { // 异步处理ID - // 注意:此字段可能返回 null,表示取不到有效值。 AsyncRequestId *string `json:"AsyncRequestId,omitnil,omitempty" name:"AsyncRequestId"` // 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 @@ -15745,17 +17184,24 @@ type UpgradeDBInstanceEngineVersionRequestParams struct { // 实例 ID,格式如:cdb-c1nl9rpv 或者 cdbro-c1nl9rpv。与云数据库控制台页面中显示的实例 ID 相同,可使用 [查询实例列表](https://cloud.tencent.com/document/api/236/15872) 接口获取,其值为输出参数中字段 InstanceId 的值。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` - // 主实例数据库引擎版本,支持值包括:5.6 和 5.7。 + // 主实例数据库引擎版本,支持值包括:5.6、5.7、8.0。 + // 说明:不支持越级升级,升级后不支持降级。 EngineVersion *string `json:"EngineVersion,omitnil,omitempty" name:"EngineVersion"` // 切换访问新实例的方式,默认为 0。支持值包括:0 - 立刻切换,1 - 时间窗切换;当该值为 1 时,升级过程中,切换访问新实例的流程将会在时间窗内进行,或者用户主动调用接口 [切换访问新实例](https://cloud.tencent.com/document/product/236/15864) 触发该流程。 WaitSwitch *int64 `json:"WaitSwitch,omitnil,omitempty" name:"WaitSwitch"` - // 是否是内核子版本升级,支持的值:1 - 升级内核子版本;0 - 升级数据库引擎版本。 + // 是否是内核子版本升级,支持的值:1 - 升级内核子版本;0 - 升级数据库引擎版本。无默认值,请指定要升级的版本类型。 UpgradeSubversion *int64 `json:"UpgradeSubversion,omitnil,omitempty" name:"UpgradeSubversion"` - // 延迟阈值。取值范围1~10 + // 延迟阈值。取值范围:1 - 10。无默认值,不传此参数时,延迟阈值为0,表示延迟阈值不做设置。 MaxDelayTime *int64 `json:"MaxDelayTime,omitnil,omitempty" name:"MaxDelayTime"` + + // 5.7升级8.0是否忽略关键字错误,取值范围[0,1],1表示忽略,0表示不忽略。无默认值,不传此参数表示不做处理。 + IgnoreErrKeyword *int64 `json:"IgnoreErrKeyword,omitnil,omitempty" name:"IgnoreErrKeyword"` + + // 版本升级支持指定参数 + ParamList []*UpgradeEngineVersionParams `json:"ParamList,omitnil,omitempty" name:"ParamList"` } type UpgradeDBInstanceEngineVersionRequest struct { @@ -15764,17 +17210,24 @@ type UpgradeDBInstanceEngineVersionRequest struct { // 实例 ID,格式如:cdb-c1nl9rpv 或者 cdbro-c1nl9rpv。与云数据库控制台页面中显示的实例 ID 相同,可使用 [查询实例列表](https://cloud.tencent.com/document/api/236/15872) 接口获取,其值为输出参数中字段 InstanceId 的值。 InstanceId *string `json:"InstanceId,omitnil,omitempty" name:"InstanceId"` - // 主实例数据库引擎版本,支持值包括:5.6 和 5.7。 + // 主实例数据库引擎版本,支持值包括:5.6、5.7、8.0。 + // 说明:不支持越级升级,升级后不支持降级。 EngineVersion *string `json:"EngineVersion,omitnil,omitempty" name:"EngineVersion"` // 切换访问新实例的方式,默认为 0。支持值包括:0 - 立刻切换,1 - 时间窗切换;当该值为 1 时,升级过程中,切换访问新实例的流程将会在时间窗内进行,或者用户主动调用接口 [切换访问新实例](https://cloud.tencent.com/document/product/236/15864) 触发该流程。 WaitSwitch *int64 `json:"WaitSwitch,omitnil,omitempty" name:"WaitSwitch"` - // 是否是内核子版本升级,支持的值:1 - 升级内核子版本;0 - 升级数据库引擎版本。 + // 是否是内核子版本升级,支持的值:1 - 升级内核子版本;0 - 升级数据库引擎版本。无默认值,请指定要升级的版本类型。 UpgradeSubversion *int64 `json:"UpgradeSubversion,omitnil,omitempty" name:"UpgradeSubversion"` - // 延迟阈值。取值范围1~10 + // 延迟阈值。取值范围:1 - 10。无默认值,不传此参数时,延迟阈值为0,表示延迟阈值不做设置。 MaxDelayTime *int64 `json:"MaxDelayTime,omitnil,omitempty" name:"MaxDelayTime"` + + // 5.7升级8.0是否忽略关键字错误,取值范围[0,1],1表示忽略,0表示不忽略。无默认值,不传此参数表示不做处理。 + IgnoreErrKeyword *int64 `json:"IgnoreErrKeyword,omitnil,omitempty" name:"IgnoreErrKeyword"` + + // 版本升级支持指定参数 + ParamList []*UpgradeEngineVersionParams `json:"ParamList,omitnil,omitempty" name:"ParamList"` } func (r *UpgradeDBInstanceEngineVersionRequest) ToJsonString() string { @@ -15794,6 +17247,8 @@ func (r *UpgradeDBInstanceEngineVersionRequest) FromJsonString(s string) error { delete(f, "WaitSwitch") delete(f, "UpgradeSubversion") delete(f, "MaxDelayTime") + delete(f, "IgnoreErrKeyword") + delete(f, "ParamList") if len(f) > 0 { return tcerr.NewTencentCloudSDKError("ClientError.BuildRequestError", "UpgradeDBInstanceEngineVersionRequest has unknown keys!", "") } @@ -15846,13 +17301,14 @@ type UpgradeDBInstanceRequestParams struct { // 备库1的可用区信息,默认和实例的 Zone 参数一致,升级主实例为多可用区部署时可指定该参数,升级只读实例或者灾备实例时指定该参数无意义。可通过 [获取云数据库可售卖规格](https://cloud.tencent.com/document/product/236/17229) 接口查询支持的可用区。 SlaveZone *string `json:"SlaveZone,omitnil,omitempty" name:"SlaveZone"` - // 主实例数据库引擎版本,支持值包括:5.5、5.6 和 5.7。 + // 主实例数据库引擎版本,支持值包括:5.5、5.6、5.7、8.0。 + // 说明:升级数据库版本请使用 [UpgradeDBInstanceEngineVersion](https://cloud.tencent.com/document/api/236/15870) 接口。 EngineVersion *string `json:"EngineVersion,omitnil,omitempty" name:"EngineVersion"` // 切换访问新实例的方式,默认为 0。支持值包括:0 - 立刻切换,1 - 时间窗切换;当该值为 1 时,升级过程中,切换访问新实例的流程将会在时间窗内进行,或者用户主动调用接口 [切换访问新实例](https://cloud.tencent.com/document/product/236/15864) 触发该流程。 WaitSwitch *int64 `json:"WaitSwitch,omitnil,omitempty" name:"WaitSwitch"` - // 备库 2 的可用区信息,默认为空,升级主实例时可指定该参数,升级只读实例或者灾备实例时指定该参数无意义。 + // 备库2的可用区信息,默认为空,升级主实例时可指定该参数,升级只读实例或者灾备实例时指定该参数无意义。可通过 [获取云数据库可售卖规格](https://cloud.tencent.com/document/product/236/17229) 接口查询支持的可用区。 // 备注:如您要将三节点降级至双节点,将该参数设置为空值即可实现。 BackupZone *string `json:"BackupZone,omitnil,omitempty" name:"BackupZone"` @@ -15880,6 +17336,20 @@ type UpgradeDBInstanceRequestParams struct { // 针对跨集群搬迁场景,选择同可用区RO的处理逻辑。together-同可用区RO跟随主实例迁移至目标可用区(默认选项),severally-同可用区RO保持原部署模式、不迁移至目标可用区。 RoTransType *string `json:"RoTransType,omitnil,omitempty" name:"RoTransType"` + + // 集群版节点拓扑配置。 + ClusterTopology *ClusterTopology `json:"ClusterTopology,omitnil,omitempty" name:"ClusterTopology"` + + // 检查原地升级是否需要重启,1 检查, 0 不检查。如果值为1,检查为原地升级需要重启,则会停止升级并进行返回提示,如果为原地升级不重启,则正常执行升级流程。 + CheckFastUpgradeReboot *int64 `json:"CheckFastUpgradeReboot,omitnil,omitempty" name:"CheckFastUpgradeReboot"` + + // 数据校验敏感度,非极速变配时使用此参数,敏感度根据当前实例规格计算迁移过程中的数据对比使用的cpu资源 + // 对应的选项为: "high"、"normal"、"low",默认为空 + // 参数详解,: + // "high": 对应控制台中的高,数据库负载过高不建议使用 + // "normal":对应控制台中的标准 + // "low":对应控制台中的低 + DataCheckSensitive *string `json:"DataCheckSensitive,omitnil,omitempty" name:"DataCheckSensitive"` } type UpgradeDBInstanceRequest struct { @@ -15904,13 +17374,14 @@ type UpgradeDBInstanceRequest struct { // 备库1的可用区信息,默认和实例的 Zone 参数一致,升级主实例为多可用区部署时可指定该参数,升级只读实例或者灾备实例时指定该参数无意义。可通过 [获取云数据库可售卖规格](https://cloud.tencent.com/document/product/236/17229) 接口查询支持的可用区。 SlaveZone *string `json:"SlaveZone,omitnil,omitempty" name:"SlaveZone"` - // 主实例数据库引擎版本,支持值包括:5.5、5.6 和 5.7。 + // 主实例数据库引擎版本,支持值包括:5.5、5.6、5.7、8.0。 + // 说明:升级数据库版本请使用 [UpgradeDBInstanceEngineVersion](https://cloud.tencent.com/document/api/236/15870) 接口。 EngineVersion *string `json:"EngineVersion,omitnil,omitempty" name:"EngineVersion"` // 切换访问新实例的方式,默认为 0。支持值包括:0 - 立刻切换,1 - 时间窗切换;当该值为 1 时,升级过程中,切换访问新实例的流程将会在时间窗内进行,或者用户主动调用接口 [切换访问新实例](https://cloud.tencent.com/document/product/236/15864) 触发该流程。 WaitSwitch *int64 `json:"WaitSwitch,omitnil,omitempty" name:"WaitSwitch"` - // 备库 2 的可用区信息,默认为空,升级主实例时可指定该参数,升级只读实例或者灾备实例时指定该参数无意义。 + // 备库2的可用区信息,默认为空,升级主实例时可指定该参数,升级只读实例或者灾备实例时指定该参数无意义。可通过 [获取云数据库可售卖规格](https://cloud.tencent.com/document/product/236/17229) 接口查询支持的可用区。 // 备注:如您要将三节点降级至双节点,将该参数设置为空值即可实现。 BackupZone *string `json:"BackupZone,omitnil,omitempty" name:"BackupZone"` @@ -15938,6 +17409,20 @@ type UpgradeDBInstanceRequest struct { // 针对跨集群搬迁场景,选择同可用区RO的处理逻辑。together-同可用区RO跟随主实例迁移至目标可用区(默认选项),severally-同可用区RO保持原部署模式、不迁移至目标可用区。 RoTransType *string `json:"RoTransType,omitnil,omitempty" name:"RoTransType"` + + // 集群版节点拓扑配置。 + ClusterTopology *ClusterTopology `json:"ClusterTopology,omitnil,omitempty" name:"ClusterTopology"` + + // 检查原地升级是否需要重启,1 检查, 0 不检查。如果值为1,检查为原地升级需要重启,则会停止升级并进行返回提示,如果为原地升级不重启,则正常执行升级流程。 + CheckFastUpgradeReboot *int64 `json:"CheckFastUpgradeReboot,omitnil,omitempty" name:"CheckFastUpgradeReboot"` + + // 数据校验敏感度,非极速变配时使用此参数,敏感度根据当前实例规格计算迁移过程中的数据对比使用的cpu资源 + // 对应的选项为: "high"、"normal"、"low",默认为空 + // 参数详解,: + // "high": 对应控制台中的高,数据库负载过高不建议使用 + // "normal":对应控制台中的标准 + // "low":对应控制台中的低 + DataCheckSensitive *string `json:"DataCheckSensitive,omitnil,omitempty" name:"DataCheckSensitive"` } func (r *UpgradeDBInstanceRequest) ToJsonString() string { @@ -15969,6 +17454,9 @@ func (r *UpgradeDBInstanceRequest) FromJsonString(s string) error { delete(f, "CrossCluster") delete(f, "ZoneId") delete(f, "RoTransType") + delete(f, "ClusterTopology") + delete(f, "CheckFastUpgradeReboot") + delete(f, "DataCheckSensitive") if len(f) > 0 { return tcerr.NewTencentCloudSDKError("ClientError.BuildRequestError", "UpgradeDBInstanceRequest has unknown keys!", "") } @@ -15980,7 +17468,7 @@ type UpgradeDBInstanceResponseParams struct { // 订单 ID。 DealIds []*string `json:"DealIds,omitnil,omitempty" name:"DealIds"` - // 异步任务的请求 ID,可使用此 ID 查询异步任务的执行结果。 + // 异步任务的请求 ID,可使用此 ID [查询异步任务的执行结果](https://cloud.tencent.com/document/product/236/20410)。 AsyncRequestId *string `json:"AsyncRequestId,omitnil,omitempty" name:"AsyncRequestId"` // 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 @@ -16003,6 +17491,14 @@ func (r *UpgradeDBInstanceResponse) FromJsonString(s string) error { return json.Unmarshal([]byte(s), &r) } +type UpgradeEngineVersionParams struct { + // 参数名称 + Name *string `json:"Name,omitnil,omitempty" name:"Name"` + + // 参数值 + Value *string `json:"Value,omitnil,omitempty" name:"Value"` +} + type UploadInfo struct { // 文件所有分片数 AllSliceNum *int64 `json:"AllSliceNum,omitnil,omitempty" name:"AllSliceNum"` diff --git a/vendor/modules.txt b/vendor/modules.txt index 8426413675..b33d11235c 100644 --- a/vendor/modules.txt +++ b/vendor/modules.txt @@ -1128,7 +1128,7 @@ github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cat/v20180409 # github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cbs v1.1.0 ## explicit; go 1.14 github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cbs/v20170312 -# github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cdb v1.0.944 +# github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cdb v1.1.27 ## explicit; go 1.14 github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cdb/v20170320 # github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cdc v1.0.1149 diff --git a/website/docs/r/mysql_instance.html.markdown b/website/docs/r/mysql_instance.html.markdown index 604b3a2af1..43ae3c9c8e 100644 --- a/website/docs/r/mysql_instance.html.markdown +++ b/website/docs/r/mysql_instance.html.markdown @@ -148,6 +148,55 @@ resource "tencentcloud_mysql_instance" "example" { } ``` +### Create instance by custom cluster_topology + +```hcl +resource "tencentcloud_mysql_instance" "example" { + instance_name = "tf-example" + internet_service = 1 + engine_version = "5.7" + charge_type = "POSTPAID" + root_password = "PassWord@123" + slave_deploy_mode = 1 + slave_sync_mode = 1 + device_type = "CLOUD_NATIVE_CLUSTER" + availability_zone = "ap-guangzhou-6" + cpu = 2 + mem_size = 4000 + volume_size = 200 + vpc_id = "vpc-i5yyodl9" + subnet_id = "subnet-hhi88a58" + intranet_port = 3306 + security_groups = ["sg-e6a8xxib"] + parameters = { + character_set_server = "utf8" + max_connections = "1000" + } + tags = { + createBy = "Terraform" + } + + cluster_topology { + read_write_node { + zone = "ap-guangzhou-6" + } + + read_only_nodes { + is_random_zone = true + } + + read_only_nodes { + zone = "ap-guangzhou-7" + } + } + + timeouts { + create = "30m" + delete = "30m" + } +} +``` + ## Argument Reference The following arguments are supported: @@ -158,6 +207,7 @@ The following arguments are supported: * `auto_renew_flag` - (Optional, Int) Auto renew flag. NOTES: Only supported prepaid instance. * `availability_zone` - (Optional, String) Indicates which availability zone will be used. * `charge_type` - (Optional, String, ForceNew) Pay type of instance. Valid values:`PREPAID`, `POSTPAID`. Default is `POSTPAID`. +* `cluster_topology` - (Optional, List) Cluster Edition node topology configuration. Note: If you purchased a cluster edition instance, this parameter is required. You need to set the RW and RO node topology of the cluster edition instance. The RO node range is 1-5. Please set at least 1 RO node. * `cpu` - (Optional, Int) CPU cores. * `device_type` - (Optional, String) Specify device type, available values: - `UNIVERSAL` (default): universal instance, @@ -191,6 +241,22 @@ If it is not specified, it defaults to a universal instance. * `vpc_id` - (Optional, String) ID of VPC, which can be modified once every 24 hours and can't be removed. * `wait_switch` - (Optional, Int) Switch the method of accessing new instances, default is `0`. Supported values include: `0` - switch immediately, `1` - switch in time window. +The `cluster_topology` object supports the following: + +* `read_only_nodes` - (Optional, Set) RO Node Topology. +* `read_write_node` - (Optional, List) RW Node Topology. + +The `read_only_nodes` object of `cluster_topology` supports the following: + +* `is_random_zone` - (Optional, Bool) Whether to distribute in random availability zones. Enter `true` to specify a random availability zone. Otherwise, use the availability zone specified by Zone. +* `node_id` - (Optional, String) When upgrading a cluster instance, if you want to adjust the availability zone of a read-only node, you need to specify the node ID. +* `zone` - (Optional, String) Specifies the availability zone where the node is distributed. + +The `read_write_node` object of `cluster_topology` supports the following: + +* `zone` - (Required, String) The availability zone where the RW node is located. +* `node_id` - (Optional, String) When upgrading a cluster instance, if you want to adjust the availability zone of a read-only node, you need to specify the node ID. + ## Attributes Reference In addition to all arguments above, the following attributes are exported: diff --git a/website/docs/r/mysql_readonly_instance.html.markdown b/website/docs/r/mysql_readonly_instance.html.markdown index 7714d29ec1..1fce5b805e 100644 --- a/website/docs/r/mysql_readonly_instance.html.markdown +++ b/website/docs/r/mysql_readonly_instance.html.markdown @@ -91,6 +91,7 @@ The following arguments are supported: * `volume_size` - (Required, Int) Disk size (in GB). * `auto_renew_flag` - (Optional, Int) Auto renew flag. NOTES: Only supported prepaid instance. * `charge_type` - (Optional, String, ForceNew) Pay type of instance. Valid values:`PREPAID`, `POSTPAID`. Default is `POSTPAID`. +* `cluster_topology` - (Optional, List) Cluster Edition node topology configuration. Note: If you purchased a cluster edition instance, this parameter is required. You need to set the RW and RO node topology of the cluster edition instance. The RO node range is 1-5. Please set at least 1 RO node. * `cpu` - (Optional, Int) CPU cores. * `device_type` - (Optional, String) Specify device type, available values: - `UNIVERSAL` (default): universal instance, @@ -116,6 +117,22 @@ If it is not specified, it defaults to a universal instance. * `wait_switch` - (Optional, Int) Switch the method of accessing new instances, default is `0`. Supported values include: `0` - switch immediately, `1` - switch in time window. * `zone` - (Optional, String) Zone information, this parameter defaults to, the system automatically selects an Availability Zone. +The `cluster_topology` object supports the following: + +* `read_only_nodes` - (Optional, Set) RO Node Topology. +* `read_write_node` - (Optional, List) RW Node Topology. + +The `read_only_nodes` object of `cluster_topology` supports the following: + +* `is_random_zone` - (Optional, Bool) Whether to distribute in random availability zones. Enter `true` to specify a random availability zone. Otherwise, use the availability zone specified by Zone. +* `node_id` - (Optional, String) When upgrading a cluster instance, if you want to adjust the availability zone of a read-only node, you need to specify the node ID. +* `zone` - (Optional, String) Specifies the availability zone where the node is distributed. + +The `read_write_node` object of `cluster_topology` supports the following: + +* `zone` - (Required, String) The availability zone where the RW node is located. +* `node_id` - (Optional, String) When upgrading a cluster instance, if you want to adjust the availability zone of a read-only node, you need to specify the node ID. + ## Attributes Reference In addition to all arguments above, the following attributes are exported: From 32308d7684ffc8f3e8dc957858d4d9fa4a82c93a Mon Sep 17 00:00:00 2001 From: SevenEarth <391613297@qq.com> Date: Tue, 23 Sep 2025 11:18:02 +0800 Subject: [PATCH 2/2] add --- .changelog/3532.txt | 3 +++ 1 file changed, 3 insertions(+) create mode 100644 .changelog/3532.txt diff --git a/.changelog/3532.txt b/.changelog/3532.txt new file mode 100644 index 0000000000..225d972493 --- /dev/null +++ b/.changelog/3532.txt @@ -0,0 +1,3 @@ +```release-note:enhancement +resource/tencentcloud_mysql_instance: support `cluster_topology` fields +```