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à.
CreateBackupVault
Crea un container logico in cui vengono archiviati i backup. Una richiesta CreateBackupVault include un nome, facoltativamente uno o più tag delle risorse, una chiave di crittografia e un ID della richiesta.
Nota
Non includere i dati riservati, ad esempio i numeri di passaporto, nel nome di un vault di backup.
Sintassi della richiesta
PUT /backup-vaults/backupVaultName HTTP/1.1
Content-type: application/json
{
"BackupVaultTags": {
"string" : "string"
},
"CreatorRequestId": "string",
"EncryptionKeyArn": "string"
}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 sono identificati da nomi univoci per l'account utilizzato per crearli e per la Regione AWS in cui sono stati creati. Consistono in lettere, numeri e trattini.
Modello:
^[a-zA-Z0-9\-\_]{2,50}$Campo obbligatorio: sì
Corpo della richiesta
La richiesta accetta i seguenti dati in formato JSON.
- BackupVaultTags
-
I tag da assegnare al vault di backup.
Tipo: mappatura stringa a stringa
Campo obbligatorio: no
- 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
Campo obbligatorio: no
- 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
Campo obbligatorio: no
Sintassi della risposta
HTTP/1.1 200
Content-type: application/json
{
"BackupVaultArn": "string",
"BackupVaultName": "string",
"CreationDate": number
}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. Consistono di minuscole, numeri e trattini.
Tipo: stringa
Modello:
^[a-zA-Z0-9\-\_]{2,50}$ - 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
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
- 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:
