调用ModifyDirectConnectConnectionAttributes修改指定物理专线的名称、描述和带宽等相关信息。

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

下方仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

Action String 必选示例值：ModifyDirectConnectConnectionAttributes

接口名称。当前 API 的名称为 ModifyDirectConnectConnectionAttributes。

Version String 必选示例值：2020-04-01

接口版本。当前 API 的版本为 2020-04-01。

DirectConnectConnectionId String 必选示例值：dcc-7qthudw0ll6jmc****

待修改信息的物理专线的ID。

您可调用DescribeDirectConnectConnections接口，查询物理专线的ID。

DirectConnectConnectionName String 可选示例值：dcc-name

物理专线的名称。

以中文、字母、数字开头，只能包含中文、字母、数字、点号（.）、空格（）、下划线（_）、中划线（-）、等号（=）、英文逗号（,）、中文逗号（，）、中文句号（。）。

长度限制为1 ~ 128个字符。

不更改该参数时，保持原有配置，表示不修改物理专线的名称。

Description String 可选示例值：This is a sample description

物理专线的描述信息。

必须以字母或中文开头，可包含数字、英文逗号（,）、点号（.）、下划线（_）、空格（）、等号（=）、短横线（-）、中文逗号（，）、中文句号（。）。

长度限制为0 ~ 255个字符。

不更改该参数时，保持原有配置，表示不修改物理专线的描述。

CustomerName String 可选示例值：韩*梅

专线联系人姓名。

CustomerContactPhone String 可选示例值：185****2333

专线联系人联系电话。

CustomerContactEmail String 可选示例值：exampletest@163.com

专线联系人联系邮箱。

Bandwidth Integer 可选示例值：1000

物理专线的带宽，单位：Mbps。不更改该参数时，保持原有配置。

1000Base-T规格取值范围：1 ~ 1000

10GBase-T规格取值范围：1 ~ 10000

1000Base规格取值范围：1 ~ 1000

10GBase规格取值范围：1 ~ 10000

40GBase规格取值范围：1 ~ 40000

100GBase规格取值范围：1 ~ 100000

MacSecEncryptionMode String 可选示例值：no_encrypt

Macsec的加密模式。不更改该参数时，保持原有配置，表示不修改Macsec的加密模式。

no_encrypt：不加密。

should_encrypt：条件加密模式。

must_encrypt：强制加密模式。

返回参数

本接口无特有的返回参数。更多信息请见返回结构。

请求示例

返回示例

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。

状态码	错误码	错误信息	说明
400	InvalidName.Malformed	The specified name is malformed. Ensure the maximum length of name is 128.	指定的名称格式不合法。名称长度不能超过128个字符。
400	InvalidName.Malformed	The specified name is malformed.	指定的名称格式不合法。请修复名称格式后重试。
400	InvalidDescription.Malformed	The specified description is malformed. Ensure the maximum length of description is 255.	指定的描述格式不合法。描述长度不能超过255个字符。
400	InvalidDirectConnectConnection.InvalidStatus	The specified direct connect connection is not in the correct status for the request.	指定的物理专线所处的状态无法响应该请求。
400	InvalidDescription.Malformed	The specified description is malformed.	指定的描述格式不合法。请修复描述格式后重试。
400	InvalidDirectConnectConnection.CustomerContactPhoneMalformed	The specified customer contact phone is malformed.	指定的联系人手机格式不合法。
400	InvalidDirectConnectConnection.CustomerContactEmailMalformed	The specified customer contact email is malformed.	指定的联系人邮箱格式不合法。
400	InvalidDirectConnectConnection.CustomerNameMalformed	The specified customer name is malformed.	指定的联系人姓名格式不合法。
400	InvalidDirectConnectConnection.BandwidthInsufficientForSharedConnection	The specified direct connect connection bandwidth is insufficient. It must be greater than or equal to the allocated shared connection bandwidth.	指定的物理专线带宽值不足，必须大于或等于已分配的共享专线带宽值。
400	InvalidDirectConnectConnection.BandwidthInsufficientForVirtualInterface	The specified direct connect connection bandwidth is insufficient. It must be greater than or equal to the maximum bandwidth limit of the associated virtual interface.	指定的物理专线带宽值不足，必须大于或等于关联虚拟接口的最大带宽限速值。
400	InvalidDirectConnectConnection.BandwidthMalformed	The specified bandwidth is malformed.	指定的带宽不合法。
400	InvalidDirectConnectConnection.SharedConnectionInModification	The specified direct connect connection has a shared connection in the process of modification. It is not supported to modify the bandwidth.	指定的物理专线存在变配中的共享专线，不支持修改带宽值。
403	Forbidden	Operation forbidden in direct connect	不支持该操作。
404	InvalidDirectConnectConnection.NotFound	The specified direct connect connection does not exist.	指定的物理专线不存在。

专线连接