tccli 3.0.1188.1__py2.py3-none-any.whl → 3.0.1190.1__py2.py3-none-any.whl

tccli/services/dcdb/dcdb_client.py

@@ -1629,6 +1629,58 @@ def doIsolateHourDCDBInstance(args, parsed_globals):
     FormatOutput.output("action", json_obj, g_param[OptionsDefine.Output], g_param[OptionsDefine.Filter])
 
 
+def doDescribeBackupConfigs(args, parsed_globals):
+    g_param = parse_global_arg(parsed_globals)
+
+    if g_param[OptionsDefine.UseCVMRole.replace('-', '_')]:
+        cred = credential.CVMRoleCredential()
+    elif g_param[OptionsDefine.RoleArn.replace('-', '_')] and g_param[OptionsDefine.RoleSessionName.replace('-', '_')]:
+        cred = credential.STSAssumeRoleCredential(
+            g_param[OptionsDefine.SecretId], g_param[OptionsDefine.SecretKey], g_param[OptionsDefine.RoleArn.replace('-', '_')],
+            g_param[OptionsDefine.RoleSessionName.replace('-', '_')], endpoint=g_param["sts_cred_endpoint"]
+        )
+    elif os.getenv(OptionsDefine.ENV_TKE_REGION)             and os.getenv(OptionsDefine.ENV_TKE_PROVIDER_ID)             and os.getenv(OptionsDefine.ENV_TKE_WEB_IDENTITY_TOKEN_FILE)             and os.getenv(OptionsDefine.ENV_TKE_ROLE_ARN):
+        cred = credential.DefaultTkeOIDCRoleArnProvider().get_credentials()
+    else:
+        cred = credential.Credential(
+            g_param[OptionsDefine.SecretId], g_param[OptionsDefine.SecretKey], g_param[OptionsDefine.Token]
+        )
+    http_profile = HttpProfile(
+        reqTimeout=60 if g_param[OptionsDefine.Timeout] is None else int(g_param[OptionsDefine.Timeout]),
+        reqMethod="POST",
+        endpoint=g_param[OptionsDefine.Endpoint],
+        proxy=g_param[OptionsDefine.HttpsProxy.replace('-', '_')]
+    )
+    profile = ClientProfile(httpProfile=http_profile, signMethod="HmacSHA256")
+    if g_param[OptionsDefine.Language]:
+        profile.language = g_param[OptionsDefine.Language]
+    mod = CLIENT_MAP[g_param[OptionsDefine.Version]]
+    client = mod.DcdbClient(cred, g_param[OptionsDefine.Region], profile)
+    client._sdkVersion += ("_CLI_" + __version__)
+    models = MODELS_MAP[g_param[OptionsDefine.Version]]
+    model = models.DescribeBackupConfigsRequest()
+    model.from_json_string(json.dumps(args))
+    start_time = time.time()
+    while True:
+        rsp = client.DescribeBackupConfigs(model)
+        result = rsp.to_json_string()
+        try:
+            json_obj = json.loads(result)
+        except TypeError as e:
+            json_obj = json.loads(result.decode('utf-8'))  # python3.3
+        if not g_param[OptionsDefine.Waiter] or search(g_param['OptionsDefine.WaiterInfo']['expr'], json_obj) == g_param['OptionsDefine.WaiterInfo']['to']:
+            break
+        cur_time = time.time()
+        if cur_time - start_time >= g_param['OptionsDefine.WaiterInfo']['timeout']:
+            raise ClientError('Request timeout, wait `%s` to `%s` timeout, last request is %s' %
+            (g_param['OptionsDefine.WaiterInfo']['expr'], g_param['OptionsDefine.WaiterInfo']['to'],
+            search(g_param['OptionsDefine.WaiterInfo']['expr'], json_obj)))
+        else:
+            print('Inquiry result is %s.' % search(g_param['OptionsDefine.WaiterInfo']['expr'], json_obj))
+        time.sleep(g_param['OptionsDefine.WaiterInfo']['interval'])
+    FormatOutput.output("action", json_obj, g_param[OptionsDefine.Output], g_param[OptionsDefine.Filter])
+
+
 def doDescribeDBSyncMode(args, parsed_globals):
     g_param = parse_global_arg(parsed_globals)
 
@@ -3501,6 +3553,58 @@ def doCreateAccount(args, parsed_globals):
     FormatOutput.output("action", json_obj, g_param[OptionsDefine.Output], g_param[OptionsDefine.Filter])
 
 
+def doModifyBackupConfigs(args, parsed_globals):
+    g_param = parse_global_arg(parsed_globals)
+
+    if g_param[OptionsDefine.UseCVMRole.replace('-', '_')]:
+        cred = credential.CVMRoleCredential()
+    elif g_param[OptionsDefine.RoleArn.replace('-', '_')] and g_param[OptionsDefine.RoleSessionName.replace('-', '_')]:
+        cred = credential.STSAssumeRoleCredential(
+            g_param[OptionsDefine.SecretId], g_param[OptionsDefine.SecretKey], g_param[OptionsDefine.RoleArn.replace('-', '_')],
+            g_param[OptionsDefine.RoleSessionName.replace('-', '_')], endpoint=g_param["sts_cred_endpoint"]
+        )
+    elif os.getenv(OptionsDefine.ENV_TKE_REGION)             and os.getenv(OptionsDefine.ENV_TKE_PROVIDER_ID)             and os.getenv(OptionsDefine.ENV_TKE_WEB_IDENTITY_TOKEN_FILE)             and os.getenv(OptionsDefine.ENV_TKE_ROLE_ARN):
+        cred = credential.DefaultTkeOIDCRoleArnProvider().get_credentials()
+    else:
+        cred = credential.Credential(
+            g_param[OptionsDefine.SecretId], g_param[OptionsDefine.SecretKey], g_param[OptionsDefine.Token]
+        )
+    http_profile = HttpProfile(
+        reqTimeout=60 if g_param[OptionsDefine.Timeout] is None else int(g_param[OptionsDefine.Timeout]),
+        reqMethod="POST",
+        endpoint=g_param[OptionsDefine.Endpoint],
+        proxy=g_param[OptionsDefine.HttpsProxy.replace('-', '_')]
+    )
+    profile = ClientProfile(httpProfile=http_profile, signMethod="HmacSHA256")
+    if g_param[OptionsDefine.Language]:
+        profile.language = g_param[OptionsDefine.Language]
+    mod = CLIENT_MAP[g_param[OptionsDefine.Version]]
+    client = mod.DcdbClient(cred, g_param[OptionsDefine.Region], profile)
+    client._sdkVersion += ("_CLI_" + __version__)
+    models = MODELS_MAP[g_param[OptionsDefine.Version]]
+    model = models.ModifyBackupConfigsRequest()
+    model.from_json_string(json.dumps(args))
+    start_time = time.time()
+    while True:
+        rsp = client.ModifyBackupConfigs(model)
+        result = rsp.to_json_string()
+        try:
+            json_obj = json.loads(result)
+        except TypeError as e:
+            json_obj = json.loads(result.decode('utf-8'))  # python3.3
+        if not g_param[OptionsDefine.Waiter] or search(g_param['OptionsDefine.WaiterInfo']['expr'], json_obj) == g_param['OptionsDefine.WaiterInfo']['to']:
+            break
+        cur_time = time.time()
+        if cur_time - start_time >= g_param['OptionsDefine.WaiterInfo']['timeout']:
+            raise ClientError('Request timeout, wait `%s` to `%s` timeout, last request is %s' %
+            (g_param['OptionsDefine.WaiterInfo']['expr'], g_param['OptionsDefine.WaiterInfo']['to'],
+            search(g_param['OptionsDefine.WaiterInfo']['expr'], json_obj)))
+        else:
+            print('Inquiry result is %s.' % search(g_param['OptionsDefine.WaiterInfo']['expr'], json_obj))
+        time.sleep(g_param['OptionsDefine.WaiterInfo']['interval'])
+    FormatOutput.output("action", json_obj, g_param[OptionsDefine.Output], g_param[OptionsDefine.Filter])
+
+
 def doModifyDBInstanceName(args, parsed_globals):
     g_param = parse_global_arg(parsed_globals)
 
