Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
UpdateJob
Sementara Nilai Tugas JobState
adalah New
, Anda dapat memperbarui beberapa informasi yang terkait dengan Tugas. Setelah Tugas berubah ke status Tugas yang berbeda, biasanya 60 menit setelah Tugas dibuat, tindakan ini tidak lagi tersedia.
Sintaks Permintaan
{
"AddressId": "string
",
"Description": "string
",
"ForwardingAddressId": "string
",
"JobId": "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
"
},
"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
"
}
Parameter Permintaan
Untuk informasi tentang parameter yang umum untuk semua tindakan, lihat Parameter Umum.
Permintaan menerima data berikut dalam JSON format.
- AddressId
-
ID objek Address 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
- Description
-
Deskripsi yang diperbarui dari objek JobMetadata Tugas ini.
Tipe: String
Batasan Panjang: Panjang minimum 1. Panjang maksimum 1024.
Pola:
.*
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
- JobId
-
ID Tugas dari Tugas yang ingin Anda perbarui, 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}
Wajib: Ya
- Notification
-
Objek Notification baru atau diperbarui.
Tipe: objek Notification
Wajib: Tidak
- OnDeviceServiceConfiguration
-
Menentukan layanan atau layanan pada perangkat Keluarga Salju tempat data yang ditransfer Anda akan diekspor atau diimpor. AWS Snow Family mendukung Amazon S3 dan NFS (Network File System) dan layanan AWS Storage Gateway tipe Tape Gateway.
Tipe: Objek OnDeviceServiceConfiguration
Wajib: Tidak
- PickupDetails
-
Informasi yang mengidentifikasi orang yang mengambil perangkat.
Tipe: Objek PickupDetails
Wajib: Tidak
- Resources
-
Objek
JobResource
yang diperbarui, atau objek JobResource yang diperbarui.Tipe: objek JobResource
Wajib: Tidak
- RoleARN
-
Peran baru Amazon Resource Name (ARN) yang ingin Anda kaitkan dengan pekerjaan ini. Untuk membuat peranARN, gunakan API tindakan 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
-
Nilai opsi pengiriman yang diperbarui dari objek ShippingDetails Tugas ini.
Tipe: String
Nilai yang Valid:
SECOND_DAY | NEXT_DAY | EXPRESS | STANDARD
Wajib: Tidak
- SnowballCapacityPreference
-
SnowballCapacityPreference
yang diperbarui dari objek JobMetadata Tugas. 50 Snowball TB hanya tersedia di wilayah AS.Untuk informasi tentang jenis 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:
T50 | T80 | T100 | T42 | T98 | T8 | T14 | T32 | NoPreference | T240 | T13
Wajib: Tidak
Elemen Respons
Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200 dengan HTTP tubuh kosong.
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.
HTTPKode Status: 400
- 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
- InvalidJobStateException
-
Tindakan tidak dapat dilakukan karena status Tugas saat ini tidak memungkinkan tindakan untuk dilakukan.
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: