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 2024-08-31 GMT+08:00
Ver PDF
Compartilhar

Consulta de detalhes da agência

Função

Essa 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 da região específica. 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

Obrigatório

Tipo

Descrição

agency_id

Sim

String

ID da agência. Para obter detalhes sobre como obter o ID da agência, consulte Obtenção de informações sobre 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

Obrigatório

Tipo

Descrição

Content-Type

Sim

String

Preencha application/json;charset=utf8 nesse campo.

X-Auth-Token

Sim

String

Token com a permissão iam:agencies:getAgency ou permissões de 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

Hora em que a agência foi criada.

NOTA:

O valor é uma hora UTC no formato AAAA-MM-DDTHH:mm:ss.ssssssZ, por exemplo, 2023-06-28T08:56:33.710000Z. Para obter detalhes sobre os formatos de data e carimbo de data/hora, consulte ISO-8601.

description

String

Descrição da agência.

domain_id

String

ID da conta delegada.

duration

String

Período de validade da agência. Unidade: hora.

  • FOREVER/null: a agência tem validade ilimitada.
  • 24: a agência é válida por 24 horas.
  • XXX: a agência tem validade limitada de, por exemplo, 480 horas.

expire_time

String

Tempo de expiração da agência. O valor null indica que a agência tem validade ilimitada.

NOTA:

O valor é uma hora UTC no formato AAAA-MM-DDTHH:mm:ss.ssssssZ, por exemplo, 2023-06-28T08:56:33.710000Z. Para obter detalhes sobre os formatos de data e carimbo de data/hora, consulte ISO-8601.

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

Solicitação para consultar detalhes da agência

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

Falha na autenticação.

403

Acesso negado.

404

O recurso solicitado não pode ser encontrado.

500

Erro de servidor interno.

Códigos de erro

Nenhum

Tópico principal:Gerenciamento de agências