Condividi tramite


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

customerName
path True

string

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

ID che identifica in modo univoco un cliente.

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

minLength: 1

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

BillingRoleAssignment

Proprietà dell'assegnazione di ruolo di fatturazione.

202 Accepted

Proprietà dell'assegnazione di ruolo di fatturazione.

Intestazioni

  • Location: string
  • Retry-After: integer
Other Status Codes

ErrorResponse

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

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.