Sintaksis Permintaan Parameter Permintaan Sintaksis Respons Elemen Respons Kesalahan Lihat Juga

CreateJob

catatan

Efektif 7 November 2025, hanya AWS Snowball Edge akan tersedia untuk pelanggan yang sudah ada. Jika Anda ingin menggunakannya AWS Snowball Edge, daftar sebelum tanggal tersebut. Pelanggan baru harus AWS DataSyncmencari transfer online, Terminal Transfer AWS Data untuk transfer fisik yang aman, atau solusi AWS Mitra. Untuk komputasi tepi, jelajahi AWS Outposts.

Membuat Tugas untuk mengimpor atau mengekspor data antara Amazon S3 dan pusat data on-premise Anda. Anda Akun AWS harus memiliki kebijakan kepercayaan dan izin yang tepat untuk membuat pekerjaan untuk perangkat Snow. Jika Anda membuat Tugas untuk sebuah simpul dalam sebuah klaster, Anda hanya perlu menyediakan nilai clusterId; atribut Tugas lainnya diwarisi dari klaster.

catatan

Hanya tipe perangkat Snowball Edge yang didukung saat memesan Tugas berklaster.

Kapasitas perangkat bersifat opsional.

Ketersediaan jenis perangkat berbeda menurut Wilayah AWS. Untuk informasi lebih lanjut tentang ketersediaan Wilayah, lihat Layanan Regional AWS.

Perangkat Keluarga Salju dan kapasitasnya.

Jenis perangkat: V3_5C
- Kapasitas: T32
- Deskripsi: Snowball Edge Compute Optimized
Jenis perangkat: V3_5S
- Kapasitas: T240
- Deskripsi: Snowball Edge Storage Optimized 210TB

Sintaksis Permintaan


{
   "AddressId": "string",
   "ClusterId": "string",
   "Description": "string",
   "DeviceConfiguration": { 
      "SnowconeDeviceConfiguration": { 
         "WirelessConnection": { 
            "IsWifiEnabled": boolean
         }
      }
   },
   "ForwardingAddressId": "string",
   "ImpactLevel": "string",
   "JobType": "string",
   "KmsKeyARN": "string",
   "LongTermPricingId": "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"
      }
   },
   "PickupDetails": { 
      "DevicePickupId": "string",
      "Email": "string",
      "IdentificationExpirationDate": number,
      "IdentificationIssuingOrg": "string",
      "IdentificationNumber": "string",
      "Name": "string",
      "PhoneNumber": "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 format JSON.

AddressId

ID untuk alamat pengiriman perangkat Snow.

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

ID klaster. Jika anda membuat Tugas untuk simpul dalam klaster, anda hanya perlu menyediakan nilai clusterId. Atribut Tugas lainnya diwarisi dari 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}

Wajib: Tidak

Description

Definisikan deskripsi opsional dari Tugas tertentu ini, misalnya Important Photos 2016-08-11.

Tipe: String

Batasan Panjang: Panjang minimum 1. Panjang maksimum 1024.

Pola: ^[a-zA-Z0-9\s\-\_\.\:]+$

Wajib: Tidak

DeviceConfiguration

Mendefinisikan konfigurasi perangkat untuk suatu AWS Snowball Edge pekerjaan.

Untuk informasi tentang jenis perangkat Snowball Edge, lihat Informasi perangkat keras perangkat di Panduan Pengembang Snowball Edge.

Tipe: Objek DeviceConfiguration

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

ImpactLevel

Tingkat dampak tertinggi data yang akan disimpan atau diproses pada perangkat, disediakan pada penciptaan lapangan kerja.

Tipe: String

Nilai yang Valid: IL2 | IL4 | IL5 | IL6 | IL99

Wajib: Tidak

JobType

Mendefinisikan tipe Tugas yang Anda buat.

Tipe: String

Nilai yang Valid: IMPORT | EXPORT | LOCAL_USE

Wajib: Tidak

KmsKeyARN

KmsKeyARNYang ingin Anda kaitkan dengan pekerjaan ini. KmsKeyARNs dibuat menggunakan aksi API CreateKey AWS Key Management Service (KMS).