@@ -3907,6 +4011,7 @@ ACTION_MAP = {
     "KillSession": doKillSession,
     "DescribeDBLogFiles": doDescribeDBLogFiles,
     "IsolateHourDCDBInstance": doIsolateHourDCDBInstance,
+    "DescribeBackupConfigs": doDescribeBackupConfigs,
     "DescribeDBSyncMode": doDescribeDBSyncMode,
     "DescribeDCDBBinlogTime": doDescribeDCDBBinlogTime,
     "UpgradeHourDCDBInstance": doUpgradeHourDCDBInstance,
@@ -3943,6 +4048,7 @@ ACTION_MAP = {
     "InitDCDBInstances": doInitDCDBInstances,
     "DescribeDCDBInstanceDetail": doDescribeDCDBInstanceDetail,
     "CreateAccount": doCreateAccount,
+    "ModifyBackupConfigs": doModifyBackupConfigs,
     "ModifyDBInstanceName": doModifyDBInstanceName,
     "DescribeLogFileRetentionPeriod": doDescribeLogFileRetentionPeriod,
     "CreateTmpDCDBInstance": doCreateTmpDCDBInstance,

tccli/services/dcdb/v20180411/api.json

@@ -98,6 +98,13 @@
       "output": "DescribeAccountsResponse",
       "status": "online"
     },
+    "DescribeBackupConfigs": {
+      "document": "本接口(DescribeBackupConfigs)用于查询数据库备份配置信息。",
+      "input": "DescribeBackupConfigsRequest",
+      "name": "查询云数据库备份配置信息",
+      "output": "DescribeBackupConfigsResponse",
+      "status": "online"
+    },
     "DescribeBackupFiles": {
       "document": "本接口(DescribeBackupFiles)用于查看备份文件列表。",
       "input": "DescribeBackupFilesRequest",
@@ -392,6 +399,13 @@
       "output": "ModifyAccountPrivilegesResponse",
       "status": "online"
     },
+    "ModifyBackupConfigs": {
+      "document": "本接口(ModifyBackupConfigs)用于修改数据库备份配置信息。\n\n1. 修改数据库超期备份配置，目前按年、按月、按日只支持一种，存在互斥关系，如当前策略按年备份，如果传入按月备份策略将会覆盖当前的按年备份策略，务必注意。",
+      "input": "ModifyBackupConfigsRequest",
+      "name": "修改云数据库备份配置信息",
+      "output": "ModifyBackupConfigsResponse",
+      "status": "online"
+    },
     "ModifyDBEncryptAttributes": {
       "document": "本接口(ModifyDBEncryptAttributes)用于修改实例数据加密。",
       "input": "ModifyDBEncryptAttributesRequest",
@@ -678,6 +692,72 @@
       ],
       "type": "object"
     },
