タグを作成して追加する - - Alibaba Cloud ドキュメントセンター

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

タグはキーと値で構成されています。各キーは、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 エラーセンター」をご参照ください。