Billing Role Assignments - Create By Customer
Aggiunge un'assegnazione di ruolo a un cliente. L'operazione è supportata per gli account di fatturazione con tipo di contratto Contratto Microsoft Partner.
POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/customers/{customerName}/createBillingRoleAssignment?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 profilo di fatturazione. Criterio di espressione regolare: |
customer
|
path | True |
string |
ID che identifica in modo univoco un cliente. 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 | Necessario | Tipo | Descrizione |
---|---|---|---|
roleDefinitionId | True |
string |
ID della definizione del 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. |
|
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. |
Risposte
Nome | Tipo | Descrizione |
---|---|---|
200 OK |
Proprietà dell'assegnazione di ruolo di fatturazione. |
|
202 Accepted |
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
BillingRoleAssignmentCreateByCustomer
Esempio di richiesta
POST 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/customers/703ab484-dda2-4402-827b-a74513b61e2d/createBillingRoleAssignment?api-version=2024-04-01
{
"principalId": "00000000-0000-0000-0000-000000000000",
"principalTenantId": "076915e7-de10-4323-bb34-a58c904068bb",
"roleDefinitionId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2018-09-30/billingProfileName/BKM6-54VH-BG7-PGB/customers/703ab484-dda2-4402-827b-a74513b61e2d/billingRoleDefinitions/30000000-aaaa-bbbb-cccc-100000000000",
"userEmailAddress": "john@contoso.com"
}
Risposta di esempio
{
"id": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2018-09-30/billingProfileName/BKM6-54VH-BG7-PGB/customers/703ab484-dda2-4402-827b-a74513b61e2d/billingRoleAssignments/30000000-aaaa-bbbb-cccc-100000000000_00000000-0000-0000-0000-000000000000",
"name": "30000000-aaaa-bbbb-cccc-100000000000_00000000-0000-0000-0000-000000000000",
"properties": {
"createdOn": "2023-10-19T20:10:50.1028398Z",
"createdByPrincipalTenantId": "076915e7-de10-4323-bb34-a58c904068bb",
"createdByPrincipalId": "47309529-17e6-4104-b9e8-39f62fa1e5ed",
"principalId": "00000000-0000-0000-0000-000000000000",
"roleDefinitionId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2018-09-30/billingProfileName/BKM6-54VH-BG7-PGB/customers/703ab484-dda2-4402-827b-a74513b61e2d/billingRoleDefinitions/30000000-aaaa-bbbb-cccc-100000000000",
"scope": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2018-09-30/billingProfileName/BKM6-54VH-BG7-PGB/customers/703ab484-dda2-4402-827b-a74513b61e2d",
"principalType": "User"
},
"type": "Microsoft.Billing/billingAccounts/billingProfiles/customers/billingRoleAssignments"
}
location: https://management.azure.com/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2018-09-30/customers/703ab484-dda2-4402-827b-a74513b61e2d/operationResults/createBillingRoleAssignment_30000000-aaaa-bbbb-cccc-100000000000_00000000-0000-0000-0000-000000000000?api-version=2024-04-01
retry-after: 5
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. |