Tipe: String

Batasan Panjang: Panjang maksimum 255.

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

Wajib: Tidak

LongTermPricingId

ID dari tipe Harga jangka panjang untuk perangkat.

Tipe: 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

Mendefinisikan pengaturan notifikasi Amazon Simple Notification Service (Amazon SNS) untuk Tugas ini.

Tipe: Objek Notification

Wajib: Tidak

OnDeviceServiceConfiguration

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

Tipe: Objek OnDeviceServiceConfiguration

Wajib: Tidak

PickupDetails

Informasi yang mengidentifikasi orang yang mengambil perangkat.

Tipe: Objek PickupDetails

Wajib: Tidak

RemoteManagement

Memungkinkan Anda mengoperasikan dan mengelola perangkat Snowcone dengan aman 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 Edge untuk mengelola perangkat. Saat diatur keNOT_INSTALLED, manajemen jarak jauh tidak akan tersedia di perangkat.

Tipe: String

Nilai yang Valid: INSTALLED_ONLY | INSTALLED_AUTOSTART | NOT_INSTALLED

Wajib: Tidak

Resources

Mendefinisikan bucket Amazon S3 terkait dengan Tugas ini.

Dengan Tugas IMPORT, Anda menentukan bucket tujuan impor data yang ditransfer.

Dengan Tugas EXPORT, Anda menentukan bucket tempat asal ekspor data yang ditransfer. Secara opsional, Anda juga dapat menentukan nilai KeyRange. Jika Anda memilih untuk mengekspor rentang, Anda menentukan panjang rentang dengan menyediakan nilai BeginMarker inklusif, nilai EndMarker inklusif, atau keduanya. Rentang diurutkan dengan biner UTF-8.

Tipe: Objek JobResource

Wajib: Tidak

RoleARN

RoleARNYang ingin Anda kaitkan dengan pekerjaan ini. RoleArns dibuat menggunakan aksi API CreateRole 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 Tugas ini. Kecepatan ini tidak menentukan seberapa cepat Anda akan mendapatkan perangkat Snow, melainkan menunjukkan seberapa cepat perangkat Snow 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 AS, Anda memiliki akses ke pengiriman satu hari dan pengiriman dua hari.

Tipe: String

Nilai yang Valid: SECOND_DAY | NEXT_DAY | EXPRESS | STANDARD

Wajib: Tidak

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 jenis perangkat Snowball Edge, lihat Informasi perangkat keras perangkat di Panduan Pengembang 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 pekerjaan ini.

catatan

Untuk pekerjaan cluster, AWS Snowball Edge saat ini hanya mendukung jenis EDGE perangkat.

Jenis perangkat AWS Salju yang digunakan untuk pekerjaan ini. Saat ini, satu-satunya tipe perangkat yang didukung untuk Tugas klaster adalah EDGE.

Untuk informasi selengkapnya, lihat Informasi perangkat keras perangkat di Panduan Pengembang Snowball Edge.

Tipe: String

Wajib: Tidak

TaxDocuments

Dokumen pajak yang diperlukan dalam Anda Wilayah AWS.

Tipe: Objek TaxDocuments

Wajib: Tidak

Sintaksis Respons


{
   "JobId": "string"
}

Elemen Respons

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

JobId

ID yang dihasilkan secara otomatis untuk Tugas, misalnya JID123e4567-e89b-12d3-a456-426655440000.

Tipe: String

Batas Panjang: Panjang tetap 39.

Pola: (M|J)ID[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}

Kesalahan

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

ClusterLimitExceededException

Pembuatan Tugas gagal. Saat ini, klaster mendukung lima simpul. Jika Anda memiliki kurang dari lima simpul untuk klaster Anda dan Anda perlu membuat lebih banyak simpul untuk klaster ini, coba lagi dan buat Tugas sampai klaster Anda memiliki tepat lima simpul.

Kode Status HTTP: 400

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: mendukung CreateJob: 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 atau UpdateJob tindakan.

Kode Status HTTP: 400

Lihat Juga

Untuk informasi selengkapnya tentang penggunaan API ini 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

CreateCluster

CreateLongTermPricing