tccli 3.0.1272.1__py2.py3-none-any.whl → 3.0.1274.1__py2.py3-none-any.whl

tccli/services/lowcode/v20210108/examples.json

@@ -1,17 +1,83 @@
 {
   "actions": {
+    "CreateKnowledgeSet": [
+      {
+        "document": "创建微搭知识库",
+        "input": "POST / HTTP/1.1\nHost: lowcode.tencentcloudapi.com\nContent-Type: application/json\nX-TC-Action: CreateKnowledgeSet\n<公共请求参数>\n\n{\n    \"Name\": \"test\",\n    \"Title\": \"testTiTle\",\n    \"Desc\": \"descd\"\n}",
+        "output": "{\n    \"Response\": {\n        \"RequestId\": \"dde48f19-e0fb-490e-bf4c-150bcf7e3c91\"\n    }\n}",
+        "title": "创建知识库"
+      }
+    ],
+    "DeleteKnowledgeDocumentSet": [
+      {
+        "document": "删除知识库下文档",
+        "input": "POST / HTTP/1.1\nHost: lowcode.tencentcloudapi.com\nContent-Type: application/json\nX-TC-Action: DeleteKnowledgeDocumentSet\n<公共请求参数>\n\n{\n    \"CollectionView\": \"gqtianTw west666\",\n    \"Query\": {\n        \"DocumentSetId\": [\n            \"124847948693739929www6\"\n        ]\n    }\n}",
+        "output": "{\n    \"Response\": {\n        \"Data\": {\n            \"AffectedCount\": 1\n        },\n        \"RequestId\": \"7365a503-7b9e-4510-9b0c-e7af0f0c06cf\"\n    }\n}",
+        "title": "删除知识库下文档"
+      }
+    ],
+    "DeleteKnowledgeSet": [
+      {
+        "document": "用于删除知识库",
+        "input": "POST / HTTP/1.1\nHost: lowcode.tencentcloudapi.com\nContent-Type: application/json\nX-TC-Action: DeleteKnowledgeSet\n<公共请求参数>\n\n{\n    \"Name\": \"test\"\n}",
+        "output": "{\n    \"Response\": {\n        \"RequestId\": \"dde48f19-e0fb-490e-bf4c-150bcf7e3c91\"\n    }\n}",
+        "title": "删除知识库"
+      }
+    ],
     "DescribeDataSourceList": [
       {
-        "document": "",
-        "input": "POST / HTTP/1.1\nHost: lowcode.tencentcloudapi.com\nContent-Type: application/json\nX-TC-Action: DescribeDataSourceList\n<公共请求参数>\n\n{\n    \"PageIndex\": 0,\n    \"PageSize\": 0,\n    \"EnvId\": \"aaa\"\n}",
-        "output": "{\n    \"Response\": {\n        \"Data\": {\n            \"Count\": 0,\n            \"Rows\": [\n                {\n                    \"IsNewDataSource\": 0,\n                    \"ChildDataSourceNames\": [\n                        \"xx\"\n                    ],\n                    \"CmsProject\": \"xx\",\n                    \"CreatorId\": \"xx\",\n                    \"AuthStatus\": 0,\n                    \"Type\": \"xx\",\n                    \"AppUsageList\": [\n                        {\n                            \"OnlineStatusUse\": 0,\n                            \"PreviewStatusUse\": 0,\n                            \"Id\": \"xx\",\n                            \"EditStatusUse\": 0,\n                            \"Title\": \"xx\"\n                        }\n                    ],\n                    \"Schema\": \"xx\",\n                    \"PkgId\": \"xx\",\n                    \"Description\": \"xx\",\n                    \"ScfStatus\": 1,\n                    \"PublishVersion\": \"xx\",\n                    \"ViewId\": \"xx\",\n                    \"Title\": \"xx\",\n                    \"PublishedAt\": \"xx\",\n                    \"TemplateCode\": \"xx\",\n                    \"DataSourceVersion\": \"xx\",\n                    \"UpdatedAt\": \"xx\",\n                    \"Configuration\": \"xx\",\n                    \"CreatedAt\": \"xx\",\n                    \"EnvId\": \"xx\",\n                    \"Name\": \"xx\",\n                    \"ChildDataSourceIds\": [\n                        \"xx\"\n                    ],\n                    \"Fun\": \"xx\",\n                    \"Methods\": \"xx\",\n                    \"SubType\": \"database\",\n                    \"Source\": 0,\n                    \"SchemaVersion\": \"xx\",\n                    \"PublishViewId\": \"xx\",\n                    \"Id\": \"xx\"\n                }\n            ]\n        },\n        \"RequestId\": \"xx\"\n    }\n}",
-        "title": "获取数据源详情列表"
-      },
+        "document": "查询数据源列表",
+        "input": "POST / HTTP/1.1\nHost: lowcode.tencentcloudapi.com\nContent-Type: application/json\nX-TC-Action: DescribeDataSourceList\n<公共请求参数>\n\n{\n    \"PageSize\": 10,\n    \"PageIndex\": 1,\n    \"EnvId\": \"lowcode-4jT6kVY\",\n    \"Appids\": [\n        \"data-4jT6kVY\"\n    ],\n    \"DataSourceIds\": [\n        \"data-4jT6kVY\"\n    ],\n    \"DataSourceNames\": [\n        \"4jT6kVY\"\n    ],\n    \"DataSourceType\": \"mysql\",\n    \"QueryOption\": {\n        \"LikeName\": \"4jT6kVY\",\n        \"LikeTitle\": \"用户\"\n    },\n    \"ViewIds\": [\n        \"4jT6kVY\"\n    ],\n    \"AppLinkStatus\": 0,\n    \"QueryBindToApp\": 0,\n    \"QueryConnector\": 0,\n    \"NotQuerySubTypeList\": [\n        \"d4jT6kVY\"\n    ],\n    \"ChannelList\": [\n        \"4jT6kVY\"\n    ],\n    \"QueryDataSourceRelationList\": true,\n    \"DbInstanceType\": \"mysql\",\n    \"DatabaseTableNames\": [\n        \"sys_user\"\n    ],\n    \"QuerySystemModel\": true\n}",
+        "output": "{\n    \"Response\": {\n        \"Data\": {\n            \"Rows\": [\n                {\n                    \"Id\": \"data-4jT6kVY\",\n                    \"Title\": \"用户\",\n                    \"Name\": \"sys_user\",\n                    \"Type\": \"database\",\n                    \"Description\": \"内置数据源\",\n                    \"Schema\": \"{\\\"x-primary-column\\\":\\\"name\\\",\\\"x-kind\\\":\\\"tcb\\\",\\\"name\\\":\\\"sys_user\\\",\\\"x-defaultMethods\\\":[\\\"wedaCreate\\\"]}\",\n                    \"CmsProject\": \"data-4jT6kVY\",\n                    \"PkgId\": \"lowcode-4jT6kVY\",\n                    \"SchemaVersion\": \"2.0\",\n                    \"CreatorId\": \"sys_user_1\",\n                    \"CreatedAt\": \"sys\",\n                    \"UpdatedAt\": \"sys\",\n                    \"EnvId\": \"lowcode-4jT6kVY\",\n                    \"DataSourceVersion\": \"data-4jT6kVY\",\n                    \"AppUsageList\": [\n                        {\n                            \"Id\": \"data-4jT6kVY\",\n                            \"Title\": \"用户\",\n                            \"EditStatusUse\": 0,\n                            \"PreviewStatusUse\": 0,\n                            \"OnlineStatusUse\": 0,\n                            \"DataSourceId\": \"data-4jT6kVY\"\n                        }\n                    ],\n                    \"PublishedAt\": \"sys\",\n                    \"ChildDataSourceIds\": [\n                        \"data-4jT6kVY\"\n                    ],\n                    \"Fun\": \"{\\\"prviewPublishAt\\\":\\\"2024-11-19T17:28:57.919+0800\\\",\\\"onlinePublishAt\\\":\\\"2024-11-19T17:28:30.989+0800\\\",\\\"previewVersion\\\":2,\\\"onlineVersion\\\":2}\",\n                    \"ScfStatus\": 1,\n                    \"Methods\": \"data-4jT6kVY\",\n                    \"ChildDataSourceNames\": [\n                        \"data-4jT6kVY\"\n                    ],\n                    \"IsNewDataSource\": 0,\n                    \"ViewId\": \"view-67vvgoe840\",\n                    \"Configuration\": \"data-4jT6kVY\",\n                    \"TemplateCode\": \"data-4jT6kVY\",\n                    \"Source\": 0,\n                    \"PublishVersion\": \"data-4jT6kVY\",\n                    \"PublishViewId\": \"data-4jT6kVY\",\n                    \"SubType\": \"data-4jT6kVY\",\n                    \"AuthStatus\": 0,\n                    \"AuthInfo\": {\n                        \"AuthUser\": \"sys\"\n                    },\n                    \"PublishStatus\": 0,\n                    \"UpdateVersion\": 0,\n                    \"RelationFieldList\": [\n                        {\n                            \"Field\": \"abcdata-4jT6kVY\",\n                            \"Format\": \"data-4jT6kVY\",\n                            \"RelateDataSourceName\": \"data-4jT6kVY\"\n                        }\n                    ],\n                    \"DbInstanceType\": \"mysql\",\n                    \"PreviewTableName\": \"sys_user_pre\",\n                    \"PublishedTableName\": \"sys_user\",\n                    \"DbSourceType\": \"mysql\"\n                }\n            ],\n            \"Count\": 1\n        },\n        \"RequestId\": \"1234_23232sdssasd\"\n    }\n}",
+        "title": "DescribeDataSourceList"
+      }
+    ],
+    "DescribeKnowledgeDocumentSetDetail": [
+      {
+        "document": "获取知识库下文档详情",
+        "input": "POST / HTTP/1.1\nHost: lowcode.tencentcloudapi.com\nContent-Type: application/json\nX-TC-Action: DescribeKnowledgeDocumentSetDetail\n<公共请求参数>\n\n{\n    \"CollectionView\": \"gqtianTest222666\",\n    \"DocumentSetId\": \"1248479222486937399296\"\n}",
+        "output": "{\n    \"Response\": {\n        \"Data\": {\n            \"Count\": 1,\n            \"DocumentSet\": {\n                \"DocumentSetId\": \"1248479222486937399296\",\n                \"FileTitle\": \"kent测试文件\",\n                \"FileMetaData\": \"{\\\"url\\\": \\\"https://ww.com\\\", \\\"total\\\": 3}\",\n                \"DocumentSetInfo\": {\n                    \"ByteLength\": 46,\n                    \"CreateTime\": \"2024-06-07 11:31:45\",\n                    \"IndexedProgress\": 100,\n                    \"IndexedStatus\": \"Ready\",\n                    \"Keywords\": \"\",\n                    \"LastUpdateTime\": \"2024-06-07 11:31:46\",\n                    \"TextLength\": 20\n                },\n                \"DocumentSetName\": \"jackzlqin.md\",\n                \"Name\": \"\",\n                \"Author\": \"\",\n                \"SplitterPreprocess\": {\n                    \"AppendKeywordsToChunk\": false,\n                    \"AppendTitleToChunk\": true\n                },\n                \"Text\": \"1. 入门微搭的技术文档\\n2. 学习微搭\",\n                \"TextPrefix\": \"1. 入门微搭的技术文档\\n2. 学习微搭......\"\n            }\n        },\n        \"RequestId\": \"b404ff44-6bc3-4f60-8185-2ff4d9be5b63\"\n    }\n}",
+        "title": "获取知识库下文档详情"
+      }
+    ],
+    "DescribeKnowledgeDocumentSetList": [
+      {
+        "document": "查询知识库下文件集合",
+        "input": "POST / HTTP/1.1\nHost: lowcode.tencentcloudapi.com\nContent-Type: application/json\nX-TC-Action: DescribeKnowledgeDocumentSetList\n<公共请求参数>\n\n{\n    \"CollectionView\": \"gqtianTest666\",\n    \"Query\": {\n        \"Limit\": 10,\n        \"Offset\": 0\n    }\n}",
+        "output": "{\n    \"Response\": {\n        \"Data\": {\n            \"Count\": 1,\n            \"DocumentSets\": [\n                {\n                    \"DocumentSetId\": \"1248479486937399296\",\n                    \"FileTitle\": \"kent测试文件\",\n                    \"FileMetaData\": \"{\\\"url\\\": \\\"https://ww.com\\\", \\\"total\\\": 3}\",\n                    \"DocumentSetInfo\": {\n                        \"ByteLength\": 46,\n                        \"CreateTime\": \"2024-06-07 11:31:45\",\n                        \"IndexedErrorMsg\": \"\",\n                        \"IndexedProgress\": 100,\n                        \"IndexedStatus\": \"Ready\",\n                        \"Keywords\": \"\",\n                        \"LastUpdateTime\": \"2024-06-07 11:31:46\",\n                        \"TextLength\": 20\n                    },\n                    \"DocumentSetName\": \"jackzlqin.md\",\n                    \"Name\": \"\",\n                    \"Author\": \"\",\n                    \"SplitterPreprocess\": {\n                        \"AppendKeywordsToChunk\": false,\n                        \"AppendTitleToChunk\": true\n                    },\n                    \"TextPrefix\": \"1. 入门微搭的技术文档\\n2. 学习微搭......\"\n                }\n            ]\n        },\n        \"RequestId\": \"2e7bdcc4-d82f-4b81-abc6-6e8b08cf1832\"\n    }\n}",
+        "title": "查询知识库下文件集合"
+      }
+    ],
+    "DescribeKnowledgeSetList": [
+      {
+        "document": "查询环境下的知识库列表",
+        "input": "POST / HTTP/1.1\nHost: lowcode.tencentcloudapi.com\nContent-Type: application/json\nX-TC-Action: DescribeKnowledgeSetList\n<公共请求参数>\n\n{\n    \"Limit\": 10\n}",
+        "output": "{\n    \"Response\": {\n        \"Data\": {\n            \"KnowledgeSets\": [\n                {\n                    \"Name\": \"test\",\n                    \"Title\": \"testTiTle\",\n                    \"Desc\": \"test\",\n                    \"Active\": \"ENABLED\",\n                    \"CreateTime\": \"2024-06-04 18:07:38\",\n                    \"UpdateTime\": \"2024-06-04 18:09:29\"\n                }\n            ],\n            \"Total\": 1\n        },\n        \"RequestId\": \"f549082e-0cff-4026-96f6-a570d9f1c22d\"\n    }\n}",
+        "title": "查询环境下的知识库列表"
+      }
+    ],
+    "SearchDocList": [
+      {
+        "document": "根据关键字搜索知识库文档",
+        "input": "POST / HTTP/1.1\nHost: lowcode.tencentcloudapi.com\nContent-Type: application/json\nX-TC-Action: SearchDocList\n<公共请求参数>\n\n{\n    \"EnvId\": \"abc\",\n    \"CollectionView\": \"abc\",\n    \"SearchKey\": \"abc\",\n    \"SearchValue\": \"abc\",\n    \"PageNo\": 1,\n    \"PageSize\": 1\n}",
+        "output": "{\n    \"Response\": {\n        \"Data\": {\n            \"DocInfos\": [\n                {\n                    \"CollectionViewName\": \"abc\",\n                    \"DocSetId\": \"123456\",\n                    \"DocSetName\": \"abc.md\",\n                    \"DocType\": \".md\",\n                    \"FileTitle\": \"abc\",\n                    \"FileMetaData\": \"{}\",\n                    \"DocDesc\": \"test\",\n                    \"FileSize\": 0\n                }\n            ],\n            \"Total\": 10\n        },\n        \"RequestId\": \"1cc82948-244f-4812-bb2a-25a8a473d312\"\n    }\n}",
+        "title": "知识库文档搜索接口"
+      }
+    ],
+    "UpdateKnowledgeSet": [
+      {
+        "document": "更新知识库状态",
+        "input": "POST / HTTP/1.1\nHost: lowcode.tencentcloudapi.com\nContent-Type: application/json\nX-TC-Action: UpdateKnowledgeSet\n<公共请求参数>\n\n{\n    \"Name\": \"test\",\n    \"Active\": \"ENABLED\"\n}",
+        "output": "{\n    \"Response\": {\n        \"RequestId\": \"dde48f19-e0fb-490e-bf4c-150bcf7e3c91\"\n    }\n}",
+        "title": "更新知识库"
+      }
+    ],
+    "UploadKnowledgeDocumentSet": [
       {
-        "document": "",
-        "input": "POST / HTTP/1.1\nHost: lowcode.tencentcloudapi.com\nContent-Type: application/json\nX-TC-Action: DescribeDataSourceList\n<公共请求参数>\n\n{\n    \"PageIndex\":\"1\",\n    \"EnvId\":\"\"123\"\",\n    \"PageSize\":\"1\"\n}",
-        "output": "{\n    \"Response\": {\n        \"Data\": {\n            \"Count\": 8,\n            \"Rows\": [\n                {\n                    \"AppUsageList\": [\n                        {\n                            \"EditStatusUse\": 0,\n                            \"Id\": \"\",\n                            \"OnlineStatusUse\": 0,\n                            \"PreviewStatusUse\": 0,\n                            \"Title\": \"\"\n                        }\n                    ],\n                    \"AuthInfo\": {\n                        \"AuthUser\": \"\"\n                    },\n                    \"AuthStatus\": 0,\n                    \"ChildDataSourceIds\": [\n                        \"\"\n                    ],\n                    \"ChildDataSourceNames\": [\n                        \"\"\n                    ],\n                    \"CmsProject\": \"0\",\n                    \"Configuration\": \"\",\n                    \"CreatedAt\": \"\",\n                    \"CreatorId\": \"\",\n                    \"DataSourceVersion\": \"\",\n                    \"Description\": \"\",\n                    \"EnvId\": \"\",\n                    \"Fun\": \"\",\n                    \"Id\": \"\",\n                    \"IsNewDataSource\": 0,\n                    \"Methods\": \"\",\n                    \"Name\": \"\",\n                    \"PkgId\": \"\",\n                    \"PublishVersion\": \"\",\n                    \"PublishViewId\": \"\",\n                    \"PublishedAt\": \"\",\n                    \"ScfStatus\": 0,\n                    \"Schema\": \"\",\n                    \"SchemaVersion\": \"\",\n                    \"Source\": 0,\n                    \"SubType\": \"\",\n                    \"TemplateCode\": \"\",\n                    \"Title\": \"\",\n                    \"Type\": \"\",\n                    \"UpdatedAt\": \"\",\n                    \"ViewId\": \"\"\n                }\n            ]\n        },\n        \"RequestId\": \"7aad9c07-97ab-4bed-8a4a-77e0c4c96e6a\"\n    }\n}",
-        "title": "成功用例"
+        "document": "上传知识库文档\n",
+        "input": "POST / HTTP/1.1\nHost: lowcode.tencentcloudapi.com\nContent-Type: application/json\nX-TC-Action: UploadKnowledgeDocumentSet\n<公共请求参数>\n\n{\n    \"EnvId\": \"lowcode-1gk9y5ik310a94df\",\n    \"CollectionView\": \"qinmyku873d0a97\",\n    \"CosUrl\": \"https://6c6f-lowcode-5g5llxbq5bc9299e-1300677802.tcb.qcloud.la/weda-uploader/5e471ea6d1891cced441b68df1022023-新手指引.md\",\n    \"FileName\": \"jackzlqin-test1.md\",\n    \"DocumentDesc\": \"test-qin-11\",\n     \"FileTitle\":\"kent测试文件\",\n    \"FileMetaData\":\"{\\\"url\\\":\\\"https://ww.com\\\",\\\"total\\\":3}\",\n    \"DocumentSetId\":\"1258635496046329856\"\n}\n\n",
+        "output": "{\n    \"Response\": {\n        \"Data\": {\n            \"DocumentSetId\": \"1248563007152455680\",\n            \"DocumentSetName\": \"jackzqlin-test.md\",\n            \"FileTitle\": \"kent测试文件\",\n            \"FileMetaData\": \"{\\\"url\\\":\\\"https://ww.com\\\",\\\"total\\\":3}\"\n        },\n        \"RequestId\": \"0f27f7a7-2d8a-456a-8de9-2e794f3f8e74\"\n    }\n}",
+        "title": "UploadKnowledgeDocumentSet"
       }
     ]
   },

