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:

URI

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

Tabla 1 Parámetros de URI

Parámetro

Obligatorio

Tipo

Descripción

project_id

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

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

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

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"
    }

Ejemplo de la respuesta

Código de estado: 200

Operación exitosa.

{
  "encryption_status" : "on"
}

Código de estado

Para más detalles, véase Códigos de estado.

Código de error

Para más detalles, véase Códigos de error.