CreateJob - AWS Snowball
Sintaxis de la solicitudParámetros de la solicitudSintaxis de la respuestaElementos de respuestaErroresVéase también

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

CreateJob

importante

Aviso de fin de soporte: el 12 de noviembre de 2024, AWS se suspenderán los dispositivos AWS Snowball de la generación anterior y los dos dispositivos Snowcone (HDD y SDD). Seguiremos ofreciendo asistencia a los clientes actuales que utilicen estos end-of-life dispositivos hasta el 12 de noviembre de 2025. Los dispositivos AWS Snowball de última generación están disponibles para todos los clientes. Para obtener más información, visite esta publicación del blog.

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.

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: V3_5C

    • Capacidad: T32

    • Descripción: Snowball Edge Compute Optimized

  • 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 de Snowball Edge, consulte la información sobre el hardware del dispositivo en la Guía del desarrollador 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 acción de la API 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 notificación de Amazon Simple Notification Service (Amazon SNS) 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).

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 se ordenan según las normas de UTF-8 binario.

Tipo: objeto JobResource

Obligatorio: no

RoleARN

Lo RoleARN que desea asociar a este trabajo. RoleArnLos s se crean mediante la acción de la API 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 de Snowball Edge, consulte la información sobre el hardware del dispositivo en la Guía del desarrollador 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 Snowball Edge actualmente solo admite el tipo de EDGE dispositivo.

El tipo de dispositivo AWS Snow que se va a 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 la información sobre el hardware del dispositivo en la Guía para desarrolladores 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 devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

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.

Código de estado HTTP: 400

Ec2RequestFailedException

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

Código de estado HTTP: 400

InvalidInputCombinationException

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

Código de estado HTTP: 400

InvalidResourceException

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

Código de estado HTTP: 400

KMSRequestFailedException

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

Código de estado HTTP: 400

Véase también

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente: