Billing Role Assignments - List By Invoice Section

Dienst:: Billing

API-Version:: 2024-04-01

Listet die Rollenzuweisungen für den Anrufer in einem Rechnungsabschnitt auf. Der Vorgang wird für Abrechnungskonten mit dem Vertragstyp Microsoft-Kundenvertrag unterstützt.

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/invoiceSections/{invoiceSectionName}/billingRoleAssignments?api-version=2024-04-01

Mit optionalen Parametern:

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/invoiceSections/{invoiceSectionName}/billingRoleAssignments?api-version=2024-04-01&filter={filter}&top={top}&skip={skip}

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
billingAccountName	path	True	string pattern: ^([0-9]+\|([Pp][Cc][Nn]\.[A-Za-z0-9]+)\|[0-9A-Fa-f]{8}-([0-9A-Fa-f]{4}-){3}[0-9A-Fa-f]{12}(:[0-9A-Fa-f]{8}-([0-9A-Fa-f]{4}-){3}[0-9A-Fa-f]{12}_[0-9]{4}(-[0-9]{2}){2})?)$	Die ID, die ein Abrechnungskonto eindeutig identifiziert.
billingProfileName	path	True	string pattern: ^[a-zA-Z\d-_]{1,128}$	Die ID, die ein Abrechnungsprofil eindeutig identifiziert.
invoiceSectionName	path	True	string pattern: ^[a-zA-Z\d-_]{1,128}$	Die ID, die einen Rechnungsabschnitt eindeutig identifiziert.
api-version	query	True	string minLength: 1	Die API-Version, die für diesen Vorgang verwendet werden soll.
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	BillingRoleAssignmentListResult	Azure-Operation erfolgreich abgeschlossen.
Other Status Codes	ErrorResponse	Unerwartete Fehlerantwort.

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

BillingRoleAssignmentListByInvoiceSection

Beispielanforderung

HTTP

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/invoiceSections/xxxx-xxxx-xxx-xxx/billingRoleAssignments?api-version=2024-04-01

Beispiel für eine Antwort

Statuscode:: 200

{
  "value": [
    {
      "name": "10000000-aaaa-bbbb-cccc-100000000000_6fd330f6-7d26-4aff-b9cf-7bd699f965b9",
      "type": "Microsoft.Billing/billingAccounts/billingProfiles/invoiceSections/billingRoleAssignments",
      "id": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2018-09-30/billingProfiles/BKM6-54VH-BG7-PGB/invoiceSections/xxxx-xxxx-xxx-xxx/billingRoleAssignments/10000000-aaaa-bbbb-cccc-100000000000_6fd330f6-7d26-4aff-b9cf-7bd699f965b9",
      "properties": {
        "createdByPrincipalId": "00000000-0000-0000-0000-000000000001",
        "createdByPrincipalTenantId": "076915e7-de10-4323-bb34-a58c904068bb",
        "createdOn": "2023-10-19T20:10:50.1028398Z",
        "principalId": "00000000-0000-0000-0000-000000000000",
        "principalType": "User",
        "roleDefinitionId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2018-09-30/billingProfiles/BKM6-54VH-BG7-PGB/invoiceSections/xxxx-xxxx-xxx-xxx/billingRoleDefinitions/30000000-aaaa-bbbb-cccc-100000000002",
        "scope": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2018-09-30/billingProfiles/BKM6-54VH-BG7-PGB/invoiceSections/xxxx-xxxx-xxx-xxx"
      }
    },
    {
      "name": "10000000-aaaa-bbbb-cccc-100000000000_b1839933-b3ac-42ca-8112-d29c43f3ab47",
      "type": "Microsoft.Billing/billingAccounts/billingProfiles/invoiceSections/billingRoleAssignments",
      "id": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2018-09-30/billingProfiles/BKM6-54VH-BG7-PGB/invoiceSections/xxxx-xxxx-xxx-xxx/billingRoleAssignments/10000000-aaaa-bbbb-cccc-100000000000_b1839933-b3ac-42ca-8112-d29c43f3ab47",
      "properties": {
        "createdByPrincipalId": "00000000-0000-0000-0000-000000000001",
        "createdByPrincipalTenantId": "076915e7-de10-4323-bb34-a58c904068bb",
        "createdOn": "2023-10-19T20:10:50.1028398Z",
        "principalId": "00000000-0000-0000-0000-000000000000",
        "principalType": "User",
        "roleDefinitionId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2018-09-30/billingProfiles/BKM6-54VH-BG7-PGB/invoiceSections/xxxx-xxxx-xxx-xxx/billingRoleDefinitions/30000000-aaaa-bbbb-cccc-100000000001",
        "scope": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2018-09-30/billingProfiles/BKM6-54VH-BG7-PGB/invoiceSections/xxxx-xxxx-xxx-xxx"
      }
    }
  ]
}

