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
<a name="API_DescribeBackupJob"></a>

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

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

```
GET /backup-jobs/backupJobId HTTP/1.1
```

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

La richiesta utilizza i seguenti parametri URI.

 ** [backupJobId](#API_DescribeBackupJob_RequestSyntax) **   <a name="Backup-DescribeBackupJob-request-uri-BackupJobId"></a>
Identifica in modo univoco una richiesta di backup AWS Backup di una risorsa.  
Obbligatorio: sì

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

La richiesta non ha un corpo della richiesta.

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

```
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",
      "BackupPlanName": "string",
      "BackupPlanVersion": "string",
      "BackupRuleCron": "string",
      "BackupRuleId": "string",
      "BackupRuleName": "string",
      "BackupRuleTimezone": "string"
   },
   "CreationDate": number,
   "EncryptionKeyArn": "string",
   "ExpectedCompletionDate": number,
   "IamRoleArn": "string",
   "InitiationDate": number,
   "IsEncrypted": boolean,
   "IsParent": boolean,
   "MessageCategory": "string",
   "NumberOfChildJobs": number,
   "ParentJobId": "string",
   "PercentDone": "string",
   "RecoveryPointArn": "string",
   "RecoveryPointLifecycle": { 
      "DeleteAfterDays": number,
      "DeleteAfterEvent": "string",
      "MoveToColdStorageAfterDays": number,
      "OptInToArchiveForSupportedResources": boolean
   },
   "ResourceArn": "string",
   "ResourceName": "string",
   "ResourceType": "string",
   "StartBy": number,
   "State": "string",
   "StatusMessage": "string",
   "VaultLockState": "string",
   "VaultType": "string"
}
```

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

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

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

 ** [AccountId](#API_DescribeBackupJob_ResponseSyntax) **   <a name="Backup-DescribeBackupJob-response-AccountId"></a>
Restituisce l'ID account proprietario del processo di backup.  
Tipo: stringa  
Modello: `^[0-9]{12}$` 

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

 ** [BackupOptions](#API_DescribeBackupJob_ResponseSyntax) **   <a name="Backup-DescribeBackupJob-response-BackupOptions"></a>
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](#API_DescribeBackupJob_ResponseSyntax) **   <a name="Backup-DescribeBackupJob-response-BackupSizeInBytes"></a>
La dimensione, in byte, di un backup (punto di ripristino).  
Questo valore può essere riprodotto in modo diverso a seconda del tipo di risorsa, poiché AWS Backup estrae informazioni sui dati da altri AWS servizi. Ad esempio, il valore restituito può mostrare un valore di`0`, che può differire dal valore previsto.  
Il comportamento previsto per i valori per tipo di risorsa è descritto come segue:  
+ Amazon Aurora, Amazon DocumentDB e Amazon Neptune non hanno questo valore compilato dall'operazione. `GetBackupJobStatus`
+ Per Amazon DynamoDB con funzionalità avanzate, questo valore si riferisce alla dimensione del punto di ripristino (backup).
+ Amazon EC2 e Amazon EBS mostrano la dimensione del volume (storage fornito) restituita come parte di questo valore. Amazon EBS non restituisce informazioni sulle dimensioni del backup; la dimensione dello snapshot avrà lo stesso valore della risorsa originale di cui è stato eseguito il backup.
+ Per Amazon EFS, questo valore si riferisce ai delta byte trasferiti durante un backup.
+ Per Amazon EKS, questo valore si riferisce alla dimensione del punto di ripristino EKS annidato.
+ Amazon FSx non inserisce questo valore nell'operazione `GetBackupJobStatus` per i FSx file system.
+ Un'istanza Amazon RDS verrà visualizzata come`0`.
+ Per le macchine virtuali in esecuzione VMware, questo valore viene passato AWS Backup attraverso un flusso di lavoro asincrono, il che può significare che questo valore visualizzato può sottorappresentare la dimensione effettiva del backup.
Tipo: long

 ** [BackupType](#API_DescribeBackupJob_ResponseSyntax) **   <a name="Backup-DescribeBackupJob-response-BackupType"></a>
Rappresenta il tipo di backup effettivo selezionato per un processo di backup. Ad esempio, se è stato eseguito correttamente un backup di Windows VSS (Volume Shadow Copy Service), `BackupType` restituisce `"WindowsVSS"`. Se `BackupType` è vuoto, significa che il tipo di backup è stato un backup normale.  
Tipo: String

 ** [BackupVaultArn](#API_DescribeBackupJob_ResponseSyntax) **   <a name="Backup-DescribeBackupJob-response-BackupVaultArn"></a>
Un nome della risorsa Amazon (ARN) che identifica in modo univoco un vault di backup, ad esempio `arn:aws:backup:us-east-1:123456789012:backup-vault:aBackupVault`.  
Tipo: String

 ** [BackupVaultName](#API_DescribeBackupJob_ResponseSyntax) **   <a name="Backup-DescribeBackupJob-response-BackupVaultName"></a>
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](#API_DescribeBackupJob_ResponseSyntax) **   <a name="Backup-DescribeBackupJob-response-BytesTransferred"></a>
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](#API_DescribeBackupJob_ResponseSyntax) **   <a name="Backup-DescribeBackupJob-response-ChildJobsInState"></a>
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](#API_DescribeBackupJob_ResponseSyntax) **   <a name="Backup-DescribeBackupJob-response-CompletionDate"></a>
La data e l'ora di complemento di un processo di backup, nel formato Unix e nell'ora UTC (Coordinated Universal Time). 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](#API_DescribeBackupJob_ResponseSyntax) **   <a name="Backup-DescribeBackupJob-response-CreatedBy"></a>
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](API_RecoveryPointCreator.md)

 ** [CreationDate](#API_DescribeBackupJob_ResponseSyntax) **   <a name="Backup-DescribeBackupJob-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

 ** [EncryptionKeyArn](#API_DescribeBackupJob_ResponseSyntax) **   <a name="Backup-DescribeBackupJob-response-EncryptionKeyArn"></a>
L'Amazon Resource Name (ARN) della chiave KMS utilizzata per crittografare il backup. Può essere una chiave gestita dal cliente o una chiave gestita, AWS a seconda della configurazione del vault.  
Tipo: String

 ** [ExpectedCompletionDate](#API_DescribeBackupJob_ResponseSyntax) **   <a name="Backup-DescribeBackupJob-response-ExpectedCompletionDate"></a>
La data e l'ora prevista di complemento di un processo di backup delle risorse, nel formato Unix e nell'ora UTC (Coordinated Universal Time). 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](#API_DescribeBackupJob_ResponseSyntax) **   <a name="Backup-DescribeBackupJob-response-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: String

 ** [InitiationDate](#API_DescribeBackupJob_ResponseSyntax) **   <a name="Backup-DescribeBackupJob-response-InitiationDate"></a>
La data di avvio di un processo di backup.  
Tipo: Timestamp

 ** [IsEncrypted](#API_DescribeBackupJob_ResponseSyntax) **   <a name="Backup-DescribeBackupJob-response-IsEncrypted"></a>
Un valore booleano che indica se il backup è crittografato. Tutti i backup in entrata AWS Backup sono crittografati, ma questo campo indica lo stato della crittografia per motivi di trasparenza.  
Tipo: Booleano

 ** [IsParent](#API_DescribeBackupJob_ResponseSyntax) **   <a name="Backup-DescribeBackupJob-response-IsParent"></a>
Ciò restituisce il valore booleano di cui un processo di backup è un processo principale (composito).  
Tipo: Booleano

 ** [MessageCategory](#API_DescribeBackupJob_ResponseSyntax) **   <a name="Backup-DescribeBackupJob-response-MessageCategory"></a>
Il numero di lavori per la categoria di messaggi specificata.  
Stringhe di esempio possono essere `AccessDenied`, `SUCCESS`, `AGGREGATE_ALL` e `INVALIDPARAMETERS`. Visualizza [Monitoraggio](https://docs.aws.amazon.com/aws-backup/latest/devguide/monitoring.html) per un elenco di MessageCategory stringhe accettate.  
Tipo: String

 ** [NumberOfChildJobs](#API_DescribeBackupJob_ResponseSyntax) **   <a name="Backup-DescribeBackupJob-response-NumberOfChildJobs"></a>
Ciò restituisce il numero di processi di backup figlio (nidificati).  
Tipo: long

 ** [ParentJobId](#API_DescribeBackupJob_ResponseSyntax) **   <a name="Backup-DescribeBackupJob-response-ParentJobId"></a>
Ciò restituisce l'ID del processo di backup della risorsa principale (composito).  
Tipo: String

 ** [PercentDone](#API_DescribeBackupJob_ResponseSyntax) **   <a name="Backup-DescribeBackupJob-response-PercentDone"></a>
Contiene una percentuale stimata di completamento di un processo nel momento in cui è stato richiesto lo stato del processo.  
Tipo: String

 ** [RecoveryPointArn](#API_DescribeBackupJob_ResponseSyntax) **   <a name="Backup-DescribeBackupJob-response-RecoveryPointArn"></a>
Un ARN che identifica in modo univoco un punto di ripristino; ad esempio `arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45`.  
Tipo: String

 ** [RecoveryPointLifecycle](#API_DescribeBackupJob_ResponseSyntax) **   <a name="Backup-DescribeBackupJob-response-RecoveryPointLifecycle"></a>
Speciifica il periodo di tempo, in giorni, prima che un punto di ripristino passi alla conservazione a freddo o venga eliminato.  
I backup passati alla conservazione a freddo devono essere conservati in celle frigorifere per un minimo di 90 giorni. Pertanto, sulla console, l'impostazione di conservazione deve essere superiore di 90 giorni rispetto all'impostazione del passaggio al freddo dopo giorni. L'impostazione relativa alla transizione a freddo dopo giorni non può essere modificata dopo che un backup è passato a freddo.  
I tipi di risorse che possono passare alla conservazione a freddo sono elencati nella tabella [Disponibilità delle funzionalità per risorsa](https://docs.aws.amazon.com/aws-backup/latest/devguide/backup-feature-availability.html#features-by-resource). AWS Backup ignora questa espressione per altri tipi di risorse.  
Per rimuovere il ciclo di vita e i periodi di conservazione esistenti e mantenere i punti di ripristino a tempo indeterminato, specifica -1 per e. `MoveToColdStorageAfterDays` `DeleteAfterDays`  
Tipo: oggetto [Lifecycle](API_Lifecycle.md)

 ** [ResourceArn](#API_DescribeBackupJob_ResponseSyntax) **   <a name="Backup-DescribeBackupJob-response-ResourceArn"></a>
Un ARN identifica in modo univoco una risorsa salvata. Il formato dell'ARN dipende dal tipo di risorsa.  
Tipo: String

 ** [ResourceName](#API_DescribeBackupJob_ResponseSyntax) **   <a name="Backup-DescribeBackupJob-response-ResourceName"></a>
Il nome non univoco della risorsa che appartiene al backup specificato.  
Tipo: String

 ** [ResourceType](#API_DescribeBackupJob_ResponseSyntax) **   <a name="Backup-DescribeBackupJob-response-ResourceType"></a>
Il tipo di AWS risorsa di cui eseguire il backup; ad esempio, un volume Amazon Elastic Block Store (Amazon EBS) o un database Amazon Relational Database Service (Amazon RDS).  
Tipo: stringa  
Modello: `^[a-zA-Z0-9\-\_\.]{1,50}$` 

 ** [StartBy](#API_DescribeBackupJob_ResponseSyntax) **   <a name="Backup-DescribeBackupJob-response-StartBy"></a>
Specifica l'ora in formato Unix e UTC (Coordinated Universal Time) in cui è necessario avviare un processo di backup prima che venga 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](#API_DescribeBackupJob_ResponseSyntax) **   <a name="Backup-DescribeBackupJob-response-State"></a>
Lo stato corrente di un processo di backup.  
Tipo: String  
Valori validi: `CREATED | PENDING | RUNNING | ABORTING | ABORTED | COMPLETED | FAILED | EXPIRED | PARTIAL` 

 ** [StatusMessage](#API_DescribeBackupJob_ResponseSyntax) **   <a name="Backup-DescribeBackupJob-response-StatusMessage"></a>
Un messaggio dettagliato che spiega lo stato del processo di backup di una risorsa.  
Tipo: String

 ** [VaultLockState](#API_DescribeBackupJob_ResponseSyntax) **   <a name="Backup-DescribeBackupJob-response-VaultLockState"></a>
Lo stato di blocco del vault di backup. Per i vault con intercapedine logiche, indica se il deposito è bloccato in modalità di conformità. I valori validi includono `LOCKED` e `UNLOCKED`.  
Tipo: String

 ** [VaultType](#API_DescribeBackupJob_ResponseSyntax) **   <a name="Backup-DescribeBackupJob-response-VaultType"></a>
Il tipo di archivio di backup in cui è archiviato il punto di ripristino. I valori validi sono `BACKUP_VAULT` per gli archivi di backup standard e `LOGICALLY_AIR_GAPPED_BACKUP_VAULT` per gli archivi con intercapedine logiche.  
Tipo: String

## Errori
<a name="API_DescribeBackupJob_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).

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

Codice di stato HTTP: 500

 ** 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
<a name="API_DescribeBackupJob_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/DescribeBackupJob) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/DescribeBackupJob) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/DescribeBackupJob) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/DescribeBackupJob) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/DescribeBackupJob) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/DescribeBackupJob) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/DescribeBackupJob) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/DescribeBackupJob) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/DescribeBackupJob) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/DescribeBackupJob)