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.
# DescribeJob
**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 información sobre una tarea específica que incluye información de envío, estado de la tarea y otros metadatos importantes.
## Sintaxis de la solicitud
```
{
"JobId": "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.
** [JobId](#API_DescribeJob_RequestSyntax) **
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}`
Obligatorio: sí
## Sintaxis de la respuesta
```
{
"JobMetadata": {
"AddressId": "string",
"ClusterId": "string",
"CreationDate": number,
"DataTransferProgress": {
"BytesTransferred": number,
"ObjectsTransferred": number,
"TotalBytes": number,
"TotalObjects": number
},
"Description": "string",
"DeviceConfiguration": {
"SnowconeDeviceConfiguration": {
"WirelessConnection": {
"IsWifiEnabled": boolean
}
}
},
"ForwardingAddressId": "string",
"ImpactLevel": "string",
"JobId": "string",
"JobLogInfo": {
"JobCompletionReportURI": "string",
"JobFailureLogURI": "string",
"JobSuccessLogURI": "string"
},
"JobState": "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",
"ShippingDetails": {
"InboundShipment": {
"Status": "string",
"TrackingNumber": "string"
},
"OutboundShipment": {
"Status": "string",
"TrackingNumber": "string"
},
"ShippingOption": "string"
},
"SnowballCapacityPreference": "string",
"SnowballId": "string",
"SnowballType": "string",
"TaxDocuments": {
"IND": {
"GSTIN": "string"
}
}
},
"SubJobMetadata": [
{
"AddressId": "string",
"ClusterId": "string",
"CreationDate": number,
"DataTransferProgress": {
"BytesTransferred": number,
"ObjectsTransferred": number,
"TotalBytes": number,
"TotalObjects": number
},
"Description": "string",
"DeviceConfiguration": {
"SnowconeDeviceConfiguration": {
"WirelessConnection": {
"IsWifiEnabled": boolean
}
}
},
"ForwardingAddressId": "string",
"ImpactLevel": "string",
"JobId": "string",
"JobLogInfo": {
"JobCompletionReportURI": "string",
"JobFailureLogURI": "string",
"JobSuccessLogURI": "string"
},
"JobState": "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",
"ShippingDetails": {
"InboundShipment": {
"Status": "string",
"TrackingNumber": "string"
},
"OutboundShipment": {
"Status": "string",
"TrackingNumber": "string"
},
"ShippingOption": "string"
},
"SnowballCapacityPreference": "string",
"SnowballId": "string",
"SnowballType": "string",
"TaxDocuments": {
"IND": {
"GSTIN": "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.
** [JobMetadata](#API_DescribeJob_ResponseSyntax) **
Devuelve información sobre un trabajo específico, que incluye información de envío, estado del trabajo y otros metadatos importantes.
Tipo: objeto [JobMetadata](API_JobMetadata.md)
** [SubJobMetadata](#API_DescribeJob_ResponseSyntax) **
Información sobre un trabajo específico (en el caso de un trabajo de exportación), que incluye información de envío, estado del trabajo y otros metadatos importantes.
Tipo: matriz de objetos [JobMetadata](API_JobMetadata.md)
## Errores
Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).
** 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
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/DescribeJob)
+ [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/snowball-2016-06-30/DescribeJob)
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/snowball-2016-06-30/DescribeJob)
+ [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/snowball-2016-06-30/DescribeJob)
+ [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/snowball-2016-06-30/DescribeJob)
+ [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/snowball-2016-06-30/DescribeJob)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/snowball-2016-06-30/DescribeJob)
+ [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/snowball-2016-06-30/DescribeJob)
+ [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/snowball-2016-06-30/DescribeJob)
+ [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/snowball-2016-06-30/DescribeJob)