Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
CreateBackupVault
Crea un contenedor lógico donde se almacenan las copias de seguridad. Una solicitud CreateBackupVault incluye un nombre, opcionalmente una o varias etiquetas de recursos, una clave de cifrado y un ID de solicitud.
nota
No incluya datos confidenciales, como los números de pasaporte, en el nombre de un almacén de copia de seguridad.
Sintaxis de la solicitud
PUT /backup-vaults/backupVaultName HTTP/1.1
Content-type: application/json
{
"BackupVaultTags": {
"string" : "string"
},
"CreatorRequestId": "string",
"EncryptionKeyArn": "string"
}URIParámetros de solicitud
La solicitud utiliza los siguientes URI parámetros.
- backupVaultName
-
El nombre de un contenedor lógico donde se almacenan las copias de seguridad. Los almacenes de copia de seguridad se identifican con nombres que son exclusivos de la cuenta usada para crearlos y de la región de AWS donde se crearon. Constan de letras minúsculas, números y guiones.
Patrón:
^[a-zA-Z0-9\-\_]{2,50}$Obligatorio: sí
Cuerpo de la solicitud
La solicitud acepta los siguientes datos en JSON formato.
- BackupVaultTags
-
Las etiquetas que se van a asignar a la bóveda de respaldo.
Tipo: mapa de cadena a cadena
Obligatorio: no
- CreatorRequestId
-
Una cadena única que identifica la solicitud y permite que se reintenten las solicitudes que han producido un error sin el riesgo de ejecutar la operación dos veces. Este parámetro es opcional.
Si se utiliza, este parámetro debe contener de 1 a 50 caracteres alfanuméricos o “-_”. caracteres.
Tipo: cadena
Requerido: no
- EncryptionKeyArn
-
La clave de cifrado en el servidor que se utiliza para proteger sus copias de seguridad; por ejemplo,
arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab.Tipo: cadena
Requerido: no
Sintaxis de la respuesta
HTTP/1.1 200
Content-type: application/json
{
"BackupVaultArn": "string",
"BackupVaultName": "string",
"CreationDate": number
}Elementos de respuesta
Si la acción se realiza correctamente, el servicio devuelve una respuesta de HTTP 200.
El servicio devuelve los siguientes datos en JSON formato.
- BackupVaultArn
-
Un nombre de recurso de Amazon (ARN) que identifica de forma exclusiva un almacén de copias de seguridad; por ejemplo,
arn:aws:backup:us-east-1:123456789012:backup-vault:aBackupVault.Tipo: cadena
- BackupVaultName
-
El nombre de un contenedor lógico donde se almacenan las copias de seguridad. Los almacenes de copia de seguridad se identifican con nombres que son exclusivos de la cuenta usada para crearlos y de la región de donde se crearon. Constan de letras minúsculas, números y guiones.
Tipo: cadena
Patrón:
^[a-zA-Z0-9\-\_]{2,50}$ - CreationDate
-
La fecha y la hora en que se crea un almacén de copias de seguridad, en formato Unix y en hora universal coordinada (UTC). El valor de
CreationDatetiene una precisión de milisegundos. Por ejemplo, el valor 1516925490.087 representa el viernes 26 de enero de 2018 a las 12:11:30.087 h.Tipo: marca temporal
Errores
Para obtener información acerca de los errores comunes a todas las acciones, consulte Errores comunes.
- AlreadyExistsException
-
El recurso ya existe.
HTTPCódigo de estado: 400
- InvalidParameterValueException
-
Indica que hay algún problema con el valor de un parámetro. Por ejemplo, el valor está fuera del rango.
HTTPCódigo de estado: 400
- LimitExceededException
-
Se ha superado un límite en la solicitud; por ejemplo, el número máximo de elementos permitidos en una solicitud.
HTTPCódigo de estado: 400
- MissingParameterValueException
-
Indica que falta un parámetro obligatorio.
HTTPCódigo de estado: 400
- ServiceUnavailableException
-
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.
HTTPCódigo de estado: 500
Véase también
Para obtener más información sobre cómo usarlo API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
