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à.
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
-
L'ID dell'account del vault di backup specificato.
- 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.
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
{
"BackupVaultArn": "string",
"BackupVaultName": "string",
"CreationDate": number,
"CreatorRequestId": "string",
"EncryptionKeyArn": "string",
"LockDate": number,
"Locked": boolean,
"MaxRetentionDays": number,
"MinRetentionDays": number,
"NumberOfRecoveryPoints": number,
"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
-
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: 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 in cui sono stati creati.
Tipo: stringa
- CreationDate
-
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
-
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 '-_'. punti (.).
Tipo: stringa
- EncryptionKeyArn
-
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: stringa
- LockDate
-
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
-
Un valore booleano che indica se AWS Backup Vault Lock sta attualmente proteggendo l'archivio di backup.
Truesignifica che Vault Lock causa il fallimento delle operazioni di eliminazione o aggiornamento sui punti di ripristino archiviati nel vault.Tipo: Booleano
- MaxRetentionDays
-
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
-
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
- NumberOfRecoveryPoints
-
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. Utilizza l'
ListRecoveryPointsByBackupVaultAPI per ottenere il conteggio esatto.Tipo: long
- VaultState
-
Lo stato attuale del vault. ->
Tipo: stringa
Valori validi:
CREATING | AVAILABLE | FAILED - VaultType
-
Il tipo di deposito descritto.
Tipo: stringa
Valori validi:
BACKUP_VAULT | LOGICALLY_AIR_GAPPED_BACKUP_VAULT
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.
Codice di stato HTTP: 400
- MissingParameterValueException
-
Indica che manca un parametro obbligatorio.
Codice di stato HTTP: 400
- ResourceNotFoundException
-
Una risorsa necessaria per l'azione non esiste.
Codice di stato HTTP: 400
- ServiceUnavailableException
-
La richiesta non è riuscita a causa di un errore temporaneo del server.
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:
