Billing Role Assignments - List By Invoice Section

Servizio:: Billing

Versione API:: 2024-04-01

Elenca le assegnazioni di ruolo per il chiamante in una sezione della fattura. L'operazione è supportata per gli account di fatturazione con tipo di contratto Contratto del cliente Microsoft.

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

Con parametri facoltativi:

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}

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
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})?)$	ID che identifica in modo univoco un account di fatturazione.
billingProfileName	path	True	string pattern: ^[a-zA-Z\d-_]{1,128}$	ID che identifica in modo univoco un profilo di fatturazione.
invoiceSectionName	path	True	string pattern: ^[a-zA-Z\d-_]{1,128}$	ID che identifica in modo univoco una sezione della fattura.
api-version	query	True	string minLength: 1	Versione dell'API da usare per questa operazione.
filter	query		string	L'opzione di query di filtro consente ai client di filtrare una raccolta di risorse indirizzate da un URL di richiesta.
skip	query		integer (int64)	L'opzione ignora query richiede il numero di elementi nella raccolta di query che devono essere ignorati e non inclusi nel risultato.
top	query		integer (int64)	L'opzione query principale richiede che il numero di elementi nella raccolta di query venga incluso nel risultato. Il valore massimo supportato per top è 50.

Risposte

Nome	Tipo	Descrizione
200 OK	BillingRoleAssignmentListResult	Operazione Azure completata con successo.
Other Status Codes	ErrorResponse	Risposta di errore imprevista.

Sicurezza

azure_auth

Azure Active Directory OAuth2 Flow.

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome	Descrizione
user_impersonation	rappresentare l'account utente

Esempio

BillingRoleAssignmentListByInvoiceSection

Esempio di richiesta

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

Risposta di esempio

Codice di stato:: 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"
      }
    }
  ]
}

Definizioni

Nome	Descrizione
BillingRoleAssignment	Proprietà dell'assegnazione di ruolo di fatturazione.
BillingRoleAssignmentListResult	Collezione paginata di elementi BillingRoleAssignment
BillingRoleAssignmentProperties	Proprietà dell'assegnazione di ruolo di fatturazione.
createdByType	Tipo di identità che ha creato la risorsa.
ErrorAdditionalInfo	Informazioni aggiuntive sull'errore di gestione delle risorse.
ErrorDetail	Dettagli dell'errore.
ErrorResponse	Risposta di errore
PrincipalType	Tipo di un'assegnazione di ruolo.
ProvisioningState	Stato di provisioning della risorsa durante un'operazione a esecuzione prolungata.
systemData	Metadati relativi alla creazione e all'ultima modifica della risorsa.

BillingRoleAssignment

Oggetto

Proprietà dell'assegnazione di ruolo di fatturazione.

Nome	Tipo	Descrizione
id	string (arm-id)	ID risorsa completo per la risorsa. Ad esempio, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	Nome della risorsa
properties	BillingRoleAssignmentProperties	Proprietà dell'assegnazione di ruolo di fatturazione.
systemData	systemData	Metadati di Azure Resource Manager contenenti le informazioni createdBy e modifiedBy.
tags	object	Dizionario dei metadati associati alla risorsa. Potrebbe non essere popolato per tutti i tipi di risorse. Lunghezza massima chiave/valore supportata di 256 caratteri. Chiavi/valore non deve essere vuoto né null. Le chiavi non possono contenere <> % & \ ? /
type	string	Tipo della risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

BillingRoleAssignmentListResult

Oggetto

Collezione paginata di elementi BillingRoleAssignment

Nome	Tipo	Descrizione
nextLink	string (uri)	Collegamento alla pagina successiva di elementi
value	BillingRoleAssignment[]	Gli elementi BillingRoleAssignment in questa pagina

BillingRoleAssignmentProperties

Oggetto

Proprietà dell'assegnazione di ruolo di fatturazione.

