調(diào)用ModifyPhysicalConnectionAttribute接口修改物理專線的配置。
接口說明
調(diào)用該接口時，請注意：
-
只有處于 Initial、Enabled 和 Rejected 狀態(tài)的物理專線可以修改規(guī)格和冗余專線 ID。
-
無法修改處于 Canceled、Allocating、AllocationFailed 和 Terminated 狀態(tài)的物理專線。
-
處于 Rejected 狀態(tài)的物理專線被修改后會進入 Initial 狀態(tài)。
調(diào)試
您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。
授權(quán)信息
下表是API對應的授權(quán)信息，可以在RAM權(quán)限策略語句的Action元素中使用，用來給RAM用戶或RAM角色授予調(diào)用此API的權(quán)限。具體說明如下：
- 操作：是指具體的權(quán)限點。
- 訪問級別：是指每個操作的訪問級別，取值為寫入（Write）、讀取（Read）或列出（List）。
- 資源類型：是指操作中支持授權(quán)的資源類型。具體說明如下：
- 對于必選的資源類型，用背景高亮的方式表示。
- 對于不支持資源級授權(quán)的操作，用
全部資源表示。
- 條件關鍵字：是指云產(chǎn)品自身定義的條件關鍵字。
- 關聯(lián)操作：是指成功執(zhí)行操作所需要的其他權(quán)限。操作者必須同時具備關聯(lián)操作的權(quán)限，操作才能成功。
| 操作 | 訪問級別 | 資源類型 | 條件關鍵字 | 關聯(lián)操作 |
|---|---|---|---|---|
| vpc:ModifyPhysicalConnectionAttribute | update | *PhysicalConnection acs:vpc:{#regionId}:{#accountId}:physicalconnection/{#PhysicalConnectionId} |
| 無 |
請求參數(shù)
| 名稱 | 類型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| RegionId | string | 是 | 物理專線所在的地域 ID。 您可以通過調(diào)用 DescribeRegions 接口獲取地域 ID。 | cn-shanghai |
| PhysicalConnectionId | string | 是 | 物理專線的 ID。 | pc-119mfjzm****** |
| LineOperator | string | 否 | 提供接入物理線路的運營商，取值：
| CT |
| bandwidth | integer | 否 | 物理專線接入接口帶寬，單位 Mbps，取值范圍：2~10240。 | 5 |
| PeerLocation | string | 否 | 本地數(shù)據(jù)中心的地理位置。 | 浙江省杭州市XX區(qū)XX街道XX號 |
| PortType | string | 否 | 物理專線接入端口類型，取值：
說明
40GBase-LR 和 100GBase-LR 需要根據(jù)實際后臺端口水位情況進行創(chuàng)建，具體水位情況請聯(lián)系商務經(jīng)理。
| 1000Base-LX |
| RedundantPhysicalConnectionId | string | 否 | 冗余物理專線的 ID，該專線的狀態(tài)必須為 Allocated、Confirmed 或 Enabled。 | pc-119mfjzm7 |
| Description | string | 否 | 物理專線的描述信息。 長度為 2~256 個字符，必須以字母或中文開頭，但不能以 | 物理專線的描述信息 |
| Name | string | 否 | 物理專線的名稱。 長度為 2~128 個字符，必須以字母或中文開頭，可包含數(shù)字，半角句號（.），下劃線（_）和短劃線（-）。但不能以 | 物理專線的名稱 |
| ClientToken | string | 否 | 客戶端 Token，用于保證請求的冪等性。 從您的客戶端生成一個參數(shù)值，確保不同請求間該參數(shù)值唯一。ClientToken 只支持 ASCII 字符。 說明
若您未指定，則系統(tǒng)自動使用 API 請求的 RequestId 作為 ClientToken 標識。每次 API 請求的 RequestId 不一樣。
| efefe566754h |
| CircuitCode | string | 否 | 運營商為物理專線提供的電路編碼。 | longtel001 |
返回參數(shù)
示例
正常返回示例
JSON格式
{
"RequestId": "013EE132-A109-4247-91B0-099A8FF49AD7"
}錯誤碼
| HTTP status code | 錯誤碼 | 錯誤信息 | 描述 |
|---|---|---|---|
| 400 | InvalidLineOperator.Malformd | The LineOperator provided was invalid. | 參數(shù)LineOperator的值不合法。 |
| 400 | InvalidPeerLocation.Malformd | The PeerLocation provided was invalid. | 參數(shù)PeerLocation的值不合法。 |
| 400 | InvalidPortType.Malformd | The PortType provided was invalid. | 該端口類型不合法。 |
| 400 | InvalidName.Malformed | The specified ?Name? is not valid. | 該名稱格式不合法。 |
| 400 | InvalidStatus | invalid physical connection status. | 物理專線狀態(tài)不合法。 |
| 400 | InvalidBandwidth | invalid physical connection banwidth. | 物理專線的帶寬不合法。 |
| 400 | InvalidRedundantPhysicalConnection | redundant physical connection doesn't belong to current user. | 該冗余物理專線不屬于您的賬號。 |
| 400 | InvalidRedundantPhysicalConnectionStatus | invalid redundant physical connection status. | 冗余物理專線狀態(tài)不合法。 |
| 400 | InvalidCircuitCode.Malformed | circuitCode is illegal. | 該CircuitCode不合法。 |
| 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. | 參數(shù)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不存在。請檢查該參數(shù)是否正確。 |
| 404 | InvalidPhysicalConnectionId.NotFound | The PhysicalConnectionId provided does not exist in our records. | 該物理專線不存在。 |
訪問錯誤中心查看更多錯誤碼。
變更歷史
| 變更時間 | 變更內(nèi)容概要 | 操作 |
|---|---|---|
| 2024-06-13 | OpenAPI 錯誤碼發(fā)生變更 | 查看變更詳情 |
| 2024-02-28 | OpenAPI 描述信息更新、OpenAPI 錯誤碼發(fā)生變更 | 查看變更詳情 |