Este conteúdo foi traduzido por máquina para sua conveniência e a Huawei Cloud não pode garantir que o conteúdo foi traduzido com precisão. Para exibir o conteúdo original, use o link no canto superior direito para mudar para a página em inglês.

Central de ajuda/ Identity and Access Management/ Referência de API/ API/ Gerenciamento de agências/ Consulta de detalhes da agência

Atualizado em 2023-02-16 GMT+08:00

Ver PDF

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}

**Tabela 1** Parâmetros de URI
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

**Tabela 2** Parâmetros no cabeçalho da 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

**Tabela 3** Parâmetros no corpo da resposta
Parâmetro	Tipo	Descrição
agency	object	Informações da agência.

**Tabela 4** agency
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. FOREVER/null: a agência tem validade ilimitada. 24: a agência tem validade de 24 horas. XXX: a agência tem validade limitada, por exemplo, a 480 horas.
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.