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

DescribeScanJob

Restituisce i dettagli del processo di scansione per l' ScanJobID specificato.

Sintassi della richiesta

GET /scan/jobs/ScanJobId HTTP/1.1

Parametri della richiesta URI

La richiesta utilizza i seguenti parametri URI.

ScanJobId

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

Obbligatorio: sì

Corpo della richiesta

La richiesta non ha un corpo della richiesta.

Sintassi della risposta

HTTP/1.1 200
Content-type: application/json

{
   "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.

AccountId

Restituisce l'ID dell'account proprietario del processo di scansione.

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

Tipo: String

BackupVaultArn

Un Amazon Resource Name (ARN) che identifica in modo univoco un archivio di backup; ad esempio, arn:aws:backup:us-east-1:123456789012:backup-vault:aBackupVault

Tipo: String

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: String

CompletionDate

Data e ora di completamento della creazione di un indice di backup, in formato Unix e Coordinated Universal Time (UTC). Il valore di CompletionDate è preciso al millisecondo. Ad esempio, il valore 1516925490.087 rappresenta venerdì 26 gennaio 2018 alle ore 12:11:30.087.

Tipo: Timestamp

CreatedBy

Contiene informazioni identificative sulla creazione di un processo di scansione, inclusi il piano di backup e la regola che ha avviato la scansione.

Tipo: oggetto ScanJobCreator

CreationDate

Data e ora di completamento della creazione di un indice di backup, in formato Unix e Coordinated Universal Time (UTC). 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

IamRoleArn

Un nome della risorsa Amazon (ARN) che identifica in modo univoco un vault di backup, ad esempio arn:aws:iam::123456789012:role/S3Access.

Tipo: String

MalwareScanner

Il motore di scansione utilizzato per il processo di scansione corrispondente. Attualmento solo GUARDUTY è supportato.

Tipo: String

Valori validi: GUARDDUTY

RecoveryPointArn

Un ARN che identifica in modo univoco il punto di ripristino di destinazione per la scansione.; ad esempio,. arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45

Tipo: String

ResourceArn

Un ARN che identifica in modo univoco la risorsa di origine dell'ARN del punto di ripristino corrispondente.

Tipo: String

ResourceName

Il nome non univoco della risorsa che appartiene al backup specificato.

Tipo: String

ResourceType

Il tipo di AWS risorsa di cui eseguire il backup, ad esempio un volume Amazon Elastic Block Store (Amazon EBS).

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

Tipo: String

Valori validi: EBS | EC2 | S3

ScanBaseRecoveryPointArn

Un ARN che identifica in modo univoco il punto di ripristino di base per la scansione. Questo campo verrà compilato solo quando viene eseguito un processo di scansione incrementale.

Tipo: String

ScanId

L'ID di scansione generato da Amazon GuardDuty per la richiesta Scan Job ID corrispondente da AWS Backup.

Tipo: String

ScanJobId

L'ID del processo di scansione a cui è stata identificata in modo univoco la AWS Backup richiesta.

Tipo: String

ScanMode

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

Tipo: String

Valori validi: FULL_SCAN | INCREMENTAL_SCAN

ScannerRoleArn

Specifica il ruolo IAM dello scanner utilizzato dall'ARN per il processo di scansione.

Tipo: String

ScanResult

Contiene il codice ScanResultsStatus per il lavoro di scansione e i resi THREATS_FOUND o NO_THREATS_FOUND per i lavori completati.

Tipo: oggetto ScanResultInfo

State

Lo stato corrente di un processo di scansione.

Tipo: String

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

StatusMessage

Un messaggio dettagliato che spiega lo stato del processo di 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

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 AWS SDKs, consulta quanto segue: