All Products
Search

This Product

    :ModifyInstanceAutoRenewAttribute

    Document Center

    :ModifyInstanceAutoRenewAttribute

    Last Updated:May 22, 2026

    Konfigurasikan perpanjangan otomatis untuk satu atau beberapa instans subscription. Untuk mengurangi beban kerja pemeliharaan saat instans kedaluwarsa, Anda dapat mengaktifkan perpanjangan otomatis pada instans subscription.

    Description

    Sebelum memanggil operasi ini, pastikan Anda memahami metode penagihan dan jadwal harga ECS. Untuk informasi selengkapnya, lihat halaman produk Elastic Compute Service.

    • Pembayaran untuk perpanjangan otomatis pertama kali dipotong secara otomatis pada pukul 08.00.00 (UTC+8), sembilan hari sebelum instans kedaluwarsa.

    • Jika upaya pemotongan pertama gagal, Alibaba Cloud akan mencoba memotong pembayaran setiap hari hingga pembayaran berhasil atau hingga instans terkunci setelah periode sembilan hari berakhir. Pastikan saldo akun atau kredit Anda mencukupi.

    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.

    Request parameters

    ParameterTypeRequiredExampleDescription
    ActionStringYesModifyInstanceAutoRenewAttribute

    Operasi yang ingin Anda lakukan. Tetapkan nilainya ke ModifyInstanceAutoRenewAttribute.

    InstanceIdStringYesi-bp67acfmxazb4ph****,i-bp67acfmxazb4pi****

    ID instans. Anda dapat menentukan ID hingga 100 instans subscription. Pisahkan ID instans dengan koma (,).

    RegionIdStringYescn-hangzhou

    ID wilayah instans. Anda dapat memanggil operasi DescribeRegions untuk mengambil daftar wilayah terbaru.

    DurationIntegerNo.1

    Periode perpanjangan otomatis untuk instans.

    • Nilai valid Duration saat PeriodUnit diatur ke Year (year): 1, 2, 3, 4, dan 5.
    • Nilai valid Duration saat PeriodUnit diatur ke Month (month): 1, 2, 3, 6, 12, 24, 36, 48, dan 60.
    AutoRenewBooleanNotrue

    Menentukan apakah akan mengaktifkan perpanjangan otomatis untuk instans.

    Nilai default: false.

    RenewalStatusStringNoAutoRenewal

    Status perpanjangan otomatis instans. Nilai valid:

    • AutoRenewal: Perpanjangan otomatis diaktifkan untuk instans.
    • Normal: Perpanjangan otomatis dinonaktifkan untuk instans.
    • NotRenewal: Instans tidak diperpanjang. Sistem tidak lagi mengirim notifikasi kedaluwarsa. Notifikasi perpanjangan dikirim tiga hari sebelum waktu kedaluwarsa instans. Anda dapat mengubah nilai parameter ini dari NotRenewal ke Normal untuk suatu instans, lalu memperpanjang instans tersebut secara manual. Atau, Anda dapat mengatur parameter RenewalStatus ke AutoRenewal.
    Catatan RenewalStatus memiliki prioritas lebih tinggi daripada AutoRenew. Jika Anda tidak menentukan RenewalStatus, parameter AutoRenew digunakan secara default.
    PeriodUnitStringNoMonth

    Unit periode perpanjangan (Duration). Nilai default: Month. Nilai valid:

    • Month
    • Year

    Response parameters

    ParameterTypeExampleDescription
    RequestIdString473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

    ID Wilayah.

    Examples

    Contoh permintaan

    https://ecs.aliyuncs.com/?Action=ModifyInstanceAutoRenewAttribute
&RegionId=cn-hangzhou
&InstanceId=i-bp67acfmxazb4ph****,i-bp67acfmxazb4pi****
&Duration=1
&PeriodUnit=Month
&AutoRenew=true
&<Common request parameters>

    Contoh respons sukses

    XML format

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

<ModifyInstanceAutoRenewAttributeResponse>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
</ModifyInstanceAutoRenewAttributeResponse>

    JSON format

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

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

    Error codes

    HTTP status codeError codeError messageDescription
    403MissingParameter.InstanceIdInstanceId should not be null.Pesan kesalahan yang dikembalikan karena parameter InstanceId tidak ditentukan.
    403InvalidParameter.ToManyInstanceIdsInstanceId should be less than 100.Pesan kesalahan yang dikembalikan karena jumlah total instans melebihi 100.
    403InvalidParameter.InvalidInstanceId%sPesan kesalahan yang dikembalikan karena parameter InstanceId yang ditentukan tidak valid.
    403IncorrectInstanceStatusThe current status of the resource does not support this operation.Pesan kesalahan yang dikembalikan karena operasi ini tidak didukung saat resource berada dalam status saat ini.
    403ChargeTypeViolationPay-As-You-Go instances do not support this operation.Pesan kesalahan yang dikembalikan karena operasi ini tidak didukung oleh instans pay-as-you-go. Periksa metode penagihan instans tersebut.
    403InvalidParameter.Duration%sPesan kesalahan yang dikembalikan karena parameter Period yang ditentukan tidak valid.
    403InvalidParameter.RenewalStatus%sPesan kesalahan yang dikembalikan karena parameter RenewalStatus yang ditentukan tidak valid.
    403InvalidPeriodUnit.ValueNotSupportedThe specified parameter PeriodUnit is not valid.Pesan kesalahan yang dikembalikan karena parameter PeriodUnit yang ditentukan tidak valid.
    403InvalidPeriod.StarterPackageThis instance was created by using a Starter Package plan and can only be renewed monthly, not yearly.Pesan kesalahan yang dikembalikan karena instance dibuat menggunakan paket Starter dan hanya dapat diperpanjang secara otomatis setiap bulan.
    500InternalErrorThe request processing has failed due to some unknown error.Pesan kesalahan yang dikembalikan karena terjadi kesalahan internal. Coba lagi nanti.

    Untuk daftar kode kesalahan, lihat Service error codes.