ローカル グループ メンバーを取得

組織、グループ ID、およびオプションのページング パラメーターに基づいて、特定のローカル グループに属するメンバーのページング リストを返します。

API エンドポイント

GET {accessURL}/{organizationName}/identity_/api/Group/{partitionGlobalId}/{groupId}/Members

すべてのエンドポイント パスの {accessURL} は、ご使用のクラウド プラットフォームのベース URL に置き換えてください。

Cloud Platform	アクセス URL
Automation Cloud	https://cloud.uipath.com/
Automation Cloud (公共部門向け)	https://govcloud.uipath.us/
Automation Cloud (専有型)	https://{customURL}.dedicated.uipath.com/

スコープ

次のスコープが必要です。

• PM.Group
• PM.Group.Read

要求ヘッダー

--header 'Authorization: Bearer {access_token}'\
--header 'Content-Type: application/json'

注:

{access_token}を取得するには、必ずこちらで説明するいずれかの方法で認証を行ってください。

パス パラメーター

パス パラメーター	データ型	説明
partitionGlobalId (必須)	文字列	目的のグループを含む組織の ID です。
groupId (必須)	文字列	取得するメンバーを含むグループの ID です。

Query Parameters

クエリ パラメーター	データ型	説明
top	Integer	返されるレコードの数です。既定値は 10です。範囲は 0 から 1000です。
skip	Integer	スキップするレコードの数です。既定値は 0です。

応答

200 OK

グループ メンバーのページングされたリストが、合計数とともに返されます。

404 見つかりません

指定した組織内で指定したグループが見つかりませんでした。

要求の例

API 呼び出しの構築に必要な情報をすべて収集したとします。

• {baseURL} は https://cloud.uipath.com/{organizationName}/identity_ です。
• {access_token} は 1234 です (長さを考慮)。
• {partitionGlobalId} は 3fa85f64-5717-4562-b3fc-2c963f66afa6 です。
• {groupId} は 2512 です。

呼び出しは次の例のようになります (cURL)。

curl --location --request GET 'https://cloud.uipath.com/{organizationName}/identity_/api/Group/3fa85f64-5717-4562-b3fc-2c963f66afa6/2512/Members?top=10&skip=0' \
--header 'Authorization: Bearer 1234' \
--header 'Content-Type: application/json'

呼び出しが成功した場合、応答本文は次のようになります。

{
    "totalCount": 2,
    "results": [
        {
            "id": "1787ef38-5933-4f2c-a67a-9c22cdb8e6a2",
            "type": 0
        },
        {
            "id": "a4c2e8b1-7d3f-4a91-b5e2-6f8d9c0e1a3b",
            "type": 0
        }
    ]
}