---
sourceDocument: オーストラリア API リファレンス
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/api-reference
Release :
- australia
ft:locale :
- ja-JP
ft:publication_title :
- オーストラリア API リファレンス
ft:clusterId :
- crapiref
bundleId :
- crapiref
workflow :
- Creator
---
# ユーザーロール継承 API
# ユーザーロール継承 API {#ariaid-title1}
* リリースバージョン: Australia
*
* 更新日 2026年08月07日
*
*  所要時間：4分
ユーザーロール継承 API には、特定のユーザーが継承したロールを表示できるエンドポイントが用意されています。
この API には、Contextual Security: Role Management V2 REST API (com.glide.role_management.inh_count.rest_api) プラグイン (Jakarta リリース以降の新しいインスタンスで自動的にアクティブ化される) か、Contextual Security: Role Management Enhancements REST API プラグイン (Geneva リリース以降で自動的にアクティブ化される) が必要です。Contextual Security: Role Management V2 REST API は、Contextual Security: Role Management V2 (com.glide.role_management.inh_count) プラグインに依存しています。
ユーザーのロールは、直接付与することも、他のロールから継承することも、グループから継承することもできます。この API にアクセスするには、user_admin ロールが必要です。
## ユーザーロールの継承:GET /global/user_role_inheritance {#ariaid-title2}
指定されたユーザーの付与および継承されたロールを返します。
### URL 形式 {#user_role_inher-GET__section_pg5_hds_2mb}
バージョニングされた URL: /api/global/{api_version}/user_role_inheritance
デフォルト URL: /api/global/user_role_inheritance
注:
使用可能なバージョン [は、REST API エクスプローラー](https://servicenow-prod.fluidtopics.net/5V9lEGssZWUBc2ao1C_~Fg "このチュートリアルでは、REST API エクスプローラーを使用して、 ServiceNow REST API をテストします。")で指定されます。スクリプト済み REST API の場合、\[ [スクリプト済み REST サービス\] フォーム](I8AGM_146DeZDBTS~H_J8g "スクリプト化された REST API 機能を使用すると、アプリケーション開発者はカスタム Web サービス API をビルドできます。")に追加のバージョン情報があります。
### サポートされている要求パラメーター
{#user_role_inher-GET__entry__2}{#user_role_inher-GET__version-not_optional-RESTAPI}
| 名前 | 説明 |
|-|-|
| api_version | オプション。アクセスするエンドポイントのバージョン。たとえば、 v1 や v2 などです。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。 データタイプ：文字列 |
[表 : 1. パスパラメーター]
{#user_role_inher-GET__entry__6}
| 名前 | 説明 |
|-|-|
| user_sysid | 必須です。ロール情報を返すユーザーのSys_id。 |
[表 : 2. クエリパラメーター]
{#user_role_inher-GET__entry__10}
| 名前 | 説明 |
|-|-|
| なし | |
[表 : 3. 要求本文パラメーター (XML または JSON)]
### ヘッダー
次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー」](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")を参照してください。
{#user_role_inher-GET__entry__14}{#user_role_inher-GET__accept-RESTAPI}
| ヘッダー | 説明 |
|-|-|
| 承認 | 応答本文のデータフォーマット。サポートされるタイプ：application/json または application/xml。 デフォルト： application/json |
[表 : 4. 要求ヘッダー]
{#user_role_inher-GET__entry__18}
| ヘッダー | 説明 |
|-|-|
| なし | |
[表 : 5. 応答ヘッダー]
### ステータスコード
この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")」を参照してください。
{#user_role_inher-GET__entry__22}{#user_role_inher-GET__entry-200-status-code}{#user_role_inher-GET__entry-400-status-code}{#user_role_inher-GET__entry-401-status-code}{#user_role_inher-GET__entry-404-status-code}{#user_role_inher-GET__entry-500-status-code}
| ステータスコード | 説明 |
|-|-|
| 200 | 成功。要求が正常に処理されました。 |
| 400 | 要求が正しくありません。不適切な要求タイプまたは誤った要求が検出されました。 |
| 401 | 権限がありません。ユーザー認証情報が正しくないか、渡されていません。 |
| 404 | 見つかりません。要求されたアイテムが見つかりませんでした。 |
| 500 | 内部サーバーエラー要求の処理中に予期しないエラーが発生しました。応答には、エラーに関する追加情報が含まれています。 |
[表 : 6. ステータスコード]
### 応答本文のパラメーター (JSON または XML)
{#user_role_inher-GET__entry__34}
| 名前 | 説明 |
|-|-|
| from_group | ロールを持つグループから継承されたロールのリスト。 データタイプ：アレイ |
| from_role | 直接付与されるロール、または他のロールから継承されるロールのリスト。 データタイプ：アレイ |
| user_name | ユーザーのフルネーム。 データタイプ：文字列 |
[ ]
### cURL 要求のサンプル
curl "https://instance.service-now.com/api/global/user_role_inheritance?user_sysid=62826bf03710200044e0bfc8bcbe5df1" \
--request GET \
--header "Accept:application/json" \
--user "username":"password"
{
"result": {
"user_name": "abel.tuter",
"from_group": [
"[Azure Operators]/sn_azure.operator",
"[Azure Operators]/sn_azure.operator/sn_azure.user"
],
"from_role": [
"/snc_internal",
"/cloud_user",
"/cloud_user/pa_viewer",
"/cloud_user/sn_azure.user",
"/cloud_user/aws_user"
]
}
}