Definitionen

Name	Beschreibung
BillingRoleAssignment	Die Eigenschaften der Abrechnungsrollenzuweisung.
BillingRoleAssignmentListResult	Ausgeführte Sammlung von BillingRoleAssignment-Einträgen
BillingRoleAssignmentProperties	Die Eigenschaften der Abrechnungsrollenzuweisung.
createdByType	Der Identitätstyp, der die Ressource erstellt hat.
ErrorAdditionalInfo	Der Ressourcenverwaltungsfehler zusätzliche Informationen.
ErrorDetail	Das Fehlerdetails.
ErrorResponse	Fehlerantwort
PrincipalType	Der Typ einer Rollenzuweisung.
ProvisioningState	Der Bereitstellungsstatus der Ressource während eines dauerhaften Vorgangs.
systemData	Metadaten zur Erstellung und letzten Änderung der Ressource.

BillingRoleAssignment

Objekt

Die Eigenschaften der Abrechnungsrollenzuweisung.

Name	Typ	Beschreibung
id	string (arm-id)	Vollqualifizierte Ressourcen-ID für die Ressource. Z. B. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	Der Name der Ressource
properties	BillingRoleAssignmentProperties	Die Eigenschaften der Abrechnungsrollenzuweisung.
systemData	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

Objekt

Ausgeführte Sammlung von BillingRoleAssignment-Einträgen

Name	Typ	Beschreibung
nextLink	string (uri)	Der Link zur nächsten Seite von Elementen
value	BillingRoleAssignment[]	Die BillingRoleAssignment-Einträge auf dieser Seite

BillingRoleAssignmentProperties

Objekt

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 (date-time)	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 (date-time)	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	PrincipalType	Der Typ einer Rollenzuweisung.
provisioningState	ProvisioningState	Der Bereitstellungsstatus der Ressource während eines dauerhaften Vorgangs.
roleDefinitionId	string minLength: 1	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

Enumeration

Der Identitätstyp, der die Ressource erstellt hat.

Wert	Beschreibung
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Objekt

Der Ressourcenverwaltungsfehler zusätzliche Informationen.

Name	Typ	Beschreibung
info	object	Die zusätzlichen Informationen.
type	string	Der zusätzliche Informationstyp.

ErrorDetail

Objekt

Das Fehlerdetails.

Name	Typ	Beschreibung
additionalInfo	ErrorAdditionalInfo[]	Die zusätzlichen Informationen des Fehlers.
code	string	Der Fehlercode.
details	ErrorDetail[]	Die Fehlerdetails.
message	string	Die Fehlermeldung.
target	string	Das Fehlerziel.

ErrorResponse

Objekt

Fehlerantwort

Name	Typ	Beschreibung
error	ErrorDetail	Das Fehlerobjekt.

PrincipalType

Enumeration

Der Typ einer Rollenzuweisung.

Wert	Beschreibung
Unknown	Unbekannt
None	Nichts
User	Benutzer
Group	Gruppieren
DirectoryRole	VerzeichnisRolle
ServicePrincipal	ServicePrincipal
Everyone	Jeder

ProvisioningState

Enumeration

Der Bereitstellungsstatus der Ressource während eines dauerhaften Vorgangs.

Wert	Beschreibung
Succeeded	Erfolgreich
Canceled	Abgesagt
Failed	gescheitert
New	Neu
Pending	Ausstehend
Provisioning	Provisioning
PendingBilling	AusstehendeAbrechnung
ConfirmedBilling	BestätigteAbrechnung
Creating	Erstellen
Created	Erstellt
Expired	Abgelaufen

systemData

Objekt

Metadaten zur Erstellung und letzten Änderung der Ressource.

Name	Typ	Beschreibung
createdAt	string (date-time)	Der Zeitstempel der Ressourcenerstellung (UTC).
createdBy	string	Die Identität, die die Ressource erstellt hat.
createdByType	createdByType	Der Identitätstyp, der die Ressource erstellt hat.
lastModifiedAt	string (date-time)	Der Zeitstempel der letzten Änderung der Ressource (UTC)
lastModifiedBy	string	Die Identität, die die Ressource zuletzt geändert hat.
lastModifiedByType	createdByType	Der Identitätstyp, der die Ressource zuletzt geändert hat.

Freigeben über

Billing Role Assignments - List By Invoice Section

URI-Parameter

Antworten

Sicherheit

azure_auth

Bereiche

Beispiele

BillingRoleAssignmentListByInvoiceSection

Beispielanforderung

Beispiel für eine Antwort

Definitionen

BillingRoleAssignment

BillingRoleAssignmentListResult

BillingRoleAssignmentProperties

createdByType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

PrincipalType

ProvisioningState

systemData