メインコンテンツまでスキップ

グループの一覧表示 (V2)

呼び出し元の組織内の SCIM グループを一覧表示します。

GET/v2/groups
接続エンドポイント

https://api.cloud.zilliz.com

shell
export BASE_URL="https://api.cloud.zilliz.com"
パラメータ
Authorizationstringheader必要

認証トークンには、適切な権限を持つ API key を使用する必要があります。

値の例： Bearer {{TOKEN}}
groupNamestringquery

グループの表示名と照合する部分文字列。

値の例： eng
currentPageintegerquery

返すページ番号。最初のページは 1 です。

値の例： 1
pageSizeintegerquery

1 ページあたりに返す項目数。

値の例： 10
bash
export TOKEN="YOUR_API_KEY"

curl --request GET \
--url "${BASE_URL}/v2/groups" \
--header "Authorization: Bearer ${TOKEN}" \
--header "Request-Timeout: 5" \
--header "Content-Type: application/json"
レスポンス200 OK - application/json

成功した結果またはエラーメッセージを返します。

成功レスポンス。

codeinteger必要

レスポンスコード。

値の例： 0
dataobject必要
countinteger必要

一致する項目の総数。

currentPageinteger必要

現在のページ番号。

値の範囲： ≥ 1
pageSizeinteger必要

要求されたページサイズ。

値の範囲： ≥ 1
groupsarray必要

このページで返されるグループ。

[]groupsobject必要
groupIdstring必要

SCIM グループ ID。

groupNamestring必要

グループの表示名。

memberCountinteger必要

グループ内のメンバー数。

失敗レスポンス。

codeinteger必要

レスポンスコード。

messagestring必要

エラーメッセージ。

Successjson
{
    "code": 0,
    "data": {
        "count": 2,
        "currentPage": 1,
        "pageSize": 10,
        "groups": [
            {
                "groupId": "g-xxxxxxxxxxxxxx",
                "groupName": "engineering",
                "memberCount": 12
            },
            {
                "groupId": "g-yyyyyyyyyyyyyy",
                "groupName": "data-readers",
                "memberCount": 3
            }
        ]
    }
}
Ctrl I