Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
ListBackupJobSummaries
Es una solicitud de resumen de trabajos de copia de seguridad creados o en ejecución en los 30 últimos días. Puede incluir los parámetros AccountID, State,,, ResourceType MessageCategory AggregationPeriod MaxResults, NextToken o para filtrar los resultados.
Esta solicitud devuelve un resumen que contiene la región, la cuenta, el estado, ResourceType, MessageCategory StartTime EndTime, y el recuento de los trabajos incluidos.
Sintaxis de la solicitud
GET /audit/backup-job-summaries?AccountId=AccountId&AggregationPeriod=AggregationPeriod&MaxResults=MaxResults&MessageCategory=MessageCategory&NextToken=NextToken&ResourceType=ResourceType&State=State HTTP/1.1
URIParámetros de la solicitud
La solicitud utiliza los siguientes URI parámetros.
- AccountId
-
Devuelve el recuento de trabajos de la cuenta especificada.
Si la solicitud se envía desde una cuenta de miembro o una cuenta que no forma parte de AWS Organizations, se devolverán los trabajos de la cuenta del solicitante.
Las cuentas raíz, de administrador y de administrador delegado pueden usar el valor ANY para devolver los recuentos de puestos de trabajo de todas las cuentas de la organización.
AGGREGATE_ALLsuma los recuentos de trabajos de todas las cuentas de la organización autenticada y, a continuación, devuelve la suma.Patrón:
^[0-9]{12}$ - AggregationPeriod
-
El período de los resultados devueltos.
-
ONE_DAY- El recuento diario de trabajos de los 14 días anteriores. -
SEVEN_DAYS- El recuento total de trabajos de los 7 días anteriores. -
FOURTEEN_DAYS- El recuento total de trabajos de los 14 días anteriores.
Valores válidos:
ONE_DAY | SEVEN_DAYS | FOURTEEN_DAYS -
- MaxResults
-
Número máximo de elementos que se van a devolver.
El valor es un entero. El rango de valores aceptados está entre 1 y 500.
Rango válido: valor mínimo de 1. Valor máximo de 1000.
- MessageCategory
-
Este parámetro devuelve el recuento de trabajos de la categoría de mensajes especificada.
Ejemplos de cadenas aceptadas son
AccessDenied,SuccessyInvalidParameters. Consulte Supervisión para ver una lista de MessageCategory las cadenas aceptadas.El valor ANY devuelve el recuento de todas las categorías de mensajes.
AGGREGATE_ALLsuma los recuentos de trabajos de todas las categorías de mensajes y devuelve la suma. - NextToken
-
El siguiente elemento que sigue a una lista parcial de recursos devueltos. Por ejemplo, si se solicita que se devuelva el número de recursos
MaxResults,NextTokenpermite devolver más elementos de la lista empezando por la ubicación indicada por el siguiente token. - ResourceType
-
Devuelve el recuento de trabajos del tipo de recurso especificado. Utilice
GetSupportedResourceTypesde solicitud para obtener cadenas para los tipos de recursos compatibles.El valor ANY devuelve el recuento de todos los tipos de recursos.
AGGREGATE_ALLsuma los recuentos de trabajos de todos los tipos de recursos y devuelve la suma.El tipo de AWS recurso del que se va a hacer una copia de seguridad; por ejemplo, un volumen de Amazon Elastic Block Store (AmazonEBS) o una base de datos de Amazon Relational Database Service (RDSAmazon).
Patrón:
^[a-zA-Z0-9\-\_\.]{1,50}$ - State
-
Este parámetro devuelve el recuento de los trabajos con el estado especificado.
El valor ANY devuelve el recuento de todos los estados.
AGGREGATE_ALLsuma los recuentos de trabajos de todos los tipos de estados y devuelve la suma.Completed with issueses un estado que solo se encuentra en la consola de AWS Backup . PuesAPI, este estado se refiere a los trabajos con un estadoCOMPLETEDy unMessageCategoryvalor distintos deSUCCESS; es decir, el estado está completado pero viene acompañado de un mensaje de estado. Para obtener el recuento de trabajosCompleted with issues, ejecute dos GET solicitudes y reste el segundo número, más pequeño:GET/auditar/? backup-job-summaries AggregationPeriod= _ &Estado= FOURTEEN DAYS COMPLETED
GET/audit/? backup-job-summaries AggregationPeriod= FOURTEEN _ & = DAYS &Estado= MessageCategory SUCCESS COMPLETED
Valores válidos:
CREATED | PENDING | RUNNING | ABORTING | ABORTED | COMPLETED | FAILED | EXPIRED | PARTIAL | AGGREGATE_ALL | ANY
Cuerpo de la solicitud
La solicitud no tiene un cuerpo de la solicitud.
Sintaxis de la respuesta
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"
}Elementos de respuesta
Si la acción se realiza correctamente, el servicio devuelve una respuesta de HTTP 200.
El servicio devuelve los siguientes datos en JSON formato.
- AggregationPeriod
-
El período de los resultados devueltos.
-
ONE_DAY- El recuento diario de trabajos de los 14 días anteriores. -
SEVEN_DAYS- El recuento total de trabajos de los 7 días anteriores. -
FOURTEEN_DAYS- El recuento total de trabajos de los 14 días anteriores.
Tipo: cadena
-
- BackupJobSummaries
-
La información resumida.
Tipo: matriz de objetos BackupJobSummary
- NextToken
-
El siguiente elemento que sigue a una lista parcial de recursos devueltos. Por ejemplo, si se solicita que se devuelva el número de recursos
MaxResults,NextTokenpermite devolver más elementos de la lista empezando por la ubicación indicada por el siguiente token.Tipo: cadena
Errores
Para obtener información acerca de los errores comunes a todas las acciones, consulte Errores comunes.
- InvalidParameterValueException
-
Indica que hay algún problema con el valor de un parámetro. Por ejemplo, el valor está fuera del rango.
HTTPCódigo de estado: 400
- ServiceUnavailableException
-
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.
HTTPCódigo de estado: 500
Véase también
Para obtener más información sobre cómo usarlo API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
