VPC で ClassicLink を確立した、1 つまたは複数のクラシックネットワーク接続インスタンスを照会します。
説明
このインターフェイスを呼び出すときは、次の点に留意してください。
- この API は、クラシックネットワーク接続インスタンスのみに対応しています。
- 1 回につき最大 100 件のクラシックネットワーク接続インスタンスを照会することができます。
- VpcId パラメーターまたは InstanceId パラメーターのいずれかを指定する必要があります。
デバッグ
API Explorer でデバッグを実行できます。 API Explorer で各種操作を実行して API の使用を簡素化することができます。 たとえば、API の取得、API の呼び出し、SDK のサンプルコードの動的な生成ができます。
リクエストパラメーター
名称 | タイプ | 必須/省略可能 | 例 | 説明 |
---|---|---|---|---|
RegionId | String | 必須 | cn-hangzhou |
インスタンスが設置されているリージョンの ID です。 DescribeRegions を呼び出すと、Alibaba Cloud の最新リージョンが表示されます。 |
Action | String | 省略可能 | DescribeClassicLinkInstances |
実行する操作です。 値を DescribeClassicLinkInstances に設定します。 |
InstanceId | String | 省略可能 | i-test |
インスタンスの ID。 最大 100 個のインスタンス ID を指定できます。ID は、コンマ(、)で区切る必要があります。 |
PageNumber | String | 省略可能 | 1 |
現在のページ番号 開始値:1。 デフォルト値 : 1。 |
PageSize | String | 省略可能 | 10 |
1 ページあたりのエントリー数。 有効値:0~50。 デフォルト値: 10。 |
VpcId | String | 省略可能 | vpc-test |
VPC の ID。 指定した VPC に対して ClassicLink サービスを有効にする必要があります。 |
応答パラメーター
名称 | タイプ | 例 | 説明 |
---|---|---|---|
リンク |
クラシックネットワーク接続インスタンスとVPCの間のリンク。 |
||
└InstanceId | String | i-test |
インスタンスの ID。 |
└VpcId | String | vpc-test |
VPCのID。 |
PageNumber | Integer | 1 |
リンクリストで照会したページ番号。 |
PageSize | Integer | 10 |
1 ページあたりのエントリー数。 |
RequestId | String | 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E |
API リクエストの ID。 |
TotalCount | Integer | 2 |
リンクの総数。 |
例
リクエストの例
https://ecs.aliyuncs.com/?Action=DescribeClassicLinkInstances
&RegionId=cn-hangzhou
&VpcId=vpc-test
&InstanceId=i-test, i-test1
&<Common request parameters>
通常の応答例
XML
形式
<DescribeClassicLinkInstancesResponse>
<RequestId>B154D309-F3E1-4AB7-BA94-FEFCA8B89001</RequestId>
<TotalCount>2</TotalCount>
<PageNumber>1</PageNumber>
<PageSize>10</PageSize>
<Links>
<Links>
<InstanceId>i-test</InstanceId>
<VpcId>vpc-test</VpcId>
<Links>
<Links>
<InstanceId>i-test1</InstanceId>
<VpcId>vpc-test</VpcId>
</Link>
<Links>
</DescribeClassicLinkInstancesResponse>
JSON
形式
{
"PageNumber":1,
"TotalCount":2,
"Links":{
"Link":[
{
"InstanceId":"i-test",
"VpcId":"vpc-test"
},
{
"InstanceId":"i-test1",
"VpcId":"vpc-test"
}
]
},
"PageSize":10,
"RequestId": "B154D309-F3E1-4AB7-BA94-FEFCA8B89001"
}
エラーコード
HTTP ステータスコード | エラーコード | エラーメッセージ | 説明 |
---|---|---|---|
403 | InvalidInstanceId.NotBelong | 指定されたインスタンスは存在しません。 | 指定されたイメージがこのアカウントに存在しない場合に表示されるエラーメッセージ。 |