ロール作成

Description

サブユーザー作成時に必須となるロールを作成します。

・ ロール作成時において、「permissions」の指定が必須になります。
・ 指定可能な「permissions」数は1つ、または複数を指定できます。
・ 「permissions」は「name」で指定します。
・ ロール名に使える文字列は「半角英数字（a〜z、A〜Z、0〜9）、アンダースコア（_）、ハイフン（-）のみを使った、1文字以上32文字以内の文字列」となります。
・ ロールの作成上限は500となります。

Request URL

Identity API

POST /v3/sub-users/roles

Request Json

・1つのパーミッションを指定する場合

{
  "role": {
    "name": "myrole",
    "permissions": [
      "パーミッション名"
    ]
  }
}

・複数のパーミッションを指定する場合

{
  "role": {
    "name": "myrole",
    "permissions": [
      "パーミッション名",
      "パーミッション名",
      "パーミッション名"
    ]
  }
}

Request Parameters

Parameter Value Style Description
X-Auth-Token トークン header トークンの情報を指定します。
トークンの発行方法は、トークン発行 にてご確認ください。
name ロール名 body ロール名を指定します。ロール名に使える文字列は「半角英数字（a〜z、A〜Z、0〜9）、アンダースコア（_）、ハイフン（-）のみを使った、1文字以上32文字以内の文字列」となります。
permissions パーミッション名 body パーミッション名を指定します。
パーミッション名の確認方法は、パーミッション一覧取得 を実行の上、レスポンス結果から対象のパーミッション名をご確認ください。

Response Code

Success 

200

Example

Request 

curl -X POST 
-H "Accept: application/json" 
-H "X-Auth-Token: トークン" 
-d '{"role": {"name": "myrole","permissions": ["パーミッション名","パーミッション名"]}}' 
https://identity.c3j1.conoha.io/v3/sub-users/roles

Response 

{
  "role": {
    "id": "ロールID",
    "name": "ロール名",
    "visibility": "private",
    "permissions": [
      "パーミッション名",
      "パーミッション名"
    ]
  }
}

ConoHaにて提供しておりますAPIにつきましては、クラウド基盤として採用しておりますOpenStackの機能にて実装しておりますので、詳細な情報や使い方はOpenStackのドキュメントにてご確認ください。

おトクなキャンペーン情報