Enrollment Account Role Assignments - Put

Riferimento

Servizio:: Billing

Versione API:: 2019-10-01-preview

Creare o aggiornare un'assegnazione di ruolo di fatturazione.

PUT https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/enrollmentAccounts/{enrollmentAccountName}/billingRoleAssignments/{billingRoleAssignmentName}?api-version=2019-10-01-preview

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
billingAccountName	path	True	string	ID che identifica in modo univoco un account di fatturazione.
billingRoleAssignmentName	path	True	string	ID che identifica in modo univoco un'assegnazione di ruolo.
enrollmentAccountName	path	True	string	ID che identifica in modo univoco un account di registrazione.
api-version	query	True	string	Versione dell'API da usare con la richiesta client. La versione corrente è 2019-10-01-preview.

Corpo della richiesta

Nome	Tipo	Descrizione
properties.principalId	string	ID principale dell'utente a cui è stato assegnato il ruolo.
properties.principalTenantId	string	ID tenant principale dell'utente a cui è stato assegnato il ruolo.
properties.roleDefinitionId	string	ID della definizione del ruolo.
properties.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 tipo di contratto Enterprise Agreement.
properties.userEmailAddress	string	Indirizzo di posta elettronica dell'utente a cui è stato assegnato il ruolo. Questa opzione è supportata solo per gli account di fatturazione con tipo di contratto Enterprise Agreement.

Risposte

Nome	Tipo	Descrizione
200 OK	BillingRoleAssignment	OK. La richiesta ha avuto esito positivo.
Other Status Codes	ErrorResponse	Risposta di errore che descrive il motivo per cui l'operazione non è riuscita.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory.

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome	Descrizione
user_impersonation	rappresentare l'account utente

Esempio

PutEnrollmentAccountSubscriptionCreatorRoleAssignment

Esempio di richiesta

HTTP

PUT https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/enrollmentAccounts/{enrollmentAccountName}/billingRoleAssignments/{billingRoleAssignmentName}?api-version=2019-10-01-preview

{
  "properties": {
    "principalId": "99a1a759-30dd-42c2-828c-db398826bb67",
    "principalTenantId": "7ca289b9-c32d-4f01-8566-7ff93261d76f",
    "roleDefinitionId": "/providers/Microsoft.Billing/billingAccounts/7898901/enrollmentAccounts/225314/billingRoleDefinitions/a0bcee42-bf30-4d1b-926a-48d21664ef71"
  }
}

Risposta di esempio

Codice di stato:: 200

{
  "id": "/providers/Microsoft.Billing/billingAccounts/7898901/enrollmentAccounts/225314/billingRoleAssignments/9dfd08c2-62a3-4d47-85bd-1cdba1408402",
  "name": "9dfd08c2-62a3-4d47-85bd-1cdba1408402",
  "properties": {
    "createdOn": "2019-06-28T19:11:50.6168809+00:00",
    "createdByPrincipalTenantId": "7ca289b9-c32d-4f01-8566-7ff93261d76f",
    "createdByPrincipalId": "60d97094-2be4-46cc-a4fe-3633021a25b9",
    "principalId": "99a1a759-30dd-42c2-828c-db398826bb67",
    "principalTenantId": "7ca289b9-c32d-4f01-8566-7ff93261d76f",
    "roleDefinitionId": "/providers/Microsoft.Billing/billingAccounts/7898901/enrollmentAccounts/225314/billingRoleDefinitions/a0bcee42-bf30-4d1b-926a-48d21664ef71",
    "scope": "/providers/Microsoft.Billing/billingAccounts/7898901/enrollmentAccounts/225314"
  },
  "type": "Microsoft.Billing/billingAccounts/enrollmentAccounts/billingRoleAssignments"
}

Definizioni

Nome	Descrizione
BillingRoleAssignment	Assegnazione di ruolo
ErrorDetails	Dettagli dell'errore.
ErrorResponse	La risposta di errore indica che il servizio non è in grado di elaborare la richiesta in ingresso. Il motivo viene fornito nel messaggio di errore.
ErrorSubDetails

BillingRoleAssignment

Assegnazione di ruolo

Nome	Tipo	Descrizione
id	string	ID risorsa.
name	string	Nome risorsa.
properties.createdByPrincipalId	string	ID principale dell'utente che ha creato l'assegnazione di ruolo.
properties.createdByPrincipalTenantId	string	ID tenant dell'utente che ha creato l'assegnazione di ruolo.
properties.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 tipo di contratto Enterprise Agreement.
properties.createdOn	string	Data di creazione dell'assegnazione di ruolo.
properties.name	string	Nome dell'assegnazione di ruolo.
properties.principalId	string	ID principale dell'utente a cui è stato assegnato il ruolo.
properties.principalTenantId	string	ID tenant principale dell'utente a cui è stato assegnato il ruolo.
properties.roleDefinitionId	string	ID della definizione del ruolo.
properties.scope	string	Ambito in cui è stato assegnato il ruolo.
properties.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 tipo di contratto Enterprise Agreement.
properties.userEmailAddress	string	Indirizzo di posta elettronica dell'utente a cui è stato assegnato il ruolo. Questa opzione è supportata solo per gli account di fatturazione con tipo di contratto Enterprise Agreement.
type	string	Tipo di risorsa.

ErrorDetails

Dettagli dell'errore.

Nome	Tipo	Descrizione
code	string	Codice di errore.
details	ErrorSubDetails[]	Dettagli secondari dell'errore.
message	string	Messaggio di errore che indica il motivo per cui l'operazione non è riuscita.
target	string	Destinazione dell'errore specifico.

ErrorResponse

La risposta di errore indica che il servizio non è in grado di elaborare la richiesta in ingresso. Il motivo viene fornito nel messaggio di errore.

Nome	Tipo	Descrizione
error	ErrorDetails	Dettagli dell'errore.

ErrorSubDetails

Nome	Tipo	Descrizione
code	string	Codice di errore.
message	string	Messaggio di errore che indica il motivo per cui l'operazione non è riuscita.
target	string	Destinazione dell'errore specifico.

Condividi tramite