调用CreateVirtualPhysicalConnection接口创建共享专线。
使用说明
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
| 名称 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
| Action | String | 是 | CreateVirtualPhysicalConnection | 要执行的操作。取值:CreateVirtualPhysicalConnection。 |
| OrderMode | String | 是 | PayByVirtualPhysicalConnectionOwner | 共享专线的付费方式。取值:
|
| VlanId | Long | 是 | 4 | 共享专线的VLAN ID。取值范围:0~2999。
|
| Spec | String | 是 | 50M | 共享专线的带宽值。 取值:50M、100M、200M、300M、400M、500M、1G、2G、5G、8G、10G。 说明 2G、5G、8G、10G的带宽值默认不开放,如需使用,请联系您的客户经理申请。 单位:M表示Mbps,G表示Gbps。 |
| VpconnAliUid | Long | 是 | 1210123456123456 | 租户的阿里云账号(主账号)ID。 |
| PhysicalConnectionId | String | 是 | pc-bp1ciz7ekd2grn1as**** | 共享专线关联的物理专线ID。 |
| Name | String | 否 | nametest | 共享专线的名称。 长度为2~128个字符,必须以字母或中文开头,可包含数字、下划线(_)和短划线(-),但不能以 |
| Token | String | 否 | CBCE910E-D396-4944-8**** | 客户端Token,用于保证请求的幂等性。 从您的客户端生成一个参数值,确保不同请求间该参数值唯一。ClientToken只支持ASCII字符。 说明 若您未指定,则系统自动使用API请求的RequestId作为ClientToken标识。每次API请求的RequestId不一样。 |
| DryRun | Boolean | 否 | false | 是否只预检此次请求。取值:
|
| Description | String | 否 | desctest | 共享专线的描述信息。 长度为2~256个字符,必须以字母或中文开头,但不能以 |
| RegionId | String | 是 | cn-hangzhou | 共享专线所属的地域ID。 您可以通过调用DescribeRegions接口获取地域ID。 |
| ResourceGroupId | String | 否 | rg-aekzjty2chzuqky | 共享专线所属的资源组ID。 |
| Tag.N.Key | String | 否 | FinanceDept | 资源的标签键。最多支持输入20个标签键。一旦传入该值,则不允许为空字符串。 最多支持64个字符,必须以字母或中文开头,可包含数字、半角句号(.)、下划线(_)和短划线(-),不能以 |
| Tag.N.Value | String | 否 | FinanceJoshua | 资源的标签值。最多支持输入20个标签值。一旦传入该值,可以为空字符串。 最多支持128个字符,必须以字母或中文开头,可包含数字、半角句号(.)、下划线(_)和短划线(-),不能以 |
返回数据
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| RequestId | String | CD14EA74-E9C3-59A9-942A-DFEC7E12818D | 请求ID。 |
| VirtualPhysicalConnection | String | pc-bp1mrgfbtmc9brre7**** | 共享专线实例ID。 |
示例
请求示例
http(s)://[Endpoint]/?Action=CreateVirtualPhysicalConnection
&OrderMode=PayByVirtualPhysicalConnectionOwner
&VlanId=4
&Spec=50M
&VpconnAliUid=1210123456123456
&PhysicalConnectionId=pc-bp1ciz7ekd2grn1as****
&Name=nametest
&Token=CBCE910E-D396-4944-8****
&DryRun=false
&Description=desctest
&RegionId=cn-hangzhou
&ResourceGroupId=rg-aekzjty2chzuqky
&Tag=[{"Key":"FinanceDept","Value":"FinanceJoshua"}]
&公共请求参数
正常返回示例
XML格式
HTTP/1.1 200 OK
Content-Type:application/xml
<CreateVirtualPhysicalConnectionResponse>
<RequestId>CD14EA74-E9C3-59A9-942A-DFEC7E12818D</RequestId>
<VirtualPhysicalConnection>pc-bp1mrgfbtmc9brre7****</VirtualPhysicalConnection>
</CreateVirtualPhysicalConnectionResponse>
JSON格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "CD14EA74-E9C3-59A9-942A-DFEC7E12818D",
"VirtualPhysicalConnection" : "pc-bp1mrgfbtmc9brre7****"
}
错误码
| HttpCode | 错误码 | 错误信息 | 描述 |
|---|---|---|---|
| 400 | OperationFailed.VbrBindedPconn | The operation is failed because of VbrBindedPconn. | VBR已经VPCONN |
| 400 | IllegalParam.Bandwidth | The param of Bandwidth [%s] is illegal. | 传入的带宽不合法。 |
| 400 | ResourceNotFound.PhysicalConnectionId | The specified PhysicalConnectionId [%s] is not found. | PhysicalConnectionId未找到。 |
| 400 | OperationFailed.VPconnCreated | The operation is failed because of VPconnCreated. | 无法创建VPconn |
| 400 | MissingParam.Spec | The param of Spec is missing. | Spec参数缺失 |
| 400 | IllegalParam.Spec | The param of Spec is illegal. | Spec不合法 |
| 400 | IllegalParam.VlanId | The param of VlanId is illegal. | VlanId不合法 |
| 400 | InvalidPhysicalConnectionId.NotFound | The specified PhysicalConnectionId is not found. | 该物理专线ID不存在。 |
| 400 | MissingParameter | The input parameter 'PhysicalConnectionId' that is mandatory for processing this request is not supplied. | 必须指定参数PhysicalConnectionId。 |
| 400 | InvalidPhysicalConnectionId.NotEnabled | The specified PhysicalConnectionId is not in Enabled state. | 该物理专线当前未处于正常状态,请检查物理专线后再创建。 |
| 400 | InvalidVlanId.Malformed | The specified VlanId is not valid. | 参数VlanId的值不合法。 |
| 400 | InvalidName.Malformed | The specified Name is not valid. | 参数Name值不合法 |
| 400 | InvalidDescription.Malformed | The specifid Description is not valid. | 参数Description值不合法 |
| 400 | ResourceNotEnough.Bandwidth | The specified resource of Bandwidth is not enough. | 带宽资源不足 |
| 400 | IllegalParam.VpconnAliUid | The specified AliUid of Vpconn is illegal. | Vpconn的AliUid参数不合法 |
| 400 | IllegalParam.OrderMode | The param of OrderMode is illegal. | OrderMode参数非法 |
| 400 | OperationDenied.CreateVpconn | You are not allowed to create virtual physical connection. Please contact you CBM. | 无权限创建共享专线,请联系商务经理。 |
| 400 | Forbidden.VpconnAliUid | Vpconn UID is forbidden to belong to a RAM account or partner account. | 共享端口UID不能是RAM账号或者合作伙伴账号 |
| 400 | QuotaExceeded.VPCONN | The quota of VPCONN_COUNT_PER_PCONN is exceeded | 单根物理端口上创建的共享端口配额超限 |
访问错误中心查看更多错误码。