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

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

customerName
path True

string

ID che identifica in modo univoco un cliente.

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.

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

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

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.