DescribeClassicLinkInstances - 查询建立了连接的经典网络类型实例 - 云服务器 ECS

接口说明

调用该接口时，您需要注意：

该接口仅支持经典网络类型实例。
单次最多只能查询 100 台经典网络类型实例。
参数VpcId和InstanceId不能同时为空。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

ecs:DescribeClassicLinkInstances

get

*全部资源

*

无

请求参数

名称	类型	必填	描述	示例值
RegionId	string	是	实例所属的地域 ID。您可以调用 DescribeRegions 查看最新的阿里云地域列表。	cn-hangzhou
VpcId	string	否	VPC ID。目标 VPC 必须已开启 ClassicLink 功能，详情请参见建立 ClassicLink 连接。	vpc-bp1vwnn14rqpyiczj****
InstanceId	string	否	实例 ID。最多指定 100 台实例 ID，并使用半角逗号（,）隔开。	i-bp1a5zr3u7nq9cxh****
PageNumber	string	否	当前页码。起始值：1 默认值：1	1
PageSize	string	否	分页查询时设置的每页行数。取值范围：1~100 默认值：10	10

返回参数

名称	类型	描述	示例值
	object
PageSize	integer	分页查询的每页行数。	10
RequestId	string	请求 ID。	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
PageNumber	integer	分页查询的页码。	1
TotalCount	integer	连接总数。	2
Links	object
Link	array<object>	返回经典网络类型实例和 VPC 连接信息。
	object
VpcId	string	VPC ID。	vpc-test
InstanceId	string	实例 ID。	i-test

示例

正常返回示例

JSON格式

{
  "PageSize": 10,
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "PageNumber": 1,
  "TotalCount": 2,
  "Links": {
    "Link": [
      {
        "VpcId": "vpc-test",
        "InstanceId": "i-test"
      }
    ]
  }
}

异常返回示例

JSON格式

{
    "PageNumber":1,
    "Links":{
        "Link":[{
            "InstanceId":"i-test",
            "VpcId":"vpc-test"
            },
           {
           "InstanceId": "i-test1",
           "VpcId": "vpc-test"
           }]
    },
    "TotalCount":2,
    "PageSize":10,
    "RequestId":"B154D309-F3E1-4AB7-BA94-FEFCA8B89001"
}

错误码

HTTP status code	错误码	错误信息	描述
403	InvalidInstanceId.NotFound	The InstanceId provided does not exist in our records.
403	InvalidParameter.ToManyInstanceIds	No more than 100 InstanceIds can be specified.	最多只能指定 100 个实例 ID。
403	InvalidParameter.InvalidInstanceIdAndVpcId	The parameter InstanceId and VpcId are not allowed to be empty at the same time.	至少指定一个 InstanceId 或 VpcId。
403	InvalidInstanceId.NotBelong	The specified instance is not belong to you.
403	InvalidVpc.NotBelong	The specified vpc is not belong to you.
403	InvalidParameter.PageNumber	The parameter pageNumber is invalid.	指定的 PageNumber 无效。请检查要查询的页码值是否正确。
403	InvalidParameter.PageSize	The parameter pageSize is invalid.	指定的分页参数PageSize无效。
404	InvalidRegionId.NotFound	The specified region does not exist.	指定的 RegionId 不存在，请您检查此产品在该地域是否可用。

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。