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

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.