/auth/v1/groups: ゲット

システムで作成されたグループのリストを取得します。

以下の表に、この REST API エンドポイントにアクセスできるロールを示します。

表 1. 役割によるアクセス
データ管理者	データ・ユーザー	コレクション管理者	管理者	サービス・ユーザー
^✓1	^✓1	✓	✓	^✓1
¹指定するグループは、要求側ユーザー ID に割り当てられているグループでなければなりません。そうでない場合、コマンドはエラー 403「Not authorized」で失敗します。

リクエストの概要 URL

curl -k  -H ‘Authorization: Bearer <token>’ https://<data_cataloging_host>/auth/v1/groups

サポートされる要求タイプと応答形式

サポートされる要求タイプ:

サポートされる応答形式:

JSON

examples

以下の例は、システムで作成された使用の詳細を取得する方法を示しています。

要求:

curl -k  -H ‘Authorization: Bearer <token>’ https://<data_cataloging_host>/auth/v1/groups

回答：

(200 OK): 
{ 
    "groups": [ 
        { 
"id": "a51f84bfeb034b12a9a362109d78bec3", 
            "name": "test-group1", 
            "description": "Test Group 1", 
            "domain": "default" 
        }, 
        { 
"id": "b62g95bfeb034b12a9a362109d89cfd4", 
            "name": "test-group2", 
            "description": "Test Group 2", 
            "domain": "default" 
        } 
    ] 
}