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

:ListGroups

最終更新日:Mar 30, 2026

Employee Identity and Access Management (EIAM) のグループ情報をページ単位で取得します。

今すぐお試しください

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

テスト

RAM 認証

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

リクエスト構文

GET /v2/{instanceId}/{applicationId}/groups HTTP/1.1

パスパラメータ

パラメーター

必須 / 任意

説明

instanceId

string

必須

インスタンス ID。

idaas_ue2jvisn35ea5lmthk267xxxxx

applicationId

string

必須

アプリケーション ID。

app_mkv7rgt4d7i4u7zqtzev2mxxxx

リクエストパラメーター

パラメーター

必須 / 任意

説明

Authorization

string

必須

認証情報。値は Bearer ${access_token} 形式です(例: Bearer ATxxxx)。

Bearer xxxx

groupNameStartWith

string

任意

グループ名のプレフィックス。

group_xxx

nextToken

string

任意

次回クエリの開始位置を示すトークン。

NTxxx

maxResults

integer

任意

1 ページあたりの最大エントリ数。デフォルト値:20。

20

レスポンスフィールド

フィールド

説明

object

DeveloperNextTokenResponse

totalCount

integer

返されたエントリの合計数。

1000

data

array<object>

返されたデータ。

object

返されたデータ。

instanceId

string

インスタンス ID。

idaas_ue2jvisn35ea5lmthk267xxxxx

groupId

string

グループ ID。

group_ufdsasn35ea5lmthk267xxxxx

groupName

string

グループ名。

name_test

description

string

グループの説明文。

description_demo

groupExternalId

string

グループの外部 ID。

group_ufdsasn35ea5lmthk267xxxxx

groupSourceType

string

グループのソース種別。有効な値: build_in、ding_talk、ad、ldap。

build_in

groupSourceId

string

グループのソース ID。

idaas_ue2jvisn35ea5lmthk267xxxxx

createTime

integer

グループが作成された時刻。値は UNIX タイムスタンプ(ミリ秒単位)です。

1652085686179

updateTime

integer

グループが最後に更新された時刻。値は UNIX タイムスタンプ(ミリ秒単位)です。

1652085686179

nextToken

string

クエリの開始位置を示すトークン。このパラメーターを空欄のままにした場合、クエリは先頭から開始されます。

NTxxx

maxResults

integer

返される最大エントリ数。

20

成功レスポンス

JSONJSON

{
  "totalCount": 1000,
  "data": [
    {
      "instanceId": "idaas_ue2jvisn35ea5lmthk267xxxxx",
      "groupId": "group_ufdsasn35ea5lmthk267xxxxx",
      "groupName": "name_test",
      "description": "description_demo",
      "groupExternalId": "group_ufdsasn35ea5lmthk267xxxxx",
      "groupSourceType": "build_in",
      "groupSourceId": "idaas_ue2jvisn35ea5lmthk267xxxxx",
      "createTime": 1652085686179,
      "updateTime": 1652085686179
    }
  ],
  "nextToken": "NTxxx",
  "maxResults": 20
}

エラーコード

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

変更履歴

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