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 **nota** AWS Snowball Edge ya no está disponible para nuevos clientes. Los nuevos clientes deberían [AWS DataSync](https://aws.amazon.com/datasync/)buscar transferencias en línea, un [terminal de transferencia de AWS datos](https://aws.amazon.com/data-transfer-terminal/) para transferencias físicas seguras o soluciones de AWS socios. Para la computación perimetral, explora [AWS Outposts](https://aws.amazon.com/outposts/). 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](https://aws.amazon.com/about-aws/global-infrastructure/regional-product-services/?p=ngi&loc=4). **Dispositivos Snow Family y sus capacidades.** + **Tipo de dispositivo: V3\$15C** + Capacidad: T32 + Descripción: Snowball Edge Compute Optimized + Tipo de dispositivo: **V3\$15S** + 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](CommonParameters.md). La solicitud acepta los siguientes datos en formato JSON. ** [AddressId](#API_CreateJob_RequestSyntax) ** 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](#API_CreateJob_RequestSyntax) ** 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](#API_CreateJob_RequestSyntax) ** 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](#API_CreateJob_RequestSyntax) ** Define la configuración del dispositivo para un AWS Snowball Edge trabajo. Para obtener información sobre los tipos de dispositivos de Snowball Edge, consulte la [información sobre el hardware del dispositivo](https://docs.aws.amazon.com/snowball/latest/developer-guide/device-differences.html) en la Guía del desarrollador de Snowball Edge. Tipo: objeto [DeviceConfiguration](API_DeviceConfiguration.md) Obligatorio: no ** [ForwardingAddressId](#API_CreateJob_RequestSyntax) ** 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](#API_CreateJob_RequestSyntax) ** 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](#API_CreateJob_RequestSyntax) ** Define el tipo de trabajo que está creando. Tipo: cadena Valores válidos: `IMPORT | EXPORT | LOCAL_USE` Obligatorio: no ** [KmsKeyARN](#API_CreateJob_RequestSyntax) ** La `KmsKeyARN` que desea asociar a este trabajo. `KmsKeyARN`Los s se crean mediante la acción de la API [CreateKey](https://docs.aws.amazon.com/kms/latest/APIReference/API_CreateKey.html) 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](#API_CreateJob_RequestSyntax) ** 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](#API_CreateJob_RequestSyntax) ** Define la configuración de notificación de Amazon Simple Notification Service (Amazon SNS) para este trabajo. Tipo: objeto [Notification](API_Notification.md) Obligatorio: no ** [OnDeviceServiceConfiguration](#API_CreateJob_RequestSyntax) ** 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](API_OnDeviceServiceConfiguration.md) Obligatorio: no ** [PickupDetails](#API_CreateJob_RequestSyntax) ** Información que identifica a la persona que recoge el dispositivo. Tipo: objeto [PickupDetails](API_PickupDetails.md) Obligatorio: no ** [RemoteManagement](#API_CreateJob_RequestSyntax) ** 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](#API_CreateJob_RequestSyntax) ** 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](API_JobResource.md) Obligatorio: no ** [RoleARN](#API_CreateJob_RequestSyntax) ** Lo `RoleARN` que desea asociar a este trabajo. `RoleArn`Los s se crean mediante la acción de la API [CreateRole](https://docs.aws.amazon.com/IAM/latest/APIReference/API_CreateRole.html) 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](#API_CreateJob_RequestSyntax) ** 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](#API_CreateJob_RequestSyntax) ** 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](https://docs.aws.amazon.com/snowball/latest/developer-guide/device-differences.html) 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](#API_CreateJob_RequestSyntax) ** Los tipos de dispositivos Snow Family que se utilizarán para este trabajo. 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](https://docs.aws.amazon.com/snowball/latest/developer-guide/device-differences.html) 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](#API_CreateJob_RequestSyntax) ** Los documentos fiscales requeridos en su. Región de AWS Tipo: objeto [TaxDocuments](API_TaxDocuments.md) 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](#API_CreateJob_ResponseSyntax) ** 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 [Tipos de errores comunes](CommonErrors.md). ** 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:](API_CreateCluster.md#Snowball-CreateCluster-request-SnowballType) es compatible con tu [CreateJob: JobType](#Snowball-CreateJob-request-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. ** ResourceType ** El valor de recurso proporcionado no es válido. Código de estado HTTP: 400 ** KMSRequestFailedException ** La AWS Key Management Service clave proporcionada carece de los permisos necesarios para realizar la [UpdateJob](API_UpdateJob.md) acción [CreateJob](#API_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: + [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/snowball-2016-06-30/CreateJob) + [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/snowball-2016-06-30/CreateJob) + [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/snowball-2016-06-30/CreateJob) + [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/snowball-2016-06-30/CreateJob) + [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/snowball-2016-06-30/CreateJob) + [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/snowball-2016-06-30/CreateJob) + [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/snowball-2016-06-30/CreateJob) + [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/snowball-2016-06-30/CreateJob) + [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/snowball-2016-06-30/CreateJob) + [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/snowball-2016-06-30/CreateJob)