Sintaks Permintaan Parameter Permintaan Sintaksis Respons Elemen Respons Kesalahan Lihat Juga

CreateCluster

Menciptakan sebuah klaster kosong. Setiap klaster mendukung lima simpul. Anda menggunakan tindakan CreateJob 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.

Permintaan menerima data berikut dalam JSON format.

AddressId

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

Deskripsi opsional klaster tertentu ini, misalnya Environmental Data Cluster-01.

Tipe: String

Batasan Panjang: Panjang minimum 1. Panjang maksimum 1024.

Pola: .*

Wajib: Tidak

ForceCreateJobs

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

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

Jika disediakan, setiap pekerjaan akan secara otomatis dibuat dan dikaitkan dengan cluster baru. Jika tidak disediakan, akan diperlakukan sebagai 0.

Tipe: Bilangan Bulat

Rentang yang Valid: Nilai minimum 0. Nilai maksimum 16.

Wajib: Tidak

JobType

Tipe Tugas untuk klaster ini. Saat ini, satu-satunya tipe Tugas yang didukung untuk klaster adalah LOCAL_USE.

Untuk informasi tentang tipe perangkat Snow Family, lihat Perangkat dan Kapasitas Snow Family di Panduan Pengguna Snowcone atau Perangkat dan Kapasitas Snow Family di Panduan Pengguna Snowball Edge.

Tipe: String

Nilai yang Valid: IMPORT | EXPORT | LOCAL_USE

Wajib: Ya

KmsKeyARN

KmsKeyARNNilai yang ingin Anda kaitkan dengan cluster ini. KmsKeyARNnilai dibuat dengan menggunakan CreateKeyAPIaction in AWS Key Management Service (AWS KMS).

Tipe: String

Batasan Panjang: Panjang maksimum 255.

Pola: arn:aws.*:kms:.*:[0-9]{12}:key/.*

Wajib: Tidak

LongTermPricingIds

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

Pengaturan notifikasi Amazon Simple Notification Service (AmazonSNS) untuk klaster ini.

Tipe: Objek Notification

Wajib: Tidak

OnDeviceServiceConfiguration

Menentukan layanan atau layanan pada perangkat Keluarga Salju tempat data transfer Anda akan diekspor atau diimpor. AWS Cluster perangkat Snow Family mendukung Amazon S3 NFS dan (Sistem File Jaringan).

Tipe: Objek OnDeviceServiceConfiguration

Wajib: Tidak

RemoteManagement

Memungkinkan Anda mengoperasikan dan mengelola perangkat Snow dengan aman di cluster dari jarak jauh dari luar jaringan internal Anda. Ketika diatur keINSTALLED_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

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

Wajib: Tidak

RoleARN

RoleARNYang ingin Anda kaitkan dengan cluster ini. RoleArnnilai dibuat dengan menggunakan CreateRoleAPIaction in AWS Identity and Access Management (IAM).

Tipe: String

Batasan Panjang: Panjang maksimum 255.

Pola: arn:aws.*:iam::[0-9]{12}:role/.*

Wajib: Tidak

ShippingOption

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

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 tipe perangkat Snow Family, lihat Perangkat dan Kapasitas Snow Family dalam Panduan Pengguna Snowcone atau Perangkat dan Kapasitas Snow Family dalam Panduan Pengguna Snowball Edge.

Tipe: String

Nilai yang Valid: T50 | T80 | T100 | T42 | T98 | T8 | T14 | T32 | NoPreference | T240 | T13

Wajib: Tidak

SnowballType

Jenis perangkat Keluarga Salju yang digunakan untuk cluster ini.

catatan

Untuk pekerjaan cluster, AWS Snow Family saat ini hanya mendukung jenis EDGE perangkat.

Tipe: String

Wajib: Ya

TaxDocuments

Dokumen pajak yang diperlukan dalam Anda Wilayah AWS.

Tipe: Objek TaxDocuments

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.

Data berikut dikembalikan dalam JSON format oleh layanan.

ClusterId

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

Daftar pekerjaan yang dibuat untuk cluster ini. Untuk sintaks, lihat ListJobsResult$ JobListEntries dalam panduan ini.

Tipe: Array objek JobListEntry

Kesalahan

Untuk informasi tentang kesalahan yang umum untuk semua tindakan, lihat Kesalahan Umum.

Ec2RequestFailedException

Pengguna Anda tidak memiliki EC2 izin Amazon yang diperlukan untuk melakukan tindakan yang dicoba.

HTTPKode Status: 400

InvalidInputCombinationException

Pembuatan Tugas atau klaster gagal. Satu atau lebih input tidak valid. Konfirmasikan bahwa SnowballType nilai CreateCluster: mendukung CreateJob: AndaJobType, dan coba lagi.

HTTPKode Status: 400

InvalidResourceException

Sumber daya yang ditentukan tidak dapat ditemukan. Periksa informasi yang Anda berikan dalam permintaan terakhir Anda, dan coba lagi.

HTTPKode Status: 400

KMSRequestFailedException

AWS Key Management Service Kunci yang disediakan tidak memiliki izin untuk melakukan yang ditentukan CreateJob atau UpdateJob tindakan.

HTTPKode Status: 400

Lihat Juga

Untuk informasi selengkapnya tentang penggunaan ini API di salah satu bahasa khusus AWS SDKs, lihat berikut ini:

Awas Javascript dinonaktifkan atau tidak tersedia di browser Anda.

Untuk menggunakan Dokumentasi AWS, Javascript harus diaktifkan. Lihat halaman Bantuan browser Anda untuk petunjuk.

Konvensi Dokumen

CreateAddress

CreateJob