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à. # DescribeBackupVault Restituisce i metadati relativi a un vault di backup specificato in base al nome. ## Sintassi della richiesta ``` GET /backup-vaults/backupVaultName?backupVaultAccountId=BackupVaultAccountId HTTP/1.1 ``` ## Parametri della richiesta URI La richiesta utilizza i seguenti parametri URI. ** [BackupVaultAccountId](#API_DescribeBackupVault_RequestSyntax) ** L'ID dell'account del vault di backup specificato. ** [backupVaultName](#API_DescribeBackupVault_RequestSyntax) ** 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. Obbligatorio: sì ## Corpo della richiesta La richiesta non ha un corpo della richiesta. ## Sintassi della risposta ``` HTTP/1.1 200 Content-type: application/json { "BackupVaultArn": "string", "BackupVaultName": "string", "CreationDate": number, "CreatorRequestId": "string", "EncryptionKeyArn": "string", "EncryptionKeyType": "string", "LatestMpaApprovalTeamUpdate": { "ExpiryDate": number, "InitiationDate": number, "MpaSessionArn": "string", "Status": "string", "StatusMessage": "string" }, "LockDate": number, "Locked": boolean, "MaxRetentionDays": number, "MinRetentionDays": number, "MpaApprovalTeamArn": "string", "MpaSessionArn": "string", "NumberOfRecoveryPoints": number, "SourceBackupVaultArn": "string", "VaultState": "string", "VaultType": "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. ** [BackupVaultArn](#API_DescribeBackupVault_ResponseSyntax) ** 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_DescribeBackupVault_ResponseSyntax) ** 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 in cui sono stati creati. Tipo: String ** [CreationDate](#API_DescribeBackupVault_ResponseSyntax) ** La data e l'ora di creazione di un vault 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 ** [CreatorRequestId](#API_DescribeBackupVault_ResponseSyntax) ** Una stringa univoca che identifica la richiesta e consente di riprovare le richieste non riuscite senza il rischio di eseguire l'operazione due volte. Questo parametro è facoltativo. Se utilizzato, questo parametro deve contenere da 1 a 50 caratteri alfanumerici o '-\$1'. punti (.). Tipo: String ** [EncryptionKeyArn](#API_DescribeBackupVault_ResponseSyntax) ** La chiave di crittografia lato server utilizzata per proteggere i backup, ad esempio `arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab`. Tipo: String ** [EncryptionKeyType](#API_DescribeBackupVault_ResponseSyntax) ** Il tipo di chiave di crittografia utilizzata per l'archivio di backup. I valori validi sono CUSTOMER\$1MANAGED\$1KMS\$1KEY per le chiavi gestite dal cliente o \$1OWNED\$1KMS\$1KEY per le chiavi di proprietà. AWS AWS Tipo: String Valori validi: `AWS_OWNED_KMS_KEY | CUSTOMER_MANAGED_KMS_KEY` ** [LatestMpaApprovalTeamUpdate](#API_DescribeBackupVault_ResponseSyntax) ** Informazioni sull'ultimo aggiornamento dell'associazione del team di approvazione MPA per questo archivio di backup. Tipo: oggetto [LatestMpaApprovalTeamUpdate](API_LatestMpaApprovalTeamUpdate.md) ** [LockDate](#API_DescribeBackupVault_ResponseSyntax) ** La data e l'ora in cui la configurazione di AWS Backup Vault Lock non può essere modificata o eliminata. Se hai applicato Vault Lock al vault senza specificare una data di blocco, puoi modificare qualsiasi impostazione di Vault Lock o eliminare completamente Vault Lock dal vault, in qualsiasi momento. Questo valore è in formato Unix, ora Coordinated Universal Time (UTC) ed è preciso al millisecondo. Ad esempio, il valore 1516925490.087 rappresenta venerdì 26 gennaio 2018 alle ore 12:11:30.087. Tipo: Timestamp ** [Locked](#API_DescribeBackupVault_ResponseSyntax) ** Un valore booleano che indica se AWS Backup Vault Lock sta attualmente proteggendo l'archivio di backup. `True`significa che Vault Lock causa il fallimento delle operazioni di eliminazione o aggiornamento sui punti di ripristino archiviati nel vault. Tipo: Booleano ** [MaxRetentionDays](#API_DescribeBackupVault_ResponseSyntax) ** L'impostazione AWS Backup Vault Lock che specifica il periodo di conservazione massimo durante il quale il vault conserva i propri punti di ripristino. Se questo parametro non è specificato, Vault Lock non applica un periodo di conservazione massimo sui punti di ripristino nel vault (consentendo lo storage a tempo indeterminato). Se specificato, qualsiasi processo di backup o copia nel vault deve avere una policy del ciclo di vita con un periodo di conservazione uguale o inferiore al periodo di conservazione massimo. Se il periodo di conservazione del processo è più lungo del periodo di conservazione massimo, allora il processo di backup o di copia del vault non riesce ed è necessario modificare le impostazioni del ciclo di vita o utilizzare un vault diverso. I punti di ripristino già archiviati nel vault prima di Vault Lock non sono interessati. Tipo: long ** [MinRetentionDays](#API_DescribeBackupVault_ResponseSyntax) ** L'impostazione AWS Backup Vault Lock che specifica il periodo di conservazione minimo durante il quale il vault conserva i propri punti di ripristino. Se questo parametro non è specificato, Vault Lock non applica un periodo di conservazione minimo. Se specificato, qualsiasi processo di backup o copia nel vault deve avere una policy del ciclo di vita con un periodo di conservazione uguale o superiore al periodo di conservazione minimo. Se il periodo di conservazione del processo è più breve del periodo di conservazione minimo, allora il processo di backup o di copia del vault non riesce ed è necessario modificare le impostazioni del ciclo di vita o utilizzare un vault diverso. I punti di ripristino già archiviati nel vault prima di Vault Lock non sono interessati. Tipo: long ** [MpaApprovalTeamArn](#API_DescribeBackupVault_ResponseSyntax) ** L'ARN del team di approvazione MPA associato a questo archivio di backup. Tipo: String ** [MpaSessionArn](#API_DescribeBackupVault_ResponseSyntax) ** L'ARN della sessione MPA associata a questo archivio di backup. Tipo: String ** [NumberOfRecoveryPoints](#API_DescribeBackupVault_ResponseSyntax) ** Il numero di punti di ripristino archiviati in un vault di backup. Il valore del conteggio dei punti di ripristino visualizzato nella console può essere un’approssimazione. Utilizzare l’API [https://docs.aws.amazon.com/aws-backup/latest/devguide/API_ListRecoveryPointsByBackupVault.html](https://docs.aws.amazon.com/aws-backup/latest/devguide/API_ListRecoveryPointsByBackupVault.html) per ottenere il conteggio esatto. Tipo: long ** [SourceBackupVaultArn](#API_DescribeBackupVault_ResponseSyntax) ** L'ARN dell'archivio di backup di origine da cui è stato creato questo archivio di backup per l'accesso di ripristino. Tipo: String ** [VaultState](#API_DescribeBackupVault_ResponseSyntax) ** Lo stato attuale del vault. -> Tipo: String Valori validi: `CREATING | AVAILABLE | FAILED` ** [VaultType](#API_DescribeBackupVault_ResponseSyntax) ** Il tipo di deposito descritto. Tipo: String Valori validi: `BACKUP_VAULT | LOGICALLY_AIR_GAPPED_BACKUP_VAULT | RESTORE_ACCESS_BACKUP_VAULT` ## Errori Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md). ** 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: + [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/DescribeBackupVault) + [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/DescribeBackupVault) + [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/DescribeBackupVault) + [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/DescribeBackupVault) + [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/DescribeBackupVault) + [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/DescribeBackupVault) + [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/DescribeBackupVault) + [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/DescribeBackupVault) + [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/DescribeBackupVault) + [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/DescribeBackupVault)