修改ECS實(shí)例的帶寬配置、分配公網(wǎng)IP、轉(zhuǎn)換網(wǎng)絡(luò)計(jì)費(fèi)方式等。本接口支持升配和降配。
接口說明
調(diào)用該接口時(shí)，您需要注意：
-
修改包年包月（PrePaid）實(shí)例的帶寬配置時(shí)，公網(wǎng)出帶寬（InternetMaxBandwidthOut）從 0 Mbit/s 升級(jí)到一個(gè)非零值時(shí)會(huì)自動(dòng)分配一個(gè)公網(wǎng) IP。
-
修改按量付費(fèi)（PostPaid）實(shí)例的帶寬配置時(shí)，公網(wǎng)出帶寬（InternetMaxBandwidthOut）從 0 Mbit/s 升級(jí)到一個(gè)非零值時(shí)不會(huì)自動(dòng)分配公網(wǎng) IP。您需要指定參數(shù)
AllocatePublicIp為true分配公網(wǎng) IP。 -
對于經(jīng)典網(wǎng)絡(luò)（Classic）類型實(shí)例，當(dāng)公網(wǎng)出帶寬（InternetMaxBandwidthOut）從 0 Mbit/s 升級(jí)到一個(gè)非零值時(shí)，實(shí)例必須處于已停止（Stopped）狀態(tài)。
說明
單個(gè)地域下，單個(gè)阿里云賬號(hào)按固定帶寬計(jì)費(fèi)的公網(wǎng)帶寬峰值總和存在限制，請參見公網(wǎng)帶寬限制。
-
費(fèi)用：
-
升級(jí)帶寬后，默認(rèn)自動(dòng)扣費(fèi)。您需要確保支付方式余額充足，否則會(huì)生成異常訂單，此時(shí)只能作廢訂單。如果您的賬戶余額不足，可以將參數(shù) AutoPay 置為 false，此時(shí)會(huì)生成正常的未支付訂單，您可以登錄 ECS 管理控制臺(tái)支付。
-
降低帶寬后，價(jià)格差退款將原路退還，已使用的代金券不退回。
-
調(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:ModifyInstanceNetworkSpec | update | *Instance acs:ecs:{#regionId}:{#accountId}:instance/{#instanceId} |
| 無 |
請求參數(shù)
| 名稱 | 類型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| InstanceId | string | 是 | 待修改網(wǎng)絡(luò)配置的實(shí)例 ID。 | i-bp67acfmxazb4**** |
| InternetMaxBandwidthOut | integer | 否 | 公網(wǎng)出帶寬最大值，單位：Mbit/s（Megabit per second）。取值范圍：
說明
單實(shí)例出帶寬峰值也會(huì)受到 ECS 實(shí)例規(guī)格的 網(wǎng)絡(luò)帶寬基礎(chǔ)/突發(fā)（Gbit/s） 指標(biāo)數(shù)據(jù)限制。更多信息，請參見實(shí)例規(guī)格族。
| 10 |
| InternetMaxBandwidthIn | integer | 否 | 公網(wǎng)入帶寬最大值，單位：Mbit/s（Megabit per second）。取值范圍：
| 10 |
| ISP | string | 否 | 說明
該參數(shù)正在邀測中，暫未開放使用。
| null |
| NetworkChargeType | string | 否 | 轉(zhuǎn)換網(wǎng)絡(luò)計(jì)費(fèi)方式。取值范圍：
說明
按使用流量計(jì)費(fèi)模式下的出入帶寬峰值都是帶寬上限，不作為業(yè)務(wù)承諾指標(biāo)。當(dāng)出現(xiàn)資源爭搶時(shí)，帶寬峰值可能會(huì)受到限制。如果您的業(yè)務(wù)需要有帶寬的保障，請使用按固定帶寬計(jì)費(fèi)模式。
| PayByTraffic |
| AllocatePublicIp | boolean | 否 | 是否分配公網(wǎng) IP 地址。
默認(rèn)值：false。 | false |
| StartTime | string | 否 | 臨時(shí)帶寬升級(jí)開始時(shí)間。按照ISO 8601標(biāo)準(zhǔn)表示，并使用 UTC+0 時(shí)間，格式為 yyyy-MM-ddThh:mmZ。精確到分鐘（mm）。 | 2017-12-05T22:40Z |
| EndTime | string | 否 | 臨時(shí)帶寬升級(jí)結(jié)束時(shí)間。按照ISO 8601標(biāo)準(zhǔn)表示，并使用 UTC+0 時(shí)間，格式為 yyyy-MM-ddThhZ。精確到小時(shí)（hh）。 說明
臨時(shí)升級(jí)帶寬的結(jié)束時(shí)間和開始時(shí)間的間隔必須大于或等于 3 小時(shí)。
| 2017-12-06T22Z |
| AutoPay | boolean | 否 | 是否自動(dòng)支付。取值范圍：
默認(rèn)值：true。 | true |
| ClientToken | string | 否 | 保證請求冪等性。從您的客戶端生成一個(gè)參數(shù)值，確保不同請求間該參數(shù)值唯一。ClientToken 只支持 ASCII 字符，且不能超過 64 個(gè)字符。更多信息，請參見如何保證冪等性。 | 123e4567-e89b-12d3-a456-426655440000 |
返回參數(shù)
示例
正常返回示例
JSON格式
{
"OrderId": "123457890",
"RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}錯(cuò)誤碼
| HTTP status code | 錯(cuò)誤碼 | 錯(cuò)誤信息 | 描述 |
|---|---|---|---|
| 400 | InvalidInternetMaxBandwidthIn.ValueNotSupported | The specified InternetMaxBandwidthIn is beyond the permitted range. | 指定的公網(wǎng)入方向最大帶寬超出允許值。 |
| 400 | InvalidInternetMaxBandwidthOut.ValueNotSupported | The specified InternetMaxBandwidthOut is beyond the permitted range. | 指定的公網(wǎng)出方向最大帶寬超出允許值。 |
| 400 | OperationDenied | Specified instance is in VPC. | 指定實(shí)例存在于 VPC。 |
| 400 | InvalidParameter.Conflict | %s | 您輸入的參數(shù)無效，請檢查參數(shù)之間是否沖突。%s為變量，將根據(jù)調(diào)用API的實(shí)際情況動(dòng)態(tài)返回錯(cuò)誤信息。 |
| 400 | InvalidStartTime.ValueNotSupported | The specified StartTime is out of the permitted range. | 指定的開始時(shí)間不在允許范圍內(nèi)。 |
| 400 | InvalidEndTime.ValueNotSupported | The specified EndTime is out of the permitted range. | 指定的 EndTime 超過限制。 |
| 400 | ChargeTypeViolation | The operation is not permitted due to billing method of the instance. | 實(shí)例的計(jì)費(fèi)方式不支持該操作。 |
| 400 | InvalidStartTime.ValueNotSupported | %s | 指定的開始時(shí)間不能早于當(dāng)前時(shí)間。 |
| 400 | Account.Arrearage | Your account has an outstanding payment. | 您的賬號(hào)存在未支付的款項(xiàng)。 |
| 400 | InvalidEndTime.ValueNotSupported | %s | - |
| 400 | InvalidInternetChargeType.ValueNotSupported | The specified InternetChargeType is invalid. | 指定的參數(shù) InternetChargeType 無效。 |
| 400 | DecreasedBandwidthNotAllowed | %s | 降低帶寬操作無效。 |
| 400 | BandwidthUpgradeDenied.EipBoundInstance | The specified VPC instance has bound EIP, temporary bandwidth upgrade is denied. | 該實(shí)例已經(jīng)綁定 EIP，不能進(jìn)行臨時(shí)升級(jí)。 |
| 400 | InvalidClientToken.ValueNotSupported | The ClientToken provided is invalid. | 指定的 ClientToken 不合法。 |
| 400 | Throttling | Request was denied due to request throttling, please try again after 5 minutes. | 您當(dāng)前的請求被流控，請5分鐘后重試。 |
| 400 | InvalidInstanceStatus.NotStopped | The specified Instance status is not Stopped. | 指定實(shí)例的狀態(tài)不是已停止。 |
| 400 | InvalidAction | Specified action is not valid. | 該操作無效。 |
| 400 | IpAllocationError | Allocate public ip failed. | 公網(wǎng) IP 地址分配失敗。 |
| 400 | InvalidParam.AllocatePublicIp | The specified param AllocatePublicIp is invalid. | 指定的 AllocatePublicIp 無效。 |
| 400 | InstanceDowngrade.QuotaExceed | Quota of instance downgrade is exceed. | 您的實(shí)例降配已超額度，無法進(jìn)行此操作。 |
| 400 | InvalidBandwidth.ValueNotSupported | Instance upgrade bandwidth of temporary not allow less then existed. | 臨時(shí)寬帶升級(jí)帶寬不能低于已有帶寬。 |
| 400 | InvalidInstanceStatus | The specified instance status does not support this action. | 實(shí)例的當(dāng)前狀態(tài)不支持該操作。 |
| 400 | InvalidInstance.UnPaidOrder | Unpaid order exists in your account, please complete or cancel the payment in the expense center. | 您的賬號(hào)里有未支付的訂單，請?zhí)幚砗笾卦嚒?/span> |
| 400 | OperationDenied | After downgrade, you cannot upgrade or downgrade your instances again in the remaining time of the current billing cycle. | 降配后，您將無法在當(dāng)前結(jié)算周期的剩余時(shí)間內(nèi)再次升級(jí)或降級(jí)實(shí)例配置。 |
| 400 | InvalidInternetChargeType.ValueNotSupported | %s | 暫不支持指定的網(wǎng)絡(luò)計(jì)費(fèi)方式，請確認(rèn)相關(guān)參數(shù)是否正確。 |
| 400 | LastOrderProcessing | The previous order is still processing, please try again later. | 訂單正在處理中，稍后重試。 |
| 400 | OperationDenied | The current user does not support this operation. | 您使用的賬號(hào)暫不支持此操作。 |
| 400 | LastRequestProcessing | The previous request is still processing, please try again later. | - |
| 400 | InvalidStartTime.BeyondLifeCycle | The specified start time exceeds the expiration time. | - |
| 400 | InvalidEndTime.BeyondLifeCycle | The specified end time exceeds the expiration time. | - |
| 400 | InvalidPayMethod.SyncPaymentNotSupport | Synchronous payment is not supported. Use another payment method. | - |
| 400 | InvalidBandwidthOut.LessThanZero | The bandwidth must be larger than 0 when specifying isp. | - |
| 400 | InvalidParameter.BandwidthBiggerThanBaseBandwidth | %s | - |
| 400 | InvalidAction.WithActiveElasticUpgrade | The instance has active Elastic Upgrade. | 指定的實(shí)例為臨時(shí)升級(jí)中（即調(diào)用ModifyPrepayInstanceSpec時(shí)設(shè)置了EndTime參數(shù)）的實(shí)例，暫不支持查詢。 |
| 400 | InvalidParameter.CloudboxNotSupported | %s | - |
| 400 | InvalidParameter.Bandwidth | %s | 指定的帶寬無效，請檢查參數(shù)是否正確。 |
| 400 | NoPermission.Price | The operation requires price permission. Please either apply for permission from your main account, or set the parameter AutoPay as true. | - |
| 400 | NoPermission.Refund | The operation requires refund permission. Please apply for permission from your main account. | - |
| 400 | InvalidParameter.DedicatedRegionNotSupported | The specified action is rejected because the specified ECS instance in the dedicated region does not support public IP. | 專屬云地域不支持的參數(shù)錯(cuò)誤碼 |
| 400 | InvalidOperation.InstanceStatusUnsupported | The specified instance status is not supported for this operation, expect status is Running or Stopped. | 指定的實(shí)例的狀態(tài)不滿足，實(shí)例的狀態(tài)須為 Running 或 Stopped。 |
| 400 | QuotaExceeded.InternetBandwidth | %s. | 您當(dāng)前賬號(hào)下，按量付費(fèi)ECS實(shí)例的按固定帶寬計(jì)費(fèi)公網(wǎng)帶寬超過了總帶寬配額限制。 |
| 400 | UnsupportedIspNetworkChargeType | The network charge type is not supported when specifying ISP. | 此實(shí)例的網(wǎng)絡(luò)計(jì)費(fèi)類型不支持指定 ISP |
| 403 | IncorrectInstanceStatus | The current status of the instance does not support this operation. | 當(dāng)前實(shí)例狀態(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 | OperationDenied | The operation is denied due to the instance is PrePaid. | 包年包月的實(shí)例不支持此操作。 |
| 403 | InvalidAccountStatus.NotEnoughBalance | Your account does not have enough balance. | 賬號(hào)余額不足，請您先充值再進(jìn)行該操作。 |
| 403 | InvalidInstance.UnPaidOrder | The specified Instance has unpaid order. | 指定的實(shí)例有未支付的訂單，請您先支付再進(jìn)行操作。 |
| 403 | InvalidInstance.InstanceNotSupported | The special vpc instance with eip not need bandwidth. | VPC 類型實(shí)例綁定 EIP 后不需要指定公網(wǎng)帶寬。 |
| 403 | InvalidInstanceStatus | The current status of the instance does not support this operation. | 當(dāng)前實(shí)例的狀態(tài)不支持此操作。 |
| 403 | InvalidOperation.StarterPackage | StarterPackage not support modification. | - |
| 403 | NAT_PUBLIC_IP_BINDING_FAILED | Binding nat public ip failed. | - |
| 403 | InvalidInstance.EipNotSupport | The specified instance with eip is not supported, please unassociate eip first. | 已綁定 EIP 的實(shí)例不支持該操作，請先解綁此EIP。 |
| 403 | InvalidInstance.NatPortMapNotSupport | The special instance with nat port map not support operate, please remove nat port map first. | - |
| 403 | OperationDenied.UnpaidOrder | The specified instance has unpaid order. | 指定的實(shí)例ID已存在未支付訂單，您可以登錄ECS管理控制臺(tái)支付。 |
| 403 | Mayi.InternalError | The request processing has failed due to some unknown error. | - |
| 403 | InvalidNetworkType.ValueNotSupported | The specified parameter NetworkType is not valid. | 指定的網(wǎng)絡(luò)類型不合法。 |
| 403 | OperationDenied.ImageNotValid | The specified image is not authorized. | 您沒有使用此鏡像的權(quán)限。 |
| 403 | InvalidInstanceChargeType.ValueNotSupported | The specified parameter ChargeType is not valid. | 不合法的計(jì)費(fèi)類型 |
| 403 | IncorrectInstanceStatus | The current status of the resource does not support this operation. | 該資源目前的狀態(tài)不支持此操作。 |
| 403 | InvalidIspType.ValueNotSupported | %s | - |
| 403 | UnsupportedIspChargeType | %s | - |
| 403 | UnsupportedIspClassicNetwork | %s | - |
| 403 | InvalidIspBandwidthOut | %s | - |
| 403 | UnsupportedChangeIsp | %s | - |
| 403 | InvalidIspUID | %s | - |
| 403 | UnsupportedIspRegion | %s | - |
| 403 | BandIncreaseNotSupportIsp | %s | ISP 實(shí)例不支持臨時(shí)帶寬升級(jí) |
| 403 | SecurityRisk.3DVerification | We have detected a security risk with your default credit or debit card. Please proceed with verification via the link in your email. | 我們檢測到您的默認(rèn)信用卡或借記卡存在安全風(fēng)險(xiǎn)。請通過電子郵件中的鏈接進(jìn)行驗(yàn)證。 |
| 403 | InvalidOperation.PublicIpAddressNoStock | The public IP address for the specified Region or ChargeType of the instance is out of stock. Please try another Region or ChargeType. | 在指定的地域或付費(fèi)類型條件下，實(shí)例公網(wǎng)IP地址庫存不足。請嘗試使用其它地域或付費(fèi)類型。 |
| 404 | InvalidInstanceId.NotFound | The specified InstanceId does not exist. | 指定的InstanceId不存在。 |
| 500 | InternalError | The request processing has failed due to some unknown error. | 內(nèi)部錯(cuò)誤，請重試。 |
| 500 | InternalError | The request processing has failed due to some unknown error, exception or failure. | 內(nèi)部錯(cuò)誤，請重試。 |
| 500 | Image.OrderFailed | Create marketplace image order failed. | 創(chuàng)建鏡像市場訂單失敗。 |
訪問錯(cuò)誤中心查看更多錯(cuò)誤碼。
變更歷史
| 變更時(shí)間 | 變更內(nèi)容概要 | 操作 |
|---|---|---|
| 2024-12-02 | OpenAPI 錯(cuò)誤碼發(fā)生變更 | 查看變更詳情 |
| 2024-09-27 | OpenAPI 錯(cuò)誤碼發(fā)生變更 | 查看變更詳情 |
| 2024-09-23 | OpenAPI 錯(cuò)誤碼發(fā)生變更 | 查看變更詳情 |
| 2024-01-30 | OpenAPI 錯(cuò)誤碼發(fā)生變更 | 查看變更詳情 |
| 2024-01-08 | OpenAPI 錯(cuò)誤碼發(fā)生變更 | 查看變更詳情 |
| 2023-10-10 | OpenAPI 錯(cuò)誤碼發(fā)生變更 | 查看變更詳情 |