调用ListVirtualPhysicalConnections接口查询共享专线的信息。

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String ListVirtualPhysicalConnections

要执行的操作。取值:ListVirtualPhysicalConnections

PhysicalConnectionId String pc-bp1ciz7ekd2grn1as****

共享专线关联的物理专线ID。

本文以下内容将共享专线关联的物理专线,简称为物理专线,和共享专线互做区分。

VirtualPhysicalConnectionBusinessStatus String Normal

共享专线的商业状态。取值:

  • Normal:正常。
  • FinancialLocked:欠费锁定。
  • SecurityLocked:因安全原因被锁定。
IsConfirmed Boolean true

共享专线是否已被租户确认接收。取值:

  • true:是。
  • false:否。
MaxResults Integer 20

分批次查询时每次显示的条目数。取值范围:1~100,默认值为20

NextToken String dd20****

分批次查询时,下一次查询的Token。

RegionId String cn-shanghai

共享专线所属的地域ID。

您可以通过调用DescribeRegions接口获取地域ID。

VirtualPhysicalConnectionIds.N String pc-bp1mrgfbtmc9brre7****

共享专线实例ID。

支持输入多个实例ID,N的取值范围:1~20

VirtualPhysicalConnectionStatuses.N String Confirmed

共享专线的业务状态。取值:

  • Confirmed:共享专线已被确认接收。
  • UnConfirmed:共享专线未被确认接收。
  • Deleted:共享专线已被删除。

支持输入多种业务状态,N的取值范围:1~20

VirtualPhysicalConnectionAliUids.N String 253460731706911258

共享专线拥有者的阿里云账号(主账号)ID。

支持输入多个阿里云账号(主账号)ID,N的取值范围:1~20

VlanIds.N String 10

共享专线的VLAN ID。

支持输入多个VLAN ID,N的取值范围:1~20

返回数据

名称 类型 示例值 描述
RequestId String 2A55F69E-EE3D-5CBE-8805-734F7D5B46B9

请求ID。

VirtualPhysicalConnections Array of VirtualPhysicalConnection

共享专线信息列表。

Type String VPC

物理专线的类型。默认值为VPC

Status String Enabled

物理专线的状态。

  • Initial:申请中。
  • Approved:审批通过。
  • Allocating:正在分配资源。
  • Allocated:接入施工中。
  • Confirmed:等待用户确认。
  • Enabled:已开通。
  • Rejected:申请被拒绝。
  • Canceled:已取消。
  • Allocation Failed:资源分配失败。
  • Terminated:已终止。
CreationTime String 2017-06-08T12:20:55

物理专线的创建时间。

AdLocation String 余杭经济开发区XXX交叉口, 余杭XX机房, E***包间

物理专线接入设备所在的物理位置。

PortNumber String 80

物理专线接入设备的端口号。

Spec String 50M

共享专线的带宽值。

单位:M表示Mbps,G表示Gbps。

ChargeType String Prepaid

物理专线的付费方式。

取值:Prepaid,表示预付费。

Description String desctest

物理专线的描述信息。

Bandwidth Long 50

物理专线的带宽。单位:Mbps。

EnabledTime String 2021-10-08T10:44Z

物理专线的开通时间。

LineOperator String CU

提供接入物理线路的运营商。

  • CT:中国电信。
  • CU:中国联通。
  • CM:中国移动。
  • CO:中国其他。
  • Equinix:Equinix。
  • Other:境外其他。
PeerLocation String 浙江省杭州市XX区XX街道XX号

本地数据中心的地理位置。

RedundantPhysicalConnectionId String pc-119mfjzm****

冗余物理专线的ID。

Name String nametest

物理专线的名称。

CircuitCode String longtel001

运营商为物理专线提供的电路编码。

EndTime String 2021-11-08T16:00:00Z

共享专线的到期时间。

时间按照ISO8601标准表示,并使用UTC时间。格式为:YYYY-MM-DDThh:mm:ssZ。

PortType String 10GBase-LR

物理专线接入端口类型。

  • 100Base-T:百兆电口。
  • 1000Base-T:千兆电口。
  • 1000Base-LX:千兆单模光口(10千米)。
  • 10GBase-T:万兆电口。
  • 10GBase-LR:万兆单模光口(10千米)。
BusinessStatus String Normal

物理专线的商业状态。

  • Normal:已开通。
  • FinancialLocked:欠费锁定。
  • SecurityLocked:因安全原因被锁定。
LoaStatus String Available

LOA的状态。

  • Applying:LOA申请中。
  • Accept:LOA申请通过。
  • Available:LOA可用。
  • Rejected:LOA申请驳回。
  • Completing:专线施工中。
  • Complete:专线施工完成。
  • Deleted:LOA已删除。
AccessPointId String ap-cn-hangzhou-finance-yh-E

物理专线的接入点ID。

PhysicalConnectionId String pc-bp1mrgfbtmc9brre7****

共享专线实例ID。

ProductType String VirtualPhysicalConnection

物理专线类型。

  • VirtualPhysicalConnection:共享专线。
  • PhysicalConnection:独享专线。
ParentPhysicalConnectionId String pc-bp1ciz7ekd2grn1as****

物理专线的实例ID。

VirtualPhysicalConnectionStatus String Confirmed

共享专线的业务状态。

  • Confirmed:共享专线已确认接收。
  • UnConfirmed:共享专线未被确认接收。
  • Deleted:共享专线已被删除。
ParentPhysicalConnectionAliUid String 283117732402483989

物理专线所属的阿里云账号(主账号)ID。

OrderMode String PayByPhysicalConnectionOwner

