外部 ID に基づいて組織単位の ID を取得します
今すぐお試しください
テスト
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 |
| 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"
}
エラーコード
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。