ListScanJobs - AWS Backup
Sintassi della richiestaParametri della richiesta URICorpo della richiestaSintassi della rispostaElementi di rispostaErroriVedi anche

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

ListScanJobs

Restituisce un elenco di processi di scansione esistenti per un account autenticato negli ultimi 30 giorni.

Sintassi della richiesta

GET /scan/jobs?ByAccountId=ByAccountId&ByBackupVaultName=ByBackupVaultName&ByCompleteAfter=ByCompleteAfter&ByCompleteBefore=ByCompleteBefore&ByMalwareScanner=ByMalwareScanner&ByRecoveryPointArn=ByRecoveryPointArn&ByResourceArn=ByResourceArn&ByResourceType=ByResourceType&ByScanResultStatus=ByScanResultStatus&ByState=ByState&MaxResults=MaxResults&NextToken=NextToken HTTP/1.1

Parametri della richiesta URI

La richiesta utilizza i seguenti parametri URI.

ByAccountId

L'ID account da cui elencare i processi. Restituisce solo i processi di backup associati all'ID account specificato.

Se utilizzato da un account di gestione di AWS Organizations, pass * restituisce tutti i lavori all'interno dell'organizzazione.

Modello: ^[0-9]{12}$

ByBackupVaultName

Restituisce solo i lavori di scansione che verranno archiviati nell'archivio di backup specificato. Gli archivi di Backup sono identificati da nomi univoci per l'account utilizzato per crearli e per la AWS regione in cui vengono creati.

Modello: ^[a-zA-Z0-9\-\_\.]{2,50}$

ByCompleteAfter

Restituisce solo i lavori di scansione completati dopo una data espressa in formato Unix e Coordinated Universal Time (UTC).

ByCompleteBefore

Restituisce solo i processi di backup completati prima di una data espressa nel formato Unix e nell'ora UTC (Coordinated Universal Time).

ByMalwareScanner

Restituisce solo i processi di scansione per lo scanner antimalware specificato. Attualmente supporta soloGUARDDUTY.

Valori validi: GUARDDUTY

ByRecoveryPointArn

Restituisce solo i processi di scansione eseguiti sul punto di ripristino specificato.

ByResourceArn

Restituisce solo i processi di scansione che corrispondono alla risorsa Amazon Resource Name (ARN) specificata.

ByResourceType

Restituisce le selezioni del test di ripristino in base al nome del piano di test di ripristino specificato.

  • EBSper Amazon Elastic Block Store

  • EC2per Amazon Elastic Compute Cloud

  • S3per Amazon Simple Storage Service (Amazon S3)

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

Valori validi: EBS | EC2 | S3

ByScanResultStatus

Restituisce solo i lavori di scansione per i risultati di scansione specificati:

  • THREATS_FOUND

  • NO_THREATS_FOUND

Valori validi: NO_THREATS_FOUND | THREATS_FOUND

ByState

Restituisce solo i lavori di scansione per lo stato del lavoro di scansione specificato.

Valori validi: CANCELED | COMPLETED | COMPLETED_WITH_ISSUES | CREATED | FAILED | RUNNING

MaxResults

Il numero massimo di elementi da restituire.

Intervallo valido: valore minimo di 1. Valore massimo pari a 1000.

Intervallo valido: valore minimo di 1. Valore massimo pari a 1000.

NextToken

L'elemento successivo che segue un elenco parziale di elementi restituiti. Ad esempio, se viene effettuata una richiesta per restituire il numero MaxResults di elementi, NextToken consente di restituire più elementi dell'elenco a partire dalla posizione indicata dal token successivo.

Corpo della richiesta

La richiesta non ha un corpo della richiesta.

Sintassi della risposta

HTTP/1.1 200
Content-type: application/json

{
   "NextToken": "string",
   "ScanJobs": [ 
      { 
         "AccountId": "string",
         "BackupVaultArn": "string",
         "BackupVaultName": "string",
         "CompletionDate": number,
         "CreatedBy": { 
            "BackupPlanArn": "string",
            "BackupPlanId": "string",
            "BackupPlanVersion": "string",
            "BackupRuleId": "string"
         },
         "CreationDate": number,
         "IamRoleArn": "string",
         "MalwareScanner": "string",
         "RecoveryPointArn": "string",
         "ResourceArn": "string",
         "ResourceName": "string",
         "ResourceType": "string",
         "ScanBaseRecoveryPointArn": "string",
         "ScanId": "string",
         "ScanJobId": "string",
         "ScanMode": "string",
         "ScannerRoleArn": "string",
         "ScanResult": { 
            "ScanResultStatus": "string"
         },
         "State": "string",
         "StatusMessage": "string"
      }
   ]
}

Elementi di risposta

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

NextToken

L'elemento successivo che segue un elenco parziale di elementi restituiti. Ad esempio, se viene effettuata una richiesta per restituire il numero MaxResults di elementi, NextToken consente di restituire più elementi dell'elenco a partire dalla posizione indicata dal token successivo.

Tipo: String

ScanJobs

Una serie di strutture contenenti metadati sui lavori di scansione restituiti in formato JSON.

Tipo: matrice di oggetti ScanJob

Errori

Per informazioni sugli errori comuni a tutte le operazioni, consultare Errori comuni.

InvalidParameterValueException

Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.

Context

Type

Codice di stato HTTP: 400

ServiceUnavailableException

La richiesta non è riuscita a causa di un errore temporaneo del server.

Context

Type

Codice di stato HTTP: 500

Vedi anche

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche, consulta quanto segue AWS SDKs: