tccli 3.0.1331.1__py2.py3-none-any.whl → 3.0.1334.1__py2.py3-none-any.whl

tccli/services/ess/ess_client.py

@@ -3033,6 +3033,58 @@ def doDescribeFileUrls(args, parsed_globals):
     FormatOutput.output("action", json_obj, g_param[OptionsDefine.Output], g_param[OptionsDefine.Filter])
 
 
+def doCreateBatchQuickSignUrl(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.EssClient(cred, g_param[OptionsDefine.Region], profile)
+    client._sdkVersion += ("_CLI_" + __version__)
+    models = MODELS_MAP[g_param[OptionsDefine.Version]]
+    model = models.CreateBatchQuickSignUrlRequest()
+    model.from_json_string(json.dumps(args))
+    start_time = time.time()
+    while True:
+        rsp = client.CreateBatchQuickSignUrl(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 doCreateIntegrationRole(args, parsed_globals):
     g_param = parse_global_arg(parsed_globals)
 
@@ -4177,7 +4229,7 @@ def doDeleteOrganizationAuthorizations(args, parsed_globals):
     FormatOutput.output("action", json_obj, g_param[OptionsDefine.Output], g_param[OptionsDefine.Filter])
 
 
-def doCreateBatchQuickSignUrl(args, parsed_globals):
+def doOperateSeals(args, parsed_globals):
     g_param = parse_global_arg(parsed_globals)
 
     if g_param[OptionsDefine.UseCVMRole.replace('-', '_')]:
@@ -4206,11 +4258,11 @@ def doCreateBatchQuickSignUrl(args, parsed_globals):
     client = mod.EssClient(cred, g_param[OptionsDefine.Region], profile)
     client._sdkVersion += ("_CLI_" + __version__)
     models = MODELS_MAP[g_param[OptionsDefine.Version]]
-    model = models.CreateBatchQuickSignUrlRequest()
+    model = models.OperateSealsRequest()
     model.from_json_string(json.dumps(args))
     start_time = time.time()
     while True:
-        rsp = client.CreateBatchQuickSignUrl(model)
+        rsp = client.OperateSeals(model)
         result = rsp.to_json_string()
         try:
             json_obj = json.loads(result)
@@ -5650,6 +5702,7 @@ ACTION_MAP = {
     "CreateUserMobileChangeUrl": doCreateUserMobileChangeUrl,
     "DeleteSealPolicies": doDeleteSealPolicies,
     "DescribeFileUrls": doDescribeFileUrls,
+    "CreateBatchQuickSignUrl": doCreateBatchQuickSignUrl,
     "CreateIntegrationRole": doCreateIntegrationRole,
     "OperateTemplate": doOperateTemplate,
     "ModifyExtendedService": doModifyExtendedService,
@@ -5672,7 +5725,7 @@ ACTION_MAP = {
     "DescribeUserFlowType": doDescribeUserFlowType,
     "CreateIntegrationEmployees": doCreateIntegrationEmployees,
     "DeleteOrganizationAuthorizations": doDeleteOrganizationAuthorizations,
-    "CreateBatchQuickSignUrl": doCreateBatchQuickSignUrl,
+    "OperateSeals": doOperateSeals,
     "ModifyApplicationCallbackInfo": doModifyApplicationCallbackInfo,
     "CancelFlow": doCancelFlow,
     "UnbindEmployeeUserIdWithClientOpenId": doUnbindEmployeeUserIdWithClientOpenId,

tccli/services/ess/v20201111/api.json

@@ -71,7 +71,7 @@
       "status": "online"
     },
     "CreateBatchSignUrl": {
-      "document": "通过此接口，可以创建小程序批量签署链接，个人/企业员工可通过此链接跳转至小程序进行批量签署。请确保生成链接时的身份信息与签署合同参与方的信息保持一致。\n\n注意事项：\n- 使用此接口生成链接，需要贵企业先开通 <font color=\"red\">个人签署方仅校验手机号 </font>功能。您可以在 <b>【腾讯电子签网页端】->【企业设置】->【拓展服务】</b>中找到该功能。\n- 生成批量签署链接时，<font color=\"red\">合同目标参与方的状态必须为<b>待签署</b>状态</font>。签署人点击链接后需要输入短信验证码才能查看合同内容。\n- 企业员工批量签署链接：需要传入签署方所在企业名称，用户名字和手机号（或者身份证件信息）参数来生成签署链接。<font color=\"red\">该签署方企业必须已完成腾讯电子签企业认证</font>\n- 个人批量签署链接：需要传入签署方用户名字和手机号（或者身份证件信息）参数来生成签署链接。个人批量签署进行的合同的签名区， 全部变成<font color=\"red\">手写签名</font>（不管合同里边设置的签名限制）来进行。\n- 不支持签署方含有签批控件，或设置了签署方在签署时自行添加签署控件功能的合同进行批量签署。",
+      "document": "通过此接口，可以创建小程序批量签署链接，个人/企业员工可通过此链接跳转至小程序进行批量签署。请确保生成链接时的身份信息与签署合同参与方的信息保持一致。\n\n注意事项：\n- 使用此接口生成链接，需要贵企业先开通 <font color=\"red\">个人签署方仅校验手机号 </font>功能。您可以在 <b>【腾讯电子签网页端】->【企业设置】->【拓展服务】</b>中找到该功能。\n- 生成批量签署链接时，<font color=\"red\">合同目标参与方的状态必须为<b>待签署</b>状态</font>。签署人点击链接后需要输入短信验证码才能查看合同内容。\n- 企业员工批量签署链接：需要传入签署方所在企业名称，用户名字和手机号（或者身份证件信息）参数来生成签署链接。<font color=\"red\">该签署方企业必须已完成腾讯电子签企业认证</font>\n- 个人批量签署链接：需要传入签署方用户名字和手机号（或者身份证件信息）参数来生成签署链接。个人批量签署进行的合同的签名区， 全部变成<font color=\"red\">手写签名</font>（不管合同里边设置的签名限制）来进行。\n- 不支持签署方含有签批控件，或设置了签署方在签署时自行添加签署控件功能的合同进行批量签署。\n- 进行小程序批量签署必须指定待签署的流程id，<font color=\"red\">接口中FlowIds参数必传。</font>",
       "input": "CreateBatchSignUrlRequest",
       "name": "获取跳转至腾讯电子签小程序的批量签署链接",
       "output": "CreateBatchSignUrlResponse",
@@ -693,6 +693,13 @@
       "output": "ModifyIntegrationRoleResponse",
       "status": "online"
     },
+    "OperateSeals": {
+      "document": "修改印章状态（停用、启用）",
+      "input": "OperateSealsRequest",
+      "name": "更新印章状态",
+      "output": "OperateSealsResponse",
+      "status": "online"
+    },
     "OperateTemplate": {
       "document": "此接口（OperateTemplate）用于对企业自有模板进行管理操作，所有操作都会有对应的回调触发，具体参考回调文档 <a href=\"https://qian.tencent.com/developers/company/callback_types_templates\" target=\"_blank\">模板操作相关回调</a>\n\n\n# 支持的操作\n## 1. 删除模板 (OperateType=DELETE)\n此操作会将模板从企业自有模板中彻底删除，若要保留模板而不删除，可将模板停用。\n\n## 2. 启用模板 (OperateType=ENABLE)\n此操作是将已停用的模板启用，操作幂等，若模板已启用，接口不报错。\n\n## 3. 停用模板 (OperateType=DISABLE)\n此操作是将已启用的模板停用，操作幂等，若模板已停用，接口不报错，停用后，无法通过此模板发起合同，已发起的合同不受影响。\n\n## 4. 复制模板 (OperateType=COPY)\n此操作将复制一个完全一样的模板，仅支持修改模板名称，若要修改其他模板内容，需到腾讯电子签控制台操作。",
       "input": "OperateTemplateRequest",
@@ -2947,7 +2954,7 @@
         },
         {
           "disabled": false,
-          "document": "批量签署的合同流程ID数组。\n注: `在调用此接口时，请确保合同流程均为本企业发起，且合同数量不超过100个。`",
+          "document": "批量签署的合同流程ID数组，<font color=\"red\">此参数必传。</font>\n注: `在调用此接口时，请确保合同流程均为本企业发起，且合同数量不超过100个。`",
           "example": "[\"yDxbNUyKQDx3oAUuO4zjEBQGidlGe4hP\"]",
           "member": "string",
           "name": "FlowIds",
@@ -2983,7 +2990,7 @@
         },
         {
           "disabled": false,
-          "document": "签署完成后是否自动回跳\n<ul><li>false：否, 签署完成不会自动跳转回来(默认)</li><li>true：是, 签署完成会自动跳转回来</li></ul>\n\n注: \n1. 该参数<font color=\"red\">只针对APP类型（电子签小程序跳转贵方小程序）场景</font> 的签署链接有效\n2. <font color=\"red\">手机应用APP 或 微信小程序需要监控界面的返回走后序逻辑</font>, 微信小程序的文档可以参考[这个](https://developers.weixin.qq.com/miniprogram/dev/reference/api/App.html#onShow-Object-object)\n3. <font color=\"red\">电子签小程序跳转贵方APP，不支持自动跳转，必需用户手动点击完成按钮（微信的限制）</font> ",
+          "document": "签署完成后是否自动回跳\n<ul><li>false：否, 签署完成不会自动跳转回来(默认)</li><li>true：是, 签署完成会自动跳转回来</li></ul>\n\n注: \n1. 该参数<font color=\"red\">只针对APP类型（电子签小程序跳转贵方小程序）场景</font> 的签署链接有效\n2. <font color=\"red\">手机应用APP 或 微信小程序需要监控界面的返回走后序逻辑</font>, 微信小程序的文档可以参考[这个](https://developers.weixin.qq.com/miniprogram/dev/reference/api/App.html#onShow-Object-object)\n3. <font color=\"red\">电子签小程序跳转贵方APP，不支持自动跳转，必须用户手动点击完成按钮（微信的限制）</font> ",
           "example": "true",
           "member": "bool",
           "name": "AutoJumpBack",
@@ -3010,7 +3017,7 @@
         },
         {
           "disabled": false,
-          "document": "是否允许此链接中签署方批量确认已读文件。 <ul><li>false (默认): 不允许批量确认已读文件。</li> <li>true : 允许批量确认已读文件。</li></ul>注：`1. 此功能为白名单功能，使用前请联系对应客户经理进行开通。2. 使用此功能时，FlowIds参数必传。3. 对于企业签署方，如果有签名控件，则会使用用户首次选择的签名类型签署所有含有签名控件的合同。`",
+          "document": "是否允许此链接中签署方批量确认已读文件。 <ul><li>false (默认): 不允许批量确认已读文件。</li> <li>true : 允许批量确认已读文件。</li></ul>\n注：`1. 此功能为白名单功能，使用前请联系对应客户经理进行开通。2. 使用此功能时，FlowIds参数必传。3. 对于企业签署方，如果对印章/签名控件有限制要求，需要保证所有印章/签名签署控件限制要求(印章id或印章/签名类型限制)一致，否则无法使用此功能。`",
           "example": "false",
           "member": "bool",
           "name": "CanSkipReadFlow",
@@ -13900,6 +13907,60 @@
       ],
       "usage": "out"
     },
+    "OperateSealsRequest": {
+      "document": "OperateSeals请求参数结构体",
+      "members": [
+        {
+          "disabled": false,
+          "document": "执行本接口操作的员工信息。 注: 在调用此接口时，请确保指定的员工已获得所需的接口调用权限，并具备接口传入的相应资源的数据权限。",
+          "example": "无",
+          "member": "UserInfo",
+          "name": "Operator",
+          "required": false,
+          "type": "object"
+        },
+        {
+          "disabled": false,
+          "document": "代理企业和员工的信息。 在集团企业代理子企业操作的场景中，需设置此参数。在此情境下，ProxyOrganizationId（子企业的组织ID）为必填项。",
+          "example": "无",
+          "member": "Agent",
+          "name": "Agent",
+          "required": false,
+          "type": "object"
+        },
+        {
+          "disabled": false,
+          "document": "操作类型，int，目前支持传入以下类型：\n<ul><li>1：启用印章</li></ul>\n<ul><li>2：停用印章</li></ul>",
+          "example": "1",
+          "member": "int64",
+          "name": "Act",
+          "required": false,
+          "type": "int"
+        },
+        {
+          "disabled": false,
+          "document": "需要操作的印章ID，数组形式，印章ID可从【web控制台->印章 】获取。",
+          "example": "[\"yDRTZxxxxxJNR\"]",
+          "member": "string",
+          "name": "SealIds",
+          "required": false,
+          "type": "list"
+        }
+      ],
+      "type": "object"
+    },
+    "OperateSealsResponse": {
+      "document": "OperateSeals返回参数结构体",
+      "members": [
+        {
+          "document": "唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。",
+          "member": "string",
+          "name": "RequestId",
+          "type": "string"
+        }
+      ],
+      "type": "object"
+    },
     "OperateTemplateRequest": {
       "document": "OperateTemplate请求参数结构体",
       "members": [
@@ -13938,6 +13999,15 @@
           "name": "Agent",
           "required": false,
           "type": "object"
+        },
+        {
+          "disabled": false,
+          "document": "模板名称，长度不超过64字符。<br>\n模板复制时指定有效，若为空，则复制后模板名称为 **原模板名称_副本**。",
+          "example": "入职协议",
+          "member": "string",
+          "name": "TemplateName",
+          "required": false,
+          "type": "string"
         }
       ],
       "type": "object"
@@ -13945,6 +14015,26 @@
     "OperateTemplateResponse": {
       "document": "OperateTemplate返回参数结构体",
       "members": [
+        {
+          "disabled": false,
+          "document": "模板ID，为32位字符串，模板复制新建时返回",
+          "example": "yDt3sUUckpxzhjc9UxGKGtnEys9Scr8j",
+          "member": "string",
+          "name": "TemplateId",
+          "output_required": false,
+          "type": "string",
+          "value_allowed_null": false
+        },
+        {
+          "disabled": false,
+          "document": "模板名称，模板复制新建时返回",
+          "example": "入职协议",
+          "member": "string",
+          "name": "TemplateName",
+          "output_required": false,
+          "type": "string",
+          "value_allowed_null": false
+        },
         {
           "document": "唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。",
           "member": "string",

tccli/services/ess/v20201111/examples.json

@@ -1896,6 +1896,14 @@
         "title": "示例-普通企业更新角色（不带权限树参数）"
       }
     ],
+    "OperateSeals": [
+      {
+        "document": "将停用的印章修改为启用状态",
+        "input": "POST / HTTP/1.1\nHost: ess.tencentcloudapi.com\nContent-Type: application/json\nX-TC-Action: OperateSeals\n<公共请求参数>\n\n{\n    \"Operator\": {\n        \"UserId\": \"yDCAOUUckpycr4l4UuOiTjVB3yTaFaLI\"\n    },\n    \"Act\": 1,\n    \"SealIds\": [\n        \"yDClqUUckpaj38v1UmGrVdB8iMEXjdyR\"\n    ]\n}",
+        "output": "{\n    \"Response\": {\n        \"RequestId\": \"73fd23a3-7e85-48e5-970a-ca50da5e25af\"\n    }\n}",
+        "title": "启用印章"
+      }
+    ],
     "OperateTemplate": [
       {
         "document": "删除企业下的模板yDwivUUckpo2g6ugUu4sxH2i15SY0OZY",

tccli/services/essbasic/v20210526/api.json

@@ -50,7 +50,7 @@
       "status": "online"
     },
     "ChannelCreateBatchSignUrl": {
-      "document": "通过此接口，创建小程序批量签署链接，个人/企业员工点击此链接即可跳转小程序进行批量签署。\n请确保生成链接时候的身份信息和签署合同参与方的信息保持一致。\n\n注：\n- 使用此接口生成链接，需要提前开通 `个人签署方仅校验手机号` 功能，在 `腾讯电子签网页端-企业设置-拓展服务` 中可以找到。\n- 个人参与方点击链接后需短信验证码才能查看合同内容。\n- 个人用户批量签署，需要传Name，Mobile，IdCardNumber(IdCardType) 参数。\n- saas企业员工用户批量签署，在传递了姓名等基本信息参数的情况下，还需要传OrganizationName（参与方所在企业名称）参数生成签署链接，<font color=\"red\">请确保此企业已完成腾讯电子签企业认证</font>。\n- 子客企业员工用户批量签署，需要传递员工OpenId和子客企业的OrganizationOpenId。<font color=\"red\">请确保此OrganizationOpenId对应子客已经认证，且OpenId对应员工此子客下已经实名</font>。Name，Mobile, IdCard等信息此时可以不传，系统会查询此OpenId实名信息自动补充。\n- 生成批量签署链接时，合同目标参与方状态需为<font color=\"red\">待签署</font>状态。\n- 个人批量签署进行的合同的签名区， 全部变成<font color=\"red\">手写签名</font>（不管合同里边设置的签名限制）来进行。\n- 不支持签署方含有签批控件，或设置了签署方在签署时自行添加签署控件功能的合同进行批量签署。",
+      "document": "通过此接口，创建小程序批量签署链接，个人/企业员工点击此链接即可跳转小程序进行批量签署。\n请确保生成链接时候的身份信息和签署合同参与方的信息保持一致。\n\n注：\n- 使用此接口生成链接，需要提前开通 `个人签署方仅校验手机号` 功能，在 `腾讯电子签网页端-企业设置-拓展服务` 中可以找到。\n- 个人参与方点击链接后需短信验证码才能查看合同内容。\n- 个人用户批量签署，需要传Name，Mobile，IdCardNumber(IdCardType) 参数。\n- saas企业员工用户批量签署，在传递了姓名等基本信息参数的情况下，还需要传OrganizationName（参与方所在企业名称）参数生成签署链接，<font color=\"red\">请确保此企业已完成腾讯电子签企业认证</font>。\n- 子客企业员工用户批量签署，需要传递员工OpenId和子客企业的OrganizationOpenId。<font color=\"red\">请确保此OrganizationOpenId对应子客已经认证，且OpenId对应员工此子客下已经实名</font>。Name，Mobile, IdCard等信息此时可以不传，系统会查询此OpenId实名信息自动补充。\n- 生成批量签署链接时，合同目标参与方状态需为<font color=\"red\">待签署</font>状态。\n- 个人批量签署进行的合同的签名区， 全部变成<font color=\"red\">手写签名</font>（不管合同里边设置的签名限制）来进行。\n- 不支持签署方含有签批控件，或设置了签署方在签署时自行添加签署控件功能的合同进行批量签署。\n- 进行小程序批量签署必须指定待签署的流程id，<font color=\"red\">接口中FlowIds参数必传。</font>",
       "input": "ChannelCreateBatchSignUrlRequest",
       "name": "获取跳转至腾讯电子签小程序的批量签署链接",
       "output": "ChannelCreateBatchSignUrlResponse",
@@ -2006,7 +2006,7 @@
         },
         {
           "disabled": false,
-          "document": "批量签署的合同流程ID数组。\n注: `在调用此接口时，请确保合同流程均为本企业发起，且合同数量不超过100个。`",
+          "document": "批量签署的合同流程ID数组。<font color=\"red\">此参数必传。</font>\n注: `在调用此接口时，请确保合同流程均为本企业发起，且合同数量不超过100个。`",
           "example": "[\"yDwcCUUgyg3tgmwcUEVzyNaupO7DiB3E\"]",
           "member": "string",
           "name": "FlowIds",
@@ -2096,7 +2096,7 @@
         },
         {
           "disabled": false,
-          "document": "是否允许此链接中签署方批量确认已读文件。 <ul><li>false (默认): 不允许批量确认已读文件。</li> <li>true : 允许批量确认已读文件。</li></ul>注：`1. 此功能为白名单功能，使用前请联系对应客户经理进行开通。2. 使用此功能时，FlowIds参数必传。3. 对于企业签署方，如果有签名控件，则会使用用户首次选择的签名类型签署所有含有签名控件的合同。`",
+          "document": "是否允许此链接中签署方批量确认已读文件。 <ul><li>false (默认): 不允许批量确认已读文件。</li> <li>true : 允许批量确认已读文件。</li></ul>\n注：`1. 此功能为白名单功能，使用前请联系对应客户经理进行开通。2. 使用此功能时，FlowIds参数必传。3. 对于企业签署方，如果对印章/签名控件有限制要求，需要保证所有印章/签名控件的限制要求(印章id或印章/签名类型限制)一致，否则无法使用此功能。`",
           "example": "false",
           "member": "bool",
           "name": "CanSkipReadFlow",
@@ -7126,8 +7126,8 @@
         },
         {
           "disabled": false,
-          "document": "可选的此企业允许的授权方式, 可以设置的方式有:\n<ul><li>1：上传授权书</li>\n<li>2：转法定代表人授权</li>\n<li>4：企业实名认证（信任第三方认证源）（此项有排他性, 选择后不能增添其他的方式）</li></ul>\n注:<ul>\n<li>未选择信任第三方认证源时，如果是法人进行企业激活，仅支持法人扫脸直接授权，该配置不对此法人生效`</li>\n<li>选择信任第三方认证源时，请先通过<a href=\"https://qian.tencent.com/developers/partnerApis/accounts/SyncProxyOrganization\" target=\"_blank\">同步企业信息</a>接口同步信息。</li>\n<li>该参数仅在企业未激活时生效</li>\n</ul>",
-          "example": "[1, 2, 4]",
+          "document": "可选的此企业允许的授权方式, 可以设置的方式有:\n<ul><li>1：上传授权书</li>\n<li>2：转法定代表人授权</li>\n</ul>",
+          "example": "[1, 2]",
           "member": "int64",
           "name": "AuthorizationTypes",
           "required": false,
@@ -11903,6 +11903,15 @@
           "name": "OperateType",
           "required": true,
           "type": "string"
+        },
+        {
+          "disabled": false,
+          "document": "模板名称，长度不超过64字符。<br>\n模板复制时指定有效，若为空，则复制后模板名称为 **原模板名称_副本**。",
+          "example": "入职合同",
+          "member": "string",
+          "name": "TemplateName",
+          "required": false,
+          "type": "string"
         }
       ],
       "type": "object"
@@ -11910,6 +11919,26 @@
     "OperateTemplateResponse": {
       "document": "OperateTemplate返回参数结构体",
       "members": [
+        {
+          "disabled": false,
+          "document": "模板ID，为32位字符串，模板复制新建时返回",
+          "example": "yDt3sUUckpxzhjc9UxGKGtnEys9Scr8j",
+          "member": "string",
+          "name": "TemplateId",
+          "output_required": false,
+          "type": "string",
+          "value_allowed_null": false
+        },
+        {
+          "disabled": false,
+          "document": "模板名称，模板复制新建时返回",
+          "example": "入职合同",
+          "member": "string",
+          "name": "TemplateName",
+          "output_required": false,
+          "type": "string",
+          "value_allowed_null": false
+        },
         {
           "document": "唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。",
           "member": "string",

tccli/services/goosefs/goosefs_client.py

@@ -433,6 +433,58 @@ def doCreateDataRepositoryTask(args, parsed_globals):
     FormatOutput.output("action", json_obj, g_param[OptionsDefine.Output], g_param[OptionsDefine.Filter])
 
 
+def doBuildClientNodeMountCommand(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.GoosefsClient(cred, g_param[OptionsDefine.Region], profile)
+    client._sdkVersion += ("_CLI_" + __version__)
+    models = MODELS_MAP[g_param[OptionsDefine.Version]]
+    model = models.BuildClientNodeMountCommandRequest()
+    model.from_json_string(json.dumps(args))
+    start_time = time.time()
+    while True:
+        rsp = client.BuildClientNodeMountCommand(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 doDeleteFileSystem(args, parsed_globals):
     g_param = parse_global_arg(parsed_globals)
 
@@ -1388,6 +1440,7 @@ ACTION_MAP = {
     "ModifyDataRepositoryBandwidth": doModifyDataRepositoryBandwidth,
     "BatchDeleteClientNodes": doBatchDeleteClientNodes,
     "CreateDataRepositoryTask": doCreateDataRepositoryTask,
+    "BuildClientNodeMountCommand": doBuildClientNodeMountCommand,
     "DeleteFileSystem": doDeleteFileSystem,
     "CreateFileset": doCreateFileset,
     "DeleteFileset": doDeleteFileset,

tccli/services/goosefs/v20220519/api.json

@@ -28,6 +28,13 @@
       "output": "BatchDeleteClientNodesResponse",
       "status": "online"
     },
+    "BuildClientNodeMountCommand": {
+      "document": "生成客户端的挂载命令",
+      "input": "BuildClientNodeMountCommandRequest",
+      "name": "生成客户端节点的挂载命令",
+      "output": "BuildClientNodeMountCommandResponse",
+      "status": "online"
+    },
     "CreateDataRepositoryTask": {
       "document": "创建数据流通任务,包括从将文件系统的数据上传到存储桶下, 以及从存储桶下载到文件系统里。",
       "input": "CreateDataRepositoryTaskRequest",
@@ -92,11 +99,11 @@
       "status": "online"
     },
     "DescribeClusterRoles": {
-      "document": "查询GooseFS集群角色",
+      "document": "接口废弃\n\n查询GooseFS集群角色",
       "input": "DescribeClusterRolesRequest",
       "name": "查询GooseFS集群角色",
       "output": "DescribeClusterRolesResponse",
-      "status": "online"
+      "status": "deprecated"
     },
     "DescribeDataRepositoryTaskStatus": {
       "document": "获取数据流通任务实时状态，用作客户端控制",
@@ -352,6 +359,52 @@
       ],
       "type": "object"
     },
+    "BuildClientNodeMountCommandRequest": {
+      "document": "BuildClientNodeMountCommand请求参数结构体",
+      "members": [
+        {
+          "disabled": false,
+          "document": "文件系统ID",
+          "example": "x-c60-a2b3d4",
+          "member": "string",
+          "name": "FileSystemId",
+          "required": true,
+          "type": "string"
+        },
+        {
+          "disabled": false,
+          "document": "自定义挂载目录的绝对路径, 如果未指定, 则会使用默认值, 格式/goosefsx/${fs_id}-proxy. 比如/goosefsx/x-c60-a2b3d4-proxy",
+          "example": "/train_data",
+          "member": "string",
+          "name": "CustomMountDir",
+          "required": false,
+          "type": "string"
+        }
+      ],
+      "type": "object"
+    },
+    "BuildClientNodeMountCommandResponse": {
+      "document": "BuildClientNodeMountCommand返回参数结构体",
+      "members": [
+        {
+          "disabled": false,
+          "document": "挂载命令",
+          "example": "test",
+          "member": "string",
+          "name": "Command",
+          "output_required": false,
+          "type": "string",
+          "value_allowed_null": false
+        },
+        {
+          "document": "唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。",
+          "member": "string",
+          "name": "RequestId",
+          "type": "string"
+        }
+      ],
+      "type": "object"
+    },
     "ChargeAttribute": {
       "document": "付费信息详情",
       "members": [

tccli/services/goosefs/v20220519/examples.json

@@ -32,6 +32,14 @@
         "title": "批量删除客户端节点"
       }
     ],
+    "BuildClientNodeMountCommand": [
+      {
+        "document": "获取某个文件系统的客户端挂载命令",
+        "input": "POST / HTTP/1.1\nHost: goosefs.tencentcloudapi.com\nContent-Type: application/json\nX-TC-Action: UpdateFileSystemStatus\n<公共请求参数>\n\n{\n    \"FileSystemId\": \"x-c60-a2b3d4\",\n    \"CustomMountDir\": \"/train_data\"\n}",
+        "output": "{\n    \"Response\": {\n        \"Command\": \"wget https://goosefsx-bucket-12510000.cos.ap-beijing.myqcloud.com/client_env_package/agent/install-goosefsx-client.sh；chmod +x install-goosefsx-client.sh; ./install-goosefsx-client.sh; 172.3.1.2:55533,172.3.1.3:55533,172.3.1.4:55533 /train_data\",\n        \"RequestId\": \"c579ea0b-d04f-4cc0-a6e2-fc6bad036017\"\n    }\n}",
+        "title": "获取文件系统的客户端挂载命令"
+      }
+    ],
     "CreateDataRepositoryTask": [
       {
         "document": "创建上传文件系统数据到存储桶任务",