DescribeBackupJob - AWS Backup

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

DescribeBackupJob

Restituisce i dettagli del processo di backup per il BackupJobId specificato.

Sintassi della richiesta

GET /backup-jobs/backupJobId HTTP/1.1

URIParametri di richiesta

La richiesta utilizza i seguenti URI parametri.

backupJobId

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

Campo 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", "BackupJobId": "string", "BackupOptions": { "string" : "string" }, "BackupSizeInBytes": number, "BackupType": "string", "BackupVaultArn": "string", "BackupVaultName": "string", "BytesTransferred": number, "ChildJobsInState": { "string" : number }, "CompletionDate": number, "CreatedBy": { "BackupPlanArn": "string", "BackupPlanId": "string", "BackupPlanVersion": "string", "BackupRuleId": "string" }, "CreationDate": number, "ExpectedCompletionDate": number, "IamRoleArn": "string", "InitiationDate": number, "IsParent": boolean, "MessageCategory": "string", "NumberOfChildJobs": number, "ParentJobId": "string", "PercentDone": "string", "RecoveryPointArn": "string", "ResourceArn": "string", "ResourceName": "string", "ResourceType": "string", "StartBy": number, "State": "string", "StatusMessage": "string" }

Elementi di risposta

Se l'azione ha esito positivo, il servizio restituisce una risposta di HTTP 200.

I seguenti dati vengono restituiti in JSON formato dal servizio.

AccountId

Restituisce l'ID account proprietario del processo di backup.

Tipo: stringa

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

BackupJobId

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

Tipo: stringa

BackupOptions

Rappresenta le opzioni specificate come parte del piano di backup o del processo di backup on demand.

Tipo: mappatura stringa a stringa

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

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

BackupSizeInBytes

La dimensione, in byte, di un backup.

Tipo: long

BackupType

Rappresenta il tipo di backup effettivo selezionato per un processo di backup. Ad esempio, se è stato eseguito correttamente un backup di Windows Volume Shadow Copy Service (VSS), BackupType restituisce. "WindowsVSS" Se BackupType è vuoto, significa che il tipo di backup è stato un backup normale.

Tipo: stringa

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

BackupVaultName

Il nome di un container logico in cui vengono archiviati i backup. I vault di backup sono identificati da nomi univoci per l'account utilizzato per crearli e per la Regione AWS in cui sono stati creati.

Tipo: stringa

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

BytesTransferred

La dimensione in byte trasferiti in un vault di backup nel momento in cui è stata richiesta la verifica dello stato del processo.

Tipo: long

ChildJobsInState

Ciò restituisce le statistiche dei processi di backup figlio (nidificati) inclusi.

Tipo: mappatura stringa a intero lungo

Chiavi valide: CREATED | PENDING | RUNNING | ABORTING | ABORTED | COMPLETED | FAILED | EXPIRED | PARTIAL

CompletionDate

La data e l'ora di completamento di un processo per creare un processo 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 di identificazione sulla creazione di un processo di backup, tra cui BackupPlanArn, BackupPlanId, BackupPlanVersion e BackupRuleId del piano backup utilizzato per crearlo.

Tipo: oggetto RecoveryPointCreator

CreationDate

Data e ora di creazione di un job 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

ExpectedCompletionDate

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

Tipo: Timestamp

IamRoleArn

Speciifica il IAM ruolo ARN utilizzato per creare il punto di ripristino di destinazione, ad esempio. arn:aws:iam::123456789012:role/S3Access

Tipo: stringa

InitiationDate

La data di avvio di un processo di backup.

Tipo: Timestamp

IsParent

Ciò restituisce il valore booleano di cui un processo di backup è un processo principale (composito).

Tipo: Booleano

MessageCategory

Il numero di lavori per la categoria di messaggi specificata.

Stringhe di esempio possono essere AccessDenied, SUCCESS, AGGREGATE_ALL e INVALIDPARAMETERS. Visualizza Monitoraggio per un elenco di MessageCategory stringhe accettate.

Tipo: stringa

NumberOfChildJobs

Ciò restituisce il numero di processi di backup figlio (nidificati).

Tipo: long

ParentJobId

Ciò restituisce l'ID del processo di backup della risorsa principale (composito).

Tipo: stringa

PercentDone

Contiene una percentuale stimata di completamento di un processo nel momento in cui è stato richiesto lo stato del processo.

Tipo: stringa

RecoveryPointArn

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

Tipo: stringa

ResourceArn

E ARN che identifica in modo univoco una risorsa salvata. Il formato di ARN dipende dal tipo di risorsa.

Tipo: stringa

ResourceName

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

Tipo: stringa

ResourceType

Il tipo di AWS risorsa di cui eseguire il backup, ad esempio un volume Amazon Elastic Block Store (AmazonEBS) o un database Amazon Relational Database Service (RDSAmazon).

Tipo: stringa

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

StartBy

Speciifica l'ora in formato Unix e Coordinated Universal Time (UTC) in cui un processo di backup deve essere avviato prima di essere annullato. Il valore viene calcolato aggiungendo la finestra di avvio all'ora pianificata. Pertanto, se l'ora pianificata era le 18:00 e la finestra di avvia è di 2 ore, l'ora StartBy sarebbe le 20:00 della data specificata. Il valore di StartBy è preciso al millisecondo. Ad esempio, il valore 1516925490.087 rappresenta venerdì 26 gennaio 2018 alle ore 12:11:30.087.

Tipo: Timestamp

State

Lo stato corrente di un processo di backup.

Tipo: stringa

Valori validi: CREATED | PENDING | RUNNING | ABORTING | ABORTED | COMPLETED | FAILED | EXPIRED | PARTIAL

StatusMessage

Un messaggio dettagliato che spiega lo stato del processo di backup di una risorsa.

Tipo: stringa

Errori

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

DependencyFailureException

Un AWS servizio o una risorsa dipendente ha restituito un errore al AWS Backup servizio e l'azione non può essere completata.

HTTPCodice di stato: 500

InvalidParameterValueException

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

HTTPCodice di stato: 400

MissingParameterValueException

Indica che manca un parametro obbligatorio.

HTTPCodice di stato: 400

ResourceNotFoundException

Una risorsa necessaria per l'azione non esiste.

HTTPCodice di stato: 400

ServiceUnavailableException

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

HTTPCodice di stato: 500

Vedi anche

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