+    "BackupConfig": {
+      "document": "数据库超期备份配置",
+      "members": [
+        {
+          "disabled": false,
+          "document": "备份策略是否启用。",
+          "example": "true",
+          "member": "bool",
+          "name": "EnableBackupPolicy",
+          "output_required": true,
+          "type": "bool",
+          "value_allowed_null": false
+        },
+        {
+          "disabled": false,
+          "document": "超期保留开始日期，早于开始日期的超期备份不保留，格式：yyyy-mm-dd。",
+          "example": "2023-05-30",
+          "member": "string",
+          "name": "BeginDate",
+          "output_required": true,
+          "type": "string",
+          "value_allowed_null": false
+        },
+        {
+          "disabled": false,
+          "document": "超期备份保留时长，超出保留时间的超期备份将被删除，可填写1-3650整数。",
+          "example": "180",
+          "member": "int64",
+          "name": "MaxRetentionDays",
+          "output_required": true,
+          "type": "int",
+          "value_allowed_null": false
+        },
+        {
+          "disabled": false,
+          "document": "备份模式，可选择按年月周模式保存\n* 按年：annually\n* 按月：monthly\n* 按周：weekly",
+          "example": "monthly",
+          "member": "string",
+          "name": "Frequency",
+          "output_required": true,
+          "type": "string",
+          "value_allowed_null": false
+        },
+        {
+          "disabled": false,
+          "document": "Frequency等于weekly时生效。\n表示保留特定工作日备份。可选择周一到周日，支持多选，取星期英文：\n* 星期一 ：Monday\n* 星期二 ：Tuesday\n* 星期三：Wednesday\n* 星期四：Thursday\n* 星期五：Friday\n* 星期六：Saturday\n* 星期日：Sunday",
+          "example": "Monday",
+          "member": "string",
+          "name": "WeekDays",
+          "output_required": false,
+          "type": "list",
+          "value_allowed_null": false
+        },
+        {
+          "disabled": false,
+          "document": "保留备份个数，Frequency等于monthly或weekly时生效。\n备份模式选择按月时，可填写1-28整数；\n备份模式选择年时，可填写1-336整数。",
+          "example": "10",
+          "member": "int64",
+          "name": "BackupCount",
+          "output_required": false,
+          "type": "int",
+          "value_allowed_null": false
+        }
+      ],
+      "usage": "out"
+    },
     "BriefNodeInfo": {
       "document": "描述分片DB节点信息",
       "members": [
@@ -3605,6 +3685,103 @@
       ],
       "type": "object"
     },
+    "DescribeBackupConfigsRequest": {
+      "document": "DescribeBackupConfigs请求参数结构体",
+      "members": [
+        {
+          "disabled": false,
+          "document": "实例 ID，格式如：tdsqlshard-c1nl9rpv，与云数据库控制台页面中显示的实例 ID 相同。",
+          "example": "tdsqlshard-c1nl9rpv",
+          "member": "string",
+          "name": "InstanceId",
+          "required": true,
+          "type": "string"
+        }
+      ],
+      "type": "object"
+    },
+    "DescribeBackupConfigsResponse": {
+      "document": "DescribeBackupConfigs返回参数结构体",
+      "members": [
+        {
+          "disabled": false,
+          "document": "实例 ID。",
+          "example": "tdsqlshard-c1nl9rpv",
+          "member": "string",
+          "name": "InstanceId",
+          "output_required": true,
+          "type": "string",
+          "value_allowed_null": false
+        },
+        {
+          "disabled": false,
+          "document": "常规备份存储时长，范围[1, 3650]。",
+          "example": "30",
+          "member": "uint64",
+          "name": "Days",
+          "output_required": true,
+          "type": "int",
+          "value_allowed_null": false
+        },
+        {
+          "disabled": false,
+          "document": "每天备份执行的区间的开始时间，格式 mm:ss，形如 22:00。",
+          "example": "03:00",
+          "member": "string",
+          "name": "StartBackupTime",
+          "output_required": true,
+          "type": "string",
+          "value_allowed_null": false
+        },
+        {
+          "disabled": false,
+          "document": "每天备份执行的区间的结束时间，格式 mm:ss，形如 23:59。",
+          "example": "05:59",
+          "member": "string",
+          "name": "EndBackupTime",
+          "output_required": true,
+          "type": "string",
+          "value_allowed_null": false
+        },
+        {
+          "disabled": false,
+          "document": "执行备份周期，枚举值：Monday,Tuesday,Wednesday,Thursday,Friday,Saturday,Sunday",
+          "example": "[Saturday, Sunday]",
+          "member": "string",
+          "name": "WeekDays",
+          "output_required": true,
+          "type": "list",
+          "value_allowed_null": false
+        },
+        {
+          "disabled": false,
+          "document": "沉降到归档存储时长，-1表示关闭归档设置。",
+          "example": "91",
+          "member": "int64",
+          "name": "ArchiveDays",
+          "output_required": true,
+          "type": "int",
+          "value_allowed_null": false
+        },
+        {
+          "disabled": false,
+          "document": "超期备份配置。",
+          "example": "无",
+          "member": "BackupConfig",
+          "name": "BackupConfigSet",
+          "output_required": true,
+          "type": "list",
+          "value_allowed_null": false
+        },
+        {
+          "document": "唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。",
+          "member": "string",
+          "name": "RequestId",
+          "type": "string"
+        }
+      ],
+      "type": "object"
+    },
     "DescribeBackupFilesRequest": {
       "document": "DescribeBackupFiles请求参数结构体",
       "members": [
@@ -7141,6 +7318,87 @@
       ],
       "type": "object"
     },
