指定した ECS リソースのリストからタグを切り離して削除します。
デバッグ
API Explorer を使用すると、API を簡単にデバッグし、SDK コード例を自動的に生成し、API をすばやく検索できます。
リクエストパラメーター
パラメーター | データ型 | 必須/任意 | 値の例 | 説明 |
---|---|---|---|---|
RegionId | String | 必須 | cn-hangzhou |
ECS リソースが属するリージョンの ID。 詳細については、 DescribeRegions を呼び出して最新のリージョンリストを取得してください。 |
ResourceId.N | RepeatList | 必須 | i-bp1j6qtvdm8w0z1o0XXX |
ECS リソースの ID 。 N の有効値 : 1~50 。 |
ResourceType | String | 必須 | instance |
ECS リソースのタイプ。 有効な値:
|
Action | String | 任意 | UntagResources |
この操作の名前。 値:UntagResources |
All | Boolean | 任意 | false |
指定したリソースからすべてのタグを削除するかどうかを指定します。 このパラメーターは、TagKey.N がリクエストで指定されていない場合に有効です。 デフォルト値: false |
TagKey.N | RepeatList | 任意 | FinanceDept |
タグの値。 N の有効値 : 1~20 。 パラメーターは null 文字列にすることができ、長さは 1~128 文字にする必要があります。aliyun または acs: で始めたり、http:// または https:// を含めることはできません。 |
レスポンスパラメーター
パラメーター | データ型 | 値の例 | 説明 |
---|---|---|---|
RequestId | String | C46FF5A8-C5F0-4024-8262-B16B639225A0 |
リクエスト ID。 |
例
リクエストの例
https://ecs.aliyuncs.com/?Action=UntagResources
&RegionId=cn-hangzhou
&ResourceType=instance
&ResourceId.1=i-bp1j6qtvdm8w0z1o0XXX
&TagKey.1=FinanceDept
&<Common Request Parameters>
レスポンスの例
XML
形式
<UntagResourcesResponse>
<RequestId>C46FF5A8-C5F0-4024-8262-B16B639225A0</RequestId>
</UntagResourcesResponse>
JSON
形式
{
"RequestId":"C46FF5A8-C5F0-4024-8262-B16B639225A0"
}
エラー
HTTP ステータスコード | エラーコード | エラーメッセージ | 説明 |
---|---|---|---|
404 | MissingParameter.TagOwnerUid | The parameter - TagOwnerUid should not be null | タグ所有者の UID が指定されていません。 |
404 | MissingParameter.TagOwnerBid | The parameter - TagOwnerBid should not be null | タグ所有者の BID が指定されていません。 |
404 | MissingParameter.ResourceType | The parameter - ResourceType should not be null | リソースタイプが指定されていません。 |
404 | MissingParameter.Tags | The parameter - Tags should not be null | Tags パラメーターが指定されていません。 |
404 | MissingParameter.RegionId | The parameter - RegionId should not be null | リージョン ID が指定されていません。 |
403 | PermissionDenied.TagOwnerUid | The specified operator not have permission to set TagOwnerUid value. | タグの所有者を設定する権限がありません。 |
403 | PermissionDenied.Scope | The specified operator not have permission to set Scope value. | スコープ値を変更する権限がありません。 |
400 | NumberExceed.ResourceIds | The ResourceIds parameter's number is exceed , Valid : 50 | リソース ID の数は 50 を超えることはできません。 |
400 | NumberExceed.Tags | The Tags parameter's number is exceed , Valid : 20 | タグの数は 20 を超えることはできません。 |
400 | Duplicate.TagKey | The Tag.N.Key contain duplicate key. | タグキーが重複しています。 |
404 | InvalidResourceId.NotFound | The specified ResourceIds are not found in our records. | 指定されたリソースは存在しません。 |
404 | InvalidResourceType.NotFound | The ResourceType provided does not exist in our records. | 指定されたリソースタイプは存在しません。 |
400 | InvalidTagKey.Malformed | The specified Tag.n.Key is not valid. | 指定されたタグキーは無効です。 |
400 | InvalidTagValue.Malformed | The specified Tag.n.Value is not valid. | 指定されたタグ値は無効です。 |
400 | OperationDenied.QuotaExceed | The quota of tags on resource is beyond permitted range. | リソースタグのクォータに達しました。 |
403 | InvalidResourceId.NotSupported | The specified ResourceId does not support tagging. | 指定されたリソース ID はタグをサポートしていません。 |
400 | InvalidTag.Mismatch | The specified Tag.n.Key and Tag.n.Value are not match. | 指定された Tag.n.Key と Tag.n.Value が一致しません。 |
400 | InvalidTagCount | The specified tags are beyond the permitted range. | 指定されたタグの数がクォータを超えています。 |
404 | InvalidRegionId.NotFound | The specified RegionId does not exist. | 指定されたリージョン ID は存在しません。 このリージョンでこのプロダクトが利用可能かどうかを確認してください。 |
400 | Invalid.Scope | The specified scope is invalid. | 指定されたスコープは無効です。 |
403 | NoPermission.Tag | The operator is not permission for the tag. | このリソースタグを使用する権限がありません。 |
エラーコードのリストについては、 API エラーセンターをご覧ください。