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/ Identity and Access Management/ Referência de API/ API/ Gerenciamento de usuários do IAM/ Modificação de informações do usuário

Atualizado em 2024-08-31 GMT+08:00

Ver PDF

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}

**Tabela 1** Parâmetros de URI
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

**Tabela 2** Parâmetros no cabeçalho da 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.

**Tabela 3** Parâmetros no corpo da solicitação
Parâmetro	Obrigatório	Tipo	Descrição
user	Sim	Object	Informações do usuário do IAM.

**Tabela 4** user
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: Pode conter de 6 a 32 caracteres. O comprimento mínimo de senha padrão é de 6 caracteres. Deve conter pelo menos dois dos seguintes tipos de caracteres: letras maiúsculas, letras minúsculas, dígitos e caracteres especiais. Não pode conter o número de celular ou endereço de e-mail do usuário. Deve atender aos requisitos de senha definidos na política de senhas. Deve ser diferente da senha anterior.
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

**Tabela 5** Parâmetros no corpo da resposta
Parâmetro	Tipo	Descrição
user	Object	Informações do usuário do IAM.

**Tabela 6** user
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.
extra	Object	Outras informações sobre o usuário do IAM.
links	Object	Informações do link de recursos do usuário de IAM.

**Tabela 7** user.extra
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.

**Tabela 8** user.links
Parâmetro	Tipo	Descrição
self	String	Link de recursos.

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.