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à.
CreateLogicallyAirGappedBackupVault
Crea un contenitore logico in cui è possibile copiare i backup.
Questa richiesta include un nome, la regione, il numero massimo di giorni di conservazione, il numero minimo di giorni di conservazione e, facoltativamente, può includere tag e un ID richiesta dell'autore.
Nota
Non includere i dati riservati, ad esempio i numeri di passaporto, nel nome di un vault di backup.
Sintassi della richiesta
PUT /logically-air-gapped-backup-vaults/backupVaultName HTTP/1.1
Content-type: application/json
{
"BackupVaultTags": {
"string" : "string"
},
"CreatorRequestId": "string",
"EncryptionKeyArn": "string",
"MaxRetentionDays": number,
"MinRetentionDays": number
}Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
- backupVaultName
-
Il nome di un container logico in cui vengono archiviati i backup. I vault di backup con isolamento logico air gap sono identificati da nomi univoci per l'account utilizzato per crearli e per la regione in cui sono stati creati.
Modello:
^[a-zA-Z0-9\-\_]{2,50}$Obbligatorio: sì
Corpo della richiesta
La richiesta accetta i seguenti dati in formato JSON.
- BackupVaultTags
-
I tag da assegnare al vault.
Tipo: mappatura stringa a stringa
Obbligatorio: no
- CreatorRequestId
-
L'ID della richiesta di creazione.
Questo parametro è facoltativo. Se utilizzato, questo parametro deve contenere da 1 a 50 caratteri alfanumerici o '-_'. punti (.).
▬Tipo: stringa
Obbligatorio: no
- EncryptionKeyArn
-
L'ARN della chiave KMS gestita dal cliente da utilizzare per crittografare il vault di backup logicamente isolato. Se non specificato, il vault verrà crittografato con una chiave di AWS proprietà gestita da Backup AWS .
▬Tipo: stringa
Obbligatorio: no
- MaxRetentionDays
-
Il periodo di conservazione massimo durante il quale il vault conserva i propri punti di ripristino.
Tipo: long
Obbligatorio: sì
- MinRetentionDays
-
Questa impostazione specifica il periodo di conservazione minimo durante il quale il vault mantiene i punti di ripristino.
Il valore minimo accettato è 7 giorni.
Tipo: long
Obbligatorio: sì
Sintassi della risposta
HTTP/1.1 200
Content-type: application/json
{
"BackupVaultArn": "string",
"BackupVaultName": "string",
"CreationDate": number,
"VaultState": "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
-
L'ARN (Amazon Resource Name) del vault.
Tipo: String
- BackupVaultName
-
Il nome di un container logico in cui vengono archiviati i backup. I vault di backup con isolamento logico air gap sono identificati da nomi univoci per l'account utilizzato per crearli e per la regione in cui sono stati creati.
Tipo: stringa
Modello:
^[a-zA-Z0-9\-\_]{2,50}$ - CreationDate
-
La data e l'ora di creazione del vault.
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
- VaultState
-
Lo stato attuale del vault.
Tipo: String
Valori validi:
CREATING | AVAILABLE | FAILED
Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare Errori comuni.
- AlreadyExistsException
-
La risorsa richiesta esiste già.
- Arn
- Context
- CreatorRequestId
- Type
Codice di stato HTTP: 400
- 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
- InvalidRequestException
-
Indica che si è verificato un errore nell'input alla richiesta. Ad esempio, un parametro è del tipo errato.
- Context
- Type
Codice di stato HTTP: 400
- LimitExceededException
-
È stato superato un limite nella richiesta, ad esempio il numero massimo di elementi consentiti in una richiesta.
- Context
- Type
Codice di stato HTTP: 400
- MissingParameterValueException
-
Indica che manca un parametro obbligatorio.
- 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:
