分配一個IPv6地址。
調試
您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。
授權信息
下表是API對應的授權信息，可以在RAM權限策略語句的Action元素中使用，用來給RAM用戶或RAM角色授予調用此API的權限。具體說明如下：
- 操作：是指具體的權限點。
- 訪問級別：是指每個操作的訪問級別，取值為寫入（Write）、讀?。≧ead）或列出（List）。
- 資源類型：是指操作中支持授權的資源類型。具體說明如下：
- 對于必選的資源類型，用背景高亮的方式表示。
- 對于不支持資源級授權的操作，用
全部資源表示。
- 條件關鍵字：是指云產品自身定義的條件關鍵字。
- 關聯操作：是指成功執行操作所需要的其他權限。操作者必須同時具備關聯操作的權限，操作才能成功。
| 操作 | 訪問級別 | 資源類型 | 條件關鍵字 | 關聯操作 |
|---|---|---|---|---|
| vpc:AllocateIpv6Address | create | *Ipv6Address acs:vpc:{#regionId}:{#accountId}:ipv6address/* |
| 無 |
請求參數
| 名稱 | 類型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| RegionId | string | 是 | 地域 ID。 | cn-hangzhou |
| VSwitchId | string | 是 | IPv6 地址所在的交換機的 ID。 | vsw-asdfjlnaue4g**** |
| Ipv6Address | string | 否 | 指定要申請的 IPv6 地址。指定的 IPv6 地址必須是在所屬交換機的地址段內的空閑地址。 | 2408:XXXX:153:3921:851c:c435:7b12:1c5f |
| Ipv6AddressName | string | 否 | IPv6 地址的實例名稱。 長度為 0～128 個字符，不能以 | ipv6-name |
| Ipv6AddressDescription | string | 否 | IPv6 地址的實例描述。 長度為 0～256 個字符，不能以 | ipv6-description |
| AddressType | string | 否 | IPv6 地址的類型，取值：
| IPv6Address |
| ResourceGroupId | string | 否 | 資源組 ID。關于資源組的更多信息，請參見什么是資源組。 | rg-bp67acfmxazb4ph**** |
| Tag | array<object> | 否 | 資源的標簽列表。 | |
| object | 否 | 資源的標簽。 | ||
| Key | string | 否 | 資源的標簽鍵。最多支持輸入 20 個標簽鍵。如需傳入該值，請勿輸入空字符串。 一個標簽鍵最多支持 128 個字符，不能以 | FinanceDept |
| Value | string | 否 | 資源的標簽值。最多支持輸入 20 個標簽值。如需傳入該值，可以輸入空字符串。 最多支持 128 個字符，不能以 aliyun 和 acs:開頭，不能包含 http://或者 https://。 | FinanceJoshua |
| ClientToken | string | 否 | 客戶端 Token，用于保證請求的冪等性。從您的客戶端生成一個參數值，確保不同請求間該參數值唯一。ClientToken 只支持 ASCII 字符。 說明
若您未指定，則系統自動使用 API 請求的 RequestId 作為 ClientToken 標識。每次 API 請求的 RequestId 不一樣。
| 02fb3da4-130e-11e9-8e44-0016e04**** |
| DryRun | boolean | 否 | 是否只預檢此次請求，取值：
| false |
返回參數
示例
正常返回示例
JSON格式
{
"Ipv6AddressId": "ipv6-2zen5j4axcp5l5qyy****",
"Ipv6Address": "2408:XXXX:153:3921:851c:c435:7b12:1c5f",
"ResourceGroupId": "rg-acfmxazdjdhd****",
"RequestId": "54B48E3D-DF70-471B-AA93-08E683A1B45"
}錯誤碼
| HTTP status code | 錯誤碼 | 錯誤信息 | 描述 |
|---|---|---|---|
| 400 | OperationFailed.IPv6AddressAlreadyAllocated | The operation is failed because of the ipv6 address specified was allocated. | 指定的IPv6地址已被分配 |
| 400 | OperationFailed.AddressNotInVSwitchCidr | The operation is failed because of %s. | 指定的IP地址不在vSwitch的網段內，請按API文檔參數說明修改后重試。 |
| 400 | IllegalParam.IpAddress | The param of %s is illegal. | 指定的IP地址格式非法，請按API文檔參數說明修改后再重試 |
| 400 | OperationFailed.IPv6Disabled | Operation failed because IPv6 is not enabled for the vSwitch. | 指定操作失敗，因為IPv6功能未打開。 |
| 400 | OperationFailed.IpPrefixMustInVSwitchCidrReservation | The specified ip prefix must in reserved segment the VSwitch. | 指定的前綴網段必須位于交換機預留網段內 |
| 400 | Forbidden.OperateShareResource | You cannot operate shared resources. | 來自共享的資源不允許操作。 |
| 400 | QuotaExceeded.IPv6PrefixMask | The quota of specifed ipv6 prefix mask is exceeded. | 指定的IPv6前綴掩碼超出配額。 |
| 400 | OperationUnsupported.Ipv6Feature | The IPv6 feature is not supported in the region. | 當前地域不支持Ipv6特性。 |
| 400 | IllegalParam.Ipv6Prefix | The param of Ipv6Prefix is illegal. | 指定的入參Ipv6Prefix非法 |
| 400 | OperationFailed.ExistIPv6Used | The operation is failed because of some ipv6 in the ipv6 prefix is already in use. | 由于IPv6前綴中存在IPv6已被使用，操作失敗 |
| 400 | OperationUnsupported.UnboundIpv6PrefixFeature | The region does not support creating IPv6 prefix that are not bound to any resources. | 該地域不支持創建未綁定資源的IPv6前綴網段。 |
| 400 | OperationUnsupported.UnboundIpv6Feature | The region does not support creating IPv6 addresses that are not bound to any resources. | 該地域不支持創建未綁定資源的IPv6地址實例。 |
| 404 | ResourceNotFound.VSwitch | The specified resource of %s is not found. | 指定的vSwitch不存在，請檢查您的輸入是否正確 |
| 404 | ResourceNotFound.VSwitchCidrReservation | The dependent vswitch cidr reservation is not found. | 依賴資源vSwitchCidrReservation不存在 |
訪問錯誤中心查看更多錯誤碼。
變更歷史
| 變更時間 | 變更內容概要 | 操作 |
|---|---|---|
| 2024-08-08 | OpenAPI 錯誤碼發生變更 | 查看變更詳情 |
| 2024-06-28 | OpenAPI 錯誤碼發生變更、OpenAPI 入參發生變更 | 查看變更詳情 |