Billing Role Assignments - Get By Invoice Section

Riferimento

Servizio:: Billing

Versione API:: 2024-04-01

Ottiene un'assegnazione 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/{billingRoleAssignmentName}?api-version=2024-04-01

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
billingAccountName	path	True	string	ID che identifica in modo univoco un account di fatturazione. Criterio di espressione regolare: `^([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})?)$`
billingProfileName	path	True	string	ID che identifica in modo univoco un profilo di fatturazione. Criterio di espressione regolare: `^[a-zA-Z\d-_]{1,128}$`
billingRoleAssignmentName	path	True	string	ID che identifica in modo univoco un'assegnazione di ruolo. Criterio di espressione regolare: `^[a-fA-F0-9]{8}[-]?([a-fA-F0-9]{4}[-]?){3}[a-fA-F0-9]{12}(_[a-fA-F0-9]{8}[-]?([a-fA-F0-9]{4}[-]?){3}[a-fA-F0-9]{12})?$`
invoiceSectionName	path	True	string	ID che identifica in modo univoco una sezione della fattura. Criterio di espressione regolare: `^[a-zA-Z\d-_]{1,128}$`
api-version	query	True	string	Versione dell'API da usare con la richiesta client. La versione corrente è 2024-04-01.

Risposte

Nome	Tipo	Descrizione
200 OK	BillingRoleAssignment	Proprietà dell'assegnazione di ruolo di fatturazione.
Other Status Codes	ErrorResponse	Risposta di errore che descrive il motivo per cui l'operazione non è riuscita.

Esempio

BillingRoleAssignmentGetByInvoiceSection

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/10000000-aaaa-bbbb-cccc-100000000000_6fd330f6-7d26-4aff-b9cf-7bd699f965b9?api-version=2024-04-01

Risposta di esempio

Codice di stato:: 200

{
  "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",
  "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": "46b831ec-42b2-4f1a-8b54-3fd5ff9d6aa1",
    "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/invoiceSections/xxxx-xxxx-xxx-xxx/billingRoleDefinitions/50000000-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/invoiceSections/xxxx-xxxx-xxx-xxx",
    "principalType": "User"
  },
  "type": "Microsoft.Billing/billingAccounts/billingProfiles/invoiceSections/billingRoleAssignments"
}

Definizioni

Nome	Descrizione
BillingRoleAssignment	Proprietà dell'assegnazione di ruolo di fatturazione.
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

Proprietà dell'assegnazione di ruolo di fatturazione.

Nome	Tipo	Descrizione
id	string	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"

BillingRoleAssignmentProperties

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	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	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	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

Tipo di identità che ha creato la risorsa.

Nome	Tipo	Descrizione
Application	string
Key	string
ManagedIdentity	string
User	string

ErrorAdditionalInfo

Informazioni aggiuntive sull'errore di gestione delle risorse.

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

ErrorDetail

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

Risposta di errore

Nome	Tipo	Descrizione
error	ErrorDetail	Oggetto error.

PrincipalType

Tipo di un'assegnazione di ruolo.

Nome	Tipo	Descrizione
DirectoryRole	string
Everyone	string
Group	string
None	string
ServicePrincipal	string
Unknown	string
User	string

ProvisioningState

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

Nome	Tipo	Descrizione
Canceled	string
Failed	string
New	string
Pending	string
Provisioning	string
Succeeded	string

systemData

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

Nome	Tipo	Descrizione
createdAt	string	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	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