Partager via


Role Assignments - Put

Créez ou mettez à jour une attribution de rôle de facturation.

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

Paramètres URI

Nom Dans Obligatoire Type Description
billingAccountName
path True

string

ID qui identifie de manière unique un compte de facturation.

billingRoleAssignmentName
path True

string

ID qui identifie de manière unique une attribution de rôle.

api-version
query True

string

Version de l’API à utiliser avec la demande cliente. La version actuelle est 2019-10-01-preview.

Corps de la demande

Nom Type Description
properties.principalId

string

ID principal de l’utilisateur auquel le rôle a été attribué.

properties.principalTenantId

string

ID de locataire principal de l’utilisateur auquel le rôle a été attribué.

properties.roleDefinitionId

string

ID de la définition de rôle.

properties.userAuthenticationType

string

Type d’authentification de l’utilisateur, qu’il s’agisse de l’organisation ou de msa, de l’utilisateur auquel le rôle a été attribué. Cette option est prise en charge uniquement pour les comptes de facturation avec le type de contrat Accord Entreprise.

properties.userEmailAddress

string

Adresse e-mail de l’utilisateur auquel le rôle a été attribué. Cette option est prise en charge uniquement pour les comptes de facturation avec le type de contrat Accord Entreprise.

Réponses

Nom Type Description
200 OK

BillingRoleAssignment

OK. La demande a réussi.

Other Status Codes

ErrorResponse

Réponse d’erreur décrivant la raison de l’échec de l’opération.

Sécurité

azure_auth

Flux OAuth2 Azure Active Directory.

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

Nom Description
user_impersonation Emprunter l’identité de votre compte d’utilisateur

Exemples

PutEnrollmentAdministratorRoleAssignment

Exemple de requête

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

Exemple de réponse

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

Définitions

Nom Description
BillingRoleAssignment

Attribution de rôle

ErrorDetails

Détails de l’erreur.

ErrorResponse

La réponse d’erreur indique que le service n’est pas en mesure de traiter la requête entrante. La raison est fournie dans le message d’erreur.

ErrorSubDetails

BillingRoleAssignment

Attribution de rôle

Nom Type Description
id

string

ID de ressource.

name

string

Nom de la ressource.

properties.createdByPrincipalId

string

ID principal de l’utilisateur qui a créé l’attribution de rôle.

properties.createdByPrincipalTenantId

string

ID de locataire de l’utilisateur qui a créé l’attribution de rôle.

properties.createdByUserEmailAddress

string

Adresse e-mail de l’utilisateur qui a créé l’attribution de rôle. Cette option est prise en charge uniquement pour les comptes de facturation avec le type de contrat Accord Entreprise.

properties.createdOn

string

Date de création de l’attribution de rôle.

properties.name

string

Nom de l’attribution de rôle.

properties.principalId

string

ID principal de l’utilisateur auquel le rôle a été attribué.

properties.principalTenantId

string

ID de locataire principal de l’utilisateur auquel le rôle a été attribué.

properties.roleDefinitionId

string

ID de la définition de rôle.

properties.scope

string

Étendue à laquelle le rôle a été attribué.

properties.userAuthenticationType

string

Type d’authentification de l’utilisateur, qu’il s’agisse de l’organisation ou de msa, de l’utilisateur auquel le rôle a été attribué. Cette option est prise en charge uniquement pour les comptes de facturation avec le type de contrat Accord Entreprise.

properties.userEmailAddress

string

Adresse e-mail de l’utilisateur auquel le rôle a été attribué. Cette option est prise en charge uniquement pour les comptes de facturation avec le type de contrat Accord Entreprise.

type

string

Type de ressource.

ErrorDetails

Détails de l’erreur.

Nom Type Description
code

string

Code d’erreur.

details

ErrorSubDetails[]

Sous-détails de l’erreur.

message

string

Message d’erreur indiquant la raison de l’échec de l’opération.

target

string

Cible de l’erreur particulière.

ErrorResponse

La réponse d’erreur indique que le service n’est pas en mesure de traiter la requête entrante. La raison est fournie dans le message d’erreur.

Nom Type Description
error

ErrorDetails

Détails de l’erreur.

ErrorSubDetails

Nom Type Description
code

string

Code d’erreur.

message

string

Message d’erreur indiquant la raison de l’échec de l’opération.

target

string

Cible de l’erreur particulière.