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
<a name="API_ListScanJobs"></a>

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

## Sintassi della richiesta
<a name="API_ListScanJobs_RequestSyntax"></a>

```
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
<a name="API_ListScanJobs_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [ByAccountId](#API_ListScanJobs_RequestSyntax) **   <a name="Backup-ListScanJobs-request-uri-ByAccountId"></a>
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](#API_ListScanJobs_RequestSyntax) **   <a name="Backup-ListScanJobs-request-uri-ByBackupVaultName"></a>
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](#API_ListScanJobs_RequestSyntax) **   <a name="Backup-ListScanJobs-request-uri-ByCompleteAfter"></a>
Restituisce solo i lavori di scansione completati dopo una data espressa in formato Unix e Coordinated Universal Time (UTC).

 ** [ByCompleteBefore](#API_ListScanJobs_RequestSyntax) **   <a name="Backup-ListScanJobs-request-uri-ByCompleteBefore"></a>
Restituisce solo i processi di backup completati prima di una data espressa nel formato Unix e nell'ora UTC (Coordinated Universal Time).

 ** [ByMalwareScanner](#API_ListScanJobs_RequestSyntax) **   <a name="Backup-ListScanJobs-request-uri-ByMalwareScanner"></a>
Restituisce solo i processi di scansione per lo scanner antimalware specificato. Attualmente supporta solo`GUARDDUTY`.  
Valori validi: `GUARDDUTY` 

 ** [ByRecoveryPointArn](#API_ListScanJobs_RequestSyntax) **   <a name="Backup-ListScanJobs-request-uri-ByRecoveryPointArn"></a>
Restituisce solo i processi di scansione eseguiti sul punto di ripristino specificato.

 ** [ByResourceArn](#API_ListScanJobs_RequestSyntax) **   <a name="Backup-ListScanJobs-request-uri-ByResourceArn"></a>
Restituisce solo i processi di scansione che corrispondono alla risorsa Amazon Resource Name (ARN) specificata.

 ** [ByResourceType](#API_ListScanJobs_RequestSyntax) **   <a name="Backup-ListScanJobs-request-uri-ByResourceType"></a>
Restituisce le selezioni del test di ripristino in base al nome del piano di test di ripristino specificato.  
+  `EBS`per Amazon Elastic Block Store
+  `EC2`per Amazon Elastic Compute Cloud
+  `S3`per Amazon Simple Storage Service (Amazon S3)
Modello: `^[a-zA-Z0-9\-\_\.]{1,50}$`   
Valori validi: `EBS | EC2 | S3` 

 ** [ByScanResultStatus](#API_ListScanJobs_RequestSyntax) **   <a name="Backup-ListScanJobs-request-uri-ByScanResultStatus"></a>
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](#API_ListScanJobs_RequestSyntax) **   <a name="Backup-ListScanJobs-request-uri-ByState"></a>
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](#API_ListScanJobs_RequestSyntax) **   <a name="Backup-ListScanJobs-request-uri-MaxResults"></a>
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](#API_ListScanJobs_RequestSyntax) **   <a name="Backup-ListScanJobs-request-uri-NextToken"></a>
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
<a name="API_ListScanJobs_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_ListScanJobs_ResponseSyntax"></a>

```
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
<a name="API_ListScanJobs_ResponseElements"></a>

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

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

 ** [NextToken](#API_ListScanJobs_ResponseSyntax) **   <a name="Backup-ListScanJobs-response-NextToken"></a>
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](#API_ListScanJobs_ResponseSyntax) **   <a name="Backup-ListScanJobs-response-ScanJobs"></a>
Una serie di strutture contenenti metadati sui lavori di scansione restituiti in formato JSON.  
Tipo: matrice di oggetti [ScanJob](API_ScanJob.md)

## Errori
<a name="API_ListScanJobs_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).

 ** 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
<a name="API_ListScanJobs_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche, consulta quanto segue AWS SDKs:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/ListScanJobs) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/ListScanJobs) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/ListScanJobs) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/ListScanJobs) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/ListScanJobs) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/ListScanJobs) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/ListScanJobs) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/ListScanJobs) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/ListScanJobs) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/ListScanJobs)