Queries Elastic Compute Service (ECS) instances that reside in the classic network and have established ClassicLink connections with virtual private clouds (VPCs).
Operation description
Take note of the following items:
- This operation applies only to instances that reside in the classic network.
- You can query a maximum of 100 instances that reside in the classic network at a time.
- At least one of the
VpcId
andInstanceId
parameters must be configured.
Debugging
Authorization information
Request parameters
Parameter | Type | Required | Description | Example |
---|---|---|---|---|
RegionId | string | Yes | The region ID of the instances. You can call the DescribeRegions operation to query the most recent region list. | cn-hangzhou |
VpcId | string | No | The VPC ID. The ClassicLink feature must be enabled for the specified VPC. For more information, see Establish a ClassicLink connection. | vpc-bp1vwnn14rqpyiczj**** |
InstanceId | string | No | The instance ID. You can specify a maximum of 100 instance IDs in a single request. Separate the instance IDs with commas (,). | i-bp1a5zr3u7nq9cxh**** |
PageNumber | string | No | The page number. Pages start from page 1. Default value: 1. | 1 |
PageSize | string | No | The number of entries per page. Valid values: 1 to 100. Default value: 10. | 10 |
Response parameters
Examples
Sample success responses
JSON
format
{
"PageSize": 10,
"RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
"PageNumber": 1,
"TotalCount": 2,
"Links": {
"Link": [
{
"VpcId": "vpc-test",
"InstanceId": "i-test"
}
]
}
}
Error codes
HTTP status code | Error code | Error message | Description |
---|---|---|---|
403 | InvalidInstanceId.NotFound | The InstanceId provided does not exist in our records. | The specified instance does not exist. Check whether the instance ID is correct. |
403 | InvalidParameter.ToManyInstanceIds | No more than 100 InstanceIds can be specified. | Up to 100 instance IDs can be specified. |
403 | InvalidParameter.InvalidInstanceIdAndVpcId | The parameter InstanceId and VpcId are not allowed to be empty at the same time. | At least one of the InstanceId and VpcId parameters must be specified. |
403 | InvalidInstanceId.NotBelong | The specified instance is not belong to you. | The specified instance does not exist in your account. |
403 | InvalidVpc.NotBelong | The specified vpc is not belong to you. | The specified VPC does not belong to your account. |
403 | InvalidParameter.PageNumber | The parameter pageNumber is invalid. | The specified PageNumber parameter is invalid. |
403 | InvalidParameter.PageSize | The parameter pageSize is invalid. | - |
404 | InvalidRegionId.NotFound | The specified region does not exist. | The specified RegionId parameter does not exist. Check whether the service is available in the specified region. |
For a list of error codes, visit the Service error codes.