Condividi tramite


Billing Role Assignments - List By Enrollment Account

Elenca le assegnazioni di ruolo per il chiamante in un account di registrazione. L'operazione è supportata per gli account di fatturazione di tipo Enterprise Agreement.

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

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.

enrollmentAccountName
path True

string

pattern: ^[a-zA-Z\d-_]{1,128}$

Nome dell'account di registrazione.

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

BillingRoleAssignmentListResult

Elenco delle assegnazioni di ruolo di fatturazione.

Other Status Codes

ErrorResponse

Risposta di errore che descrive il motivo per cui l'operazione non è riuscita.

Esempio

BillingRoleAssignmentListByEnrollmentAccount

Esempio di richiesta

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/6100092/enrollmentAccounts/123456/billingRoleAssignments?api-version=2024-04-01

Risposta di esempio

{
  "value": [
    {
      "id": "/providers/Microsoft.Billing/billingAccounts/6100092/enrollmentAccounts/123456/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/6100092/enrollmentAccounts/123456/billingRoleDefinitions/50000000-0000-0000-0000-000000000000",
        "scope": "/providers/Microsoft.Billing/billingAccounts/6100092/enrollmentAccounts/123456",
        "principalType": "User"
      },
      "type": "Microsoft.Billing/billingAccounts/enrollmentAccounts/billingRoleAssignments"
    },
    {
      "id": "/providers/Microsoft.Billing/billingAccounts/6100092/enrollmentAccounts/123456/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/6100092/enrollmentAccounts/123456/billingRoleDefinitions/50000000-0000-0000-0000-000000000001",
        "scope": "/providers/Microsoft.Billing/billingAccounts/6100092/enrollmentAccounts/123456",
        "principalType": "User"
      },
      "type": "Microsoft.Billing/billingAccounts/enrollmentAccounts/billingRoleAssignments"
    }
  ]
}

Definizioni

Nome Descrizione
BillingRoleAssignment

Proprietà dell'assegnazione di ruolo di fatturazione.

BillingRoleAssignmentListResult

Contenitore per un elenco di risorse

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

Contenitore per un elenco di risorse

Nome Tipo Descrizione
nextLink

string

Collegamento (URL) alla pagina successiva dei risultati.

value

BillingRoleAssignment[]

Elenco di risorse.

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

Tipo di identità che ha creato la risorsa.

Valore Descrizione
Application
Key
ManagedIdentity
User

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.

Valore Descrizione
DirectoryRole
Everyone
Group
None
ServicePrincipal
Unknown
User

ProvisioningState

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

Valore Descrizione
Canceled
Failed
New
Pending
Provisioning
Succeeded

systemData

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.