Membuat instans Tair (Edisi Enterprise) cloud-native.
Deskripsi operasi
Untuk referensi pemilihan instans, lihat Panduan pemilihan ApsaraDB for Tair (kompatibel dengan Redis).
Sebelum Anda menggunakan operasi ini, pastikan Anda sepenuhnya memahami metode penagihan dan harga ApsaraDB for Tair (kompatibel dengan Redis).
Untuk informasi tentang cara melakukan operasi di konsol, lihat Membuat instans Tair.
Untuk membuat tipe instans lainnya, seperti instans edisi open-source atau instans edisi klasik berbasis DRAM Tair, Anda dapat memanggil operasi CreateInstance.
Coba sekarang
Test
RAM authorization
|
Action |
Access level |
Resource type |
Condition key |
Dependent action |
|
kvstore:CreateTairInstance |
create |
*DBInstance
|
|
None |
Parameter permintaan
|
Parameter |
Type |
Required |
Description |
Example |
| RegionId |
string |
Yes |
ID region. Anda dapat memanggil operasi DescribeRegions untuk menanyakan region. Gunakan parameter ini untuk menentukan region tempat instans dibuat. |
cn-hangzhou |
| InstanceName |
string |
No |
Nama instans. Nama harus memenuhi persyaratan berikut:
|
apitest |
| Password |
string |
No |
Kata sandi instans. Kata sandi harus memenuhi persyaratan berikut:
|
Pass!123456 |
| InstanceClass |
string |
Yes |
Tipe instans. Untuk informasi lebih lanjut, lihat topik berikut: |
tair.scm.standard.4m.32d |
| ZoneId |
string |
No |
ID zona utama. Anda dapat memanggil operasi DescribeRegions untuk menanyakan zona. Gunakan parameter ini untuk menentukan zona tempat instans dibuat. Catatan
Anda juga dapat menentukan parameter SecondaryZoneId untuk menentukan zona sekunder. Node master dan replika dikerahkan masing-masing di zona utama dan zona sekunder yang ditentukan untuk menerapkan arsitektur pemulihan bencana zona dalam region yang sama. Misalnya, Anda dapat menetapkan parameter ZoneId ke "cn-hangzhou-h" dan parameter SecondaryZoneId ke "cn-hangzhou-g". |
cn-hangzhou-h |
| SecondaryZoneId |
string |
No |
ID zona sekunder. Anda dapat memanggil operasi DescribeRegions untuk menanyakan zona. Catatan
Nilai parameter ini tidak boleh sama dengan nilai parameter ZoneId, dan Anda tidak dapat menentukan ID yang sesuai dengan beberapa zona. |
cn-hangzhou-g |
| ChargeType |
string |
No |
Metode penagihan. Nilai yang valid:
Valid values:
|
PrePaid |
| VpcId |
string |
Yes |
ID dari virtual private cloud (VPC). Anda dapat memanggil operasi DescribeVpcs dari layanan VPC untuk menanyakan ID VPC. |
vpc-bp1nme44gek34slfc**** |
| VSwitchId |
string |
Yes |
ID vSwitch dalam VPC. Anda dapat memanggil operasi DescribeVpcs dari layanan VPC untuk menanyakan ID vSwitch. |
vsw-bp1e7clcw529l773d**** |
| Period |
integer |
No |
Periode langganan. Satuan: bulan. Nilai yang valid: 1 hingga 9, 12, 24, 36, dan 60. Catatan
Parameter ini diperlukan hanya ketika ChargeType ditetapkan ke PrePaid. |
1 |
| BusinessInfo |
string |
No |
ID acara promosi atau informasi bisnis. |
000000000 |
| CouponNo |
string |
No |
Kode kupon. |
youhuiquan_promotion_option_id_for_blank |
| SrcDBInstanceId |
string |
No |
Jika Anda ingin membuat instans berdasarkan set cadangan dari sebuah instans, tentukan ID instans sumber dalam parameter ini. Catatan
Kemudian, gunakan parameter BackupId, ClusterBackupId (direkomendasikan untuk arsitektur cluster cloud-native), atau RestoreTime untuk menentukan set cadangan atau titik waktu yang akan digunakan. Parameter ini harus digunakan bersama dengan salah satu dari tiga parameter di atas. |
r-bp1zxszhcgatnx**** |
| BackupId |
string |
No |
Anda dapat menentukan ID set cadangan dari instans sumber dalam parameter ini. Sistem menggunakan data yang disimpan dalam set cadangan untuk membuat instans baru. Anda dapat memanggil operasi DescribeBackups untuk menanyakan BackupId. Jika instans sumber adalah instans cluster, Anda harus menentukan ID set cadangan dari semua shard pada instans sumber, dipisahkan dengan koma. Misalnya, "10**,11**,15**". Catatan
Jika instans Anda adalah instans arsitektur cloud-native dan instans cluster, kami merekomendasikan Anda menggunakan DescribeClusterBackupList untuk menanyakan ID set cadangan cluster, misalnya "cb-xx", lalu menentukannya dalam parameter permintaan ClusterBackupId untuk mengkloning instans cluster. Ini menghemat kerepotan memasukkan ID set cadangan dari semua shard. |
2158****20 |
| ClusterBackupId |
string |
No |
Beberapa arsitektur cluster baru mendukung ID set cadangan cluster. Anda dapat memanggil operasi DescribeClusterBackupList untuk mendapatkan ID set cadangan cluster.
|
cb-hyxdof5x9kqb**** |
| RecoverConfigMode |
string |
No |
Menentukan apakah akan memulihkan informasi akun, parameter (config), dan whitelist dari set cadangan asli saat membuat instans dari set cadangan yang ditentukan. Misalnya, untuk memulihkan informasi akun, atur nilainya menjadi account. Nilai default kosong, yang menunjukkan bahwa informasi akun, parameter, dan whitelist tidak akan dipulihkan dari set cadangan asli. Catatan
Parameter ini hanya berlaku untuk instans cloud-native, dan set cadangan asli harus berisi informasi akun, parameter, dan whitelist. Anda dapat memanggil operasi DescribeBackups untuk menanyakan apakah parameter RecoverConfigMode dari set cadangan yang ditentukan berisi informasi di atas. |
whitelist,config,account |
| PrivateIpAddress |
string |
No |
Alamat IP internal dari instans. Catatan
Alamat IP harus berada dalam blok CIDR vSwitch tempat instans tersebut berada. Anda dapat memanggil operasi DescribeVSwitches dari layanan VPC untuk menanyakan informasi blok CIDR. |
172.16.88.*** |
| AutoUseCoupon |
string |
No |
Menentukan apakah akan menggunakan voucher. Nilai yang valid:
|
true |
| AutoRenew |
string |
No |
Menentukan apakah akan mengaktifkan perpanjangan otomatis. Nilai yang valid:
|
true |
| AutoRenewPeriod |
string |
No |
Periode perpanjangan otomatis. Satuan: bulan. Nilai yang valid: 1, 2, 3, 6, dan 12. Catatan
Parameter ini diperlukan hanya ketika AutoRenew ditetapkan ke true. |
3 |
| ResourceGroupId |
string |
No |
ID resource group. Catatan
|
rg-acfmyiu4ekp**** |
| AutoPay |
boolean |
No |
Menentukan pembayaran otomatis. Nilainya ditetapkan sebagai true. |
true |
| ClientToken |
string |
No |
Token klien yang digunakan untuk memastikan idempotensi permintaan. Nilai dihasilkan oleh klien dan harus unik di antara permintaan yang berbeda. Token bersifat case-sensitive dan tidak boleh melebihi 64 karakter ASCII. |
ETnLKlblzczshOTUbOCz**** |
| StorageType |
string |
No |
Tipe penyimpanan. Nilai yang valid: essd_pl1, essd_pl2, dan essd_pl3. Catatan
Parameter ini diperlukan hanya ketika InstanceType ditetapkan ke tair_essd dan Anda membuat instans berbasis ESSD. |
essd_pl1 |
| Storage |
integer |
No |
Kapasitas penyimpanan dari instans yang dioptimalkan untuk penyimpanan. Nilai yang valid bervariasi berdasarkan tipe instans. Untuk informasi lebih lanjut, lihat Tipe instans yang dioptimalkan untuk penyimpanan. Catatan
Parameter ini diperlukan hanya ketika InstanceType ditetapkan ke tair_essd dan Anda membuat instans berbasis ESSD. Untuk instans yang dioptimalkan untuk penyimpanan Tair berbasis SSD, kapasitas didefinisikan sebagai nilai tetap berdasarkan tipe instans dan tidak perlu ditentukan. |
60 |
| ShardType |
string |
No |
Tipe instans. Nilai yang valid:
|
MASTER_SLAVE |
| ShardCount |
integer |
No |
Jumlah node data dalam instans. Nilai yang valid:
Catatan
Anda dapat menentukan nilai dalam rentang 2 hingga 32 hanya ketika InstanceType ditetapkan ke tair_rdb atau tair_scm. Yaitu, hanya instans berbasis DRAM dan yang dioptimalkan untuk memori persisten yang mendukung arsitektur cluster. |
2 |
| ReplicaCount |
integer |
No |
Jumlah node replika di zona utama. Parameter ini hanya berlaku untuk membuat instans cluster multi-replika cloud-native. Anda dapat menggunakan parameter ini untuk menyesuaikan jumlah node replika. Nilai yang valid: 1 hingga 4. Catatan
Jika Anda membuat instans multi-zona, Anda dapat menggunakan parameter ini dan parameter SlaveReplicaCount untuk menyesuaikan jumlah node replika di zona utama dan 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 read-only di zona utama. Parameter ini hanya berlaku untuk membuat instans read/write splitting cloud-native.
Catatan
Jika Anda membuat instans multi-zona, Anda dapat menggunakan parameter ini dan parameter SlaveReadOnlyCount untuk menyesuaikan jumlah node read-only di zona utama dan sekunder.
|
5 |
| SlaveReadOnlyCount |
integer |
No |
Jumlah node read-only di zona sekunder. |
1 |
| EngineVersion |
string |
No |
Versi engine database. Nilai default: 1.0. Aturan pengiriman parameter untuk berbagai tipe produk Tair:
|
1.0 |
| InstanceType |
string |
Yes |
Media penyimpanan. Nilai yang valid:
|
tair_scm |
| GlobalInstanceId |
string |
No |
Menentukan apakah akan menggunakan instans baru sebagai instans anak dari instans terdistribusi. Anda dapat membuat instans terdistribusi dengan cara ini.
Catatan
Jika Anda ingin instans baru menjadi instans terdistribusi, instans tersebut harus berupa instans berbasis DRAM Tair. |
gr-bp14rkqrhac**** |
| Tag |
array<object> |
No |
Informasi tag dari instans. |
|
|
object |
No |
Informasi tag. |
||
| Key |
string |
No |
Kunci tag. Kunci tag dan nilai tag membentuk pasangan key-value. Catatan
Maksimal lima pasangan key-value tag dapat ditentukan dalam satu permintaan. |
key1_test |
| Value |
string |
No |
Nilai tag. Catatan
N menunjukkan nomor urut dari nilai tag. Misalnya, Tag.1.Value menunjukkan nilai tag pertama, dan Tag.2.Value menunjukkan nilai tag kedua. |
value1_test |
| DryRun |
boolean |
No |
Menentukan apakah akan melakukan precheck untuk operasi pembuatan instans ini. Nilai yang valid:
|
false |
| Port |
integer |
No |
Port layanan dari instans. Nilai yang valid: 1 hingga 65535. Nilai default: 6379. |
6379 |
| GlobalSecurityGroupIds |
string |
No |
Template whitelist IP global dari instans. Pisahkan beberapa template whitelist IP dengan koma (,). Template tersebut tidak boleh duplikat. |
g-zsldxfiwjmti0kcm**** |
| ParamGroupId |
string |
No |
ID template parameter. Instans dibuat berdasarkan parameter dari template parameter yang baru dibuat. Nilainya tidak boleh duplikat. |
g-50npzjcqb1ua6q6j**** |
| RestoreTime |
string |
No |
Jika flashback data diaktifkan untuk instans sumber, Anda dapat menentukan titik waktu apa pun dalam periode retensi cadangan instans sumber dalam parameter ini. Sistem menggunakan data cadangan instans sumber pada titik waktu ini untuk membuat instans baru. Format: yyyy-MM-ddTHH:mm:ssZ (waktu UTC). |
2021-07-06T07:25:57Z |
| ConnectionStringPrefix |
string |
No |
Awalan dari alamat koneksi. Awalan harus terdiri dari huruf kecil dan angka, diawali dengan huruf kecil, dan terdiri dari 8 hingga 40 karakter. Catatan
Format alamat koneksi: |
r-bp1zxszhcgatnx**** |
| InstanceEndpointType |
string |
No |
Tipe alamat koneksi yang digunakan saat membuat instans read/write splitting dual-zona cloud-native. Jika parameter ini tidak ditentukan secara eksplisit, nilai default-nya adalah AzIndependentEndpoint.
Penting Parameter ini hanya berlaku untuk instans read/write splitting dual-zona cloud-native. Untuk tipe instans lainnya, hanya alamat koneksi independen zona yang didukung. Bahkan jika UnifiedEndpoint ditentukan, parameter tersebut tidak akan benar-benar berlaku. Penting Parameter UnifiedEndpoint saat ini hanya tersedia untuk pengguna whitelist. Pengguna non-whitelist yang menentukan parameter ini akan mengalami kesalahan pemanggilan. Untuk mengaktifkan penggunaan, kirimkan tiket untuk mengajukan whitelisting. |
AzIndependentEndpoint |
| MaintainStartTime |
string |
No |
Waktu mulai dari jendela pemeliharaan instans. Format: HH:mmZ (waktu UTC). Misalnya, untuk memulai pada pukul 1:00 (UTC+8), atur nilainya ke Catatan
Jika tidak diatur, nilai default-nya adalah 18:00 UTC, yaitu 2:00 (UTC+8). |
|
| MaintainEndTime |
string |
No |
Waktu berakhir dari jendela pemeliharaan instans. Format: HH:mmZ (waktu UTC). Misalnya, untuk berakhir pada pukul 2:00 (UTC+8), atur nilainya ke Catatan
Interval antara waktu mulai dan waktu berakhir tidak boleh kurang dari 1 jam. Catatan
Jika tidak diatur, nilai default-nya adalah 22:00 UTC, yaitu 6:00 (UTC+8). |
Elemen respons
|
Element |
Type |
Description |
Example |
|
object |
Objek. |
||
| QPS |
integer |
Jumlah maksimum operasi baca dan tulis per detik. Satuan: kali/detik. Ini adalah nilai teoritis dari tipe instans saat ini. |
100000 |
| ConnectionDomain |
string |
Alamat koneksi internal dari instans. |
r-bp13ac3d047b****.tairpena.rds.aliyuncs.com |
| ChargeType |
string |
Metode penagihan dari instans. Nilai yang valid:
|
PrePaid |
| InstanceId |
string |
ID instans. |
r-bp13ac3d047b**** |
| Port |
integer |
Nomor port dari instans. |
6379 |
| Config |
string |
Konfigurasi terperinci dari instans dalam format JSON string. Untuk informasi lebih lanjut tentang parameter, lihat Deskripsi konfigurasi parameter. |
{\"EvictionPolicy\":\"volatile-lru\",\"hash-max-ziplist-entries\":512,\"zset-max-ziplist-entries\":128,\"list-max-ziplist-entries\":512,\"list-max-ziplist-value\":64,\"zset-max-ziplist-value\":64,\"set-max-intset-entries\":512,\"hash-max-ziplist-value\":64} |
| RegionId |
string |
ID region. |
cn-hangzhou |
| RequestId |
string |
ID permintaan. |
12123216-4B00-4378-BE4B-08005BFC**** |
| Bandwidth |
integer |
Bandwidth maksimum dari instans. Satuan: MB/s. |
96 |
| Connections |
integer |
Jumlah maksimum koneksi ke instans. |
10000 |
| InstanceName |
string |
Nama instans. Catatan
Parameter ini dikembalikan hanya ketika parameter permintaan InstanceName ditentukan. |
redistest |
| ZoneId |
string |
ID zona. |
cn-hangzhou-h |
| InstanceStatus |
string |
Status saat ini dari instans. Nilai yang dikembalikan ditetapkan sebagai Creating. |
Creating |
| TaskId |
string |
ID tugas. |
10**** |
| OrderId |
integer |
ID pesanan. |
2084452111111 |
Contoh
Respons sukses
JSONformat
{
"QPS": 100000,
"ConnectionDomain": "r-bp13ac3d047b****.tairpena.rds.aliyuncs.com",
"ChargeType": "PrePaid",
"InstanceId": "r-bp13ac3d047b****",
"Port": 6379,
"Config": "{\\\"EvictionPolicy\\\":\\\"volatile-lru\\\",\\\"hash-max-ziplist-entries\\\":512,\\\"zset-max-ziplist-entries\\\":128,\\\"list-max-ziplist-entries\\\":512,\\\"list-max-ziplist-value\\\":64,\\\"zset-max-ziplist-value\\\":64,\\\"set-max-intset-entries\\\":512,\\\"hash-max-ziplist-value\\\":64}",
"RegionId": "cn-hangzhou",
"RequestId": "12123216-4B00-4378-BE4B-08005BFC****",
"Bandwidth": 96,
"Connections": 10000,
"InstanceName": "redistest",
"ZoneId": "cn-hangzhou-h",
"InstanceStatus": "Creating",
"TaskId": "10****",
"OrderId": 2084452111111
}
Kode kesalahan
|
HTTP status code |
Error code |
Error message |
Description |
|---|---|---|---|
| 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. | |
| 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. | |
| 403 | UserCannotBuyNotInnerCommodity | The user can not buy this commodity without alibaba group tag. | |
| 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.