Express Connect 回線に追加されているタグをクエリします。
使用上の注意
- リクエストで、クエリ対象のオブジェクトを指定するために、ResourceId.N または Tag.N.Key と Tag.N.Value で構成される Tag.N を指定する必要があります。
- Tag.N は、キーと値のペアで構成されるリソースタグです。Tag.N.Key のみ指定した場合、指定したキーに割り当てられているすべてのタグ値が返されます。Tag.N.Value のみ指定した場合、エラーメッセージが返されます。
- タグをフィルタリングするために Tag.N と ResourceId.N を指定する場合、ResourceId.N は、指定されたすべてのキーと値のペアと一致する必要があります。
- 複数のキーと値のペアを指定した場合、これらのキーと値のペアを含むリソースが返されます。
デバッグ
リクエストパラメーター
| パラメーター | タイプ | 必須 | 例 | 説明 |
| ResourceType | String | Yes | PHYSICALCONNECTION | リソースタイプ。有効な値:
|
| RegionId | String | Yes | cn-hangzhou | リソースが属するリージョンの ID。 DescribeRegions 操作を呼び出して、最新のリージョンリストをクエリできます。 |
| NextToken | String | No | FFmyTO70tTpLG6I3FmYAXGKPd**** | 次のリクエストで新しいページの結果を取得するために使用されるページネーショントークン。有効な値:
|
| 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 文字で、 |
| Tag.N.Value | String | No | FinanceJoshua | リソースに追加するタグ N の値。最大 20 個のタグ値を指定できます。タグ値は空の文字列にすることができます。 タグ値は最大 128 文字で、 |
レスポンスパラメーター
| パラメーター | タイプ | 例 | 説明 |
| NextToken | String | FFmyTO70tTpLG6I3FmYAXGKPd**** | 次のリクエストで新しいページの結果を取得するために使用されるページネーショントークン。有効な値:
|
| RequestId | String | 54B48E3D-DF70-471B-AA93-08E683A1B45 | リクエスト ID。 |
| TagResources | Array of TagResource | 返されたタグのリスト。 |
|
| TagResource | |||
| ResourceType | String | PHYSICALCONNECTION | リソースタイプ。有効な値:
|
| 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 エラーセンター をご参照ください。