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.
CreateLogicallyAirGappedBackupVault
Crea un contenedor lógico en el que se pueden copiar las copias de seguridad.
Esta solicitud incluye un nombre, la región, el número máximo de días de retención y el número mínimo de días de retención y, opcionalmente, puede incluir etiquetas y un identificador de solicitud del creador.
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 /logically-air-gapped-backup-vaults/backupVaultName HTTP/1.1
Content-type: application/json
{
"BackupVaultTags": {
"string" : "string"
},
"CreatorRequestId": "string",
"MaxRetentionDays": number,
"MinRetentionDays": number
}Parámetros de solicitud del URI
La solicitud utiliza los siguientes parámetros URI.
- backupVaultName
-
El nombre de un contenedor lógico donde se almacenan las copias de seguridad. Los almacenes de copia de seguridad independientes lógicamente se identifican con nombres que son exclusivos de la cuenta usada para crearlos y de la región en la que se crearon.
Patrón:
^[a-zA-Z0-9\-\_]{2,50}$Obligatorio: sí
Cuerpo de la solicitud
La solicitud acepta los siguientes datos en formato JSON.
- BackupVaultTags
-
Las etiquetas que se van a asignar al almacén.
Tipo: mapa de cadena a cadena
Obligatorio: no
- CreatorRequestId
-
El ID de la solicitud de creación.
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
- MaxRetentionDays
-
El período máximo de retención durante el que el almacén conserva sus puntos de recuperación. Si no se especifica este parámetro, AWS Backup no impone un periodo de retención máximo en los puntos de recuperación del almacén (lo que permite un almacenamiento indefinido).
Si se especifica, cualquier trabajo de copia de seguridad o copia en el almacén debe tener una política de ciclo de vida con un periodo de retención igual o inferior al periodo de retención máximo. Si el periodo de retención del trabajo es más largo que ese periodo de retención máximo, el almacén no podrá realizar el trabajo de copia de seguridad o de copia, y deberá modificar la configuración del ciclo de vida o utilizar un almacén diferente.
Tipo: largo
Obligatorio: sí
- MinRetentionDays
-
Esta configuración especifica el periodo mínimo de retención durante el cual el almacén retiene sus puntos de recuperación. Si no se especifica este parámetro, no se impondrá un periodo mínimo de retención.
Si se especifica, cualquier trabajo de copia de seguridad o copia en el almacén debe tener una política de ciclo de vida con un periodo de retención igual o superior al periodo de retención mínimo. Si el periodo de retención del trabajo es más corto que ese periodo de retención mínimo, el almacén no podrá realizar ese trabajo de copia de seguridad o de copia, y deberá modificar la configuración del ciclo de vida o utilizar un almacén diferente.
Tipo: largo
Obligatorio: sí
Sintaxis de la respuesta
HTTP/1.1 200
Content-type: application/json
{
"BackupVaultArn": "string",
"BackupVaultName": "string",
"CreationDate": number,
"VaultState": "string"
}Elementos de respuesta
Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.
El servicio devuelve los datos siguientes en formato JSON.
- BackupVaultArn
-
El ARN (Amazon Resource Name) del almacén.
Tipo: cadena
- BackupVaultName
-
El nombre de un contenedor lógico donde se almacenan las copias de seguridad. Los almacenes de copia de seguridad independientes lógicamente se identifican con nombres que son exclusivos de la cuenta usada para crearlos y de la región en la que se crearon.
Tipo: String
Patrón:
^[a-zA-Z0-9\-\_]{2,50}$ - CreationDate
-
Fecha y hora en que se creó el almacén.
Este valor está en formato Unix, horario universal coordinado (UTC) y tiene 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
- VaultState
-
El estado actual del almacén.
Tipo: cadena
Valores válidos:
CREATING | AVAILABLE | FAILED
Errores
Para obtener información acerca de los errores comunes a todas las acciones, consulte Errores comunes.
- AlreadyExistsException
-
El recurso ya existe.
Código de estado HTTP: 400
- InvalidParameterValueException
-
Indica que hay algún problema con el valor de un parámetro. Por ejemplo, el valor está fuera del rango.
Código de estado HTTP: 400
- InvalidRequestException
-
Indica que hay algún problema con la entrada de la solicitud. Por ejemplo, un parámetro es del tipo incorrecto.
Código de estado HTTP: 400
- LimitExceededException
-
Se ha superado un límite en la solicitud; por ejemplo, el número máximo de elementos permitidos en una solicitud.
Código de estado HTTP: 400
- MissingParameterValueException
-
Indica que falta un parámetro obligatorio.
Código de estado HTTP: 400
- ServiceUnavailableException
-
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.
Código de estado HTTP: 500
Véase también
Para obtener más información sobre el uso de esta API en uno de los AWS SDK específicos del idioma, consulta lo siguiente:
