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. # CreateJob Crée une tâche pour importer ou exporter des données entre Amazon S3 et votre centre de données sur site. VousCompte AWS devez disposer des politiques de confiance et des autorisations appropriées pour créer une tâche pour un appareil Snow. Si vous créez une tâche pour un nœud d'un cluster, il vous suffit de fournir la`clusterId` valeur ; les autres attributs de la tâche sont hérités du cluster. **Note** Seul le type d'appareil Snowball ; Edge est pris en charge lors de la commande de tâches en cluster. La capacité de l'appareil est facultative. La disponibilité des types d'appareils varie selonRégion AWS. Pour de plus amples informations sur la région, veuillez consulter [ServicesAWS régionaux](https://aws.amazon.com/about-aws/global-infrastructure/regional-product-services/?p=ngi&loc=4). **Les appareils de la famille Snow et leurs capacités.** + Type d'appareil de la famille Snow : **SNC1\$1SSD** + Capacité : T14 + Description : Snowcone + Type d'appareil de la famille Snow : **SNC1\$1HDD** + Capacité : T8 + Description : Snowcone + Type d'appareil : **EDGE\$1S** + Capacité : T98 + Description : Snowball Edge Storage Optimized pour le transfert de données uniquement + Type d'appareil : **EDGE\$1CG** + Capacité : T42 + Description : Snowball Edge Compute Optimized avec GPU + Type d'appareil : **EDGE\$1C** + Capacité : T42 + Description : Snowball Edge Compute Optimized sans GPU + Type d'appareil : **EDGE** + Capacité : T100 + Description : Snowball Edge Storage Optimized avec EC2 Compute + Type d'appareil : **STANDARD** + Capacité : T50 + Description : Appareil Snowball original **Note** Cet appareil n'est disponible qu'au Ningxia, à Pékin et à SingapourRégion AWS + Type d'appareil : **STANDARD** + Capacité : T80 + Description : Appareil Snowball original **Note** Cet appareil n'est disponible qu'au Ningxia, à Pékin et à SingapourRégion AWS. ## Syntaxe de la requête ``` { "AddressId": "string", "ClusterId": "string", "Description": "string", "DeviceConfiguration": { "SnowconeDeviceConfiguration": { "WirelessConnection": { "IsWifiEnabled": boolean } } }, "ForwardingAddressId": "string", "JobType": "string", "KmsKeyARN": "string", "LongTermPricingId": "string", "Notification": { "JobStatesToNotify": [ "string" ], "NotifyAll": boolean, "SnsTopicARN": "string" }, "OnDeviceServiceConfiguration": { "EKSOnDeviceService": { "EKSAnywhereVersion": "string", "KubernetesVersion": "string" }, "NFSOnDeviceService": { "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" } } } ``` ## Paramètres de demande Pour plus d'informations sur les paramètres communs à toutes les actions, voir [Paramètres communs](CommonParameters.md). Cette demande accepte les données suivantes au format JSON. ** [AddressId](#API_CreateJob_RequestSyntax) ** L'identifiant de l'adresse à laquelle vous souhaitez que l'appareil Snow soit expédié. 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 ** [ClusterId](#API_CreateJob_RequestSyntax) ** ID d'un cluster. Si vous créez une tâche pour un nœud d'un cluster, vous devez uniquement fournir cette`clusterId` valeur. Les autres attributs de tâche sont hérités du cluster. Type : String Contraintes de longueur : longueur fixe de 39. Modèle : `CID[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}` Obligatoire : non ** [Description](#API_CreateJob_RequestSyntax) ** Définit une description facultative de cette tâche spécifique, par exemple`Important Photos 2016-08-11`. Type : String Contraintes de longueur : Longueur minimum de 1. Longueur maximum de 1024. Modèle : `.*` Obligatoire : non ** [DeviceConfiguration](#API_CreateJob_RequestSyntax) ** Définit la configuration de l'appareil pour uneAWS Snowball Edge tâche. Pour plus d'informations sur les types d'appareils de la [famille Snow, consultez les sections Appareils et capacités](https://docs.aws.amazon.com/snowball/latest/snowcone-guide/snow-device-types.html) de la famille [Snow dans le *guide de l'utilisateur Snowcone* ou Appareils et capacités de la famille Snow](https://docs.aws.amazon.com/snowball/latest/developer-guide/snow-device-types.html) dans le *guide de l'utilisateur Snowball Edge*. Type : objet [DeviceConfiguration](API_DeviceConfiguration.md) Obligatoire : non ** [ForwardingAddressId](#API_CreateJob_RequestSyntax) ** 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 ** [JobType](#API_CreateJob_RequestSyntax) ** Définit le type de tâche que vous créez. Type : String Valeurs valides :` IMPORT | EXPORT | LOCAL_USE` Obligatoire : non ** [KmsKeyARN](#API_CreateJob_RequestSyntax) ** celui`KmsKeyARN` que vous voulez associer à ce travail. `KmsKeyARN`s sont créés à l'aide de l'action d'API [CreateKey](https://docs.aws.amazon.com/kms/latest/APIReference/API_CreateKey.html)AWS Key Management Service(KMS). Type : String Contraintes de longueur : longueur maximale de 255. Modèle : `arn:aws.*:kms:.*:[0-9]{12}:key/.*` Obligatoire : non ** [LongTermPricingId](#API_CreateJob_RequestSyntax) ** L'identifiant du type de tarification à long terme pour l'appareil. Type : String Contraintes de longueur : longueur fixe de 41. Modèle : `LTPID[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}` Obligatoire : non ** [Notification](#API_CreateJob_RequestSyntax) ** Définit les paramètres de notification Amazon Simple Notification Service (Amazon SNS) pour cette tâche. Type : objet [Notification](API_Notification.md) Obligatoire : non ** [OnDeviceServiceConfiguration](#API_CreateJob_RequestSyntax) ** 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](API_OnDeviceServiceConfiguration.md) Obligatoire : non ** [RemoteManagement](#API_CreateJob_RequestSyntax) ** Vous permet de faire fonctionner et de gérer les appareils Snowcone à distance en toute sécurité depuis l'extérieur de votre réseau interne. Lorsque ce paramètre est réglé sur`INSTALLED_AUTOSTART`, la gestion à distance sera automatiquement disponible lorsque l'appareil arrivera chez vous. Sinon, vous devez utiliser le client Snowball pour gérer l'appareil. Type : String Valeurs valides :` INSTALLED_ONLY | INSTALLED_AUTOSTART` Obligatoire : non ** [Resources](#API_CreateJob_RequestSyntax) ** Définit les compartiments Amazon S3 associés à cette tâche. Avec les`IMPORT` tâches, vous spécifiez le ou les compartiments dans lesquels les données transférées seront importées. Avec les`EXPORT` tâches, vous spécifiez le ou les compartiments à partir desquels les données transférées seront exportées. Le cas échéant, vous pouvez également spécifier une`KeyRange` valeur. Si vous choisissez d'exporter une plage, vous définissez la longueur de la plage en fournissant soit une`BeginMarker` valeur inclusive, soit une`EndMarker` valeur inclusive, soit les deux. Les plages sont triées dans un ordre binaire UTF-8. Type : objet [JobResource](API_JobResource.md) Obligatoire : non ** [RoleARN](#API_CreateJob_RequestSyntax) ** celui`RoleARN` que vous voulez associer à ce travail. `RoleArn`s sont créés à l'aide de l'action d'API [CreateRole](https://docs.aws.amazon.com/IAM/latest/APIReference/API_CreateRole.html)Gestion des identités et des accès AWS(IAM). Type : String Contraintes de longueur : longueur maximale de 255. Modèle : `arn:aws.*:iam::[0-9]{12}:role/.*` Obligatoire : non ** [ShippingOption](#API_CreateJob_RequestSyntax) ** La rapidité d'expédition pour cette tâche. Cette vitesse ne dicte pas la rapidité avec laquelle vous recevrez l'appareil Snow, mais plutôt la rapidité avec laquelle l'appareil Snow se déplace vers sa destination pendant le transport. Les vitesses d'expédition régionales sont les suivantes : + En Australie, vous avez accès à la livraison express. En règle générale, les appareils Snow expédiés en express sont livrés en une journée environ. + Dans l'Union européenne (UE), vous avez accès à la livraison express. En règle générale, les appareils Snow expédiés en express sont livrés en une journée environ. En outre, la plupart des pays de l'UE ont accès à l'expédition standard, ce qui prend généralement moins d'une semaine dans un sens. + En Inde, les appareils Snow sont livrés en un à sept jours. + Aux États-Unis, vous avez accès à la livraison en un jour et à la livraison en deux jours. Type : String Valeurs valides :` SECOND_DAY | NEXT_DAY | EXPRESS | STANDARD` Obligatoire : non ** [SnowballCapacityPreference](#API_CreateJob_RequestSyntax) ** Si votre poste est créé dans l'une des régions des États-Unis, vous avez la possibilité de spécifier la taille de l'appareil Snow que vous souhaitez pour ce travail. Dans toutes les autres régions, les Snowballs disposent d'une capacité de stockage de 80 To. Pour plus d'informations sur les types d'appareils de la [famille Snow, consultez les sections Appareils et capacités](https://docs.aws.amazon.com/snowball/latest/snowcone-guide/snow-device-types.html) de la famille [Snow dans le *guide de l'utilisateur Snowcone* ou Appareils et capacités de la famille Snow](https://docs.aws.amazon.com/snowball/latest/developer-guide/snow-device-types.html) dans le *guide de l'utilisateur Snowball Edge*. Type : String Valeurs valides :` T50 | T80 | T100 | T42 | T98 | T8 | T14 | T32 | NoPreference` Obligatoire : non ** [SnowballType](#API_CreateJob_RequestSyntax) ** Type d'appareils Snow Family à utiliser pour cette tâche. Pour les tâches de cluster,AWS Snow Family ne prend actuellement en charge que le type d'`EDGE`appareil. Type d'appareilAWS Snow à utiliser pour cette tâche. Actuellement, le seul type de périphérique pris en charge pour les tâches de cluster est`EDGE`. Pour de plus amples informations, veuillez consulter [Options du périphérique Snowball Edge](https://docs.aws.amazon.com/snowball/latest/developer-guide/device-differences.html) dans le Manuel du développeur de Snowball Edge. Pour plus d'informations sur les types d'appareils de la [famille Snow, consultez les sections Appareils et capacités](https://docs.aws.amazon.com/snowball/latest/snowcone-guide/snow-device-types.html) de la famille [Snow dans le *guide de l'utilisateur Snowcone* ou Appareils et capacités de la famille Snow](https://docs.aws.amazon.com/snowball/latest/developer-guide/snow-device-types.html) dans le *guide de l'utilisateur Snowball Edge*. Type : String Valeurs valides :` STANDARD | EDGE | EDGE_C | EDGE_CG | EDGE_S | SNC1_HDD | SNC1_SSD | V3_5C` Obligatoire : non ** [TaxDocuments](#API_CreateJob_RequestSyntax) ** Les documents fiscaux requis dans votreRégion AWS. Type : objet [TaxDocuments](API_TaxDocuments.md) Obligatoire : non ## Syntaxe de la réponse ``` { "JobId": "string" } ``` ## Eléments de réponse Si l'action aboutit, le service renvoie une réponse HTTP 200. Les données suivantes sont renvoyées au format JSON par le service. ** [JobId](#API_CreateJob_ResponseSyntax) ** L'identifiant généré automatiquement pour une tâche, 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}` ## Erreurs Pour plus d'informations sur les erreurs communes à toutes les actions, consultez[Erreurs courantes](CommonErrors.md). ** ClusterLimitExceededException ** La création du poste de travail a échoué. 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 d'un travail ou d'un cluster a échoué. Une ou plusieurs entrées n'étaient pas valides. Vérifiez que laSnowballType valeur [CreateCluster:](API_CreateCluster.md#Snowball-CreateCluster-request-SnowballType) est compatible avec votre [CreateJob:JobType](#Snowball-CreateJob-request-JobType), puis réessayez. Code d'état HTTP : 400 ** InvalidResourceException ** La ressource spécifiée est introuvable. Vérifiez les informations que vous avez fournies dans votre 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'[UpdateJob](API_UpdateJob.md)action[CreateJob](#API_CreateJob) 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 : + [Interface de ligne de commande AWS](https://docs.aws.amazon.com/goto/aws-cli/snowball-2016-06-30/CreateJob) + [AWS SDK pour .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/snowball-2016-06-30/CreateJob) + [Kit AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/snowball-2016-06-30/CreateJob) + [Kit AWS SDK pour Go](https://docs.aws.amazon.com/goto/SdkForGoV1/snowball-2016-06-30/CreateJob) + [Kit SDK AWS pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/snowball-2016-06-30/CreateJob) + [AWSSDK pour JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/snowball-2016-06-30/CreateJob) + [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/snowball-2016-06-30/CreateJob) + [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/snowball-2016-06-30/CreateJob) + [Kit SDK AWS pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/snowball-2016-06-30/CreateJob)