全部產品
Search
文件中心

Express Connect:ModifyPhysicalConnectionAttribute - 修改物理專線的配置

更新時間:Apr 27, 2026

調用ModifyPhysicalConnectionAttribute介面修改物理專線的配置。

介面說明

調用該介面時,請注意:

  • 只有處於 InitialEnabledRejected 狀態的物理專線可以修改規格和冗餘專線 ID。

  • 無法修改處於 CanceledAllocatingAllocationFailedTerminated 狀態的物理專線。

  • 處於 Rejected 狀態的物理專線被修改後會進入 Initial 狀態。

調試

您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

當前API暫無授權資訊透出。

請求參數

名稱

類型

必填

描述

樣本值

RegionId

string

物理專線所在的地區 ID。

您可以通過調用 DescribeRegions 介面擷取地區 ID。

cn-shanghai

PhysicalConnectionId

string

物理專線的 ID。

pc-119mfjzm******

LineOperator

string

提供接入物理線路的電訊廠商,取值:

  • CT:中國電信

  • CU:中國聯通

  • CM:中國移動

  • CO:中國其他

  • Equinix:Equinix

  • Other:境外其他

CT

bandwidth

integer

物理專線接入介面頻寬,單位 Mbps,取值範圍:2~10240。

5

PeerLocation

string

本機資料中心的地理位置。

浙江省杭州市XX區XX街道XX號

PortType

string

物理專線接入連接埠類型,取值:

  • 100Base-T:百兆電口。

  • 1000Base-T(預設值):千兆電口。

  • 1000Base-LX:千兆單模光口(10 千米)。

  • 10GBase-T:萬兆電口 。

  • 10GBase-LR:萬兆單模光口(10 千米) 。

  • 40GBase-LR:四萬兆單模光口。

  • 100GBase-LR:十萬兆單模光口。

說明

40GBase-LR 和 100GBase-LR 需要根據實際後台連接埠水位情況進行建立,具體水位情況請聯絡商務經理。

1000Base-LX

RedundantPhysicalConnectionId

string

冗餘物理專線的 ID,該專線的狀態必須為 AllocatedConfirmedEnabled

pc-119mfjzm7

Description

string

物理專線的描述資訊。

長度為 2~256 個字元,必須以字母或中文開頭,但不能以http:// https://開頭。

物理專線的描述資訊

Name

string

物理專線的名稱。

長度為 2~128 個字元,必須以字母或中文開頭,可包含數字,半形句號(.),底線(_)和短劃線(-)。但不能以http:// https://開頭。

物理專線的名稱

ClientToken

string

用戶端 Token,用於保證請求的等冪性。

從您的用戶端產生一個參數值,確保不同請求間該參數值唯一。ClientToken 只支援 ASCII 字元。

說明

若您未指定,則系統自動使用 API 請求的 RequestId 作為 ClientToken 標識。每次 API 請求的 RequestId 不一樣。

efefe566754h

ClientToken

string

用戶端 Token,用於保證請求的等冪性。

從您的用戶端產生一個參數值,確保不同請求間該參數值唯一。ClientToken 只支援 ASCII 字元。

說明

若您未指定,則系統自動使用 API 請求的 RequestId 作為 ClientToken 標識。每次 API 請求的 RequestId 不一樣。

efefe566754h

CircuitCode

string

電訊廠商為物理專線提供的電路編碼。

longtel001

返回參數

名稱

類型

描述

樣本值

object

RequestId

string

請求 ID。

013EE132-A109-4247-91B0-099A8FF49AD7

樣本

正常返回樣本

JSON格式

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

錯誤碼

HTTP status code

錯誤碼

錯誤資訊

描述

400 InvalidLineOperator.Malformd The LineOperator provided was invalid.
400 InvalidPeerLocation.Malformd The PeerLocation provided was invalid.
400 InvalidPortType.Malformd The PortType provided was invalid.
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.
400 InvalidPhysicalConnectionOperator.Malformed Specified PhysicalConnection Operator is not valid. 專線的操作無效
400 InvalidPhysicalConnectionBandwidth.Malformed Specified PhysicalConnection Bandwidth is not valid. 專線綁定的頻寬值無效
400 InvalidDescription.Malformed The specified Description is not valid. 參數Description值不合法
400 OperationDenied.VPconn The operation is not allowed because of VPconn. Vpconn類型不支援此操作。
404 InvalidRegionId.NotFound The RegionId provided does not exist in our records. 指定的RegionId不存在
404 InvalidPhysicalConnectionId.NotFound The PhysicalConnectionId provided does not exist in our records.

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊,參考變更詳情