All Products
Search

This Product

    :RenewDedicatedHosts

    Document Center

    :RenewDedicatedHosts

    Last Updated:May 25, 2026

    Memperbarui satu atau beberapa host khusus berlangganan.

    Description

    When you renew subscription dedicated hosts, vouchers are used first by default. Make sure that your account supports credit card payments or balance payments.

    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 untuk berbagai SDK.

    Request parameters

    Parameter Type Required Example Description
    Action String Yes RenewDedicatedHosts

    Operasi yang ingin Anda lakukan. Tetapkan nilainya ke RenewDedicatedHosts.
    DedicatedHostIds String Yes dh-bp199lyny9b3****

    Daftar ID dedicated host. Anda dapat menentukan ID hingga 100 dedicated host subscription. Tentukan ID dedicated host dalam bentuk array JSON. Contoh: ["dh-xxxxxxxxx", "dh-yyyyyyyyy", … "dh-zzzzzzzzz"]. Pisahkan ID dengan koma (,).
    RegionId String Yes cn-hangzhou

    ID wilayah dari dedicated host. Anda dapat memanggil operasi DescribeRegions untuk mengambil daftar wilayah terbaru.
    Period Integer Yes 1

    Durasi perpanjangan. Nilai yang valid:

    • Nilai yang valid ketika parameter PeriodUnit diatur ke Month: 1, 2, 3, 4, 5, 6, 7, 8, 9, 12, 24, 36, 48, dan 60.
    • Nilai yang valid ketika parameter PeriodUnit diatur ke Year: 1, 2, 3, 4, dan 5.
    PeriodUnit String No Month

    Unit durasi perpanjangan. Nilai yang valid:

    • Month
    • Year

    Nilai default: Month.
    ClientToken String No 123e4567-e89b-12d3-a456-426655440000

    Token client yang digunakan untuk memastikan idempotensi permintaan. Anda dapat menggunakan client untuk menghasilkan token client. Pastikan token client yang unik digunakan untuk permintaan yang berbeda. Token hanya boleh berisi karakter ASCII dan panjangnya tidak boleh melebihi 64 karakter. Untuk informasi selengkapnya, lihat How to ensure idempotence.

    Response parameters

    Parameter Type Example Description
    RequestId String 2A4EA075-CB5B-41B7-B0EB-70D339F6****

    ID permintaan.

    Examples

    Contoh permintaan

    http(s)://ecs.aliyuncs.com/?Action=RenewDedicatedHosts
&DedicatedHostIds=dh-bp199lyny9b3****
&Period=1
&PeriodUnit=Month
&RegionId=cn-hangzhou
&<Common request parameters>

    Contoh respons sukses

    XML format

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

<RenewDedicatedHostsResponse>
    <RequestId>2A4EA075-CB5B-41B7-B0EB-70D339F6****</RequestId>
</RenewDedicatedHostsResponse>

    JSON format

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

{
  "RequestId" : "2A4EA075-CB5B-41B7-B0EB-70D339F6****"
}

    Error codes

    HttpCode Error code Error message Description
    400 IdempotenceParamNotMatch Request uses a client token in a previous request but is not identical to that request. Pesan kesalahan yang dikembalikan karena permintaan ini dan permintaan sebelumnya menggunakan client token yang sama tetapi memiliki parameter yang berbeda.
    400 InvalidClientToken.ValueNotSupported The ClientToken provided is invalid. Pesan kesalahan yang dikembalikan karena parameter ClientToken yang ditentukan tidak valid.
    400 InvalidPeriod The specified period is not valid. Pesan kesalahan yang dikembalikan karena parameter Period yang ditentukan tidak valid.
    400 InvalidPeriodUnit.ValueNotSupported The specified parameter PeriodUnit is not valid. Pesan kesalahan yang dikembalikan karena parameter PeriodUnit yang ditentukan tidak valid.
    400 InvalidDedicatedHostId.NotFound The specified DedicatedHostId does not exist. Pesan kesalahan yang dikembalikan karena dedicated host yang ditentukan tidak ada.
    400 InvalidStatus.Upgrading The dedicated host is upgrading, please try it later. Pesan kesalahan yang dikembalikan karena dedicated host yang ditentukan sedang dalam proses peningkatan. Coba lagi nanti.
    400 LastOrderProcessing The previous order is still processing, please try again later. Pesan kesalahan yang dikembalikan karena pesanan sedang diproses. Coba lagi nanti.
    500 InternalError The request processing has failed due to some unknown error. Pesan kesalahan yang dikembalikan karena terjadi kesalahan internal. Coba lagi nanti.
    403 IncorrectHostStatus The 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.
    403 LastTokenProcessing The last token request is processing. Pesan kesalahan yang dikembalikan karena permintaan token sedang diproses. Coba lagi nanti.

    For a list of error codes, see Service error codes.