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.
ListScanJobSummaries
Se trata de una solicitud de resumen de los trabajos de digitalización creados o en ejecución en los últimos 30 días.
Sintaxis de la solicitud
GET /audit/scan-job-summaries?AccountId=AccountId&AggregationPeriod=AggregationPeriod&MalwareScanner=MalwareScanner&MaxResults=MaxResults&NextToken=NextToken&ResourceType=ResourceType&ScanResultStatus=ScanResultStatus&State=State HTTP/1.1
Parámetros de solicitud del URI
La solicitud utiliza los siguientes parámetros URI.
- AccountId
-
Devuelve el recuento de trabajos de la cuenta especificada.
Si la solicitud se envía desde una cuenta de miembro o desde 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
ANYpara 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_DAYEl recuento diario de trabajos del día anterior. -
SEVEN_DAYSEl recuento diario de trabajos de los 7 días anteriores. -
FOURTEEN_DAYSEl recuento diario de trabajos de los 14 días anteriores.
Valores válidos:
ONE_DAY | SEVEN_DAYS | FOURTEEN_DAYS -
- MalwareScanner
-
Devuelve solo los trabajos de escaneo del escáner de malware especificado. Actualmente, el único MalwareScanner es
GUARDDUTY. Pero el campo también apoyaANY, yAGGREGATE_ALL.Valores válidos:
GUARDDUTY - 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.
- NextToken
-
El siguiente elemento que sigue a una lista parcial de elementos devueltos. Por ejemplo, si se solicita que se devuelva el número de elementos
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
ANYdevuelve el recuento de todos los tipos de recursos.AGGREGATE_ALLsuma los recuentos de trabajos de todos los tipos de recursos y devuelve la suma.Patrón:
^[a-zA-Z0-9\-\_\.]{1,50}$ - ScanResultStatus
-
Devuelve solo los trabajos de escaneo para los resultados de escaneo especificados.
Valores válidos:
NO_THREATS_FOUND | THREATS_FOUND - State
-
Devuelve solo los trabajos de escaneo para el estado del trabajo de escaneo especificado.
Valores válidos:
CREATED | COMPLETED | COMPLETED_WITH_ISSUES | RUNNING | FAILED | CANCELED | 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",
"NextToken": "string",
"ScanJobSummaries": [
{
"AccountId": "string",
"Count": number,
"EndTime": number,
"MalwareScanner": "string",
"Region": "string",
"ResourceType": "string",
"ScanResultStatus": "string",
"StartTime": number,
"State": "string"
}
]
}Elementos de respuesta
Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.
El servicio devuelve los datos siguientes en formato JSON.
- AggregationPeriod
-
El período de los resultados devueltos.
-
ONE_DAYEl recuento de trabajos diarios del día anterior. -
SEVEN_DAYSEl recuento diario de trabajos de los 7 días anteriores. -
FOURTEEN_DAYSEl recuento diario de trabajos de los 14 días anteriores.
Valores válidos:
'ONE_DAY'|'SEVEN_DAYS'|'FOURTEEN_DAYS'Tipo: cadena
-
- NextToken
-
El siguiente elemento que sigue a una lista parcial de elementos devueltos. Por ejemplo, si se solicita que se devuelva el número de elementos
MaxResults,NextTokenpermite devolver más elementos de la lista empezando por la ubicación indicada por el siguiente token.Tipo: cadena
- ScanJobSummaries
-
La información del resumen.
Tipo: matriz de objetos ScanJobSummary
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.
- Context
- Type
Código de estado HTTP: 400
- ServiceUnavailableException
-
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.
- Context
- Type
Código de estado HTTP: 500
Véase también
Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
