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
Questa richiesta crea un container 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",
"MaxRetentionDays": number,
"MinRetentionDays": number
}Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
- backupVaultName
-
Questo è il nome del vault che viene creato.
Modello:
^[a-zA-Z0-9\-\_]{2,50}$Campo obbligatorio: sì
Corpo della richiesta
La richiesta accetta i seguenti dati in formato JSON.
- BackupVaultTags
-
Questi sono i tag che verranno inclusi nel vault appena creato.
Tipo: mappatura stringa a stringa
Campo obbligatorio: no
- CreatorRequestId
-
Questo è 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
Campo obbligatorio: no
- MaxRetentionDays
-
Questa è l'impostazione che specifica il periodo di conservazione massimo durante il quale il vault conserva i punti di ripristino. Se questo parametro non è specificato, AWS Backup 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.
Tipo: long
Campo obbligatorio: sì
- MinRetentionDays
-
Questa impostazione specifica il periodo di conservazione minimo durante il quale il vault mantiene i punti di ripristino. Se questo parametro non è specificato, non viene applicato alcun 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.
Tipo: long
Campo 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
-
Questo è l'ARN (Amazon Resource Name) del vault che viene creato.
▬Tipo: stringa
- 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. Consistono di minuscole, numeri e trattini.
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
-
Questo è lo stato corrente del vault.
▬Tipo: stringa
Valori validi:
CREATING | AVAILABLE | FAILED
Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare Errori comuni.
- AlreadyExistsException
-
La risorsa richiesta esiste già.
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.
Codice di stato HTTP: 400
- InvalidRequestException
-
Indica che si è verificato un errore nell'input alla richiesta. Ad esempio, un parametro è del tipo errato.
Codice di stato HTTP: 400
- LimitExceededException
-
È stato superato un limite nella richiesta, ad esempio il numero massimo di elementi consentiti in una richiesta.
Codice di stato HTTP: 400
- MissingParameterValueException
-
Indica che manca un parametro obbligatorio.
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 uno degli AWS SDK specifici della lingua, consulta quanto segue:
