tccli 3.0.909.1__py2.py3-none-any.whl → 3.0.910.1__py2.py3-none-any.whl

tccli/services/wedata/v20210820/examples.json

@@ -448,6 +448,14 @@
         "title": "获取集群命名空间列表"
       }
     ],
+    "DescribeColumnLineage": [
+      {
+        "document": "列出表血缘信息",
+        "input": "POST / HTTP/1.1\nHost: wedata.tencentcloudapi.com\nContent-Type: application/json\nX-TC-Action: DescribeColumnLineage\n<公共请求参数>\n\n{\n    \"Direction\": \"xx\",\n    \"InputDepth\": 0,\n    \"ExtParams\": [\n        {\n            \"Name\": \"xx\",\n            \"Value\": \"xx\"\n        }\n    ],\n    \"OutputDepth\": 0,\n    \"IgnoreTemp\": true,\n    \"Data\": {\n        \"ParentId\": \"xx\",\n        \"Params\": \"xx\",\n        \"MetastoreType\": \"xx\",\n        \"RelationParams\": \"xx\",\n        \"QualifiedName\": \"xx\",\n        \"Description\": \"xx\",\n        \"TableName\": \"xx\",\n        \"ColumnNameCn\": \"xx\",\n        \"ParentSet\": \"xx\",\n        \"ChildSet\": \"xx\",\n        \"ColumnType\": \"xx\",\n        \"UpStreamCount\": 0,\n        \"PrefixPath\": \"xx\",\n        \"DatasourceId\": \"xx\",\n        \"ModifyTime\": \"xx\",\n        \"MetastoreTypeName\": \"xx\",\n        \"Tasks\": [\n            \"xx\"\n        ],\n        \"DownStreamCount\": 0,\n        \"ExtParams\": [\n            {\n                \"Name\": \"xx\",\n                \"Value\": \"xx\"\n            }\n        ],\n        \"Id\": \"xx\",\n        \"ColumnName\": \"xx\",\n        \"TableId\": \"xx\",\n        \"CreateTime\": \"xx\"\n    }\n}",
+        "output": "{\n    \"Response\": {\n        \"RequestId\": \"xx\",\n        \"ColumnAggregationLineage\": {\n            \"ChildSet\": \"xx\",\n            \"ParentSet\": \"xx\",\n            \"ParentId\": \"xx\",\n            \"TableName\": \"xx\",\n            \"MetastoreType\": \"xx\",\n            \"ColumnInfoSet\": [\n                {\n                    \"QualifiedName\": \"xx\",\n                    \"Tasks\": [\n                        \"xx\"\n                    ],\n                    \"ColumnType\": \"xx\",\n                    \"Description\": \"xx\",\n                    \"DownStreamCount\": 0,\n                    \"UpStreamCount\": 0,\n                    \"CreateTime\": \"xx\",\n                    \"ColumnName\": \"xx\",\n                    \"PrefixPath\": \"xx\",\n                    \"Params\": \"xx\",\n                    \"ModifyTime\": \"xx\",\n                    \"RelationParams\": \"xx\",\n                    \"ColumnNameCn\": \"xx\",\n                    \"Id\": \"xx\",\n                    \"DatasourceId\": \"xx\"\n                }\n            ]\n        }\n    }\n}",
+        "title": "列出表血缘信息"
+      }
+    ],
     "DescribeDataBases": [
       {
         "document": "",
@@ -1080,6 +1088,14 @@
         "title": "获取数据表信息"
       }
     ],
