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.

Nesta página

Função
Restrições
URI
Parâmetros de solicitação
Parâmetros de resposta
Exemplo de solicitação
Exemplo de resposta
Códigos de status
Códigos de erro

Mostrar todos

Central de ajuda/ Identity and Access Management/ Referência de API/ API/ Gerenciamento de usuários do IAM/ Criação de um usuário do IAM

Criação de um usuário do IAM

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

Ver PDF

Função

Essa API é fornecida para o administrador criar um usuário do IAM. Um usuário do IAM precisa alterar sua senha no primeiro logon.

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

Quando você usa essa API para criar um usuário do IAM, não é possível especificar um número de celular ou endereço de e-mail para o usuário do IAM. Para especificar um número de celular e um endereço de e-mail, use a API descrita em Criação de um usuário do IAM (recomendado).

URI

POST /v3/users

Parâmetros de solicitação

**Tabela 1** 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 2** Parâmetros no corpo da solicitação
Parâmetro	Obrigatório	Tipo	Descrição
user	Sim	Object	Informações do usuário.

**Tabela 3** user
Parâmetro	Obrigatório	Tipo	Descrição
name	Sim	String	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.
domain_id	Não	String	ID da conta à qual o usuário do IAM pertence.
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 de senha definidos na política de senhas.
enabled	Não	Boolean	Status de ativação do usuário de 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.

Parâmetros de resposta

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

**Tabela 5** user
Parâmetro	Tipo	Descrição
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.
domain_id	String	ID da conta à qual o usuário do IAM pertence.
name	String	Nome de usuário do IAM.
links	Object	Informações do link de recursos do usuário de 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.

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

Exemplo de solicitação

Solicitação para que um administrador crie um usuário do IAM chamado IAMUser

POST https://iam.myhuaweicloud.com/v3/users

{
    "user": {
        "name": "IAMUser",
        "domain_id": "d78cbac186b744899480f25bd02...",
        "enabled": true,
        "password": "IAMPassword@",
        "description": "IAMDescription"
    }
}

Exemplo de resposta

Código de status: 201

O usuário do IAM foi criado com sucesso.

{
    "user": {
        "description": "IAMDescription",
        "name": "IAMUser",
        "enabled": true,
        "links": {
            "self": "https://iam.myhuaweicloud.com/v3/users/076598a17b0010e21fdec003f3a2aa45"
        },
        "domain_id": "d78cbac186b744899480f25b...",
        "id": "076598a17b0010e21fdec003f3a2a..."
    }
}

Códigos de status

Código de status	Descrição
201	O usuário do IAM foi criado com sucesso.
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.