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 laclusterId 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.

Les appareils de la famille Snow et leurs capacités.

• Type d'appareil de la famille Snow : SNC1_SSD

  • Capacité : T14

  • Description : Snowcone

• Type d'appareil de la famille Snow : SNC1_HDD

  • Capacité : T8

  • Description : Snowcone

• Type d'appareil : EDGE_S

  • Capacité : T98

  • Description : Snowball Edge Storage Optimized pour le transfert de données uniquement

• Type d'appareil : EDGE_CG

  • Capacité : T42

  • Description : Snowball Edge Compute Optimized avec GPU

• Type d'appareil : EDGE_C

  • 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.

Cette demande accepte les données suivantes au format JSON.

AddressId

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

ID d'un cluster. Si vous créez une tâche pour un nœud d'un cluster, vous devez uniquement fournir cetteclusterId 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

Définit une description facultative de cette tâche spécifique, par exempleImportant Photos 2016-08-11.

Type : String

Contraintes de longueur : Longueur minimum de 1. Longueur maximum de 1024.

Modèle : .*

Obligatoire : non

DeviceConfiguration

Définit la configuration de l'appareil pour uneAWS Snowcone tâche.

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 : objet DeviceConfiguration

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

JobType

Définit le type de tâche que vous créez.

Type : String

Valeurs valides : IMPORT | EXPORT | LOCAL_USE

Obligatoire : non

KmsKeyARN

celuiKmsKeyARN que vous voulez associer à ce travail. KmsKeyARNs sont créés à l'aide de l'action d'API CreateKeyAWS 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

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

Définit les paramètres de notification Amazon Simple Notification Service (Amazon SNS) pour cette tâche.

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

RemoteManagement

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é surINSTALLED_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

Définit les compartiments Amazon S3 associés à cette tâche.

Avec lesIMPORT tâches, vous spécifiez le ou les compartiments dans lesquels les données transférées seront importées.

Avec lesEXPORT 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 uneKeyRange valeur. Si vous choisissez d'exporter une plage, vous définissez la longueur de la plage en fournissant soit uneBeginMarker valeur inclusive, soit uneEndMarker valeur inclusive, soit les deux. Les plages sont triées dans un ordre binaire UTF-8.

Type : objet JobResource

Obligatoire : non

RoleARN

celuiRoleARN que vous voulez associer à ce travail. RoleArns sont créés à l'aide de 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 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

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 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 | NoPreference

Obligatoire : non

SnowballType

Type d'appareils Snow Family à utiliser pour cette tâche.

Note

Pour les tâches de cluster,AWS Snow Family ne prend actuellement en charge que le type d'EDGEappareil.

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 estEDGE.

Pour de plus amples informations, veuillez consulter Options du périphérique Snowball Edge 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 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 : STANDARD | EDGE | EDGE_C | EDGE_CG | EDGE_S | SNC1_HDD | SNC1_SSD | V3_5C

Obligatoire : non

TaxDocuments

Les documents fiscaux requis dans votreRégion AWS.

Type : objet TaxDocuments

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

L'identifiant généré automatiquement pour une tâche, par exempleJID123e4567-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, consultezErreurs courantes.

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: est compatible avec votre CreateJob: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'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 :

• Interface de ligne de commande AWS

• AWS SDK pour .NET

• Kit AWS SDK pour C++

• Kit AWS SDK pour Go

• Kit SDK AWS pour Java V2

• AWSSDK pour JavaScript

• AWS SDK pour PHP V3

• AWS SDK pour Python

• Kit SDK AWS pour Ruby V3