All Products
Search

This Product

    Elastic Compute Service:CreateElasticityAssurance

    Document Center

    Elastic Compute Service:CreateElasticityAssurance

    Last Updated:Jun 12, 2026

    Membuat jaminan elastisitas dengan menentukan parameter seperti zona di region tempat jaminan elastisitas berada, tipe instance, durasi pembelian, dan apakah akan mengaktifkan perpanjangan otomatis.

    Deskripsi operasi

    Jaminan elastisitas adalah metode pembelian dan penggunaan sumber daya baru yang menggabungkan fleksibilitas dan kepastian. Ini adalah layanan reservasi sumber daya yang menyediakan jaminan deterministik untuk instance ECS pay-as-you-go. Untuk informasi lebih lanjut, lihat Tinjauan jaminan elastisitas.

    • Setelah Anda membeli jaminan elastisitas, jaminan elastisitas reguler mendukung pengembalian dana, tetapi jaminan elastisitas tersegmentasi waktu tidak. Untuk detail penagihan, lihat Jaminan sumber daya.

    • Anda hanya dapat menggunakan jaminan elastisitas untuk membuat instance ECS yang menggunakan metode penagihan pay-as-you-go.

    • Saat ini, jumlah jaminan elastisitas hanya mendukung mode unlimited. Artinya, parameter AssuranceTimes hanya dapat diatur ke Unlimited. Setelah jaminan elastisitas mode unlimited mulai berlaku, ia akan dijalankan secara otomatis.

    Coba sekarang

    Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

    Test

    RAM authorization

    Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

    • Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.

    • API: API yang dapat Anda panggil untuk melakukan aksi tersebut.

    • Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.

    • Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.

      • Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.

      • Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.

    • Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.

    • Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

    Action

    Access level

    Resource type

    Condition key

    Dependent action

    ecs:CreateElasticityAssurance

    create

    *ElasticityAssurance

    acs:ecs:{#regionId}:{#accountId}:elasticityassurance/*

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    RegionId

    string

    Yes

    ID region dari jaminan elastisitas. Anda dapat memanggil DescribeRegions untuk menanyakan daftar region Alibaba Cloud terbaru.

    cn-hangzhou
    ResourceGroupId

    string

    No

    ID grup sumber daya tempat jaminan elastisitas berada.

    rg-bp67acfmxazb4p****
    Tag

    array<object>

    No

    Daftar tag dari jaminan elastisitas.

    object

    No

    Informasi pasangan tag.

    Value

    string

    No

    Nilai tag dari jaminan elastisitas. Nilai valid N: 1 sampai 20. Setelah suatu nilai diteruskan, string kosong diperbolehkan. Nilai dapat memiliki panjang hingga 128 karakter, tidak boleh diawali dengan acs:, dan tidak boleh mengandung http:// atau https://.

    TestValue
    Key

    string

    No

    Kunci tag dari jaminan elastisitas. Nilai valid N: 1 sampai 20. Setelah suatu nilai diteruskan, string kosong tidak diperbolehkan. Nilai dapat memiliki panjang hingga 128 karakter, tidak boleh diawali dengan aliyun atau acs:, dan tidak boleh mengandung http:// atau https://.

    TestKey
    Period

    integer

    No

    Durasi pembelian. Satuan durasi ditentukan oleh parameter PeriodUnit. Nilai valid:

    • Ketika PeriodUnit diatur ke Month, nilai valid adalah: 1, 2, 3, 4, 5, 6, 7, 8, dan 9.

    • Ketika PeriodUnit diatur ke Year, nilai valid adalah: 1, 2, 3, 4, dan 5.

    • Ketika PeriodUnit diatur ke Day, nilai valid adalah: 1 sampai 365.

    Nilai default: 1.

    1
    PeriodUnit

    string

    No

    Satuan durasi pembelian. Nilai valid:

    • Month

    • Year

    • Day
      Catatan

      Ketika PeriodUnit diatur ke Day, Anda juga harus menentukan RecurrenceRules, yang menunjukkan bahwa Anda sedang membuat jaminan elastisitas tersegmentasi waktu.

    Nilai default: Year.

    Year
    ClientToken

    string

    No

    Token klien yang digunakan untuk memastikan idempotensi permintaan. Anda dapat menggunakan klien untuk menghasilkan nilai, tetapi Anda harus memastikan bahwa itu unik di antara permintaan yang berbeda. Nilai ClientToken hanya dapat berisi karakter ASCII dan tidak boleh melebihi 64 karakter panjangnya. Untuk informasi lebih lanjut, lihat Cara memastikan idempotensi.

    0c593ea1-3bea-11e9-b96b-88e9fe637760
    PrivatePoolOptions.Name

    string

    No

    Nama jaminan elastisitas. Nama harus memiliki panjang 2 sampai 128 karakter. Harus diawali dengan huruf atau karakter Cina dan tidak boleh diawali dengan http:// atau https://. Nama dapat berisi huruf, angka, titik dua (:), garis bawah (_), dan tanda hubung (-).

    eapTestName
    Description

    string

    No

    Deskripsi jaminan elastisitas. Deskripsi harus memiliki panjang 2 sampai 256 karakter dan tidak boleh diawali dengan http:// atau https://.

    Parameter ini dibiarkan kosong secara default.

    This is description.
    PrivatePoolOptions.MatchCriteria

    string

    No

    Mode pencocokan dari jaminan elastisitas. Nilai valid:

    • Open: mode terbuka. Jaminan elastisitas secara otomatis mencocokkan kapasitas private pool tipe open ketika instance dijalankan. Jika tidak ada kapasitas private pool yang memenuhi syarat, sumber daya public pool digunakan untuk menjalankan instance.

    • Target: mode tertarget. Kapasitas private pool yang ditentukan digunakan ketika instance dijalankan. Jika kapasitas private pool tidak tersedia, instance gagal dijalankan.

    Nilai default: Open.

    Open
    AssuranceTimes

    string

    No

    Total jumlah kali jaminan elastisitas dapat digunakan. Nilai: Unlimited. Hanya mode unlimited yang didukung dalam periode validitas layanan.

    Nilai default: Unlimited.

    Unlimited
    InstanceAmount

    integer

    No

    Total jumlah instance yang perlu dicadangkan dalam suatu tipe instance.

    Nilai valid: 1 sampai 1000.

    Penting Parameter ini wajib diisi.

    2
    InstanceCpuCoreCount

    integer

    No

    Catatan

    Parameter ini sudah usang.

    null
    StartTime

    string

    No

    Waktu kapan jaminan elastisitas mulai berlaku. Nilai default adalah waktu ketika operasi CreateElasticityAssurance dipanggil untuk membuat jaminan elastisitas. Tentukan waktu dalam standar ISO 8601 dengan format yyyy-MM-ddTHH:mm:ssZ. Waktu harus dalam UTC. Untuk informasi lebih lanjut, lihat ISO 8601.

    2020-10-30T06:32:00Z
    ZoneId

    array

    Yes

    ID zona di region tempat jaminan elastisitas dibuat. Saat ini, jaminan elastisitas hanya dapat dibuat dalam satu zona.

    cn-hangzhou-h

    string

    No

    ID zona di region tempat jaminan elastisitas dibuat.

    cn-hangzhou-h
    InstanceType

    array

    Yes

    Tipe instance. Saat ini, jaminan elastisitas hanya mendukung satu tipe instance.

    ecs.c6.xlarge

    string

    No

    Tipe instance.

    ecs.c6.xlarge
    RecurrenceRules

    array<object>

    No

    Daftar aturan perulangan dari jaminan elastisitas tersegmentasi waktu.

    object

    No

    Aturan perulangan dari jaminan elastisitas tersegmentasi waktu.

    StartHour

    integer

    No

    Waktu mulai dari jaminan tersegmentasi waktu. Nilai harus tepat pada jam.

    Catatan

    Anda harus menentukan baik StartHour maupun EndHour, dan keduanya harus berjarak setidaknya 4 jam.

    4
    RecurrenceType

    string

    No

    Tipe aturan perulangan. Nilai valid:

    • Daily: Aturan dijalankan setiap hari.

    • Weekly: Aturan dijalankan setiap minggu.

    • Monthly: Aturan dijalankan setiap bulan.

    Catatan

    Anda harus menentukan baik RecurrenceType maupun RecurrenceValue.

    Daily
    EndHour

    integer

    No

    Waktu akhir dari jaminan tersegmentasi waktu. Nilai harus tepat pada jam.

    10
    RecurrenceValue

    string

    No

    Nilai dari aturan perulangan.

    • Ketika RecurrenceType diatur ke Daily, Anda hanya dapat menentukan satu nilai. Nilai valid: 1 sampai 31. Nilai ini menentukan seberapa sering aturan dijalankan dalam hari.

    • Ketika RecurrenceType diatur ke Weekly, Anda dapat menentukan beberapa nilai yang dipisahkan dengan koma (,). Nilai-nilai tersebut berturut-turut sesuai dengan Minggu, Senin, Selasa, Rabu, Kamis, Jumat, dan Sabtu: 0, 1, 2, 3, 4, 5, dan 6. Misalnya, 1,2 menunjukkan bahwa aturan dijalankan pada Senin dan Selasa.

    • Ketika RecurrenceType diatur ke Monthly, formatnya adalah A-B. Nilai valid dari A dan B: 1 sampai 31. B harus lebih besar dari atau sama dengan A. Misalnya, 1-5 menunjukkan bahwa aturan dijalankan setiap hari dari tanggal 1 sampai 5 setiap bulan.

    Catatan

    Anda harus menentukan baik RecurrenceType maupun RecurrenceValue.

    1
    AutoRenew

    boolean

    No

    Menentukan apakah perpanjangan otomatis diaktifkan. Nilai valid:

    • true: mengaktifkan perpanjangan otomatis.

    • false: menonaktifkan perpanjangan otomatis.

    Nilai default: false.

    true
    AutoRenewPeriod

    integer

    No

    Durasi perpanjangan otomatis. Satuan: bulan. Nilai valid: 1, 2, 3, 6, 12, 24, dan 36.

    • Ketika PeriodUnit=Month, nilai default adalah 1.

    • Ketika PeriodUnit=Year, nilai default adalah 12.

    Catatan

    Parameter ini wajib diisi ketika AutoRenew diatur ke True.

    1

    Elemen respons

    Element

    Type

    Description

    Example

    object

    RequestId

    string

    ID permintaan.

    473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
    PrivatePoolOptionsId

    string

    ID dari jaminan elastisitas.

    eap-bp67acfmxazb4****
    OrderId

    string

    ID dari order yang dihasilkan.

    1234567890

    Contoh

    Respons sukses

    JSONformat

    {
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "PrivatePoolOptionsId": "eap-bp67acfmxazb4****",
  "OrderId": "1234567890"
}

    Kode kesalahan

    HTTP status code

    Error code

    Error message

    Description
    400 InvalidOperation.PeriodUnitUnsupported TimeDivisionElasticityAssurance only supports PeriodUnit of Day.
    400 InvalidParameter.RegionId The specified RegionId is invalid.
    400 OperationDenied The specified instanceType or zone is not available or not authorized.
    400 MissingParameter.RegionId The specified RegionId should not be null.
    400 InvalidStartTime.NotSupported The specified StartTime should be within 180 calendar days from the current date, and you must specify a precision to hour.
    400 InvalidStartTime.MalFormed The specified StartTime is out of the permitted range.
    400 Invalid.PrivatePoolOptionsName.MalFormed The specified PrivatePoolOptions.Name is not valid.
    400 Invalid.ZoneId The specified ZoneId is not valid.
    400 Invalid.InstanceType The specified InstanceType is not valid.
    400 DedicatedHostNotSupported DedicatedHost is not supported for PrivatePool.
    400 SpotNotSupported Spot is not supported for PrivatePool.
    400 ClassicNetworkNotSupported Classic network is not supported for PrivatePool.
    400 Invalid.InstanceId Instance does not exist.
    400 Invalid.PrivatePoolOptions.MatchCriteria Target mode does not support this operation.
    400 MissingParameter.PrivatePoolOptions.Id The specified PrivatePoolOptions.Id should not be null.
    400 Invalid.PrivatePoolOptions.Id The PrivatePool does not exist.
    400 Invalid.InstanceChargeType The InstanceChargeType does not match the PrivatePool.
    400 Invalid.PrivatePoolOptions.status The PrivatePool status is not valid.
    400 InvalidPlatform.ValueNotSupported The Platform does not match the PrivatePool.
    400 InvalidAliUid The PrivatePool does not belong to the user of the Instance.
    400 MissingParameter.PackageType The specified parameter "PackageType" can not be empty.
    400 MissingParameter.PrivatePoolOptions.Ids The specified parameter "PrivatePoolOptions.Ids" can not be empty.
    400 MissingParameter.InstanceCpuCoreCount The specified parameter "InstanceCpuCoreCount" can not be empty.
    400 MissingParameter.InstanceAmount The specified parameter "InstanceAmount" can not be empty.
    400 MissingParameter.InstanceCpuCoreCountOrInstanceAmount The specified parameter "InstanceCpuCoreCount" and "InstanceAmount" must not be empty at the same time.
    400 Invalid.TooManyPrivatePoolOptions.Ids Too many PrivatePoolOptions.Ids in this request.
    400 Invalid.TooManyZoneIds Too many ZoneIds in the request.
    400 Invalid.TooManyInstanceTypes Too many InstanceTypes in the request.
    400 Invalid.TooManyUnpaidPrivatePool Too many PrivatePools create but still unpaid.
    400 Invalid.InstanceCpuCoreCountOrInstanceAmount Both InstanceCpuCoreCount and InstanceAmount are provided.
    400 Invalid.PrivatePoolOptions.Ids The specified parameter "PrivatePoolOptions.Ids" exist invalid element Id.
    400 Invalid.PackageType The specified parameter "PackageType" is invalid.
    400 Invalid.PrivatePool.Purchase The PrivatePool has already paid.
    400 Invalid.AssuranceTimes.NotSupported The value of AssuranceTimes is not supported.
    400 RepeatStartPrivatePool PrivatePool has already been started.
    400 Invalid.PeriodUnit Only Month or Year is supported for PeriodUnit.
    400 AccountForbidden.ProductCreationLimited The commodity must be officially operated by Aliyun and in pay-as-you-go billing method.
    400 RegionUnauthorized There is no authority to create private pool in the specified region.
    400 PriceNotFound The price of your queried resource is not available now, please try other resources.
    400 InvalidRecurrenceRules.CountLimitExceeded The count of RecurrenceRules exceeds the limit.
    400 InvalidRecurrenceRulesStartHourEndHour.TooShort The recurrence hour between RecurrenceRules.StartHour and RecurrenceRules.EndHour is too short.
    400 InvalidParameter.RecurrenceRulesStartHourEndHour The specified parameter RecurrenceRules.StartHour or RecurrenceRules.EndHour is invalid.
    400 InvalidParameter.RecurrenceRulesRecurrenceValueMonthly The specified parameter RecurrenceRules.RecurrenceValue for Monthly is invalid.
    400 InvalidParameter.RecurrenceRulesRecurrenceValueWeekly The specified parameter RecurrenceRules.RecurrenceValue for Weekly is invalid.
    400 InvalidParameter.RecurrenceRulesRecurrenceValueDaily The specified parameter RecurrenceRules.RecurrenceValue for Daily is invalid.
    400 InvalidParameter.RecurrenceRulesRecurrenceType The specified parameter RecurrenceRules.RecurrenceType is invalid.
    400 InvalidAutoRenewPeriod.ValueNotSupported The specified autoRenewPeriod is invalid.
    400 InvalidOperation.ElasticityAssuranceActiveTimeTooShort The total active time of the ElasticityAssurance is too short.
    500 InternalError The request processing has failed due to some unknown error, exception or failure.
    403 Zone.NotOpen The specified zone is not granted to you to buy resources yet.
    403 InvalidResourceType.NotSupported %s
    403 OperationDenied.NoStock The resource is out of stock in the specified zone. Please try other types, or choose other regions and zones.
    403 InvalidInstanceType.NotSupported The specified InstanceType is invalid.
    403 Invalid.ZoneIds At least one of the specified ZoneIds are invalid.
    403 Zone.NotOnSale The specified zone is not available for purchase.
    403 QuotaExceed.ElasticityAssuranceCapacity ElasticityAssurance Capacity quota exceeded.
    403 InvalidAccount.NotSupportEA According to business rules, this account cannot purchase ECS ElasticityAssurance.
    404 InvalidZoneId.NotFound The specified zoneId does not exist.
    404 InvalidResourceGroup.NotFound The ResourceGroup provided does not exist in our records.

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.