UpdateJob - AWS Snowball Edge
Sintaxis de la solicitudParámetros de la solicitudElementos 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.

UpdateJob

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.

Aunque el valor JobState de un trabajo sea New, puede actualizar parte de la información asociada a un trabajo. Una vez que el trabajo cambia a un estado diferente, normalmente 60 minutos después de crearlo, esta acción deja de estar disponible.

Sintaxis de la solicitud

{
   "AddressId": "string",
   "Description": "string",
   "ForwardingAddressId": "string",
   "JobId": "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"
   },
   "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"
}

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 del objeto Address actualizado.

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

Description

La descripción actualizada del JobMetadata objeto de este trabajo.

Tipo: cadena

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

Patrón: .*

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

JobId

El ID del trabajo que desea actualizar, 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}

Obligatorio: sí

Notification

El objeto Notification nuevo o actualizado.

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 Snowball Edge es compatible con Amazon S3 y NFS (Network File System).

Tipo: objeto OnDeviceServiceConfiguration

Obligatorio: no

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

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

Tipo: objeto PickupDetails

Obligatorio: no

Resources

El objeto JobResource actualizado o el objeto JobResource actualizado.

Tipo: objeto JobResource

Obligatorio: no

RoleARN

El Nombre de recurso de Amazon (ARN) del rol nuevo que desea asociar a este trabajo. Para crear un ARN de rol, utilice 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

El valor actualizado de la opción de envío del objeto ShippingDetails de este trabajo.

Tipo: cadena

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

Obligatorio: no

SnowballCapacityPreference

La SnowballCapacityPreference actualizada del objeto JobMetadata de este 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: cadena

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

Obligatorio: no

Elementos de respuesta

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200 con un cuerpo HTTP vacío.

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

InvalidJobStateException

La acción no se puede realizar porque el estado actual del trabajo no permite que se realice esa acción.

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: