查詢一個或多個EAIS資源已經(jīng)綁定的標簽列表。
接口說明
請求中至少指定以下任一參數(shù)，以確定查詢對象。
- ResourceId.N
- Tag.N（Tag.N.Key 與 Tag.N.Value）
同時指定 Tag.N 和 ResourceId.N 參數(shù)時，返回結(jié)果中僅包含同時滿足這兩個條件的 EAIS 資源。
調(diào)試
您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。
授權(quán)信息
當前API暫無授權(quán)信息透出。
請求參數(shù)
| 名稱 | 類型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| RegionId | string | 是 | 資源所屬的地域 ID。您可以調(diào)用 DescribeRegions 查看最新的阿里云地域列表。 | cn-hangzhou |
| NextToken | string | 否 | 下一個查詢開始 Token。 | caeba0bbb2be03f84eb48b699f0a4884 |
| ResourceType | string | 是 | 資源類型定義。目前取值僅支持 | instance |
| ResourceId | array | 否 | 資源 ID，最多 50 個子項。 | |
| string | 否 | 資源 ID。 | eais-hzs4h26yyt5xkcke**** | |
| Tag | array<object> | 否 | 標簽列表，最多包含 20 個子項。 | |
| object | 否 | 標簽對象。 | ||
| Key | string | 否 | 標簽鍵。限制：
| TestKey |
| Value | string | 否 | 標簽值。限制：
| TestValue |
返回參數(shù)
示例
正常返回示例
JSON格式
{
"RequestId": "F23AEEC7-4D98-4657-A104-02692701****",
"NextToken": "caeba0bbb2be03f84eb48b699f0a4885",
"TagResources": [
{
"TagKey": "TestKey",
"TagValue": "TestValue",
"ResourceId": "eais-hzs4h26yyt5xkcke****",
"ResourceType": "instance"
}
]
}錯誤碼
| HTTP status code | 錯誤碼 | 錯誤信息 | 描述 |
|---|---|---|---|
| 400 | MissingParameter.ResourceIdOrTag | Either ResourceId or Tag must be specified. | ResourceId和Tag至少有一個必填。 |
| 400 | InvalidNextToken | The NextToken is invalid. | NextToken參數(shù)非法。 |
| 400 | NumberExceed.ResourceIds | The maximum number of ResourceIds is exceeded. The maximum is 50. | 傳入的資源ID數(shù)量達到上限，最多支持50個。 |
| 400 | MissingParameter.ResourceIds | You must specify ResourceIds. | ResourceId不能為空。 |
| 400 | Duplicate.ResourceId | The request contains duplicated ResourceId. | ResourceId不能重復(fù)。 |
| 400 | NumberExceed.Tags | The maximum number of Tags is exceeded. The maximum is 20. | 傳入的Tag數(shù)量達到上限，最多支持20個。 |
| 400 | Duplicate.TagKey | The Tag.N.Key contains a duplicated key. | 傳入的TagKey重復(fù)。 |
| 400 | InvalidResourceId.NotFound | The ResourceId does not exist. | ResourceId不存在。 |
| 400 | InvalidParameter.TagKey | The specified Tag.n.Key is invalid. | TagKey為非法值。 |
| 400 | InvalidParameter.TagValue | The specified Tag.n.Value is invalid. | TagValue為非法值。 |
訪問錯誤中心查看更多錯誤碼。