All Products
Search

This Product

    :AllocateDedicatedHosts

    Document Center

    :AllocateDedicatedHosts

    Last Updated:May 25, 2026

    Membuat satu atau beberapa host khusus berjenis pay-as-you-go atau subscription. Host khusus adalah server fisik yang didedikasikan untuk satu penyewa tunggal. Anda dapat membuat Instance Elastic Compute Service (ECS) pada host khusus tersebut dan melihat atributnya.

    Description

    Sebelum membuat host khusus, Anda dapat memanggil operasi DescribeAvailableResource untuk mengkueri resource yang tersedia di wilayah atau zona tertentu.

    Kami menyarankan agar Anda memahami metode penagihan resource sebelum membuat host khusus. Anda akan dikenai biaya atas resource yang digunakan oleh host khusus yang dibuat. Untuk informasi selengkapnya, lihat Billing overview.

    • Anda dapat membuat hingga 100 host khusus berjenis pay-as-you-go atau subscription dalam satu permintaan.
    • Setelah host khusus dibuat, Anda dapat menggunakan ID host khusus yang dikembalikan sebagai nilai parameter permintaan untuk memanggil operasi DescribeDedicatedHosts guna mengkueri status host tersebut.
    • Jika parameter tertentu tidak valid atau resource yang diminta tidak mencukupi, error akan dikembalikan setelah Anda mengirim permintaan pembuatan host khusus. Untuk informasi lebih lanjut mengenai penyebab error, lihat bagian "Error codes" pada topik ini.
    • Setelah host khusus dibuat, Anda dapat memanggil operasi ModifyInstanceDeployment untuk memigrasikan Instance ECS dari host bersama ke host khusus tersebut, atau memigrasikan Instance ECS dari host khusus lain ke host khusus yang baru dibuat.

    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

    Parameter Type Required Example Description
    Action String Yes AllocateDedicatedHosts

    Operasi yang ingin Anda lakukan. Tetapkan nilainya ke AllocateDedicatedHosts.

    RegionId String Yes cn-hangzhou

    ID wilayah tempat host khusus akan dibuat. Anda dapat memanggil operasi DescribeRegions untuk mengkueri daftar wilayah terbaru.

    Tag.N.Key String No Environment

    Kunci tag N yang akan ditambahkan ke host khusus. Nilai N yang valid: 1 hingga 20.

    Kunci tag tidak boleh berupa string kosong. Panjangnya maksimal 128 karakter dan tidak boleh diawali dengan acs: atau aliyun. Kunci tag juga tidak boleh mengandung http:// atau https://.

    Tag.N.Value String No Production

    Nilai tag N yang akan ditambahkan ke host khusus. Nilai N yang valid: 1 hingga 20.

    Nilai tag boleh berupa string kosong. Panjangnya maksimal 128 karakter dan tidak boleh diawali dengan acs: atau mengandung http:// atau https://.

    ResourceGroupId String No rg-bp67acfmxazb4ph***

    ID kelompok sumber daya tempat host khusus akan ditugaskan.

    ZoneId String No cn-hangzhou-f

    ID zona tempat host khusus akan dibuat.

    Parameter ini kosong secara default. Jika Anda tidak menentukan zona, sistem akan memilih zona secara otomatis.

    DedicatedHostName String No myDDH

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

    DedicatedHostClusterId String No dc-bp12wlf6am0vz9v2****

    ID kluster host khusus tempat host khusus akan dibuat.

    DedicatedHostType String Yes ddh.c5

    Tipe host khusus. Anda dapat memanggil operasi DescribeDedicatedHostTypes untuk mengkueri daftar tipe host khusus terbaru.

    ActionOnMaintenance String No Migrate

    Kebijakan yang digunakan untuk memigrasikan instans yang diterapkan pada host khusus ketika host khusus mengalami kegagalan atau perlu diperbaiki secara online. Nilai yang valid:

    • Migrate: Instans dimigrasikan ke server fisik lain dan dimulai ulang.

      Jika disk cloud disambungkan ke host khusus, nilai default-nya adalah Migrate.

    • Stop: Instans dihentikan. Jika host khusus tidak dapat diperbaiki, instans dimigrasikan ke mesin fisik lain lalu dimulai ulang.

      Jika disk lokal disambungkan ke host khusus, nilai default-nya adalah Stop.

    NetworkAttributes.SlbUdpTimeout Integer No 60

    Periode timeout untuk sesi UDP antara Instance Server Load Balancer (SLB) dan host khusus. Satuan: detik. Nilai yang valid: 15 hingga 310.

    NetworkAttributes.UdpTimeout Integer No 60

    Periode timeout untuk sesi UDP antara pengguna dan Layanan Alibaba Cloud pada host khusus. Satuan: detik. Nilai yang valid: 15 hingga 310.

    Description String No This-is-my-DDH

    Deskripsi host khusus. Deskripsi harus terdiri dari 2 hingga 256 karakter dan tidak boleh diawali dengan http:// atau https://.

    AutoPlacement String No off

    Menentukan apakah host khusus akan ditambahkan ke kolam sumber daya untuk penyebaran otomatis. Jika Anda membuat Instance ECS pada host khusus tanpa menentukan parameter DedicatedHostId, Alibaba Cloud akan memilih host khusus dari kolam sumber daya untuk menjalankan instans tersebut. Untuk informasi selengkapnya, lihat Automatic deployment. Nilai yang valid:

    • on: menambahkan host khusus ke kolam sumber daya untuk penyebaran otomatis.
    • off: tidak menambahkan host khusus ke kolam sumber daya untuk penyebaran otomatis.

    Nilai default: on.

    Catatan Jika Anda tidak ingin menambahkan host khusus ke kolam sumber daya untuk penyebaran otomatis, tetapkan nilainya ke off.
    CpuOverCommitRatio Float No 1

    Rasio overcommit CPU. Anda hanya dapat mengonfigurasi rasio overcommit CPU untuk tipe host khusus berikut: g6s, c6s, dan r6s. Nilai yang valid: 1 hingga 5.

    Rasio overcommit CPU memengaruhi jumlah vCPU yang tersedia pada host khusus. Anda dapat menggunakan rumus berikut untuk menghitung jumlah vCPU yang tersedia pada host khusus: Jumlah vCPU yang tersedia = Jumlah core CPU fisik × 2 × rasio overcommit CPU. Sebagai contoh, jumlah core CPU fisik pada setiap host khusus g6s adalah 52. Jika Anda menetapkan rasio overcommit CPU host khusus g6s ke 4, jumlah vCPU yang tersedia pada host khusus tersebut adalah 416. Untuk skenario yang memiliki persyaratan minimal terhadap stabilitas CPU atau beban CPU tidak berat, seperti lingkungan pengembangan dan pengujian, Anda dapat meningkatkan jumlah vCPU yang tersedia pada host khusus dengan menaikkan rasio overcommit CPU. Dengan cara ini, Anda dapat menerapkan lebih banyak Instance ECS dengan spesifikasi yang sama pada host khusus dan mengurangi biaya penerapan per unit.

    MinQuantity Integer No 2

    Jumlah minimum host khusus yang akan dibuat. Nilai yang valid: 1 hingga 100.

    Catatan Jika jumlah host khusus yang dapat dibuat berdasarkan resource yang tersedia kurang dari jumlah minimum yang ditentukan, pembuatan host khusus akan gagal.
    ChargeType String No PrePaid

    Metode penagihan host khusus. Nilai yang valid:

    • PrePaid: subscription. Jika Anda menetapkan parameter ini ke PrePaid, pastikan saldo akun atau kredit Anda mencukupi. Jika tidak, InvalidPayMethod akan dikembalikan.
    • PostPaid: pay-as-you-go.

    Nilai default: PostPaid.

    Quantity Integer No 2

    Jumlah host khusus yang ingin Anda buat. Nilai yang valid: 1 hingga 100.

    Nilai default: 1.

    Period Integer No 6

    Durasi langganan host khusus. Parameter Period wajib diisi dan hanya berlaku ketika parameter ChargeType ditetapkan ke PrePaid. Nilai yang valid:

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

    Unit durasi langganan host khusus. Nilai yang valid:

    • Month
    • Year

    Nilai default: Month.

    AutoRenew Boolean No false

    Menentukan apakah host khusus berlangganan akan diperpanjang secara otomatis.

    Catatan Parameter AutoRenew hanya berlaku ketika parameter ChargeType ditetapkan ke PrePaid.

    Nilai default: false.

    AutoRenewPeriod Integer No 1

    Durasi perpanjangan otomatis host khusus. Parameter AutoRenewPeriod hanya berlaku dan wajib diisi ketika parameter AutoRenew ditetapkan ke true. Nilai yang valid:

    Nilai yang valid ketika PeriodUnit ditetapkan ke Month: 1, 2, 3, 6, dan 12.

    AutoReleaseTime String No 2019-08-21T12:30:24Z

    Waktu pelepasan otomatis host khusus. Tentukan waktu dalam format standar ISO 8601 dengan pola yyyy-MM-ddTHH:mm:ssZ. Waktu harus dalam UTC.

    Catatan
    • Harus setidaknya setengah jam setelah waktu saat ini.
    • Harus paling lama tiga tahun setelah waktu saat ini.
    • Jika nilai detik (ss) bukan 00, nilai tersebut akan diatur otomatis menjadi 00.
    ClientToken String No 123e4567-e89b-12d3-a456-426655440000

    Token klien yang digunakan untuk memastikan idempotensi permintaan. Anda dapat menghasilkan nilainya dari sisi klien, tetapi pastikan nilainya unik di antara permintaan yang berbeda. Nilai ClientToken hanya boleh mengandung 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 E2A664A6-2933-4C64-88AE-5033D003****

    ID permintaan.

    DedicatedHostIdSets Array of String "DedicatedHostIdSets":{"DedicatedHostId":["dh-bp67acfmxazb4p****", "dh-bp67acfmxazb4d****"]}

    ID host khusus.

    Examples

    Contoh permintaan

    http(s)://ecs.aliyuncs.com/?Action=AllocateDedicatedHosts
