CreateInstances - Tair (Redis® OSS-Compatible) - Alibaba Cloud Documentation Center

Membuat beberapa instans Database Apsara for Tair (kompatibel Redis OSS) Edisi Klasik secara batch.

Deskripsi operasi

Sebelum memanggil operasi ini, pastikan Anda memahami sepenuhnya metode penagihan dan harga Database Apsara for Tair (kompatibel Redis OSS).

Catatan

Operasi ini hanya mendukung pembuatan instans Edisi Klasik. Kami menyarankan Anda menggunakan operasi API berikut untuk membuat satu instans:

CreateInstance: membuat instans Edisi Sumber Terbuka Redis atau instans Edisi Klasik Tair (Optimasi Memori).
CreateTairInstance: membuat instans Edisi Cloud-Native Tair (termasuk tipe Optimasi Memori, Memori Persisten, dan Berbasis Disk).

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

kvstore:CreateInstances

create

*DBInstance

acs:kvstore:{#regionId}:{#accountId}:instance/*

kvstore:InstanceClass
kvstore:InstanceType
kvstore:Appendonly

None

Parameter permintaan

Parameter	Type	Required	Description	Example
Instances	string	Yes	Informasi konfigurasi untuk instans baru, dalam format JSON. Untuk informasi lebih lanjut, lihat deskripsi tambahan parameter Instances.	[{ "RegionId": "cn-hangzhou", "izNo": "cn-hangzhou-b", "quantity": 1, "instanceType": "Redis", "instanceClass": "redis.logic.sharding.1g.2db.0rodb.4proxy.default", "EngineVersion": "5.0", "ChargeType":"PrePaid", "Period":"1", "networkType": "VPC" , "vpcId": "vpc-2zex6u1nu32k3ux35oxxx", "vSwitchId": "vsw-2zesk464e647104kw3xxx" }]
Token	string	No	Token idempotensi yang digunakan untuk memastikan idempotensi permintaan. Nilai dihasilkan oleh klien. Nilai harus unik di berbagai permintaan, bersifat case-sensitive, dan panjangnya tidak boleh melebihi 64 karakter ASCII.	ETnLKlblzczshOTUbOCz****
AutoPay	boolean	No	Apakah akan mengaktifkan pembayaran otomatis. Nilai valid: true: Mengaktifkan pembayaran otomatis. Ini adalah nilai default. false: Menonaktifkan pembayaran otomatis. Dalam hal ini, Anda harus masuk ke Konsol, klik Expenses > Renewal Management di bilah menu atas, lalu klik Order Management > My Orders di panel navigasi kiri untuk mencari pesanan target dan menyelesaikan pembayaran. Catatan Parameter ini hanya tersedia ketika parameter ChargeType di Instances diatur ke PrePaid.	true
BusinessInfo	string	No	Informasi ekstensi bisnis.	000000000
CouponNo	string	No	Kode kupon. Nilai default: `youhuiquan_promotion_option_id_for_blank`.	youhuiquan_promotion_option_id_for_blank
EngineVersion	string	No	Versi kompatibel Redis dari instans. Nilai valid: 4.0 dan 5.0. Catatan Nilai default: 5.0.	5.0
RebuildInstance	boolean	No	Apakah akan memulihkan dan membangun ulang instans sumber dari Keranjang daur ulang. Nilai valid: true: Ya. false: Tidak. Ini adalah nilai default. Catatan Parameter ini hanya tersedia ketika parameter SrcDBInstanceId ditentukan di Instances.	false
AutoRenew	string	No	Apakah akan mengaktifkan perpanjangan otomatis. Nilai valid: true: Mengaktifkan perpanjangan otomatis. false: Menonaktifkan perpanjangan otomatis. Ini adalah nilai default. Catatan Parameter ini hanya tersedia ketika parameter ChargeType di Instances diatur ke PrePaid.	false
ResourceGroupId	string	No	ID kelompok sumber daya.	rg-resourcegroupid1

Deskripsi tambahan parameter Instances

Nama	Tipe	Diperlukan	Contoh	Deskripsi
RegionId	String	Ya	cn-hangzhou	ID wilayah. Anda dapat memanggil DescribeRegions untuk mengkueri ID wilayah. Gunakan parameter ini untuk menentukan wilayah tempat instans dibuat.
IzNo	String	Ya	cn-hangzhou-b	ID zona utama. Anda dapat memanggil DescribeRegions untuk mengkueri ID zona. Gunakan parameter ini untuk menentukan zona tempat instans dibuat.
Quantity	Integer	Tidak	1	Jumlah instans yang akan dibuat. Nilai valid: 1 hingga 300. Nilai default: 1.
InstanceType	String	Tidak	Redis	Tipe instans. Nilai valid: Redis (default): Instans Database Apsara for Tair (kompatibel Redis OSS). Memcache: Instans Memcache.
InstanceClass	String	Tidak	redis.master.small.default	Tipe instans. Misalnya, redis.master.small.default menunjukkan instans 1 GB arsitektur standar dual-replica Edisi Komunitas (Edisi Klasik). Untuk informasi lebih lanjut, lihat Navigasi kueri spesifikasi. Catatan: Anda harus menentukan parameter ini atau parameter Capacity.
Capacity	Long	Tidak	16384	Kapasitas penyimpanan instans, dalam MB. Untuk informasi lebih lanjut, lihat Navigasi kueri spesifikasi. Catatan: Anda harus menentukan parameter ini atau parameter InstanceClass.
EngineVersion	String	Tidak	5.0	Versi kompatibel Redis dari instans. Nilai valid: 5.0 (default) 4.0
ChargeType	String	Tidak	PrePaid	Metode penagihan. Nilai valid: PrePaid: berlangganan (prabayar). PostPaid (default): bayar sesuai pemakaian (pascabayar).
Period	Long	Tidak	12	Durasi berlangganan, dalam bulan. Nilai valid: 1 hingga 9, 12, 24, 36, dan 60. Catatan: Parameter ini tersedia dan diperlukan hanya ketika parameter ChargeType diatur ke PrePaid.
AutoRenew	String	Tidak	true	Apakah akan mengaktifkan perpanjangan otomatis. Nilai valid: true: Mengaktifkan perpanjangan otomatis. false (default): Menonaktifkan perpanjangan otomatis. Catatan: Parameter ini hanya tersedia ketika parameter ChargeType diatur ke PrePaid.
InstanceName	String	Tidak	apitest	Nama instans. Nama harus memenuhi persyaratan berikut: Harus diawali dengan huruf (huruf besar atau kecil) atau karakter Tionghoa, dan panjangnya harus 2 hingga 80 karakter. Spasi dan karakter khusus berikut tidak didukung: @/:="<>{[]}
Password	String	Tidak	Pass!123456	Kata sandi instans. Kata sandi harus memenuhi persyaratan berikut: Panjangnya harus 8 hingga 32 karakter. Harus mengandung setidaknya tiga dari jenis karakter berikut: huruf besar, huruf kecil, karakter khusus, dan angka. Karakter khusus yang didukung adalah: !@#$%^&*()_+-=
NetworkType	String	Tidak	VPC	Tipe jaringan. Nilai valid: VPC (saat ini hanya instans jaringan VPC yang didukung): Virtual Private Cloud (VPC).
VpcId	String	Tidak	vpc-bp1nme44gek34slfc****	ID VPC. Anda dapat memanggil operasi DescribeVpcs dari VPC untuk mendapatkan ID.
VSwitchId	String	Tidak	vsw-bp1e7clcw529l773d****	ID vSwitch di VPC. Anda dapat memanggil operasi DescribeVpcs dari VPC untuk mendapatkan ID.
NodeType	String	Tidak	MASTER_SLAVE	Tipe node. Nilai valid: STAND_ALONE: mandiri (single-replica). MASTER_SLAVE (default): ketersediaan tinggi (dual-replica).
SrcDBInstanceId	String	Tidak	r-bp1zxszhcgatnx****	ID instans sumber. Anda dapat memanggil DescribeInstances untuk mendapatkan ID. Catatan: Anda hanya perlu meneruskan parameter ini ketika ingin membuat instans baru berdasarkan data cadangan dari instans sumber yang ditentukan.
BackupId	String	Tidak	111111111	ID set cadangan. Anda dapat memanggil DescribeBackups untuk mengkueri ID. Catatan: Untuk membuat instans baru berdasarkan data cadangan dari sebuah instans, setelah Anda menentukan instans sumber di parameter SrcDBInstanceId, Anda juga harus menentukan ID set cadangan dari instans sumber di parameter ini. Sistem akan membuat instans baru berdasarkan data dari set cadangan yang ditentukan.
RebuildInstance	String	Tidak	false	Apakah akan memulihkan dan membangun ulang instans sumber dari Keranjang daur ulang. Nilai valid: true: Ya. false (default): Tidak. Catatan: Jika Anda meneruskan parameter ini, Anda juga harus meneruskan parameter SrcDBInstanceId.

Contoh permintaan untuk parameter Instances

[{
    "RegionId": "cn-hangzhou",
    "izNo": "cn-hangzhou-b",
    "quantity": 1,
    "instanceType": "Redis",
    "instanceClass": "redis.logic.sharding.1g.2db.0rodb.4proxy.default",
    "EngineVersion": "5.0",
    "ChargeType": "PrePaid",
    "Period":"1",
    "networkType": "VPC" , 
    "vpcId": "vpc-2zex6u1nu32k3ux35xxxx", 
    "vSwitchId": "vsw-2zesk464e647104kwxxxx"
}]

Elemen respons

Element	Type	Description	Example
	object
OrderId	string	ID pesanan.	20905403119****
RequestId	string	ID permintaan.	561AFBF1-BE20-44DB-9BD1-6988B53E****
InstanceIds	object
InstanceId	array	Daftar ID instans yang dibuat dalam permintaan ini.
	string	ID instans.	r-bp16e70a4338****

Contoh

Respons sukses

JSONformat

{
  "OrderId": "20905403119****",
  "RequestId": "561AFBF1-BE20-44DB-9BD1-6988B53E****",
  "InstanceIds": {
    "InstanceId": [
      "r-bp16e70a4338****"
    ]
  }
}

Kode kesalahan

HTTP status code	Error code	Error message
400	Zone.Closed	Specified zone is closed.
400	MissingParameter	Period is mandatory for this action.
400	InvalidToken.Malformed	The Specified parameter "Token" is not valid.
400	InvalidInstanceName.Malformed	The Specified parameter "InstanceName" is not valid.
400	InvalidPassword.Malformed	The Specified parameter "Password" is not valid.
400	InvalidInstances.Malformed	The Specified parameter "Instances" is not valid.
400	InsufficientBalance	Your account does not have enough balance.
400	QuotaExceed.AfterpayInstance	Living afterpay instances quota exceeded.
400	InvalidCapacity.NotFound	The Capacity provided does not exist in our records.
400	ResourceNotAvailable	Resource you requested is not available for finance user.
400	PaymentMethodNotFound	No payment method has been registered on the account.
400	IdempotentParameterMismatch	Request uses a client token in a previous request but is not identical to that request.
400	QuotaNotEnough	Quota not enough in this zone.
400	QuotaExceed	Living afterpay instances quota exceed.
400	VpcServiceError	Invoke vpc service failed.
400	IzNotSupportVpcError	Specify iz not support vpc.
400	InvalidVpcIdRegion.NotSupported	The Specified vpcId or vSwitchId not supported.
400	ResourceGroupNotExist	The Specified ResourceGroupId does not exist.
403	RealNameAuthenticationError	Your account has not passed the real-name authentication yet.
404	InvalidCapacity.NotFound	The Capacity provided does not exist in our records.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.