Consulta de detalhes da agência
Função
Esta API é fornecida para que o administrador consulte os detalhes sobre 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
GET /v3.0/OS-AGENCY/agencies/{agency_id}
Parâmetro |
Obrigatoriedade |
Tipo |
Descrição |
---|---|---|---|
agency_id |
Sim |
String |
ID da agência. Para obter detalhes sobre como obter uma ID de agência, 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 as permissões iam:agencies:getAgency ou Security Administrator. Para obter detalhes sobre permissões refinadas, consulte Açõ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
GET https://iam.myhuaweicloud.com/v3.0/OS-AGENCY/agencies/{agency_id}
Exemplo de resposta
Código de status: 200
A solicitação foi bem-sucedida.
{ "agency":{ "create_time":"2020-01-04T03:37:16.000000", "description":"", "domain_id":"d78cbac186b744899480f25bd...8", "duration":"FOREVER", "id":"0760a9e2a60026664f1fc0031f9f205e", "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