使用DescribeGroupedTags查詢資產標籤的統計資訊-Security Center-阿里雲 - Security Center

調試

您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

操作：是指具體的許可權點。
存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。
資源類型：是指操作中支援授權的資源類型。具體說明如下：
- 對於必選的資源類型，用前面加 * 表示。
- 對於不支援資源級授權的操作，用全部資源表示。
條件關鍵字：是指雲產品自身定義的條件關鍵字。
關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

yundun-sas:DescribeGroupedTags

get

*All Resource

*

無

請求參數

名稱	類型	必填	描述	樣本值
MachineTypes	string	否	指定要查詢的資產類型。不指定資產類型時，預設查詢所有資產類型下的標籤資訊。取值： ecs：伺服器 cloud_product：雲端產品。	ecs

返回參數

名稱	類型	描述	樣本值
	object
HttpStatusCode	integer	請求資料結果的 HTTP 狀態碼。	200
RequestId	string	本次呼叫請求的 ID，是由阿里雲為該請求生成的唯一識別碼，可用於排查和定位問題。	151F6EB6-D5F3-417A-AF7B-4D84975DB586
Success	boolean	資料請求是否成功。取值： true：請求成功 false：請求失敗。	true
Count	integer	該參數已廢棄，無需關注。	0
GroupedFileds	array<object>	資產標籤的統計資訊。
	object
Name	string	標籤名稱。	InternetIp
Count	string	標籤對應的資產數量。	152
TagId	integer	標籤 ID。	3252366

樣本

正常返回樣本

JSON格式

{
  "HttpStatusCode": 200,
  "RequestId": "151F6EB6-D5F3-417A-AF7B-4D84975DB586",
  "Success": true,
  "Count": 0,
  "GroupedFileds": [
    {
      "Name": "InternetIp",
      "Count": "152",
      "TagId": 3252366
    }
  ]
}

錯誤碼

HTTP status code	錯誤碼	錯誤資訊
400	NoPermission	no permission
500	ServerError	ServerError
403	NoPermission	caller has no permission

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊，參考變更詳情。