Criação de um usuário do IAM
Função
Essa API é fornecida para que o administrador crie um usuário do IAM. Um usuário do IAM precisa alterar sua senha no primeiro login.
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.
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
Parâmetro |
Obrigatoriedade |
Tipo |
Descrição |
---|---|---|---|
Content-Type |
Sim |
String |
Preencha application/json;charset=utf8 neste campo. |
X-Auth-Token |
Sim |
String |
Consulte Ações. |
Parâmetro |
Obrigatoriedade |
Tipo |
Descrição |
---|---|---|---|
Sim |
Object |
Informações do usuário. |
Parâmetro |
Obrigatoriedade |
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, hífens (-), 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:
|
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. |
description |
Não |
String |
Descrição do usuário do IAM. |
Parâmetros de resposta
Parâmetro |
Tipo |
Descrição |
---|---|---|
Object |
Informações do usuário do IAM. |
Parâmetro |
Tipo |
Descrição |
---|---|---|
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. |
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. |
Object |
Informações de link de recurso do usuário do IAM. |
|
password_expires_at |
String |
Horário UTC quando a senha irá expirar. null indica que a senha tem validade ilimitada. |
description |
String |
Descrição do usuário do IAM. |
Exemplo de solicitação
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 êxito.
{ "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 êxito. |
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. |
Códigos de erro
Para obter detalhes, consulte Códigos de erro.