Estos contenidos se han traducido de forma automática para su comodidad, pero Huawei Cloud no garantiza la exactitud de estos. Para consultar los contenidos originales, acceda a la versión en inglés.

Centro de ayuda/TaurusDB/Referencia de la API/Las API (recomendadas)/Gestión de copias de respaldo/Activación o desactivación de la copia de respaldo encriptada

Actualización más reciente 2025-03-21 GMT+08:00

Activación o desactivación de la copia de respaldo encriptada

Función

Esta API se utiliza para habilitar o deshabilitar la copia de respaldo encriptada. Antes de invocar a esta API:

Aprender cómo autorizar y autenticarla.
Obtenga la región y el punto de conexión requeridos.

URI

POST /v3/{project_id}/instances/{instance_id}/backups/encryption

**Tabla 1** Parámetros de URI
Parámetro	Obligatorio	Tipo	Descripción
project_id	Sí	String	ID de proyecto de un tenant en una región. Para obtener este valor, consulte Obtención de un ID de proyecto.
instance_id	Sí	String	ID de instancia, que es compatible con el formato UUID.

Parámetros de solicitud

**Tabla 2** Parámetros de encabezado de solicitud
Parámetro	Obligatorio	Tipo	Descripción
X-Auth-Token	Sí	String	Token de usuario. Para obtener este valor, invoque a la API de IAM para obtener un token de usuario. El valor de X-Subject-Token en el encabezado de respuesta es el valor del token.
X-Language	No	String	Tipo de idioma de solicitud. El valor predeterminado es en-us. Valores: en-us zh-cn

**Tabla 3** Parámetros del cuerpo de solicitud
Parámetro	Obligatorio	Tipo	Descripción
encryption_status	Sí	String	Si se debe habilitar o deshabilitar la copia de respaldo encriptada. Valor (sin distinción entre mayúsculas y minúsculas): on: habilitado off: deshabilitado
type	No	String	Tipo de encriptación. Actualmente, solo se admite kms (sin distinción entre mayúsculas y minúsculas). Este parámetro es obligatorio cuando la copia de respaldo encriptado está habilitado y no es necesario cuando la copia de respaldo encriptado está deshabilitado.
kms_key_id	No	String	ID de KMS. Este parámetro es obligatorio cuando la copia de respaldo encriptado está habilitado y no es necesario cuando la copia de respaldo encriptado está deshabilitado. Para obtener el valor, véase el parámetro de respuesta key_id en la API para la creación de una clave.

Parámetros de respuesta

Código de estado: 200

**Tabla 4** Parámetros del cuerpo de respuesta
Parámetro	Tipo	Descripción
encryption_status	String	Si la copia de respaldo encriptada está habilitada o deshabilitada. Valores: on: La copia de respaldo encriptada está activada. off: La copia de respaldo encriptada está deshabilitada.

Código de estado: 400

**Tabla 5** Parámetros del cuerpo de respuesta
Parámetro	Tipo	Descripción
error_code	String	Código de error.
error_msg	String	Mensaje de error.

Código de estado: 500

**Tabla 6** Parámetros del cuerpo de respuesta
Parámetro	Tipo	Descripción
error_code	String	Código de error.
error_msg	String	Mensaje de error.

Ejemplo de la solicitud

Habilitación de copia de respaldo encriptada

POST https://{endpoint}/v3/619d3e78f61b4be68bc5aa0b59edcf7b/instances/7033e7c3cf93438797d44ad7ae0a7d95in07/backups/encryption
{
  "type" : "kms",
  "kms_key_id" : "b82fa43f-f6e8-4ec4-9c31-231bc547c526",
  "encryption_status" : "on"
}

Desactivación de copia de respaldo encriptada

POST https://{endpoint}/v3/619d3e78f61b4be68bc5aa0b59edcf7b/instances/7033e7c3cf93438797d44ad7ae0a7d95in07/backups/encryption
{
  "encryption_status" : "off"
}