All Products
Search

This Product

    :ModifyReservedInstances

    Document Center

    :ModifyReservedInstances

    Last Updated:May 25, 2026

    Memisahkan, menggabungkan, atau memodifikasi reserved instance.

    Catatan Penggunaan

    Perhatikan hal-hal berikut:

    • Untuk informasi mengenai batasan pada reserved instance, lihat bagian "Batasan" dalam Overview.
    • Sebelum memanggil operasi ini untuk memisahkan reserved instance, pastikan Anda memahami batasan terkait pemisahan reserved instance. Untuk informasi selengkapnya, lihat Split a reserved instance.
    • Sebelum memanggil operasi ini untuk menggabungkan reserved instance, pastikan Anda memahami batasan terkait penggabungan reserved instance. Untuk informasi selengkapnya, lihat Merge reserved instances.
    • Sebelum memanggil operasi ini untuk memodifikasi reserved instance, pastikan Anda memahami batasan dan metode modifikasi reserved instance. Untuk informasi selengkapnya, lihat Modify a reserved instance.

    Debugging

    OpenAPI Explorer secara otomatis menghitung nilai signature. Untuk kenyamanan Anda, kami menyarankan agar Anda memanggil operasi ini di OpenAPI Explorer. OpenAPI Explorer secara dinamis menghasilkan contoh kode operasi ini untuk berbagai SDK.

    Parameter permintaan

    Parameter Type Required Example Description
    Action String Yes ModifyReservedInstances

    Operasi yang ingin Anda lakukan. Tetapkan nilainya ke ModifyReservedInstances.

    RegionId String Yes cn-hangzhou

    ID wilayah dari reserved instance tersebut.

    Anda dapat memanggil operasi DescribeRegions untuk mengambil daftar wilayah terbaru.

    ReservedInstanceId.N String No ecsri-bp15xx2****

    ID reserved instance ke-N. Nilai N yang valid: 1 hingga 20.

    Configuration.N.ReservedInstanceName String No testReservedInstanceName

    Nama reserved instance ke-N. Nilai N yang valid: 1 hingga 100.

    Nama harus terdiri dari 2 hingga 128 karakter. Nama harus dimulai dengan huruf dan tidak boleh dimulai dengan http:// atau https://. Nama dapat berisi angka, huruf, titik dua (:), garis bawah (_), dan tanda hubung (-).

    Configuration.N.ZoneId String No cn-hangzhou-i

    ID zona dari reserved instance ke-N. Nilai N yang valid: 1 hingga 100.

    Parameter ini wajib ditentukan ketika Scope diatur ke Zone.

    Anda dapat memanggil operasi DescribeZones untuk mengambil daftar zona terbaru.

    Configuration.N.Scope String Yes Zone

    Cakupan reserved instance ke-N. Nilai yang valid:

    • Region
    • Zone

    Nilai N yang valid: 1 hingga 100.

    Nilai default: Region.

    Configuration.N.InstanceType String Yes ecs.c5.4xlarge

    Tipe instans yang dapat dicocokkan oleh reserved instance ke-N. Nilai N yang valid: 1 hingga 100.

    Catatan Tipe instans yang berlaku terus diperbarui. Untuk informasi selengkapnya, lihat bagian "Atribut" dalam Reserved instance overview.
    Configuration.N.InstanceAmount Integer Yes 1

    Jumlah instans pay-as-you-go dengan tipe instans yang sama yang dapat dicocokkan oleh reserved instance ke-N. Nilai parameter ini harus lebih besar dari atau sama dengan 1. Nilai N yang valid: 1 hingga 100.

    Parameter respons

    Parameter Type Example Description
    RequestId String ED9E4A5F-FF4D-4C96-BE80-6B4227060DD7

    ID permintaan.

    ReservedInstanceIdSets Array of String {"ReservedInstanceId":"ecsri-bp1cx3****","ecsri-bp15xx2****"]}

    ID reserved instance.

    Contoh

    Contoh permintaan

    http(s)://ecs.aliyuncs.com/?Action=ModifyReservedInstances
&RegionId=cn-hangzhou
&ReservedInstanceId.1=ecsri-bp1cx3****
&ReservedInstanceId.2=ecsri-bp15xx2****
&Configuration.1.InstanceType=ecs.c5.4xlarge
&Configuration.1.Scope=Zone
&Configuration.2.InstanceType=ecs.g5.4xlarge
&Configuration.2.Scope=Region
&<Common request parameters>

    Contoh respons sukses

    XML format

    HTTP/1.1 200 OK
