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.

# ListBackupJobs
<a name="API_ListBackupJobs"></a>

Renvoie la liste des tâches de sauvegarde existantes pour un compte authentifié au cours des 30 derniers jours. Envisagez d'utiliser ces [outils de surveillance](https://docs.aws.amazon.com/aws-backup/latest/devguide/monitoring.html) pendant une période plus longue.

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

```
GET /backup-jobs/?accountId=ByAccountId&backupVaultName=ByBackupVaultName&completeAfter=ByCompleteAfter&completeBefore=ByCompleteBefore&createdAfter=ByCreatedAfter&createdBefore=ByCreatedBefore&maxResults=MaxResults&messageCategory=ByMessageCategory&nextToken=NextToken&parentJobId=ByParentJobId&resourceArn=ByResourceArn&resourceType=ByResourceType&state=ByState HTTP/1.1
```

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

La demande utilise les paramètres URI suivants.

 ** [ByAccountId](#API_ListBackupJobs_RequestSyntax) **   <a name="Backup-ListBackupJobs-request-uri-ByAccountId"></a>
L'ID du compte à partir duquel répertorier les tâches. Renvoie uniquement les tâches de sauvegarde associées à l'ID de compte spécifié.  
S'il est utilisé à partir d'un compte de AWS Organizations gestion, le transfert `*` renvoie tous les emplois de l'organisation.  
Modèle : `^[0-9]{12}$` 

 ** [ByBackupVaultName](#API_ListBackupJobs_RequestSyntax) **   <a name="Backup-ListBackupJobs-request-uri-ByBackupVaultName"></a>
Renvoie uniquement les tâches de sauvegarde qui seront stockées dans le coffre-fort de sauvegarde spécifié. Les coffres-forts de sauvegarde sont identifiés par des noms spécifiques pour le compte utilisé pour les créer et la région AWS dans laquelle ils sont créés.  
Modèle : `^[a-zA-Z0-9\-\_]{2,50}$` 

 ** [ByCompleteAfter](#API_ListBackupJobs_RequestSyntax) **   <a name="Backup-ListBackupJobs-request-uri-ByCompleteAfter"></a>
Renvoie uniquement les tâches de sauvegarde terminées après une date exprimée au format Unix et au format UTC (temps universel coordonné).

 ** [ByCompleteBefore](#API_ListBackupJobs_RequestSyntax) **   <a name="Backup-ListBackupJobs-request-uri-ByCompleteBefore"></a>
Renvoie uniquement les tâches de sauvegarde terminées avant une date exprimée au format Unix et au format UTC (temps universel coordonné).

 ** [ByCreatedAfter](#API_ListBackupJobs_RequestSyntax) **   <a name="Backup-ListBackupJobs-request-uri-ByCreatedAfter"></a>
Renvoie uniquement les tâches de sauvegarde créées après la date spécifiée.

 ** [ByCreatedBefore](#API_ListBackupJobs_RequestSyntax) **   <a name="Backup-ListBackupJobs-request-uri-ByCreatedBefore"></a>
Renvoie uniquement les tâches de sauvegarde créées avant la date spécifiée.

 ** [ByMessageCategory](#API_ListBackupJobs_RequestSyntax) **   <a name="Backup-ListBackupJobs-request-uri-ByMessageCategory"></a>
Il s'agit d'un paramètre facultatif qui peut être utilisé pour filtrer les tâches MessageCategory dont la valeur correspond à la valeur que vous avez saisie.  
Les exemples de chaînes peuvent inclure `AccessDenied`, `SUCCESS`, `AGGREGATE_ALL` et `InvalidParameters`.  
Consultez [Surveillance](https://docs.aws.amazon.com/aws-backup/latest/devguide/monitoring.html)   
Le caractère générique () renvoie le nombre de toutes les catégories de messages.  
 `AGGREGATE_ALL` agrège le nombre de tâches pour toutes les catégories de messages et renvoie la somme.

 ** [ByParentJobId](#API_ListBackupJobs_RequestSyntax) **   <a name="Backup-ListBackupJobs-request-uri-ByParentJobId"></a>
Il s'agit d'un filtre permettant de répertorier les tâches enfants (imbriquées) en fonction de l'ID de tâche parent.

 ** [ByResourceArn](#API_ListBackupJobs_RequestSyntax) **   <a name="Backup-ListBackupJobs-request-uri-ByResourceArn"></a>
Renvoie uniquement les tâches de sauvegarde qui correspondent à l'Amazon Resource Name (ARN) des ressources spécifié.

 ** [ByResourceType](#API_ListBackupJobs_RequestSyntax) **   <a name="Backup-ListBackupJobs-request-uri-ByResourceType"></a>
Renvoie uniquement les tâches de sauvegarde pour les ressources spécifiées :  
+  `Aurora` pour Amazon Aurora
+  `CloudFormation`pour AWS CloudFormation 
+  `DocumentDB` pour Amazon DocumentDB (compatible avec MongoDB)
+  `DynamoDB` pour Amazon DynamoDB
+  `EBS` pour Amazon Elastic Block Store
+  `EC2` pour Amazon Elastic Compute Cloud
+  `EFS` pour Amazon Elastic File System
+  `EKS`pour Amazon Elastic Kubernetes Service
+  `FSx`pour Amazon FSx
+  `Neptune` pour Amazon Neptune
+  `RDS` pour Amazon Relational Database Service
+  `Redshift` pour Amazon Redshift
+  `S3`pour Amazon Simple Storage Service (Amazon S3)
+  `SAP HANA on Amazon EC2`pour les bases de données SAP HANA sur les instances Amazon Elastic Compute Cloud
+  `Storage Gateway`pour AWS Storage Gateway 
+  `Timestream` pour Amazon Timestream
+  `VirtualMachine`pour les machines VMware virtuelles
Modèle : `^[a-zA-Z0-9\-\_\.]{1,50}$` 

 ** [ByState](#API_ListBackupJobs_RequestSyntax) **   <a name="Backup-ListBackupJobs-request-uri-ByState"></a>
Renvoie uniquement les tâches de sauvegarde qui sont dans l'état spécifié.  
 `Completed with issues` est un statut présent uniquement dans la console AWS Backup . Pour l’API, ce statut fait référence aux tâches avec un état `COMPLETED` et `MessageCategory` avec une valeur différente de `SUCCESS` ; c’est-à-dire que le statut est terminé mais qu’il est accompagné d’un message de statut.  
Pour obtenir le nombre de tâches pour `Completed with issues`, exécutez deux requêtes GET et soustrayez le deuxième plus petit nombre :  
GET /backup-jobs/?state=COMPLETED  
GET /backup-jobs/?messageCategory=SUCCESS&state=COMPLETED  
Valeurs valides : `CREATED | PENDING | RUNNING | ABORTING | ABORTED | COMPLETED | FAILED | EXPIRED | PARTIAL` 

 ** [MaxResults](#API_ListBackupJobs_RequestSyntax) **   <a name="Backup-ListBackupJobs-request-uri-MaxResults"></a>
Le nombre maximum d'éléments à renvoyer.  
Plage valide : valeur minimum de 1. La valeur maximale est 1 000.

 ** [NextToken](#API_ListBackupJobs_RequestSyntax) **   <a name="Backup-ListBackupJobs-request-uri-NextToken"></a>
L'élément suivant selon une liste partielle des éléments renvoyés. Par exemple, si une demande est faite pour renvoyer `MaxResults` éléments, `NextToken` vous permet de renvoyer d'autres éléments dans votre liste en commençant par l'emplacement indiqué par le jeton suivant.

## Corps de la requête
<a name="API_ListBackupJobs_RequestBody"></a>

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

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

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

{
   "BackupJobs": [ 
      { 
         "AccountId": "string",
         "BackupJobId": "string",
         "BackupOptions": { 
            "string" : "string" 
         },
         "BackupSizeInBytes": number,
         "BackupType": "string",
         "BackupVaultArn": "string",
         "BackupVaultName": "string",
         "BytesTransferred": number,
         "CompletionDate": number,
         "CreatedBy": { 
            "BackupPlanArn": "string",
            "BackupPlanId": "string",
            "BackupPlanName": "string",
            "BackupPlanVersion": "string",
            "BackupRuleCron": "string",
            "BackupRuleId": "string",
            "BackupRuleName": "string",
            "BackupRuleTimezone": "string"
         },
         "CreationDate": number,
         "EncryptionKeyArn": "string",
         "ExpectedCompletionDate": number,
         "IamRoleArn": "string",
         "InitiationDate": number,
         "IsEncrypted": boolean,
         "IsParent": boolean,
         "MessageCategory": "string",
         "ParentJobId": "string",
         "PercentDone": "string",
         "RecoveryPointArn": "string",
         "RecoveryPointLifecycle": { 
            "DeleteAfterDays": number,
            "DeleteAfterEvent": "string",
            "MoveToColdStorageAfterDays": number,
            "OptInToArchiveForSupportedResources": boolean
         },
         "ResourceArn": "string",
         "ResourceName": "string",
         "ResourceType": "string",
         "StartBy": number,
         "State": "string",
         "StatusMessage": "string",
         "VaultLockState": "string",
         "VaultType": "string"
      }
   ],
   "NextToken": "string"
}
```

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

 ** [BackupJobs](#API_ListBackupJobs_ResponseSyntax) **   <a name="Backup-ListBackupJobs-response-BackupJobs"></a>
Tableau de structures contenant des métadonnées relatives à vos tâches de sauvegarde renvoyées au format JSON.  
Type : tableau d’objets [BackupJob](API_BackupJob.md)

 ** [NextToken](#API_ListBackupJobs_ResponseSyntax) **   <a name="Backup-ListBackupJobs-response-NextToken"></a>
L'élément suivant selon une liste partielle des éléments renvoyés. Par exemple, si une demande est faite pour renvoyer `MaxResults` éléments, `NextToken` vous permet de renvoyer d'autres éléments dans votre liste en commençant par l'emplacement indiqué par le jeton suivant.  
Type : Chaîne

## Erreurs
<a name="API_ListBackupJobs_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

 ** 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_ListBackupJobs_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/ListBackupJobs) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/ListBackupJobs) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ListBackupJobs) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/ListBackupJobs) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ListBackupJobs) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/ListBackupJobs) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/ListBackupJobs) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/ListBackupJobs) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/ListBackupJobs) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ListBackupJobs)