Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Memodifikasi cluster elastis. Ini termasuk memperbarui admin-username/password, memutakhirkan versi API, dan menyiapkan jendela cadangan dan jendela pemeliharaan
Minta Sintaks
PUT /cluster/clusterArn HTTP/1.1
Content-type: application/json
{
"adminUserPassword": "string",
"authType": "string",
"backupRetentionPeriod": number,
"clientToken": "string",
"preferredBackupWindow": "string",
"preferredMaintenanceWindow": "string",
"shardCapacity": number,
"shardCount": number,
"shardInstanceCount": number,
"subnetIds": [ "string" ],
"vpcSecurityGroupIds": [ "string" ]
}Parameter Permintaan URI
Permintaan menggunakan parameter URI berikut.
- clusterArn
-
Pengidentifikasi ARN dari cluster elastis.
Wajib: Ya
Isi Permintaan
Permintaan menerima data berikut dalam format JSON.
- adminUserPassword
-
Kata sandi yang terkait dengan administrator cluster elastis. Kata sandi ini dapat berisi karakter ASCII apa pun yang dapat dicetak kecuali garis miring (/), tanda kutip ganda ("), atau simbol "at" (@).
Kendala: Harus berisi dari 8 hingga 100 karakter.
Tipe: String
Wajib: Tidak
- authType
-
Jenis otentikasi yang digunakan untuk menentukan di mana untuk mengambil password yang digunakan untuk mengakses cluster elastis. Jenis yang valid adalah
PLAIN_TEXTatauSECRET_ARN.Tipe: String
Nilai yang Valid:
PLAIN_TEXT | SECRET_ARNWajib: Tidak
- backupRetentionPeriod
-
Jumlah hari di mana snapshot otomatis dipertahankan.
Tipe: Integer
Wajib: Tidak
- clientToken
-
Token klien untuk cluster elastis.
Tipe: String
Wajib: Tidak
- preferredBackupWindow
-
Rentang waktu harian di mana pencadangan otomatis dibuat jika pencadangan otomatis diaktifkan, sebagaimana ditentukan oleh.
backupRetentionPeriodTipe: String
Wajib: Tidak
- preferredMaintenanceWindow
-
Rentang waktu mingguan selama pemeliharaan sistem dapat terjadi, dalam Waktu Universal Terkoordinasi (UTC).
Format:
ddd:hh24:mi-ddd:hh24:miDefault: jendela 30 menit yang dipilih secara acak dari blok waktu 8 jam untuk masing-masing Wilayah AWS, terjadi pada hari acak dalam seminggu.
Hari yang berlaku: Senin, Sel, Rabu, Kam, Jumat, Sabtu, Minggu
Kendala: Jendela minimum 30 menit.
Tipe: String
Wajib: Tidak
- shardCapacity
-
Jumlah v yang CPUs ditetapkan untuk setiap pecahan cluster elastis. Maksimal adalah 64. Nilai yang diizinkan adalah 2, 4, 8, 16, 32, 64.
Tipe: Integer
Wajib: Tidak
- shardCount
-
Jumlah pecahan yang ditugaskan ke cluster elastis. Maksimal adalah 32.
Tipe: Integer
Wajib: Tidak
- shardInstanceCount
-
Jumlah contoh replika yang berlaku untuk semua pecahan di cluster elastis.
shardInstanceCountNilai 1 berarti ada satu contoh penulis, dan setiap contoh tambahan adalah replika yang dapat digunakan untuk membaca dan untuk meningkatkan ketersediaan.Tipe: Integer
Wajib: Tidak
- subnetIds
-
EC2 Subnet Amazon IDs untuk cluster elastis.
Tipe: Array string
Wajib: Tidak
- vpcSecurityGroupIds
-
Daftar grup keamanan EC2 VPC untuk diasosiasikan dengan cluster elastis.
Tipe: Array string
Wajib: Tidak
Sintaksis Respons
HTTP/1.1 200
Content-type: application/json
{
"cluster": {
"adminUserName": "string",
"authType": "string",
"backupRetentionPeriod": number,
"clusterArn": "string",
"clusterEndpoint": "string",
"clusterName": "string",
"createTime": "string",
"kmsKeyId": "string",
"preferredBackupWindow": "string",
"preferredMaintenanceWindow": "string",
"shardCapacity": number,
"shardCount": number,
"shardInstanceCount": number,
"shards": [
{
"createTime": "string",
"shardId": "string",
"status": "string"
}
],
"status": "string",
"subnetIds": [ "string" ],
"vpcSecurityGroupIds": [ "string" ]
}
}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 Kesalahan Umum.
- AccessDeniedException
-
Pengecualian yang terjadi ketika tidak ada izin yang cukup untuk melakukan tindakan.
Kode Status HTTP: 403
- ConflictException
-
Terjadi konflik akses.
Kode Status HTTP: 409
- InternalServerException
-
Ada kesalahan server internal.
Kode Status HTTP: 500
- ResourceNotFoundException
-
Sumber daya yang ditentukan tidak dapat ditemukan.
Kode Status HTTP: 404
- ThrottlingException
-
ThrottlingException akan dilemparkan ketika permintaan ditolak karena pembatasan permintaan.
Kode Status HTTP: 429
- ValidationException
-
Struktur yang mendefinisikan pengecualian validasi.
Kode Status HTTP: 400
Lihat Juga
Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
