Membuat instans klasik Redis Community Edisi, instans arsitektur cloud-native Redis Community Edisi, atau instans klasik Tair memory-optimized. Untuk membuat instans Tair arsitektur cloud-native, panggil operasi CreateTairInstance.
Deskripsi operasi
Sebelum memanggil operasi ini, pastikan Anda sepenuhnya memahami metode penagihan dan harga Database Apsara for Tair (Redis® OSS-Compatible).
Operasi ini membuat instans Redis Community Edisi dan instans klasik Tair memory-optimized. Untuk membuat instans cloud-native Tair, panggil operasi CreateTairInstance.
Untuk operasi konsol yang sesuai dan rekomendasi pemilihan instans, lihat Membuat instans Redis.
Coba sekarang
Test
RAM authorization
|
Action |
Access level |
Resource type |
Condition key |
Dependent action |
|
kvstore:CreateInstance |
create |
*DBInstance.
|
|
None |
Parameter permintaan
|
Parameter |
Type |
Required |
Description |
Example |
| RegionId |
string |
Yes |
ID wilayah. Anda dapat memanggil DescribeRegions untuk mengkueri wilayah yang tersedia. Gunakan parameter ini untuk menentukan wilayah tempat instans dibuat. |
cn-hangzhou |
| Token |
string |
No |
Token klien yang digunakan untuk memastikan idempotensi permintaan. Nilai token dihasilkan oleh klien dan harus unik di antara permintaan yang berbeda. Token bersifat case-sensitive dan panjangnya tidak boleh melebihi 64 karakter ASCII. |
ETnLKlblzczshOTUbOCz**** |
| InstanceName |
string |
No |
Nama instans. Panjang nama harus 2 hingga 80 karakter dan harus diawali dengan huruf atau karakter Tionghoa. Nama tidak boleh mengandung |
apitest |
| Password |
string |
No |
Kata sandi instans. Panjang kata sandi harus 8 hingga 32 karakter dan harus mengandung setidaknya tiga dari jenis karakter berikut: huruf besar, huruf kecil, karakter khusus, dan angka. Karakter khusus berikut didukung: |
Pass!123456 |
| Capacity |
integer |
No |
Kapasitas penyimpanan instans. Unit: MB. Catatan
Anda harus menentukan setidaknya satu dari parameter Capacity dan InstanceClass saat memanggil operasi ini. |
16384 |
| InstanceClass |
string |
No |
Tipe instans. Misalnya, redis.master.kecil.default menentukan instans 1 GB arsitektur standar dual-replica Community Edisi (klasik). Untuk informasi selengkapnya, lihat Ikhtisar tipe instans. Catatan
Anda harus menentukan setidaknya satu dari parameter Capacity dan InstanceClass saat memanggil operasi ini. |
redis.master.small.default |
| ZoneId |
string |
No |
ID zona primer. Anda dapat memanggil DescribeRegions untuk mengkueri zona yang aktif. Gunakan parameter ini untuk menentukan zona tempat instans dibuat. Catatan
Anda juga dapat menentukan parameter SecondaryZoneId untuk mengatur zona sekunder. Node primer dan sekunder diterapkan masing-masing di zona primer dan sekunder yang ditentukan, yang mengimplementasikan arsitektur primer/sekunder dual-center di kota yang sama. Misalnya, atur ZoneId menjadi "cn-hangzhou-h" dan SecondaryZoneId menjadi "cn-hangzhou-g". |
cn-hangzhou-h |
| SecondaryZoneId |
string |
No |
ID zona sekunder. Anda dapat memanggil DescribeZones untuk mengkueri zona yang tersedia. Catatan
Nilai parameter ini harus berbeda dari nilai ZoneId. Anda tidak dapat mengatur parameter ini ke ID multi-zona. |
cn-hangzhou-g |
| ChargeType |
string |
No |
Metode penagihan. Nilai valid:
|
PostPaid |
| NodeType |
string |
No |
Tipe node. Nilai valid:
Catatan
Untuk instans cloud-native, atur parameter ini menjadi MASTER_SLAVE atau STAND_ALONE. Untuk instans klasik, atur parameter ini menjadi double atau single. |
STAND_ALONE |
| NetworkType |
string |
No |
Jenis jaringan. Nilai valid:
|
VPC |
| VpcId |
string |
No |
ID VPC. |
vpc-bp1nme44gek34slfc**** |
| VSwitchId |
string |
No |
ID vSwitch. |
vsw-bp1e7clcw529l773d**** |
| Period |
string |
No |
Periode langganan. Unit: bulan. Nilai valid: 1 hingga 9, 12, 24, 36, dan 60. Catatan
Parameter ini tersedia dan wajib hanya jika ChargeType diatur ke PrePaid. |
12 |
| BusinessInfo |
string |
No |
ID aktivitas dan informasi bisnis. |
000000000 |
| CouponNo |
string |
No |
Kode kupon. Nilai default: |
youhuiquan_promotion_option_id_for_blank |
| SrcDBInstanceId |
string |
No |
Untuk membuat instans dari set cadangan instans yang ada, tentukan ID instans sumber di parameter ini. Catatan
Kemudian gunakan parameter BackupId, ClusterBackupId (direkomendasikan untuk instans kluster cloud-native), atau RestoreTime untuk menentukan set cadangan atau waktu. Parameter ini harus digunakan bersama dengan salah satu dari tiga parameter sebelumnya. Nilainya adalah string, bukan array. |
r-bp1zxszhcgatnx**** |
| BackupId |
string |
No |
ID set cadangan instans sumber. Sistem menggunakan data yang disimpan dalam set cadangan untuk membuat instans. Anda dapat memanggil DescribeBackups untuk mengkueri BackupId. Jika instans sumber adalah instans kluster, tentukan ID set cadangan semua shard instans sumber, dipisahkan dengan koma (,). Contoh: "10**,11**,15**". Catatan
Jika instans Anda adalah instans kluster arsitektur cloud-native, gunakan DescribeClusterBackupList untuk mengkueri ID set cadangan kluster, seperti "cb-xx", dan tentukan di parameter permintaan ClusterBackupId untuk mengkloning instans kluster. Hal ini menghilangkan kebutuhan untuk menentukan ID set cadangan shard secara individual. |
111111111 |
| InstanceType |
string |
No |
Tipe instans. Nilai valid:
|
Redis |
| EngineVersion |
string |
No |
Versi mesin Redis klasik. Nilai valid:
Versi mesin Redis cloud-native. Nilai valid:
Catatan
Nilai default: 5.0. Valid values:
|
5.0 |
| PrivateIpAddress |
string |
No |
Alamat IP jaringan internal instans baru. Catatan
Alamat IP jaringan internal harus berada dalam Blok CIDR vSwitch tempat instans berada. |
172.16.0.*** |
| AutoUseCoupon |
string |
No |
Apakah akan menggunakan kupon. Nilai valid:
|
false |
| AutoRenew |
string |
No |
Apakah akan mengaktifkan perpanjangan otomatis. Nilai valid:
|
true |
| AutoRenewPeriod |
string |
No |
Epoch perpanjangan otomatis. Unit: bulan. Nilai valid: 1, 2, 3, 6, dan 12. Catatan
Parameter ini wajib jika AutoRenew diatur ke true. |
3 |
| ResourceGroupId |
string |
No |
ID kelompok sumber daya. |
rg-resourcegroupid1 |
| RestoreTime |
string |
No |
Jika flashback diaktifkan untuk instans sumber, Anda dapat menentukan pengatur waktu dalam periode retensi cadangan. Sistem menggunakan data cadangan instans sumber pada pengatur waktu yang ditentukan untuk membuat instans. Tentukan waktu dalam standar ISO 8601 dengan format yyyy-MM-ddTHH:mm:ssZ. Waktu harus dalam UTC. |
2019-06-19T16:00:00Z |
| DedicatedHostGroupId |
string |
No |
ID klaster khusus. Parameter ini wajib saat Anda membuat instans di klaster khusus. |
dhg-uv4fnk6r7zff**** |
| ShardCount |
integer |
No |
Jumlah shard. Parameter ini hanya berlaku untuk instans cloud-native. Anda dapat menggunakan parameter ini untuk menyesuaikan jumlah shard.
|
4 |
| ReplicaCount |
integer |
No |
Jumlah node replika di zona primer. Parameter ini hanya berlaku untuk instans kluster multi-replika cloud-native. Anda dapat menggunakan parameter ini untuk menyesuaikan jumlah node replika. Nilai valid: 1 hingga 4. Catatan
Jika Anda membuat instans multi-zona, Anda dapat menggunakan parameter ini bersama dengan parameter SlaveReplicaCount untuk menyesuaikan jumlah node replika di zona primer dan zona sekunder. Jumlah parameter ini dan parameter SlaveReplicaCount tidak boleh melebihi 4. |
2 |
| SlaveReplicaCount |
integer |
No |
Jumlah node replika di zona sekunder. |
2 |
| ReadOnlyCount |
integer |
No |
Jumlah node baca-saja di zona primer. Parameter ini hanya berlaku untuk instans pemisahan baca/tulis cloud-native.
Catatan
Jika Anda membuat instans multi-zona, Anda dapat menggunakan parameter ini bersama dengan parameter SlaveReadOnlyCount untuk menyesuaikan jumlah node baca-saja di zona primer dan zona sekunder.
|
2 |
| SlaveReadOnlyCount |
integer |
No |
Jumlah node baca-saja di zona sekunder. |
2 |
| GlobalInstanceId |
string |
No |
ID instans terdistribusi. Parameter ini hanya berlaku untuk situs Tiongkok (aliyun.com). |
gr-bp14rkqrhac**** |
| GlobalInstance |
boolean |
No |
Apakah akan menggunakan instans baru sebagai instans anak pertama dari instans terdistribusi. Hal ini memungkinkan Anda membuat instans terdistribusi. Nilai valid:
Catatan
|
false |
| Port |
string |
No |
Port layanan instans. Nilai valid: 1 hingga 65535. Nilai default: 6379. |
6379 |
| DryRun |
boolean |
No |
Apakah akan menjalankan dry run untuk permintaan pembuatan instans ini. Nilai valid:
|
false |
| GlobalSecurityGroupIds |
string |
No |
Templat daftar putih IP global untuk instans. Pisahkan beberapa templat dengan koma (,). Duplikat tidak diperbolehkan. Penting Parameter ini hanya berlaku untuk instans cloud-native. Instans klasik tidak mendukung fitur templat daftar putih. |
g-zsldxfiwjmti0kcm**** |
| Appendonly |
string |
No |
Pengaturan parameter Persistensi AOF (Append Only File) untuk instans baru. Nilai valid:
Catatan
Parameter ini berlaku untuk instans klasik. Instans cloud-native tidak mendukung penentuan parameter AOF. Valid values:
|
yes |
| ConnectionStringPrefix |
string |
No |
Awalan titik akhir. Awalan harus terdiri dari huruf kecil dan angka, diawali dengan huruf kecil, dan panjangnya 8 hingga 40 karakter. Catatan
Titik akhir memiliki format: |
r-bp1zxszhcgatnx**** |
| ParamGroupId |
string |
No |
ID template parameter. ID bersifat unik secara global. Penting Parameter ini hanya berlaku untuk instans cloud-native. |
rpg-test** |
| Tag |
array<object> |
No |
Tag instans. |
|
|
object |
No |
Objek. |
||
| Key |
string |
No |
Kunci tag. Catatan
|
testkey |
| Value |
string |
No |
Nilai tag. Catatan
N menentukan nomor urut tag. Misalnya, Tag.1.Value menentukan nilai tag pertama, dan Tag.2.Value menentukan nilai tag kedua. |
testvalue |
| ClusterBackupId |
string |
No |
ID set cadangan kluster, yang didukung oleh beberapa instans arsitektur kluster baru. Anda dapat memanggil DescribeClusterBackupList untuk mendapatkan ID.
|
cb-hyxdof5x9kqb**** |
| RecoverConfigMode |
string |
No |
Apakah akan memulihkan informasi akun, parameter kernel (config), atau daftar putih dari set cadangan asli saat membuat instans dari set cadangan yang ditentukan. Misalnya, untuk memulihkan informasi akun, atur parameter ini menjadi Nilai default kosong, yang menunjukkan bahwa informasi akun, parameter kernel, dan daftar putih tidak dipulihkan dari set cadangan asli. Catatan
Parameter ini hanya berlaku untuk instans cloud-native, dan set cadangan asli harus berisi informasi akun, parameter kernel, atau daftar putih. Anda dapat memanggil DescribeBackups untuk memeriksa apakah parameter RecoverConfigMode dari set cadangan yang ditentukan berisi informasi sebelumnya. |
whitelist,config,account |
| InstanceEndpointType |
string |
No |
Tipe titik akhir yang digunakan saat membuat instans pemisahan baca/tulis penerapan dual-zona cloud-native. Jika parameter ini tidak dikirim secara eksplisit, nilai defaultnya adalah AzIndependentEndpoint.
Penting Parameter ini hanya berlaku untuk instans pemisahan baca/tulis penerapan dual-zona cloud-native. Untuk tipe instans lain, hanya titik akhir independen zona yang didukung. Bahkan jika UnifiedEndpoint ditentukan, parameter ini tidak akan berlaku. Penting Opsi UnifiedEndpoint hanya tersedia untuk pengguna dalam daftar putih. Jika Anda tidak berada dalam daftar putih dan menentukan parameter ini, pemanggilan akan mengembalikan error. Untuk meminta akses, kirimkan tiket. |
AzIndependentEndpoint |
| MaintainStartTime |
string |
No |
Waktu mulai jendela pemeliharaan. Tentukan waktu dalam format HH:mmZ UTC. Misalnya, untuk mengatur waktu mulai ke 01:00 (UTC+8), tentukan Catatan
Jika parameter ini tidak ditentukan, nilai defaultnya adalah 02:00 (UTC+8), yaitu 18:00Z UTC. |
03:00Z |
| MaintainEndTime |
string |
No |
Waktu akhir jendela pemeliharaan. Tentukan waktu dalam format HH:mmZ UTC. Misalnya, untuk mengatur waktu akhir ke 02:00 (UTC+8), tentukan Catatan
Interval antara waktu mulai dan waktu akhir harus minimal 1 jam. Catatan
Jika parameter ini tidak ditentukan, nilai defaultnya adalah 06:00 (UTC+8), yaitu 22:00Z UTC. |
07:00Z |
Contoh berikut menunjukkan permintaan untuk membuat instans kluster Redis 7.0.
{
"RegionId": "ap-southeast-1",
"InstanceName": "apitest",
"Password": "D****23",
"ZoneId": "ap-southeast-1a",
"ChargeType": "PrePaid",
"InstanceClass": "redis.shard.with.proxy.small.ce",
"NetworkType": "VPC",
"Period": "1",
"InstanceType": "Redis",
"EngineVersion": "7.0",
"ShardCount": 4,
"SourceIp": "10.10.10.10"
}
Elemen respons
|
Element |
Type |
Description |
Example |
|
object |
Objek tanggapan. |
||
| VpcId |
string |
ID VPC. |
vpc-bp1nme44gek34slfc**** |
| QPS |
integer |
Kueri per detik (QPS). Nilai ini adalah maksimum teoretis untuk tipe instans saat ini. |
100000 |
| Capacity |
integer |
Kapasitas penyimpanan instans. Unit: MB. |
16384 |
| ConnectionDomain |
string |
Titik akhir jaringan internal instans Redis. |
r-bp1zxszhcgatnx****.redis.rds.aliyuncs.com |
| ChargeType |
string |
Metode penagihan. Nilai valid:
|
PostPaid |
| NetworkType |
string |
Jenis jaringan. Nilai valid:
|
VPC |
| InstanceId |
string |
ID instans, yang bersifat unik secara global. |
r-bp1zxszhcgatnx**** |
| Port |
integer |
Port layanan Redis. |
6379 |
| Config |
string |
Konfigurasi detail instans. |
{\"EvictionPolicy\":\"volatile-lru\",\"hash-max-ziplist-entries\":512,\"zset-max-ziplist-entries\":128,\"zset-max-ziplist-value\":64,\"set-max-intset-entries\":512,\"hash-max-ziplist-value\":64} |
| RegionId |
string |
ID wilayah instans. |
cn-hongkong |
| EndTime |
string |
Waktu ketika instans langganan kedaluwarsa. Waktu dalam format yyyy-MM-ddTHH:mm:ssZ UTC. |
2019-01-18T16:00:00Z |
| VSwitchId |
string |
ID vSwitch. |
vsw-bp1e7clcw529l773d**** |
| RequestId |
string |
ID permintaan. |
5DEA3CC9-F81D-4387-8E97-CEA40F09**** |
| NodeType |
string |
Tipe node. Nilai valid:
|
MASTER_SLAVE |
| Connections |
integer |
Jumlah koneksi maksimum yang didukung oleh instans. |
10000 |
| Bandwidth |
integer |
Batas bandwidth instans. Unit: MB/s. |
32 |
| InstanceName |
string |
Nama instans. |
apitest |
| ZoneId |
string |
ID zona instans. |
cn-hangzhou-b |
| InstanceStatus |
string |
Status instans saat ini. Nilai kembali tetap berupa Creating. |
Creating |
| PrivateIpAddr |
string |
Alamat IP internal instans. |
172.16.0.10 |
| UserName |
string |
Akun yang digunakan untuk terhubung ke instans Redis. Secara default, akun yang dinamai sesuai ID instans disertakan. |
r-bp1zxszhcgatnx**** |
| OrderId |
integer |
ID pesanan. |
2084452111111 |
Contoh
Respons sukses
JSONformat
{
"VpcId": "vpc-bp1nme44gek34slfc****",
"QPS": 100000,
"Capacity": 16384,
"ConnectionDomain": "r-bp1zxszhcgatnx****.redis.rds.aliyuncs.com",
"ChargeType": "PostPaid",
"NetworkType": "VPC",
"InstanceId": "r-bp1zxszhcgatnx****",
"Port": 6379,
"Config": "{\\\"EvictionPolicy\\\":\\\"volatile-lru\\\",\\\"hash-max-ziplist-entries\\\":512,\\\"zset-max-ziplist-entries\\\":128,\\\"zset-max-ziplist-value\\\":64,\\\"set-max-intset-entries\\\":512,\\\"hash-max-ziplist-value\\\":64}",
"RegionId": "cn-hongkong",
"EndTime": "2019-01-18T16:00:00Z",
"VSwitchId": "vsw-bp1e7clcw529l773d****",
"RequestId": "5DEA3CC9-F81D-4387-8E97-CEA40F09****",
"NodeType": "MASTER_SLAVE",
"Connections": 10000,
"Bandwidth": 32,
"InstanceName": "apitest",
"ZoneId": "cn-hangzhou-b",
"InstanceStatus": "Creating",
"PrivateIpAddr": "172.16.0.10",
"UserName": "r-bp1zxszhcgatnx****",
"OrderId": 2084452111111
}
Kode kesalahan
|
HTTP status code |
Error code |
Error message |
Description |
|---|---|---|---|
| 400 | ZoneIdNotFound | Specify iz not support switch network. | |
| 400 | InvalidShardInfo.Format | Shard total number is out of range. | |
| 400 | InvalidInstancelevel | Specified Instance level dose not match gdc other member instance level. | |
| 400 | InvalidBackupLogStatus | Backup logs are not enabled for the specified source instance. | |
| 400 | InvalidStatus | Specified instance status is Modifying. | |
| 400 | SecurityRisk.AuthVerification | we have detected a risk with your default payment method. An email and notification has been sent to you. Please re-submit your order before after verificaiton. | |
| 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 | 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 | InvalidvSwitchId | The vpc does not cover the vswitch. | |
| 400 | InvalidIzNo.NotSupported | The Specified vpc zone not supported. | |
| 400 | InvalidAccountPassword.Format | Specified account password is not valid. | |
| 400 | InstanceClass.NotMatch | Current instance class and instance type is not match. | |
| 400 | InvalidVPCId.NotFound | Specified virtual vpc is not found. | |
| 400 | AccountMoneyValidateError | Account money validate error. | |
| 400 | RequestTokenConflict | Specified request token conflict. | |
| 400 | InvalidIPNotInSubnet | Error ip not in subnet. | |
| 400 | InvalidEngineVersion.Malformed | Specified engine version is not valid. | |
| 400 | Zone.Closed | The specified zone is closed. | |
| 400 | VSwithNotBelongToNotVpcFault | The vSwitch does not belong to current vpc. | |
| 400 | PayIllegalAgreement | Pay mayi with holding agreement illegal. | |
| 400 | IllegalParamError | validateSaleConditionWithSubArticle failed. | |
| 400 | CASH_BOOK_INSUFFICIENT | No payment method is specified for your account. We recommend that you add a payment method or maitain a minimum prepayment balance of INR 1000. | |
| 400 | InvalidRegion.Format | Specified Region is not valid. | |
| 400 | DryRunOperation | Request validation has been passed with DryRun flag set. | |
| 400 | ResourceGroupNotExist | The Specified ResourceGroupId does not exist. | |
| 403 | RealNameAuthenticationError | Your account has not passed the real-name authentication yet. | |
| 403 | AuthorizationFailure | The request processing has failed due to authorization failure. | |
| 403 | TokenServiceError | The specified token is duplicated, please change it. | |
| 404 | InvalidCapacity.NotFound | The Capacity provided does not exist in our records. | |
| 404 | InvalidvSwitchId | The Specified vSwitchId zone not supported. | |
| 404 | InvalidVpcIdOrVswitchId.NotSupported | The Specified vpcId or vSwitchId not supported. |
Lihat Error Codes untuk daftar lengkap.
Catatan rilis
Lihat Release Notes untuk daftar lengkap.