Condividi tramite


Role Assignments - Put

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

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

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