ListTagResourcesForExpressConnect - 查詢Express Connect已經綁定的標籤列表
調用ListTagResourcesForExpressConnect介面查詢Express Connect已經綁定的標籤列表。
介面說明
-
如您需要確認檢索對象,請求參數中需指定參數ResourceId.N或Tag.N(Tag.N.Key與Tag.N.Value)。
-
Tag.N是資源的標籤,由一個索引值對組成。僅指定Tag.N.Key時,則返回該標籤鍵關聯的所有標籤值。僅指定Tag.N.Value會報錯。
-
如果您同時指定Tag.N和ResourceId.N篩選標籤,則ResourceId.N必須滿足所有輸入的標籤索引值對。
-
如果您同時指定多個標籤索引值對,返回結果為同時包含被指定的多個索引值對的資源。
調試
您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。
調試
授權資訊
請求參數
|
名稱 |
類型 |
必填 |
描述 |
樣本值 |
| ResourceType |
string |
是 |
資源類型。取值:
|
PHYSICALCONNECTION |
| RegionId |
string |
是 |
資源所屬的地區 ID。 您可以通過調用 DescribeRegions 介面擷取地區 ID。 |
cn-hangzhou |
| NextToken |
string |
否 |
是否擁有下一次查詢的令牌(Token)。取值:
|
FFmyTO70tTpLG6I3FmYAXGKPd**** |
| MaxResults |
integer |
否 |
分批次查詢時每次顯示的條目數。取值範圍:1~100,預設值為 20。 |
20 |
| ResourceId |
array |
否 |
資源 ID 列表。 |
|
|
string |
否 |
資源 ID。最多支援輸入 20 個資源 ID。 |
pc-bp16qjewdsunr41m1**** |
|
| Tag |
array<object> |
否 |
標籤列表。 |
|
|
object |
否 |
標籤列表。 |
||
| Key |
string |
否 |
資源的標籤鍵。最多支援輸入 20 個標籤鍵。如果傳入該值,則不能輸入Null 字元串。 最多支援 128 個字元,不能以 |
FinanceDept |
| Value |
string |
否 |
資源的標籤值。最多支援輸入 20 個標籤值。如需傳入該值,可以輸入Null 字元串。 最多支援 128 個字元,不能以 |
FinanceJoshua |
返回參數
|
名稱 |
類型 |
描述 |
樣本值 |
|
object |
|||
| NextToken |
string |
是否擁有下一次查詢的令牌(Token)。取值:
|
FFmyTO70tTpLG6I3FmYAXGKPd**** |
| RequestId |
string |
請求 ID。 |
54B48E3D-DF70-471B-AA93-08E683A1B45 |
| TagResources |
object |
||
| TagResource |
array<object> |
標籤資源清單。 |
|
|
object |
標籤資源清單。 |
||
| ResourceType |
string |
資源類型。取值:
|
PHYSICALCONNECTION |
| TagValue |
string |
資源的標籤值。 |
FinanceJoshua |
| ResourceId |
string |
資源 ID。 |
pc-bp16qjewdsunr41m1**** |
| TagKey |
string |
資源的標籤鍵。 |
FinanceDept |
樣本
正常返回樣本
JSON格式
{
"NextToken": "FFmyTO70tTpLG6I3FmYAXGKPd****",
"RequestId": "54B48E3D-DF70-471B-AA93-08E683A1B45",
"TagResources": {
"TagResource": [
{
"ResourceType": "PHYSICALCONNECTION",
"TagValue": "FinanceJoshua",
"ResourceId": "pc-bp16qjewdsunr41m1****",
"TagKey": "FinanceDept"
}
]
}
}
錯誤碼
|
HTTP status code |
錯誤碼 |
錯誤資訊 |
描述 |
|---|---|---|---|
| 400 | InvalidTagKey | The tag keys are not valid. | 無效的標籤索引 |
| 400 | InvalidTagValue | The tag values are not valid. | 無效的標籤值 |
| 400 | InvalidInstanceType.NotFound | The instance type is not found | 執行個體類型沒有找到 |
| 400 | InvalidInstanceIds.NotFound | The instanceIds are not found | 執行個體ID沒有找到 |
| 400 | Forbidden.TagKeys | The request do not allow to operate the tag keys | 沒有許可權操作TagKeys |
| 400 | QuotaExceeded.TagNum | Custom Tags quota exceeded | quota超限 |
| 400 | Forbidden.TagKey.Duplicated | The specified tag key already exists. | 標籤資源重複 |
| 400 | SizeLimitExceeded.TagNum | The maximum number of tags is exceeded. | 標籤數量超限 |
| 400 | SizeLimitExceeded.ResourceId | The maximum number of resource IDs is exceeded. | 資源群組ID數目超限 |
| 403 | Forbidden | User not authorized to operate on the specified resource. | 您沒有許可權操作指定資源,請申請許可權後再操作。 |
| 403 | BothEmpty.TagsAndResources | The specified Tags and ResourcesIds are not allow to both empty. |
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊,參考變更詳情。