調(diào)用ListTagResources接口查詢對等連接已經(jīng)綁定的標(biāo)簽列表。
接口說明
- 請求中至少指定參數(shù)ResourceId.N或Tag.N(Tag.N.Key與Tag.N.Value),以確定檢索對象。
- Tag.N是資源的標(biāo)簽,由一個(gè)鍵值對組成。僅指定Tag.N.Key時(shí),則返回該標(biāo)簽鍵關(guān)聯(lián)的所有標(biāo)簽值。僅指定Tag.N.Value會(huì)報(bào)錯(cuò)。
- 如果您同時(shí)指定Tag.N和ResourceId.N篩選標(biāo)簽,則ResourceId.N必須滿足所有輸入的標(biāo)簽鍵值對。
- 如果您同時(shí)指定多個(gè)標(biāo)簽鍵值對,返回結(jié)果為同時(shí)包含被指定的多個(gè)鍵值對的資源。
調(diào)試
您可以在OpenAPI Explorer中直接運(yùn)行該接口,免去您計(jì)算簽名的困擾。運(yùn)行成功后,OpenAPI Explorer可以自動(dòng)生成SDK代碼示例。
授權(quán)信息
請求參數(shù)
名稱 | 類型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
ResourceType | string | 是 | 資源類型。取值:PeerConnection,VPC 對等連接。 | PeerConnection |
ResourceIddeprecated | array | 否 | 資源 ID。最多支持 20 個(gè)資源 ID。 | |
string | 否 | 資源 ID。最多支持輸入 20 個(gè)資源 ID。 說明
參數(shù)ResourceId.N或Tag.N(Tag.N.Key與Tag.N.Value)至少輸入一個(gè)。
| pcc-bp16qjewdsunr41m1**** | |
Tagdeprecated | object [] | 否 | 標(biāo)簽信息。 | |
Key | string | 否 | 資源的標(biāo)簽鍵。最多支持 20 個(gè)標(biāo)簽鍵。一旦傳入該值,則不允許為空字符串。 一個(gè)標(biāo)簽鍵最多支持 128 個(gè)字符,不能以 說明
參數(shù)ResourceId.N或Tag.N(Tag.N.Key與Tag.N.Value)至少輸入一個(gè)。
| FinanceDept |
Value | string | 否 | 資源的標(biāo)簽值。最多支持 20 個(gè)標(biāo)簽值。一旦傳入該值,可以為空字符串。 一個(gè)標(biāo)簽值最多支持 128 個(gè)字符,不能以 說明
參數(shù)ResourceId.N或Tag.N(Tag.N.Key與Tag.N.Value)至少輸入一個(gè)。
| FinanceJoshua |
MaxResults | integer | 否 | 分批次查詢時(shí)每次顯示的條目數(shù)。取值范圍:1~50,默認(rèn)值:50。 | 50 |
NextToken | string | 否 | 是否擁有下一次查詢的令牌(Token)。取值:
| FFmyTO70tTpLG6I3FmYAXGKPd**** |
RegionId | string | 是 | 資源所屬的地域 ID。 您可以通過調(diào)用 DescribeRegions 接口獲取地域 ID。 | cn-hangzhou |
返回參數(shù)
示例
正常返回示例
JSON
格式
{
"RequestId": "DE65F6B7-7566-4802-9007-96F2494AC512",
"TagResources": [
{
"ResourceId": "pcc-bp16qjewdsunr41m1****",
"ResourceType": "PeerConnection",
"RegionNo": "cn-hangzhou",
"TagKey": "FinanceDept",
"TagValue": "FinanceJoshua"
}
],
"NextToken": "FFmyTO70tTpLG6I3FmYAXGKPd****",
"MaxResults": 50
}
錯(cuò)誤碼
HTTP status code | 錯(cuò)誤碼 | 錯(cuò)誤信息 | 描述 |
---|---|---|---|
400 | InvalidTagKey | The tag keys are not valid. | 無效的標(biāo)簽索引 |
400 | NumberExceed.Tags | The maximum number of tags is exceeded. | 標(biāo)簽數(shù)量超限 |
400 | NumberExceed.ResourceIds | The maximum number of resource IDs is exceeded. | 資源組ID數(shù)目超限 |
400 | Forbidden.TagKeys | The tag key cannot be operated by the request. | 該請求不允許操作此 tagkey |
400 | Forbidden.TagKey.Duplicated | The specified tag key already exists. | 標(biāo)簽資源重復(fù) |
400 | InvalidInstanceIds.NotFound | The instance IDs are not found. | 實(shí)例ID沒有找到 |
400 | InvalidInstanceType.NotFound | The instance type is not found. | 實(shí)例類型沒有找到 |
400 | BothEmpty.TagsAndResources | The specified Tags and ResourcesIds are not allow to both empty. | 標(biāo)簽和資源信息不能同時(shí)為空。 |
訪問錯(cuò)誤中心查看更多錯(cuò)誤碼。
變更歷史
變更時(shí)間 | 變更內(nèi)容概要 | 操作 | ||||||
---|---|---|---|---|---|---|---|---|
2023-12-08 | OpenAPI 描述信息更新、OpenAPI 錯(cuò)誤碼發(fā)生變更 | 看變更集 | ||||||
| ||||||||
2023-07-25 | OpenAPI 錯(cuò)誤碼發(fā)生變更 | 看變更集 | ||||||
|