共享专线的付费方式。

  • PayByPhysicalConnectionOwner:表示共享专线关联的物理专线的拥有者付费。
  • PayByVirtualPhysicalConnectionOwner:表示共享专线的拥有者付费。
AliUid String 253460731706911258

共享专线拥有者的阿里云账号(主账号)ID。

VlanId String 10

共享专线的VLAN ID。

ExpectSpec String 50M

共享专线的预计带宽值。完成支付后,预计带宽值才能生效。

单位:M表示Mbps,G表示Gbps。

NextToken String dd20****

分批次查询时,下一次查询的Token。

TotalCount Integer 1

总条目数。

Count Integer 1

本次查询的条目数。

示例

请求示例

http(s)://[Endpoint]/?Action=ListVirtualPhysicalConnections
&PhysicalConnectionId=pc-bp1ciz7ekd2grn1as****
&VirtualPhysicalConnectionBusinessStatus=Normal
&VirtualPhysicalConnectionIds=["pc-bp1mrgfbtmc9brre7****"]
&IsConfirmed=true
&VirtualPhysicalConnectionStatuses=["Confirmed"]
&VirtualPhysicalConnectionAliUids=["253460731706911258"]
&VlanIds=["10"]
&MaxResults=20
&NextToken=dd20****
&RegionId=cn-shanghai
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<ListVirtualPhysicalConnectionsResponse>
    <RequestId>2A55F69E-EE3D-5CBE-8805-734F7D5B46B9</RequestId>
    <VirtualPhysicalConnections>
        <Type>VPC</Type>
        <Status>Enabled</Status>
        <CreationTime>2017-06-08T12:20:55</CreationTime>
        <AdLocation>余杭经济开发区XXX交叉口, 余杭XX机房, E***包间</AdLocation>
        <PortNumber>80</PortNumber>
        <Spec>50M</Spec>
        <ChargeType>Prepaid</ChargeType>
        <Description>desctest</Description>
        <Bandwidth>50</Bandwidth>
        <EnabledTime>2021-10-08T10:44Z</EnabledTime>
        <LineOperator>CU</LineOperator>
        <PeerLocation>浙江省杭州市XX区XX街道XX号</PeerLocation>
        <RedundantPhysicalConnectionId>pc-119mfjzm****</RedundantPhysicalConnectionId>
        <Name>nametest</Name>
        <CircuitCode>longtel001</CircuitCode>
        <EndTime>2021-11-08T16:00:00Z</EndTime>
        <PortType>10GBase-LR</PortType>
        <BusinessStatus>Normal</BusinessStatus>
        <LoaStatus>Available</LoaStatus>
        <AccessPointId>ap-cn-hangzhou-finance-yh-E</AccessPointId>
        <PhysicalConnectionId>pc-bp1mrgfbtmc9brre7****</PhysicalConnectionId>
        <ProductType>VirtualPhysicalConnection</ProductType>
        <ParentPhysicalConnectionId>pc-bp1ciz7ekd2grn1as****</ParentPhysicalConnectionId>
        <VirtualPhysicalConnectionStatus>Confirmed</VirtualPhysicalConnectionStatus>
        <ParentPhysicalConnectionAliUid>283117732402483989</ParentPhysicalConnectionAliUid>
        <OrderMode>PayByPhysicalConnectionOwner</OrderMode>
        <AliUid>253460731706911258</AliUid>
        <VlanId>10</VlanId>
        <ExpectSpec>50M</ExpectSpec>
    </VirtualPhysicalConnections>
    <NextToken>dd20****</NextToken>
    <TotalCount>1</TotalCount>
    <Count>1</Count>
</ListVirtualPhysicalConnectionsResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "2A55F69E-EE3D-5CBE-8805-734F7D5B46B9",
  "VirtualPhysicalConnections" : [ {
    "Type" : "VPC",
    "Status" : "Enabled",
    "CreationTime" : "2017-06-08T12:20:55",
    "AdLocation" : "余杭经济开发区XXX交叉口, 余杭XX机房, E***包间",
    "PortNumber" : "80",
    "Spec" : "50M",
    "ChargeType" : "Prepaid",
    "Description" : "desctest",
    "Bandwidth" : 50,
    "EnabledTime" : "2021-10-08T10:44Z",
    "LineOperator" : "CU",
    "PeerLocation" : "浙江省杭州市XX区XX街道XX号",
    "RedundantPhysicalConnectionId" : "pc-119mfjzm****",
    "Name" : "nametest",
    "CircuitCode" : "longtel001",
    "EndTime" : "2021-11-08T16:00:00Z",
    "PortType" : "10GBase-LR",
    "BusinessStatus" : "Normal",
    "LoaStatus" : "Available",
    "AccessPointId" : "ap-cn-hangzhou-finance-yh-E",
    "PhysicalConnectionId" : "pc-bp1mrgfbtmc9brre7****",
    "ProductType" : "VirtualPhysicalConnection",
    "ParentPhysicalConnectionId" : "pc-bp1ciz7ekd2grn1as****",
    "VirtualPhysicalConnectionStatus" : "Confirmed",
    "ParentPhysicalConnectionAliUid" : "283117732402483989",
    "OrderMode" : "PayByPhysicalConnectionOwner",
    "AliUid" : "253460731706911258",
    "VlanId" : "10",
    "ExpectSpec" : "50M"
  } ],
  "NextToken" : "dd20****",
  "TotalCount" : 1,
  "Count" : 1
}

错误码

HttpCode 错误码 错误信息 描述
400 IllegalParam.Bandwidth The param of Bandwidth [%s] is illegal. 传入的带宽不合法。
400 ResourceNotFound.PhysicalConnectionId The specified PhysicalConnectionId [%s] is not found. PhysicalConnectionId未找到。

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