為一臺(tái)ECS實(shí)例分配一個(gè)固定公網(wǎng)IP地址。調(diào)用該接口時(shí)請確保實(shí)例帶寬大于0，且僅白名單用戶支持指定固定公網(wǎng)IP。強(qiáng)烈建議您調(diào)用ModifyInstanceNetworkSpec接口調(diào)整帶寬，分配固定公網(wǎng)IP。
接口說明
調(diào)用該接口時(shí)，您需要注意：
-
分配公網(wǎng) IP 地址之前，實(shí)例必須處于運(yùn)行中（
Running）或者已停止（Stopped）狀態(tài)。 -
被安全控制的實(shí)例的
OperationLocks中標(biāo)記了"LockReason" : "security"時(shí)，不能分配公網(wǎng) IP 地址。 -
一臺(tái)實(shí)例只能分配一個(gè)公網(wǎng) IP 地址。如果實(shí)例已經(jīng)擁有一個(gè)公網(wǎng) IP 地址，將返回已綁定的公網(wǎng) IP 地址
IpAddress。 -
重啟實(shí)例（ RebootInstance ）或者啟動(dòng)實(shí)例（ StartInstance ）后，新的公網(wǎng) IP 地址生效。
除分配公網(wǎng) IP 之外，您還可以給 VPC 類型 ECS 實(shí)例綁定彈性公網(wǎng) IP（EIP）。更多信息，請參見 AssociateEipAddress 。
調(diào)試
您可以在OpenAPI Explorer中直接運(yùn)行該接口，免去您計(jì)算簽名的困擾。運(yùn)行成功后，OpenAPI Explorer可以自動(dòng)生成SDK代碼示例。
授權(quán)信息
下表是API對應(yīng)的授權(quán)信息，可以在RAM權(quán)限策略語句的Action元素中使用，用來給RAM用戶或RAM角色授予調(diào)用此API的權(quán)限。具體說明如下：
- 操作：是指具體的權(quán)限點(diǎn)。
- 訪問級(jí)別：是指每個(gè)操作的訪問級(jí)別，取值為寫入（Write）、讀?。≧ead）或列出（List）。
- 資源類型：是指操作中支持授權(quán)的資源類型。具體說明如下：
- 對于必選的資源類型，用背景高亮的方式表示。
- 對于不支持資源級(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)操作 |
|---|---|---|---|---|
| ecs:AllocatePublicIpAddress | create | *Instance acs:ecs:{#regionId}:{#accountId}:instance/{#instanceId} |
| 無 |
請求參數(shù)
| 名稱 | 類型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| InstanceId | string | 是 | 待分配 IP 地址的實(shí)例 ID。 說明
該實(shí)例帶寬必須大于 0。
| i-bp1gtjxuuvwj17zr**** |
| IpAddress | string | 否 | 實(shí)例的公網(wǎng) IP 地址。如果該參數(shù)值為空，則默認(rèn)由系統(tǒng)隨機(jī)分配 IP 地址。 說明
該參數(shù)只支持白名單用戶指定，普通用戶不支持指定固定公網(wǎng) IP。
| 112.124.**.** |
| VlanId | string | 否 | 實(shí)例的 VLAN ID。 說明
該參數(shù)即將被棄用，為提高兼容性，請盡量使用其他參數(shù)。
| 720 |
返回參數(shù)
示例
正常返回示例
JSON格式
{
"IpAddress": "112.124.**.**",
"RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}錯(cuò)誤碼
| HTTP status code | 錯(cuò)誤碼 | 錯(cuò)誤信息 | 描述 |
|---|---|---|---|
| 400 | InvalidOperation.AllocateFailed | The current instance failed to allocate public IP, please try again later. | - |
| 400 | InvalidIpAddress.Malformed | The specified parameter "IpAddress" is not valid. | - |
| 400 | OperationDenied | Specified operation is denied as your instance is in VPC. | 由于實(shí)例存在于 VPC 中，指定的操作不合法。 |
| 400 | InsufficientPublicIp | Ip address not found. | - |
| 400 | AllocateIpInvalidInstanceBandwidth | OperationDenied The InternetMaxBandwidthOut of the specified instance cannot be less than 0. | 當(dāng)前操作無效，請保證最大輸出帶寬大于0。 |
| 400 | OperationDenied | The specified parameter "VlanId" is not valid or vlan has not enough IP address. | - |
| 400 | OperationDenied | The specified instance already has a public IP. | - |
| 400 | OperationDenied.CloudboxNotSupport | This operation is denied, because the specified ECS instance which is in the Cloudbox dose not support PublicIp or Eip. | - |
| 400 | OperationDenied.DedicatedRegionNotSupported | This operation is denied, because the specified ECS instance which is in the dedicated region dose not support PublicIp or Eip. | 專屬云不支持的api的報(bào)錯(cuò) |
| 403 | IncorrectInstanceStatus | The current status of the resource does not support this operation. | 該資源目前的狀態(tài)不支持此操作。 |
| 403 | InstanceLockedForSecurity | The specified operation is denied as your instance is locked for security reasons. | 實(shí)例被安全鎖定。 |
| 403 | InstanceExpiredOrInArrears | The specified operation is denied as your prepay instance is expired (prepay mode) or in arrears (afterpay mode). | 實(shí)例已過期或者欠費(fèi)，請您續(xù)費(fèi)或者結(jié)清后再進(jìn)行操作。 |
| 403 | IpInUse | The specified IP is already in use. | 使用指定IP進(jìn)行綁定時(shí)，IP已經(jīng)被使用在別的機(jī)器上。 |
| 403 | AllocatedAlready | There is an IpAddress allocated already for the specified instance. | 使用指定 IP 進(jìn)行綁定時(shí)，該實(shí)例已經(jīng)被分配了別的 IP 地址。 |
| 403 | AllocateIp.Fail | The specified instance fails to allocate ip, please try again. | - |
| 403 | NAT_PUBLIC_IP_BINDING_FAILED | Binding nat public ip failed. | - |
| 403 | NAT_PUBLIC_IP_ALLOCATE_FAILED | Nat public ip binding failed. | 公網(wǎng) IP 綁定失敗。 |
| 403 | InvalidIpAddress.NotPublic | The specified IP is not public address. | - |
| 403 | AllocatedAlready | An IpAddress has been assigned to the specified instance. | - |
| 404 | InvalidInstanceId.NotFound | The specified InstanceId does not exist. | 指定的InstanceId不存在。 |
| 404 | InvalidVlanId.NotFound | The VlanId provided does not exist in our records. | 指定的虛擬局域網(wǎng) ID 不存在。 |
| 404 | InvalidIpAddress.NotFound | The specified IP is not in the specified vlan. | 指定的 IP 不在指定的虛擬局域網(wǎng)內(nèi)。 |
| 500 | InternalError | The request processing has failed due to some unknown error. | 內(nèi)部錯(cuò)誤，請重試。 |
訪問錯(cuò)誤中心查看更多錯(cuò)誤碼。
變更歷史
| 變更時(shí)間 | 變更內(nèi)容概要 | 操作 |
|---|---|---|
| 2023-10-10 | OpenAPI 錯(cuò)誤碼發(fā)生變更 | 查看變更詳情 |