Role Assignments - Create

Erstellt eine Rollenzuweisung.

PUT https://management.azure.com/{scope}/providers/Microsoft.Authorization/roleAssignments/{roleAssignmentName}?api-version=2015-07-01

URI-Parameter

Name In Required Type Description
roleAssignmentName
path True
  • string

Eine GUID für die zu erstellende Rollenzuweisung. Der Name muss eindeutig und für jede Rollenzuweisung unterschiedlich sein.

scope
path True
  • string

Der Bereich der zu erstellenden Rollenzuweisung. Der Bereich kann eine beliebige REST-Ressourceninstanz sein. Verwenden Sie beispielsweise '/abonnements/{subscription-id}/' für ein Abonnement, '/abonnements/{subscription-id}/resourceGroups/{resource-group-name}' für eine Ressourcengruppe und '/abonnements/{subscription-id}/resourceGroups/{resource-group-name}/providers/{resource-provider}/{resource-type}/{resource-type}/{resource-name}' für eine Ressource.

api-version
query True
  • string

Hierbei handelt es sich um die für diesen Vorgang zu verwendende API-Version.

Anforderungstext

Name Required Type Description
properties True

Rollenzuweisungseigenschaften.

Antworten

Name Type Description
201 Created

Erstellt – Gibt Informationen zur Rollenzuweisung zurück.

Other Status Codes

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ätswechsel Ihres Benutzerkontos

Beispiele

Create role assignment

Sample Request

PUT https://management.azure.com/scope/providers/Microsoft.Authorization/roleAssignments/roleAssignmentName?api-version=2015-07-01

{
  "properties": {
    "roleDefinitionId": "/subscriptions/4004a9fd-d58e-48dc-aeb2-4a4aec58606f/providers/Microsoft.Authorization/roleDefinitions/de139f84-1756-47ae-9be6-808fbbe84772",
    "principalId": "d93a38bc-d029-4160-bfb0-fbda779ac214"
  }
}

Sample Response

{
  "properties": {
    "roleDefinitionId": "/subscriptions/subId/providers/Microsoft.Authorization/roleDefinitions/roledefinitionId",
    "principalId": "Pid",
    "scope": "/subscriptions/subId/resourcegroups/rgname"
  },
  "id": "/subscriptions/subId/resourcegroups/rgname/providers/Microsoft.Authorization/roleAssignments/roleassignmentId",
  "type": "Microsoft.Authorization/roleAssignments",
  "name": "roleassignmentId"
}

Definitionen

ErrorAdditionalInfo

Der Fehler beim Ressourcenverwaltungsfehler.

ErrorDetail

Die Fehlerdetails.

ErrorResponse

Fehlerantwort

RoleAssignment

Rollenzuweisungen

RoleAssignmentCreateParameters

Rollenzuweisungen erstellen Parameter.

RoleAssignmentProperties

Rollenzuweisungseigenschaften.

RoleAssignmentPropertiesWithScope

Rollenzuweisungseigenschaften mit Bereich.

ErrorAdditionalInfo

Der Fehler beim Ressourcenverwaltungsfehler.

Name Type Description
info
  • object

Die zusätzlichen Informationen.

type
  • string

Der zusätzliche Infotyp.

ErrorDetail

Die Fehlerdetails.

Name Type Description
additionalInfo

Der Fehler, der zusätzliche Informationen enthält.

code
  • string

Der Fehlercode.

details

Die Fehlerdetails.

message
  • string

Die Fehlermeldung.

target
  • string

Das Fehlerziel.

ErrorResponse

Fehlerantwort

Name Type Description
error

Das Fehlerobjekt.

RoleAssignment

Rollenzuweisungen

Name Type Description
id
  • string

Hierbei handelt es sich um die Rollenzuweisungs-ID.

name
  • string

Der Rollenzuweisungsname.

properties

Rollenzuweisungseigenschaften.

type
  • string

Der Rollenzuweisungstyp.

RoleAssignmentCreateParameters

Rollenzuweisungen erstellen Parameter.

Name Type Description
properties

Rollenzuweisungseigenschaften.

RoleAssignmentProperties

Rollenzuweisungseigenschaften.

Name Type Description
principalId
  • string

Die Prinzipal-ID, die der Rolle zugewiesen ist. Dadurch wird die ID innerhalb des Active Directory zugeordnet. Sie kann auf eine Benutzer-, Dienstprinzipal- oder Sicherheitsgruppe verweisen.

roleDefinitionId
  • string

Die rollendefinitions-ID, die in der Rollenzuweisung verwendet wird.

RoleAssignmentPropertiesWithScope

Rollenzuweisungseigenschaften mit Bereich.

Name Type Description
principalId
  • string

Die Prinzipal-ID.

roleDefinitionId
  • string

Hierbei handelt es sich um die Rollendefinitions-ID.

scope
  • string

Der Rollenzuweisungsbereich.