Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
UpdateJob
Lorsque laJobState valeur d'une tâche estNew, vous pouvez mettre à jour certaines informations associées à une tâche. Une fois que la tâche change d'état, généralement dans les 60 minutes suivant sa création, cette action n'est plus disponible.
Syntaxe de la requête
{
"AddressId": "string",
"Description": "string",
"ForwardingAddressId": "string",
"JobId": "string",
"Notification": {
"JobStatesToNotify": [ "string" ],
"NotifyAll": boolean,
"SnsTopicARN": "string"
},
"OnDeviceServiceConfiguration": {
"EKSOnDeviceService": {
"EKSAnywhereVersion": "string",
"KubernetesVersion": "string"
},
"NFSOnDeviceService": {
"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",
"SnowballCapacityPreference": "string"
}Paramètres de demande
Pour plus d'informations sur les paramètres communs à toutes les actions, voir Paramètres communs.
Cette demande accepte les données suivantes au format JSON.
- AddressId
-
L'ID de l'Addressobjet mis à jour.
Type : String
Contraintes de longueur : longueur fixe de 40.
Modèle :
ADID[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}Obligatoire : non
- Description
-
Description mise à jour de l'JobMetadataobjet de cette tâche.
Type : String
Contraintes de longueur : Longueur minimum de 1. Longueur maximum de 1024.
Modèle :
.*Obligatoire : non
- ForwardingAddressId
-
Ce champ n'est pas pris en charge dans votre région.
Type : String
Contraintes de longueur : longueur fixe de 40.
Modèle :
ADID[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}Obligatoire : non
- JobId
-
L'ID de la tâche que vous souhaitez mettre à jour, par exemple
JID123e4567-e89b-12d3-a456-426655440000.Type : String
Contraintes de longueur : longueur fixe de 39.
Modèle :
(M|J)ID[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}Obligatoire : oui
- Notification
-
L'Notificationobjet nouveau ou mis à jour.
Type : objet Notification
Obligatoire : non
- OnDeviceServiceConfiguration
-
Spécifie le ou les services de l'appareil Snow Family à partir desquels les données transférées seront exportées ou importées. AWS Snow Family prend en charge Amazon S3 et NFS (Network File System) ainsi que le serviceAWS Storage Gateway de type Tape Gateway.
Type : objet OnDeviceServiceConfiguration
Obligatoire : non
- Resources
-
L'
JobResourceobjet mis à jour, ou l'JobResourceobjet mis à jour.Type : objet JobResource
Obligatoire : non
- RoleARN
-
Le nouveau rôle Amazon (ARN) que vous souhaitez associer à cette tâche. Pour créer un ARN de rôle, utilisez l'action d'API CreateRoleAWS Identity and Access Management(IAM).
Type : String
Contraintes de longueur : longueur maximale de 255.
Modèle :
arn:aws.*:iam::[0-9]{12}:role/.*Obligatoire : non
- ShippingOption
-
La valeur de l'option d'expédition mise à jour de l'ShippingDetailsobjet de cette tâche.
Type : String
Valeurs valides :
SECOND_DAY | NEXT_DAY | EXPRESS | STANDARDObligatoire : non
- SnowballCapacityPreference
-
La mise à jour
SnowballCapacityPreferencede l'JobMetadataobjet de cette tâche. Les Snowfailed.Pour plus d'informations sur les types d'appareils de la famille Snow, consultez les sections Appareils et capacités de la famille Snow dans le guide de l'utilisateur Snowcone ou Appareils et capacités de la famille Snow dans le guide de l'utilisateur Snowball Edge.
Type : String
Valeurs valides :
T50 | T80 | T100 | T42 | T98 | T8 | T14 | T32 | NoPreferenceObligatoire : non
Éléments de réponse
Si l'action aboutit, le service renvoie une réponse HTTP 200 avec un corps HTTP vide.
Erreurs
Pour plus d'informations sur les erreurs communes à toutes les actions, consultezErreurs courantes.
- ClusterLimitExceededException
-
Job création failed Actuellement, les clusters prennent en charge cinq nœuds. Si vous avez moins de cinq nœuds pour votre cluster et que vous avez d'autres nœuds à créer pour ce cluster, réessayez et créez des tâches jusqu'à ce que votre cluster compte exactement cinq nœuds.
Code d'état HTTP : 400
- Ec2RequestFailedException
-
Votre utilisateur IAM ne dispose pas des autorisations Amazon EC2 nécessaires pour effectuer l'action tentée.
Code d'état HTTP : 400
- InvalidInputCombinationException
-
La création failed Une ou plusieurs entrées n'étaient pas valides. Vérifiez que laSnowballType valeur CreateCluster: est compatible avec votre CreateJob:JobType, puis réessayez.
Code d'état HTTP : 400
- InvalidJobStateException
-
L'action ne peut pas être exécutée car l'état actuel de la tâche ne permet pas d'effectuer cette action.
Code d'état HTTP : 400
- InvalidResourceException
-
La ressource spécifiée est introuvable. Vérifiez les informations que vous avez fournies dans la dernière requête, et réessayez.
Code d'état HTTP : 400
- KMSRequestFailedException
-
LaAWS Key Management Service clé fournie ne dispose pas des autorisations nécessaires pour exécuter l'UpdateJobactionCreateJob ou l'action spécifiée.
Code d'état HTTP : 400
Voir aussi
Pour plus d'informations sur l'utilisation de cette API dans l'un des kits SDK AWS spécifiques au langage, consultez les ressources suivantes :
