指定した 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 リソースのタイプ。 有効な値：

  • instance
  • disk
  • snapshot
  • image
  • securitygroup
  • volume
  • eni
  • ddh
  • keypair
  • launchtemplate
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 エラーセンターをご覧ください。