Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# DescribeJob
<a name="API_DescribeJob"></a>

Renvoie des informations sur une tâche spécifique, y compris les informations d'expédition, le statut de la tâche et d'autres métadonnées importantes. 

## Syntaxe de la requête
<a name="API_DescribeJob_RequestSyntax"></a>

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

## Paramètres de demande
<a name="API_DescribeJob_RequestParameters"></a>

Pour plus d'informations sur les paramètres communs à toutes les actions, voir [Paramètres communs](CommonParameters.md).

Cette demande accepte les données suivantes au format JSON.

 ** [JobId](#API_DescribeJob_RequestSyntax) **   <a name="Snowball-DescribeJob-request-JobId"></a>
L'identifiant généré automatiquement pour une tâche, par exemple`JID123e4567-e89b-12d3-a456-426655440000`.  
Type : String  
Contraintes de longueur : longueur fixe de 39.  
Modèle : `(M|J)ID[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}`   
Obligatoire : oui

## Syntaxe de la réponse
<a name="API_DescribeJob_ResponseSyntax"></a>

```
{
   "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",
      "JobId": "string",
      "JobLogInfo": { 
         "JobCompletionReportURI": "string",
         "JobFailureLogURI": "string",
         "JobSuccessLogURI": "string"
      },
      "JobState": "string",
      "JobType": "string",
      "KmsKeyARN": "string",
      "LongTermPricingId": "string",
      "Notification": { 
         "JobStatesToNotify": [ "string" ],
         "NotifyAll": boolean,
         "SnsTopicARN": "string"
      },
      "OnDeviceServiceConfiguration": { 
         "EKSOnDeviceService": { 
            "EKSAnywhereVersion": "string",
            "KubernetesVersion": "string"
         },
         "NFSOnDeviceService": { 
            "StorageLimit": number,
            "StorageUnit": "string"
         },
         "TGWOnDeviceService": { 
            "StorageLimit": number,
            "StorageUnit": "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",
      "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",
         "JobId": "string",
         "JobLogInfo": { 
            "JobCompletionReportURI": "string",
            "JobFailureLogURI": "string",
            "JobSuccessLogURI": "string"
         },
         "JobState": "string",
         "JobType": "string",
         "KmsKeyARN": "string",
         "LongTermPricingId": "string",
         "Notification": { 
            "JobStatesToNotify": [ "string" ],
            "NotifyAll": boolean,
            "SnsTopicARN": "string"
         },
         "OnDeviceServiceConfiguration": { 
            "EKSOnDeviceService": { 
               "EKSAnywhereVersion": "string",
               "KubernetesVersion": "string"
            },
            "NFSOnDeviceService": { 
               "StorageLimit": number,
               "StorageUnit": "string"
            },
            "TGWOnDeviceService": { 
               "StorageLimit": number,
               "StorageUnit": "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",
         "SnowballType": "string",
         "TaxDocuments": { 
            "IND": { 
               "GSTIN": "string"
            }
         }
      }
   ]
}
```

## Eléments de réponse
<a name="API_DescribeJob_ResponseElements"></a>

Si l'action aboutit, le service renvoie une réponse HTTP 200.

Les données suivantes sont renvoyées au format JSON par le service.

 ** [JobMetadata](#API_DescribeJob_ResponseSyntax) **   <a name="Snowball-DescribeJob-response-JobMetadata"></a>
Informations sur une tâche spécifique, y compris les informations d'expédition, le statut de la tâche et d'autres métadonnées importantes.  
Type : objet [JobMetadata](API_JobMetadata.md)

 ** [SubJobMetadata](#API_DescribeJob_ResponseSyntax) **   <a name="Snowball-DescribeJob-response-SubJobMetadata"></a>
Informations sur une tâche spécifique (dans le cas d'une tâche d'exportation), y compris les informations d'expédition, le statut de la tâche et d'autres métadonnées importantes.  
Type : tableau d’objets [JobMetadata](API_JobMetadata.md)

## Erreurs
<a name="API_DescribeJob_Errors"></a>

Pour plus d'informations sur les erreurs communes à toutes les actions, consultez[Erreurs courantes](CommonErrors.md).

 ** InvalidResourceException **   
La ressource spécifiée est introuvable. Vérifiez les informations que vous avez fournies dans votre dernière requête, et réessayez.  
Code d'état HTTP : 400

## Voir aussi
<a name="API_DescribeJob_SeeAlso"></a>

Pour plus d'informations sur l'utilisation de cette API dans l'un des kits SDK AWS spécifiques au langage, consultez les ressources suivantes :
+  [Interface de ligne de commande AWS](https://docs.aws.amazon.com/goto/aws-cli/snowball-2016-06-30/DescribeJob) 
+  [AWS SDK pour .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/snowball-2016-06-30/DescribeJob) 
+  [Kit AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/snowball-2016-06-30/DescribeJob) 
+  [Kit AWS SDK pour Go](https://docs.aws.amazon.com/goto/SdkForGoV1/snowball-2016-06-30/DescribeJob) 
+  [Kit SDK AWS pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/snowball-2016-06-30/DescribeJob) 
+  [AWSSDK pour JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/snowball-2016-06-30/DescribeJob) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/snowball-2016-06-30/DescribeJob) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/snowball-2016-06-30/DescribeJob) 
+  [Kit SDK AWS pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/snowball-2016-06-30/DescribeJob)