All Products
Search
Document Center

Identity as a Service:GetOrganizationalUnitIdByExternalId

Last Updated:Jun 10, 2026

Mengambil ID unit organisasi berdasarkan ID eksternal.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tidak ada otorisasi untuk operasi ini. Jika Anda mengalami masalah saat menjalankan operasi ini, hubungi dukungan teknis.

Sintaks permintaan

POST /v2/{instanceId}/{applicationId}/organizationalUnits/_/actions/getOrganizationalUnitIdByExternalId HTTP/1.1

Path Parameters

Parameter

Type

Required

Description

Example

instanceId

string

Yes

ID instans.

idaas_ue2jvisn35ea5lmthk267xxxxx

applicationId

string

Yes

ID aplikasi.

app_mkv7rgt4d7i4u7zqtzev2mxxxx

Parameter permintaan

Parameter

Type

Required

Description

Example

Authorization

string

Yes

Informasi autentikasi. Format: Bearer ${access_token}. Contoh: Bearer ATxxxx.

Bearer AT8csE2seYxxxxxij

body

object

No

Isi permintaan.

xxx001

organizationalUnitExternalId

string

Yes

ID eksternal unit organisasi. ID eksternal dapat digunakan untuk memetakan data eksternal ke data unit organisasi di Employee Identity and Access Management (EIAM) dari Identity as a Service (IDaaS). Secara default, ID eksternal adalah ID unit organisasi.

Catatan: Untuk unit organisasi dengan tipe sumber dan ID sumber yang sama, setiap unit organisasi memiliki ID eksternal yang unik.

ou_wovwffm62xifdziem7an7xxxxx

organizationalUnitSourceType

string

Yes

Tipe sumber unit organisasi. Nilai yang valid:

  • build_in: Unit organisasi dibuat di IDaaS.

  • ding_talk: Unit organisasi diimpor dari DingTalk.

  • ad: Unit organisasi diimpor dari Microsoft Active Directory (AD).

  • ldap: Unit organisasi diimpor dari layanan Lightweight Directory Access Protocol (LDAP).

build_in

organizationalUnitSourceId

string

Yes

ID sumber unit organisasi.

Jika unit organisasi dibuat di IDaaS, ID sumbernya adalah ID instans IDaaS. Jika unit organisasi diimpor, ID sumbernya adalah ID perusahaan di sumber. Misalnya, jika unit organisasi diimpor dari DingTalk, ID sumbernya adalah nilai corpId perusahaan di DingTalk.

idaas_ue2jvisn35ea5lmthk267xxxxx

Elemen respons

Element

Type

Description

Example

object

OrganizationalUnitIdObject

organizationalUnitId

string

ID unit organisasi.

ou_wovwffm62xifdziem7an7xxxxx

Contoh

Respons sukses

JSONformat

{
  "organizationalUnitId": "ou_wovwffm62xifdziem7an7xxxxx"
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.