+    "DescribeTableLineage": [
+      {
+        "document": "列出表血缘信息",
+        "input": "POST / HTTP/1.1\nHost: wedata.tencentcloudapi.com\nContent-Type: application/json\nX-TC-Action: DescribeTableLineage\n<公共请求参数>\n\n{\n    \"Direction\": \"xx\",\n    \"InputDepth\": 0,\n    \"ExtParams\": [\n        {\n            \"Name\": \"xx\",\n            \"Value\": \"xx\"\n        }\n    ],\n    \"OutputDepth\": 0,\n    \"IgnoreTemp\": true,\n    \"Data\": {\n        \"ChildSet\": \"xx\",\n        \"Tasks\": [\n            \"xx\"\n        ],\n        \"Description\": \"xx\",\n        \"DownStreamCount\": 0,\n        \"ProjectId\": \"xx\",\n        \"ExtParams\": [\n            {\n                \"Name\": \"xx\",\n                \"Value\": \"xx\"\n            }\n        ],\n        \"MetastoreType\": \"xx\",\n        \"TableName\": \"xx\",\n        \"QualifiedName\": \"xx\",\n        \"CreateTime\": \"xx\",\n        \"UpStreamCount\": 0,\n        \"PrefixPath\": \"xx\",\n        \"Params\": [\n            {\n                \"Name\": \"xx\",\n                \"Value\": \"xx\"\n            }\n        ],\n        \"DatasourceId\": \"xx\",\n        \"ModifyTime\": \"xx\",\n        \"TableId\": \"xx\",\n        \"ParentSet\": \"xx\",\n        \"Id\": \"xx\",\n        \"MetastoreTypeName\": \"xx\"\n    }\n}",
+        "output": "{\n    \"Response\": {\n        \"RequestId\": \"xx\",\n        \"TableLineage\": {\n            \"ChildSet\": \"xx\",\n            \"Tasks\": [\n                \"xx\"\n            ],\n            \"Description\": \"xx\",\n            \"DownStreamCount\": 0,\n            \"ProjectId\": \"xx\",\n            \"ExtParams\": [\n                {\n                    \"Name\": \"xx\",\n                    \"Value\": \"xx\"\n                }\n            ],\n            \"MetastoreType\": \"xx\",\n            \"TableName\": \"xx\",\n            \"QualifiedName\": \"xx\",\n            \"CreateTime\": \"xx\",\n            \"UpStreamCount\": 0,\n            \"PrefixPath\": \"xx\",\n            \"Params\": [\n                {\n                    \"Name\": \"xx\",\n                    \"Value\": \"xx\"\n                }\n            ],\n            \"DatasourceId\": \"xx\",\n            \"ModifyTime\": \"xx\",\n            \"TableId\": \"xx\",\n            \"ParentSet\": \"xx\",\n            \"Id\": \"xx\",\n            \"MetastoreTypeName\": \"xx\"\n        }\n    }\n}",
+        "title": "列出表血缘信息"
+      }
+    ],
     "DescribeTableQualityDetails": [
       {
         "document": "分页查询表数据质量详情",

tccli/services/wedata/wedata_client.py

@@ -7037,6 +7037,58 @@ def doBatchStopIntegrationTasks(args, parsed_globals):
     FormatOutput.output("action", json_obj, g_param[OptionsDefine.Output], g_param[OptionsDefine.Filter])
 
 
+def doDescribeTableLineage(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('-', '_')]
+        )
+    elif os.getenv(OptionsDefine.ENV_TKE_REGION)             and os.getenv(OptionsDefine.ENV_TKE_PROVIDER_ID)             and os.getenv(OptionsDefine.ENV_TKE_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.WedataClient(cred, g_param[OptionsDefine.Region], profile)
+    client._sdkVersion += ("_CLI_" + __version__)
+    models = MODELS_MAP[g_param[OptionsDefine.Version]]
+    model = models.DescribeTableLineageRequest()
+    model.from_json_string(json.dumps(args))
+    start_time = time.time()
+    while True:
+        rsp = client.DescribeTableLineage(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 doDescribeRuleExecExportResult(args, parsed_globals):
     g_param = parse_global_arg(parsed_globals)
 
@@ -7453,6 +7505,58 @@ def doModifyTaskScript(args, parsed_globals):
     FormatOutput.output("action", json_obj, g_param[OptionsDefine.Output], g_param[OptionsDefine.Filter])
 
 
+def doDescribeColumnLineage(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('-', '_')]
+        )
+    elif os.getenv(OptionsDefine.ENV_TKE_REGION)             and os.getenv(OptionsDefine.ENV_TKE_PROVIDER_ID)             and os.getenv(OptionsDefine.ENV_TKE_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.WedataClient(cred, g_param[OptionsDefine.Region], profile)
+    client._sdkVersion += ("_CLI_" + __version__)
+    models = MODELS_MAP[g_param[OptionsDefine.Version]]
+    model = models.DescribeColumnLineageRequest()
+    model.from_json_string(json.dumps(args))
+    start_time = time.time()
+    while True:
+        rsp = client.DescribeColumnLineage(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 doDescribeTableInfoList(args, parsed_globals):
     g_param = parse_global_arg(parsed_globals)
 
@@ -10459,6 +10563,7 @@ ACTION_MAP = {
     "DescribeExecStrategy": doDescribeExecStrategy,
     "CreateWorkflow": doCreateWorkflow,
     "BatchStopIntegrationTasks": doBatchStopIntegrationTasks,
+    "DescribeTableLineage": doDescribeTableLineage,
     "DescribeRuleExecExportResult": doDescribeRuleExecExportResult,
     "DescribeRules": doDescribeRules,
     "StartIntegrationTask": doStartIntegrationTask,
@@ -10467,6 +10572,7 @@ ACTION_MAP = {
     "BatchDeleteIntegrationTasks": doBatchDeleteIntegrationTasks,
     "DescribeIntegrationTasks": doDescribeIntegrationTasks,
     "ModifyTaskScript": doModifyTaskScript,
+    "DescribeColumnLineage": doDescribeColumnLineage,
     "DescribeTableInfoList": doDescribeTableInfoList,
     "ModifyRuleTemplate": doModifyRuleTemplate,
     "DescribeTaskInstances": doDescribeTaskInstances,

{tccli-3.0.909.1.dist-info → tccli-3.0.910.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: tccli
-Version: 3.0.909.1
+Version: 3.0.910.1
 Summary: Universal Command Line Environment for Tencent Cloud
 Project-URL: Bug Tracker, https://github.com/TencentCloud/tencentcloud-cli/issues
 Project-URL: Homepage, https://github.com/TencentCloud/tencentcloud-cli
@@ -13,7 +13,7 @@ Classifier: Programming Language :: Python :: 2.7
 Classifier: Programming Language :: Python :: 3
 Requires-Dist: jmespath==0.10.0
 Requires-Dist: six==1.16.0
-Requires-Dist: tencentcloud-sdk-python>=3.0.909
+Requires-Dist: tencentcloud-sdk-python>=3.0.910
 Description-Content-Type: text/markdown
 
 # 命令行工具简介
@@ -148,6 +148,86 @@ set  http_proxy=https://myproxy.com:1111
 tccli cvm DescribeRegions --https-proxy https://192.168.1.1:1111
 ```
 
+# 凭证管理
+
+腾讯云命令行工具（TCCLI）目前支持以下几种方式进行凭证管理，获取凭证的优先级：实例角色 > 角色 > TKE OIDC > 临时密钥 > 永久密钥：
+
+1. 实例角色
+
+有关实例角色的相关概念请参阅：[腾讯云实例角色](https://cloud.tencent.com/document/product/213/47668)
+
+在您为实例绑定角色后，您可以在实例中访问相关元数据接口获取临时凭证，SDK 会自动刷新临时凭证。相关命令如下：
+
+使用方式：
+- 命令行输入
+```bash
+tccli cvm DescribeRegions --use-cvm-role
+```
+
+2. 角色
+
+有关角色的相关概念请参阅：[腾讯云角色概述](https://cloud.tencent.com/document/product/598/19420)
+
+要使用此种方式，您必须在腾讯云访问管理控制台上创建了一个角色，具体创建过程请参阅：[腾讯云角色创建](https://cloud.tencent.com/document/product/598/19381)
+
+在您拥有角色后，可以通过如下方式获取临时凭证，相关命令如下：
+
+- 命令行输入
+
+```bash
+tccli cvm DescribeRegions --secretId xx --secretKey xx --role-arn xx --role-session-name
+```
+
+- 环境变量
+
+配置环境变量：`TENCENTCLOUD_SECRET_ID`, `TENCENTCLOUD_SECRET_KEY`, `TENCENTCLOUD_ROLE_ARN`, `TENCENTCLOUD_ROLE_SESSION_NAME`
+
+3. TKE OIDC
+
+- 环境变量
+  配置环境变量：`TKE_REGION`, `TKE_PROVIDER_ID`, `TKE_IDENTITY_TOKEN_FILE`, `TKE_ROLE_ARN`
+
+4. 临时密钥
+
+- 命令行输入
+```bash
+tccli cvm DescribeRegions --secretId xx --secretKey xx --token xx
+```
+
+
+- 环境变量
+  配置环境变量：`TENCENTCLOUD_SECRET_ID`, `TENCENTCLOUD_SECRET_KEY`, `TENCENTCLOUD_TOKEN`
+
+
+- xxx.credential文件
+```json
+{
+  "secretId": "AKIDxxxxxxxxxxxxxxxxxxxxQsPk",
+  "secretKey": "QgoxxxxxxxxxxxxxxxxgvW4",
+  "token": "xxxxxxxxxxxxxxxxxx"
+}
+```
+
+
+5. 永久密钥
+
+- 命令行输入
+```bash
+tccli cvm DescribeRegions --secretId xx --secretKey xx
+```
+
+
+- 环境变量
+  配置环境变量：`TENCENTCLOUD_SECRET_ID`, `TENCENTCLOUD_SECRET_KEY`
+
+
+- xxx.credential文件
+```json
+{
+  "secretId": "AKIDxxxxxxxxxxxxxxxxxxxxQsPk",
+  "secretKey": "QgoxxxxxxxxxxxxxxxxgvW4"
+}
+```
 
 # 使用TCCLI
 命令行工具集成了腾讯云所有支持云 API 的产品，可以在命令行下完成对腾讯云产品的配置和管理。包括使用TCCLI创建云服务器，操作云服务器，通过TCCLI创建CBS盘、查看CBS盘使用情况，通过TCCLI创建VPC网络、往VPC网络中添加资源等等，所有在控制台页面能完成的操作，均能再命令行工具上执行命令实现。
@@ -321,4 +401,3 @@ tccli cvm DescribeInstancesStatus --region ap-hongkong --waiter "{'expr':'Instan
     "InstanceIdSet": null
 }
 ```
-