為一個或多個雲資料庫 Tair(相容 Redis)執行個體綁定標籤。
介面說明
在執行個體數量較多的情況下,您可以建立多個標籤,為執行個體綁定不同的標籤對其進行分類,之後通過標籤進行執行個體篩選。
標籤由一對鍵(key)值(value)組成,鍵在同帳號同地區下唯一,值無此限制。
若設定的標籤不存在,則自動建立該標籤並綁定到目標執行個體。
若執行個體已經綁定了有相同鍵的標籤,則進行覆蓋綁定。
每個執行個體最多可以綁定 20 個標籤。
每次調用最多設定 50 個執行個體進行批量標籤綁定。
該 API 對應的控制台操作請參見建立標籤。
調試
您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。
調試
授權資訊
|
操作 |
存取層級 |
資源類型 |
條件關鍵字 |
關聯操作 |
|
kvstore:TagResources |
create |
*DBInstance
|
無 | 無 |
請求參數
|
名稱 |
類型 |
必填 |
描述 |
樣本值 |
| RegionId |
string |
是 |
執行個體所屬的地區 ID。 |
cn-hangzhou |
| ResourceType |
string |
是 |
資源類型,取值固定為 INSTANCE。 |
INSTANCE |
| ResourceId |
array |
是 |
執行個體 ID。 |
r-bp1zxszhcgatnx**** |
|
string |
否 |
執行個體 ID,支援設定多個。 說明
N 表示傳入第幾個執行個體 ID。例如ResourceId.1表示傳入第一個執行個體 ID;ResourceId.2表示傳入第二個執行個體 ID。 |
r-bp1zxszhcgatnx**** |
|
| Tag |
array<object> |
是 |
執行個體的標籤資訊。 |
|
|
object |
否 |
對象。 |
||
| Key |
string |
是 |
標籤的鍵。 說明
|
demokey |
| Value |
string |
是 |
標籤的值。 說明
N 表示傳入第幾個標籤的值。例如Tag.1.Value表示傳入第一個標籤的值;Tag.2.Value表示傳入第二個標籤的值。 |
demovalue |
返回參數
|
名稱 |
類型 |
描述 |
樣本值 |
|
object |
|||
| RequestId |
string |
請求 ID。 |
4BD4E308-A3D8-4CD1-98B3-0ADAEE38**** |
樣本
正常返回樣本
JSON格式
{
"RequestId": "4BD4E308-A3D8-4CD1-98B3-0ADAEE38****"
}
錯誤碼
|
HTTP status code |
錯誤碼 |
錯誤資訊 |
描述 |
|---|---|---|---|
| 400 | NumberExceed.Tags | The Tags parameter number is exceed, Valid is 20. | |
| 400 | InvalidTagKey.Malformed | The specified parameter Tag.n.Key or TagKey.n is not valid. | |
| 400 | InvalidTagValue.Malformed | The specified parameter Tag.n.Value is not valid. | |
| 400 | InvalidParameter.ResourceId | The specified parameter ResourceId.n is not valid. | |
| 400 | MissParameter.TagOrResourceId | The parameter Tag.n or ResourceId.n is needed. | 參數Tag和ResourceId不能全部為空白,至少傳入其中一種 |
| 400 | InvalidParameter.Scope | The specified parameter Scope is not valid. | |
| 400 | NumberExceed.ResourceIds | The ResourceIds parameter number is exceed. | |
| 400 | NumberExceed.CustomTags | The Custom Tags parameter number is exceed. Valid is 20. | |
| 400 | Duplicate.TagKey | The specified parameter Tag.n.Key is duplicated. | |
| 400 | InvalidParameter.ResourceType | The specified parameter ResourceType is not valid. | |
| 400 | OperationDenied.QuotaExceed | The Tags parameter number is exceed. Valid is 20. | |
| 404 | InvalidDbInstanceId.NotFound | Specified instance does not exist. |
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊,參考變更詳情。