All Products
Search
Document Center

:CreateDeploymentSet

Last Updated:May 25, 2026

Membuat deployment set di suatu wilayah.

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 CreateDeploymentSet

Operasi yang ingin Anda lakukan. Tetapkan nilainya ke CreateDeploymentSet.

RegionId String Yes cn-hangzhou

ID wilayah tempat pembuatan deployment set. Anda dapat memanggil operasi DescribeRegions untuk mengambil daftar wilayah terbaru.

OnUnableToRedeployFailedInstance String No CancelMembershipAndStart

Solusi darurat yang digunakan dalam situasi berikut: Instans dalam deployment set tidak dapat didistribusikan ke zona berbeda karena kekurangan resource setelah instans tersebut dialihkan (failover) dari mesin fisik yang rusak ke mesin fisik normal. Nilai yang valid:

  • CancelMembershipAndStart: menghapus instans dari deployment set dan segera me-restart instans setelah failover.
  • KeepStopped: membiarkan instans dalam keadaan abnormal dan me-restart-nya setelah resource tersedia kembali.

Nilai default: CancelMembershipAndStart.

Description String No testDescription

Deskripsi deployment set. Panjang deskripsi harus antara 2 hingga 256 karakter, dan tidak boleh dimulai dengan http:// atau https://.

ClientToken String No 123e4567-e89b-12d3-a456-426655440000

Token client yang digunakan untuk memastikan idempotensi permintaan. Anda dapat menghasilkan token ini di sisi client, tetapi harus memastikan bahwa token tersebut unik di antara permintaan yang berbeda. Token hanya boleh berisi karakter ASCII dan panjangnya tidak boleh lebih dari 64 karakter. Untuk informasi selengkapnya, lihat How to ensure idempotence.

DeploymentSetName String No testDeploymentSetName

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

Domain String No null
Catatan Parameter ini tidak lagi digunakan.
Granularity String No null
Catatan Parameter ini tidak lagi digunakan.
Strategy String No Availability

Strategi penyebaran. Nilai yang valid:

  • Availability: strategi ketersediaan tinggi
  • AvailabilityGroup: strategi kelompok ketersediaan tinggi
  • LowLatency: strategi latensi rendah

Nilai default: Availability.

GroupCount Long No 1

Jumlah kelompok deployment set dalam deployment set. Nilai yang valid: 1 hingga 7.

Nilai default: 3.

Catatan Parameter ini hanya berlaku ketika Strategy diatur ke AvailabilityGroup.

Response parameters

Parameter

Type

Example

Description

DeploymentSetId String ds-bp1frxuzdg87zh4pzq****

ID deployment set.

RequestId String 473469C7-AA6F-4DC5-B3DB-A3DC0DE3****

ID permintaan.

Examples

Contoh permintaan

http(s)://ecs.aliyuncs.com/?Action=CreateDeploymentSet
&RegionId=cn-hangzhou
&DeploymentSetName=testDeploymentSetName
&Strategy=Availability
&<Common request parameters>

Contoh respons sukses

XML format

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

<CreateDeploymentSetResponse>
    <DeploymentSetId>ds-bp1frxuzdg87zh4pzq****</DeploymentSetId>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3****</RequestId>
</CreateDeploymentSetResponse>

JSON format

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

{
  "DeploymentSetId" : "ds-bp1frxuzdg87zh4pzq****",
  "RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****"
}

Error codes

HTTP status code

Error code

Error message

Description

400 MissingParameter The input parameter RegionId that is mandatory for processing this request is not supplied. RegionId wajib diisi.
400 InvalidDeploymentSetName.Malformed Specified deployment set name is not valid. Nilai DeploymentSetName tidak valid.
400 InvalidDescription.Malformed The specified parameter Description is not valid. Format Description tidak valid. Deskripsi harus terdiri dari 2 hingga 256 karakter dan tidak boleh dimulai dengan http:// atau https://.
400 InvalidParameter.Domain The specified parameter Domain is not valid. Nilai Domain tidak valid.
400 InvalidParameter.Strategy The specified parameter Strategy is not valid. Nilai Strategy tidak valid.
400 InvalidParameter.granularity The specified parameter Granularity is not valid. Nilai Granularity tidak valid.
400 DependencyViolation.domain.granularity The DeploymentSet domain and granularity is violation. Parameter Domain dan Granularity yang ditentukan tidak sesuai satu sama lain.
400 DependencyViolation.strategy.granularity The DeploymentSet strategy and granularity is violation. Parameter Strategy dan Granularity yang ditentukan tidak sesuai satu sama lain.
400 DeploymentSet.GroupQuotaFull The deploymentSet group quota is full. Jumlah kelompok deployment set dalam deployment set melebihi kuota.
400 InvalidParameter.GroupCount The specified parameter "GroupCount" is not valid. Nilai GroupCount tidak valid.
400 InvalidZoneId.NotFound The zoneId provided does not exist in our records. ID zona yang ditentukan tidak ditemukan.
400 QuotaExceed.DeploymentSet The deploymentSet quota is full. Kuota deployment set telah habis.

Untuk daftar kode kesalahan lengkap, lihat Service error codes.