调用ModifyPhysicalConnectionAttribute接口修改物理专线的配置。

限制说明

调用该接口时，请注意：

  • 只有处于Initial、Enabled和Rejected状态的物理专线可以修改规格和冗余专线ID。
  • 无法修改处于Canceled、Allocating、AllocationFailed和Terminated状态的物理专线。
  • 处于Rejected状态的物理专线被修改后会进入Initial状态。

调试

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

请求参数

名称 类型 是否必选 示例值 描述
RegionId String 是 cn-shanghai

物理专线所在的地域ID。

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

PhysicalConnectionId String 是 pc-119mfjzm******

物理专线的ID。

LineOperator String 否 CT

提供接入物理线路的运营商，取值：

  • CT：中国电信
  • CU：中国联通
  • CM：中国移动
  • CO：中国其他
  • Equinix：Equinix
  • Other：境外其他
bandwidth Integer 否 5

物理专线接入接口带宽，单位Mbps，取值范围：2~10240。
PeerLocation String 否 浙江省杭州市XX区XX街道XX号

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

PortType String 否 1000Base-LX

物理专线接入端口类型，取值：

  • 100Base-T：百兆电口。
  • 1000Base-T（默认值）：千兆电口。
  • 1000Base-LX：千兆单模光口（10千米）。
  • 10GBase-T：万兆电口 。
  • 10GBase-LR：万兆单模光口（10千米） 。
  • 40GBase-LR：四万兆单模光口。
  • 100GBase-LR：十万兆单模光口。
说明 40GBase-LR和100GBase-LR需要根据实际后台端口水位情况进行创建，具体水位情况请联系商务经理。
RedundantPhysicalConnectionId String 否 pc-119mfjzm7

冗余物理专线的ID，该专线的状态必须为Allocated、Confirmed或Enabled。

Description String 否 物理专线的描述信息

物理专线的描述信息。

长度为 2~256个字符，必须以字母或中文开头，但不能以http:// 或https://开头。

Name String 否 物理专线的名称

物理专线的名称。

长度为 2~128个字符，必须以字母或中文开头，可包含数字，半角句号（.），下划线（_）和短划线（-）。但不能以http:// 或https://开头。

ClientToken String 否 efefe566754h

客户端Token，用于保证请求的幂等性。 由客户端生成该参数值，要保证在不同请求间唯一，最大不值过64个 ASCII 字符。

Action String 是 ModifyPhysicalConnectionAttribute

系统规定参数。取值：ModifyPhysicalConnectionAttribute。

CircuitCode String 否 longtel001

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

返回数据

名称 类型 示例值 描述
RequestId String 013EE132-A109-4247-91B0-099A8FF49AD7

请求ID。

示例

请求示例

http(s)://[Endpoint]/?RegionId=cn-shanghai
&PhysicalConnectionId=pc-119mfjzm******
&LineOperator=CT
&bandwidth=5
&PeerLocation=浙江省杭州市XX区XX街道XX号
&PortType=1000Base-LX
&RedundantPhysicalConnectionId=pc-119mfjzm7
&Description=物理专线的描述信息
&Name=物理专线的名称
&ClientToken=efefe566754h
&Action=ModifyPhysicalConnectionAttribute
&CircuitCode=longtel001
&公共请求参数

正常返回示例

XML格式 

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

<ModifyPhysicalConnectionAttributeResponse>
    <RequestId>013EE132-A109-4247-91B0-099A8FF49AD7</RequestId>
</ModifyPhysicalConnectionAttributeResponse>

JSON格式 

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

{
  "RequestId" : "013EE132-A109-4247-91B0-099A8FF49AD7"
}

错误码

HttpCode 错误码 错误信息 描述
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不合法。
404 InvalidPhysicalConnectionId.NotFound The PhysicalConnectionId provided does not exist in our records. 该物理专线不存在。

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