Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris. # UpdateCluster **catatan** AWS Snowball Edge tidak lagi tersedia untuk pelanggan baru. Pelanggan baru harus [AWS DataSync](https://aws.amazon.com/datasync/)mencari transfer online, [Terminal Transfer AWS Data untuk transfer](https://aws.amazon.com/data-transfer-terminal/) fisik yang aman, atau solusi AWS Mitra. Untuk komputasi tepi, jelajahi [AWS Outposts](https://aws.amazon.com/outposts/). Sementara sebuah nilai `ClusterState` klaster dalam status `AwaitingQuorum`, Anda dapat memperbarui beberapa informasi yang terkait dengan klaster. Setelah klaster berubah ke status Tugas yang berbeda, biasanya 60 menit setelah klaster dibuat, tindakan ini tidak lagi tersedia. ## Sintaks Permintaan ``` { "AddressId": "string", "ClusterId": "string", "Description": "string", "ForwardingAddressId": "string", "Notification": { "DevicePickupSnsTopicARN": "string", "JobStatesToNotify": [ "string" ], "NotifyAll": boolean, "SnsTopicARN": "string" }, "OnDeviceServiceConfiguration": { "EKSOnDeviceService": { "EKSAnywhereVersion": "string", "KubernetesVersion": "string" }, "NFSOnDeviceService": { "StorageLimit": number, "StorageUnit": "string" }, "S3OnDeviceService": { "FaultTolerance": number, "ServiceSize": number, "StorageLimit": number, "StorageUnit": "string" }, "TGWOnDeviceService": { "StorageLimit": number, "StorageUnit": "string" } }, "Resources": { "Ec2AmiResources": [ { "AmiId": "string", "SnowballAmiId": "string" } ], "LambdaResources": [ { "EventTriggers": [ { "EventResourceARN": "string" } ], "LambdaArn": "string" } ], "S3Resources": [ { "BucketArn": "string", "KeyRange": { "BeginMarker": "string", "EndMarker": "string" }, "TargetOnDeviceServices": [ { "ServiceName": "string", "TransferOption": "string" } ] } ] }, "RoleARN": "string", "ShippingOption": "string" } ``` ## Parameter Permintaan Untuk informasi tentang parameter yang umum untuk semua tindakan, lihat [Parameter Umum](CommonParameters.md). Permintaan menerima data berikut dalam format JSON. ** [AddressId](#API_UpdateCluster_RequestSyntax) ** ID objek [Address](API_Address.md) yang diperbarui. Tipe: String Batas Panjang: Panjang tetap 40. Pola: `ADID[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}` Wajib: Tidak ** [ClusterId](#API_UpdateCluster_RequestSyntax) ** ID klaster dari klaster yang ingin Anda perbarui, misalnya `CID123e4567-e89b-12d3-a456-426655440000`. Tipe: String Batas Panjang: Panjang tetap 39. Pola: `CID[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}` Wajib: Ya ** [Description](#API_UpdateCluster_RequestSyntax) ** Deskripsi terbaru dari klaster ini. Tipe: String Batasan Panjang: Panjang minimum 1. Panjang maksimum 1024. Pola: `.*` Wajib: Tidak ** [ForwardingAddressId](#API_UpdateCluster_RequestSyntax) ** Bidang ini tidak didukung di wilayah Anda. Tipe: String Batas Panjang: Panjang tetap 40. Pola: `ADID[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}` Wajib: Tidak ** [Notification](#API_UpdateCluster_RequestSyntax) ** Objek [Notification](API_Notification.md) baru atau diperbarui. Tipe: objek [Notification](API_Notification.md) Wajib: Tidak ** [OnDeviceServiceConfiguration](#API_UpdateCluster_RequestSyntax) ** Menentukan layanan atau layanan pada perangkat Snowball Edge tempat data yang ditransfer Anda akan diekspor atau diimpor. AWS Cluster perangkat Snowball Edge mendukung Amazon S3 dan NFS (Sistem File Jaringan). Tipe: Objek [OnDeviceServiceConfiguration](API_OnDeviceServiceConfiguration.md) Wajib: Tidak ** [Resources](#API_UpdateCluster_RequestSyntax) ** Susunan objek [JobResource](API_JobResource.md) yang diperbarui yang dapat mencakup objek [S3Resource](API_S3Resource.md) yang diperbarui atau objek [LambdaResource](API_LambdaResource.md). Tipe: Objek [JobResource](API_JobResource.md) Wajib: Tidak ** [RoleARN](#API_UpdateCluster_RequestSyntax) ** Amazon Resource Name (ARN) peran baru yang ingin Anda kaitkan dengan klaster ini. Untuk membuat peran ARN, gunakan aksi [CreateRole](https://docs.aws.amazon.com/IAM/latest/APIReference/API_CreateRole.html)API di AWS Identity and Access Management (IAM). Tipe: String Batasan Panjang: Panjang maksimum 255. Pola: `arn:aws.*:iam::[0-9]{12}:role/.*` Wajib: Tidak ** [ShippingOption](#API_UpdateCluster_RequestSyntax) ** Nilai opsi pengiriman yang diperbarui dari objek [ShippingDetails](API_ShippingDetails.md) klaster ini. Tipe: String Nilai yang Valid: `SECOND_DAY | NEXT_DAY | EXPRESS | STANDARD` Wajib: Tidak ## Elemen Respons Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200 dengan isi HTTP kosong. ## Kesalahan Untuk informasi tentang kesalahan yang umum untuk semua tindakan, lihat [Jenis Kesalahan Umum](CommonErrors.md). ** Ec2RequestFailedException ** Pengguna Anda tidak memiliki EC2 izin Amazon yang diperlukan untuk melakukan tindakan yang dicoba. Kode Status HTTP: 400 ** InvalidInputCombinationException ** Pembuatan Tugas atau klaster gagal. Satu atau lebih input tidak valid. Konfirmasikan bahwa SnowballType nilai [CreateCluster:](API_CreateCluster.md#Snowball-CreateCluster-request-SnowballType) mendukung [CreateJob:](API_CreateJob.md#Snowball-CreateJob-request-JobType) AndaJobType, dan coba lagi. Kode Status HTTP: 400 ** InvalidJobStateException ** Tindakan tidak dapat dilakukan karena status Tugas saat ini tidak memungkinkan tindakan untuk dilakukan. Kode Status HTTP: 400 ** InvalidResourceException ** Sumber daya yang ditentukan tidak dapat ditemukan. Periksa informasi yang Anda berikan dalam permintaan terakhir Anda, dan coba lagi. ** ResourceType ** Nilai sumber daya yang disediakan tidak valid. Kode Status HTTP: 400 ** KMSRequestFailedException ** AWS Key Management Service Kunci yang disediakan tidak memiliki izin untuk melakukan yang ditentukan [CreateJob](API_CreateJob.md) atau [UpdateJob](API_UpdateJob.md) tindakan. Kode Status HTTP: 400 ## Lihat Juga 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/snowball-2016-06-30/UpdateCluster) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/snowball-2016-06-30/UpdateCluster) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/snowball-2016-06-30/UpdateCluster) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/snowball-2016-06-30/UpdateCluster) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/snowball-2016-06-30/UpdateCluster) + [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/snowball-2016-06-30/UpdateCluster) + [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/snowball-2016-06-30/UpdateCluster) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/snowball-2016-06-30/UpdateCluster) + [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/snowball-2016-06-30/UpdateCluster) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/snowball-2016-06-30/UpdateCluster)