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.
ListBackupJobSummaries
Il s’agit d’une demande pour un résumé des tâches de sauvegarde créées ou en cours d’exécution au cours des 30 derniers jours. Vous pouvez inclure les paramètres AccountID, State,, ResourceType, MessageCategory AggregationPeriod MaxResults, NextToken ou pour filtrer les résultats.
Cette demande renvoie un résumé contenant la région, le compte, l'état ResourceType, MessageCategory, StartTime, EndTime, et le nombre de tâches incluses.
Syntaxe de la requête
GET /audit/backup-job-summaries?AccountId=AccountId&AggregationPeriod=AggregationPeriod&MaxResults=MaxResults&MessageCategory=MessageCategory&NextToken=NextToken&ResourceType=ResourceType&State=State HTTP/1.1
URIParamètres de demande
La demande utilise les URI paramètres suivants.
- AccountId
-
Renvoie le nombre de tâches pour le compte spécifié.
Si la demande est envoyée depuis un compte membre ou un compte ne faisant pas partie d' AWS Organizations, les offres d'emploi enregistrées dans le compte du demandeur seront renvoyées.
Les comptes root, administrateur et administrateur délégué peuvent utiliser cette valeur ANY pour renvoyer le nombre de tâches de tous les comptes de l'organisation.
AGGREGATE_ALLagrège le nombre de tâches provenant de tous les comptes de l’organisation authentifiée, puis renvoie la somme.Modèle :
^[0-9]{12}$ - AggregationPeriod
-
Période pendant laquelle les résultats sont renvoyés.
-
ONE_DAY- Le nombre de tâches quotidiennes des 14 jours précédents. -
SEVEN_DAYS- Le nombre de tâches agrégé pour les 7 jours précédents. -
FOURTEEN_DAYS- Le nombre de tâches agrégé pour les 14 jours précédents.
Valeurs valides :
ONE_DAY | SEVEN_DAYS | FOURTEEN_DAYS -
- MaxResults
-
Le nombre maximum d'éléments à renvoyer.
La valeur est un nombre entier. La plage de valeurs acceptées est comprise entre 1 et 500.
Plage valide : valeur minimum de 1. La valeur maximale est 1 000.
- MessageCategory
-
Ce paramètre renvoie le nombre de tâches pour la catégorie de message spécifiée.
Les exemples de chaînes acceptées incluent
AccessDenied,SuccessetInvalidParameters. Voir Surveillance pour une liste des MessageCategory chaînes acceptées.La valeur ANY renvoie le nombre de toutes les catégories de messages.
AGGREGATE_ALLagrège le nombre de tâches pour toutes les catégories de messages et renvoie la somme. - NextToken
-
L'élément suivant selon une liste partielle des ressources renvoyées. Par exemple, si une demande est faite pour renvoyer
MaxResultsressources,NextTokenvous permet de renvoyer d'autres éléments dans votre liste en commençant par l'emplacement indiqué par le jeton suivant. - ResourceType
-
Renvoie le nombre de tâches pour le type de ressource spécifié. Utilisez la demande
GetSupportedResourceTypespour obtenir des chaînes pour les types de ressources pris en charge.La valeur ANY renvoie le nombre de tous les types de ressources.
AGGREGATE_ALLagrège le nombre de tâches pour tous les types de ressources et renvoie la somme.Type de AWS ressource à sauvegarder ; par exemple, un volume Amazon Elastic Block Store (AmazonEBS) ou une base de données Amazon Relational Database Service (RDSAmazon).
Modèle :
^[a-zA-Z0-9\-\_\.]{1,50}$ - State
-
Ce paramètre renvoie le nombre de tâches pour les tâches dans l’état spécifié.
La valeur ANY renvoie le nombre de tous les états.
AGGREGATE_ALLagrège le nombre de tâches pour tous les états et renvoie la somme.Completed with issuesest un statut présent uniquement dans la console AWS Backup . En API effet, ce statut fait référence aux tâches dont l'étatCOMPLETEDet la valeur sont différentes deSUCCESS; c'est-à-dire que le statut est terminé mais qu'il est accompagné d'un message d'état.MessageCategoryPour obtenir le nombre de tâches pourCompleted with issues, exécutez deux GET requêtes et soustrayez le second, le plus petit nombre :GET/audit/ ? backup-job-summaries AggregationPeriod= FOURTEEN _ DAYS &État= COMPLETED
GET/audit/ ? backup-job-summaries AggregationPeriod= FOURTEEN _ DAYS & = MessageCategory SUCCESS &État= COMPLETED
Valeurs valides :
CREATED | PENDING | RUNNING | ABORTING | ABORTED | COMPLETED | FAILED | EXPIRED | PARTIAL | AGGREGATE_ALL | ANY
Corps de la requête
La demande n’a pas de corps de requête.
Syntaxe de la réponse
HTTP/1.1 200
Content-type: application/json
{
"AggregationPeriod": "string",
"BackupJobSummaries": [
{
"AccountId": "string",
"Count": number,
"EndTime": number,
"MessageCategory": "string",
"Region": "string",
"ResourceType": "string",
"StartTime": number,
"State": "string"
}
],
"NextToken": "string"
}Eléments de réponse
Si l'action aboutit, le service renvoie une réponse HTTP 200.
Les données suivantes sont renvoyées sous JSON forme formatée par le service.
- AggregationPeriod
-
Période pendant laquelle les résultats sont renvoyés.
-
ONE_DAY- Le nombre de tâches quotidiennes des 14 jours précédents. -
SEVEN_DAYS- Le nombre de tâches agrégé pour les 7 jours précédents. -
FOURTEEN_DAYS- Le nombre de tâches agrégé pour les 14 jours précédents.
Type : String
-
- BackupJobSummaries
-
Les informations récapitulatives.
Type : tableau d’objets BackupJobSummary
- NextToken
-
L'élément suivant selon une liste partielle des ressources renvoyées. Par exemple, si une demande est faite pour renvoyer
MaxResultsressources,NextTokenvous permet de renvoyer d'autres éléments dans votre liste en commençant par l'emplacement indiqué par le jeton suivant.Type : String
Erreurs
Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez Erreurs courantes.
- InvalidParameterValueException
-
Indique une erreur avec la valeur d'un paramètre. Par exemple, la valeur est hors de portée.
HTTPCode de statut : 400
- ServiceUnavailableException
-
La demande a échoué en raison d'une défaillance temporaire du serveur.
HTTPCode de statut : 500
consultez aussi
Pour plus d'informations sur son utilisation API dans l'une des langues spécifiques AWS SDKs, consultez ce qui suit :
