Todos os produtos
Search
Central de documentação

Identity as a Service:ListOrganizationalUnits

Última atualização: Jul 03, 2026

Realiza uma consulta paginada de unidades organizacionais do 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

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.

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

InstanceId

string

Sim

O ID da instância.

idaas_ue2jvisn35ea5lmthk267xxxxx

PageNumber

integer

Não

O número da página a ser retornada. Valor padrão: 1.

1

PageSize

integer

Não

O número de entradas a serem retornadas em cada página. Valor padrão: 20. Valor máximo: 100.

20

OrganizationalUnitIds

array

Não

A lista de IDs de unidades organizacionais. O número de IDs na lista não pode exceder 100.

[ou_wovwffm62xifdziem7an7xxxxx]

string

Não

O ID da unidade organizacional.

ou_wovwffm62xifdziem7an7xxxxx

OrganizationalUnitName

string

Não

O nome da unidade organizacional. Uma correspondência exata é usada para a consulta.

name_001

OrganizationalUnitNameStartsWith

string

Não

O prefixo do nome da unidade organizacional. Uma correspondência à esquerda é usada para a consulta.

name

ParentId

string

Não

O ID da unidade organizacional pai.

ou_wovwffm62xifdziem7an7xxxxx

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

A resposta.

RequestId

string

O ID da solicitação.

0441BD79-92F3-53AA-8657-F8CE4A2B912A

TotalCount

integer

O número total de entradas retornadas. Este valor é o número total de entradas correspondentes. O número máximo de entradas que podem ser retornadas em uma única solicitação é especificado por PageSize.

1000

OrganizationalUnits

array<object>

A lista de unidades organizacionais.

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. Este ID é usado para mapear os dados da unidade organizacional para os dados de um sistema externo. Por padrão, o valor deste parâmetro é o ID da unidade organizacional.\n\nNota: 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 unidade organizacional. Valores válidos:\n\n- build_in: A unidade organizacional é criada no IDaaS.\n- ding_talk: A unidade organizacional é importada do DingTalk.\n- ad: A unidade organizacional é importada do Active Directory (AD).\n- ldap: A unidade organizacional é importada de um diretório LDAP (Lightweight Directory Access Protocol).\n- we_com: A unidade organizacional é importada do WeCom.

build_in

OrganizationalUnitSourceId

string

O ID de origem da unidade organizacional.

idaas_ue2jvisn35ea5lmthk267xxxxx

CreateTime

integer

A hora em que a unidade organizacional foi criada. O valor é um carimbo de data/hora UNIX. Unidade: milissegundos.

1652085686179

UpdateTime

integer

A hora em que a unidade organizacional foi atualizada pela última vez. O valor é um carimbo de data/hora UNIX. Unidade: milissegundos.

1652085686179

Description

string

A descrição da unidade organizacional.

Test organization

InstanceId

string

O ID da instância.

idaas_ue2jvisn35ea5lmthk267xxxxx

Leaf

boolean

Indica se a unidade organizacional é um nó folha. Um valor true indica que a unidade organizacional não possui nós filhos. Um valor false indica que a unidade organizacional possui nós filhos.

false

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "0441BD79-92F3-53AA-8657-F8CE4A2B912A",
  "TotalCount": 1000,
  "OrganizationalUnits": [
    {
      "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.