CreateJob

Crea una tarea para importar o exportar datos entre Amazon S3 y su centro de datos local. Cuenta de AWS Debe contar con las políticas de confianza y los permisos adecuados para crear un trabajo para un dispositivo Snow. Si va a crear un trabajo para un nodo de un clúster, solo tiene que proporcionar el valor clusterId; los demás atributos del trabajo se heredan del clúster.

nota

Solo se admite el tipo de dispositivo Snowball Edge al solicitar trabajos agrupados en clústeres.

La capacidad del dispositivo es opcional.

La disponibilidad de los tipos de dispositivos varía según la Región de AWS. Para obtener información acerca de la disponibilidad regional, consulte Servicios regionales de AWS.

Dispositivos Snow Family y sus capacidades.

• Tipo de dispositivo: SNC1_ SSD

  • Capacidad: T14

  • Descripción: Snowcone

• Tipo de dispositivo: SNC1_ HDD

  • Capacidad: T8

  • Descripción: Snowcone

• Tipo de dispositivo: EDGE_S

  • Capacidad: T98

  • Descripción: Snowball Edge Storage Optimized solo para la transferencia de datos

• Tipo de dispositivo: _CG EDGE

  • Capacidad: T42

  • Descripción: Snowball Edge Compute Optimized con GPU

• Tipo de dispositivo: _C EDGE

  • Capacidad: T42

  • Descripción: Snowball Edge Compute Optimized sin GPU

• Tipo de dispositivo: EDGE

  • Capacidad: T100

  • Descripción: Snowball Edge Storage Optimized with Compute EC2

  nota

  Este dispositivo se sustituye por el T98.

• Tipo de dispositivo: STANDARD

  • Capacidad: T50

  • Descripción: dispositivo Snowball original

    nota

    Este dispositivo solo está disponible en Ningxia, Pekín y Singapur Región de AWS

• Tipo de dispositivo: STANDARD

  • Capacidad: T80

  • Descripción: dispositivo Snowball original

    nota

    Este dispositivo solo está disponible en la Región de AWS de Ningxia, Pekín y Singapur.

• Tipo de dispositivo de la familia Snow: RACK_5U_C

  • Capacidad: T13

  • Descripción: Snowblade.

• Tipo de dispositivo: V3_5S

  • Capacidad: T240

  • Descripción: Snowball Edge Storage Optimized de 210 TB

Sintaxis de la solicitud

{
   "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"
      }
   }
}

Parámetros de la solicitud

Para obtener información sobre los parámetros comunes a todas las acciones, consulte Parámetros comunes.

La solicitud acepta los siguientes datos en formato. JSON

AddressId

El ID de la dirección a la que desea enviar el dispositivo Snow.

Tipo: cadena

Limitaciones de longitud: longitud fija de 40.

Patrón: ADID[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}

Obligatorio: no

ClusterId

El ID de un clúster. Si va a crear un trabajo para un nodo de un clúster, solo debe proporcionar este valor clusterId. Los demás atributos del trabajo se heredan del clúster.

Tipo: cadena

Limitaciones de longitud: longitud fija de 39.

Patrón: CID[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}

Obligatorio: no

Description

Define una descripción opcional de este trabajo específico, por ejemplo, Important Photos 2016-08-11.

Tipo: cadena

Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 1024 caracteres.

Patrón: ^[a-zA-Z0-9\s\-\_\.\:]+$

Obligatorio: no

DeviceConfiguration

Define la configuración del dispositivo para un AWS Snowcone trabajo.

Para obtener información sobre los tipos de dispositivos Snow Family, consulte Dispositivos y capacidad de Snow Family en la Guía del usuario de Snowcone o Dispositivos y capacidad de Snow Family en la Guía del usuario de Snowball Edge.

Tipo: objeto DeviceConfiguration

Obligatorio: no

ForwardingAddressId

Este campo no se admite en su región.

Tipo: cadena

Limitaciones de longitud: longitud fija de 40.

Patrón: ADID[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}

Obligatorio: no

ImpactLevel

