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 參數

名稱 位於 必要 類型 Description
scope
path True

string

角色定義的範圍。

api-version
query True

string

用於此作業的 API 版本。

$filter
query

string

要套用至作業的篩選。 使用 atScopeAndBelow 篩選條件,在指定的範圍下方搜尋。

回應

名稱 類型 Description
200 OK

RoleDefinitionListResult

確定 - 傳回角色定義的陣列。

Other Status Codes

ErrorResponse

描述作業失敗原因的錯誤回應。

權限

若要呼叫此 API,您必須獲指派具有下列權限的角色。 如需詳細資訊,請參閱 Azure 內建角色

Microsoft.Authorization/roleDefinitions/read

安全性

azure_auth

Azure Active Directory OAuth2 Flow

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

Scopes

名稱 Description
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"
    }
  ]
}

定義

名稱 Description
ErrorAdditionalInfo

資源管理錯誤其他資訊。

ErrorDetail

錯誤詳細數據。

ErrorResponse

錯誤回應

Permission

角色定義許可權。

RoleDefinition

角色定義。

RoleDefinitionListResult

角色定義清單作業結果。

ErrorAdditionalInfo

資源管理錯誤其他資訊。

名稱 類型 Description
info

object

其他資訊。

type

string

其他信息類型。

ErrorDetail

錯誤詳細數據。

名稱 類型 Description
additionalInfo

ErrorAdditionalInfo[]

錯誤其他資訊。

code

string

錯誤碼。

details

ErrorDetail[]

錯誤詳細資料。

message

string

錯誤訊息。

target

string

錯誤目標。

ErrorResponse

錯誤回應

名稱 類型 Description
error

ErrorDetail

error 物件。

Permission

角色定義許可權。

名稱 類型 Description
actions

string[]

允許的動作。

dataActions

string[]

允許的數據動作。

notActions

string[]

拒絕的動作。

notDataActions

string[]

拒絕的數據動作。

RoleDefinition

角色定義。

名稱 類型 Description
id

string

角色定義識別碼。

name

string

角色定義名稱。

properties.assignableScopes

string[]

角色定義可指派的範圍。

properties.createdBy

string

建立指派的使用者標識碼

properties.createdOn

string

建立時間

properties.description

string

角色定義描述。

properties.permissions

Permission[]

角色定義許可權。

properties.roleName

string

角色名稱。

properties.type

string

角色類型。

properties.updatedBy

string

更新指派的使用者標識碼

properties.updatedOn

string

更新時間

type

string

角色定義類型。

RoleDefinitionListResult

角色定義清單作業結果。

名稱 類型 Description
nextLink

string

要用於取得下一組結果的URL。

value

RoleDefinition[]

角色定義清單。