次の方法で共有


Role Definitions - Create Or Update

ロール定義を作成または更新します。

PUT https://management.azure.com/{scope}/providers/Microsoft.Authorization/roleDefinitions/{roleDefinitionId}?api-version=2022-04-01

URI パラメーター

名前 / 必須 説明
roleDefinitionId
path True

string

ロール定義の ID。

scope
path True

string

ロール定義のスコープ。

api-version
query True

string

この操作に使用する API バージョン。

要求本文

名前 説明
properties.assignableScopes

string[]

ロール定義の割り当て可能なスコープ。

properties.description

string

ロール定義の説明。

properties.permissions

Permission[]

ロール定義のアクセス許可。

properties.roleName

string

ロール名。

properties.type

string

ロールの種類。

応答

名前 説明
201 Created

RoleDefinition

OK - ロール定義に関する情報を返します。

Other Status Codes

ErrorResponse

操作に失敗した理由を説明するエラー応答。

セキュリティ

azure_auth

Azure Active Directory OAuth2 フロー

型: oauth2
フロー: implicit
Authorization URL (承認 URL): https://login.microsoftonline.com/common/oauth2/authorize

スコープ

名前 説明
user_impersonation ユーザー アカウントの借用

Create role definition

要求のサンプル

PUT https://management.azure.com/scope/providers/Microsoft.Authorization/roleDefinitions/roleDefinitionId?api-version=2022-04-01

{}

応答のサンプル

{
  "properties": {
    "roleName": "Role name",
    "type": "roletype",
    "description": "Role description",
    "assignableScopes": [
      "/subscriptions/subId"
    ],
    "permissions": [
      {
        "actions": [
          "action"
        ],
        "notActions": [],
        "dataActions": [
          "dataAction"
        ],
        "notDataActions": []
      }
    ]
  },
  "id": "/subscriptions/subID/providers/Microsoft.Authorization/roleDefinitions/roleDefinitionId",
  "type": "Microsoft.Authorization/roleDefinitions",
  "name": "roleDefinitionId"
}

定義

名前 説明
ErrorAdditionalInfo

リソース管理エラーの追加情報。

ErrorDetail

エラーの詳細。

ErrorResponse

エラー応答

Permission

ロール定義のアクセス許可。

RoleDefinition

ロールの定義。

ErrorAdditionalInfo

リソース管理エラーの追加情報。

名前 説明
info

object

追加情報。

type

string

追加情報の種類。

ErrorDetail

エラーの詳細。

名前 説明
additionalInfo

ErrorAdditionalInfo[]

エラーの追加情報。

code

string

エラー コード。

details

ErrorDetail[]

エラーの詳細です。

message

string

エラー メッセージ。

target

string

エラーのターゲット。

ErrorResponse

エラー応答

名前 説明
error

ErrorDetail

error オブジェクト。

Permission

ロール定義のアクセス許可。

名前 説明
actions

string[]

許可されるアクション。

dataActions

string[]

許可されるデータ アクション。

notActions

string[]

拒否されたアクション。

notDataActions

string[]

拒否されたデータ アクション。

RoleDefinition

ロールの定義。

名前 説明
id

string

ロール定義 ID

name

string

ロール定義名。

properties.assignableScopes

string[]

ロール定義の割り当て可能なスコープ。

properties.createdBy

string

割り当てを作成したユーザーの ID

properties.createdOn

string

作成された時刻

properties.description

string

ロール定義の説明。

properties.permissions

Permission[]

ロール定義のアクセス許可。

properties.roleName

string

ロール名。

properties.type

string

ロールの種類。

properties.updatedBy

string

割り当てを更新したユーザーの ID

properties.updatedOn

string

更新された時刻

type

string

ロール定義の種類。