パブリック配信不可: 2025-05-14

移動先

• リクエスト
• レスポンス

ロールの権限受領者のリスト

get

https://EM_HOST:EM_CONSOLE_HTTPS_PORT/em/api/roles/{roleId}/grantees

このAPIは、デフォルトでは名前順(昇順)で(このロールが付与されている)権限受領者のリストを返します。

リクエスト

パス・パラメータ

• roleId(必須): string
  ロールのID

問合せパラメータ

• limit: integer
  最小値: 1

  最大値: 2000

  リストのページ分割用。ページ当たりの最大結果数、またはページ分割される"List"コールで返すアイテムの最大数。このAPIでは、limitとして指定した数より多を返すことはありませんが、その数が必ずしも返されるというわけではありません。

  デフォルト値: 20
• name: string
  フィルタ処理される正確な権限受領者名

  例:

  EM_ADMIN_OPERATOR

• nameContains: string
  権限受領者のフィルタ処理に使用される権限受領者名の一部

  例:

  ADMIN

• page: string
  ページのシステム生成ページ・トークン。
• sort: string
  方向付きの結果セットの順序。許容されるソート・フィールドは名前です。指定可能な方向はDESCとASCです

  例:

  name:DESC

• type: string
  権限受領者のタイプ

  例:

  User

この操作にはリクエスト本文はありません。

先頭に戻る

レスポンス

サポートされているメディア・タイプ

• application/json

200レスポンス

ロールの権限受領者が正常に返されました

本文()

ルート・スキーマ: GranteeCollection

型: object

これは、デフォルトでは名前順(ASC順)の権限受領者のリストを表すものです。

ソースの表示

• count(必須): integer
  このページ内の権限受領者の数

  例: 20
• items(必須): array items
  権限受領者リスト
• links(必須): links
  結果セットのナビゲーション・リンク

{
    "required":[
        "count",
        "items",
        "links"
    ],
    "type":"object",
    "properties":{
        "count":{
            "type":"integer",
            "description":"The number of Grantees in this page",
            "example":20
        },
        "links":{
            "properties":{
                "self":{
                    "$ref":"#/components/schemas/Link"
                },
                "previous":{
                    "$ref":"#/components/schemas/Link"
                },
                "next":{
                    "$ref":"#/components/schemas/Link"
                }
            },
            "description":"The result set navigation links"
        },
        "items":{
            "type":"array",
            "description":"The grantee list",
            "items":{
                "$ref":"#/components/schemas/GranteeSummary"
            }
        }
    },
    "description":"This is the representation of list of Grantees ordered by name in ASC order by default."
}

ネストされたスキーマ: items

型: array

権限受領者リスト

ソースの表示

• 配列: object GranteeSummary
  ロールが付与されているユーザーまたはロールを表します

{
    "type":"array",
    "description":"The grantee list",
    "items":{
        "$ref":"#/components/schemas/GranteeSummary"
    }
}

ネストされたスキーマ: links

型: object

結果セットのナビゲーション・リンク

ソースの表示

• next: object Link
  リンクを表します(self、previous、nextのいずれか)
• previous: object Link
  リンクを表します(self、previous、nextのいずれか)
• self: object Link
  リンクを表します(self、previous、nextのいずれか)

{
    "properties":{
        "self":{
            "$ref":"#/components/schemas/Link"
        },
        "previous":{
            "$ref":"#/components/schemas/Link"
        },
        "next":{
            "$ref":"#/components/schemas/Link"
        }
    },
    "description":"The result set navigation links"
}

ネストされたスキーマ: GranteeSummary

型: object

ロールが付与されているユーザーまたはロールを表します

ソースの表示

• id: string
  読取り専用: true

  権限受領者(ユーザーまたはロール)の一意識別子

  例: B0F9D83F6E313B03E0537013790ACA39
• isWithAdmin: boolean
  権限受領者がユーザーの場合、このフラグはプライベート・ロールがWITH_ADMINとして付与されているかどうかを示します

  例: true
• links: object links
  読取り専用: true

  権限受領者の関連リンク
• name: string
  権限受領者の名前

  例: TEST_SUPER_ADMIN
• type: array type
  権限受領者のタイプ

