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.

# GetSearchJob
<a name="API_BKS_GetSearchJob"></a>

Cette opération permet de récupérer les métadonnées d'une tâche de recherche, y compris sa progression.

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

```
GET /search-jobs/SearchJobIdentifier HTTP/1.1
```

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

La demande utilise les paramètres URI suivants.

 ** [SearchJobIdentifier](#API_BKS_GetSearchJob_RequestSyntax) **   <a name="Backup-BKS_GetSearchJob-request-uri-SearchJobIdentifier"></a>
Chaîne unique obligatoire qui spécifie la tâche de recherche.  
Obligatoire : oui

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

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

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

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

{
   "CompletionTime": number,
   "CreationTime": number,
   "CurrentSearchProgress": { 
      "ItemsMatchedCount": number,
      "ItemsScannedCount": number,
      "RecoveryPointsScannedCount": number
   },
   "EncryptionKeyArn": "string",
   "ItemFilters": { 
      "EBSItemFilters": [ 
         { 
            "CreationTimes": [ 
               { 
                  "Operator": "string",
                  "Value": number
               }
            ],
            "FilePaths": [ 
               { 
                  "Operator": "string",
                  "Value": "string"
               }
            ],
            "LastModificationTimes": [ 
               { 
                  "Operator": "string",
                  "Value": number
               }
            ],
            "Sizes": [ 
               { 
                  "Operator": "string",
                  "Value": number
               }
            ]
         }
      ],
      "S3ItemFilters": [ 
         { 
            "CreationTimes": [ 
               { 
                  "Operator": "string",
                  "Value": number
               }
            ],
            "ETags": [ 
               { 
                  "Operator": "string",
                  "Value": "string"
               }
            ],
            "ObjectKeys": [ 
               { 
                  "Operator": "string",
                  "Value": "string"
               }
            ],
            "Sizes": [ 
               { 
                  "Operator": "string",
                  "Value": number
               }
            ],
            "VersionIds": [ 
               { 
                  "Operator": "string",
                  "Value": "string"
               }
            ]
         }
      ]
   },
   "Name": "string",
   "SearchJobArn": "string",
   "SearchJobIdentifier": "string",
   "SearchScope": { 
      "BackupResourceArns": [ "string" ],
      "BackupResourceCreationTime": { 
         "CreatedAfter": number,
         "CreatedBefore": number
      },
      "BackupResourceTags": { 
         "string" : "string" 
      },
      "BackupResourceTypes": [ "string" ],
      "SourceResourceArns": [ "string" ]
   },
   "SearchScopeSummary": { 
      "TotalItemsToScanCount": number,
      "TotalRecoveryPointsToScanCount": number
   },
   "Status": "string",
   "StatusMessage": "string"
}
```

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

 ** [CompletionTime](#API_BKS_GetSearchJob_ResponseSyntax) **   <a name="Backup-BKS_GetSearchJob-response-CompletionTime"></a>
Date et heure de fin d'une tâche de recherche, au format Unix et en temps universel coordonné (UTC). La valeur de `CompletionTime` 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

 ** [CreationTime](#API_BKS_GetSearchJob_ResponseSyntax) **   <a name="Backup-BKS_GetSearchJob-response-CreationTime"></a>
Date et heure de création d'une tâche de recherche, au format Unix et en temps universel coordonné (UTC). La valeur de `CompletionTime` 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

 ** [CurrentSearchProgress](#API_BKS_GetSearchJob_ResponseSyntax) **   <a name="Backup-BKS_GetSearchJob-response-CurrentSearchProgress"></a>
Renvoie des nombres représentant BackupsScannedCount ItemsScanned, et ItemsMatched.  
Type : objet [CurrentSearchProgress](API_BKS_CurrentSearchProgress.md)

 ** [EncryptionKeyArn](#API_BKS_GetSearchJob_ResponseSyntax) **   <a name="Backup-BKS_GetSearchJob-response-EncryptionKeyArn"></a>
La clé de chiffrement pour la tâche de recherche spécifiée.  
Exemple: `arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab`.  
Type : Chaîne

 ** [ItemFilters](#API_BKS_GetSearchJob_ResponseSyntax) **   <a name="Backup-BKS_GetSearchJob-response-ItemFilters"></a>
Les filtres d'éléments représentent toutes les propriétés des éléments d'entrée spécifiées lors de la création de la recherche.  
Type : objet [ItemFilters](API_BKS_ItemFilters.md)

 ** [Name](#API_BKS_GetSearchJob_ResponseSyntax) **   <a name="Backup-BKS_GetSearchJob-response-Name"></a>
Nom renvoyé de la tâche de recherche spécifiée.  
Type : Chaîne

 ** [SearchJobArn](#API_BKS_GetSearchJob_ResponseSyntax) **   <a name="Backup-BKS_GetSearchJob-response-SearchJobArn"></a>
Chaîne unique qui identifie le nom de ressource Amazon (ARN) de la tâche de recherche spécifiée.  
Type : Chaîne

 ** [SearchJobIdentifier](#API_BKS_GetSearchJob_ResponseSyntax) **   <a name="Backup-BKS_GetSearchJob-response-SearchJobIdentifier"></a>
Chaîne unique qui identifie la tâche de recherche spécifiée.  
Type : Chaîne

 ** [SearchScope](#API_BKS_GetSearchJob_ResponseSyntax) **   <a name="Backup-BKS_GetSearchJob-response-SearchScope"></a>
L'étendue de la recherche comprend toutes les propriétés de sauvegarde saisies dans une recherche.  
Type : objet [SearchScope](API_BKS_SearchScope.md)

 ** [SearchScopeSummary](#API_BKS_GetSearchJob_ResponseSyntax) **   <a name="Backup-BKS_GetSearchJob-response-SearchScopeSummary"></a>
Résumé renvoyé de l'étendue de la tâche de recherche spécifiée, y compris :   
+ TotalBackupsToScanCount, le nombre de points de récupération renvoyés par la recherche.
+ TotalItemsToScanCount, le nombre d'éléments renvoyés par la recherche.
Type : objet [SearchScopeSummary](API_BKS_SearchScopeSummary.md)

 ** [Status](#API_BKS_GetSearchJob_ResponseSyntax) **   <a name="Backup-BKS_GetSearchJob-response-Status"></a>
État actuel de la tâche de recherche spécifiée.  
Une tâche de recherche peut avoir l'un des statuts suivants : `RUNNING` ; `COMPLETED` ; `STOPPED` ; `FAILED` `TIMED_OUT` ; ou`EXPIRED`.  
Type : Chaîne  
Valeurs valides : `RUNNING | COMPLETED | STOPPING | STOPPED | FAILED` 

 ** [StatusMessage](#API_BKS_GetSearchJob_ResponseSyntax) **   <a name="Backup-BKS_GetSearchJob-response-StatusMessage"></a>
Un message d'état sera renvoyé pour une tâche de recherche avec un statut de `ERRORED` ou pour un statut de `COMPLETED` tâches présentant des problèmes.  
Par exemple, un message peut indiquer qu'une recherche contient des points de récupération qui ne peuvent pas être analysés en raison d'un problème d'autorisation.  
Type : Chaîne

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

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

 ** AccessDeniedException **   
Vous ne disposez pas d’un accès suffisant pour effectuer cette action.    
 ** message **   
L'utilisateur ne dispose pas d'un accès suffisant pour effectuer cette action.
Code d’état HTTP : 403

 ** InternalServerException **   
Une erreur interne du serveur s’est produite. Réessayez votre demande.    
 ** message **   
Erreur inattendue lors du traitement de la demande.  
 ** retryAfterSeconds **   
Réessayez l'appel au bout de quelques secondes.
Code d’état HTTP : 500

 ** ResourceNotFoundException **   
La ressource n'a pas été trouvée pour cette demande.  
Vérifiez que les informations sur la ressource, telles que l'ARN ou le type, sont correctes et existent, puis réessayez la demande.    
 ** message **   
La requête fait référence à une ressource qui n'existe pas.  
 ** resourceId **   
Identifiant hypothétique de la ressource affectée.  
 ** resourceType **   
Type hypothétique de la ressource affectée.
Code d’état HTTP :404

 ** ThrottlingException **   
La demande a été refusée suite à une limitation des demandes.    
 ** message **   
La demande n'a pas abouti en raison d'une limitation des demandes.  
 ** quotaCode **   
Il s'agit du code propre au service d'origine avec le quota.  
 ** retryAfterSeconds **   
Réessayez l'appel au bout de quelques secondes.  
 ** serviceCode **   
Il s'agit du code propre au service d'origine.
Code d’état HTTP : 429

 ** ValidationException **   
L'entrée ne satisfait pas les contraintes spécifiées par un service.    
 ** message **   
L'entrée ne répond pas aux contraintes spécifiées par un service Amazon.
Code d’état HTTP : 400

## Voir aussi
<a name="API_BKS_GetSearchJob_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/backupsearch-2018-05-10/GetSearchJob) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backupsearch-2018-05-10/GetSearchJob) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backupsearch-2018-05-10/GetSearchJob) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backupsearch-2018-05-10/GetSearchJob) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backupsearch-2018-05-10/GetSearchJob) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backupsearch-2018-05-10/GetSearchJob) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backupsearch-2018-05-10/GetSearchJob) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backupsearch-2018-05-10/GetSearchJob) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/backupsearch-2018-05-10/GetSearchJob) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backupsearch-2018-05-10/GetSearchJob)