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}/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.
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 MSA, dell'utente a cui è stato assegnato il ruolo. Questo è supportato solo per gli account di fatturazione con il tipo di contratto Enterprise Agreement.
properties.userEmailAddress	string	Indirizzo di posta elettronica dell'utente a cui è stato assegnato il ruolo. Questo è supportato solo per gli account di fatturazione con il 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 perché 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

PutEnrollmentAdministratorRoleAssignment

Esempio di richiesta

HTTP

PUT https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/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/billingRoleDefinitions/9f1983cb-2574-400c-87e9-34cf8e2280db"
  }
}

Risposta di esempio

Codice di stato:: 200

{
  "id": "/providers/Microsoft.Billing/billingAccounts/7898901/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/billingRoleDefinitions/9f1983cb-2574-400c-87e9-34cf8e2280db",
    "scope": "/providers/Microsoft.Billing/billingAccounts/7898901"
  },
  "type": "Microsoft.Billing/billingAccounts/billingRoleAssignments"
}

Definizioni

Nome	Descrizione
BillingRoleAssignment	Assegnazione di ruolo
ErrorDetails	Dettagli dell'errore.
ErrorResponse	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. Questo è supportato solo per gli account di fatturazione con il 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 MSA, dell'utente a cui è stato assegnato il ruolo. Questo è supportato solo per gli account di fatturazione con il tipo di contratto Enterprise Agreement.
properties.userEmailAddress	string	Indirizzo di posta elettronica dell'utente a cui è stato assegnato il ruolo. Questo è supportato solo per gli account di fatturazione con il 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 perché l'operazione non è riuscita.
target	string	Destinazione dell'errore specifico.

ErrorResponse

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 perché l'operazione non è riuscita.
target	string	Destinazione dell'errore specifico.

Condividi tramite