Billing Role Assignments - Resolve By Billing Profile
Listet die Rollenzuweisungen für den Anrufer in einem Abrechnungsprofil auf, während Benutzerinformationen für jede Rollenzuweisung abgerufen werden. Der Vorgang wird für Abrechnungskonten mit dem Vertragstyp Microsoft Partner Agreement oder Microsoft Customer Agreement unterstützt.
POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/resolveBillingRoleAssignments?api-version=2024-04-01
POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/resolveBillingRoleAssignments?resolveScopeDisplayNames={resolveScopeDisplayNames}&api-version=2024-04-01&filter={filter}
URI-Parameter
Name | In | Erforderlich | Typ | Beschreibung |
---|---|---|---|---|
billing
|
path | True |
string |
Die ID, die ein Abrechnungskonto eindeutig identifiziert. RegEx-Muster: |
billing
|
path | True |
string |
Die ID, die ein Abrechnungsprofil eindeutig identifiziert. RegEx-Muster: |
api-version
|
query | True |
string |
Die Version der API, die mit der Clientanforderung verwendet werden soll. Die aktuelle Version ist 2024-04-01. |
filter
|
query |
string |
Mit der Filterabfrageoption können Clients eine Sammlung von Ressourcen filtern, die von einer Anforderungs-URL adressiert werden. |
|
resolve
|
query |
boolean |
Löst den Anzeigenamen des Bereichs für jede Rollenzuweisung auf. |
Antworten
Name | Typ | Beschreibung |
---|---|---|
200 OK |
Die Liste der Abrechnungsrollenzuweisungen. |
|
202 Accepted |
Die Liste der Abrechnungsrollenzuweisungen. Header
|
|
Other Status Codes |
Fehlerantwort, die beschreibt, warum der Vorgang fehlgeschlagen ist. |
Beispiele
ResolveBillingRoleAssignmentByBillingProfile
Beispielanforderung
Beispiel für eine Antwort
{
"value": [
{
"id": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2018-09-30/billingProfiles/xxxx-xxxx-xxx-xxx/billingRoleAssignments/10000000-aaaa-bbbb-cccc-100000000000_6fd330f6-7d26-4aff-b9cf-7bd699f965b9",
"name": "10000000-aaaa-bbbb-cccc-100000000000_6fd330f6-7d26-4aff-b9cf-7bd699f965b9",
"properties": {
"createdOn": "2023-10-19T20:10:50.1028398Z",
"createdByPrincipalTenantId": "076915e7-de10-4323-bb34-a58c904068bb",
"createdByPrincipalId": "00000000-0000-0000-0000-000000000001",
"principalId": "00000000-0000-0000-0000-000000000000",
"roleDefinitionId": "providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2018-09-30/billingProfiles/xxxx-xxxx-xxx-xxx/billingRoleDefinitions/00000000-0000-0000-0000-000000000000",
"scope": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2018-09-30/billingProfiles/xxxx-xxxx-xxx-xxx",
"principalType": "User"
},
"type": "Microsoft.Billing/billingAccounts/billingProfiles/billingRoleAssignments"
},
{
"id": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2018-09-30/billingProfiles/xxxx-xxxx-xxx-xxx/billingRoleAssignments/10000000-aaaa-bbbb-cccc-100000000000_b1839933-b3ac-42ca-8112-d29c43f3ab47",
"name": "10000000-aaaa-bbbb-cccc-100000000000_b1839933-b3ac-42ca-8112-d29c43f3ab47",
"properties": {
"createdOn": "2023-10-19T20:10:50.1028398Z",
"createdByPrincipalTenantId": "076915e7-de10-4323-bb34-a58c904068bb",
"createdByPrincipalId": "00000000-0000-0000-0000-000000000001",
"principalId": "00000000-0000-0000-0000-000000000000",
"roleDefinitionId": "providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2018-09-30/billingProfiles/xxxx-xxxx-xxx-xxx/billingRoleDefinitions/00000000-0000-0000-0000-000000000001",
"scope": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2018-09-30/billingProfiles/xxxx-xxxx-xxx-xxx",
"principalType": "User"
},
"type": "Microsoft.Billing/billingAccounts/billingProfiles/billingRoleAssignments"
}
]
}
location: https://management.azure.com/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2018-09-30/billingProfiles/xxxx-xxxx-xxx-xxx/operationResults/resolveBillingRoleAssignments_10000000-0000-0000-0000-000000000001?api-version=2024-04-01
retry-after: 5
Definitionen
Name | Beschreibung |
---|---|
Billing |
Die Eigenschaften der Abrechnungsrollenzuweisung. |
Billing |
Ein Container für eine Liste von Ressourcen |
Billing |
Die Eigenschaften der Abrechnungsrollenzuweisung. |
created |
Der Identitätstyp, der die Ressource erstellt hat. |
Error |
Der Ressourcenverwaltungsfehler zusätzliche Informationen. |
Error |
Das Fehlerdetails. |
Error |
Fehlerantwort |
Principal |
Der Typ einer Rollenzuweisung. |
Provisioning |
Der Bereitstellungsstatus der Ressource während eines dauerhaften Vorgangs. |
system |
Metadaten zur Erstellung und letzten Änderung der Ressource. |
BillingRoleAssignment
Die Eigenschaften der Abrechnungsrollenzuweisung.
Name | Typ | Beschreibung |
---|---|---|
id |
string |
Vollqualifizierte Ressourcen-ID für die Ressource. Z. B. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
name |
string |
Der Name der Ressource |
properties |
Die Eigenschaften der Abrechnungsrollenzuweisung. |
|
systemData |
Azure Resource Manager-Metadaten, die createdBy- und modifiedBy-Informationen enthalten. |
|
tags |
object |
Wörterbuch der Metadaten, die der Ressource zugeordnet sind. Möglicherweise wird sie nicht für alle Ressourcentypen aufgefüllt. Maximale Schlüssel-/Wertlänge unterstützt von 256 Zeichen. Schlüssel/Wert dürfen keinen leeren Wert oder null sein. Schlüssel können nicht <> % & \ enthalten? / |
type |
string |
Der Typ der Ressource. Z. B. "Microsoft.Compute/virtualMachines" oder "Microsoft.Storage/storageAccounts" |
BillingRoleAssignmentListResult
Ein Container für eine Liste von Ressourcen
Name | Typ | Beschreibung |
---|---|---|
nextLink |
string |
Der Link (URL) zur nächsten Seite der Ergebnisse. |
value |
Die Liste der Ressourcen. |
BillingRoleAssignmentProperties
Die Eigenschaften der Abrechnungsrollenzuweisung.
Name | Typ | Beschreibung |
---|---|---|
billingAccountDisplayName |
string |
Der Name des Abrechnungskontos. |
billingAccountId |
string |
Die vollqualifizierte ID, die ein Abrechnungskonto eindeutig identifiziert. |
billingProfileDisplayName |
string |
Der Name des Abrechnungsprofils. |
billingProfileId |
string |
Die vollqualifizierte ID, die ein Abrechnungsprofil eindeutig identifiziert. |
billingRequestId |
string |
Die ID der Abrechnungsanforderung, die für die Rollenzuweisung erstellt wurde. Dies gilt nur für mandantenübergreifende Rollenzuweisungen oder Rollenzuweisungen, die über die Abrechnungsanforderung erstellt wurden. |
createdByPrincipalId |
string |
Die Objekt-ID des Benutzers, der die Rollenzuweisung erstellt hat. |
createdByPrincipalPuid |
string |
Die Haupt-PUID des Benutzers, der die Rollenzuweisung erstellt hat. |
createdByPrincipalTenantId |
string |
Die Mandanten-ID des Benutzers, der die Rollenzuweisung erstellt hat. |
createdByUserEmailAddress |
string |
Die E-Mail-Adresse des Benutzers, der die Rollenzuweisung erstellt hat. Dies wird nur für Abrechnungskonten mit Vereinbarungstyp Enterprise Agreement unterstützt. |
createdOn |
string |
Das Datum, an dem die Rollenzuweisung erstellt wurde. |
customerDisplayName |
string |
Der Name des Kunden. |
customerId |
string |
Die vollqualifizierte ID, die einen Kunden eindeutig identifiziert. |
invoiceSectionDisplayName |
string |
Der Name des Rechnungsabschnitts. |
invoiceSectionId |
string |
Die vollqualifizierte ID, die einen Rechnungsabschnitt eindeutig identifiziert. |
modifiedByPrincipalId |
string |
Die Haupt-PUID des Benutzers, der die Rollenzuweisung geändert hat. |
modifiedByPrincipalPuid |
string |
Die Haupt-PUID des Benutzers, der die Rollenzuweisung geändert hat. |
modifiedByPrincipalTenantId |
string |
Die Mandanten-ID des Benutzers, der die Rollenzuweisung geändert hat. |
modifiedByUserEmailAddress |
string |
Die E-Mail-Adresse des Benutzers, der die Rollenzuweisung geändert hat. Dies wird nur für Abrechnungskonten mit Vereinbarungstyp Enterprise Agreement unterstützt. |
modifiedOn |
string |
Das Datum, an dem die Rollenzuweisung geändert wurde. |
principalDisplayName |
string |
Der Anzeigename des Prinzipals, dem die Rolle zugewiesen wurde. |
principalId |
string |
Die Objekt-ID des Benutzers, dem die Rolle zugewiesen wurde. |
principalPuid |
string |
Die Haupt-PUID des Benutzers, dem die Rolle zugewiesen wurde. |
principalTenantId |
string |
Die Prinzipalmandanten-ID des Benutzers, dem die Rolle zugewiesen wurde. |
principalTenantName |
string |
Der Anzeigename des Mandanten des Benutzers, dem die Rolle zugewiesen wurde. Dies ist "Primärmandant" für den primären Mandanten des Abrechnungskontos. |
principalType |
Der Typ einer Rollenzuweisung. |
|
provisioningState |
Der Bereitstellungsstatus der Ressource während eines dauerhaften Vorgangs. |
|
roleDefinitionId |
string |
Die ID der Rollendefinition. |
scope |
string |
Der Bereich, zu dem die Rolle zugewiesen wurde. |
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 Vereinbarungstyp Enterprise Agreement unterstützt. |
userEmailAddress |
string |
Die E-Mail-Adresse des Benutzers, dem die Rolle zugewiesen wurde. Dies wird nur für Abrechnungskonten mit Vereinbarungstyp Enterprise Agreement unterstützt. |
createdByType
Der Identitätstyp, der die Ressource erstellt hat.
Name | Typ | Beschreibung |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
ErrorAdditionalInfo
Der Ressourcenverwaltungsfehler zusätzliche Informationen.
Name | Typ | Beschreibung |
---|---|---|
info |
object |
Die zusätzlichen Informationen. |
type |
string |
Der zusätzliche Informationstyp. |
ErrorDetail
Das Fehlerdetails.
Name | Typ | Beschreibung |
---|---|---|
additionalInfo |
Die zusätzlichen Informationen des Fehlers. |
|
code |
string |
Der Fehlercode. |
details |
Die Fehlerdetails. |
|
message |
string |
Die Fehlermeldung. |
target |
string |
Das Fehlerziel. |
ErrorResponse
Fehlerantwort
Name | Typ | Beschreibung |
---|---|---|
error |
Das Fehlerobjekt. |
PrincipalType
Der Typ einer Rollenzuweisung.
Name | Typ | Beschreibung |
---|---|---|
DirectoryRole |
string |
|
Everyone |
string |
|
Group |
string |
|
None |
string |
|
ServicePrincipal |
string |
|
Unknown |
string |
|
User |
string |
ProvisioningState
Der Bereitstellungsstatus der Ressource während eines dauerhaften Vorgangs.
Name | Typ | Beschreibung |
---|---|---|
Canceled |
string |
|
Failed |
string |
|
New |
string |
|
Pending |
string |
|
Provisioning |
string |
|
Succeeded |
string |
systemData
Metadaten zur Erstellung und letzten Änderung der Ressource.
Name | Typ | Beschreibung |
---|---|---|
createdAt |
string |
Der Zeitstempel der Ressourcenerstellung (UTC). |
createdBy |
string |
Die Identität, die die Ressource erstellt hat. |
createdByType |
Der Identitätstyp, der die Ressource erstellt hat. |
|
lastModifiedAt |
string |
Der Zeitstempel der letzten Änderung der Ressource (UTC) |
lastModifiedBy |
string |
Die Identität, die die Ressource zuletzt geändert hat. |
lastModifiedByType |
Der Identitätstyp, der die Ressource zuletzt geändert hat. |