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. # DescribeBackupVault Devuelve los metadatos de un almacén de copias de seguridad especificado por su nombre. ## Sintaxis de la solicitud ``` GET /backup-vaults/backupVaultName?backupVaultAccountId=BackupVaultAccountId HTTP/1.1 ``` ## Parámetros de solicitud del URI La solicitud utiliza los siguientes parámetros URI. ** [BackupVaultAccountId](#API_DescribeBackupVault_RequestSyntax) ** El identificador de cuenta del almacén de copias de seguridad especificado. ** [backupVaultName](#API_DescribeBackupVault_RequestSyntax) ** El nombre de un contenedor lógico donde se almacenan las copias de seguridad. Los almacenes de copias 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. Obligatorio: sí ## Cuerpo de la solicitud La solicitud no tiene un cuerpo de la solicitud. ## Sintaxis de la respuesta ``` HTTP/1.1 200 Content-type: application/json { "BackupVaultArn": "string", "BackupVaultName": "string", "CreationDate": number, "CreatorRequestId": "string", "EncryptionKeyArn": "string", "EncryptionKeyType": "string", "LatestMpaApprovalTeamUpdate": { "ExpiryDate": number, "InitiationDate": number, "MpaSessionArn": "string", "Status": "string", "StatusMessage": "string" }, "LockDate": number, "Locked": boolean, "MaxRetentionDays": number, "MinRetentionDays": number, "MpaApprovalTeamArn": "string", "MpaSessionArn": "string", "NumberOfRecoveryPoints": number, "SourceBackupVaultArn": "string", "VaultState": "string", "VaultType": "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](#API_DescribeBackupVault_ResponseSyntax) ** Un nombre de recurso de Amazon (ARN) que identifica de forma exclusiva un almacén de copia de seguridad; por ejemplo, `arn:aws:backup:us-east-1:123456789012:backup-vault:aBackupVault`. Tipo: cadena ** [BackupVaultName](#API_DescribeBackupVault_ResponseSyntax) ** El nombre de un contenedor lógico donde se almacenan las copias de seguridad. Los almacenes de copias de seguridad se identifican con nombres que son exclusivos de la cuenta usada para crearlos y de la región donde se crearon. Tipo: cadena ** [CreationDate](#API_DescribeBackupVault_ResponseSyntax) ** La fecha y la hora en que se creó el almacén, en formato Unix y horario universal coordinado (UTC). El valor de `CreationDate` 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 ** [CreatorRequestId](#API_DescribeBackupVault_ResponseSyntax) ** 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 “-\$1”. caracteres. Tipo: cadena ** [EncryptionKeyArn](#API_DescribeBackupVault_ResponseSyntax) ** 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 ** [EncryptionKeyType](#API_DescribeBackupVault_ResponseSyntax) ** El tipo de clave de cifrado utilizada para el almacén de copias de seguridad. Los valores válidos son CUSTOMER\$1MANAGED\$1KMS\$1KEY para las claves gestionadas por el cliente o \$1OWNED\$1KMS\$1KEY para las claves propias. AWS AWS Tipo: cadena Valores válidos: `AWS_OWNED_KMS_KEY | CUSTOMER_MANAGED_KMS_KEY` ** [LatestMpaApprovalTeamUpdate](#API_DescribeBackupVault_ResponseSyntax) ** Información sobre la última actualización de la asociación del equipo de aprobación MPA para este almacén de copias de seguridad. Tipo: objeto [LatestMpaApprovalTeamUpdate](API_LatestMpaApprovalTeamUpdate.md) ** [LockDate](#API_DescribeBackupVault_ResponseSyntax) ** La fecha y la hora en las que no se AWS Backup puede cambiar ni eliminar la configuración de Vault Lock. Si ha aplicado el bloqueo de almacenes a su almacén sin especificar una fecha de bloqueo, puede cambiar cualquier configuración del bloqueo de almacenes o eliminarlo del almacén por completo en cualquier momento. 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 ** [Locked](#API_DescribeBackupVault_ResponseSyntax) ** Un valor booleano que indica si AWS Backup Vault Lock protege actualmente el almacén de respaldo. `True`significa que Vault Lock provoca un error en las operaciones de eliminación o actualización de los puntos de recuperación almacenados en el almacén. Tipo: Booleano ** [MaxRetentionDays](#API_DescribeBackupVault_ResponseSyntax) ** La configuración de bloqueo del AWS Backup almacén que especifica 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, el bloqueo de almacenes 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 superior a ese periodo de retención máximo, el almacén falla el trabajo de copia de seguridad o de copia de seguridad, y deberá modificar la configuración del ciclo de vida o utilizar un almacén diferente. Los puntos de recuperación ya almacenados en el almacén antes del bloqueo del mismo no se ven afectados. Tipo: largo ** [MinRetentionDays](#API_DescribeBackupVault_ResponseSyntax) ** La configuración de bloqueo del AWS Backup almacén que especifica el período mínimo de retención durante el que el almacén conserva sus puntos de recuperación. Si no se especifica este parámetro, el bloqueo del almacén no 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 breve que ese periodo de retención mínimo, el almacén dará error en el trabajo de copia de seguridad o copia, y deberá modificar la configuración del ciclo de vida o usar un almacén diferente. Los puntos de recuperación ya almacenados en el almacén antes del bloqueo del mismo no se ven afectados. Tipo: largo ** [MpaApprovalTeamArn](#API_DescribeBackupVault_ResponseSyntax) ** Es el ARN del equipo de aprobación MPA asociado con este almacén de copias de seguridad. Tipo: cadena ** [MpaSessionArn](#API_DescribeBackupVault_ResponseSyntax) ** Es el ARN de la sesión de MPA asociado con este almacén de copias de seguridad. Tipo: cadena ** [NumberOfRecoveryPoints](#API_DescribeBackupVault_ResponseSyntax) ** El número de puntos de recuperación que se almacenan en un almacén de copias de seguridad. El valor del recuento de puntos de recuperación que se muestra en la consola puede ser una aproximación. Utilice la API [https://docs.aws.amazon.com/aws-backup/latest/devguide/API_ListRecoveryPointsByBackupVault.html](https://docs.aws.amazon.com/aws-backup/latest/devguide/API_ListRecoveryPointsByBackupVault.html) para obtener el recuento exacto. Tipo: largo ** [SourceBackupVaultArn](#API_DescribeBackupVault_ResponseSyntax) ** Es el ARN del almacén de copias de seguridad de origen a partir del cual se ha creado este almacén de copias de seguridad con acceso a la restauración. Tipo: cadena ** [VaultState](#API_DescribeBackupVault_ResponseSyntax) ** El estado actual del almacén.-> Tipo: cadena Valores válidos: `CREATING | AVAILABLE | FAILED` ** [VaultType](#API_DescribeBackupVault_ResponseSyntax) ** El tipo de almacén descrito. Tipo: cadena Valores válidos: `BACKUP_VAULT | LOGICALLY_AIR_GAPPED_BACKUP_VAULT | RESTORE_ACCESS_BACKUP_VAULT` ## Errores Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md). ** InvalidParameterValueException ** Indica que hay algún problema con el valor de un parámetro. Por ejemplo, el valor está fuera del rango. ** Context ** ** Type ** Código de estado HTTP: 400 ** MissingParameterValueException ** Indica que falta un parámetro obligatorio. ** Context ** ** Type ** Código de estado HTTP: 400 ** ResourceNotFoundException ** No existe un recurso necesario para la acción. ** Context ** ** Type ** Código de estado HTTP: 400 ** ServiceUnavailableException ** La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor. ** Context ** ** Type ** 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 idiomas específicos AWS SDKs, consulta lo siguiente: + [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/DescribeBackupVault) + [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/DescribeBackupVault) + [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/DescribeBackupVault) + [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/DescribeBackupVault) + [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/DescribeBackupVault) + [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/DescribeBackupVault) + [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/DescribeBackupVault) + [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/DescribeBackupVault) + [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/DescribeBackupVault) + [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/DescribeBackupVault)