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 do IAM (recomendado)

Atualizado em 2023-02-16 GMT+08:00

Ver PDF

Modificação de informações do usuário do IAM (recomendado)

Função

Esta 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 específicos da região. Para pontos de extremidade do IAM, consulte Regiões e pontos de extremidade.

URI

PUT /v3.0/OS-USER/users/{user_id}

**Tabela 1** Parâmetros de URI
Parâmetro	Obrigatoriedade	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 de 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	Obrigatoriedade	Tipo	Descrição
Content-Type	Sim	String	Preencha application/json;charset=utf8 neste campo.
X-Auth-Token	Sim	String	Token com permissões Security Administrator.

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

**Tabela 4** user
Parâmetro	Obrigatoriedade	Tipo	Descrição
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, hífens (-), sublinhados (_), e pontos (.) e não pode começar com um dígito ou espaço.
password	Não	String	Senha do usuário. A senha 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. deve atender aos requisitos da política de senha configurada na página de configurações da conta. deve ser diferente da senha antiga.
email	Não	String	Endereço de e-mail, que não pode conter mais de 255 caracteres.
areacode	Não	String	Código do país. O código do país deve ser usado com um número de celular.
phone	Não	String	Novo número de celular, que pode conter no máximo 32 dígitos. O número de telefone deve ser utilizado com um código de país.
enabled	Não	Boolean	Habilitação do status do usuário do IAM. true (valor padrão) indica que o usuário está habilitado. false indica que o usuário está desativado.
pwd_status	Não	Boolean	Status da senha. true significa que a senha precisa ser alterada, false significa que a senha é normal.
xuser_type	Não	String	Tipo do usuário do IAM no sistema externo. O tipo de usuário pode conter no máximo 64 caracteres. xuser_type deve ser usado com xuser_id e será verificado com base em xaccount_type e xdomain_type da mesma conta. NOTA: Um sistema externo refere-se a um sistema de gestão empresarial conectado à HUAWEI CLOUD. Os parâmetros xaccount_type, xaccount_id, xdomain_type, xdomain_id, xuser_type e xuser_id não podem ser obtidos da HUAWEI CLOUD. Entre em contato com o administrador da empresa.
xuser_id	Não	String	ID do usuário do IAM no sistema externo. O ID do usuário pode conter no máximo 128 caracteres e deve ser usado com xuser_type. NOTA: Um sistema externo refere-se a um sistema de gestão empresarial conectado à HUAWEI CLOUD. Os parâmetros xaccount_type, xaccount_id, xdomain_type, xdomain_id, xuser_type e xuser_id não podem ser obtidos da HUAWEI CLOUD. Entre em contato com o administrador da empresa.
access_mode	Não	String	Tipo de acesso do usuário do IAM. default: acesso programático e acesso ao console de gerenciamento. Essa opção é o tipo de acesso padrão. programmatic: acesso programático console: acesso ao console de gerenciamento
description	Não	String	Descrição do usuário do IAM.

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
pwd_status	Boolean	Status da senha. true significa que a senha precisa ser alterada, false significa que a senha é normal.
xuser_id	String	ID do usuário do IAM no sistema externo. NOTA: Um sistema externo refere-se a um sistema de gestão empresarial conectado à HUAWEI CLOUD. Os parâmetros xaccount_type, xaccount_id, xdomain_type, xdomain_id, xuser_type e xuser_id não podem ser obtidos da HUAWEI CLOUD. Entre em contato com o administrador da empresa.
xuser_type	String	Tipo do usuário do IAM no sistema externo. NOTA: Um sistema externo refere-se a um sistema de gestão empresarial conectado à HUAWEI CLOUD. Os parâmetros xaccount_type, xaccount_id, xdomain_type, xdomain_id, xuser_type e xuser_id não podem ser obtidos da HUAWEI CLOUD. Entre em contato com o administrador da empresa.
access_mode	String	Tipo de acesso do usuário do IAM. default: acesso programático e acesso ao console de gerenciamento. Essa opção é o tipo de acesso padrão. programmatic: acesso programático console: acesso ao console de gerenciamento
description	String	Descrição do usuário do IAM.
name	String	Novo nome de usuário do IAM, que consiste de 1 a 32 caracteres. Pode conter letras, dígitos, espaços, hífens (-), sublinhados (_), e pontos (.) e não pode começar com um dígito ou espaço.
phone	String	Novo número de celular, que pode conter no máximo 32 dígitos. O número de telefone deve ser utilizado com um código de país.
domain_id	String	ID da conta à qual o usuário do IAM pertence.
enabled	Boolean	Habilitação do status do usuário do IAM. true (valor padrão) indica que o usuário está habilitado. false indica que o usuário está desativado.
areacode	String	Código do país.
email	String	Novo endereço de e-mail.
id	String	ID do usuário do IAM.
links	Object	Informações de link de recurso do usuário do IAM.
password_expires_at	String	Hora de expiração da senha (hora UTC) Este parâmetro não será retornado se seu valor for nulo.

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

Exemplo de solicitação

PUT https://iam.myhuaweicloud.com/v3.0/OS-USER/users/{user_id}

{
    "user": {
        "email": "IAMEmail@huawei.com",
        "areacode": "0852",
        "phone": "12345678910",
        "enabled": true,
        "name": "IAMUser",
        "password": "IAMPassword@",
        "pwd_status": false,
        "xuser_type": "",
        "xuser_id": "",
        "access_mode" : "default",
        "description": "IAMDescription"
    }
}

Exemplo de resposta

Código de status: 200

A solicitação foi bem-sucedida.

{
    "user": {
        "description": "IAMDescription",
        "areacode": "0852",
        "enabled": true,
        "pwd_status": false,
        "xuser_id": "",
        "access_mode" : "default",
        "domain_id": "d78cbac186b744899480f25bd0...",
        "phone": "12345678910",
        "name": "IAMUser",
        "links": {
            "self": "https://iam.myhuaweicloud.com/3.0/OS-USER/users/076934ff9f0010cd1f0bc003..."
        },
        "id": "076934ff9f0010cd1f0bc0031019...",
        "xuser_type": "",
        "email": "IAMEmail@huawei.com"
    }
}

Códigos de status

Código de status	Descrição
200	A solicitação foi bem-sucedida.
400	Parâmetros inválidos.
401	Autenticação falhou.
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.