Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
CreateCluster
Membuat cluster. Semua node di cluster menjalankan perangkat lunak mesin yang sesuai dengan protokol yang sama.
Sintaksis Permintaan
{
"ACLName": "string",
"AutoMinorVersionUpgrade": boolean,
"ClusterName": "string",
"DataTiering": boolean,
"Description": "string",
"Engine": "string",
"EngineVersion": "string",
"KmsKeyId": "string",
"MaintenanceWindow": "string",
"MultiRegionClusterName": "string",
"NodeType": "string",
"NumReplicasPerShard": number,
"NumShards": number,
"ParameterGroupName": "string",
"Port": number,
"SecurityGroupIds": [ "string" ],
"SnapshotArns": [ "string" ],
"SnapshotName": "string",
"SnapshotRetentionLimit": number,
"SnapshotWindow": "string",
"SnsTopicArn": "string",
"SubnetGroupName": "string",
"Tags": [
{
"Key": "string",
"Value": "string"
}
],
"TLSEnabled": boolean
}Parameter Permintaan
Untuk informasi tentang parameter yang umum untuk semua tindakan, lihat Parameter Umum.
Permintaan menerima data berikut dalam JSON format.
- ACLName
-
Nama Daftar Kontrol Akses untuk dikaitkan dengan cluster.
Tipe: String
Batasan Panjang: Panjang minimum 1.
Pola:
[a-zA-Z][a-zA-Z0-9\-]*Wajib: Ya
- AutoMinorVersionUpgrade
-
Ketika disetel ke true, cluster akan secara otomatis menerima upgrade versi mesin minor setelah peluncuran.
Tipe: Boolean
Wajib: Tidak
- ClusterName
-
Nama klaster. Nilai ini harus unik karena juga berfungsi sebagai pengidentifikasi cluster.
Tipe: String
Diperlukan: Ya
- DataTiering
-
Mengaktifkan tiering data. Tiering data hanya didukung untuk cluster yang menggunakan tipe node r6gd. Parameter ini harus diatur saat menggunakan node r6gd. Untuk informasi selengkapnya, lihat Tingkatan data.
Tipe: Boolean
Wajib: Tidak
- Description
-
Deskripsi opsional cluster.
Tipe: String
Wajib: Tidak
- Engine
-
Nama mesin yang akan digunakan untuk cluster.
Tipe: String
Wajib: Tidak
- EngineVersion
-
Nomor versi OSS mesin Redis yang akan digunakan untuk cluster.
Tipe: String
Wajib: Tidak
- KmsKeyId
-
ID KMS kunci yang digunakan untuk mengenkripsi cluster.
Tipe: String
Wajib: Tidak
- MaintenanceWindow
-
Menentukan rentang waktu mingguan selama pemeliharaan klaster dilakukan. Hal ini ditentukan sebagai rentang dalam format ddd:hh24:mi-ddd:hh24:mi (24H Clock). UTC Jendela pemeliharaan minimum adalah periode 60 menit.
Nilai yang valid untuk
dddadalah:-
sun -
mon -
tue -
wed -
thu -
fri -
sat
Contoh:
sun:23:00-mon:01:30Tipe: String
Wajib: Tidak
-
- MultiRegionClusterName
-
Nama cluster Multi-region yang akan dibuat.
Tipe: String
Wajib: Tidak
- NodeType
-
Kapasitas komputasi dan memori node di cluster.
Tipe: String
Diperlukan: Ya
- NumReplicasPerShard
-
Jumlah replika untuk diterapkan pada setiap pecahan. Nilai default adalah 1. Maksimal adalah 5.
Tipe: Integer
Wajib: Tidak
- NumShards
-
Jumlah pecahan yang akan dikandung cluster. Nilai default adalah 1.
Jenis: Bilangan bulat
Wajib: Tidak
- ParameterGroupName
-
Nama kelompok parameter yang terkait dengan cluster.
Tipe: String
Wajib: Tidak
- Port
-
Nomor port di mana masing-masing node menerima koneksi.
Tipe: Integer
Wajib: Tidak
- SecurityGroupIds
-
Daftar nama grup keamanan untuk diasosiasikan dengan klaster ini.
Tipe: Array string
Wajib: Tidak
- SnapshotArns
-
Daftar Nama Sumber Daya Amazon (ARN) yang secara unik mengidentifikasi file RDB snapshot yang disimpan di Amazon S3. File snapshot digunakan untuk mengisi cluster baru. Nama objek Amazon S3 di ARN tidak dapat berisi koma apa pun.
Tipe: Array string
Wajib: Tidak
- SnapshotName
-
Nama snapshot untuk mengembalikan data ke cluster baru. Status snapshot berubah menjadi pemulihan saat cluster baru sedang dibuat.
Tipe: String
Wajib: Tidak
- SnapshotRetentionLimit
-
Jumlah hari di mana MemoryDB mempertahankan snapshot otomatis sebelum menghapusnya. Misalnya, jika Anda menyetel SnapshotRetentionLimit ke 5, snapshot yang diambil hari ini dipertahankan selama 5 hari sebelum dihapus.
Tipe: Integer
Wajib: Tidak
- SnapshotWindow
-
Rentang waktu harian (inUTC) di mana MemoryDB mulai mengambil snapshot harian dari pecahan Anda.
Contoh: 05:00-09:00
Jika Anda tidak menentukan parameter ini, MemoryDB secara otomatis memilih rentang waktu yang sesuai.
Tipe: String
Wajib: Tidak
- SnsTopicArn
-
Nama Sumber Daya Amazon (ARN) dari topik Amazon Simple Notification Service (SNS) tempat notifikasi dikirim.
Tipe: String
Wajib: Tidak
- SubnetGroupName
-
Nama grup subnet yang akan digunakan untuk klaster.
Tipe: String
Wajib: Tidak
- Tags
-
Daftar tanda yang akan ditambahkan ke sumber daya ini. Tag adalah kunci yang dipisahkan koma, pasangan nilai (misalnya Key =myKey, Nilai =myKeyValue. Anda dapat menyertakan beberapa tag seperti yang ditunjukkan berikut: Kunci =myKey, Nilai = Kunci =, Nilai = myKeyValue Nilai. mySecondKey mySecondKey
Tipe: Array objek Tag
Anggota Array: Jumlah maksimum 200 item.
Wajib: Tidak
- TLSEnabled
-
Bendera untuk mengaktifkan enkripsi dalam transit di cluster.
Tipe: Boolean
Wajib: Tidak
Sintaksis Respons
{
"Cluster": {
"ACLName": "string",
"ARN": "string",
"AutoMinorVersionUpgrade": boolean,
"AvailabilityMode": "string",
"ClusterEndpoint": {
"Address": "string",
"Port": number
},
"DataTiering": "string",
"Description": "string",
"Engine": "string",
"EnginePatchVersion": "string",
"EngineVersion": "string",
"KmsKeyId": "string",
"MaintenanceWindow": "string",
"MultiRegionClusterName": "string",
"Name": "string",
"NodeType": "string",
"NumberOfShards": number,
"ParameterGroupName": "string",
"ParameterGroupStatus": "string",
"PendingUpdates": {
"ACLs": {
"ACLToApply": "string"
},
"Resharding": {
"SlotMigration": {
"ProgressPercentage": number
}
},
"ServiceUpdates": [
{
"ServiceUpdateName": "string",
"Status": "string"
}
]
},
"SecurityGroups": [
{
"SecurityGroupId": "string",
"Status": "string"
}
],
"Shards": [
{
"Name": "string",
"Nodes": [
{
"AvailabilityZone": "string",
"CreateTime": number,
"Endpoint": {
"Address": "string",
"Port": number
},
"Name": "string",
"Status": "string"
}
],
"NumberOfNodes": number,
"Slots": "string",
"Status": "string"
}
],
"SnapshotRetentionLimit": number,
"SnapshotWindow": "string",
"SnsTopicArn": "string",
"SnsTopicStatus": "string",
"Status": "string",
"SubnetGroupName": "string",
"TLSEnabled": boolean
}
}Elemen Respons
Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.
Data berikut dikembalikan dalam JSON format oleh layanan.
Kesalahan
Untuk informasi tentang kesalahan yang umum untuk semua tindakan, lihat Kesalahan Umum.
- ACLNotFoundFault
-
HTTPKode Status: 400
- ClusterAlreadyExistsFault
-
HTTPKode Status: 400
- ClusterQuotaForCustomerExceededFault
-
HTTPKode Status: 400
- InsufficientClusterCapacityFault
-
HTTPKode Status: 400
- InvalidACLStateFault
-
HTTPKode Status: 400
- InvalidCredentialsException
-
HTTPKode Status: 400
- InvalidMultiRegionClusterStateFault
-
Operasi yang diminta tidak dapat dilakukan pada cluster Multi-region dalam keadaan saat ini.
HTTPKode Status: 400
- InvalidParameterCombinationException
-
HTTPKode Status: 400
- InvalidParameterValueException
-
HTTPKode Status: 400
- InvalidVPCNetworkStateFault
-
HTTPKode Status: 400
- MultiRegionClusterNotFoundFault
-
Cluster Multi-region yang ditentukan tidak ada.
HTTPKode Status: 400
- NodeQuotaForClusterExceededFault
-
HTTPKode Status: 400
- NodeQuotaForCustomerExceededFault
-
HTTPKode Status: 400
- ParameterGroupNotFoundFault
-
HTTPKode Status: 400
- ServiceLinkedRoleNotFoundFault
-
HTTPKode Status: 400
- ShardsPerClusterQuotaExceededFault
-
HTTPKode Status: 400
- SubnetGroupNotFoundFault
-
HTTPKode Status: 400
- TagQuotaPerResourceExceeded
-
HTTPKode Status: 400
Lihat Juga
Untuk informasi selengkapnya tentang penggunaan ini API di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
