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"
SeBackupType
è 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
eBackupRuleId
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
eINVALIDPARAMETERS
. 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 diStartBy
è 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: