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

Realiza uma consulta paginada para recuperar informações de organizações do EIAM.

Descrição da operação

Para recuperar as organizações filhas diretas da organização raiz, defina o parâmetro de solicitação da seguinte forma:

{
  "parentOrganizationalUnitId": "ou_root"
}

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

Nenhuma autorização necessária para esta operação. Se você encontrar problemas com esta operação, entre em contato com o suporte técnico.

Sintaxe da solicitação

GET /v2/{instanceId}/{applicationId}/organizationalUnits HTTP/1.1

Parâmetros de caminho

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
instanceId	string	Sim	O ID da instância.	idaas_ue2jvisn35ea5lmthk267xxxxx
applicationId	string	Sim	O ID da aplicação.	app_mkv7rgt4d7i4u7zqtzev2mxxxx

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
Authorization	string	Sim	As informações de autenticação. O valor deve estar no formato `Bearer ${access\_token}`. Exemplo: `Bearer ATxxxx`.	Bearer AT8csE2seYxxxxxij
parentId	string	Sim	O ID da organização pai.	ou_wovwffm62xifdziem7an7xxxxx
pageNumber	integer	Não	O número da página. O valor padrão é 1.	1
pageSize	integer	Não	O número de registros por página. O valor padrão é 20. O valor pode variar de 1 a 100.	20

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	A resposta.
totalCount	integer	O número total de registros.	1000
data	array<object>	Uma lista de objetos de dados.
	object	O objeto de dados.
instanceId	string	O ID da instância.	idaas_ue2jvisn35ea5lmthk267xxxxx
organizationalUnitId	string	O ID da organização.	ou_wovwffm62xifdziem7an7xxxxx
organizationalUnitName	string	O nome da organização.	name001
parentId	string	O ID da organização pai.	ou_wovwffm62xifdziem7an7xxxxx
organizationalUnitExternalId	string	O ID externo da organização. Esse ID é usado para mapear dados externos aos dados da organização no IDaaS. O valor padrão é o ID da organização no IDaaS. Observação: O ID externo deve ser único para o mesmo tipo de origem e ID de origem.	ou_wovwffm62xifdziem7an7xxxxx
organizationalUnitSourceType	string	O tipo de origem da organização. Valores válidos: `build\_in`: A organização foi criada no IDaaS. `ding\_talk`: A organização foi importada do DingTalk. `ad`: A organização foi importada do Active Directory (AD). `ldap`: A organização foi importada do LDAP.	build_in
organizationalUnitSourceId	string	O ID de origem da organização. Para o tipo `build\_in`, o valor padrão é o ID da instância. Para outros tipos, o valor é o ID da empresa na origem. Por exemplo, se a origem for DingTalk, o valor será o `corpId` da empresa no DingTalk.	idaas_ue2jvisn35ea5lmthk267xxxxx
createTime	integer	O momento em que a organização foi criada. Este é um timestamp UNIX. Unidade: milissegundos.	1652083425923
updateTime	integer	O momento da última atualização da organização. Este é um timestamp UNIX. Unidade: milissegundos.	1652083425923
description	string	A descrição da organização.	测试组织

Exemplos

Resposta de sucesso

JSON formato

{
  "totalCount": 1000,
  "data": [
    {
      "instanceId": "idaas_ue2jvisn35ea5lmthk267xxxxx",
      "organizationalUnitId": "ou_wovwffm62xifdziem7an7xxxxx",
      "organizationalUnitName": "name001",
      "parentId": "ou_wovwffm62xifdziem7an7xxxxx",
      "organizationalUnitExternalId": "ou_wovwffm62xifdziem7an7xxxxx",
      "organizationalUnitSourceType": "build_in",
      "organizationalUnitSourceId": "idaas_ue2jvisn35ea5lmthk267xxxxx",
      "createTime": 1652083425923,
      "updateTime": 1652083425923,
      "description": "测试组织"
    }
  ]
}

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.