{
    "type":"object",
    "properties":{
        "id":{
            "type":"string",
            "description":"Unique identifier for a Grantee (User or Role)",
            "readOnly":true,
            "example":"B0F9D83F6E313B03E0537013790ACA39"
        },
        "name":{
            "type":"string",
            "description":"Name of a Grantee",
            "example":"TEST_SUPER_ADMIN"
        },
        "type":{
            "type":"array",
            "description":"Type of Grantee",
            "example":"User",
            "items":{
                "$ref":"#/components/schemas/GranteeTypes"
            }
        },
        "isWithAdmin":{
            "type":"boolean",
            "description":"If a Grantee is a User, this flag says whether the Private Role has been granted as WITH_ADMIN",
            "example":true
        },
        "links":{
            "type":"object",
            "properties":{
                "self":{
                    "$ref":"#/components/schemas/Link"
                }
            },
            "description":"The Grantee related links",
            "readOnly":true
        }
    },
    "description":"It represents User or Role to whom a Role is granted"
}

ネストされたスキーマ: links

型: object

読取り専用: true

権限受領者の関連リンク

ソースの表示

• self: object Link
  リンクを表します(self、previous、nextのいずれか)

{
    "type":"object",
    "properties":{
        "self":{
            "$ref":"#/components/schemas/Link"
        }
    },
    "description":"The Grantee related links",
    "readOnly":true
}

ネストされたスキーマ: type

型: array

権限受領者のタイプ

ソースの表示

• 配列: string
  指定可能な値: [ "User", "Role" ]

  これは権限受領者のタイプを表すものです。

{
    "type":"array",
    "description":"Type of Grantee",
    "example":"User",
    "items":{
        "$ref":"#/components/schemas/GranteeTypes"
    }
}

例:

User

ネストされたスキーマ: Link

型: object

リンクを表します(self、previous、nextのいずれか)

ソースの表示

• href: string
  リンクのためのURL

  例: /em/api/<resources>?page=b2Zmc2V0OjA&limit=0

{
    "type":"object",
    "description":"Represents a link(could be self, previous or next)",
    "properties":{
        "href":{
            "type":"string",
            "description":"URL for Link",
            "example":"/em/api/<resources>?page=b2Zmc2V0OjA&limit=0"
        }
    }
}

400レスポンス

不正なリクエスト

本文()

ルート・スキーマ: ErrorResponse

型: object

エラー・レスポンス

ソースの表示

• code(必須): string
  プログラムによる解析を目的とした、エラーを定義する短いエラー・コード。
• message(必須): string
  判読可能なエラー文字列

{
    "description":"Error response",
    "type":"object",
    "required":[
        "code",
        "message"
    ],
    "properties":{
        "code":{
            "description":"A short error code that defines the error, meant for programmatic parsing",
            "type":"string"
        },
        "message":{
            "description":"A human-readable error string",
            "type":"string"
        }
    }
}

401レスポンス

認証に失敗しました

本文()

ルート・スキーマ: ErrorResponse

型: object

エラー・レスポンス

ソースの表示

• code(必須): string
  プログラムによる解析を目的とした、エラーを定義する短いエラー・コード。
• message(必須): string
  判読可能なエラー文字列

{
    "description":"Error response",
    "type":"object",
    "required":[
        "code",
        "message"
    ],
    "properties":{
        "code":{
            "description":"A short error code that defines the error, meant for programmatic parsing",
            "type":"string"
        },
        "message":{
            "description":"A human-readable error string",
            "type":"string"
        }
    }
}

403レスポンス

許可されていません

本文()

ルート・スキーマ: MissingPrivErrorResponse

型: object

必要な権限がない場合にエラーとして返送されるレスポンス

ソースの表示

• missingPrivileges: array missingPrivileges
  エラーが発生したために欠落している権限。これにより、権限オブジェクトには権限の内部名および表示名のみが含まれます

{
    "type":"object",
    "properties":{
        "missingPrivileges":{
            "type":"array",
            "description":"Privileges which are missing due to that the Error is occurred. This will have privilege internal name and display name only in the Privilege object",
            "items":{
                "$ref":"#/components/schemas/MissingPrivilegeSummary"
            }
        }
    },
    "description":"Response sent back as an Error in case required privileges are missing",
    "allOf":[
        {
            "$ref":"#/components/schemas/ErrorResponse"
        }
    ]
}

すべてに一致

必要な権限がない場合にエラーとして返送されるレスポンス

ソースの表示

• object ErrorResponse
  エラー・レスポンス

{
    "type":"object",
    "properties":{
        "missingPrivileges":{
            "type":"array",
            "description":"Privileges which are missing due to that the Error is occurred. This will have privilege internal name and display name only in the Privilege object",
            "items":{
                "$ref":"#/components/schemas/MissingPrivilegeSummary"
            }
        }
    },
    "description":"Response sent back as an Error in case required privileges are missing",
    "allOf":[
        {
            "$ref":"#/components/schemas/ErrorResponse"
        }
    ]
}

