Freigeben über


Role Assignments - Put

Erstellen oder Aktualisieren einer Abrechnungsrollenzuweisung.

PUT https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingRoleAssignments/{billingRoleAssignmentName}?api-version=2019-10-01-preview

URI-Parameter

Name In Erforderlich Typ Beschreibung
billingAccountName
path True

string

Die ID, die ein Abrechnungskonto eindeutig identifiziert.

billingRoleAssignmentName
path True

string

Die ID, die eine Rollenzuweisung eindeutig identifiziert.

api-version
query True

string

Die Version der API, die mit der Clientanforderung verwendet werden soll. Die aktuelle Version ist 2019-10-01-preview.

Anforderungstext

Name Typ Beschreibung
properties.principalId

string

Die Prinzipal-ID des Benutzers, dem die Rolle zugewiesen wurde.

properties.principalTenantId

string

Die Prinzipalmandanten-ID des Benutzers, dem die Rolle zugewiesen wurde.

properties.roleDefinitionId

string

Die ID der Rollendefinition.

properties.userAuthenticationType

string

Der Authentifizierungstyp des Benutzers,unabhängig davon, ob organisation oder MSA, des Benutzers, dem die Rolle zugewiesen wurde. Dies wird nur für Abrechnungskonten mit dem Vertragstyp Enterprise Agreement unterstützt.

properties.userEmailAddress

string

Die E-Mail-Adresse des Benutzers, dem die Rolle zugewiesen wurde. Dies wird nur für Abrechnungskonten mit dem Vertragstyp Enterprise Agreement unterstützt.

Antworten

Name Typ Beschreibung
200 OK

BillingRoleAssignment

OK. Die Anforderung wurde erfolgreich durchgeführt.

Other Status Codes

ErrorResponse

Fehlerantwort mit Beschreibung des Grunds für den Fehler.

Sicherheit

azure_auth

Azure Active Directory OAuth2 Flow.

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name Beschreibung
user_impersonation Identitätswechsel Ihres Benutzerkontos

Beispiele

PutEnrollmentAdministratorRoleAssignment

Beispielanforderung

PUT https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingRoleAssignments/{billingRoleAssignmentName}?api-version=2019-10-01-preview

{
  "properties": {
    "principalId": "99a1a759-30dd-42c2-828c-db398826bb67",
    "principalTenantId": "7ca289b9-c32d-4f01-8566-7ff93261d76f",
    "roleDefinitionId": "/providers/Microsoft.Billing/billingAccounts/7898901/billingRoleDefinitions/9f1983cb-2574-400c-87e9-34cf8e2280db"
  }
}

Beispiel für eine Antwort

{
  "id": "/providers/Microsoft.Billing/billingAccounts/7898901/billingRoleAssignments/9dfd08c2-62a3-4d47-85bd-1cdba1408402",
  "name": "9dfd08c2-62a3-4d47-85bd-1cdba1408402",
  "properties": {
    "createdOn": "2019-06-28T19:11:50.6168809+00:00",
    "createdByPrincipalTenantId": "7ca289b9-c32d-4f01-8566-7ff93261d76f",
    "createdByPrincipalId": "60d97094-2be4-46cc-a4fe-3633021a25b9",
    "principalId": "99a1a759-30dd-42c2-828c-db398826bb67",
    "principalTenantId": "7ca289b9-c32d-4f01-8566-7ff93261d76f",
    "roleDefinitionId": "/providers/Microsoft.Billing/billingAccounts/7898901/billingRoleDefinitions/9f1983cb-2574-400c-87e9-34cf8e2280db",
    "scope": "/providers/Microsoft.Billing/billingAccounts/7898901"
  },
  "type": "Microsoft.Billing/billingAccounts/billingRoleAssignments"
}

Definitionen

Name Beschreibung
BillingRoleAssignment

Die Rollenzuweisung

ErrorDetails

Die Details des Fehlers.

ErrorResponse

Die Fehlerantwort gibt an, dass der Dienst die eingehende Anforderung nicht verarbeiten kann. Der Grund wird in der Fehlermeldung angegeben.

ErrorSubDetails

BillingRoleAssignment

Die Rollenzuweisung

Name Typ Beschreibung
id

string

Ressourcen-ID.

name

string

Name der Ressource.

properties.createdByPrincipalId

string

Die Prinzipal-ID des Benutzers, der die Rollenzuweisung erstellt hat.

properties.createdByPrincipalTenantId

string

Die Mandanten-ID des Benutzers, der die Rollenzuweisung erstellt hat.

properties.createdByUserEmailAddress

string

Die E-Mail-Adresse des Benutzers, der die Rollenzuweisung erstellt hat. Dies wird nur für Abrechnungskonten mit dem Vertragstyp Enterprise Agreement unterstützt.

properties.createdOn

string

Das Datum, an dem die Rollenzuweisung erstellt wurde.

properties.name

string

Der Name der Rollenzuweisung.

properties.principalId

string

Die Prinzipal-ID des Benutzers, dem die Rolle zugewiesen wurde.

properties.principalTenantId

string

Die Prinzipalmandanten-ID des Benutzers, dem die Rolle zugewiesen wurde.

properties.roleDefinitionId

string

Die ID der Rollendefinition.

properties.scope

string

Der Bereich, in dem die Rolle zugewiesen wurde.

properties.userAuthenticationType

string

Der Authentifizierungstyp des Benutzers,unabhängig davon, ob organisation oder MSA, des Benutzers, dem die Rolle zugewiesen wurde. Dies wird nur für Abrechnungskonten mit dem Vertragstyp Enterprise Agreement unterstützt.

properties.userEmailAddress

string

Die E-Mail-Adresse des Benutzers, dem die Rolle zugewiesen wurde. Dies wird nur für Abrechnungskonten mit dem Vertragstyp Enterprise Agreement unterstützt.

type

string

Der Ressourcentyp.

ErrorDetails

Die Details des Fehlers.

Name Typ Beschreibung
code

string

Fehlercode

details

ErrorSubDetails[]

Die Unterdetails des Fehlers.

message

string

Eine Fehlermeldung, die angibt, warum der Vorgang fehlgeschlagen ist.

target

string

Das Ziel des jeweiligen Fehlers.

ErrorResponse

Die Fehlerantwort gibt an, dass der Dienst die eingehende Anforderung nicht verarbeiten kann. Der Grund wird in der Fehlermeldung angegeben.

Name Typ Beschreibung
error

ErrorDetails

Die Details des Fehlers.

ErrorSubDetails

Name Typ Beschreibung
code

string

Fehlercode

message

string

Eine Fehlermeldung, die angibt, warum der Vorgang fehlgeschlagen ist.

target

string

Das Ziel des jeweiligen Fehlers.