El nivel de impacto más alto de los datos que se almacenarán o procesarán en el dispositivo, proporcionado en el momento de la creación del trabajo.

Tipo: cadena

Valores válidos: IL2 | IL4 | IL5 | IL6 | IL99

Obligatorio: no

JobType

Define el tipo de trabajo que está creando.

Tipo: cadena

Valores válidos: IMPORT | EXPORT | LOCAL_USE

Obligatorio: no

KmsKeyARN

La KmsKeyARN que desea asociar a este trabajo. KmsKeyARNLos s se crean mediante la API acción CreateKey AWS Key Management Service (KMS).

Tipo: cadena

Limitaciones de longitud: longitud máxima de 255 caracteres.

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

Obligatorio: no

LongTermPricingId

El ID del tipo de precios a largo plazo del dispositivo.

Tipo: cadena

Limitaciones de longitud: longitud fija de 41.

Patrón: LTPID[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}

Obligatorio: no

Notification

Define la configuración de notificaciones de Amazon Simple Notification Service (AmazonSNS) para este trabajo.

Tipo: objeto Notification

Obligatorio: no

OnDeviceServiceConfiguration

Especifica el servicio o los servicios del dispositivo de la familia Snow desde los que se exportarán o importarán los datos transferidos. AWS La familia Snow es compatible con Amazon S3 y NFS (Network File System) y el servicio AWS Storage Gateway del tipo Tape Gateway.

Tipo: objeto OnDeviceServiceConfiguration

Obligatorio: no

PickupDetails

Información que identifica a la persona que recoge el dispositivo.

Tipo: objeto PickupDetails

Obligatorio: no

RemoteManagement

Le permite utilizar y administrar de forma segura los dispositivos Snowcone de forma remota desde fuera de su red interna. Si se establece en INSTALLED_AUTOSTART, la administración remota estará disponible automáticamente cuando el dispositivo llegue a su ubicación. De lo contrario, tendrá que utilizar el cliente de Snowball Edge para administrar el dispositivo. Si se establece en NOT_INSTALLED, la administración remota no estará disponible en el dispositivo.

Tipo: cadena

Valores válidos: INSTALLED_ONLY | INSTALLED_AUTOSTART | NOT_INSTALLED

Obligatorio: no

Resources

Define los buckets de Amazon S3 asociados a este trabajo.

Con trabajos IMPORT, debe especificar el bucket o los buckets a los que se importarán los datos transferidos.

Con trabajos EXPORT, debe especificar el bucket o los buckets a los que se exportarán los datos transferidos. También puede especificar un valor KeyRange. Si elige exportar un rango, defina la longitud del rango proporcionando un valor BeginMarker inclusivo, un valor EndMarker inclusivo, o ambos. Los rangos están ordenados en UTF forma binaria de 8 a 8.

Tipo: objeto JobResource

Obligatorio: no

RoleARN

El RoleARN que desea asociar a este trabajo. RoleArnLos s se crean mediante la API acción CreateRole AWS Identity and Access Management (IAM).

Tipo: cadena

Limitaciones de longitud: longitud máxima de 255 caracteres.

Patrón: arn:aws.*:iam::[0-9]{12}:role/.*

Obligatorio: no

ShippingOption

La velocidad de envío de este trabajo. Esta velocidad no determina la rapidez con la que recibirá el dispositivo Snow, sino que representa la rapidez con la que el dispositivo Snow se mueve a su destino mientras está en tránsito. Las velocidades de envío regionales son:

• En Australia, tiene acceso al envío urgente. Normalmente, los dispositivos Snow que se envían con la modalidad urgente tardan alrededor de un día en entregarse.

• En la Unión Europea (UE), tiene acceso al envío urgente. Normalmente, los dispositivos Snow que se envían con la modalidad urgente tardan alrededor de un día en entregarse. Además, la mayoría de los países de la UE pueden utilizar el envío estándar, que suele tardar menos de una semana, de ida o de vuelta.

• En la India, los dispositivos Snow se entregan en un plazo de uno a siete días.

• En Estados Unidos, es posible utilizar el envío en un día o en dos días.

