Listagem de agências
Função
Esta API é fornecida para que o administrador liste as agências que correspondem às condições especificadas.
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
GET /v3.0/OS-AGENCY/agencies
Parâmetro |
Obrigatoriedade |
Tipo |
Descrição |
---|---|---|---|
domain_id |
Sim |
String |
ID da conta da parte delegante. 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.
NOTA:
domain_id não é necessário se X-Auth-Token estiver definido como um token com permissões refinadas. |
name |
Não |
String |
Nome da agência. Para obter detalhes sobre como obter o nome da agência, consulte Obtenção de informações de conta, usuário do IAM, grupo, projeto, região e agência. |
trust_domain_id |
Não |
String |
ID da conta da parte delegada. 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. |
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 |
Token com permissões de Security Administrator ou permissões de política. |
Parâmetros de resposta
Parâmetro |
Tipo |
Descrição |
---|---|---|
Array of objects |
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 delegante. |
duration |
String |
Prazo de validade da agência. FOREVER e null indicam que a agência tem validade ilimitada. ONEDAY indica que a agência é válida apenas por um dia. |
expire_time |
String |
Prazo de expiração da agência. null indica que a agência tem validade ilimitada. |
id |
String |
Identificação 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
GET https://iam.myhuaweicloud.com/v3.0/OS-AGENCY/agencies?domain_id=0ae9c6993a2e47bb8c4c7a9bb82...
Exemplo de resposta
Código de status: 200
A solicitação foi bem-sucedida.
{ "agencies": [ { "create_time": "2020-01-04T03:37:16.000000", "description": "", "domain_id": "d78cbac186b744899480f25b...", "duration": "FOREVER", "expire_time": null, "id": "0760a9e2a60026664f1fc0031f9f2...", "name": "IAMAgency", "trust_domain_id": "a2cd82a33fb043dc9304bf72...", "trust_domain_name": "IAMDomainB" } ] }
Códigos de status
Código de status |
Descrição |
---|---|
200 |
A solicitação foi bem-sucedida. |
401 |
Autenticação falhou. |
403 |
Acesso negado. |
404 |
O recurso solicitado não pode ser encontrado. |
500 |
Erro de servidor interno. |
Códigos de erro
Nenhum