tccli/services/monitor/monitor_client.py

@@ -4647,6 +4647,58 @@ def doUpdateAlertRuleState(args, parsed_globals):
     FormatOutput.output("action", json_obj, g_param[OptionsDefine.Output], g_param[OptionsDefine.Filter])
 
 
+def doGetTopNMonitorData(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.MonitorClient(cred, g_param[OptionsDefine.Region], profile)
+    client._sdkVersion += ("_CLI_" + __version__)
+    models = MODELS_MAP[g_param[OptionsDefine.Version]]
+    model = models.GetTopNMonitorDataRequest()
+    model.from_json_string(json.dumps(args))
+    start_time = time.time()
+    while True:
+        rsp = client.GetTopNMonitorData(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 doModifyPrometheusTemp(args, parsed_globals):
     g_param = parse_global_arg(parsed_globals)
 
@@ -8337,6 +8389,7 @@ ACTION_MAP = {
     "CreatePrometheusAgent": doCreatePrometheusAgent,
     "CreatePrometheusGlobalNotification": doCreatePrometheusGlobalNotification,
     "UpdateAlertRuleState": doUpdateAlertRuleState,
+    "GetTopNMonitorData": doGetTopNMonitorData,
     "ModifyPrometheusTemp": doModifyPrometheusTemp,
     "UnbindPrometheusManagedGrafana": doUnbindPrometheusManagedGrafana,
     "DescribeExporterIntegrations": doDescribeExporterIntegrations,

tccli/services/monitor/v20180724/api.json

@@ -784,6 +784,13 @@
       "output": "GetPrometheusAgentManagementCommandResponse",
       "status": "online"
     },
+    "GetTopNMonitorData": {
+      "document": "支持TopN查询，对于给定的监控指标和时间区间，按照指标大小按序返回不同维度组合及数据。",
+      "input": "GetTopNMonitorDataRequest",
+      "name": "获取TopN监控数据",
+      "output": "GetTopNMonitorDataResponse",
+      "status": "online"
+    },
     "InstallPlugins": {
       "document": "安装 Grafana Plugin",
       "input": "InstallPluginsRequest",
@@ -13931,6 +13938,137 @@
       ],
       "type": "object"
     },
+    "GetTopNMonitorDataRequest": {
+      "document": "GetTopNMonitorData请求参数结构体",
+      "members": [
+        {
+          "disabled": false,
+          "document": "topN",
+          "example": "20",
+          "member": "uint64",
+          "name": "N",
+          "required": true,
+          "type": "int"
+        },
+        {
+          "disabled": false,
+          "document": "起始时间",
+          "example": "2020-05-11T14:52:44+08:00",
+          "member": "datetime_iso",
+          "name": "StartTime",
+          "required": true,
+          "type": "string"
+        },
+        {
+          "disabled": false,
+          "document": "截止时间",
+          "example": "2020-05-11T14:52:44+08:00",
+          "member": "datetime_iso",
+          "name": "EndTime",
+          "required": true,
+          "type": "string"
+        },
+        {
+          "disabled": false,
+          "document": "实例对象的维度组合，格式为key-value键值对形式的集合。不同类型的实例字段完全不同，如CVM为[{\"Name\":\"InstanceId\",\"Value\":\"ins-j0hk02zo\"}]，Ckafka为[{\"Name\":\"instanceId\",\"Value\":\"ckafka-l49k54dd\"}]，COS为[{\"Name\":\"appid\",\"Value\":\"1258344699\"},{\"Name\":\"bucket\",\"Value\":\"rig-1258344699\"}]。各个云产品的维度请参阅各个产品监控指标文档，对应的维度列即为维度组合的key，value为key对应的值。单请求最多支持批量拉取50个实例的监控数据。",
+          "example": "[{\"Dimensions\":[{\"Name\":\"netgroup\",\"Value\":\"-1\"}]}]",
+          "member": "Instance",
+          "name": "Instances",
+          "required": true,
+          "type": "list"
+        },
+        {
+          "disabled": false,
+          "document": "指标名称，如Bwpresourcebandwidthin，仅支持单指标拉取。各个云产品的详细指标说明请参阅各个产品监控指标文档，对应的指标英文名即为MetricName",
+          "example": "Bwpresourcebandwidthin",
+          "member": "string",
+          "name": "MetricName",
+          "required": true,
+          "type": "string"
+        },
+        {
+          "disabled": false,
+          "document": "命名空间，如QCE/CVM。各个云产品的详细命名空间说明请参阅各个产品监控指标文档",
+          "example": "QCE/BWP",
+          "member": "string",
+          "name": "Namespace",
+          "required": true,
+          "type": "string"
+        },
+        {
+          "disabled": false,
+          "document": "监控统计周期，如60。默认为取值为60，单位为s。每个指标支持的统计周期不一定相同，各个云产品支持的统计周期请参阅各个产品监控指标文档，对应的统计周期列即为支持的统计周期。",
+          "example": "60",
+          "member": "uint64",
+          "name": "Period",
+          "required": false,
+          "type": "int"
+        }
+      ],
+      "type": "object"
+    },
+    "GetTopNMonitorDataResponse": {
+      "document": "GetTopNMonitorData返回参数结构体",
+      "members": [
+        {
+          "disabled": false,
+          "document": "指标名\t",
+          "example": "Bwpresourcebandwidthin",
+          "member": "string",
+          "name": "MetricName",
+          "output_required": true,
+          "type": "string",
+          "value_allowed_null": false
+        },
+        {
+          "disabled": false,
+          "document": "统计周期\t",
+          "example": "60",
+          "member": "uint64",
+          "name": "Period",
+          "output_required": true,
+          "type": "int",
+          "value_allowed_null": false
+        },
+        {
+          "disabled": false,
+          "document": "topN",
+          "example": "无",
+          "member": "uint64",
+          "name": "N",
+          "output_required": true,
+          "type": "int",
+          "value_allowed_null": false
+        },
+        {
+          "disabled": false,
+          "document": "排序的监控数据\t",
+          "example": "无",
+          "member": "SingleOrderedDataPoint",
+          "name": "OrderedDataPoints",
+          "output_required": true,
+          "type": "list",
+          "value_allowed_null": false
+        },
+        {
+          "disabled": false,
+          "document": "返回信息",
+          "example": "无",
+          "member": "string",
+          "name": "Msg",
+          "output_required": true,
+          "type": "string",
+          "value_allowed_null": false
+        },
+        {
+          "document": "唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。",
+          "member": "string",
+          "name": "RequestId",
+          "type": "string"
+        }
+      ],
+      "type": "object"
+    },
     "GrafanaAccountInfo": {
       "document": "Grafana可视化服务 授权账户信息",
       "members": [
@@ -14605,7 +14743,7 @@
         {
           "disabled": false,
           "document": "内容",
-          "example": "{\\\"name\\\":\\\"test\\\",\\\"kind\\\":\\\"blackbox-exporter\\\",\\\"spec\\\":{\\\"in",
+          "example": "{\"name\":\"test\",\"kind\":\"blackbox-exporter\",\"spec\":{\"scrapeSpec\":{\"interval\":\"15s\"},\"instanceSpec\":{\"module\":\"http_get\",\"urls\":[\"http://test.com\"]},\"exporterSpec\":{}}}",
           "member": "string",
           "name": "Content",
           "output_required": true,
@@ -19882,6 +20020,56 @@
       ],
       "type": "object"
     },
+    "SingleOrderedDataPoint": {
+      "document": "单个有序数据点",
+      "members": [
+        {
+          "disabled": false,
+          "document": "实例对象维度组合\t\n注意：此字段可能返回 null，表示取不到有效值。",
+          "example": "无",
+          "member": "Dimension",
+          "name": "Dimensions",
+          "output_required": true,
+          "required": false,
+          "type": "list",
+          "value_allowed_null": true
+        },
+        {
+          "disabled": false,
+          "document": "监控数据值\n注意：此字段可能返回 null，表示取不到有效值。",
+          "example": "无",
+          "member": "float",
+          "name": "Value",
+          "output_required": true,
+          "required": false,
+          "type": "float",
+          "value_allowed_null": true
+        },
+        {
+          "disabled": false,
+          "document": "监控数据时间戳\n注意：此字段可能返回 null，表示取不到有效值。",
+          "example": "无",
+          "member": "uint64",
+          "name": "Timestamp",
+          "output_required": true,
+          "required": false,
+          "type": "int",
+          "value_allowed_null": true
+        },
+        {
+          "disabled": false,
+          "document": "排序序号\n注意：此字段可能返回 null，表示取不到有效值。",
+          "example": "无",
+          "member": "uint64",
+          "name": "Order",
+          "output_required": true,
+          "required": false,
+          "type": "int",
+          "value_allowed_null": true
+        }
+      ],
+      "usage": "both"
+    },
     "SyncPrometheusTempRequest": {
       "document": "SyncPrometheusTemp请求参数结构体",
       "members": [

tccli/services/monitor/v20180724/examples.json

@@ -1076,6 +1076,14 @@
         "title": "获取 Prometheus Agent 管理相关的命令行"
       }
     ],
+    "GetTopNMonitorData": [
+      {
+        "document": "根据某个netgroup实例，查看一段时间范围内带宽Top5的u_id数据。",
+        "input": "POST / HTTP/1.1\nHost: monitor.tencentcloudapi.com\nContent-Type: application/json\nX-TC-Action: GetTopNMonitorData\n<公共请求参数>\n\n{\n    \"Namespace\": \"QCE/BWP\",\n    \"MetricName\": \"Bwpresourcebandwidthin\",\n    \"Period\": 60,\n    \"StartTime\": \"2024-09-05T00:27:00+08:00\",\n    \"EndTime\": \"2024-09-05T23:27:00+08:00\",\n    \"N\": 5,\n    \"Instances\": [\n        {\n            \"Dimensions\": [\n                {\n                    \"Name\": \"netgroup\",\n                    \"Value\": \"-1\"\n                }\n            ]\n        }\n    ]\n}",
+        "output": "{\n    \"Response\": {\n        \"MetricName\": \"Bwpresourcebandwidthin\",\n        \"Period\": 60,\n        \"N\": 5,\n        \"OrderedDataPoints\": [\n            {\n                \"Dimensions\": [\n                    {\n                        \"Name\": \"appid\",\n                        \"Value\": \"251236571\"\n                    },\n                    {\n                        \"Name\": \"netgroup\",\n                        \"Value\": \"-1\"\n                    },\n                    {\n                        \"Name\": \"u_id\",\n                        \"Value\": \"eip-3xq5lcpb\"\n                    }\n                ],\n                \"Timestamp\": 1725496200,\n                \"Value\": 19411.2,\n                \"Order\": 1\n            },\n            {\n                \"Dimensions\": [\n                    {\n                        \"Name\": \"u_id\",\n                        \"Value\": \"eip-bhhl5d0l\"\n                    },\n                    {\n                        \"Name\": \"appid\",\n                        \"Value\": \"251236571\"\n                    },\n                    {\n                        \"Name\": \"netgroup\",\n                        \"Value\": \"-1\"\n                    }\n                ],\n                \"Timestamp\": 1725495840,\n                \"Value\": 2224,\n                \"Order\": 2\n            },\n            {\n                \"Dimensions\": [\n                    {\n                        \"Name\": \"appid\",\n                        \"Value\": \"251236571\"\n                    },\n                    {\n                        \"Name\": \"netgroup\",\n                        \"Value\": \"-1\"\n                    },\n                    {\n                        \"Name\": \"u_id\",\n                        \"Value\": \"eip-7mg0n41b\"\n                    }\n                ],\n                \"Timestamp\": 1725496200,\n                \"Value\": 2088,\n                \"Order\": 3\n            },\n            {\n                \"Dimensions\": [\n                    {\n                        \"Name\": \"netgroup\",\n                        \"Value\": \"-1\"\n                    },\n                    {\n                        \"Name\": \"u_id\",\n                        \"Value\": \"eip-r2n5fxfr\"\n                    },\n                    {\n                        \"Name\": \"appid\",\n                        \"Value\": \"251195348\"\n                    }\n                ],\n                \"Timestamp\": 1725495840,\n                \"Value\": 1759.2,\n                \"Order\": 4\n            },\n            {\n                \"Dimensions\": [\n                    {\n                        \"Name\": \"netgroup\",\n                        \"Value\": \"-1\"\n                    },\n                    {\n                        \"Name\": \"u_id\",\n                        \"Value\": \"eip-bl7z49yd\"\n                    },\n                    {\n                        \"Name\": \"appid\",\n                        \"Value\": \"251236571\"\n                    }\n                ],\n                \"Timestamp\": 1725496140,\n                \"Value\": 1568,\n                \"Order\": 5\n            }\n        ],\n        \"RequestId\": \"yql-qqqqqqqqq\",\n        \"Msg\": \"Success\"\n    }\n}",
+        "title": "拉取BWP带宽Top5的监控数据"
+      }
+    ],
     "InstallPlugins": [
       {
         "document": "",