调用ModifyPhysicalConnectionAttribute接口修改物理专线的配置。
调用该接口时,请注意:
- 只有处于Initial或Rejected状态的物理专线可以修改规格和冗余专线ID。
- 无法修改处于Canceled、Allocating、AllocationFailed和Terminated状态的物理专线。
- 处于Rejected状态的物理专线被修改后会进入Initial状态。
调试
前往【API Explorer】在线调试,API Explorer 提供在线调用 API、动态生成 SDK Example 代码和快速检索接口等能力,能显著降低使用云 API 的难度,强烈推荐使用。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | ModifyPhysicalConnectionAttribute | 要执行的操作。 取值: ModifyPhysicalConnectionAttribute。 |
PhysicalConnectionId | String | 是 | pc-119mfjzm7 | 物理专线的ID。 |
RegionId | String | 是 | cn-shanghai | 物理专线所在的地域。 您可以通过调用DescribeRegions接口获取地域ID。 |
CircuitCode | String | 否 | longtel001 | 运营商的为物理专线提供的电路编码。 |
ClientToken | String | 否 | efefe566754h | 客户端token,用于保证请求的幂等性。 由客户端生成该参数值,要保证在不同请求间唯一,最大不值过64个 ASCII 字符。 |
Description | String | 否 | 物理专线的描述信息 | 物理专线的描述信息。 长度为 2-256个字符,必须以字母或中文开头,但不能以 |
LineOperator | String | 否 | CT | 提供接入物理线路的运营商,取值:
|
Name | String | 否 | 物理专线的名称 | 物理专线的名称。 长度为 2-128个字符,必须以字母或中文开头,可包含数字,点号(.),下划线(_)和短横线(-)。但不能以 |
PeerLocation | String | 否 | 浙江省---vfjdbg_21e | 本地数据中心的地理位置。 |
PortType | String | 否 | E1 - 2M | 物理专线接入端口类型,取值:
|
RedundantPhysicalConnectionId | String | 否 | pc-119mfjzm7 | 冗余物理专线的ID,该专线的状态必须为Allocated、Confirmed或Enabled。 |
bandwidth | Integer | 否 | 5 | 物理专线接入接口带宽,单位Mbps,取值范围:2-10240。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
RequestId | String | 013EE132-A109-4247-91B0-099A8FF49AD7 | 请求ID。 |
示例
请求示例
https://vpc.aliyuncs.com/?Action=ModifyPhysicalConnectionAttribute &PhysicalConnectionId=pc-119mfjzm7 &RegionId=cn-shanghai &<公共请求参数>
正常返回示例
XML
格式
<ModifyPhysicalConnectionAttributeResponse> <RequestId>8A6A5EC5-6F6C-4906-9689-56ACE58A13E0"</RequestId> </ModifyPhysicalConnectionAttributeResponse>
JSON
格式
{ "RequestId":"8A6A5EC5-6F6C-4906-9689-56ACE58A13E0" }
错误码
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
404 | InvalidPhysicalConnectionId.NotFound | The PhysicalConnectionId provided does not exist in our records. | 该物理专线不存在。 |
400 | InvalidLineOperator.Malformd | The LineOperator provided was invalid. | 参数LineOperator的值不合法。 |
400 | InvalidPeerLocation.Malformd | The PeerLocation provided was invalid. | 参数PeerLocation的值不合法。 |
400 | InvalidPortType.Malformd | The PortType provided was invalid. | 该端口类型不合法。 |
400 | InvalidDescription.Malformed | The specifid ?Description? is not valid. | 指定的资源描述格式不合法。长度为2-256个字符,不能以 http:// 和 https:// 开头。 |
400 | InvalidName.Malformed | The specified ?Name? is not valid. | 该名称格式不合法。 |
400 | InvalidStatus | invalid physical connection status. | 物理专线状态不合法。 |
400 | InvalidBandwidth | invalid physical connection banwidth. | 物理专线的带宽不合法。 |
400 | InvalidRedundantPhysicalConnection | redundant physical connection doesn't belong to current user. | 该冗余物理专线不属于您的账号。 |
400 | InvalidRedundantPhysicalConnectionStatus | invalid redundant physical connection status. | 冗余物理专线状态不合法。 |
400 | InvalidCircuitCode.Malformed | circuitCode is illegal. | 该CircuitCode不合法。 |
访问错误中心查看更多错误码。