Role Definitions - List

Haal alle roldefinities op die van toepassing zijn op bereik en hoger.

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-parameters

Name In Vereist Type Description
scope
path True

string

Het bereik van de roldefinitie.

api-version
query True

string

De API-versie die voor deze bewerking moet worden gebruikt.

$filter
query

string

Het filter dat moet worden toegepast op de bewerking. Gebruik het atScopeAndBelow-filter om ook onder het opgegeven bereik te zoeken.

Antwoorden

Name Type Description
200 OK

RoleDefinitionListResult

OK: retourneert een matrix met roldefinities.

Other Status Codes

ErrorResponse

Foutreactie waarin wordt beschreven waarom de bewerking is mislukt.

Machtigingen

Als u deze API wilt aanroepen, moet er aan u een rol zijn toegewezen met de volgende machtigingen. Zie Ingebouwde rollen in Azure voor meer informatie.

Microsoft.Authorization/roleDefinitions/read

Beveiliging

azure_auth

Azure Active Directory OAuth2-stroom

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

Scopes

Name Description
user_impersonation uw gebruikersaccount imiteren

Voorbeelden

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"
    }
  ]
}

Definities

Name Description
ErrorAdditionalInfo

Aanvullende informatie over de resourcebeheerfout.

ErrorDetail

De foutdetails.

ErrorResponse

Foutreactie

Permission

Roldefinitiemachtigingen.

RoleDefinition

Roldefinitie.

RoleDefinitionListResult

Resultaat van bewerking in lijst met roldefinities.

ErrorAdditionalInfo

Aanvullende informatie over de resourcebeheerfout.

Name Type Description
info

object

De aanvullende informatie.

type

string

Het type aanvullende informatie.

ErrorDetail

De foutdetails.

Name Type Description
additionalInfo

ErrorAdditionalInfo[]

Aanvullende informatie over de fout.

code

string

De foutcode.

details

ErrorDetail[]

De foutdetails.

message

string

Het foutbericht.

target

string

Het foutdoel.

ErrorResponse

Foutreactie

Name Type Description
error

ErrorDetail

Het foutobject.

Permission

Roldefinitiemachtigingen.

Name Type Description
actions

string[]

Toegestane acties.

dataActions

string[]

Toegestane gegevensacties.

notActions

string[]

Geweigerde acties.

notDataActions

string[]

Gegevensacties geweigerd.

RoleDefinition

Roldefinitie.

Name Type Description
id

string

De roldefinitie-id.

name

string

De naam van de roldefinitie.

properties.assignableScopes

string[]

Toewijsbare bereiken voor roldefinities.

properties.createdBy

string

Id van de gebruiker die de toewijzing heeft gemaakt

properties.createdOn

string

Tijdstip waarop deze is gemaakt

properties.description

string

De beschrijving van de roldefinitie.

properties.permissions

Permission[]

Roldefinitiemachtigingen.

properties.roleName

string

De naam van de rol.

properties.type

string

Het roltype.

properties.updatedBy

string

Id van de gebruiker die de toewijzing heeft bijgewerkt

properties.updatedOn

string

Tijdstip waarop deze is bijgewerkt

type

string

Het roldefinitietype.

RoleDefinitionListResult

Resultaat van bewerking in lijst met roldefinities.

Name Type Description
nextLink

string

De URL die moet worden gebruikt om de volgende set resultaten op te halen.

value

RoleDefinition[]

Lijst met roldefinities.