4.13　ユーザグループを作成する

メモ

REST API を実行するユーザが、対象ストレージシステムのリソースをREST API でロックしている場合、このAPIは実行できません。その場合は、ロックを解除してから実行してください。

実行権限

セキュリティ管理者（参照・編集）

リクエストライン

POST ＜ベースURL＞/v1/objects/storages/＜ストレージデバイスID＞/user-groups

リクエストメッセージ

オブジェクトID

なし。

クエリパラメータ

なし。

ボディ

{
  "userGroupId":"devGroup",
  "roleNames":[
    "Storage Administrator (Provisioning)"
  ],
  "resourceGroupIds": [
    8,
    9
  ],
  "hasAllResourceGroup":false
}

属性	型	説明
userGroupId	string	（必須）ユーザグループID 1～64文字で指定します。
roleNames	string[]	（必須）ロール名 次のロール名を指定します。大文字と小文字を区別します。複数指定する場合はコンマで区切ります。 Storage Administrator (View Only)は必ず指定してください。 Audit Log Administrator (View & Modify)※ Audit Log Administrator (View Only)※ Security Administrator (View & Modify)※ Security Administrator (View Only)※ Storage Administrator (Initial Configuration) Storage Administrator (Local Copy) Storage Administrator (Performance Management) Storage Administrator (Provisioning) Storage Administrator (Remote Copy) Storage Administrator (System Resource Management) Storage Administrator (View Only) Support Personnel※ User Maintenance※ 注※：このロールを指定する場合は、必ずhasAllResourceGroupにtrueを指定してください。
resourceGroupIds	int[]	（任意）リソースグループID 0～1023の10進数で指定します。複数指定する場合はコンマで区切ります。hasAllResourceGroup属性がtrueの場合は指定できません。
hasAllResourceGroup	boolean	（必須）全リソースグループを対象に割り当てるかどうか roleNamesに指定するロールに次のどれかが含まれている場合は、必ずtrueを指定してください。 Audit Log Administrator (View & Modify) Audit Log Administrator (View Only) Security Administrator (View & Modify) Security Administrator (View Only) Support Personnel User Maintenance どれも含まれていない場合は、必ずfalseを指定してください。

レスポンスメッセージ

ボディ

ジョブオブジェクトを返します。affectedResources以外の属性については、ジョブオブジェクトの説明を参照してください。

属性	説明
affectedResources	作成したユーザグループのURL

ステータスコード

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

コード例

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