Este conteúdo foi traduzido por máquina para sua conveniência e a Huawei Cloud não pode garantir que o conteúdo foi traduzido com precisão. Para exibir o conteúdo original, use o link no canto superior direito para mudar para a página em inglês.

Central de ajuda/TaurusDB/Referência de API/APIs (recomendadas)/Gerenciamento de backup/Ativação ou desativação do backup criptografado

Atualizado em 2025-05-23 GMT+08:00

Ativação ou desativação do backup criptografado

Função

Essa API é usada para ativar ou desativar o backup criptografado. Antes de chamar essa API:

Saiba como autorizá-la e autenticá-la.
Obtenha a região e o ponto de extremidade necessários.

URI

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

**Tabela 1** Parâmetros de URI
Parâmetro	Obrigatório	Tipo	Descrição
project_id	Sim	String	ID do projeto de um locatário numa região. Para obter esse valor, consulte Obtenção de um ID de projeto.
instance_id	Sim	String	ID da instância, que é compatível com o formato UUID.

Parâmetros de solicitação

**Tabela 2** Parâmetros de cabeçalho de solicitação
Parâmetro	Obrigatório	Tipo	Descrição
X-Auth-Token	Sim	String	Token do usuário. Para obter esse valor, chame a API do IAM para obter um token de usuário. O valor de X-Subject-Token no cabeçalho da resposta é o valor do token.
X-Language	Não	String	Tipo de linguagem da solicitação. O valor padrão é en-us. Valores: en-us zh-cn

**Tabela 3** Parâmetros do corpo da solicitação
Parâmetro	Obrigatório	Tipo	Descrição
encryption_status	Sim	String	Se deve ativar ou desativar o backup criptografado. Valor (sem distinção entre maiúsculas e minúsculas): on: ativado off: desativado
type	Não	String	Tipo de criptografia. Atualmente, somente kms (sem distinção entre maiúsculas e minúsculas) é suportado. Esse parâmetro é obrigatório quando o backup criptografado está ativado e não é necessário quando o backup criptografado está desativado.
kms_key_id	Não	String	ID do KMS. Esse parâmetro é obrigatório quando o backup criptografado está ativado e não é necessário quando o backup criptografado está desativado. Para obter o valor, consulte o parâmetro de resposta key_id na API para criação de uma chave.

Parâmetros de resposta

Código de status: 200

**Tabela 4** Parâmetros do corpo de resposta
Parâmetro	Tipo	Descrição
encryption_status	String	Se o backup criptografado está ativado ou desativado. Valores: on: o backup criptografado está ativado off: o backup criptografado está desativado.

Código de status: 400

**Tabela 5** Parâmetros do corpo de resposta
Parâmetro	Tipo	Descrição
error_code	String	Código de erro.
error_msg	String	Mensagem de erro.

Código de status: 500

**Tabela 6** Parâmetros do corpo de resposta
Parâmetro	Tipo	Descrição
error_code	String	Código de erro.
error_msg	String	Mensagem de erro.

Exemplo de solicitação

Ativação de backup criptografado

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

Desativação de backup criptografado

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