Billing Role Assignments - List By Customer
Listet die Rollenzuweisungen für den Anrufer für den Kunden auf. Der Vorgang wird für Abrechnungskonten mit dem Vertragstyp Microsoft Partner Agreement unterstützt.
GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/customers/{customerName}/billingRoleAssignments?api-version=2024-04-01
GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/customers/{customerName}/billingRoleAssignments?api-version=2024-04-01&filter={filter}&top={top}&skip={skip}
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: |
customer
|
path | True |
string |
Die ID, die einen Kunden 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. |
|
skip
|
query |
integer int64 |
Die Option "Abfrage überspringen" fordert die Anzahl der Elemente in der abgefragten Auflistung an, die übersprungen und nicht in das Ergebnis einbezogen werden sollen. |
|
top
|
query |
integer int64 |
Die oberste Abfrageoption fordert die Anzahl der Elemente in der abgefragten Auflistung an, in das Ergebnis eingeschlossen zu werden. Der maximal unterstützte Wert für top ist 50. |
Antworten
Name | Typ | Beschreibung |
---|---|---|
200 OK |
Die Liste der Abrechnungsrollenzuweisungen. |
|
Other Status Codes |
Fehlerantwort, die beschreibt, warum der Vorgang fehlgeschlagen ist. |
Beispiele
BillingRoleAssignmentListByCustomer
Beispielanforderung
GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2018-09-30/billingProfiles/BKM6-54VH-BG7-PGB/customers/703ab484-dda2-4402-827b-a74513b61e2d/billingRoleAssignments?api-version=2024-04-01
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/BKM6-54VH-BG7-PGB/customers/703ab484-dda2-4402-827b-a74513b61e2d/billingRoleAssignments/30000000-aaaa-bbbb-cccc-100000000000_6fd330f6-7d26-4aff-b9cf-7bd699f965b9",
"name": "30000000-aaaa-bbbb-cccc-100000000000_6fd330f6-7d26-4aff-b9cf-7bd699f965b9",
"properties": {
"createdOn": "2023-10-19T20:10:50.1028398Z",
"createdByPrincipalTenantId": "076915e7-de10-4323-bb34-a58c904068bb",
"createdByPrincipalId": "",
"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/BKM6-54VH-BG7-PGB/customers/703ab484-dda2-4402-827b-a74513b61e2d/billingRoleDefinitions/30000000-aaaa-bbbb-cccc-100000000000",
"scope": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2018-09-30/billingProfiles/BKM6-54VH-BG7-PGB/customers/703ab484-dda2-4402-827b-a74513b61e2d",
"principalType": "User"
},
"type": "Microsoft.Billing/billingAccounts/billingProfiles/customers/billingRoleAssignments"
},
{
"id": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2018-09-30/billingProfiles/BKM6-54VH-BG7-PGB/customers/703ab484-dda2-4402-827b-a74513b61e2d/billingRoleAssignments/30000000-aaaa-bbbb-cccc-100000000000_b1839933-b3ac-42ca-8112-d29c43f3ab47",
"name": "30000000-aaaa-bbbb-cccc-100000000000_b1839933-b3ac-42ca-8112-d29c43f3ab47",
"properties": {
"createdOn": "2023-10-19T20:10:50.1028398Z",
"createdByPrincipalTenantId": "076915e7-de10-4323-bb34-a58c904068bb",
"createdByPrincipalId": "",
"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/BKM6-54VH-BG7-PGB/customers/703ab484-dda2-4402-827b-a74513b61e2d/billingRoleDefinitions/30000000-aaaa-bbbb-cccc-100000000000",
"scope": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2018-09-30/billingProfiles/BKM6-54VH-BG7-PGB/customers/703ab484-dda2-4402-827b-a74513b61e2d",
"principalType": "User"
},
"type": "Microsoft.Billing/billingAccounts/billingProfiles/customers/billingRoleAssignments"
}
]
}
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. |