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

:ListTagResourcesForExpressConnect

最終更新日:Mar 16, 2025

Express Connect 回線に追加されているタグをクエリします。

使用上の注意

  • リクエストで、クエリ対象のオブジェクトを指定するために、ResourceId.N または Tag.N.KeyTag.N.Value で構成される Tag.N を指定する必要があります。
  • Tag.N は、キーと値のペアで構成されるリソースタグです。Tag.N.Key のみ指定した場合、指定したキーに割り当てられているすべてのタグ値が返されます。Tag.N.Value のみ指定した場合、エラーメッセージが返されます。
  • タグをフィルタリングするために Tag.NResourceId.N を指定する場合、ResourceId.N は、指定されたすべてのキーと値のペアと一致する必要があります。
  • 複数のキーと値のペアを指定した場合、これらのキーと値のペアを含むリソースが返されます。

デバッグ

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

リクエストパラメーター

パラメーター タイプ 必須 説明
ResourceType String Yes PHYSICALCONNECTION

リソースタイプ。有効な値:

  • PHYSICALCONNECTION: Express Connect 回線。
  • VIRTUALBORDERROUTER: 仮想ボーダールータ (VBR)。
  • ROUTERINTERFACE: VBR と VPC の接続。
RegionId String Yes cn-hangzhou

リソースが属するリージョンの ID。

DescribeRegions 操作を呼び出して、最新のリージョンリストをクエリできます。

NextToken String No FFmyTO70tTpLG6I3FmYAXGKPd****

次のリクエストで新しいページの結果を取得するために使用されるページネーショントークン。有効な値:

  • これが最初のクエリであるか、次のクエリが送信されない場合は、このパラメーターを無視します。
  • 前のクエリから取得したトークンを NextToken の値として指定する必要があります。
Action String Yes ListTagResourcesForExpressConnect

実行する操作。ListTagResourcesForExpressConnect に設定します。

MaxResults Integer No 20

1 ページあたりのエントリ数。有効な値:1 から 100。デフォルト値:20

ResourceId.N String No pc-bp16qjewdsunr41m1****

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

Tag.N.Key String No FinanceDept

リソースに追加するタグ N のキー。最大 20 個のタグキーを指定できます。タグキーは空の文字列にすることはできません。

タグキーは最大 128 文字で、http:// または https:// を含めることはできません。キーは acs: または aliyun で始めることはできません。

Tag.N.Value String No FinanceJoshua

リソースに追加するタグ N の値。最大 20 個のタグ値を指定できます。タグ値は空の文字列にすることができます。

タグ値は最大 128 文字で、http:// または https:// を含めることはできません。タグ値は acs: または aliyun で始めることはできません。

レスポンスパラメーター

パラメーター タイプ 説明
NextToken String FFmyTO70tTpLG6I3FmYAXGKPd****

次のリクエストで新しいページの結果を取得するために使用されるページネーショントークン。有効な値:

  • NextToken が空の場合、次のページは存在しません。
  • NextToken に値が返された場合、その値は次のクエリに使用されるトークンです。
RequestId String 54B48E3D-DF70-471B-AA93-08E683A1B45

リクエスト ID。

TagResources Array of TagResource

返されたタグのリスト。

TagResource
ResourceType String PHYSICALCONNECTION

リソースタイプ。有効な値:

  • PHYSICALCONNECTION: Express Connect 回線。
  • VIRTUALBORDERROUTER: VBR。
  • ROUTERINTERFACE: VBR と VPC の接続。
TagValue String FinanceJoshua

リソースに追加されているタグ N の値。

ResourceId String pc-bp16qjewdsunr41m1****

リソース ID。

TagKey String FinanceDept

リソースに追加されているタグ N のキー。

リクエストの例

http(s)://[エンドポイント]/?ResourceType=PHYSICALCONNECTION
&RegionId=cn-hangzhou
&NextToken=FFmyTO70tTpLG6I3FmYAXGKPd****
&Action=ListTagResourcesForExpressConnect
&MaxResults=20
&ResourceId=["pc-bp16qjewdsunr41m1****"]
&Tag=[{"Key":"FinanceDept","Value":"FinanceJoshua"}]
&共通リクエストパラメーター

成功レスポンスの例

XML 形式

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

<ListTagResourcesForExpressConnectResponse>
    <NextToken>FFmyTO70tTpLG6I3FmYAXGKPd****</NextToken>
    <RequestId>54B48E3D-DF70-471B-AA93-08E683A1B45</RequestId>
    <TagResources>
        <ResourceType>PHYSICALCONNECTION</ResourceType>
        <TagValue>FinanceJoshua</TagValue>
        <ResourceId>pc-bp16qjewdsunr41m1****</ResourceId>
        <TagKey>FinanceDept</TagKey>
    </TagResources>
</ListTagResourcesForExpressConnectResponse>

JSON 形式

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

{
  "NextToken" : "FFmyTO70tTpLG6I3FmYAXGKPd****",
  "RequestId" : "54B48E3D-DF70-471B-AA93-08E683A1B45",
  "TagResources" : [ {
    "ResourceType" : "PHYSICALCONNECTION",
    "TagValue" : "FinanceJoshua",
    "ResourceId" : "pc-bp16qjewdsunr41m1****",
    "TagKey" : "FinanceDept"
  } ]
}

エラーコード

HTTP ステータスコード エラーコード エラーメッセージ 説明
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.TagNum タグの最大数を超えました。 タグの数が上限を超えたために返されるエラーメッセージ。
400 SizeLimitExceeded.ResourceId リソース ID の最大数を超えました。 リソースグループ ID の数が上限を超えたために返されるエラーメッセージ。
403 Forbidden 指定されたリソースに対する操作が許可されていません。 指定されたリソースを管理する権限がないために返されるエラーメッセージ。必要な権限を取得して、再試行してください。
403 BothEmpty.TagsAndResources 指定されたタグとリソース ID の両方を空にすることはできません。 ResourceId.N と Tag.N が指定されていないために返されるエラーメッセージ。少なくとも 1 つのパラメーターを指定する必要があります。

エラーコードの一覧については、API エラーセンター をご参照ください。