調用CreatePhysicalConnection接口申請物理專線接入。
接口說明
您可以申請獨享物理專線，也可以為租戶申請共享物理專線。 申請完成后，物理專線的狀態為 Initial，請聯系運營商進行施工。
調用該接口時，請注意：
-
申請物理專線時，處于 Enabled 狀態之外的物理專線不得超過 5 條。
-
若賬號下存在欠費狀態的物理專線，則不能再申請物理專線。
調試
您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。
授權信息
下表是API對應的授權信息，可以在RAM權限策略語句的Action元素中使用，用來給RAM用戶或RAM角色授予調用此API的權限。具體說明如下：
- 操作：是指具體的權限點。
- 訪問級別：是指每個操作的訪問級別，取值為寫入（Write）、讀?。≧ead）或列出（List）。
- 資源類型：是指操作中支持授權的資源類型。具體說明如下：
- 對于必選的資源類型，用背景高亮的方式表示。
- 對于不支持資源級授權的操作，用
全部資源表示。
- 條件關鍵字：是指云產品自身定義的條件關鍵字。
- 關聯操作：是指成功執行操作所需要的其他權限。操作者必須同時具備關聯操作的權限，操作才能成功。
| 操作 | 訪問級別 | 資源類型 | 條件關鍵字 | 關聯操作 |
|---|---|---|---|---|
| vpc:CreatePhysicalConnection | create | *PhysicalConnection acs:vpc:{#regionId}:{#accountId}:physicalconnection/* |
| 無 |
請求參數
| 名稱 | 類型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| RegionId | string | 是 | 物理專線所在的地域 ID。 您可以通過調用 DescribeRegions 接口獲取地域 ID。 | cn-shanghai |
| AccessPointId | string | 是 | 物理專線所在的接入點 ID。 | ap-cn-beijing-ft-A |
| Type | string | 否 | 物理專線的類型。默認值為 VPC。 | VPC |
| LineOperator | string | 是 | 提供接入物理線路的運營商。取值：
| CT |
| bandwidth | integer | 否 | 共享專線的帶寬。單位：Mbps。 取值分別為 50、100、200、300、400、500、1000、2000、4000、5000、8000、10000。 | 50 |
| PeerLocation | string | 否 | 本地數據中心的地理位置。 | XX街道 |
| PortType | string | 否 | 物理專線接入端口類型。取值：
說明
40GBase-LR 和 100GBase-LR 需要根據實際后臺端口水位情況進行創建，具體水位情況請聯系商務經理。
| 1000Base-T |
| RedundantPhysicalConnectionId | string | 否 | 冗余物理專線的實例 ID。該專線的狀態必須為 Allocated、Confirmed 或 Enabled。 | pc-119mfjzm**** |
| Description | string | 否 | 物理專線的描述信息。 長度為 2～256 個字符，必須以字母或中文開頭，但不能以 | description |
| Name | string | 否 | 物理專線的名稱。 長度為 2～128 個字符，必須以字母或中文開頭，可包含數字、下劃線（_）和短劃線（-），但不能以 | test |
| CircuitCode | string | 否 | 運營商為物理專線提供的電路編碼。 | longtel001 |
| ClientToken | string | 是 | 客戶端 Token，用于保證請求的冪等性。 從您的客戶端生成一個參數值，確保不同請求間該參數值唯一。ClientToken 只支持 ASCII 字符。 說明
若您未指定，則系統自動使用 API 請求的 RequestId 作為 ClientToken 標識。每次 API 請求的 RequestId 不一樣。
| 123e4567-e89b-12d3-a456-42665544**** |
| ResourceGroupId | string | 否 | 物理專線所在的資源組 ID。 | rg-acfmoiyermp**** |
| Tag | array<object> | 否 | 標簽列表。 | |
| object | 否 | 標簽列表。 | ||
| Key | string | 否 | 資源的標簽鍵。最多支持輸入 20 個標簽鍵。如需傳入該值，則不能輸入空字符串。 最多支持 128 個字符，不能以 | FinanceDept |
| Value | string | 否 | 資源的標簽值。最多支持輸入 20 個標簽值。如需傳入該值，可以輸入空字符串。 最多支持 128 個字符，不能以 | FinanceJoshua |
| DeviceAdvancedCapacity | array | 否 | 設備高級能力列表。 | |
| string | 否 | 設備高級能力列表，取值如下：
| CENv6 |
返回參數
示例
正常返回示例
JSON格式
{
"PhysicalConnectionId": "pc-bp1ciz7ekd2grn1as****",
"RequestId": "8A6A5EC5-6F6C-4906-9689-56ACE58A13E0"
}錯誤碼
| HTTP status code | 錯誤碼 | 錯誤信息 | 描述 |
|---|---|---|---|
| 400 | Invalid.Status | The device or interface status invalid, or has been used.. | 參數Status無效 |
| 400 | InvalidType.Malformd | The Type provided was invalid. | 參數Type的值不合法。 |
| 400 | InvalidPeerLocation.Malformd | The PeerLocation provided was invalid. | 參數PeerLocation的值不合法。 |
| 400 | InvalidLineOperator.Malformd | The LineOperator provided was invalid. | 參數LineOperator的值不合法。 |
| 400 | InvalidPortType.Malformd | The PortType provided was invalid. | 該端口類型不合法。 |
| 400 | InvalidDescription.Malformed | The specifid ?Description? is not valid. | 指定的資源描述格式不合法。長度為2～256個字符，不能以http://和https://開頭。 |
| 400 | InvalidRedundantPhysicalConnectionId.NotFound | The RedundantPhysicalConnectionId does not found. | 冗余物理專線不存在。 |
| 400 | InvalidName.Malformed | The specified ?Name? is not valid. | 該名稱格式不合法。 |
| 400 | QuotaExceeded.pConnPerAP | Physical connection count per ap quota exceed. | 超過接入點的物理專線配額。 |
| 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不合法。 |
| 400 | QuotaExceeded.freePconnPerAP | free physical connections count excceeded. | 超過物理專線配額。 |
| 400 | InvalidPhysicalConnectionOperator.Malformed | Specified PhysicalConnection Operator is not valid. | 專線的操作無效 |
| 400 | InvalidPhysicalConnectionPortType.Malformed | Specified PhysicalConnection PortType is not valid. | 專線的端口類型無效 |
| 400 | InvalidPhysicalConnectionBandwidth.Malformed | Specified PhysicalConnection Bandwidth is not valid. | 專線綁定的帶寬值無效 |
| 400 | IllegalParam.ClientToken | Token verify failed because client token length too long. | ClientToken參數不合法 |
| 400 | InvalidPortType.NotFound | Specified port type is not found. | 指定規格端口已無庫存。 |
| 400 | OperationFailed.PconnTrafficNotEnable | The operation is failed because of PconnTrafficNotEnable. | 操作失敗，因為出方向流量未開通。 |
| 400 | InvalidAccessPointId.NotEnabled | Invalid access point status. | 當前接入點暫無足夠資源可支持接入，請聯系您的商務經理 |
| 400 | ResourceNotFound.AccessPointId | The specified resource of access point id is not found. | 當前接入點信息不存在，請核對后重試。 |
| 404 | InvalidPortType.NotFound | There are no resources with the portType. | 沒有該端口類型 |
訪問錯誤中心查看更多錯誤碼。
變更歷史
| 變更時間 | 變更內容概要 | 操作 |
|---|---|---|
| 2024-07-15 | OpenAPI 錯誤碼發生變更 | 查看變更詳情 |
| 2024-06-28 | OpenAPI 錯誤碼發生變更 | 查看變更詳情 |
| 2023-10-12 | OpenAPI 描述信息更新、OpenAPI 錯誤碼發生變更、OpenAPI 入參發生變更 | 查看變更詳情 |
| 2023-03-14 | OpenAPI 錯誤碼發生變更、OpenAPI 入參發生變更 | 查看變更詳情 |
| 2021-11-25 | OpenAPI 錯誤碼發生變更 | 查看變更詳情 |