Tipo: cadena

Valores válidos: SECOND_DAY | NEXT_DAY | EXPRESS | STANDARD

Obligatorio: no

SnowballCapacityPreference

Si su trabajo se está creando en una de las regiones de EE. UU., tiene la opción de especificar el tamaño del dispositivo Snow que desea para este trabajo. En el resto de regiones, los dispositivos Snowball vienen con una capacidad de almacenamiento de 80 TB.

Para obtener información sobre los tipos de dispositivos Snow Family, consulte Dispositivos y capacidad de Snow Family en la Guía del usuario de Snowcone o Dispositivos y capacidad de Snow Family en la Guía del usuario de Snowball Edge.

Tipo: cadena

Valores válidos: T50 | T80 | T100 | T42 | T98 | T8 | T14 | T32 | NoPreference | T240 | T13

Obligatorio: no

SnowballType

Los tipos de dispositivos Snow Family que se utilizarán para este trabajo.

nota

Para los trabajos de clúster, AWS Snow Family actualmente solo admite el tipo de EDGE dispositivo.

El tipo de dispositivo AWS Snow que se utilizará para este trabajo. Actualmente, el único tipo de dispositivo que se admite para trabajos de clúster es EDGE.

Para obtener más información, consulte Snowball Edge Device Options en la Guía para desarrolladores de Snowball Edge.

Para obtener información sobre los tipos de dispositivos Snow Family, consulte Dispositivos y capacidad de Snow Family en la Guía del usuario de Snowcone o Dispositivos y capacidad de Snow Family en la Guía del usuario de Snowball Edge.

Tipo: cadena

Valores válidos: STANDARD | EDGE | EDGE_C | EDGE_CG | EDGE_S | SNC1_HDD | SNC1_SSD | V3_5C | V3_5S | RACK_5U_C

Obligatorio: no

TaxDocuments

Los documentos fiscales requeridos en su Región de AWS.

Tipo: objeto TaxDocuments

Obligatorio: no

Sintaxis de la respuesta

{
   "JobId": "string"
}

Elementos de respuesta

Si la acción se realiza correctamente, el servicio envía una respuesta de HTTP 200.

El servicio devuelve los siguientes datos en JSON formato.

JobId

El ID generado automáticamente para un trabajo, por ejemplo, JID123e4567-e89b-12d3-a456-426655440000.

Tipo: cadena

Limitaciones de longitud: longitud fija de 39.

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

Errores

Para obtener información acerca de los errores comunes a todas las acciones, consulte Errores comunes.

ClusterLimitExceededException

Error de creación del trabajo. Actualmente, los clústeres admiten cinco nodos. Si tiene menos de cinco nodos para el clúster y tiene que crear más nodos para este clúster, inténtelo de nuevo y cree trabajos hasta que el clúster tenga exactamente cinco nodos.

HTTPCódigo de estado: 400

Ec2RequestFailedException

El usuario carece de los EC2 permisos de Amazon necesarios para realizar el intento de acción.

HTTPCódigo de estado: 400

InvalidInputCombinationException

Error al crear el trabajo o clúster. Una o más entradas no son válidas. Confirme que el SnowballType valor CreateCluster: es compatible con su CreateJob: JobType e inténtelo de nuevo.

HTTPCódigo de estado: 400

InvalidResourceException

No se ha encontrado el recurso especificado. Compruebe la información que proporcionó en la última solicitud e inténtelo de nuevo.

HTTPCódigo de estado: 400

KMSRequestFailedException

La AWS Key Management Service clave proporcionada carece de los permisos para realizar la UpdateJob acción CreateJob o acción especificada.

HTTPCódigo de estado: 400

Véase también

Para obtener más información sobre cómo usarlo API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:

• Interfaz de la línea de comandos de AWS

• AWS SDKpara. NET

• AWS SDKpara C++

• AWS SDKpara Go v2

• AWS SDKpara Java V2

• AWS SDKpara JavaScript V3

• AWS SDKpara PHP V3

• AWS SDKpara Python

• AWS SDKpara Ruby V3