Nome	Tipo	Descrizione
billingAccountDisplayName	string	Nome dell'account di fatturazione.
billingAccountId	string	ID completo che identifica in modo univoco un account di fatturazione.
billingProfileDisplayName	string	Nome del profilo di fatturazione.
billingProfileId	string	ID completo che identifica in modo univoco un profilo di fatturazione.
billingRequestId	string	ID della richiesta di fatturazione creata per l'assegnazione di ruolo. Questo è applicabile solo alle assegnazioni di ruolo tra tenant o alle assegnazioni di ruolo create tramite la richiesta di fatturazione.
createdByPrincipalId	string	ID oggetto dell'utente che ha creato l'assegnazione di ruolo.
createdByPrincipalPuid	string	PUID principale dell'utente che ha creato l'assegnazione di ruolo.
createdByPrincipalTenantId	string	ID tenant dell'utente che ha creato l'assegnazione di ruolo.
createdByUserEmailAddress	string	Indirizzo di posta elettronica dell'utente che ha creato l'assegnazione di ruolo. Questa opzione è supportata solo per gli account di fatturazione con il tipo di contratto Enterprise Agreement.
createdOn	string (date-time)	Data di creazione dell'assegnazione di ruolo.
customerDisplayName	string	Nome del cliente.
customerId	string	ID completo che identifica in modo univoco un cliente.
invoiceSectionDisplayName	string	Nome della sezione della fattura.
invoiceSectionId	string	ID completo che identifica in modo univoco una sezione della fattura.
modifiedByPrincipalId	string	PUID principale dell'utente che ha modificato l'assegnazione di ruolo.
modifiedByPrincipalPuid	string	PUID principale dell'utente che ha modificato l'assegnazione di ruolo.
modifiedByPrincipalTenantId	string	ID tenant dell'utente che ha modificato l'assegnazione di ruolo.
modifiedByUserEmailAddress	string	Indirizzo di posta elettronica dell'utente che ha modificato l'assegnazione di ruolo. Questa opzione è supportata solo per gli account di fatturazione con il tipo di contratto Enterprise Agreement.
modifiedOn	string (date-time)	Data di modifica dell'assegnazione di ruolo.
principalDisplayName	string	Nome visualizzato dell'entità a cui è stato assegnato il ruolo.
principalId	string	ID oggetto dell'utente a cui è stato assegnato il ruolo.
principalPuid	string	PUID principale dell'utente a cui è stato assegnato il ruolo.
principalTenantId	string	ID tenant principale dell'utente a cui è stato assegnato il ruolo.
principalTenantName	string	Nome descrittivo del tenant dell'utente a cui è stato assegnato il ruolo. Si tratta di "Tenant primario" per il tenant primario dell'account di fatturazione.
principalType	PrincipalType	Tipo di un'assegnazione di ruolo.
provisioningState	ProvisioningState	Stato di provisioning della risorsa durante un'operazione a esecuzione prolungata.
roleDefinitionId	string minLength: 1	ID della definizione del ruolo.
scope	string	Ambito in cui è stato assegnato il ruolo.
userAuthenticationType	string	Tipo di autenticazione dell'utente, organizzazione o account del servizio gestito, dell'utente a cui è stato assegnato il ruolo. Questa opzione è supportata solo per gli account di fatturazione con il tipo di contratto Enterprise Agreement.
userEmailAddress	string	Indirizzo di posta elettronica dell'utente a cui è stato assegnato il ruolo. Questa opzione è supportata solo per gli account di fatturazione con il tipo di contratto Enterprise Agreement.

createdByType

Enumerazione

Tipo di identità che ha creato la risorsa.

Valore	Descrizione
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Oggetto

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome	Tipo	Descrizione
info	object	Informazioni aggiuntive.
type	string	Tipo di informazioni aggiuntive.

ErrorDetail

Oggetto

Dettagli dell'errore.

Nome	Tipo	Descrizione
additionalInfo	ErrorAdditionalInfo[]	Informazioni aggiuntive sull'errore.
code	string	Codice di errore.
details	ErrorDetail[]	Dettagli dell'errore.
message	string	Messaggio di errore.
target	string	Destinazione dell'errore.

ErrorResponse

Oggetto

Risposta di errore

Nome	Tipo	Descrizione
error	ErrorDetail	Oggetto error.

PrincipalType

Enumerazione

Tipo di un'assegnazione di ruolo.

Valore	Descrizione
Unknown	Sconosciuto
None	Nessuno
User	User
Group	Gruppo
DirectoryRole	DirectoryRole
ServicePrincipal	Servizio Principale
Everyone	Tutti

ProvisioningState

Enumerazione

Stato di provisioning della risorsa durante un'operazione a esecuzione prolungata.

Valore	Descrizione
Succeeded	Succeeded
Canceled	Annullato
Failed	Non riuscito
New	Nuova
Pending	In sospeso
Provisioning	Provisioning
PendingBilling	PendingBilling
ConfirmedBilling	Fatturazione confermataFattura
Creating	Creazione
Created	Creato
Expired	Scaduto

systemData

Oggetto

Metadati relativi alla creazione e all'ultima modifica della risorsa.

Nome	Tipo	Descrizione
createdAt	string (date-time)	Timestamp della creazione della risorsa (UTC).
createdBy	string	Identità che ha creato la risorsa.
createdByType	createdByType	Tipo di identità che ha creato la risorsa.
lastModifiedAt	string (date-time)	Timestamp dell'ultima modifica della risorsa (UTC)
lastModifiedBy	string	Identità che ha modificato l'ultima volta la risorsa.
lastModifiedByType	createdByType	Tipo di identità che ha modificato l'ultima volta la risorsa.

Condividi tramite

Billing Role Assignments - List By Invoice Section

Parametri dell'URI

Risposte

Sicurezza

azure_auth

Ambiti

Esempio

BillingRoleAssignmentListByInvoiceSection

Esempio di richiesta

Risposta di esempio

Definizioni

BillingRoleAssignment

BillingRoleAssignmentListResult

BillingRoleAssignmentProperties

createdByType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

PrincipalType

ProvisioningState

systemData