Redefinição da senha do BMS com alguns cliques
Função
Esta API é usada para redefinir a senha da conta de gerenciamento do BMS (root ou Administrator) quando a redefinição de senha com um clique é suportada.
Você pode usar a API de Consulta sobre se a redefinição de senha com um clique é suportada para verificar se a redefinição de senha com um clique é suportada.
Restrições
- Não há verificação de complexidade de senha que atenda aos requisitos de segurança. Nenhuma mensagem de erro é exibida depois que uma senha não segura é inserida.
- Antes de usar essa API, você deve instalar plug-ins de redefinição de senha. Para obter detalhes sobre como baixar e instalar os plug-ins de redefinição de senha, consulte Instalação do plug-in de redefinição de senha com um clique em Guia de usuário do Bare Metal Server.
- Se a função de redefinição de senha não entrar em vigor, essa API não relatará um erro.
- Uma nova senha entra em vigor depois que o BMS é iniciado ou reiniciado.
URI
PUT /v1/{project_id}/baremetalservers/{server_id}/os-reset-password
A Tabela 1 lista os parâmetros.
Parâmetro |
Obrigatório |
Descrição |
---|---|---|
project_id |
Sim |
Especifica o ID do projeto. Para obter detalhes de como conseguir o ID de domínio, consulte Obtenção de um ID de projeto. |
server_id |
Sim |
Especifica o ID do BMS. Você pode obter o ID do BMS no console do BMS ou usando a API do Consulta de BMSs (API OpenStack nativo). |
Solicitação
- Parâmetros de solicitação
Parâmetro
Obrigatório
Tipo
Descrição
reset-password
Sim
Object
Fornece detalhes de redefinição de senha. Para mais detalhes, consulte Tabela 2.
Tabela 2 Descrição da estrutura de dados do campo reset-password Parâmetro
Obrigatório
Tipo
Descrição
new_password
Sim
String
Especifica a nova senha do BMS.
Esta API não verifica a segurança da senha. Verifique se a complexidade da senha está em conformidade com as regras de senha.
A senha deve obedecer às seguintes regras:
- Consiste de 8 a 26 caracteres.
- Contém pelo menos três dos seguintes tipos de caracteres:
- Não pode conter o nome de usuário ou o nome de usuário ao contrário.
- Não pode conter mais de dois caracteres na mesma sequência que aparecem no nome de usuário. (Este requisito aplica-se apenas aos BMSs do Windows.)
- Exemplo de solicitação
1
PUT https://{BMS Endpoint}/v1/2e62dec99940499d93717c2789759015/baremetalservers/77616c78-0bc4-4156-b24b-4286586ac350/os-reset-password
1 2 3 4 5
{ "reset-password": { "new_password": "Fusion@123" } }
Resposta
N/D
Valores retornados
Valor retornado |
Descrição |
---|---|
204 |
O servidor processou a solicitação, mas não retornou nenhum conteúdo. |
Para obter detalhes sobre outros valores retornados, consulte Códigos de status.
Códigos de erro
Consulte Códigos de erro.