Billing Role Assignments - Create Or Update By Enrollment Account
Creare o aggiornare un'assegnazione di ruolo di fatturazione. L'operazione è supportata solo per gli account di fatturazione con il tipo di contratto Enterprise Agreement.
PUT https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/enrollmentAccounts/{enrollmentAccountName}/billingRoleAssignments/{billingRoleAssignmentName}?api-version=2024-04-01
Parametri dell'URI
Nome | In | Necessario | Tipo | Descrizione |
---|---|---|---|---|
billing
|
path | True |
string |
ID che identifica in modo univoco un account di fatturazione. Criterio di espressione regolare: |
billing
|
path | True |
string |
ID che identifica in modo univoco un'assegnazione di ruolo. Criterio di espressione regolare: |
enrollment
|
path | True |
string |
Nome dell'account di registrazione. Criterio di espressione regolare: |
api-version
|
query | True |
string |
Versione dell'API da usare con la richiesta client. La versione corrente è 2024-04-01. |
Corpo della richiesta
Nome | Tipo | Descrizione |
---|---|---|
properties |
Proprietà dell'assegnazione di ruolo di fatturazione. |
|
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 <> % & \ ? / |
Risposte
Nome | Tipo | Descrizione |
---|---|---|
200 OK |
Proprietà dell'assegnazione di ruolo di fatturazione. |
|
201 Created |
Proprietà dell'assegnazione di ruolo di fatturazione. Intestazioni
|
|
Other Status Codes |
Risposta di errore che descrive il motivo per cui l'operazione non è riuscita. |
Esempio
BillingRoleAssignmentCreateOrUpdateByEnrollmentAccount
Esempio di richiesta
PUT https://management.azure.com/providers/Microsoft.Billing/billingAccounts/7898901/enrollmentAccounts/123456/billingRoleAssignments/9dfd08c2-62a3-4d47-85bd-1cdba1408402?api-version=2024-04-01
{
"properties": {
"principalId": "00000000-0000-0000-0000-000000000000",
"principalTenantId": "076915e7-de10-4323-bb34-a58c904068bb",
"roleDefinitionId": "/providers/Microsoft.Billing/billingAccounts/7898901/enrollmentAccounts/123456/billingRoleDefinitions/9f1983cb-2574-400c-87e9-34cf8e2280db",
"userEmailAddress": "john@contoso.com"
}
}
Risposta di esempio
{
"id": "/providers/Microsoft.Billing/billingAccounts/7898901/enrollmentAccounts/123456/billingRoleAssignments/9dfd08c2-62a3-4d47-85bd-1cdba1408402",
"name": "9dfd08c2-62a3-4d47-85bd-1cdba1408402",
"properties": {
"createdOn": "2023-10-19T20:10:50.1028398Z",
"createdByPrincipalTenantId": "076915e7-de10-4323-bb34-a58c904068bb",
"createdByPrincipalId": "60d97094-2be4-46cc-a4fe-3633021a25b9",
"principalId": "00000000-0000-0000-0000-000000000000",
"principalTenantId": "7ca289b9-c32d-4f01-8566-7ff93261d76f",
"roleDefinitionId": "/providers/Microsoft.Billing/billingAccounts/7898901/enrollmentAccounts/123456/billingRoleDefinitions/9f1983cb-2574-400c-87e9-34cf8e2280db",
"scope": "/providers/Microsoft.Billing/billingAccounts/7898901/enrollmentAccounts/123456"
},
"type": "Microsoft.Billing/billingAccounts/enrollmentAccounts/billingRoleAssignments"
}
{
"id": "/providers/Microsoft.Billing/billingAccounts/7898901/enrollmentAccounts/123456/billingRoleAssignments/9dfd08c2-62a3-4d47-85bd-1cdba1408402",
"name": "9dfd08c2-62a3-4d47-85bd-1cdba1408402",
"properties": {
"createdOn": "2023-10-19T20:10:50.1028398Z",
"createdByPrincipalTenantId": "076915e7-de10-4323-bb34-a58c904068bb",
"createdByPrincipalId": "60d97094-2be4-46cc-a4fe-3633021a25b9",
"principalId": "00000000-0000-0000-0000-000000000000",
"principalTenantId": "7ca289b9-c32d-4f01-8566-7ff93261d76f",
"roleDefinitionId": "/providers/Microsoft.Billing/billingAccounts/7898901/enrollmentAccounts/123456/billingRoleDefinitions/9f1983cb-2574-400c-87e9-34cf8e2280db",
"scope": "/providers/Microsoft.Billing/billingAccounts/7898901/enrollmentAccounts/123456"
},
"type": "Microsoft.Billing/billingAccounts/enrollmentAccounts/billingRoleAssignments"
}
Definizioni
Nome | Descrizione |
---|---|
Billing |
Proprietà dell'assegnazione di ruolo di fatturazione. |
Billing |
Proprietà dell'assegnazione di ruolo di fatturazione. |
created |
Tipo di identità che ha creato la risorsa. |
Error |
Informazioni aggiuntive sull'errore di gestione delle risorse. |
Error |
Dettagli dell'errore. |
Error |
Risposta di errore |
Principal |
Tipo di un'assegnazione di ruolo. |
Provisioning |
Stato di provisioning della risorsa durante un'operazione a esecuzione prolungata. |
system |
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 |
Proprietà dell'assegnazione di ruolo di fatturazione. |
|
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 |
Tipo di un'assegnazione di ruolo. |
|
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 |
Informazioni aggiuntive sull'errore. |
|
code |
string |
Codice di errore. |
details |
Dettagli dell'errore. |
|
message |
string |
Messaggio di errore. |
target |
string |
Destinazione dell'errore. |
ErrorResponse
Risposta di errore
Nome | Tipo | Descrizione |
---|---|---|
error |
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 |
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 |
Tipo di identità che ha modificato l'ultima volta la risorsa. |