Role Definitions - Get

Referenz

Service:: Authorization

API Version:: 2015-07-01

Abrufen der Rollendefinition anhand des Namens (GUID).

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

URI-Parameter

Name	In	Required	Type	Description
roleDefinitionId	path	True	string	Die ID der Rollendefinition.
scope	path	True	string	Der Bereich der Rollendefinition.
api-version	query	True	string	Hierbei handelt es sich um die für diesen Vorgang zu verwendende API-Version.

Antworten

Name	Type	Description
200 OK	RoleDefinition	OK: Gibt Informationen zur Rollendefinition zurück.
Other Status Codes	ErrorResponse	Fehlerantwort mit Beschreibung des Grunds für den Fehler.

Sicherheit

azure_auth

Azure Active Directory OAuth2-Flow

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

Scopes

Name	Description
user_impersonation	Identität Ihres Benutzerkontos annehmen

Beispiele

Get role definition by name

Sample Request

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

Sample Response

Status code:: 200

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

Definitionen

ErrorAdditionalInfo	Zusätzliche Informationen zu Ressourcenverwaltungsfehlern.
ErrorDetail	Die Fehlerdetails.
ErrorResponse	Fehlerantwort
Permission	Rollendefinitionsberechtigungen.
RoleDefinition	Rollendefinition.

ErrorAdditionalInfo

Zusätzliche Informationen zu Ressourcenverwaltungsfehlern.

Name	Type	Description
info	object	Die zusätzlichen Informationen.
type	string	Der zusätzliche Infotyp.

ErrorDetail

Die Fehlerdetails.

Name	Type	Description
additionalInfo	ErrorAdditionalInfo[]	Die zusätzlichen Fehlerinformationen.
code	string	Der Fehlercode.
details	ErrorDetail[]	Die Fehlerdetails.
message	string	Die Fehlermeldung.
target	string	Das Fehlerziel.

ErrorResponse

Fehlerantwort

Name	Type	Description
error	ErrorDetail	Das Fehlerobjekt.

Permission

Rollendefinitionsberechtigungen.

Name	Type	Description
actions	string[]	Zulässige Aktionen.
notActions	string[]	Abgelehnte Aktionen.

RoleDefinition

Rollendefinition.

Name	Type	Description
id	string	Hierbei handelt es sich um die Rollendefinitions-ID.
name	string	Der Name der Rollendefinition.
properties.assignableScopes	string[]	Zuweisbare Bereiche für Rollendefinitionen.
properties.description	string	Die Beschreibung der Rollendefinition.
properties.permissions	Permission[]	Rollendefinitionsberechtigungen.
properties.roleName	string	Der Name der Rolle.
properties.type	string	Der Rollentyp.
type	string	Der Rollendefinitionstyp.