TagResources - Virtual Private Cloud - Alibaba Cloud ドキュメントセンター

リソースにタグを作成して追加します。

操作説明

タグはインスタンスを分類するために使用されます。各タグはキーと値のペアで構成されます。タグを使用する前に、以下の制限事項にご注意ください。

同じインスタンスに追加されるタグのキーは一意である必要があります。
インスタンスに追加せずにタグを単体で作成することはできません。すべてのタグはインスタンスに追加する必要があります。
タグ情報はリージョン間で共有されません。

たとえば、中国 (上海) リージョンから中国 (杭州) リージョンで作成されたタグを表示することはできません。
同一の Alibaba Cloud アカウントに属し、同じリージョンにデプロイされた仮想プライベートクラウド (VPC)、ルートテーブル、vSwitch、および Elastic IP アドレス (EIP) は、互いにタグ情報を共有します。

たとえば、VPC にタグを追加した場合、その VPC が作成されたリージョン内で同一アカウントに属する vSwitch、ルートテーブル、および EIP でもそのタグを利用できます。編集ページから再度入力することなく、このタグを選択できます。タグのキーまたは値を変更したり、インスタンスからタグを削除したりできます。インスタンスを削除すると、そのインスタンスに追加されたすべてのタグも削除されます。
各インスタンスに最大 20 個のタグを追加できます。インスタンスにタグを追加する前に、システムは自動的に既存のタグ数をチェックします。タグ数が上限に達している場合は、エラーメッセージが返されます。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

この操作の認証情報はありません。問題が発生した場合は、アカウントマネージャーにご連絡ください。

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
ResourceType	string	必須	リソースタイプ。有効な値： VPC：VPC VSWITCH：vSwitch ROUTETABLE：ルートテーブル EIP：EIP VpnGateway：VPN ゲートウェイ NATGATEWAY：NAT ゲートウェイ COMMONBANDWIDTHPACKAGE：EIP 帯域幅プラン	VPC
ResourceId	array	必須	リソース ID。最大 20 個の ID を指定できます。	vpc-bp16qjewdsunr41m1****
	string	任意	リソース ID。最大 20 個のリソース ID を指定できます。説明この操作を呼び出す際、ResourceId.N は必須です。	vpc-bp16qjewdsunr41m1****
RegionId	string	必須	リソースのリージョン ID。最新のリージョンリストを照会するには、DescribeRegions 操作を呼び出してください。	cn-hangzhou
Tag	array<object>	必須	タグ情報。	TagResources
	object	任意
Key	string	任意	リソースに追加されるタグのキー。最大 20 個のタグキーを指定できます。キーの長さは 128 文字以内である必要があります。`aliyun` または `acs:` で開始してはならず、`http://` または `https://` を含んではなりません。説明この操作を呼び出す際、Tag.N.Key パラメーターは必須であり、空文字列であってはなりません。	FinanceDept
Value	string	任意	リソースに追加されるタグの値。最大 20 個のタグ値を指定できます。タグ値の長さは 128 文字以内である必要があります。値は `aliyun` または `acs:` で開始してはならず、`http://` または `https://` を含んではなりません。説明この操作を呼び出す際、Tag.N.Value パラメーターは必須ですが、空文字列であってもかまいません。	FinanceJoshua

レスポンスフィールド

フィールド	型	説明	例
	object
RequestId	string	リクエスト ID。	C46FF5A8-C5F0-4024-8262-B16B639225A0

例

成功レスポンス

JSONJSON

{
  "RequestId": "C46FF5A8-C5F0-4024-8262-B16B639225A0"
}

エラーコード

HTTP ステータスコード	エラーコード	エラーメッセージ
400	InvalidTagKey	The tag keys are not valid.
400	InvalidTagValue	The tag values are not valid.
400	MissingParam	%s
400	InvalidInstanceType.NotFound	The instance type is not found
400	InvalidInstanceIds.NotFound	The instanceIds are not found
400	Forbidden.TagKeys	The request do not allow to operate the tag keys
400	QuotaExceeded.TagNum	Custom Tags quota exceeded
400	InvalidTagScope.NotFound	The tag scope is not found
400	Forbidden.NotAllowedCategary	The System tag is not valid
400	Forbidden.TagKey.Duplicated	The specified tag key already exists.
400	SizeLimitExceeded.TagNum	The maximum number of tags is exceeded.
400	SizeLimitExceeded.ResourceId	The maximum number of resource IDs is exceeded.
400	MissingParameter.TagValue	The input parameter TagValue that is mandatory for processing this request is not supplied.
400	MissingParameter.TagKey	The input parameter TagKey that is mandatory for processing this request is not supplied.
400	MissingParam.Tags	You must specify the Tags parameter.
400	DuplicatedParam.ResourceIds	The parameter of ResourceIds contains duplicate values.
403	Forbidden	User not authorized to operate on the specified resource.

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。