Role Definitions - List

スコープ以上で適用可能なすべてのロール定義を取得します。

GET https://management.azure.com/{scope}/providers/Microsoft.Authorization/roleDefinitions?api-version=2022-04-01
GET https://management.azure.com/{scope}/providers/Microsoft.Authorization/roleDefinitions?$filter={$filter}&api-version=2022-04-01

URI パラメーター

名前 / 必須 説明
scope
path True

string

ロール定義のスコープ。

api-version
query True

string

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

$filter
query

string

操作に適用するフィルター。 atScopeAndBelow フィルターを使用して、指定されたスコープの下でも検索します。

応答

名前 説明
200 OK

RoleDefinitionListResult

OK - ロール定義の配列を返します。

Other Status Codes

ErrorResponse

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

アクセス許可

この API を呼び出すには、次のアクセス許可を持つロールがお客様に割り当てられている必要があります。 詳細については、Azure の組み込みロールに関するページを参照してください。

Microsoft.Authorization/roleDefinitions/read

セキュリティ

azure_auth

Azure Active Directory OAuth2 フロー

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

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

List role definitions for scope

Sample Request

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

Sample Response

{
  "value": [
    {
      "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

ロールの定義。

RoleDefinitionListResult

ロール定義リスト操作の結果。

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

ロール定義の種類。

RoleDefinitionListResult

ロール定義リスト操作の結果。

名前 説明
nextLink

string

次の結果セットを取得するために使用する URL。

value

RoleDefinition[]

ロール定義の一覧。