創(chuàng)建高可靠模式物理專線,以滿足您多線接入阿里云上業(yè)務(wù)的穩(wěn)定性以及多線路容災(zāi)后可避免因?yàn)閱尉€而導(dǎo)致的業(yè)務(wù)受損。
接口說明
您在購(gòu)買端口時(shí),可以選擇以下三種組合類型為您的業(yè)務(wù)或工作提供容災(zāi)能力。
-
最強(qiáng)容災(zāi)能力:您將申請(qǐng) 2 個(gè)接入點(diǎn)內(nèi)的資源,建立 4 條獨(dú)立的物理專線連接。對(duì)于最強(qiáng)容災(zāi)能力的 SLA 可用性指標(biāo)不低于 99.99%。
-
強(qiáng)大容災(zāi)能力:您將申請(qǐng) 2 個(gè)接入點(diǎn)內(nèi)的資源,建立 2 條獨(dú)立的物理專線連接。對(duì)于強(qiáng)大容災(zāi)能力的 SLA 可用性指標(biāo)不低于 99.95%。
-
開發(fā)和測(cè)試:您將申請(qǐng) 1 個(gè)接入點(diǎn)的資源,建立 2 條獨(dú)立的物理專線連接。
調(diào)試
您可以在OpenAPI Explorer中直接運(yùn)行該接口,免去您計(jì)算簽名的困擾。運(yùn)行成功后,OpenAPI Explorer可以自動(dòng)生成SDK代碼示例。
授權(quán)信息
下表是API對(duì)應(yīng)的授權(quán)信息,可以在RAM權(quán)限策略語句的Action
元素中使用,用來給RAM用戶或RAM角色授予調(diào)用此API的權(quán)限。具體說明如下:
- 操作:是指具體的權(quán)限點(diǎn)。
- 訪問級(jí)別:是指每個(gè)操作的訪問級(jí)別,取值為寫入(Write)、讀取(Read)或列出(List)。
- 資源類型:是指操作中支持授權(quán)的資源類型。具體說明如下:
- 對(duì)于必選的資源類型,用背景高亮的方式表示。
- 對(duì)于不支持資源級(jí)授權(quán)的操作,用
全部資源
表示。
- 條件關(guān)鍵字:是指云產(chǎn)品自身定義的條件關(guān)鍵字。
- 關(guān)聯(lián)操作:是指成功執(zhí)行操作所需要的其他權(quán)限。操作者必須同時(shí)具備關(guān)聯(lián)操作的權(quán)限,操作才能成功。
操作 | 訪問級(jí)別 | 資源類型 | 條件關(guān)鍵字 | 關(guān)聯(lián)操作 |
---|---|---|---|---|
vpc:CreateHighReliablePhysicalConnection | create | *全部資源 * |
| 無 |
請(qǐng)求參數(shù)
名稱 | 類型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
RegionId | string | 是 | 物理專線所在的地域。 您可以通過調(diào)用 DescribeRegions 接口獲取地域 ID。 | cn-shanghai |
ClientToken | string | 是 | 客戶端 Token,用于保證請(qǐng)求的冪等性。 從您的客戶端生成一個(gè)參數(shù)值,確保不同請(qǐng)求間該參數(shù)值唯一。ClientToken 只支持 ASCII 字符。 說明
若您未指定,則系統(tǒng)自動(dòng)使用 API 請(qǐng)求的 RequestId 作為 ClientToken 標(biāo)識(shí)。每次 API 請(qǐng)求的 RequestId 不一樣。
| 123e4567-e89b-12d3-a456-426655440000 |
ResourceGroupId | string | 否 | 物理專線所在的資源組 ID。 | rg-acfmxazb4p**** |
Tag | array<object> | 否 | 標(biāo)簽列表。 | |
object | 否 | 標(biāo)簽列表。 | ||
Key | string | 否 | 資源的標(biāo)簽鍵。最多支持輸入 20 個(gè)標(biāo)簽鍵。一旦傳入該值,則不允許為空字符串。 最多支持 64 個(gè)字符,必須以字母或中文開頭,可包含數(shù)字、半角句號(hào)(.)、下劃線(_)和短劃線(-),不能以 | FinanceDept |
Value | string | 否 | 資源的標(biāo)簽值。最多支持輸入 20 個(gè)標(biāo)簽值。一旦傳入該值,可以為空字符串。 最多支持 128 個(gè)字符,必須以字母或中文開頭,可包含數(shù)字、半角句號(hào)(.)、下劃線(_)和短劃線(-),不能以 | FinanceJoshua |
HighReliableType | string | 是 | 高可靠模式。取值:
| MultiApMultiDevice |
PortType | string | 是 | 物理專線接入端口類型。取值:
說明
40GBase-LR 和 100GBase-LR 需要根據(jù)實(shí)際后臺(tái)端口水位情況進(jìn)行創(chuàng)建,具體水位情況請(qǐng)聯(lián)系商務(wù)經(jīng)理。
| 1000Base-LX |
DeviceAdvancedCapacity | array | 否 | 設(shè)備高級(jí)能力。取值:
| |
string | 否 | 設(shè)備高級(jí)能力。取值:
| SubifRateLimit, DualStack | |
ApList | array<object> | 是 | 接入點(diǎn)列表 | |
object | 是 | 接入點(diǎn)列表 | ||
Name | string | 否 | 物理專線的名稱。 長(zhǎng)度為 2~128 個(gè)字符,必須以字母或中文開頭,可包含數(shù)字、下劃線(_)和短劃線(-),但不能以 | test |
Description | string | 否 | 物理專線的描述信息。 長(zhǎng)度為 2~256 個(gè)字符,必須以字母或中文開頭,但不能以 | description |
RegionId | string | 是 | 物理專線所在的地域 ID。 您可以通過調(diào)用 DescribeRegions 接口獲取地域 ID。 | cn-shanghai |
LineOperator | string | 是 | 提供接入物理線路的運(yùn)營(yíng)商。取值:
| CT |
AccessPointId | string | 是 | 物理專線所在的接入點(diǎn) ID。 說明
HighReliableType 為 MultiApMultiDevice 和 MultiApSingleDevice 的時(shí)候要求傳入兩個(gè)不同的接入點(diǎn),HighReliableType 為 SingleApMultiDevice 和 SingleApMultiConnection 的時(shí)候要求傳入一個(gè)接入點(diǎn)。
| ap-cn-beijing-ft-A |
PortNum | integer | 否 | 端口數(shù)量。僅在 HighReliableType 為 SingleApMultiConnection 的時(shí)候要求傳入,取值范圍為 2-16。 | 2 |
Type | string | 否 | 物理專線的類型。默認(rèn)值為 VPC。 | VPC |
Bandwidth | long | 否 | 共享專線的帶寬。單位:Mbps。 取值分別為 50、100、200、300、400、500、1000、2000、4000、5000、8000、10000。 | 50 |
PeerLocation | string | 否 | 本地?cái)?shù)據(jù)中心的地理位置。 | XX街道 |
CircuitCode | string | 否 | 運(yùn)營(yíng)商為物理專線提供的電路編碼。 | longtel001 |
DryRun | string | 否 | 是否只預(yù)檢此次請(qǐng)求。取值范圍:
| false |
AcceptLanguage | string | 否 | 返回結(jié)果顯示的語言。取值:
| zh-CN |
返回參數(shù)
示例
正常返回示例
JSON
格式
{
"PhysicalConnectionList": {
"physicalConnectionList": [
{
"InstanceId": "pc-j5e5qqo616p81ncsp****",
"RegionNo": "cn-shanghai"
}
]
},
"RequestId": "0ED8D006-F706-4D23-88ED-E11ED28DCAC0",
"ErrorInfoList": {
"errorInfoList": [
{
"ErrorCode": "pconn.high.reliable.dryrun.error.disable.outbound.data.transfer.billing",
"ErrorMessage": "pconn.high.reliable.dryrun.error.disable.outbound.data.transfer.billing",
"InstanceId": "pc-j5e5qqo616p81ncsp****"
}
]
}
}
錯(cuò)誤碼
HTTP status code | 錯(cuò)誤碼 | 錯(cuò)誤信息 | 描述 |
---|---|---|---|
400 | Invalid.Status | The device or interface status invalid, or has been used.. | 參數(shù)Status無效 |
400 | InvalidType.Malformd | The Type provided was invalid. | 參數(shù)Type的值不合法。 |
400 | InvalidPeerLocation.Malformd | The PeerLocation provided was invalid. | 參數(shù)PeerLocation的值不合法。 |
400 | InvalidLineOperator.Malformd | The LineOperator provided was invalid. | 參數(shù)LineOperator的值不合法。 |
400 | InvalidPortType.Malformd | The PortType provided was invalid. | 該端口類型不合法。 |
400 | InvalidDescription.Malformed | The specifid ?Description? is not valid. | 指定的資源描述格式不合法。長(zhǎng)度為2~256個(gè)字符,不能以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. | 超過接入點(diǎn)的物理專線配額。 |
400 | InvalidBandwidth | invalid physical connection banwidth. | 物理專線的帶寬不合法。 |
400 | InvalidRedundantPhysicalConnection | redundant physical connection doesn't belong to current user. | 該冗余物理專線不屬于您的賬號(hào)。 |
400 | InvalidRedundantPhysicalConnectionStatus | invalid redundant physical connection status. | 冗余物理專線狀態(tài)不合法。 |
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參數(shù)不合法 |
400 | InvalidPortType.NotFound | Specified port type is not found. | 指定規(guī)格端口已無庫(kù)存。 |
400 | OperationFailed.PconnTrafficNotEnable | The operation is failed because of PconnTrafficNotEnable. | 操作失敗,因?yàn)槌龇较蛄髁课撮_通。 |
400 | EcNotSupportRegion | High reliable physical connection is not support in this region. | 高可靠物理專線在本地域暫時(shí)不支持售賣 |
400 | EcFailToGetAp | Fail to get access point details. | 無法查詢到對(duì)應(yīng)接入點(diǎn)信息 |
400 | EcNotEnoughResource | Insufficient access point resources. | 接入點(diǎn)資源不足 |
400 | IllegalParam.UnsupportedAccessPoint | The access point type does not support the creation of a highly reliable physical connection. | 接入點(diǎn)類型不支持創(chuàng)建高可靠物理專線。 |
400 | ResourceNotFound.AccessPointId | The specified resource of access point id is not found. | 當(dāng)前接入點(diǎn)信息不存在,請(qǐng)核對(duì)后重試。 |
404 | InvalidPortType.NotFound | There are no resources with the portType. | 沒有該端口類型 |
訪問錯(cuò)誤中心查看更多錯(cuò)誤碼。
變更歷史
變更時(shí)間 | 變更內(nèi)容概要 | 操作 |
---|---|---|
2024-06-28 | OpenAPI 錯(cuò)誤碼發(fā)生變更 | 查看變更詳情 |