ネストされたスキーマ: missingPrivileges

型: array

エラーが発生したために欠落している権限。これにより、権限オブジェクトには権限の内部名および表示名のみが含まれます

ソースの表示

• 配列: object MissingPrivilegeSummary
  これは、リソースの表示または管理のための権限がないことを表します。

{
    "type":"array",
    "description":"Privileges which are missing due to that the Error is occurred. This will have privilege internal name and display name only in the Privilege object",
    "items":{
        "$ref":"#/components/schemas/MissingPrivilegeSummary"
    }
}

ネストされたスキーマ: ErrorResponse

型: object

エラー・レスポンス

ソースの表示

• code(必須): string
  プログラムによる解析を目的とした、エラーを定義する短いエラー・コード。
• message(必須): string
  判読可能なエラー文字列

{
    "description":"Error response",
    "type":"object",
    "required":[
        "code",
        "message"
    ],
    "properties":{
        "code":{
            "description":"A short error code that defines the error, meant for programmatic parsing",
            "type":"string"
        },
        "message":{
            "description":"A human-readable error string",
            "type":"string"
        }
    }
}

ネストされたスキーマ: MissingPrivilegeSummary

型: object

これは、リソースの表示または管理のための権限がないことを表します。

ソースの表示

• displayName: string
  権限の表示名

  例: Manage
• name: string
  権限の名前

  例: MANAGE_JOB

{
    "type":"object",
    "properties":{
        "name":{
            "type":"string",
            "description":"Name of Privilege",
            "example":"MANAGE_JOB"
        },
        "displayName":{
            "type":"string",
            "description":"Display Name of Privilege",
            "example":"Manage"
        }
    },
    "description":"It represents a Privilege which is missing on a Resource to view or manage it."
}

404レスポンス

見つかりません

本文()

ルート・スキーマ: ErrorResponse

型: object

エラー・レスポンス

ソースの表示

• code(必須): string
  プログラムによる解析を目的とした、エラーを定義する短いエラー・コード。
• message(必須): string
  判読可能なエラー文字列

{
    "description":"Error response",
    "type":"object",
    "required":[
        "code",
        "message"
    ],
    "properties":{
        "code":{
            "description":"A short error code that defines the error, meant for programmatic parsing",
            "type":"string"
        },
        "message":{
            "description":"A human-readable error string",
            "type":"string"
        }
    }
}

500レスポンス

内部サーバー・エラー

本文()

ルート・スキーマ: ErrorResponse

型: object

エラー・レスポンス

ソースの表示

• code(必須): string
  プログラムによる解析を目的とした、エラーを定義する短いエラー・コード。
• message(必須): string
  判読可能なエラー文字列

{
    "description":"Error response",
    "type":"object",
    "required":[
        "code",
        "message"
    ],
    "properties":{
        "code":{
            "description":"A short error code that defines the error, meant for programmatic parsing",
            "type":"string"
        },
        "message":{
            "description":"A human-readable error string",
            "type":"string"
        }
    }
}

503レスポンス

サービスを使用できません

本文()

ルート・スキーマ: ErrorResponse

型: object

エラー・レスポンス

ソースの表示

• code(必須): string
  プログラムによる解析を目的とした、エラーを定義する短いエラー・コード。
• message(必須): string
  判読可能なエラー文字列

{
    "description":"Error response",
    "type":"object",
    "required":[
        "code",
        "message"
    ],
    "properties":{
        "code":{
            "description":"A short error code that defines the error, meant for programmatic parsing",
            "type":"string"
        },
        "message":{
            "description":"A human-readable error string",
            "type":"string"
        }
    }
}

デフォルト・レスポンス

予期しないエラー

本文()

ルート・スキーマ: ErrorResponse

型: object

エラー・レスポンス

ソースの表示

• code(必須): string
  プログラムによる解析を目的とした、エラーを定義する短いエラー・コード。
• message(必須): string
  判読可能なエラー文字列

{
    "description":"Error response",
    "type":"object",
    "required":[
        "code",
        "message"
    ],
    "properties":{
        "code":{
            "description":"A short error code that defines the error, meant for programmatic parsing",
            "type":"string"
        },
        "message":{
            "description":"A human-readable error string",
            "type":"string"
        }
    }
}

先頭に戻る