從Elastic Compute Service 資源上解綁一個或多個標籤,例如,實例、磁碟、快照、鏡像和安全性群組等。
請求參數
名稱 | 類型 | 是否必需 | 描述 |
---|---|---|---|
Action | String | 是 | 系統規定參數。取值:RemoveTags |
RegionId | String | 是 | 資源所屬地域。您可以調用 DescribeRegions 查看最新的阿里雲地域列表。 |
ResourceType | String | 是 | 資源類型。取值範圍:
|
ResourceId | String | 是 | 要解綁標籤的資源 ID。例如,當資源類型(ResourceType )為實例(instance )時,資源 ID 可以理解為實例 ID。 |
Tag.n.Key | String | 否 | 標籤鍵,n 的取值範圍為 [1, 5]。您可以調用 DescribeTags 查看您可用的標籤。 |
Tag.n.Value | String | 否 | 標籤值,n 的取值範圍為 [1, 5]。如果您不指定該參數,則解綁由參數 Tag.n.Key 確定的標籤。 |
返回參數
全是公共返回參數。參閱 公共參數。
樣本
請求樣本
https://ecs.aliyuncs.com/?Action=RemoveTags
&ResourceId=s-946ntx4wr
&ResourceType=snapshot
&RegionId=cn-shenzhen
&Tag.1.Key=test
&Tag.1.Value=api
&<公共請求參數>
返回樣本
XML 格式
<RemoveTagsResponse>
<RequestId>6A2C8AB5-E15D-478C-B56A-CF3DAF060028</RequestId>
</RemoveTagsResponse>
JSON 格式
{
"RequestId": "6A2C8AB5-E15D-478C-B56A-CF3DAF060028"
}
錯誤碼
以下為本介面特有的錯誤碼。更多錯誤碼,請訪問 API 錯誤中心。
錯誤碼 | 錯誤資訊 | HTTP 狀態碼 | 說明 |
---|---|---|---|
InvalidTagCount | The specified tags are beyond the permitted range. | 400 | 指定的標籤數不能超過五個。 |
InvalidResourceId.NotSupported | The specified ResourceId does not support tagging. | 403 | 指定的資源不支援標籤功能。 |
InvalidResourceId.NotFound | The specified ResourceId is not found in our records. | 404 | 指定的 ResourceId 不存在。 |
InvalidRegionId.NotFound | The RegionId provided does not exist in our records. | 404 | 指定的 RegionId 不存在。 |
InvalidResourceType.NotFound | The ResourceType provided does not exist in our records. | 404 | 指定的 ResourceType 不存在。 |