&RegionId=cn-hangzhou
&DedicatedHostType=ddh.sn1ne
&Quantity=2
&ChargeType=PostPaid
&ClientToken=123e4567-e89b-12d3-a456-426655440000
&<Common request parameters>

    Contoh respons sukses

    XML format

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

<AllocateDedicatedHostsResponse>
    <RequestId>E2A664A6-2933-4C64-88AE-5033D003EADF</RequestId>
    <DedicatedHostIdSets>
        <DedicatedHostId>dh-bp67acfmxazb4p****</DedicatedHostId>
        <DedicatedHostId>dh-bp67acfmxazb4d****</DedicatedHostId>
    </DedicatedHostIdSets>
</AllocateDedicatedHostsResponse>

    JSON format

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

{
  "RequestId" : "E2A664A6-2933-4C64-88AE-5033D003EADF",
  "DedicatedHostIdSets" : {
    "DedicatedHostId" : [ "dh-bp67acfmxazb4p****", "dh-bp67acfmxazb4d****" ]
  }
}

    Error codes

    HTTP status code Error code Error message Description
    400 InvalidInstanceType.ValueUnauthorized The specified InstanceType is not authorized. Pesan kesalahan yang dikembalikan karena Anda tidak memiliki otorisasi untuk menggunakan tipe instans yang ditentukan.
    400 InvalidDescription.Malformed The specified parameter "Description" is not valid. Pesan kesalahan yang dikembalikan karena parameter Description yang ditentukan tidak valid. Deskripsi harus terdiri dari 2 hingga 256 karakter dan tidak boleh diawali dengan http:// atau https://.
    400 InvalidParameter.Conflict The specified region and cluster do not match. Pesan kesalahan yang dikembalikan karena wilayah dan kluster yang ditentukan tidak saling berkorespondensi.
    400 InvalidAutoRenewPeriod.ValueNotSupported The specified autoRenewPeriod is not valid. Pesan kesalahan yang dikembalikan karena parameter AutoRenewPeriod yang ditentukan tidak valid.
    400 InvalidTagKey.Malformed The specified Tag.n.Key is not valid. Pesan kesalahan yang dikembalikan karena parameter Tag.N.Key yang ditentukan tidak valid.
    400 InvalidDedicatedHostType.ValueNotSupported %s Pesan kesalahan yang dikembalikan karena parameter DedicatedHostType yang ditentukan tidak valid.
    400 RegionUnauthorized %s Pesan kesalahan yang dikembalikan karena Anda tidak memiliki otorisasi untuk melakukan operasi di wilayah yang ditentukan. %s adalah variabel. Pesan kesalahan dikembalikan secara dinamis berdasarkan kondisi pemanggilan.
    400 Zone.NotOnSale %s Pesan kesalahan yang dikembalikan karena resource yang diminta tidak tersedia di zona yang ditentukan. %s adalah variabel. Pesan kesalahan dikembalikan secara dinamis berdasarkan kondisi pemanggilan.
    400 OperationDenied The specified DedicatedHostType or Zone is not available or not authorized. Pesan kesalahan yang dikembalikan karena tipe host khusus atau zona yang ditentukan tidak tersedia atau Anda tidak memiliki otorisasi untuk mengelola resource tersebut.
    400 InvalidPeriodUnit.ValueNotSupported The specified parameter PeriodUnit is not valid. Pesan kesalahan yang dikembalikan karena parameter PeriodUnit yang ditentukan tidak valid.
    400 InvalidTagValue.Malformed The specified Tag.n.Value is not valid. Pesan kesalahan yang dikembalikan karena parameter Tag.N.Value yang ditentukan tidak valid.
    400 QuotaExceed.AfterpayDedicatedHost The maximum number of Pay-As-You-Go DedicatedHosts is exceeded: %s Pesan kesalahan yang dikembalikan karena resource pay-as-you-go untuk tipe host khusus yang ditentukan tidak mencukupi. Kurangi jumlah host khusus yang akan dibuat.
    400 InvalidChargeType.ValueNotSupported ChargeType is not valid Pesan kesalahan yang dikembalikan karena parameter ChargeType yang ditentukan tidak valid.
    400 InvalidParameter.SlbUdpTimeout The specified value is invalid. Pesan kesalahan yang dikembalikan karena parameter NetworkAttributes.SlbUdpTimeout yang ditentukan tidak valid.
    400 InvalidParameter.UdpTimeout The specified value is invalid. Pesan kesalahan yang dikembalikan karena parameter NetworkAttributes.UdpTimeout yang ditentukan tidak valid.
    400 Duplicate.TagKey The Tag.N.Key contain duplicate key. Pesan kesalahan yang dikembalikan karena kunci tag yang ditentukan sudah ada. Kunci tag harus unik.
    403 OperationDenied The creation of Host to the specified Zone is not allowed. Pesan kesalahan yang dikembalikan karena Anda tidak memiliki otorisasi untuk membuat host khusus di zona yang ditentukan.
    403 OperationDenied.NoStock The requested resource is sold out in the specified zone; try other types of resources or other regions and zones. Pesan kesalahan yang dikembalikan karena resource yang diminta tidak tersedia di zona yang ditentukan. Coba tipe instans atau zona yang berbeda. Anda dapat memanggil operasi DescribeZones untuk mengkueri resource yang tersedia.
    403 OperationDenied Sales of this resource are temporarily suspended in the specified region; please try again later. Pesan kesalahan yang dikembalikan karena resource yang diminta tidak tersedia di wilayah yang ditentukan. Coba lagi nanti.
    403 NodeControllerUnavailable The Node Controller is temporarily unavailable. Pesan kesalahan yang dikembalikan karena node controller tidak tersedia.
    403 OperationDenied The resource is out of usage. Pesan kesalahan yang dikembalikan karena instans tidak berada dalam status Running. Mulai instans tersebut atau periksa apakah operasi yang ditentukan valid.
    403 InvalidParameter.ResourceOwnerAccount ResourceOwnerAccount is Invalid. Pesan kesalahan yang dikembalikan karena parameter ResourceOwnerAccount yang ditentukan tidak valid.
    403 Zone.NotOpen The specified zone is not granted to you to buy resources yet. Pesan kesalahan yang dikembalikan karena Anda tidak memiliki otorisasi untuk membeli resource di zona yang ditentukan.
    403 Zone.NotOnSale The specified zone is not available for purchase. Pesan kesalahan yang dikembalikan karena resource yang diminta tidak tersedia di zona yang ditentukan. Coba tipe instans yang berbeda atau pilih wilayah atau zona yang berbeda.
    403 InvalidDedicatedHostType.ValueNotSupported The specified DedicatedHostType does not exist or beyond the permitted range. Pesan kesalahan yang dikembalikan karena parameter DedicatedHostType yang ditentukan tidak ada.
    403 InvalidDedicatedHostType.ZoneNotSupported The specified zone does not support this dedicatedHostType. Pesan kesalahan yang dikembalikan karena tipe host khusus yang ditentukan tidak didukung di zona yang ditentukan.
    403 InvalidParameter.NotMatch %s Pesan kesalahan yang dikembalikan karena parameter yang ditentukan tidak valid. Periksa apakah terdapat konflik parameter.
    403 Account.Arrearage Your account has been in arrears. Pesan kesalahan yang dikembalikan karena saldo akun Anda tidak mencukupi. Tambahkan dana ke Akun Alibaba Cloud Anda dan coba lagi.
    404 OperationDenied Another Host has been creating Pesan kesalahan yang dikembalikan karena host lain sedang dalam proses pembuatan.
    404 PaymentMethodNotFound No payment method has been registered on the account. Pesan kesalahan yang dikembalikan karena Anda belum mengonfigurasi metode pembayaran untuk akun Anda.
    404 InvalidDedicatedHostName.Malformed The specified parameter DedicatedHostName is not valid. Pesan kesalahan yang dikembalikan karena parameter DedicatedHostName yang ditentukan tidak valid.
    500 InternalError The request processing has failed due to some unknown error. Pesan kesalahan yang dikembalikan karena terjadi kesalahan internal. Coba lagi nanti.
    500 InternalError %s Pesan kesalahan yang dikembalikan karena terjadi kesalahan internal.

    Untuk daftar kode kesalahan, kunjungi API Error Center.