Todos os produtos
Search
Central de documentação

Identity as a Service:GetOrganizationalUnit

Última atualização: Jun 28, 2026

Obtém as informações sobre uma unidade organizacional.

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/{organizationalUnitId} 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

organizationalUnitId

string

Sim

O ID da unidade organizacional.

ou_wovwffm62xifdziem7an7xxxxx

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

Authorization

string

Sim

As informações de autenticação. Formato: Bearer ${access_token}. Exemplo: Bearer ATxxxx.

Bearer AT8csE2seYxxxxxij

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

Os parâmetros de resposta.

instanceId

string

O ID da instância.

idaas_ue2jvisn35ea5lmthk267xxxxx

organizationalUnitId

string

O ID da unidade organizacional.

ou_wovwffm62xifdziem7an7xxxxx

organizationalUnitName

string

O nome da unidade organizacional.

name001

parentId

string

O ID da unidade organizacional pai.

ou_wovwffm62xifdziem7an7xxxxx

organizationalUnitExternalId

string

O ID externo da unidade organizacional.

id_wovwffm62xifdziem7an7xxxxx

organizationalUnitSourceType

string

O tipo de origem da unidade organizacional. Valores válidos:

  • build_in: A unidade organizacional foi criada no Identity as a Service (IDaaS).

  • ding_talk: A unidade organizacional foi importada do DingTalk.

  • ad: A unidade organizacional foi importada do Microsoft Active Directory (AD).

  • ldap: A unidade organizacional foi importada de um serviço Lightweight Directory Access Protocol (LDAP).

build_in

organizationalUnitSourceId

string

O ID de origem da unidade organizacional.

id_wovwffm62xifdziem7an7xxxxx

createTime

integer

A hora em que a unidade organizacional foi criada. Este valor é um timestamp UNIX que representa o número de milissegundos decorridos desde 1 de janeiro de 1970, 00:00:00 UTC.

1652083425923

updateTime

integer

A hora em que a unidade organizacional foi atualizada pela última vez. Este valor é um timestamp UNIX que representa o número de milissegundos decorridos desde 1 de janeiro de 1970, 00:00:00 UTC.

1652083425923

description

string

A descrição da unidade organizacional.

xxxxx

Exemplos

Resposta de sucesso

JSON formato

{
  "instanceId": "idaas_ue2jvisn35ea5lmthk267xxxxx",
  "organizationalUnitId": "ou_wovwffm62xifdziem7an7xxxxx",
  "organizationalUnitName": "name001",
  "parentId": "ou_wovwffm62xifdziem7an7xxxxx",
  "organizationalUnitExternalId": "id_wovwffm62xifdziem7an7xxxxx",
  "organizationalUnitSourceType": "build_in",
  "organizationalUnitSourceId": "id_wovwffm62xifdziem7an7xxxxx",
  "createTime": 1652083425923,
  "updateTime": 1652083425923,
  "description": "xxxxx"
}

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.