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/Distributed Cache Service/Referência de API/API V2/Gerenciamento de instância/Alteração de senha
Atualizado em 2022-11-09 GMT+08:00
Ver PDF
Compartilhar

Alteração de senha

Função

Essa API é usada para alterar a senha de uma instância do DCS.

URI

PUT /v2/{project_id}/instances/{instance_id}/password

Tabela 1 Parâmetros de caminho

Parâmetro

Obrigatório

Tipo

Descrição

instance_id

Sim

String

ID da instância.

project_id

Sim

String

ID do projeto.

Parâmetros de solicitação

Tabela 2 Parâmetros do corpo da solicitação

Parâmetro

Obrigatório

Tipo

Descrição

old_password

Não

String

Senha antiga.

new_password

Não

String

Nova senha.

Parâmetros de resposta

Código de estado: 200

Tabela 3 Parâmetros do corpo de resposta

Parâmetro

Tipo

Descrição

lock_time

String

Duração do bloqueio. Se a autenticação de senha falhar e a conta estiver bloqueada, o valor desse parâmetro não será null.

result

String

Resultado da alteração da senha:

  • success: A senha foi alterada com sucesso.
  • passwordFailed: Falha na autenticação por palavra-passe.
  • locked: A conta foi bloqueada.
  • failed: Falha na alteração da senha.

Valores de enumeração:

  • success
  • passwordFailed
  • locked
  • failed

lock_time_left

String

Tempo restante antes da conta ser desbloqueada. Quando a conta está bloqueada, o valor deste parâmetro não é null.

retry_times_left

String

Número de tentativas de senha restantes. Se a autenticação de senha falhar, uma resposta será retornada e não será null.

message

String

Descrição do resultado da modificação.

Código de estado: 400

Tabela 4 Parâmetros do corpo de resposta

Parâmetro

Tipo

Descrição

error_msg

String

Mensagem de erro.

Máximo: 1024

error_code

String

Código de erro.

Máximo: 9

error_ext_msg

String

Informações de erro estendidas. Este parâmetro não é usado atualmente e está definido como nulo.

Máximo: 1024

Código de estado: 500

Tabela 5 Parâmetros do corpo de resposta

Parâmetro

Tipo

Descrição

error_msg

String

Mensagem de erro.

Máximo: 1024

error_code

String

Código de erro.

Máximo: 9

error_ext_msg

String

Informações de erro estendidas. Este parâmetro não é usado atualmente e está definido como nulo.

Máximo: 1024

Exemplos de solicitações

PUT https://{dcs_endpoint}/v2/{project_id}/instances/{instance_id}/password

{
  "old_password" : "XXXXXX",
  "new_password" : "XXXXXX"
}

Exemplo de respostas

Código de estado: 200

A senha foi alterada com sucesso.

{
  "lock_time" : "0",
  "result" : "success",
  "lock_time_left" : "0",
  "retry_times_left" : "5",
  "message" : "Modify DCSInstance password success."
}

Códigos de status

Código de status

Descrição

200

A senha foi alterada com sucesso.

400

Pedido inválido.

500

Erro de serviço interno.

Códigos de erro

Consulte Códigos de erro.

Tópico principal:Gerenciamento de instância