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

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