Role Definitions - Get

依名稱 (GUID) 取得角色定義。

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

URI 參數

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

string

角色定義的識別碼。

scope
path True

string

角色定義的範圍。

api-version
query True

string

用於此作業的 API 版本。

回應

名稱 類型 Description
200 OK

RoleDefinition

確定 - 傳回角色定義的相關信息。

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 模擬您的用戶帳戶

範例

Get role definition by name

Sample Request

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

Sample Response

{
  "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

角色定義。

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

角色定義類型。