Criação de um usuário do IAM (recomendado)
Função
Essa API é fornecida para que o administrador crie um 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
POST /v3.0/OS-USER/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 |
Para obter detalhes, consulte Ações. |
Parâmetro |
Obrigatoriedade |
Tipo |
Descrição |
---|---|---|---|
Sim |
Object |
Informações do usuário do IAM. |
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 |
Sim |
String |
ID da conta. Para obter detalhes sobre como conseguir o ID de domínio, consulte Obtenção de informações de conta, usuário do IAM, grupo, projeto, região e agência. |
password |
Não |
String |
Senha do usuário. A senha deve atender aos seguintes requisitos: |
Não |
String |
Endereço de e-mail com no máximo 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 |
Número de celular com 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 |
Indica se a redefinição de senha é necessária no primeiro login. Por padrão, a redefinição de senha é necessária. |
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 gerenciamento corporativo 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 CLOUDda plataforma de nuvem. 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 gerenciamento corporativo 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.
|
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 |
---|---|---|
status |
Integer |
Status do usuário do IAM. |
pwd_status |
Boolean |
Indica se a redefinição de senha é necessária no primeiro login. |
xuser_id |
String |
ID do usuário do IAM no sistema externo.
NOTA:
Um sistema externo refere-se a um sistema de gerenciamento corporativo 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 gerenciamento corporativo 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.
|
description |
String |
Descrição do usuário do IAM. |
name |
String |
Nome de usuário do IAM, que consiste de 1 a 32 caracteres. Pode conter letras, dígitos, espaços, (-) de hífens, sublinhados (_), e pontos (.) e não pode começar com um dígito ou espaço. |
phone |
String |
Número de celular com no máximo 32 dígitos. O número de telefone deve ser utilizado com um código de país. |
is_domain_owner |
Boolean |
Indica se o usuário do IAM é um administrador de conta. |
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. |
String |
Endereço de e-mail. |
|
create_time |
String |
Hora em que o usuário do IAM foi criado. |
xdomain_id |
String |
Código do cliente da entidade comercial. |
xdomain_type |
String |
Entidade empresarial. |
id |
String |
ID 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. |
Exemplo de solicitação
POST https://iam.myhuaweicloud.com/v3.0/OS-USER/users
{ "user": { "domain_id": "d78cbac186b744899480f25...", "name": "IAMUser", "password": "IAMPassword@", "email": "IAMEmail@huaweiexample.com", "areacode": "00123", "phone": "12345678910", "enabled": true, "pwd_status": false, "xuser_type": "", "xuser_id": "", "access_mode" : "default", "description": "IAMDescription" } }
Exemplo de resposta
Código de status: 201
O usuário do IAM foi criado com êxito.
{ "user": { "pwd_status": false, "xuser_id": "", "xuser_type": "", "access_mode" : "default", "description": "IAMDescription", "name": "IAMUser", "phone": "12345678910", "is_domain_owner": false, "enabled": true, "domain_id": "d78cbac186b744899480f25bd...", "areacode": "00123", "email": "IAMEmail@huaweiexample.com", "create_time": "2020-01-06T08:05:16.000000", "xdomain_id": "", "xdomain_type": "", "id": "07664aec578026691f00c003a..." } }
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
Consulte Códigos de erro.