Enrollment Account Role Assignments - Put

Service:

Billing

API Version:

2019-10-01-preview

Erstellen oder Aktualisieren einer Abrechnungsrollenzuweisung.

PUT https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/enrollmentAccounts/{enrollmentAccountName}/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.
enrollmentAccountName	path	True	string	Die ID, die ein Registrierungskonto 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.

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

Scopes

Name	Beschreibung
user_impersonation	Identitätswechsel Ihres Benutzerkontos

Beispiele

PutEnrollmentAccountSubscriptionCreatorRoleAssignment

Sample Request

HTTP

PUT https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/enrollmentAccounts/{enrollmentAccountName}/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/enrollmentAccounts/225314/billingRoleDefinitions/a0bcee42-bf30-4d1b-926a-48d21664ef71"
  }
}

Sample Response

Status code:

200

{
  "id": "/providers/Microsoft.Billing/billingAccounts/7898901/enrollmentAccounts/225314/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/enrollmentAccounts/225314/billingRoleDefinitions/a0bcee42-bf30-4d1b-926a-48d21664ef71",
    "scope": "/providers/Microsoft.Billing/billingAccounts/7898901/enrollmentAccounts/225314"
  },
  "type": "Microsoft.Billing/billingAccounts/enrollmentAccounts/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.