Modificação de informações do usuário
Função
Essa API é fornecida para que o administrador modifique as informações do usuário do IAM.
A API pode ser chamada usando o ponto de extremidade global e pontos de extremidade da região específica. Para pontos de extremidade do IAM, consulte Regiões e pontos de extremidade.
Restrições
Essa API não pode ser usada para alterar o número de celular e o endereço de e-mail de um usuário do IAM. Para alterar o número do celular e o endereço de e-mail, use a API descrita em Modificação das informações do usuário do IAM (recomendado).
URI
PATCH /v3/users/{user_id}
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
| user_id | Sim | String | ID do usuário do IAM. Para obter detalhes sobre como obter um ID de usuário, consulte Obtenção de informações sobre conta, usuário do IAM, grupo, projeto, região e agência. |
Parâmetros de solicitação
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
| Content-Type | Sim | String | Preencha application/json;charset=utf8 nesse campo. |
| X-Auth-Token | Sim | String | Token de acesso emitido para um usuário para suportar sua identidade e permissões. Para obter detalhes sobre as permissões exigidas pelo token, consulte Ações. |
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
| Sim | Object | Informações do usuário do IAM. |
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
| domain_id | Não | String | ID da conta à qual o usuário do IAM pertence. |
| name | Não | String | Novo nome de usuário do IAM, que consiste de 1 a 32 caracteres. Pode conter letras, dígitos, espaços, hifens (-), sublinhados (_) e pontos (.) e não pode começar com um dígito ou espaço. |
| password | Não | String | Nova senha, que deve atender aos seguintes requisitos:
|
| enabled | Não | Boolean | Status de ativação do usuário do IAM. true (valor padrão) indica que o usuário está ativado. false indica que o usuário está desativado. |
| description | Não | String | Descrição do usuário do IAM. |
| pwd_status | Não | Boolean | Status da senha. true significa que a senha precisa ser alterada e false significa que a senha é normal. |
Parâmetros de resposta
| Parâmetro | Tipo | Descrição |
|---|---|---|
| Object | Informações do usuário do IAM. |
| Parâmetro | Tipo | Descrição |
|---|---|---|
| name | String | Nome de usuário do IAM. |
| domain_id | String | ID da conta à qual o usuário do IAM pertence. |
| enabled | Boolean | Status de ativação do usuário do IAM. true (valor padrão) indica que o usuário está ativado. false indica que o usuário está desativado. |
| id | String | ID do usuário do IAM. |
| password_expires_at | String | Tempo de expiração da senha. Se esse parâmetro for definido como null, a senha nunca expirará. NOTA: O valor é uma hora UTC no formato AAAA-MM-DDTHH:mm:ss.ssssssZ, por exemplo, 2023-06-28T08:56:33.710000Z. Para obter detalhes sobre os formatos de data e carimbo de data/hora, consulte ISO-8601. |
| description | String | Descrição do usuário do IAM. |
| pwd_status | Boolean | Status da senha. true significa que a senha precisa ser alterada e false significa que a senha é normal. |
| last_project_id | String | ID do projeto que o usuário do IAM acessou pela última vez antes de sair do sistema. |
| Object | Outras informações sobre o usuário do IAM. | |
| Object | Informações do link de recursos do usuário de IAM. |
| Parâmetro | Tipo | Descrição |
|---|---|---|
| description | String | Descrição do usuário do IAM. |
| pwd_status | Boolean | Status da senha. true significa que a senha precisa ser alterada e false significa que a senha é normal. |
| last_project_id | String | ID do projeto que o usuário do IAM acessou pela última vez antes de sair do sistema. |
Exemplo de solicitação
Solicitação para que um administrador altere a senha do usuário do IAM chamado IAMUser para IAMPassword@
PATCH https://iam.myhuaweicloud.com/v3/users/{user_id} {
"user": {
"domain_id": "d78cbac186b744899480f25bd02...",
"name": "IAMUser",
"password": "IAMPassword@",
"enabled": true,
"pwd_status": false,
"description": "IAMDescription"
}
} Exemplo de resposta
Código de status: 200
A solicitação foi bem-sucedida.
{
"user": {
"pwd_status": false,
"description": "IAMDescription",
"name": "IAMUser",
"extra": {
"pwd_status": false,
"description": "IAMDescription",
},
"enabled": true,
"links": {
"self": "https://iam.myhuaweicloud.com/v3/users/07609fb9358010e21f7bc003751c7..."
},
"id": "07609fb9358010e21f7bc003751c7...",
"domain_id": "d78cbac186b744899480f25bd02..."
}
} Códigos de status
| Código de status | Descrição |
|---|---|
| 200 | A solicitação foi bem-sucedida. |
| 400 | Parâmetros inválidos. |
| 401 | Falha na autenticação. |
| 403 | Acesso negado. |
| 404 | O recurso solicitado não pode ser encontrado. |
| 405 | O método especificado na solicitação não é permitido para o recurso solicitado. |
| 409 | Ocorre um conflito de recursos. |
| 413 | A entidade de solicitação é muito grande. |
| 500 | Erro de servidor interno. |
| 503 | Serviço indisponível. |
Códigos de erro
Para obter detalhes, consulte Códigos de erro.
