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.

# DescribeScanJob
<a name="API_DescribeScanJob"></a>

Renvoie les détails de la tâche de numérisation pour l' ScanJobID spécifié.

## Syntaxe de la demande
<a name="API_DescribeScanJob_RequestSyntax"></a>

```
GET /scan/jobs/ScanJobId HTTP/1.1
```

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

La demande utilise les paramètres URI suivants.

 ** [ScanJobId](#API_DescribeScanJob_RequestSyntax) **   <a name="Backup-DescribeScanJob-request-uri-ScanJobId"></a>
Identifie de manière unique une demande AWS Backup d'analyse d'une ressource.  
Obligatoire : oui

## Corps de la demande
<a name="API_DescribeScanJob_RequestBody"></a>

La demande n’a pas de corps de requête.

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

```
HTTP/1.1 200
Content-type: application/json

{
   "AccountId": "string",
   "BackupVaultArn": "string",
   "BackupVaultName": "string",
   "CompletionDate": number,
   "CreatedBy": { 
      "BackupPlanArn": "string",
      "BackupPlanId": "string",
      "BackupPlanVersion": "string",
      "BackupRuleId": "string"
   },
   "CreationDate": number,
   "IamRoleArn": "string",
   "MalwareScanner": "string",
   "RecoveryPointArn": "string",
   "ResourceArn": "string",
   "ResourceName": "string",
   "ResourceType": "string",
   "ScanBaseRecoveryPointArn": "string",
   "ScanId": "string",
   "ScanJobId": "string",
   "ScanMode": "string",
   "ScannerRoleArn": "string",
   "ScanResult": { 
      "ScanResultStatus": "string"
   },
   "State": "string",
   "StatusMessage": "string"
}
```

## Eléments de réponse
<a name="API_DescribeScanJob_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.

 ** [AccountId](#API_DescribeScanJob_ResponseSyntax) **   <a name="Backup-DescribeScanJob-response-AccountId"></a>
Renvoie l'ID du compte auquel appartient la tâche de numérisation.  
Modèle : `^[0-9]{12}$`   
Type : Chaîne

 ** [BackupVaultArn](#API_DescribeScanJob_ResponseSyntax) **   <a name="Backup-DescribeScanJob-response-BackupVaultArn"></a>
Un Amazon Resource Name (ARN) qui identifie de manière unique un coffre-fort de sauvegarde ; par exemple, `arn:aws:backup:us-east-1:123456789012:backup-vault:aBackupVault`   
Type : Chaîne

 ** [BackupVaultName](#API_DescribeScanJob_ResponseSyntax) **   <a name="Backup-DescribeScanJob-response-BackupVaultName"></a>
Le nom d'un conteneur logique où les sauvegardes sont stockées. Les coffres-forts de sauvegarde sont identifiés par des noms propres au compte utilisé pour les créer et à la AWS région dans laquelle ils ont été créés.  
Modèle : `^[a-zA-Z0-9\-\_\.]{2,50}$`   
Type : Chaîne

 ** [CompletionDate](#API_DescribeScanJob_ResponseSyntax) **   <a name="Backup-DescribeScanJob-response-CompletionDate"></a>
Date et heure de fin de création d'un index de sauvegarde, au format Unix et en temps universel coordonné (UTC). La valeur de `CompletionDate` est précise en millisecondes. Par exemple, la valeur 1516925490,087 représente le vendredi 26 janvier 2018 à 00 h 11 m 30,087 s.  
Type : Timestamp

 ** [CreatedBy](#API_DescribeScanJob_ResponseSyntax) **   <a name="Backup-DescribeScanJob-response-CreatedBy"></a>
Contient des informations d'identification relatives à la création d'une tâche d'analyse, notamment le plan de sauvegarde et la règle à l'origine de l'analyse.  
Type : objet [ScanJobCreator](API_ScanJobCreator.md)

 ** [CreationDate](#API_DescribeScanJob_ResponseSyntax) **   <a name="Backup-DescribeScanJob-response-CreationDate"></a>
Date et heure de fin de création d'un index de sauvegarde, au format Unix et en temps universel coordonné (UTC). La valeur de `CreationDate` est précise en millisecondes. Par exemple, la valeur 1516925490,087 représente le vendredi 26 janvier 2018 à 00 h 11 m 30,087 s.  
Type : Timestamp

 ** [IamRoleArn](#API_DescribeScanJob_ResponseSyntax) **   <a name="Backup-DescribeScanJob-response-IamRoleArn"></a>
Amazon Resource Name (ARN) qui identifie de façon unique un coffre-fort de sauvegarde ; par exemple, `arn:aws:iam::123456789012:role/S3Access`.  
Type : Chaîne

 ** [MalwareScanner](#API_DescribeScanJob_ResponseSyntax) **   <a name="Backup-DescribeScanJob-response-MalwareScanner"></a>
Moteur d'analyse utilisé pour la tâche de numérisation correspondante. Actuellement, seul `GUARDUTY` est pris en charge.  
Type : Chaîne  
Valeurs valides : `GUARDDUTY` 

 ** [RecoveryPointArn](#API_DescribeScanJob_ResponseSyntax) **   <a name="Backup-DescribeScanJob-response-RecoveryPointArn"></a>
Un ARN qui identifie de manière unique le point de récupération cible à scanner. ; par exemple,`arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45`.  
Type : Chaîne

 ** [ResourceArn](#API_DescribeScanJob_ResponseSyntax) **   <a name="Backup-DescribeScanJob-response-ResourceArn"></a>
Un ARN qui identifie de manière unique la ressource source de l'ARN du point de récupération correspondant.  
Type : Chaîne

 ** [ResourceName](#API_DescribeScanJob_ResponseSyntax) **   <a name="Backup-DescribeScanJob-response-ResourceName"></a>
Nom non unique de la ressource appartenant à la sauvegarde spécifiée.  
Type : Chaîne

 ** [ResourceType](#API_DescribeScanJob_ResponseSyntax) **   <a name="Backup-DescribeScanJob-response-ResourceType"></a>
Type de AWS ressource à sauvegarder ; par exemple, un volume Amazon Elastic Block Store (Amazon EBS).  
Modèle : `^[a-zA-Z0-9\-\_\.]{1,50}$`   
Type : Chaîne  
Valeurs valides : `EBS | EC2 | S3` 

 ** [ScanBaseRecoveryPointArn](#API_DescribeScanJob_ResponseSyntax) **   <a name="Backup-DescribeScanJob-response-ScanBaseRecoveryPointArn"></a>
Un ARN qui identifie de manière unique le point de récupération de base à scanner. Ce champ ne sera rempli que lorsqu'une tâche de numérisation incrémentielle aura eu lieu.  
Type : Chaîne

 ** [ScanId](#API_DescribeScanJob_ResponseSyntax) **   <a name="Backup-DescribeScanJob-response-ScanId"></a>
L'ID de scan généré par Amazon GuardDuty pour la demande d'ID de scan Job correspondante auprès de AWS Backup.  
Type : Chaîne

 ** [ScanJobId](#API_DescribeScanJob_ResponseSyntax) **   <a name="Backup-DescribeScanJob-response-ScanJobId"></a>
L'ID de la tâche de numérisation qui a identifié de manière unique la demande adressée à AWS Backup.  
Type : Chaîne

 ** [ScanMode](#API_DescribeScanJob_ResponseSyntax) **   <a name="Backup-DescribeScanJob-response-ScanMode"></a>
Spécifie le type de numérisation utilisé pour la tâche de numérisation.  
Type : Chaîne  
Valeurs valides : `FULL_SCAN | INCREMENTAL_SCAN` 

 ** [ScannerRoleArn](#API_DescribeScanJob_ResponseSyntax) **   <a name="Backup-DescribeScanJob-response-ScannerRoleArn"></a>
Spécifie l'ARN du rôle IAM du scanner utilisé pour la tâche de numérisation.  
Type : Chaîne

 ** [ScanResult](#API_DescribeScanJob_ResponseSyntax) **   <a name="Backup-DescribeScanJob-response-ScanResult"></a>
 Contient le `ScanResultsStatus` pour le travail de numérisation et les retours `THREATS_FOUND` ou `NO_THREATS_FOUND` pour les travaux terminés.  
Type : objet [ScanResultInfo](API_ScanResultInfo.md)

 ** [State](#API_DescribeScanJob_ResponseSyntax) **   <a name="Backup-DescribeScanJob-response-State"></a>
État actuel d'une tâche de numérisation.  
Type : Chaîne  
Valeurs valides : `CANCELED | COMPLETED | COMPLETED_WITH_ISSUES | CREATED | FAILED | RUNNING` 

 ** [StatusMessage](#API_DescribeScanJob_ResponseSyntax) **   <a name="Backup-DescribeScanJob-response-StatusMessage"></a>
Message détaillé expliquant le statut de la tâche de sauvegarde d'une ressource.  
Type : Chaîne

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

Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Types d'erreurs courants](CommonErrors.md).

 ** InvalidParameterValueException **   
Indique une erreur avec la valeur d'un paramètre. Par exemple, la valeur est hors de portée.    
 ** Context **   
  
 ** Type **   

Code d’état HTTP : 400

 ** MissingParameterValueException **   
Indique qu'un paramètre obligatoire est manquant.    
 ** Context **   
  
 ** Type **   

Code d’état HTTP : 400

 ** ResourceNotFoundException **   
Aucune ressource requise pour l'action n'existe.    
 ** Context **   
  
 ** Type **   

Code d’état HTTP : 400

 ** ServiceUnavailableException **   
La demande a échoué en raison d'une défaillance temporaire du serveur.    
 ** Context **   
  
 ** Type **   

Code d’état HTTP : 500

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

Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :
+  [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/DescribeScanJob) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/DescribeScanJob) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/DescribeScanJob) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/DescribeScanJob) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/DescribeScanJob) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/DescribeScanJob) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/DescribeScanJob) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/DescribeScanJob) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/DescribeScanJob) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/DescribeScanJob)