Tüm Ürünler
Search

Bu Ürün

    :ModifyInstanceNetworkSpec

    Belge Merkezi

    :ModifyInstanceNetworkSpec

    Son Güncelleme:Oct 02, 2026

    Bir ECS örneğinin bant genişliği yapılandırmasını değiştirir, genel IP adresi atar ve ağ faturalandırma yöntemini dönüştürür. Hem yükseltme hem de düşürme işlemleri desteklenir.

    Operation description

    • Abonelik (PrePaid) örneğinin bant genişliği yapılandırmasını değiştirdiğinizde ve giden genel bant genişliği (InternetMaxBandwidthOut) 0 Mbit/s'den sıfır olmayan bir değere yükseltildiğinde, otomatik olarak bir genel IP adresi atanır.

    • Kullandıkça öde (PostPaid) örneğinin bant genişliği yapılandırmasını değiştirdiğinizde ve giden genel bant genişliği (InternetMaxBandwidthOut) 0 Mbit/s'den sıfır olmayan bir değere yükseltildiğinde, otomatik olarak bir genel IP adresi atanmaz. Genel IP adresi atamak için AllocatePublicIp parametresini true olarak ayarlayın.

    Not

    Tek bir bölgede, tek bir Alibaba Cloud hesabı için bant genişliğine göre ödeme yapılan toplam maksimum genel bant genişliği sınırlıdır. Daha fazla bilgi için Genel bant genişliği sınırları konusuna bakın.

    • Ücretler:

    • Bant genişliği yükseltildikten sonra, ücretler varsayılan olarak otomatik şekilde düşülür. Ödeme yönteminizde yeterli bakiye bulunduğundan emin olun. Aksi takdirde, anormal bir sipariş oluşturulur ve siparişi yalnızca iptal edebilirsiniz. Hesap bakiyeniz yetersizse, AutoPay parametresini false olarak ayarlayın. Normal ve ödenmemiş bir sipariş oluşturulur ve ödemeyi tamamlamak için ECS konsolunda oturum açabilirsiniz.

    • Bant genişliği düşürüldükten sonra, fiyat farkı orijinal ödeme yöntemine iade edilir. Kullanılan kuponlar iade edilmez.

    Try it now

    Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

    Test

    RAM authorization

    The table below describes the authorization required to call this API. You can define it in a Resource Access Management (RAM) policy. The table's columns are detailed below:

    • Action: The actions can be used in the Action element of RAM permission policy statements to grant permissions to perform the operation.

    • API: The API that you can call to perform the action.

    • Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.

    • Resource type: The type of the resource that supports authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.

      • For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the Resource element of the policy.

      • For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the Resource element of the policy.

    • Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys applicable across all RAM-supported services.

    • Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.

    Action

    Access level

    Resource type

    Condition key

    Dependent action

    ecs:ModifyInstanceNetworkSpec

    update

    *Instance

    acs:ecs:{#regionId}:{#accountId}:instance/{#instanceId}
    • ecs:AssociatePublicIpAddress
    		 None

    Request parameters

    Parameter

    Type

    Required

    Description

    Example
    InstanceId

    string

    Yes

    Ağ yapılandırmasını değiştirmek istediğiniz örneğin örnek kimliği.

    i-bp67acfmxazb4****
    InternetMaxBandwidthOut

    integer

    No

    Maksimum giden genel bant genişliği. Birim: Mbit/s (Saniye başına megabit). Geçerli değerler:

    • Trafiğe göre ödeme: 0 ile 100 arası.

    • Bant genişliğine göre ödeme:

    • Abonelik örnekleri: 0 ile 200 arası.

    • Kullandıkça öde örnekleri: 0 ile 100 arası.

    Not

    Tek bir örneğin maksimum giden bant genişliği aynı zamanda ECS örnek türünün Ağ bant genişliği taban/anlık artış (Gbit/s) metriği ile de sınırlıdır. Daha fazla bilgi için Örnek aileleri konusuna bakın.

    10
    InternetMaxBandwidthIn

    integer

    No

    Maksimum gelen genel bant genişliği. Birim: Mbit/s (Saniye başına megabit). Geçerli değerler:

    • Satın alınan giden genel bant genişliği 10 Mbit/s'den küçük veya buna eşitse: 1 ile 10 arası. Varsayılan değer: 10.

    • Satın alınan giden genel bant genişliği 10 Mbit/s'den büyükse: 1 ile InternetMaxBandwidthOut değeri arası. Varsayılan değer: InternetMaxBandwidthOut değeri.

    10
    ISP

    string

    No

    Not

    Bu parametre davetiye ile ön izleme aşamasındadır ve herkese açık değildir.

    null
    NetworkChargeType

    string

    No

    Ağ faturalandırma yöntemini dönüştürür. Geçerli değerler:

    • PayByBandwidth: Bant genişliğine göre ödeme.

    • PayByTraffic: Trafiğe göre ödeme.

    Not

    Trafiğe göre ödeme modunda, gelen ve giden bant genişliği maksimum değerleri her ikisi de üst sınırdır ve garanti edilmez. Kaynak çekişmesi meydana geldiğinde, bant genişliği maksimum değerleri kısıtlanabilir. İş yükleriniz garanti edilen bant genişliği gerektiriyorsa, bant genişliğine göre ödeme modunu kullanın.

    PayByTraffic
    AllocatePublicIp

    boolean

    No

    Genel IP adresi atanıp atanmayacağını belirtir. Geçerli değerler:

    • true: Genel IP adresi atanır.

    • false: Genel IP adresi atanmaz.

    Varsayılan değer: false.

    false
    StartTime

    string

    No

    Geçici bant genişliği yükseltmesinin başlangıç zamanı. Zamanı ISO 8601 standardında yyyy-MM-ddTHH:mmZ biçiminde belirtin. Zaman UTC+0 olmalıdır. Değer dakika (mm) hassasiyetindedir.

    2017-12-05T22:40Z
    EndTime

    string

    No

    Geçici bant genişliği yükseltmesinin bitiş zamanı. Zamanı ISO 8601 standardında yyyy-MM-ddTHHZ biçiminde belirtin. Zaman UTC+0 olmalıdır. Değer saat (HH) hassasiyetindedir.

    Not

    Geçici bant genişliği yükseltmesinin bitiş zamanı ile başlangıç zamanı arasındaki aralık 3 saatten büyük veya buna eşit olmalıdır.

    2017-12-06T22Z
    AutoPay

    boolean

    No

    Ödemenin otomatik olarak tamamlanıp tamamlanmayacağını belirtir. Geçerli değerler:

    • true: Bant genişliği yapılandırması değiştirildikten sonra ödeme otomatik olarak tamamlanır. Hesap bakiyenizin yeterli olduğundan emin olun. Bakiye yetersizse, anormal bir sipariş oluşturulur. Bu siparişin ödemesini ECS konsolunda yapamazsınız. Siparişi yalnızca iptal edebilirsiniz.

    • false: Bant genişliği yapılandırması değiştirildikten sonra bir sipariş oluşturulur ancak ödeme tamamlanmaz. Ödeme yönteminizde yetersiz bakiye varsa, otomatik ödemeyi iptal etmek için Autopay parametresini false olarak ayarlayın. Bu durumda, normal ve ödenmemiş bir sipariş oluşturulur. Ödemeyi tamamlamak için ECS konsolunda oturum açabilirsiniz.

    Varsayılan değer: true.

    true
    ClientToken

    string

    No

    İsteğin idempotent olmasını sağlamak için kullanılan istemci belirteci. Belirteci oluşturmak için istemciyi kullanabilirsiniz, ancak belirtecin farklı istekler arasında benzersiz olduğundan emin olun. ClientToken değeri yalnızca ASCII karakterleri içerebilir ve uzunluğu 64 karakteri aşamaz. Daha fazla bilgi için İdempotentlik nasıl sağlanır konusuna bakın.

    123e4567-e89b-12d3-a456-426655440000

    Response elements

    Element

    Type

    Description

    Example

    object

    OrderId

    string

    Sipariş kimliği. Bu parametre yalnızca bir abonelik (PrePaid) örneğinin bant genişliği yapılandırmasını değiştirdiğinizde döndürülür.

    123457890
    RequestId

    string

    İstek kimliği.

    473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

    Examples

    Success response

    JSON format

    {
  "OrderId": "123457890",
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}

    Error codes

    HTTP status code

    Error code

    Error message

    Description
    400 InvalidInternetMaxBandwidthIn.ValueNotSupported The specified InternetMaxBandwidthIn is beyond the permitted range.
    400 InvalidInternetMaxBandwidthOut.ValueNotSupported The specified InternetMaxBandwidthOut is beyond the permitted range.
    400 OperationDenied Specified instance is in VPC.
    400 InvalidParameter.Conflict %s
    400 InvalidStartTime.ValueNotSupported The specified StartTime is out of the permitted range.
    400 InvalidEndTime.ValueNotSupported The specified EndTime is out of the permitted range.
    400 ChargeTypeViolation The operation is not permitted due to billing method of the instance.
    400 Account.Arrearage Your account has an outstanding payment.
    400 InvalidInternetChargeType.ValueNotSupported The specified InternetChargeType is invalid.
    400 DecreasedBandwidthNotAllowed %s
    400 BandwidthUpgradeDenied.EipBoundInstance The specified VPC instance has bound EIP, temporary bandwidth upgrade is denied.
    400 InvalidClientToken.ValueNotSupported The ClientToken provided is invalid.
    400 Throttling Request was denied due to request throttling, please try again after 5 minutes.
    400 InvalidInstanceStatus.NotStopped The specified Instance status is not Stopped.
    400 InvalidAction Specified action is not valid.
    400 IpAllocationError Allocate public ip failed.
    400 InvalidParam.AllocatePublicIp The specified param AllocatePublicIp is invalid.
    400 InstanceDowngrade.QuotaExceed Quota of instance downgrade is exceed.
    400 InvalidBandwidth.ValueNotSupported Instance upgrade bandwidth of temporary not allow less then existed.
    400 InvalidInstanceStatus The specified instance status does not support this action.
    400 InvalidInstance.UnPaidOrder Unpaid order exists in your account, please complete or cancel the payment in the expense center.
    400 LastOrderProcessing The previous order is still processing, please try again later.
    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.
    400 InvalidParameter.CloudboxNotSupported %s
    400 InvalidParameter.Bandwidth %s
    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.
    400 InvalidOperation.InstanceStatusUnsupported The specified instance status is not supported for this operation, expect status is Running or Stopped.
    400 QuotaExceeded.InternetBandwidth %s.
    400 UnsupportedIspNetworkChargeType The network charge type is not supported when specifying ISP.
    400 IncorrectInstanceStatus Current instance status does not support this operation.
    400 TaskConflict The operation is too frequent, please wait a moment and try again.
    400 InvalidOperation.InternetMaxBandwidthOutUnsupported The InternetMaxBandwidthOut is not allowed to modify.
    500 InternalError The request processing has failed due to some unknown error.
    500 Image.OrderFailed Create marketplace image order failed.
    403 IncorrectInstanceStatus The current status of the instance does not support this operation.
    403 InstanceLockedForSecurity The specified operation is denied as your instance is locked for security reasons.
    403 InstanceExpiredOrInArrears The specified operation is denied as your prepay instance is expired (prepay mode) or in arrears (afterpay mode).
    403 ChargeTypeViolation The operation is not permitted due to billing method of the instance.
    403 OperationDenied The operation is denied due to the instance is PrePaid.
    403 InvalidAccountStatus.NotEnoughBalance Your account does not have enough balance.
    403 InvalidInstance.UnPaidOrder The specified Instance has unpaid order.
    403 Throttling Request was denied due to request throttling, please try again after 5 minutes.
    403 InvalidInstance.InstanceNotSupported The special vpc instance with eip not need bandwidth.
    403 InstanceDowngrade.QuotaExceed Quota of instance downgrade is exceed.
    403 InvalidInstanceStatus The current status of the instance does not support this operation.
    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.
    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.
    403 Mayi.InternalError The request processing has failed due to some unknown error.
    403 InvalidNetworkType.ValueNotSupported The specified parameter NetworkType is not valid.
    403 OperationDenied.ImageNotValid The specified marketplace image is not authorized. Please verify the marketplace image authorization and try again.
    403 InvalidInstanceChargeType.ValueNotSupported The specified parameter ChargeType is not valid.
    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
    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.
    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.
    403 InvalidOperation.NetworkTypeUnsupported The specified network type is not supported in this region.
    404 InvalidInstanceId.NotFound The specified InstanceId does not exist.
    409 OperationConflict Request was denied due to conflict with a previous request,please try again later.

    See Error Codes for a complete list.

    Release notes

    See Release Notes for a complete list.