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.

# GetJobUnlockCode
<a name="API_GetJobUnlockCode"></a>

**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/).

Devuelve el valor del código `UnlockCode` para la tarea especificada. Se puede acceder a un valor `UnlockCode` concreto hasta 360 días después de que se haya creado el trabajo asociado.

El valor `UnlockCode` es un código de 29 caracteres con 25 caracteres alfanuméricos y 4 guiones. Este código se utiliza para descifrar el archivo de manifiesto que se transfiere junto con el manifiesto al dispositivo mediante el cliente Snowball cuando este se inicia por primera vez. El único estado válido para llamar a esta API es `WithCustomer`, ya que el manifiesto y los valores del código `Unlock` se utilizan para proteger el dispositivo y solo se deben usar cuando se tiene el dispositivo.

Como práctica recomendada, se recomienda no guardar una copia de `UnlockCode` en la misma ubicación donde se encuentra el archivo de manifiesto de ese trabajo. Guardarlos por separado ayuda a evitar que personas no autorizadas accedan al dispositivo Snow asociado a ese trabajo.

## Sintaxis de la solicitud
<a name="API_GetJobUnlockCode_RequestSyntax"></a>

```
{
   "JobId": "string"
}
```

## Parámetros de la solicitud
<a name="API_GetJobUnlockCode_RequestParameters"></a>

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.

 ** [JobId](#API_GetJobUnlockCode_RequestSyntax) **   <a name="Snowball-GetJobUnlockCode-request-JobId"></a>
El ID del trabajo cuyo valor `UnlockCode` desea obtener, 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í

## Sintaxis de la respuesta
<a name="API_GetJobUnlockCode_ResponseSyntax"></a>

```
{
   "UnlockCode": "string"
}
```

## Elementos de respuesta
<a name="API_GetJobUnlockCode_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [UnlockCode](#API_GetJobUnlockCode_ResponseSyntax) **   <a name="Snowball-GetJobUnlockCode-response-UnlockCode"></a>
El valor `UnlockCode` para el trabajo especificado. Se puede acceder al valor `UnlockCode` hasta 360 días después de que se haya creado el trabajo.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 1024 caracteres.  
Patrón: `.*` 

## Errores
<a name="API_GetJobUnlockCode_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

 ** 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.    
 ** ResourceType **   
El valor de recurso proporcionado no es válido.
Código de estado HTTP: 400

## Véase también
<a name="API_GetJobUnlockCode_SeeAlso"></a>

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/GetJobUnlockCode) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/snowball-2016-06-30/GetJobUnlockCode) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/snowball-2016-06-30/GetJobUnlockCode) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/snowball-2016-06-30/GetJobUnlockCode) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/snowball-2016-06-30/GetJobUnlockCode) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/snowball-2016-06-30/GetJobUnlockCode) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/snowball-2016-06-30/GetJobUnlockCode) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/snowball-2016-06-30/GetJobUnlockCode) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/snowball-2016-06-30/GetJobUnlockCode) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/snowball-2016-06-30/GetJobUnlockCode)