UpdateJob - AWS Snowball
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 dispositivos Snowcone (y). HDD 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 JSON formato.

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 dispositivos Snowcone (y). HDD 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 nuevo rol Amazon Resource Name (ARN) que desea asociar a este trabajo. Para crear un rolARN, utilice 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

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 de HTTP 200 puntos con el cuerpo vacíoHTTP.

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

InvalidJobStateException

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

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: