Criação de uma agência
Função
Esta API é fornecida para que o administrador crie uma agência.
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-AGENCY/agencies
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 da agência. |
Parâmetro |
Obrigatoriedade |
Tipo |
Descrição |
---|---|---|---|
name |
Sim |
String |
Nome da agência, que deve conter menos ou igual a 64 caracteres. |
domain_id |
Sim |
String |
ID da conta que delega. |
trust_domain_id |
Não |
String |
ID da conta delegada. trust_domain_id ou trust_domain_name deve ser especificado. Se ambos forem especificados, trust_domain_name tem precedência. |
trust_domain_name |
Não |
String |
Nome da conta delegada. trust_domain_id ou trust_domain_name deve ser especificado. Se ambos forem especificados, trust_domain_name tem precedência. |
description |
Não |
String |
Descrição da agência, que deve conter menos ou igual a 255 caracteres. |
duration |
Não |
String |
Prazo de validade da agência. Unidade: dia. Opções:
|
Parâmetros de resposta
Parâmetro |
Tipo |
Descrição |
---|---|---|
object |
Informações da agência. |
Parâmetro |
Tipo |
Descrição |
---|---|---|
create_time |
String |
Momento em que a agência foi criada. |
description |
String |
Descrição da agência. |
domain_id |
String |
ID da conta que delega. |
duration |
String |
Prazo de validade da agência. Unidade: hora.
|
expire_time |
String |
Prazo de expiração da agência. null indica que a agência tem validade ilimitada. |
id |
String |
ID da agência. |
name |
String |
Nome da agência. |
trust_domain_id |
String |
ID da conta delegada. |
trust_domain_name |
String |
Nome da conta delegada. |
Exemplo de solicitação
POST https://iam.myhuaweicloud.com/v3.0/OS-AGENCY/agencies
{ "agency": { "name": "IAMAgency", "domain_id": "d78cbac186b744899480f25bd...", "trust_domain_id": "c2cd82a33fb043dc9304bf72a...", "trust_domain_name": "IAMDomainB", "duration": "FOREVER", "description": "IAMDescription" } }
Exemplo de resposta
Código de status: 201
A agência é criada com sucesso.
{ "agency": { "description": "IAMDescription", "trust_domain_id": "a2cd82a33fb043dc9304bf72a0f...", "id": "078ade0fc20010004f8fc0034fad529d", "duration": "FOREVER", "create_time": "2020-01-20T12:59:20.811642", "expire_time": null, "domain_id": "d78cbac186b744899480f25bd02...", "name": "IAMAgency" } }
Códigos de status
Código de status |
Descrição |
---|---|
201 |
A agência é criada com sucesso. |
400 |
Parâmetros inválidos. |
401 |
Autenticação falhou. |
403 |
Acesso negado. |
404 |
O recurso solicitado não pode ser encontrado. |
409 |
Ocorre um conflito de recursos. |
500 |
Erro de servidor interno. |
Códigos de erro
Nenhum