ListScanJobSummaries - AWS Backup
Sintaxe da SolicitaçãoParâmetros da Solicitação de URICorpo da SolicitaçãoSintaxe da respostaElementos de respostaErrosConsulte também

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

ListScanJobSummaries

Essa é uma solicitação para um resumo dos trabalhos de verificação criados ou em execução nos últimos 30 dias.

Sintaxe da Solicitação

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 da Solicitação de URI

A solicitação usa os seguintes parâmetros de URI:

AccountId

Retorna a contagem de trabalhos para a conta especificada.

Se a solicitação for enviada de uma conta de membro ou de uma conta que não faz parte de AWS Organizations, os trabalhos na conta do solicitante serão devolvidos.

As contas raiz, de administrador e de administrador delegado podem usar o valor ANY para retornar as contagens de trabalhos de todas as contas da organização.

AGGREGATE_ALL agrega as contagens de trabalhos de todas as contas da organização autenticada e retorna a soma.

Padrão: ^[0-9]{12}$

AggregationPeriod

O período para os resultados retornados.

  • ONE_DAYA contagem diária de trabalhos do primeiro dia anterior.

  • SEVEN_DAYSA contagem diária de trabalhos dos 7 dias anteriores.

  • FOURTEEN_DAYSA contagem diária de trabalhos dos 14 dias anteriores.

Valores válidos: ONE_DAY | SEVEN_DAYS | FOURTEEN_DAYS

MalwareScanner

Retorna somente os trabalhos de verificação do verificador de malware especificado. Atualmente, o único MalwareScanner éGUARDDUTY. Mas o campo também apóiaANY, AGGREGATE_ALL e.

Valores válidos: GUARDDUTY

MaxResults

O número máximo de itens a serem retornados.

O valor é um inteiro. O intervalo de valores aceitos é de 1 a 500.

Faixa válida: valor mínimo de 1. Valor máximo de 1.000.

NextToken

O próximo item após uma lista parcial dos itens retornados. Por exemplo, se for feita uma solicitação para retornar o número MaxResults de itens, o NextToken permitirá que você retorne mais itens em sua lista começando pelo local apontado pelo próximo token.

ResourceType

Retorna a contagem de trabalhos para o tipo de recurso especificado. Use a solicitação GetSupportedResourceTypes a fim de obter as strings para os tipos de recurso compatíveis.

Em seguida, o valor ANY retorna a contagem de todos os tipos de recursos.

AGGREGATE_ALL agrega as contagens de trabalhos para todos os tipos de recurso e retorna a soma.

Padrão: ^[a-zA-Z0-9\-\_\.]{1,50}$

ScanResultStatus

Retorna somente os trabalhos de escaneamento para os resultados de escaneamento especificados.

Valores válidos: NO_THREATS_FOUND | THREATS_FOUND

State

Retorna somente os trabalhos de digitalização para o estado do trabalho de digitalização especificado.

Valores válidos: CREATED | COMPLETED | COMPLETED_WITH_ISSUES | RUNNING | FAILED | CANCELED | AGGREGATE_ALL | ANY

Corpo da Solicitação

Essa solicitação não tem corpo.

Sintaxe da resposta

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 resposta

Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200.

Os dados a seguir são retornados no formato JSON pelo serviço.

AggregationPeriod

O período para os resultados retornados.

  • ONE_DAYA contagem diária de trabalhos do primeiro dia anterior.

  • SEVEN_DAYSA contagem diária de trabalhos dos 7 dias anteriores.

  • FOURTEEN_DAYSA contagem diária de trabalhos dos 14 dias anteriores.

Valores válidos: 'ONE_DAY' | 'SEVEN_DAYS' | 'FOURTEEN_DAYS'

Tipo: string

NextToken

O próximo item após uma lista parcial dos itens retornados. Por exemplo, se for feita uma solicitação para retornar o número MaxResults de itens, o NextToken permitirá que você retorne mais itens em sua lista começando pelo local apontado pelo próximo token.

Tipo: string

ScanJobSummaries

As informações resumidas.

Tipo: matriz de objetos ScanJobSummary

Erros

Para obter informações sobre os erros comuns a todas as ações, consulte Erros comuns.

InvalidParameterValueException

Indica que há algo errado com o valor de um parâmetro. Por exemplo, o valor está fora do intervalo.

Context

Type

Código de status HTTP: 400

ServiceUnavailableException

Houve falha na solicitação devido a um erro temporário do servidor.

Context

Type

Código de status HTTP: 500

Consulte também

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte: