Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# UpdateCluster
<a name="API_elastic_UpdateCluster"></a>

Memodifikasi cluster elastis. Ini termasuk memperbarui admin-username/password, memutakhirkan versi API, dan menyiapkan jendela cadangan dan jendela pemeliharaan

## Minta Sintaks
<a name="API_elastic_UpdateCluster_RequestSyntax"></a>

```
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
<a name="API_elastic_UpdateCluster_RequestParameters"></a>

Permintaan menggunakan parameter URI berikut.

 ** [clusterArn](#API_elastic_UpdateCluster_RequestSyntax) **   <a name="documentdb-elastic_UpdateCluster-request-uri-clusterArn"></a>
Pengidentifikasi ARN dari cluster elastis.  
Wajib: Ya

## Isi Permintaan
<a name="API_elastic_UpdateCluster_RequestBody"></a>

Permintaan menerima data berikut dalam format JSON.

 ** [adminUserPassword](#API_elastic_UpdateCluster_RequestSyntax) **   <a name="documentdb-elastic_UpdateCluster-request-adminUserPassword"></a>
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](#API_elastic_UpdateCluster_RequestSyntax) **   <a name="documentdb-elastic_UpdateCluster-request-authType"></a>
Jenis otentikasi yang digunakan untuk menentukan di mana untuk mengambil password yang digunakan untuk mengakses cluster elastis. Jenis yang valid adalah `PLAIN_TEXT` atau`SECRET_ARN`.  
Tipe: String  
Nilai yang Valid: `PLAIN_TEXT | SECRET_ARN`   
Wajib: Tidak

 ** [backupRetentionPeriod](#API_elastic_UpdateCluster_RequestSyntax) **   <a name="documentdb-elastic_UpdateCluster-request-backupRetentionPeriod"></a>
Jumlah hari di mana snapshot otomatis dipertahankan.  
Tipe: Integer  
Wajib: Tidak

 ** [clientToken](#API_elastic_UpdateCluster_RequestSyntax) **   <a name="documentdb-elastic_UpdateCluster-request-clientToken"></a>
Token klien untuk cluster elastis.  
Tipe: String  
Wajib: Tidak

 ** [preferredBackupWindow](#API_elastic_UpdateCluster_RequestSyntax) **   <a name="documentdb-elastic_UpdateCluster-request-preferredBackupWindow"></a>
Rentang waktu harian di mana pencadangan otomatis dibuat jika pencadangan otomatis diaktifkan, sebagaimana ditentukan oleh. `backupRetentionPeriod`  
Tipe: String  
Wajib: Tidak

 ** [preferredMaintenanceWindow](#API_elastic_UpdateCluster_RequestSyntax) **   <a name="documentdb-elastic_UpdateCluster-request-preferredMaintenanceWindow"></a>
Rentang waktu mingguan selama pemeliharaan sistem dapat terjadi, dalam Waktu Universal Terkoordinasi (UTC).  
 *Format*: `ddd:hh24:mi-ddd:hh24:mi`   
 *Default*: 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](#API_elastic_UpdateCluster_RequestSyntax) **   <a name="documentdb-elastic_UpdateCluster-request-shardCapacity"></a>
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](#API_elastic_UpdateCluster_RequestSyntax) **   <a name="documentdb-elastic_UpdateCluster-request-shardCount"></a>
Jumlah pecahan yang ditugaskan ke cluster elastis. Maksimal adalah 32.  
Tipe: Integer  
Wajib: Tidak

 ** [shardInstanceCount](#API_elastic_UpdateCluster_RequestSyntax) **   <a name="documentdb-elastic_UpdateCluster-request-shardInstanceCount"></a>
Jumlah contoh replika yang berlaku untuk semua pecahan di cluster elastis. `shardInstanceCount`Nilai 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](#API_elastic_UpdateCluster_RequestSyntax) **   <a name="documentdb-elastic_UpdateCluster-request-subnetIds"></a>
Subnet Amazon EC2 IDs untuk cluster elastis.  
Tipe: Array string  
Wajib: Tidak

 ** [vpcSecurityGroupIds](#API_elastic_UpdateCluster_RequestSyntax) **   <a name="documentdb-elastic_UpdateCluster-request-vpcSecurityGroupIds"></a>
Daftar grup keamanan VPC EC2 untuk diasosiasikan dengan cluster elastis.  
Tipe: Array string  
Wajib: Tidak

## Sintaksis Respons
<a name="API_elastic_UpdateCluster_ResponseSyntax"></a>

```
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
<a name="API_elastic_UpdateCluster_ResponseElements"></a>

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

 ** [cluster](#API_elastic_UpdateCluster_ResponseSyntax) **   <a name="documentdb-elastic_UpdateCluster-response-cluster"></a>
Mengembalikan informasi tentang cluster elastis diperbarui.  
Tipe: Objek [Cluster](API_elastic_Cluster.md)

## Kesalahan
<a name="API_elastic_UpdateCluster_Errors"></a>

Untuk informasi tentang kesalahan yang umum untuk semua tindakan, lihat [Kesalahan Umum](CommonErrors.md).

 ** AccessDeniedException **   
Pengecualian yang terjadi ketika tidak ada izin yang cukup untuk melakukan tindakan.    
 ** message **   
Pesan kesalahan yang menjelaskan mengapa akses ditolak.
Kode Status HTTP: 403

 ** ConflictException **   
Terjadi konflik akses.    
 ** resourceId **   
ID sumber daya di mana ada konflik akses.  
 ** resourceType **   
Jenis sumber daya di mana ada konflik akses.
Kode Status HTTP: 409

 ** InternalServerException **   
Ada kesalahan server internal.  
Kode Status HTTP: 500

 ** ResourceNotFoundException **   
Sumber daya yang ditentukan tidak dapat ditemukan.    
 ** message **   
Pesan kesalahan yang menjelaskan kegagalan.  
 ** resourceId **   
ID sumber daya yang tidak dapat ditemukan.  
 ** resourceType **   
Jenis sumber daya yang tidak dapat ditemukan.
Kode Status HTTP: 404

 ** ThrottlingException **   
ThrottlingException akan dilemparkan ketika permintaan ditolak karena pembatasan permintaan.    
 ** retryAfterSeconds **   
Jumlah detik untuk menunggu sebelum mencoba kembali operasi.
Kode Status HTTP: 429

 ** ValidationException **   
Struktur yang mendefinisikan pengecualian validasi.    
 ** fieldList **   
Daftar bidang di mana pengecualian validasi terjadi.  
 ** message **   
Pesan kesalahan yang menjelaskan pengecualian validasi.  
 ** reason **   
Alasan mengapa pengecualian validasi terjadi (salah satu`unknownOperation`,, `cannotParse``fieldValidationFailed`, atau`other`).
Kode Status HTTP: 400

## Lihat Juga
<a name="API_elastic_UpdateCluster_SeeAlso"></a>

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
+  [AWS Antarmuka Baris Perintah V2](https://docs.aws.amazon.com/goto/cli2/docdb-elastic-2022-11-28/UpdateCluster) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-elastic-2022-11-28/UpdateCluster) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-elastic-2022-11-28/UpdateCluster) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-elastic-2022-11-28/UpdateCluster) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-elastic-2022-11-28/UpdateCluster) 
+  [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-elastic-2022-11-28/UpdateCluster) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-elastic-2022-11-28/UpdateCluster) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-elastic-2022-11-28/UpdateCluster) 
+  [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/docdb-elastic-2022-11-28/UpdateCluster) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-elastic-2022-11-28/UpdateCluster)