すべてのプロダクト
Search
ドキュメントセンター

:GetOrganizationalUnitIdByExternalId

最終更新日:Mar 30, 2026

外部 ID に基づいて組織単位の ID を取得します

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

この操作の認証情報はありません。問題が発生した場合は、アカウントマネージャーにご連絡ください。

リクエスト構文

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

パスパラメータ

パラメーター

必須 / 任意

説明

instanceId

string

必須

インスタンス ID。

idaas_ue2jvisn35ea5lmthk267xxxxx

applicationId

string

必須

アプリケーション ID。

app_mkv7rgt4d7i4u7zqtzev2mxxxx

リクエストパラメーター

パラメーター

必須 / 任意

説明

Authorization

string

必須

認証情報。形式:Bearer ${access_token}。 例:Bearer ATxxxx。

Bearer AT8csE2seYxxxxxij

body

object

任意

リクエストボディ。

xxx001

organizationalUnitExternalId

string

必須

組織単位の外部 ID。外部 ID は、外部データを Identity as a Service (IDaaS) の Employee Identity and Access Management (EIAM) の組織単位のデータにマッピングするために使用できます。デフォルトでは、外部 ID は組織単位 ID です。

注意:同じソースタイプとソース ID を持つ組織単位の場合、各組織単位は一意の外部 ID を持ちます。

ou_wovwffm62xifdziem7an7xxxxx

organizationalUnitSourceType

string

必須

組織単位のソースタイプ。有効な値:

  • build_in:組織単位は IDaaS で作成されました。

  • ding_talk:組織単位は DingTalk からインポートされました。

  • ad:組織単位は Microsoft Active Directory (AD) からインポートされました。

  • ldap:組織単位は Lightweight Directory Access Protocol (LDAP) サービスからインポートされました。

build_in

organizationalUnitSourceId

string

必須

組織単位のソース ID。

組織単位が IDaaS で作成された場合、そのソース ID は IDaaS インスタンスの ID です。組織単位がインポートされた場合、そのソース ID はソース内のエンタープライズ ID です。たとえば、組織単位が DingTalk からインポートされた場合、そのソース ID は DingTalk のエンタープライズの corpId 値です。

idaas_ue2jvisn35ea5lmthk267xxxxx

レスポンスフィールド

フィールド

説明

object

OrganizationalUnitIdObject

organizationalUnitId

string

組織単位の ID。

ou_wovwffm62xifdziem7an7xxxxx

成功レスポンス

JSONJSON

{
  "organizationalUnitId": "ou_wovwffm62xifdziem7an7xxxxx"
}

エラーコード

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。