GetOrganizationalUnit - Identity as a Service: Central de Documentação do Alibaba Cloud

Consulta as informações de uma organização EIAM.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

eiam:GetOrganizationalUnit

get

*OrganizationalUnit

acs:eiam:{#regionId}:{#accountId}:instance/{#InstanceId}/organizationalunit/{#OrganizationalUnitId}

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
InstanceId	string	Sim	O ID da instância.	idaas_ue2jvisn35ea5lmthk267xxxxx
OrganizationalUnitId	string	Sim	O ID da unidade organizacional.	ou_wovwffm62xifdziem7an7xxxxx

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	O resultado da resposta.
RequestId	string	O ID da solicitação.	0441BD79-92F3-53AA-8657-F8CE4A2B912A
OrganizationalUnit	object	O objeto de dados da unidade organizacional.
OrganizationalUnitId	string	O ID da unidade organizacional.	ou_wovwffm62xifdziem7an7xxxxx
OrganizationalUnitName	string	O nome da unidade organizacional.	test_organizationalUnit_name
ParentId	string	O ID da unidade organizacional pai.	ou_wovwffm62xifdziem7an7xxxxx
OrganizationalUnitExternalId	string	O ID externo da unidade organizacional. É usado para mapear dados externos para unidades organizacionais do IDaaS. O valor padrão é o ID da unidade organizacional do IDaaS. Nota: O ID externo deve ser exclusivo dentro do mesmo tipo de origem e ID de origem.	ou_wovwffm62xifdziem7an7xxxxx
OrganizationalUnitSourceType	string	O tipo de origem da conta. Valores válidos: build_in: Autogerenciado. ding_talk: Importado do DingTalk. ad: Importado do AD. ldap: Importado do LDAP. we_com: Importado do WeCom.	build_in
OrganizationalUnitSourceId	string	O ID de origem da unidade organizacional. Para unidades organizacionais autogerenciadas, o valor padrão é o ID da instância. Para outros tipos, o valor corresponde ao ID da empresa da respectiva origem. Por exemplo, para o DingTalk, o valor é o corpId da empresa do DingTalk.	idaas_ue2jvisn35ea5lmthk267xxxxx
CreateTime	integer	A hora em que a unidade organizacional foi criada. O valor é um timestamp UNIX em milissegundos.	1652085686179
UpdateTime	integer	A hora em que a unidade organizacional foi atualizada pela última vez. O valor é um timestamp UNIX em milissegundos.	1652085686179
Description	string	A descrição da unidade organizacional.	Test organization
InstanceId	string	O ID da instância.	idaas_ue2jvisn35ea5lmthk267xxxxx
Leaf	boolean	Especifica se a unidade organizacional é um nó folha. O valor true indica que a unidade organizacional não possui nós filhos. O valor false indica que a unidade organizacional possui nós filhos.	false

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "0441BD79-92F3-53AA-8657-F8CE4A2B912A",
  "OrganizationalUnit": {
    "OrganizationalUnitId": "ou_wovwffm62xifdziem7an7xxxxx",
    "OrganizationalUnitName": "test_organizationalUnit_name",
    "ParentId": "ou_wovwffm62xifdziem7an7xxxxx",
    "OrganizationalUnitExternalId": "ou_wovwffm62xifdziem7an7xxxxx",
    "OrganizationalUnitSourceType": "build_in",
    "OrganizationalUnitSourceId": "idaas_ue2jvisn35ea5lmthk267xxxxx",
    "CreateTime": 1652085686179,
    "UpdateTime": 1652085686179,
    "Description": "Test organization",
    "InstanceId": "idaas_ue2jvisn35ea5lmthk267xxxxx",
    "Leaf": false
  }
}

Códigos de erro

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.