DescribeTagKeysForExpressConnect - - Alibaba Cloud ドキュメントセンター

Express Connect 回線のタグリストを照会します。

デバッグ

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

リクエストパラメーター

パラメーター	タイプ	必須	例	説明
ResourceType	String	いいえ	PHYSICALCONNECTION	リソースタイプ。有効な値： PHYSICALCONNECTION: Express Connect 回線。 VIRTUALBORDERROUTER: 仮想ボーダールータ (VBR)。 ROUTERINTERFACE: VBR から VPC への接続。
Keyword	String	いいえ	keyword	タグのキーワード。キーワードはあいまい一致を実行するために使用されます。キーワードを指定して、キーワードを含むすべてのタグを照会できます。
RegionId	String	はい	cn-hangzhou	リソースが属するリージョン ID。 DescribeRegions 操作を呼び出して、最新のリージョンリストを照会できます。
NextToken	String	いいえ	FFmyTO70tTpLG6I3FmYAXGKPd****	次のリクエストで使用されるページネーショントークン。新しいページの結果を取得します。有効な値：これが最初のクエリであり、後続のクエリが送信されない場合は、このパラメーターを無視します。前のクエリから取得したトークンを NextToken の値として指定する必要があります。
MaxResult	Integer	いいえ	20	1 ページあたりのエントリ数。有効な値：1 から 100。デフォルト値：20。
Action	String	はい	DescribeTagKeysForExpressConnect	実行する操作。値を DescribeTagKeysForExpressConnect に設定します。
ResourceId.N	String	いいえ	pc-bp16qjewdsunr41m1****	リソース ID。最大 20 個のリソース ID を指定できます。

レスポンスパラメーター

パラメーター	タイプ	例	説明
NextToken	String	FFmyTO70tTpLG6I3FmYAXGKPd****	次のリクエストで使用されるページネーショントークン。新しいページの結果を取得します。有効な値： NextToken が空の場合、次のページは存在しません。 NextToken の値が返された場合、その値は次のクエリで使用されるトークンです。
RequestId	String	54B48E3D-DF70-471B-AA93-08E683A1B45	リクエスト ID。
TagKeys	TagKey の配列		タグキーのリスト。
TagKey
Type	String	PHYSICALCONNECTION	リソースタイプ。有効な値： PHYSICALCONNECTION: Express Connect 回線。 VIRTUALBORDERROUTER: VBR。 ROUTERINTERFACE: VBR から VPC への接続。
TagKey	String	FinanceDept	リソースに追加されたタグ N のキー。

例

リクエストの例

http(s)://[Endpoint]/?ResourceType=PHYSICALCONNECTION
&Keyword=keyword
&RegionId=cn-hangzhou
&NextToken=FFmyTO70tTpLG6I3FmYAXGKPd****
&MaxResult=20
&Action=DescribeTagKeysForExpressConnect
&ResourceId=["pc-bp16qjewdsunr41m1****"]
&共通リクエストパラメーター

正常なレスポンスの例

XML 形式

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

<DescribeTagKeysForExpressConnectResponse>
    <NextToken>FFmyTO70tTpLG6I3FmYAXGKPd****</NextToken>
    <RequestId>54B48E3D-DF70-471B-AA93-08E683A1B45</RequestId>
    <TagKeys>
        <Type>PHYSICALCONNECTION</Type>
        <TagKey>FinanceDept</TagKey>
    </TagKeys>
</DescribeTagKeysForExpressConnectResponse>

JSON 形式

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

{
  "NextToken" : "FFmyTO70tTpLG6I3FmYAXGKPd****",
  "RequestId" : "54B48E3D-DF70-471B-AA93-08E683A1B45",
  "TagKeys" : [ {
    "Type" : "PHYSICALCONNECTION",
    "TagKey" : "FinanceDept"
  } ]
}

エラーコード

HttpCode	エラーコード	エラーメッセージ	説明
400	BothEmpty.TagsAndResources	指定されたタグとリソース ID の両方を空にすることはできません。	ResourceId.N と Tag.N が指定されていないために返されるエラーメッセージ。少なくとも 1 つのパラメーターを指定する必要があります。
400	MissingParameter.TagKey	このリクエストの処理に必須の入力パラメーター TagKey が指定されていません。	TagKey パラメーターが指定されていないために返されるエラーメッセージ。
400	MissingParameter.TagValue	このリクエストの処理に必須の入力パラメーター TagValue が指定されていません。	TagValue パラメーターが指定されていないために返されるエラーメッセージ。
400	InvalidTagKey	タグキーが無効です。	タグキーが無効なために返されるエラーメッセージ。
400	InvalidTagValue	タグ値が無効です。	タグ値が無効なために返されるエラーメッセージ。
400	InvalidInstanceType.NotFound	インスタンスタイプが見つかりません。	インスタンスタイプが見つからないために返されるエラーメッセージ。
400	InvalidInstanceIds.NotFound	インスタンス ID が見つかりません。	インスタンス ID が見つからないために返されるエラーメッセージ。
400	Forbidden.TagKeys	リクエストはタグキーを操作することを許可していません。	TagKeys パラメーターを設定する権限がないために返されるエラーメッセージ。
400	QuotaExceeded.TagNum	カスタムタグのクォータを超えました。	クォータを超えたために返されるエラーメッセージ。
400	Forbidden.TagKey.Duplicated	指定されたタグキーはすでに存在します。	タグキーがすでに存在するために返されるエラーメッセージ。
400	SizeLimitExceeded.ResourceId	リソース ID の最大数を超えました。	リソースグループ ID の数が上限を超えたために返されるエラーメッセージ。
403	Forbidden	指定されたリソースに対する操作が許可されていません。	指定されたリソースに対して操作を実行する権限がないために返されるエラーメッセージ。必要な権限を取得して、再試行してください。

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