TagResources操作を呼び出して、インスタンスにタグを作成および追加できます。

多数のインスタンスがある場合は、複数のタグを作成し、これらのタグをインスタンスに追加できます。 次に、これらのインスタンスをタグでフィルタリングできます。

  • タグはキーと値で構成されています。 各キーは、Alibaba Cloud アカウントのリージョン内で一意である必要があります。 異なるキーを同じ値にマッピングすることができます。
  • 指定したタグが存在しない場合、このタグは自動的に作成され、指定されたインスタンスに追加されます。
  • 指定したタグのキーが既存のタグのキーと同じ場合、既存のタグは指定したタグで上書きされます。
  • インスタンスに最大20個のタグを追加できます。
  • 各呼び出しで最大50個のインスタンスにタグを追加できます。

デバッグ

OpenAPI Explorer は署名値を自動的に計算します。 この操作は、OpenAPI Explorer で呼び出すことを推奨します。 OpenAPI Explorer は、さまざまな SDK に対して操作のサンプルコードを動的に生成します。

リクエストパラメーター

項目 データ型 必須／任意 例: 説明
操作 String 必須 TagResources

実行する操作です。 値をTagResourcesに設定します。

RegionId String 必須 cn-hangzhou

リージョンの ID DescribeRegions を呼び出して、最新のリージョンリストをクエリできます。

ResourceType String 必須 INSTANCE

リソースのタイプを示します。 値をINSTANCEに設定します。

ResourceId.N String 必須 rm-uf6wjk5xxxxxxx

インスタンスの ID。 一度にN個のインスタンスにタグを追加できます。 Nの有効値: 1 ~ 50。

Tag.N.Key String 必須 testkey1

インスタンスに追加するタグのキー。 一度にN個のタグキーを作成できます。 Nの有効値: 1〜20。 このパラメーターの値を空の文字列にすることはできません。

Tag.N.Value String 任意 testvalue1

指定されたタグキーに関連付けられているタグ値。 一度にN個のタグ値を作成できます。 Nの有効値: 1〜20。 パラメーターを空の文字列にすることができます。

レスポンスパラメーター

項目 データ型 例: 説明
RequestId String 224DB9F7-3100-4899-AB9C-C938BCCB43E7

リクエストの ID です。

例

リクエストの例

http(s):// rds.aliyuncs.com/?Action=TagResources
&RegionId=cn-hangzhou
&ResourceType=INSTANCE
&ResourceId.1=rm-uf6wjk5xxxxxxx
&Tag.1.Key=testkey1
&Tag.1.Value=testvalue1
&<共通リクエストパラメーター>

正常に処理された場合のレスポンス例

XML 形式

HTTP/1.1 200 OK
Content-Type:application/xml

<TagResourcesResponse>
<RequestId>224DB9F7-3100-4899-AB9C-C938BCCB43E7</RequestId>
</TagResourcesResponse>

JSON 形式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "224DB9F7-3100-4899-AB9C-C938BCCB43E7"
}

エラーコード

HTTP ステータスコード エラーコード エラーメッセージ 説明
400 NumberExceed。タグ タグの最大数を超えています。 最大値は20です。 作成されたタグの数が上限を超えた場合に返されるエラーメッセージ。 インスタンスに最大20個のタグを作成できます。
400 MissingParameter パラメータ-タグはnullであってはなりません Tag.N.Keyパラメーターが指定されていない場合に返されるエラーメッセージ。
400 InvalidTagKey.Malformed Tag.N.Keyパラメーターは空白です。 Tag.N.Keyパラメーターの値が空の文字列の場合に返されるエラーメッセージ。
400 InvalidTagValue.Malformed Tag.N.Valueパラメーターが空白です。 Tag.N. valueパラメーターの値が空の場合に返されるエラーメッセージ。
400 Duplicate.TagKey Tag.N.Keyは合鍵を含む。 Tag.N.Keyパラメーターで重複キーが指定されている場合に返されるエラーメッセージ。
400 OperationDenied.QuotaExceed タグの最大数を超えています。 作成されたタグの数が上限を超えた場合に返されるエラーメッセージ。
400 NumberExceed.ResourceIds ResourceIdsの最大数を超えています。 最大値は50です。 インスタンスIDの数が上限を超えた場合に返されるエラーメッセージ。 最大50個のインスタンスIDを指定できます。
400 InvalidTagKey.Malformed オペレータがシステムタグの許可を得ていない システムタグに対する操作を実行する権限がない場合に返されるエラーメッセージ。
400 Request.NotFound 要求されたリソースは使用できません。 リクエストしたリソースが利用できない場合に返されるエラーメッセージ。
400 InvalidTagValue.Malformed Tag.N.Valueパラメーターが無効です。 Tag.N. valueパラメーターの値が無効な場合に返されるエラーメッセージ。

エラーコードリストについては、「API エラーセンター」をご参照ください。