Hitachi

Hitachi Command Suite Configuration Manager REST API リファレンスガイド


4.11 ユーザグループの一覧を取得する

対象のストレージシステムに登録されているユーザグループの一覧を取得します。

実行権限

セキュリティ管理者(参照)

リクエストライン

GET <ベースURL>/v1/objects/storages/<ストレージデバイスID>/user-groups

リクエストメッセージ

オブジェクトID

なし。

クエリパラメータ

なし。

ボディ

なし。

レスポンスメッセージ

ボディ
{
  "data": [
    {
      "userGroupObjectId": "devGroup",
      "userGroupId": "devGroup",
      "roleNames": [
        "Audit Log Administrator (View & Modify)"
      ],
      "resourceGroupIds": [
        1,
        2,
        3
      ],
      "isBuiltIn": false,
      "hasAllResourceGroup": false
    },
    {
      "userGroupObjectId": "adminGroup",
      "userGroupId": "adminGroup",
      "roleNames": [
        "Audit Log Administrator (View & Modify)",
        "Security Administrator (View & Modify)",
        "Storage Administrator (Initial Configuration)",
        "Storage Administrator (Local Copy)",
        "Storage Administrator (Performance Management)",
        "Storage Administrator (Provisioning)",
        "Storage Administrator (Remote Copy)",
        "Storage Administrator (System Resource Management)"
      ],
      "isBuiltIn": false,
      "hasAllResourceGroup": true
    }
  ]
}

属性

説明

userGroupObjectId

string

ユーザグループIDのオブジェクトID

ユーザグループIDがRFC3986 に定められた予約文字を含む場合、エンコードされた文字列が出力されます。

userGroupId

string

ユーザグループID

roleNames

string[]

ユーザグループに割り当てたロール名

resourceGroupIds

int[]

ユーザグループに割り当てたリソースグループのID

isBuiltIn

boolean

ビルトインユーザグループかどうか

  • true:ビルトインユーザグループ

  • false:ユーザが作成したユーザグループ

hasAllResourceGroup

boolean

全リソースグループが対象に割り当たっているかどうか

  • true:全リソースグループが割り当てられている

  • false:指定したリソースグループが割り当てられている

ステータスコード

この操作のリクエストに対するステータスコードについては、HTTPステータスコードの説明を参照してください。

コード例

curl -v -H "Accept:application/json" -H "Content-Type:application/json" -H "Authorization:Session b74777a3-f9f0-4ea8-bd8f-09847fac48d3" -X GET https://192.0.2.100:23451/ConfigurationManager/v1/objects/storages/836000123456/user-groups