調用TagResources介面為指定的VPC對等串連統一建立並綁定標籤。
介面說明
標籤是您為執行個體分配的標記,每個標籤都由一對索引值對(Key-Value)組成。標籤的使用說明如下:
-
一個執行個體上的每列標籤的標籤鍵(Key)必須唯一。
-
不支援未綁定執行個體的空標籤存在,標籤必須綁定在執行個體上。
-
不同地區下的標籤資訊不互連。
例如在華東 1(杭州)地區建立的標籤在華東 2(上海)地區不可見。
-
同帳號同地區下,不同 VPC 對等串連的執行個體標籤資訊互連。
例如在同帳號同地區下,VPC 對等串連執行個體綁定了某個標籤,那麼您可以在其他 VPC 對等串連執行個體的編輯標籤頁面,直接選擇將該標籤綁定到執行個體上,而無需手動輸入標籤的索引值資訊。您可以修改標籤的鍵和值,也可以隨時刪除執行個體的標籤。如果刪除執行個體,綁定執行個體的所有標籤也會被刪除。 -
單個執行個體最多可綁定 20 列標籤。綁定標籤前,阿里雲會校正資源已有標籤數量。超過限制值後返回報錯資訊。
調試
您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。
調試
授權資訊
|
操作 |
存取層級 |
資源類型 |
條件關鍵字 |
關聯操作 |
|
vpc:TagResources |
update |
*PeerConnection
|
無 | 無 |
請求參數
|
名稱 |
類型 |
必填 |
描述 |
樣本值 |
| ResourceId |
array |
是 |
資源 ID,最多支援輸入 20 個資源 ID。 |
|
|
string |
否 |
資源 ID,最多支援輸入 20 個資源 ID。 |
pcc-bp16qjewdsunr41m1**** |
|
| Tag |
array<object> |
是 |
標籤資訊。 |
|
|
object |
否 |
標籤資訊。 |
||
| Key |
string |
否 |
資源的標籤鍵。至少輸入 1 個標籤鍵,最多支援輸入 20 個標籤鍵。一旦傳入該值,則不允許為空白字串。 最多支援 128 個字元,不能以 |
FinanceDept |
| Value |
string |
否 |
資源的標籤值。至少輸入 1 個標籤值,最多支援輸入 20 個標籤值。一旦傳入該值,可以為空白字串。 最多支援 128 個字元,不能以 |
FinanceJoshua |
| ResourceType |
string |
是 |
資源類型。取值:PeerConnection,表示 VPC 對等串連。 |
PeerConnection |
| ClientToken |
string |
否 |
用戶端 Token,用於保證請求的等冪性。 從您的用戶端產生一個參數值,確保不同請求間該參數值唯一。ClientToken 只支援 ASCII 字元。 說明
若您未指定,則系統自動使用 API 請求的 RequestId 作為 ClientToken 標識。每次 API 請求的 RequestId 不一樣。 |
123e4567-e89b-12d3-a456-426655440000 |
| RegionId |
string |
是 |
要建立並綁定標籤的資源所在的地區 ID。 您可以通過調用 DescribeRegions 介面擷取地區 ID。 |
cn-hangzhou |
返回參數
|
名稱 |
類型 |
描述 |
樣本值 |
|
object |
請求 ID。 |
||
| RequestId |
string |
請求 ID。 |
C46FF5A8-C5F0-4024-8262-B16B639225A0 |
| Success |
boolean |
是否建立並綁定成功。取值:
|
true |
樣本
正常返回樣本
JSON格式
{
"RequestId": "C46FF5A8-C5F0-4024-8262-B16B639225A0",
"Success": true
}
錯誤碼
|
HTTP status code |
錯誤碼 |
錯誤資訊 |
描述 |
|---|---|---|---|
| 400 | NumberExceed.Tags | The maximum number of tags is exceeded. | 標籤數量超限 |
| 400 | NumberExceed.ResourceIds | The maximum number of resource IDs is exceeded. | 資源群組ID數目超限 |
| 400 | Forbidden.TagKeys | The tag key cannot be operated by the request. | 該請求不允許操作此 tagkey |
| 400 | Forbidden.TagKey.Duplicated | The specified tag key already exists. | 標籤資源重複 |
| 400 | InvalidInstanceIds.NotFound | The instance IDs are not found. | 執行個體ID沒有找到 |
| 400 | InvalidInstanceType.NotFound | The instance type is not found. | 執行個體類型沒有找到 |
| 400 | IllegalParam.TagKey | The param of Tag.Key is illegal. | 指定的參數Tag.Key非法 |
| 400 | IllegalParam.TagValue | The param of Tag.Value is illegal. | 指定的參數Tag.Value非法 |
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊,參考變更詳情。