Role Assignments - Put

Référence

Service:: Billing

Version d'API:: 2019-10-01-preview

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

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

Exemple de réponse

Code d’état:: 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"
}

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.

Partager via