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

リソースに追加されたタグをクエリします。

操作説明

注意事項

クエリ対象のオブジェクトを指定するには、リクエストに ResourceId.N または Tag.N（Tag.N.Key と Tag.N.Value で構成される）のいずれかを指定する必要があります。
Tag.N はキーと値のペアで構成されるリソースタグです。Tag.N.Key のみを指定した場合、そのキーに関連付けられたすべてのタグ値が返されます。Tag.N.Value のみを指定した場合は、エラーメッセージが返されます。
タグをフィルターするために Tag.N と ResourceId.N の両方を指定する場合、ResourceId.N は指定されたすべてのキーと値のペアに一致している必要があります。
複数のキーと値のペアを指定した場合、それらのキーと値のペアを含むリソースが返されます。

今すぐお試しください

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

テスト

RAM 認証

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

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
ResourceType	string	必須	リソースタイプ。有効な値： VPC VSWITCH ROUTETABLE EIP VpnGateway NATGATEWAY COMMONBANDWIDTHPACKAGE：EIP 帯域幅プラン	VPC
NextToken	string	任意	次のリクエストで新しいページの結果を取得するために使用するページネーショントークン。有効な値：最初のリクエストでは、このパラメーターを指定する必要はありません。前回のクエリから取得したトークンを NextToken の値として指定する必要があります。	FFmyTO70tTpLG6I3FmYAXGKPd****
MaxResults	integer	任意	各ページで返されるエントリー数。有効な値：1 ～ 50。デフォルト値：50。	50
ResourceId	array	任意	リソース ID。最大 20 個のリソース ID を指定できます。	vpc-bp16qjewdsunr41m1****
	string	任意	リソース ID。最大 20 個のリソース ID を指定できます。説明 ResourceId.N および Tag.N (Tag.N.Key と Tag.N.Value) のいずれか一方は必ず指定する必要があります。	vpc-bp16qjewdsunr41m1****
RegionId	string	必須	リソースのリージョン ID。最新のリージョンリストを確認するには、DescribeRegions 操作を呼び出してください。	cn-hangzhou
Tag	array<object>	任意	タグ値。最大 20 個のタグ値を指定できます。空文字列も可能です。値の長さは最大 128 文字で、英数字、ピリオド (.)、アンダースコア (_)、ハイフン (-) を使用できます。値は英字で始まる必要がありますが、`aliyun` または `acs:` で始まってはいけません。また、`http://` または `https://` を含んではいけません。説明 ResourceId.N および Tag.N (Tag.N.Key と Tag.N.Value) のいずれか一方は必ず指定する必要があります。	ListTagResources
	object	任意
Key	string	任意	リソースに追加されたタグのキー。最大 20 個のタグキーを指定できます。タグキーは空文字列であってはいけません。キーの長さは最大 64 文字で、英数字、ピリオド (.)、アンダースコア (_)、ハイフン (-) を使用できます。キーは英字で始まる必要がありますが、`aliyun` または `acs:` で始まってはいけません。また、`http://` または `https://` を含んではいけません。説明 ResourceId.N および Tag.N パラメーター (Tag.N.Key と Tag.N.Value) のいずれか一方は必ず指定する必要があります。	FinanceDept
Value	string	任意	リソースに追加されたタグの値。最大 20 個のタグ値を指定できます。タグ値は空文字列でもかまいません。値の長さは最大 128 文字で、英数字、ピリオド (.)、アンダースコア (_)、ハイフン (-) を使用できます。値は英字で始まる必要がありますが、`aliyun` または `acs:` で始まってはいけません。また、`http://` または `https://` を含んではいけません。説明 ResourceId.N および Tag.N パラメーター (Tag.N.Key と Tag.N.Value) のいずれか一方は必ず指定する必要があります。	FinanceJoshua

レスポンスフィールド

フィールド	型	説明	例
	object
NextToken	string	ページネーショントークン。次のリクエストで新しいページの結果を取得するために使用できます。有効な値： NextToken に値が返されない場合、次のクエリは送信されません。 NextToken に値が返される場合、その値を使用して新しいページの結果を取得します。	FFmyTO70tTpLG6I3FmYAXGKPd****
RequestId	string	リクエスト ID。	DE65F6B7-7566-4802-9007-96F2494AC512
TagResources	object
TagResource	array<object>	タグキー。
	object
ResourceType	string	リソースのタイプ。有効な値： VPC：VPC VSWITCH：vSwitch ROUTETABLE：ルートテーブル EIP：EIP VpnGateWay：VPN ゲートウェイ NATGATEWAY：NAT ゲートウェイ COMMONBANDWIDTHPACKAGE：EIP 帯域幅プラン	VPC
TagValue	string	タグ値。	FinanceJoshua
ResourceId	string	リソースの ID。	vpc-bp16qjewdsunr41m1****
TagKey	string	タグキー。	FinanceDept

例

成功レスポンス

JSONJSON

{
  "NextToken": "FFmyTO70tTpLG6I3FmYAXGKPd****",
  "RequestId": "DE65F6B7-7566-4802-9007-96F2494AC512",
  "TagResources": {
    "TagResource": [
      {
        "ResourceType": "VPC",
        "TagValue": "FinanceJoshua",
        "ResourceId": "vpc-bp16qjewdsunr41m1****",
        "TagKey": "FinanceDept"
      }
    ]
  }
}

エラーコード

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	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	BothEmpty.TagsAndResources	The specified Tags and ResourcesIds are not allow to both empty.
400	MissingParam.ResourceType	The param of ResourceType is missing.
403	Forbidden	User not authorized to operate on the specified resource.
403	BothEmpty.TagsAndResources	The specified Tags and ResourcesIds are not allow to both empty.

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

変更履歴

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