Content-Type:application/xml

<ModifyReservedInstancesResponse>
    <ReservedInstanceIdSets>
        <ReservedInstanceId>ecsri-bp1cx3****</ReservedInstanceId>
        <ReservedInstanceId>ecsri-bp15xx2****</ReservedInstanceId>
    </ReservedInstanceIdSets>
    <RequestId>ED9E4A5F-FF4D-4C96-BE80-6B4227060DD7</RequestId>
</ModifyReservedInstancesResponse>

    JSON format

    HTTP/1.1 200 OK
Content-Type:application/json

{
  "ReservedInstanceIdSets" : {
    "ReservedInstanceId" : [ "ecsri-bp1cx3****", "ecsri-bp15xx2****" ]
  },
  "RequestId" : "ED9E4A5F-FF4D-4C96-BE80-6B4227060DD7"
}

    Kode kesalahan

    Kode status HTTP Kode kesalahan Pesan kesalahan Deskripsi
    400 InvalidInstanceType.ValueUnauthorized The specified InstanceType is not authorized. Anda tidak memiliki otorisasi untuk menggunakan tipe instans tersebut.
    400 InvalidParameter.Conflict The specified region and cluster do not match. Wilayah dan kluster yang ditentukan tidak saling sesuai.
    400 InvalidTagKey.Malformed The specified Tag.n.Key is not valid. Nilai Tag.N.Key tidak valid.
    400 RegionUnauthorized %s Anda tidak memiliki otorisasi untuk melakukan operasi ini di wilayah tersebut. %s adalah variabel. Pesan kesalahan dikembalikan secara dinamis berdasarkan kondisi pemanggilan.
    400 Zone.NotOnSale %s Sumber daya yang diminta tidak tersedia di zona yang ditentukan. %s adalah variabel. Pesan kesalahan dikembalikan secara dinamis berdasarkan kondisi pemanggilan.
    400 InvalidPeriodUnit.ValueNotSupported The specified parameter PeriodUnit is not valid. Nilai PeriodUnit tidak valid.
    400 InvalidTagValue.Malformed The specified Tag.n.Value is not valid. Nilai Tag.N.Value tidak valid.
    400 InvalidChargeType.ValueNotSupported ChargeType is not valid. Metode penagihan ini tidak didukung. Pilih metode penagihan lain.
    403 OperationDenied.NoStock The requested resource is sold out in the specified zone; try other types of resources or other regions and zones. Sumber daya yang diminta tidak tersedia di zona yang ditentukan. Coba tipe instans atau zona lain. Anda dapat memanggil operasi DescribeZones untuk mengecek sumber daya yang tersedia.
    403 OperationDenied Sales of this resource are temporarily suspended in the specified region; please try again later. Sumber daya yang diminta tidak tersedia di wilayah yang ditentukan. Coba lagi nanti.
    403 NodeControllerUnavailable The Node Controller is temporarily unavailable. Node controller tidak tersedia.
    403 OperationDenied The resource is out of usage. Instans tidak berada dalam status Running. Jalankan instans atau periksa apakah operasi yang ditentukan tidak valid.
    403 InvalidParameter.ResourceOwnerAccount ResourceOwnerAccount is Invalid. Nilai ResourceOwnerAccount tidak valid.
    403 Zone.NotOpen The specified zone is not granted to you to buy resources yet. Anda belum memiliki otorisasi untuk membeli sumber daya di zona yang ditentukan.
    403 Zone.NotOnSale The specified zone is not available for purchase. Sumber daya yang diminta tidak tersedia di zona yang ditentukan. Coba tipe instans lain atau pilih wilayah atau zona lain.
    403 InvalidParameter.NotMatch %s Nilai parameter tidak valid. Periksa apakah terdapat konflik parameter.
    403 Account.Arrearage Your account has been in arrears. Saldo akun tidak mencukupi. Tambahkan dana ke akun dan coba lagi.
    403 IncorrectInstanceStatus The current status of the resource does not support this operation. Operasi ini tidak dapat dilakukan pada sumber daya dalam status saat ini.
    403 OperationDenied.OnlyModifyName It is not allowed to modify the ReservedInstanceName only. Nama reserved instance tidak dapat dimodifikasi secara terpisah.
    500 InternalError The request processing has failed due to some unknown error. Terjadi kesalahan internal. Coba lagi nanti.
    500 InternalError %s Terjadi kesalahan internal.

    Untuk daftar kode kesalahan, lihat Service error codes.