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

调试

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

请求参数

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

要执行的操作。取值：ListVirtualPhysicalConnections。

PhysicalConnectionId String 否 pc-bp1ciz7ekd2grn1as****

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

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

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

  • Normal：正常。
  • FinancialLocked：欠费锁定。
  • SecurityLocked：因安全原因被锁定。
VirtualPhysicalConnectionIds.N String 否 pc-bp1mrgfbtmc9brre7****

共享专线实例ID。

支持输入多个实例ID，N的取值范围：1~20。

IsConfirmed Boolean 否 true

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

  • true：是。
  • false：否。
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。

MaxResults Integer 否 20

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

NextToken String 否 dd20****

是否拥有下一次查询的令牌（Token）。取值：

  • 第一次查询和没有下一次查询时，均无需填写。
  • 如果有下一次查询，取值为上一次API调用返回的NextToken值。
RegionId String 是 cn-shanghai

共享专线所属的地域ID。

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

Tags.N.Key String 否 FinanceDept

资源的标签键。最多支持输入20个标签键。一旦传入该值，则不允许为空字符串。

最多支持64个字符，必须以字母或中文开头，可包含数字、半角句号（.）、下划线（_）和短划线（-），不能以aliyun和acs:开头，不能包含http://或者https://。

Tags.N.Value String 否 FinanceJoshua

资源的标签值。最多支持输入20个标签值。一旦传入该值，可以为空字符串。

最多支持128个字符，必须以字母或中文开头，可包含数字、半角句号（.）、下划线（_）和短划线（-），不能以aliyun和acs:开头，不能包含http://或者https://。

返回数据

名称 类型 示例值 描述
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 2021-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千米）。
  • 40GBase-LR：四万兆单模光口。
  • 100GBase-LR：十万兆单模光口。
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）。取值：

  • 如果NextToken为空表示没有下一次查询。
  • 如果NextToken有返回值，该取值表示下一次查询开始的令牌。
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
&Tags=[{"Key":"FinanceDept","Value":"FinanceJoshua"}]
&公共请求参数

正常返回示例

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>2021-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" : "2021-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未找到。

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