為指定的多個云產品的多個云資源統一創建并綁定標簽。
接口說明
調試
您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。
授權信息
下表是API對應的授權信息，可以在RAM權限策略語句的Action元素中使用，用來給RAM用戶或RAM角色授予調用此API的權限。具體說明如下：
- 操作：是指具體的權限點。
- 訪問級別：是指每個操作的訪問級別，取值為寫入（Write）、讀取（Read）或列出（List）。
- 資源類型：是指操作中支持授權的資源類型。具體說明如下：
- 對于必選的資源類型，用背景高亮的方式表示。
- 對于不支持資源級授權的操作，用
全部資源表示。
- 條件關鍵字：是指云產品自身定義的條件關鍵字。
- 關聯操作：是指成功執行操作所需要的其他權限。操作者必須同時具備關聯操作的權限，操作才能成功。
| 操作 | 訪問級別 | 資源類型 | 條件關鍵字 | 關聯操作 |
|---|---|---|---|---|
| tag:TagResources | update | *全部資源 * |
|
|
請求參數
| 名稱 | 類型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| RegionId | string | 是 | 地域 ID。取值：
| cn-hangzhou |
| Tags | string | 是 | 標簽鍵和標簽值。鍵值對取值范圍：1~10。 如果指定多個標簽，則會為指定資源同時創建并綁定該多個標簽。 約束如下：
| {"k1":"v1","k2":"v2"} |
| ResourceARN | array | 是 | 資源 ARN（Aliyun Resource Name）。 | |
| string | 是 | 資源 ARN（Aliyun Resource Name）。 N 的取值范圍：1~50。 資源 ARN 的格式：
說明
ResourceARN 支持傳遞資源組、操作審計和資源管理的 ProductCode和ResourceType。
| arn:acs:vpc:cn-hangzhou:123456789****:vpc/vpc-bp19dd90tkt6tz7wu**** |
關于公共請求參數的詳情，請參見公共參數。
返回參數
示例
正常返回示例
JSON格式
{
"RequestId": "72086426-9F8C-4A60-852B-864048FD1199",
"FailedResources": {
"FailedResource": [
{
"ResourceARN": "arn:acs:vpc:cn-hangzhou:123456789****:vpc/vpc-bp19dd90tkt6tz7wu****",
"Result": {
"Code": "InvalidResourceId.NotFound",
"Message": "The specified ResourceIds are not found in our records."
}
}
]
}
}錯誤碼
| HTTP status code | 錯誤碼 | 錯誤信息 | 描述 |
|---|---|---|---|
| 400 | InvalidResourceARN.Region | The Region specified in the ResourceARN parameter does not match the RegionId parameter, specifically: %s. | ResourceARN中的Region與參數RegionId不匹配，它們分別是：%s |
| 400 | InvalidResourceARN.Account | The Account specified in the ResourceARN parameter does not match the actual account, specifically: %s. | ResourceARN中的Account與實際用戶不吻合，分別是：%s |
| 400 | InvalidResourceARN.FormatError | The format of parameter ResourceARN: %s is not valid, for the correct format, you can refer to the Recommend. | ResourceARN的格式不符合規范，正確的格式請參考錯誤診斷。 |
| 400 | InvalidParameter.ResourceType | The parameter resource type: %s in ResourceARN is not valid or not support. | 在ResourceARN中的ResourceType：%s 不合法或不被支持。 |
| 400 | InvalidParameter.ServiceCode | The parameter service code: %s in ResourceARN is not valid or not support. | ResourceARN中的ServiceCode：%s 不合法或未被支持。 |
| 400 | InvalidParameter.TagKey | The TagKey parameter is invalid. The following TagKeys are invalid: %s. | 參數中存在不合法的標簽鍵，不合法的標簽鍵如下：%s |
| 400 | InvalidParameter.TagValue | The TagValue parameter is invalid. The following TagValues are invalid: %s. | 參數中包含不合法的標簽值，不合法的標簽值如下：%s |
| 400 | InvalidParameter.Tags | The Tags parameter cannot be empty, and JSON parsing should adhere to the format of a Map. | - |
| 403 | Duplicate.TagKey | The Tag.N.Key contains duplicate keys. | 參數包含重復標簽鍵。 |
| 403 | InvalidParameter.Category | The specified Category is invalid. Valid values are Custom and System. | 標簽類型非法，合法值為Custom，System。 |
| 403 | MissingParameter.Createby | You must specify Createby. | 操作者參數不可為空。 |
| 403 | MissingParameter.ResourceIds | You must specify ResourceIds. | 資源列表參數不可為空。 |
| 403 | NoPermission.Operator | The user is not authorized to operate on the specified resource. | 該用戶沒有權限操作。 |
| 403 | NoPermissionKey.Category | Some keys cannot be modified because the user does not have permission. | 某些key的標簽類型沒有操作權限。 |
| 403 | NoPermissionKey.Operator | You are not authorized to operate the tag key. | 該用戶沒有操作此標簽鍵權限。 |
| 403 | NumberExceed.ResourceIds | The maximum number of ResourceIds is exceeded. | 資源列表參數數量超限。 |
| 403 | NumberExceed.Tags | The maximum number of Tags is exceeded. | 標簽參數數量超限。 |
| 403 | QuotaExceed.TagsPerResource | The maximum number of tags for each resource is exceeded. | 每個資源上的標簽數量有限制，目前有資源已經超限。 |
| 404 | Missing.TagKey | Tag.N.Value has been specified and you must specify Tag.N.Key. | 一對鍵值對，對應的TagValue缺失相同N的TagKey。 |
| 404 | MissingParameter.AliUid | You must specify AliUid. | 缺失用戶UID參數。 |
| 404 | MissingParameter.Bid | You must specify Bid. | bid參數不可為空。 |
| 404 | MissingParameter.TagKey | You must specify TagKey. | 標簽鍵參數不可為空。 |
訪問錯誤中心查看更多錯誤碼。
變更歷史
| 變更時間 | 變更內容概要 | 操作 |
|---|---|---|
| 2024-02-27 | OpenAPI 錯誤碼發生變更 | 查看變更詳情 |