啟用處於 Confirmed 狀態的實體專線,啟用完成後實體專線進入 Enabled 狀態。
介面說明
呼叫此介面時,請注意:
僅允許啟用處於 Confirmed 狀態的實體專線,啟用完成後實體專線進入 Enabled 狀態。到達 Confirmed 狀態需依次完成:CreatePhysicalConnection 建立專線(Initial → Allocating)、資源分配完成進入 Allocated 狀態、施工完成後呼叫 ConfirmPhysicalConnection 確認(Allocated → Confirmed)。
Confirmed → Enabled 之間存在計費啟用環節。預設情況下(不傳 ByPassSp 或 ByPassSp=false),呼叫此介面時系統會自動向銷售計費系統建立計費訂單,訂單建立成功後才會啟用專線;如需跳過計費訂單流程直接啟用,可設定 ByPassSp=true,但此功能僅對白名單帳號開放(詳見 ByPassSp 參數說明)。
EnablePhysicalConnection 介面屬於非同步介面,即系統會回傳成功,但該實體專線尚未啟用完成,系統背景的啟用任務仍在進行。您可以呼叫 DescribePhysicalConnections 查詢實體專線的啟用狀態。
EnablePhysicalConnection 介面不支援並行啟用同一個處於 Confirmed 狀態的實體專線,並行呼叫將回傳錯誤。 若實體專線已處於 Enabled 狀態,重複呼叫此介面將直接回傳成功(冪等)。
調試
您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。
調試
授權資訊
|
操作 |
存取層級 |
資源類型 |
條件關鍵字 |
關聯操作 |
|
vpc:EnablePhysicalConnection |
update |
*PhysicalConnection
|
無 | 無 |
請求參數
|
名稱 |
類型 |
必填 |
描述 |
樣本值 |
| RegionId |
string |
是 |
實體專線所在的地域。 您可以透過呼叫 DescribeRegions 介面取得地域 ID。 |
cn-shanghai |
| PhysicalConnectionId |
string |
是 |
實體專線的 ID。 |
pc-2zeoaxkq3x**** |
| ClientToken |
string |
否 |
用戶端 token,用於保證請求的冪等性。 由用戶端產生此參數值,要保證在不同請求間唯一,最大值不超過 64 個 ASCII 字元。 |
02fb3da4-130e-11e9-8e44-0016e04115b |
| ByPassSp |
boolean |
否 |
是否跳過 SP(銷售計費系統)計費訂單流程直接啟用實體專線。取值:
|
false |
返回參數
|
名稱 |
類型 |
描述 |
樣本值 |
|
object |
|||
| RequestId |
string |
請求 ID。 |
20365164-5b0d-460a-83c2-2189972b3349 |
樣本
正常返回樣本
JSON格式
{
"RequestId": "20365164-5b0d-460a-83c2-2189972b3349"
}
錯誤碼
|
HTTP status code |
錯誤碼 |
錯誤資訊 |
描述 |
|---|---|---|---|
| 400 | Forbidden.NotAllowedInState | The request does not allow in this state. | |
| 400 | INSTANCE.STATUS.NOT.ALLOW | Instance status not allow | 執行個體狀態不允許。 |
| 400 | ALIUID.NOT.ALLOW.WITHOUT.SP | AliUid not allow direct enable physical connection | AliUid 不允許直接啟用實體連接埠。 |
| 400 | ACCESS.DEVICE.NOT.ALLOW.WITHOUT.SP | Access device not allow direct enable physical connection | 接入裝置不允許直接啟用實體連接埠。 |
| 404 | InvalidRegionId.NotFound | The RegionId provided does not exist in our records. | |
| 404 | InvalidPhysicalConnectionId.NotFound | The PhysicalConnectionId provided does not exist in our records. |
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊,參考變更詳情。