すべてのプロダクト
Search
ドキュメントセンター

Virtual Private Cloud:DescribeTagKeys

最終更新日:Apr 27, 2026

タグキーを照会します。

今すぐお試しください

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

テスト

RAM 認証

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

リクエストパラメーター

パラメーター

型

必須 / 任意

説明

例

ResourceType

string

任意

リソースタイプ。有効な値は次のとおりです。

  • VPC:VPC (Virtual Private Cloud)

  • VSWITCH:vSwitch

  • ROUTETABLE:ルートテーブル

  • EIP:EIP (Elastic IP Address)

  • VpnGateway:VPN ゲートウェイ

  • NATGATEWAY:NAT ゲートウェイ

  • COMMONBANDWIDTHPACKAGE:EIP 帯域幅プラン

VPC

Keyword

string

任意

タグキー。

keyword

RegionId

string

必須

リソースのリージョン ID。

最新のリージョン一覧を照会するには、DescribeRegions 操作を呼び出してください。

cn-hangzhou

NextToken

string

任意

次のクエリに使用するトークン。有効な値は次のとおりです。

  • 初回のクエリの場合、または後続のクエリを送信しない場合は、このパラメーターを無視してください。

  • 後続のクエリを送信する場合は、前回の呼び出しで返された NextToken の値をこのパラメーターに設定してください。

FFmyTO70tTpLG6I3FmYAXGKPd****

MaxResult

integer

任意

1 ページあたりのエントリー数。有効な値:1~50。デフォルト値:50。

50

ResourceId

array

任意

リソース ID。最大 20 個のリソース ID を指定できます。

string

任意

リソースの ID。最大 50 個の ID を入力できます。

説明

このパラメーターを設定する場合は、ResourceType も設定する必要があります。

vpc-bp16qjewdsunr41m1****

レスポンスフィールド

フィールド

型

説明

例

object

object

NextToken

string

次のクエリに使用するトークン。有効な値は次のとおりです。

  • NextToken の値が返されない場合、後続のクエリを送信しないことを示します。

  • NextToken の値が返される場合、その値は後続のクエリに使用するトークンです。

FFmyTO70tTpLG6I3FmYAXGKPd****

RequestId

string

リクエストの ID。

DE65F6B7-7566-4802-9007-96F2494AC512

TagKeys

object

TagKey

array<object>

タグキーのリスト。

object

Type

string

タグキーのタイプ。有効な値は次のとおりです。

  • Custom:カスタム

  • System:システム

Custom

TagKey

string

タグキー。

FinanceDept

例

成功レスポンス

JSONJSON

{
  "NextToken": "FFmyTO70tTpLG6I3FmYAXGKPd****",
  "RequestId": "DE65F6B7-7566-4802-9007-96F2494AC512",
  "TagKeys": {
    "TagKey": [
      {
        "Type": "Custom",
        "TagKey": "FinanceDept"
      }
    ]
  }
}

エラーコード

HTTP ステータスコード

エラーコード

エラーメッセージ

説明

400 BothEmpty.TagsAndResources The specified Tags and ResourcesIds are not allow to both empty.
400 MissingParameter.TagKey The input parameter TagKey that is mandatory for processing this request is not supplied.
400 MissingParameter.TagValue The input parameter TagValue that is mandatory for processing this request is not supplied.
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.
403 Forbidden User not authorized to operate on the specified resource.

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

変更履歴

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