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à.

# StartScanJob
<a name="API_StartScanJob"></a>

Avvia la scansione dei lavori per risorse specifiche.

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

```
PUT /scan/job HTTP/1.1
Content-type: application/json

{
   "BackupVaultName": "string",
   "IamRoleArn": "string",
   "IdempotencyToken": "string",
   "MalwareScanner": "string",
   "RecoveryPointArn": "string",
   "ScanBaseRecoveryPointArn": "string",
   "ScanMode": "string",
   "ScannerRoleArn": "string"
}
```

## Parametri della richiesta URI:
<a name="API_StartScanJob_RequestParameters"></a>

La richiesta non utilizza parametri URI.

## Corpo della richiesta
<a name="API_StartScanJob_RequestBody"></a>

La richiesta accetta i seguenti dati in formato JSON.

 ** [BackupVaultName](#API_StartScanJob_RequestSyntax) **   <a name="Backup-StartScanJob-request-BackupVaultName"></a>
Il nome di un container logico in cui vengono archiviati i backup. 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}$`   
Tipo: stringa  
Obbligatorio: sì

 ** [IamRoleArn](#API_StartScanJob_RequestSyntax) **   <a name="Backup-StartScanJob-request-IamRoleArn"></a>
Specifica l'ARN del ruolo IAM utilizzato per creare il punto di ripristino di destinazione; ad esempio, `arn:aws:iam::123456789012:role/S3Access`.  
Tipo: stringa  
Obbligatorio: sì

 ** [IdempotencyToken](#API_StartScanJob_RequestSyntax) **   <a name="Backup-StartScanJob-request-IdempotencyToken"></a>
Una stringa scelta dal cliente che puoi usare per distinguere tra chiamate altrimenti identiche a `StartScanJob`. Riprovare una richiesta riuscita con lo stesso token di idempotenza restituisce un messaggio di completamento senza alcuna azione eseguita.  
▬Tipo: stringa  
Obbligatorio: no

 ** [MalwareScanner](#API_StartScanJob_RequestSyntax) **   <a name="Backup-StartScanJob-request-MalwareScanner"></a>
Speciifica lo scanner antimalware utilizzato durante il processo di scansione. Attualmente supporta `GUARDDUTY` solo.  
Tipo: String  
Valori validi: `GUARDDUTY`   
Obbligatorio: sì

 ** [RecoveryPointArn](#API_StartScanJob_RequestSyntax) **   <a name="Backup-StartScanJob-request-RecoveryPointArn"></a>
Un Amazon Resource Name (ARN) che identifica in modo univoco un punto di ripristino. Questo è il punto di ripristino di destinazione per una scansione completa. Se si esegue una scansione incrementale, questo sarà il punto di ripristino creato dopo la selezione del punto di ripristino di base.  
Tipo: stringa  
Obbligatorio: sì

 ** [ScanBaseRecoveryPointArn](#API_StartScanJob_RequestSyntax) **   <a name="Backup-StartScanJob-request-ScanBaseRecoveryPointArn"></a>
Un ARN che identifica in modo univoco il punto di ripristino di base da utilizzare per la scansione incrementale.  
▬Tipo: stringa  
Obbligatorio: no

 ** [ScanMode](#API_StartScanJob_RequestSyntax) **   <a name="Backup-StartScanJob-request-ScanMode"></a>
Speciifica il tipo di scansione utilizzato per il processo di scansione.  
Include:  
+  `FULL_SCAN`eseguirà la scansione dell'intera sequenza di dati all'interno del backup.
+  `INCREMENTAL_SCAN`eseguirà la scansione della differenza di dati tra il punto di ripristino di destinazione e l'ARN del punto di ripristino di base.
Tipo: String  
Valori validi: `FULL_SCAN | INCREMENTAL_SCAN`   
Obbligatorio: sì

 ** [ScannerRoleArn](#API_StartScanJob_RequestSyntax) **   <a name="Backup-StartScanJob-request-ScannerRoleArn"></a>
Specificato l'ARN del ruolo dello scanner IAM.  
Tipo: stringa  
Obbligatorio: sì

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

```
HTTP/1.1 201
Content-type: application/json

{
   "CreationDate": number,
   "ScanJobId": "string"
}
```

## Elementi di risposta
<a name="API_StartScanJob_ResponseElements"></a>

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

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

 ** [CreationDate](#API_StartScanJob_ResponseSyntax) **   <a name="Backup-StartScanJob-response-CreationDate"></a>
La data e l'ora di creazione di un processo di backup, nel formato Unix e nell'ora UTC (Coordinated Universal Time). Il valore di `CreationDate` è preciso al millisecondo. Ad esempio, il valore 1516925490.087 rappresenta venerdì 26 gennaio 2018 alle ore 12:11:30.087.  
Tipo: Timestamp

 ** [ScanJobId](#API_StartScanJob_ResponseSyntax) **   <a name="Backup-StartScanJob-response-ScanJobId"></a>
Identifica in modo univoco una richiesta di backup AWS Backup di una risorsa.  
Tipo: String

## Errori
<a name="API_StartScanJob_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

 ** InvalidRequestException **   
Indica che si è verificato un errore nell'input alla richiesta. Ad esempio, un parametro è del tipo errato.    
 ** Context **   
  
 ** Type **   

Codice di stato HTTP: 400

 ** LimitExceededException **   
È stato superato un limite nella richiesta, ad esempio il numero massimo di elementi consentiti in una richiesta.    
 ** Context **   
  
 ** Type **   

Codice di stato HTTP: 400

 ** MissingParameterValueException **   
Indica che manca un parametro obbligatorio.    
 ** Context **   
  
 ** Type **   

Codice di stato HTTP: 400

 ** ResourceNotFoundException **   
Una risorsa necessaria per l'azione non esiste.    
 ** 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_StartScanJob_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/StartScanJob) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/StartScanJob) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/StartScanJob) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/StartScanJob) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/StartScanJob) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/StartScanJob) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/StartScanJob) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/StartScanJob) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/StartScanJob) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/StartScanJob)