+    "ModifyBackupConfigsRequest": {
+      "document": "ModifyBackupConfigs请求参数结构体",
+      "members": [
+        {
+          "disabled": false,
+          "document": "实例 ID，格式如：tdsqlshard-c1nl9rpv，与云数据库控制台页面中显示的实例 ID 相同。",
+          "example": "tdsqlshard-c1nl9rpv",
+          "member": "string",
+          "name": "InstanceId",
+          "required": true,
+          "type": "string"
+        },
+        {
+          "disabled": false,
+          "document": "常规备份存储时长，范围[1, 3650]。",
+          "example": "30",
+          "member": "uint64",
+          "name": "Days",
+          "required": false,
+          "type": "int"
+        },
+        {
+          "disabled": false,
+          "document": "每天备份执行的区间的开始时间，格式 mm:ss，形如 22:00。",
+          "example": "03:00",
+          "member": "string",
+          "name": "StartBackupTime",
+          "required": false,
+          "type": "string"
+        },
+        {
+          "disabled": false,
+          "document": "每天备份执行的区间的结束时间，格式 mm:ss，形如 23:59。",
+          "example": "05:59",
+          "member": "string",
+          "name": "EndBackupTime",
+          "required": false,
+          "type": "string"
+        },
+        {
+          "disabled": false,
+          "document": "执行备份周期，枚举值：Monday,Tuesday,Wednesday,Thursday,Friday,Saturday,Sunday",
+          "example": "[Saturday, Sunday]",
+          "member": "string",
+          "name": "WeekDays",
+          "required": false,
+          "type": "list"
+        },
+        {
+          "disabled": false,
+          "document": "沉降到归档存储时长，-1表示关闭归档设置。",
+          "example": "91",
+          "member": "int64",
+          "name": "ArchiveDays",
+          "required": false,
+          "type": "int"
+        },
+        {
+          "disabled": false,
+          "document": "超期备份配置。",
+          "example": "无",
+          "member": "NewBackupConfig",
+          "name": "BackupConfigSet",
+          "required": false,
+          "type": "list"
+        }
+      ],
+      "type": "object"
+    },
+    "ModifyBackupConfigsResponse": {
+      "document": "ModifyBackupConfigs返回参数结构体",
+      "members": [
+        {
+          "document": "唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。",
+          "member": "string",
+          "name": "RequestId",
+          "type": "string"
+        }
+      ],
+      "type": "object"
+    },
     "ModifyDBEncryptAttributesRequest": {
       "document": "ModifyDBEncryptAttributes请求参数结构体",
       "members": [
@@ -7624,6 +7882,66 @@
       ],
       "type": "object"
     },
+    "NewBackupConfig": {
+      "document": "数据库超期备份配置",
+      "members": [
+        {
+          "disabled": false,
+          "document": "备份策略是否启用。",
+          "example": "true",
+          "member": "bool",
+          "name": "EnableBackupPolicy",
+          "required": true,
+          "type": "bool"
+        },
+        {
+          "disabled": false,
+          "document": "超期保留开始日期，早于开始日期的超期备份不保留，格式：yyyy-mm-dd。",
+          "example": "2023-05-30",
+          "member": "string",
+          "name": "BeginDate",
+          "required": true,
+          "type": "string"
+        },
+        {
+          "disabled": false,
+          "document": "超期备份保留时长，超出保留时间的超期备份将被删除，可填写1-3650整数。",
+          "example": "180",
+          "member": "int64",
+          "name": "MaxRetentionDays",
+          "required": true,
+          "type": "int"
+        },
+        {
+          "disabled": false,
+          "document": "备份模式，可选择按年月周模式保存\n* 按年：annually\n* 按月：monthly\n* 按周：weekly",
+          "example": "monthly",
+          "member": "string",
+          "name": "Frequency",
+          "required": true,
+          "type": "string"
+        },
+        {
+          "disabled": false,
+          "document": "Frequency等于weekly时生效。\n表示保留特定工作日备份。可选择周一到周日，支持多选，取星期英文：\n* 星期一 ：Monday\n* 星期二 ：Tuesday\n* 星期三：Wednesday\n* 星期四：Thursday\n* 星期五：Friday\n* 星期六：Saturday\n* 星期日：Sunday",
+          "example": "Monday",
+          "member": "string",
+          "name": "WeekDays",
+          "required": false,
+          "type": "list"
+        },
+        {
+          "disabled": false,
+          "document": "保留备份个数，Frequency等于monthly或weekly时生效。\n备份模式选择按月时，可填写1-28整数；\n备份模式选择年时，可填写1-336整数。",
+          "example": "10",
+          "member": "int64",
+          "name": "BackupCount",
+          "required": false,
+          "type": "int"
+        }
+      ],
+      "usage": "in"
+    },
     "NodeInfo": {
       "document": "描述DB节点信息",
       "members": [

tccli/services/dcdb/v20180411/examples.json

@@ -112,6 +112,20 @@
         "title": "无"
       }
     ],
+    "DescribeBackupConfigs": [
+      {
+        "document": "获取超期备份策略",
+        "input": "POST / HTTP/1.1\nHost: dcdb.tencentcloudapi.com\nContent-Type: application/json\nX-TC-Action: DescribeBackupConfigs\n<公共请求参数>\n\n{\n    \"InstanceId\": \"tdsqlshard-6cmpk1rd\"\n}",
+        "output": "{\n    \"Response\": {\n        \"Days\": 30,\n        \"StartBackupTime\": \"03:00\",\n        \"EndBackupTime\": \"05:00\",\n        \"WeekDays\": [\n            \"Monday\",\n            \"Sunday\"\n        ],\n        \"ArchiveDays\": 91,\n        \"BackupConfigSet\": [\n            {\n                \"BackupCount\": 1,\n                \"BeginDate\": \"2023-06-08\",\n                \"EnableBackupPolicy\": true,\n                \"Frequency\": \"monthly\",\n                \"MaxRetentionDays\": 365,\n                \"WeekDays\": []\n            }\n        ],\n        \"InstanceId\": \"tdsqlshard-6cmpk1rd\",\n        \"RequestId\": \"827d5b16-d464-4f43-af92-06c63d25375e\"\n    }\n}",
+        "title": "示例"
+      },
+      {
+        "document": "示例1",
+        "input": "POST / HTTP/1.1\nHost: dcdb.tencentcloudapi.com\nContent-Type: application/json\nX-TC-Action: DescribeBackupConfigs\n<公共请求参数>\n\n{\n    \"InstanceId\": \"tdsqlshard-2500dqmh\"\n}",
+        "output": "{\n    \"Response\": {\n        \"Days\": 30,\n        \"StartBackupTime\": \"03:00\",\n        \"EndBackupTime\": \"05:00\",\n        \"WeekDays\": [\n            \"Monday\",\n            \"Sunday\"\n        ],\n        \"ArchiveDays\": 91,\n        \"BackupConfigSet\": [\n            {\n                \"BackupCount\": 0,\n                \"BeginDate\": \"2023-07-20\",\n                \"EnableBackupPolicy\": true,\n                \"Frequency\": \"weekly\",\n                \"MaxRetentionDays\": 100,\n                \"WeekDays\": [\n                    \"Monday\",\n                    \"Tuesday\"\n                ]\n            }\n        ],\n        \"InstanceId\": \"tdsqlshard-2500dqmh\",\n        \"RequestId\": \"c4712e5d-78f3-4899-b8f4-0b6af5a17b77\"\n    }\n}",
+        "title": "示例1"
+      }
+    ],
     "DescribeBackupFiles": [
       {
         "document": "",
@@ -448,6 +462,20 @@
         "title": "修改云数据库实例账号的权限信息"
       }
     ],
+    "ModifyBackupConfigs": [
+      {
+        "document": "近一年每个月保留一个备份",
+        "input": "POST / HTTP/1.1\nHost: dcdb.tencentcloudapi.com\nContent-Type: application/json\nX-TC-Action: ModifyBackupConfigs\n<公共请求参数>\n\n{\n    \"InstanceId\": \"tdsqlshard-6cmpk1rd\",\n    \"BackupConfigSet\": [\n        {\n            \"EnableBackupPolicy\": true,\n            \"BeginDate\": \"2023-06-08\",\n            \"MaxRetentionDays\": 365,\n            \"Frequency\": \"monthly\",\n            \"BackupCount\": 1\n        }\n    ]\n}",
+        "output": "{\n    \"Response\": {\n        \"RequestId\": \"a0495e38-cd59-420c-8f09-893207d28955\"\n    }\n}",
+        "title": "示例"
+      },
+      {
+        "document": "按周保留备份",
+        "input": "POST / HTTP/1.1\nHost: dcdb.tencentcloudapi.com\nContent-Type: application/json\nX-TC-Action: ModifyBackupConfigs\n<公共请求参数>\n\n{\n    \"InstanceId\": \"tdsqlshard-2500dqmh\",\n    \"BackupConfigSet\": [\n        {\n            \"EnableBackupPolicy\": true,\n            \"BeginDate\": \"2023-07-20\",\n            \"MaxRetentionDays\": 100,\n            \"Frequency\": \"weekly\",\n            \"WeekDays\": [\n                \"Monday\",\n                \"Tuesday\"\n            ]\n        }\n    ]\n}",
+        "output": "{\n    \"Response\": {\n        \"RequestId\": \"45b034f3-1ace-45c7-b49e-1fca45f89d9e\"\n    }\n}",
+        "title": "示例1"
+      }
+    ],
     "ModifyDBEncryptAttributes": [
       {
         "document": "用户开启实例的透明加密",

tccli/services/dnspod/dnspod_client.py

@@ -2617,6 +2617,58 @@ def doDescribeRecord(args, parsed_globals):
     FormatOutput.output("action", json_obj, g_param[OptionsDefine.Output], g_param[OptionsDefine.Filter])
 
 
+def doDescribeDomainShareUserList(args, parsed_globals):
+    g_param = parse_global_arg(parsed_globals)
+
+    if g_param[OptionsDefine.UseCVMRole.replace('-', '_')]:
+        cred = credential.CVMRoleCredential()
+    elif g_param[OptionsDefine.RoleArn.replace('-', '_')] and g_param[OptionsDefine.RoleSessionName.replace('-', '_')]:
+        cred = credential.STSAssumeRoleCredential(
+            g_param[OptionsDefine.SecretId], g_param[OptionsDefine.SecretKey], g_param[OptionsDefine.RoleArn.replace('-', '_')],
+            g_param[OptionsDefine.RoleSessionName.replace('-', '_')], endpoint=g_param["sts_cred_endpoint"]
+        )
+    elif os.getenv(OptionsDefine.ENV_TKE_REGION)             and os.getenv(OptionsDefine.ENV_TKE_PROVIDER_ID)             and os.getenv(OptionsDefine.ENV_TKE_WEB_IDENTITY_TOKEN_FILE)             and os.getenv(OptionsDefine.ENV_TKE_ROLE_ARN):
+        cred = credential.DefaultTkeOIDCRoleArnProvider().get_credentials()
+    else:
+        cred = credential.Credential(
+            g_param[OptionsDefine.SecretId], g_param[OptionsDefine.SecretKey], g_param[OptionsDefine.Token]
+        )
+    http_profile = HttpProfile(
+        reqTimeout=60 if g_param[OptionsDefine.Timeout] is None else int(g_param[OptionsDefine.Timeout]),
+        reqMethod="POST",
+        endpoint=g_param[OptionsDefine.Endpoint],
+        proxy=g_param[OptionsDefine.HttpsProxy.replace('-', '_')]
+    )
+    profile = ClientProfile(httpProfile=http_profile, signMethod="HmacSHA256")
+    if g_param[OptionsDefine.Language]:
+        profile.language = g_param[OptionsDefine.Language]
+    mod = CLIENT_MAP[g_param[OptionsDefine.Version]]
+    client = mod.DnspodClient(cred, g_param[OptionsDefine.Region], profile)
+    client._sdkVersion += ("_CLI_" + __version__)
+    models = MODELS_MAP[g_param[OptionsDefine.Version]]
+    model = models.DescribeDomainShareUserListRequest()
+    model.from_json_string(json.dumps(args))
+    start_time = time.time()
+    while True:
+        rsp = client.DescribeDomainShareUserList(model)
+        result = rsp.to_json_string()
+        try:
+            json_obj = json.loads(result)
+        except TypeError as e:
+            json_obj = json.loads(result.decode('utf-8'))  # python3.3
+        if not g_param[OptionsDefine.Waiter] or search(g_param['OptionsDefine.WaiterInfo']['expr'], json_obj) == g_param['OptionsDefine.WaiterInfo']['to']:
+            break
+        cur_time = time.time()
+        if cur_time - start_time >= g_param['OptionsDefine.WaiterInfo']['timeout']:
+            raise ClientError('Request timeout, wait `%s` to `%s` timeout, last request is %s' %
+            (g_param['OptionsDefine.WaiterInfo']['expr'], g_param['OptionsDefine.WaiterInfo']['to'],
+            search(g_param['OptionsDefine.WaiterInfo']['expr'], json_obj)))
+        else:
+            print('Inquiry result is %s.' % search(g_param['OptionsDefine.WaiterInfo']['expr'], json_obj))
+        time.sleep(g_param['OptionsDefine.WaiterInfo']['interval'])
+    FormatOutput.output("action", json_obj, g_param[OptionsDefine.Output], g_param[OptionsDefine.Filter])
+
+
 def doModifyDomainRemark(args, parsed_globals):
     g_param = parse_global_arg(parsed_globals)
 
@@ -3926,6 +3978,7 @@ ACTION_MAP = {
     "ModifyRecord": doModifyRecord,
     "DescribeDomain": doDescribeDomain,
     "DescribeRecord": doDescribeRecord,
+    "DescribeDomainShareUserList": doDescribeDomainShareUserList,
     "ModifyDomainRemark": doModifyDomainRemark,
     "DescribeRecordExistExceptDefaultNS": doDescribeRecordExistExceptDefaultNS,
     "ModifyDomainOwner": doModifyDomainOwner,