查詢一台或多台與專有網路 VPC 建立了串連的經典網路類型執行個體。

描述

調用該介面時,您需要注意:

  • 該介面僅支援經典網路類型執行個體。

  • 單次最多隻能查詢 100 台經典網路類型執行個體。

  • 參數 VpcIdInstanceId 不能同時為空。

請求參數

名稱 類型 是否必需 描述
Action String 系統規定參數。取值:DescribeClassicLinkInstances
RegionId String 執行個體所屬的地域 ID。您可以調用 DescribeRegions 查看最新的阿里雲地域列表。
InstanceId String 執行個體 ID。最多指定 100 台執行個體 ID,並使用半形逗號(,)隔開。樣本格式為 InstanceId=i-XXX, i-XXX, i-XXX, i-XXX, ...
VpcId String VPC ID。目標 VPC 必須已 開啟 ClassicLink 功能 功能。
PageNumber Integer 當前頁碼。起始值:1

預設值:1

PageSize Integer 分頁查詢時設定的每頁行數。取值範圍:[1, 100]

預設值:10

返回參數

名稱 類型 描述
TotalCount Integer 串連總數
PageNumber Integer 串連列表的頁碼
PageSize Integer 輸入時設定的每頁行數
Links Link 返回經典網路類型執行個體和 VPC 串連資訊

樣本

請求樣本
https://ecs.aliyuncs.com/?Action=DescribeClassicLinkInstances
&RegionId=cn-hangzhou
&VpcId=vpc-test
&InstanceId=i-test, i-test1
&<公共請求參數>
返回樣本

XML 格式

<DescribeClassicLinkInstancesResponse>
    <RequestId>B154D309-F3E1-4AB7-BA94-FEFCA8B89001</RequestId>
    <TotalCount>2</TotalCount>
    <PageNumber>1</PageNumber>
    <PageSize>10</PageSize>
    <Links>
        <Link>
            <InstanceId>i-test</InstanceId>
            <VpcId>vpc-test</VpcId>
        </Link>
        <Link>
            <InstanceId>i-test1</InstanceId>
            <VpcId>vpc-test</VpcId>
        </Link>
    </Links>
</DescribeClassicLinkInstancesResponse>
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"
}

錯誤碼

以下為本介面特有的錯誤碼。更多錯誤碼,請訪問 API 錯誤中心

錯誤碼 錯誤資訊 HTTP 狀態碼 說明
InvalidRegionId.Malformed The specified RegionId is invalid. 400 指定的 RegionId不存在或者未授權。
InvalidInstanceId.NotBelong The user does not own the specified instance. 403 指定的執行個體不屬於您。
InvalidParameter.InvalidInstanceIdAndVpcId Either InstanceId or VpcId must be specified. 403 必須指定 InstanceIdVpcId
InvalidParameter.ToManyInstanceIds The maximum number of specified InstanceIds is exceeded. 403 指定的 InstanceId 超過 100 台執行個體 ID。
InvalidVpc.NotBelong The user do not own the specified VPC. 403 指定的 VPC 不屬於您。
InvalidInstanceId.NotFound The specified InstanceId does not exist. 404 指定的 InstanceId 不存在。