Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
UpdateCluster
Memodifikasi pengaturan untuk cluster. Anda dapat menggunakan operasi ini untuk mengubah satu atau lebih pengaturan konfigurasi cluster dengan menentukan pengaturan dan nilai baru.
Sintaksis Permintaan
{
"ACLName": "string",
"ClusterName": "string",
"Description": "string",
"Engine": "string",
"EngineVersion": "string",
"IpDiscovery": "string",
"MaintenanceWindow": "string",
"NodeType": "string",
"ParameterGroupName": "string",
"ReplicaConfiguration": {
"ReplicaCount": number
},
"SecurityGroupIds": [ "string" ],
"ShardConfiguration": {
"ShardCount": number
},
"SnapshotRetentionLimit": number,
"SnapshotWindow": "string",
"SnsTopicArn": "string",
"SnsTopicStatus": "string"
}Parameter Permintaan
Untuk informasi tentang parameter yang umum untuk semua tindakan, lihat Parameter Umum.
Permintaan menerima data berikut dalam format JSON.
- ACLName
-
Daftar Kontrol Akses yang terkait dengan cluster.
Tipe: String
Batasan Panjang: Panjang minimum 1.
Pola:
[a-zA-Z][a-zA-Z0-9\-]*Wajib: Tidak
- ClusterName
-
Nama cluster yang akan diperbarui.
Tipe: String
Diperlukan: Ya
- Description
-
Deskripsi cluster yang akan diperbarui.
Tipe: String
Wajib: Tidak
- Engine
-
Nama mesin yang akan digunakan untuk cluster.
Tipe: String
Wajib: Tidak
- EngineVersion
-
Versi mesin yang ditingkatkan untuk dijalankan pada node. Anda dapat meningkatkan ke versi mesin yang lebih baru, tetapi Anda tidak dapat menurunkan versi ke versi mesin sebelumnya. Jika Anda ingin menggunakan versi mesin yang lebih lama, Anda harus menghapus cluster yang ada dan membuatnya lagi dengan versi mesin sebelumnya.
Tipe: String
Wajib: Tidak
- IpDiscovery
-
Mekanisme untuk menemukan alamat IP untuk protokol penemuan cluster. Nilai yang valid adalah 'ipv4' atau 'ipv6'. Ketika diatur ke 'ipv4', fungsi penemuan cluster seperti slot cluster, cluster shards, dan cluster node akan mengembalikan alamat IPv4 untuk node cluster. Ketika disetel ke 'ipv6', fungsi penemuan cluster mengembalikan alamat IPv6 untuk node cluster. Nilai harus kompatibel dengan NetworkType parameter. Jika tidak ditentukan, defaultnya adalah 'ipv4'.
Tipe: String
Nilai yang Valid:
ipv4 | ipv6Wajib: Tidak
- MaintenanceWindow
-
Menentukan rentang waktu mingguan selama pemeliharaan klaster dilakukan. Ini ditentukan sebagai rentang dalam format hhh:jj24:me-hhh:jj24:me (24J Jam 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
-
- NodeType
-
Jenis node yang valid yang ingin Anda tingkatkan atau turunkan cluster ini.
Tipe: String
Wajib: Tidak
- ParameterGroupName
-
Nama grup parameter yang akan diperbarui.
Tipe: String
Wajib: Tidak
- ReplicaConfiguration
-
Jumlah replika yang akan berada di setiap pecahan.
Tipe: Objek ReplicaConfigurationRequest
Wajib: Tidak
- SecurityGroupIds
-
SecurityGroupIds Untuk memperbarui.
Tipe: Array string
Wajib: Tidak
- ShardConfiguration
-
Jumlah pecahan dalam cluster.
Tipe: Objek ShardConfigurationRequest
Wajib: Tidak
- SnapshotRetentionLimit
-
Jumlah hari dimana MemoryDB menyimpan snapshot cluster otomatis sebelum menghapusnya. Misalnya, jika Anda menyet SnapshotRetentionLimit el ke 5, snapshot yang diambil hari ini akan disimpan selama 5 hari sebelum dihapus.
Tipe: Integer
Wajib: Tidak
- SnapshotWindow
-
Rentang waktu harian (dalam UTC) di mana MemoryDB mulai mengambil snapshot harian cluster Anda.
Tipe: String
Wajib: Tidak
- SnsTopicArn
-
Topik SNS ARN untuk diperbarui.
Tipe: String
Wajib: Tidak
- SnsTopicStatus
-
Status topik notifikasi Amazon SNS. Pemberitahuan dikirim hanya jika statusnya aktif.
Tipe: String
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",
"IpDiscovery": "string",
"KmsKeyId": "string",
"MaintenanceWindow": "string",
"MultiRegionClusterName": "string",
"Name": "string",
"NetworkType": "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.
Layanan mengembalikan data berikut dalam format JSON.
Kesalahan
Untuk informasi tentang kesalahan yang umum untuk semua tindakan, lihat Jenis Kesalahan Umum.
- ACLNotFoundFault
-
Kode Status HTTP: 400
- ClusterNotFoundFault
-
Kode Status HTTP: 400
- ClusterQuotaForCustomerExceededFault
-
Kode Status HTTP: 400
- InvalidACLStateFault
-
Kode Status HTTP: 400
- InvalidClusterStateFault
-
Kode Status HTTP: 400
- InvalidKMSKeyFault
-
Kode Status HTTP: 400
- InvalidNodeStateFault
-
Kode Status HTTP: 400
- InvalidParameterCombinationException
-
Kode Status HTTP: 400
- InvalidParameterValueException
-
Kode Status HTTP: 400
- InvalidVPCNetworkStateFault
-
Kode Status HTTP: 400
- NodeQuotaForClusterExceededFault
-
Kode Status HTTP: 400
- NodeQuotaForCustomerExceededFault
-
Kode Status HTTP: 400
- NoOperationFault
-
Kode Status HTTP: 400
- ParameterGroupNotFoundFault
-
Kode Status HTTP: 400
- ServiceLinkedRoleNotFoundFault
-
Kode Status HTTP: 400
- ShardsPerClusterQuotaExceededFault
-
Kode Status HTTP: 400
Lihat Juga
Untuk informasi selengkapnya tentang menggunakan API ini di salah satu AWS SDK khusus bahasa, lihat berikut ini:
