Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris. # CreateCluster **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/). Menciptakan sebuah klaster kosong. Setiap klaster mendukung lima simpul. Anda menggunakan tindakan [CreateJob](API_CreateJob.md) secara terpisah untuk membuat Tugas bagi masing-masing simpul ini. Klaster tidak mengirim sampai lima Tugas simpul ini telah dibuat. ## Sintaks Permintaan ``` { "AddressId": "string", "Description": "string", "ForceCreateJobs": boolean, "ForwardingAddressId": "string", "InitialClusterSize": number, "JobType": "string", "KmsKeyARN": "string", "LongTermPricingIds": [ "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" } }, "RemoteManagement": "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", "SnowballCapacityPreference": "string", "SnowballType": "string", "TaxDocuments": { "IND": { "GSTIN": "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_CreateCluster_RequestSyntax) ** ID untuk alamat pengiriman klaster yang Anda inginkan. 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: Ya ** [Description](#API_CreateCluster_RequestSyntax) ** Deskripsi opsional klaster tertentu ini, misalnya `Environmental Data Cluster-01`. Tipe: String Batasan Panjang: Panjang minimum 1. Panjang maksimum 1024. Pola: `.*` Wajib: Tidak ** [ForceCreateJobs](#API_CreateCluster_RequestSyntax) ** Paksa untuk membuat klaster saat pengguna mencoba untuk menyediakan berlebihan atau mengurangi penyediaan klaster. Cluster dilebih-lebihkan atau direvisi jika ukuran awal cluster lebih (overprovisioned) atau kurang (underprovisioned) daripada yang diperlukan untuk memenuhi persyaratan kapasitas yang ditentukan. `OnDeviceServiceConfiguration` Tipe: Boolean Wajib: Tidak ** [ForwardingAddressId](#API_CreateCluster_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 ** [InitialClusterSize](#API_CreateCluster_RequestSyntax) ** Jika disediakan, setiap pekerjaan akan secara otomatis dibuat dan dikaitkan dengan cluster baru. Jika tidak disediakan, akan diperlakukan sebagai 0. Jenis: Integer Rentang yang Valid: Nilai minimum 0. Nilai maksimum 16. Wajib: Tidak ** [JobType](#API_CreateCluster_RequestSyntax) ** Tipe Tugas untuk klaster ini. Saat ini, satu-satunya tipe Tugas yang didukung untuk klaster adalah `LOCAL_USE`. Untuk informasi tentang jenis perangkat Snowball Edge, [Informasi perangkat keras perangkat](https://docs.aws.amazon.com/snowball/latest/developer-guide/device-differences.html) di Panduan Pengembang Snowball Edge. Tipe: String Nilai yang Valid: `IMPORT | EXPORT | LOCAL_USE` Wajib: Ya ** [KmsKeyARN](#API_CreateCluster_RequestSyntax) ** `KmsKeyARN`Nilai yang ingin Anda kaitkan dengan cluster ini. `KmsKeyARN`nilai dibuat dengan menggunakan aksi [CreateKey](https://docs.aws.amazon.com/kms/latest/APIReference/API_CreateKey.html)API di AWS Key Management Service (AWS KMS). Tipe: String Batasan Panjang: Panjang maksimum 255. Pola: `arn:aws.*:kms:.*:[0-9]{12}:key/.*` Wajib: Tidak ** [LongTermPricingIds](#API_CreateCluster_RequestSyntax) ** Daftar id harga jangka panjang yang akan digunakan untuk mengaitkan dengan pekerjaan yang dibuat secara otomatis untuk klaster baru. Tipe: Array string Batas Panjang: Panjang tetap 41. Pola: `LTPID[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}` Wajib: Tidak ** [Notification](#API_CreateCluster_RequestSyntax) ** Pengaturan notifikasi Amazon Simple Notification Service (Amazon SNS) untuk klaster ini. Tipe: Objek [Notification](API_Notification.md) Wajib: Tidak ** [OnDeviceServiceConfiguration](#API_CreateCluster_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 ** [RemoteManagement](#API_CreateCluster_RequestSyntax) ** Memungkinkan Anda mengoperasikan dan mengelola perangkat Snow dengan aman di cluster dari jarak jauh dari luar jaringan internal Anda. Ketika diatur ke`INSTALLED_AUTOSTART`, manajemen jarak jauh akan secara otomatis tersedia ketika perangkat tiba di lokasi Anda. Jika tidak, Anda perlu menggunakan Klien Snowball untuk mengelola perangkat. Tipe: String Nilai yang Valid: `INSTALLED_ONLY | INSTALLED_AUTOSTART | NOT_INSTALLED` Wajib: Tidak ** [Resources](#API_CreateCluster_RequestSyntax) ** Sumber daya yang terkait dengan Tugas klaster. Sumber daya ini mencakup bucket Amazon S3 dan AWS Lambda fungsi opsional yang ditulis dalam bahasa Python. Tipe: Objek [JobResource](API_JobResource.md) Wajib: Tidak ** [RoleARN](#API_CreateCluster_RequestSyntax) ** `RoleARN`Yang ingin Anda kaitkan dengan cluster ini. `RoleArn`nilai dibuat dengan menggunakan 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_CreateCluster_RequestSyntax) ** Kecepatan pengiriman untuk setiap simpul dalam klaster ini. Kecepatan ini tidak menentukan seberapa cepat Anda akan mendapatkan setiap perangkat Snowball Edge, melainkan menunjukkan seberapa kecepatan setiap perangkat bergerak ke tujuan saat sedang dalam pengiriman. Kecepatan pengiriman per wilayah adalah sebagai berikut: + Di Australia, Anda memiliki akses ke pengiriman ekspres. Biasanya, perangkat Snow yang dikirim ekspres dikirimkan dalam waktu sekitar satu hari. + Di Uni Eropa (EU), Anda memiliki akses ke pengiriman ekspres. Biasanya, perangkat Snow yang dikirim ekspres dikirimkan dalam waktu sekitar satu hari. Selain itu, sebagian besar negara di Uni Eropa memiliki akses ke pengiriman standar, yang biasanya memakan waktu kurang dari seminggu, satu arah. + Di India, perangkat Snow dikirim dalam satu sampai tujuh hari. + Di Amerika Serikat (AS), Anda memiliki akses ke pengiriman satu hari dan pengiriman dua hari. + Di Australia, Anda memiliki akses ke pengiriman ekspres. Biasanya, perangkat yang dikirim ekspres terkirim dalam waktu sekitar satu hari. + Di Uni Eropa (EU), Anda memiliki akses ke pengiriman ekspres. Biasanya, perangkat Snow yang dikirim ekspres dikirimkan dalam waktu sekitar satu hari. Selain itu, sebagian besar negara di Uni Eropa memiliki akses ke pengiriman standar, yang biasanya memakan waktu kurang dari seminggu, satu arah. + Di India, perangkat Snow dikirim dalam satu sampai tujuh hari. + Di AS, Anda memiliki akses ke pengiriman satu hari dan pengiriman dua hari. Tipe: String Nilai yang Valid: `SECOND_DAY | NEXT_DAY | EXPRESS | STANDARD` Wajib: Ya ** [SnowballCapacityPreference](#API_CreateCluster_RequestSyntax) ** Jika Tugas Anda sedang dibuat di salah satu wilayah AS, Anda memiliki pilihan untuk menentukan ukuran perangkat Snow yang Anda inginkan untuk Tugas ini. Di semua daerah lain, Snowball dilengkapi dengan 80 TB dalam kapasitas penyimpanan. Untuk informasi tentang jenis perangkat Snowball Edge, lihat [Informasi perangkat keras perangkat](/snowball/latest/developer-guide/device-differences.html) di Panduan Pengembang Snowball Edge. Tipe: String Nilai yang Valid: `T50 | T80 | T100 | T42 | T98 | T8 | T14 | T32 | NoPreference | T240 | T13` Wajib: Tidak ** [SnowballType](#API_CreateCluster_RequestSyntax) ** Jenis perangkat Keluarga Salju yang digunakan untuk cluster ini. Untuk pekerjaan cluster, AWS Snowball Edge saat ini hanya mendukung jenis `EDGE` perangkat. Untuk informasi tentang jenis perangkat Snowball Edge, lihat [Informasi perangkat keras perangkat](https://docs.aws.amazon.com/snowball/latest/developer-guide/device-differences.html) di Panduan Pengembang Snowball Edge. Tipe: String Nilai yang Valid: `STANDARD | EDGE | EDGE_C | EDGE_CG | EDGE_S | SNC1_HDD | SNC1_SSD | V3_5C | V3_5S | RACK_5U_C` Wajib: Ya ** [TaxDocuments](#API_CreateCluster_RequestSyntax) ** Dokumen pajak yang diperlukan dalam Anda Wilayah AWS. Tipe: Objek [TaxDocuments](API_TaxDocuments.md) Wajib: Tidak ## Sintaksis Respons ``` { "ClusterId": "string", "JobListEntries": [ { "CreationDate": number, "Description": "string", "IsMaster": boolean, "JobId": "string", "JobState": "string", "JobType": "string", "SnowballType": "string" } ] } ``` ## Elemen Respons Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200. Layanan mengembalikan data berikut dalam format JSON. ** [ClusterId](#API_CreateCluster_ResponseSyntax) ** ID yang dihasilkan secara otomatis untuk sebuah klaster. 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}` ** [JobListEntries](#API_CreateCluster_ResponseSyntax) ** Daftar pekerjaan yang dibuat untuk cluster ini. Untuk sintaks, lihat [ListJobsResult\$1 JobListEntries](https://amazonaws.com/snowball/latest/api-reference/API_ListJobs.html#API_ListJobs_ResponseSyntax) dalam panduan ini. Tipe: Array objek [JobListEntry](API_JobListEntry.md) ## 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:](#Snowball-CreateCluster-request-SnowballType) mendukung [CreateJob:](API_CreateJob.md#Snowball-CreateJob-request-JobType) AndaJobType, dan coba lagi. 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/CreateCluster) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/snowball-2016-06-30/CreateCluster) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/snowball-2016-06-30/CreateCluster) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/snowball-2016-06-30/CreateCluster) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/snowball-2016-06-30/CreateCluster) + [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/snowball-2016-06-30/CreateCluster) + [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/snowball-2016-06-30/CreateCluster) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/snowball-2016-06-30/CreateCluster) + [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/snowball-2016-06-30/CreateCluster) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/snowball-2016-06-30/CreateCluster)