StartScanJob - AWS Backup
Sintassi della richiestaParametri della richiesta URI:Corpo 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à.

StartScanJob

Avvia la scansione dei lavori per risorse specifiche.

Sintassi della richiesta

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:

La richiesta non utilizza parametri URI.

Corpo della richiesta

La richiesta accetta i seguenti dati in formato JSON.

BackupVaultName

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

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

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

Speciifica lo scanner antimalware utilizzato durante il processo di scansione. Attualmente supporta GUARDDUTY solo.

Tipo: String

Valori validi: GUARDDUTY

Obbligatorio: sì

RecoveryPointArn

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 stai eseguendo una scansione incrementale, questo sarà il tuo punto di ripristino creato dopo la selezione del punto di ripristino di base.

Tipo: stringa

Obbligatorio: sì

ScanBaseRecoveryPointArn

Un ARN che identifica in modo univoco il punto di ripristino di base da utilizzare per la scansione incrementale.

▬Tipo: stringa

Obbligatorio: no

ScanMode

Speciifica il tipo di scansione utilizzato per il processo di scansione.

Include:

  • FULL_SCANeseguirà la scansione dell'intera sequenza di dati all'interno del backup.

  • INCREMENTAL_SCANeseguirà 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

Specificato l'ARN del ruolo dello scanner IAM.

Tipo: stringa

Obbligatorio: sì

Sintassi della risposta

HTTP/1.1 201
Content-type: application/json

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

Elementi di risposta

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

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

CreationDate

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

Identifica in modo univoco una richiesta di backup AWS Backup di una risorsa.

Tipo: String

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

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

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