Partager via

Billing Role Assignments - Create By Invoice Section

  • Référence
Service:
Billing
Version d'API:
2024-04-01

Ajoute une attribution de rôle dans une section de facture. L’opération est prise en charge pour les comptes de facturation avec le type contrat client Microsoft.

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/invoiceSections/{invoiceSectionName}/createBillingRoleAssignment?api-version=2024-04-01

Paramètres URI

Nom Dans Obligatoire Type Description
billingAccountName
 path True

string

ID qui identifie de façon unique un compte de facturation.

Modèle d’expression régulière: ^([0-9]+|([Pp][Cc][Nn]\.[A-Za-z0-9]+)|[0-9A-Fa-f]{8}-([0-9A-Fa-f]{4}-){3}[0-9A-Fa-f]{12}(:[0-9A-Fa-f]{8}-([0-9A-Fa-f]{4}-){3}[0-9A-Fa-f]{12}_[0-9]{4}(-[0-9]{2}){2})?)$
billingProfileName
 path True

string

ID qui identifie de façon unique un profil de facturation.

Modèle d’expression régulière: ^[a-zA-Z\d-_]{1,128}$
invoiceSectionName
 path True

string

ID qui identifie de façon unique une section de facture.

Modèle d’expression régulière: ^[a-zA-Z\d-_]{1,128}$
api-version
 query True

string

Version de l’API à utiliser avec la demande cliente. La version actuelle est 2024-04-01.

Corps de la demande

Nom Obligatoire Type Description
roleDefinitionId True

string

ID de la définition de rôle.
principalId

string

ID d’objet de l’utilisateur auquel le rôle a été attribué.
principalPuid

string

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

string

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

string

Étendue à laquelle le rôle a été attribué.
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é. Cela est pris en charge uniquement pour les comptes de facturation avec le type Contrat Entreprise de type Contrat Entreprise.
userEmailAddress

string

Adresse e-mail de l’utilisateur auquel le rôle a été attribué. Cela est pris en charge uniquement pour les comptes de facturation avec le type Contrat Entreprise de type Contrat Entreprise.

Réponses

Nom Type Description
200 OK

BillingRoleAssignment

Propriétés de l’attribution de rôle de facturation.
202 Accepted

Propriétés de l’attribution de rôle de facturation.

En-têtes

  • Location: string
  • Retry-After: integer
Other Status Codes

ErrorResponse

Réponse d’erreur décrivant pourquoi l’opération a échoué.

Exemples

BillingRoleAssignmentCreateByInvoiceSection

Exemple de requête

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2018-09-30/billingProfiles/BKM6-54VH-BG7-PGB/invoiceSections/xxxx-xxxx-xxx-xxx/createBillingRoleAssignment?api-version=2024-04-01

{
  "principalId": "00000000-0000-0000-0000-000000000000",
  "principalTenantId": "076915e7-de10-4323-bb34-a58c904068bb",
  "roleDefinitionId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2018-09-30/billingProfiles/BKM6-54VH-BG7-PGB/invoiceSections/xxxx-xxxx-xxx-xxx/billingRoleDefinitions/10000000-aaaa-bbbb-cccc-100000000000",
  "userEmailAddress": "john@contoso.com"
}

Exemple de réponse

Code d’état:
200 
{
  "id": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2018-09-30/billingProfiles/BKM6-54VH-BG7-PGB/invoiceSections/xxxx-xxxx-xxx-xxx/billingRoleAssignments/10000000-aaaa-bbbb-cccc-100000000000_00000000-0000-0000-0000-000000000000",
  "name": "10000000-aaaa-bbbb-cccc-100000000000_00000000-0000-0000-0000-000000000000",
  "properties": {
    "createdOn": "2023-10-19T20:10:50.1028398Z",
    "createdByPrincipalTenantId": "076915e7-de10-4323-bb34-a58c904068bb",
    "createdByPrincipalId": "47309529-17e6-4104-b9e8-39f62fa1e5ed",
    "principalId": "00000000-0000-0000-0000-000000000000",
    "roleDefinitionId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2018-09-30/billingProfiles/BKM6-54VH-BG7-PGB/invoiceSections/xxxx-xxxx-xxx-xxx/billingRoleDefinitions/10000000-aaaa-bbbb-cccc-100000000000",
    "scope": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2018-09-30/billingProfiles/BKM6-54VH-BG7-PGB/invoiceSections/xxxx-xxxx-xxx-xxx",
    "principalType": "User"
  },
  "type": "Microsoft.Billing/billingAccounts/billingProfiles/invoiceSections/billingRoleAssignments"
}
Code d’état:
202 
location: https://management.azure.com/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2018-09-30/billingProfiles/xxxx-xxxx-xxx-xxx/invoiceSections/xxxx-xxxx-xxx-xxx/operationResults/createBillingRoleAssignment_10000000-0000-0000-0000-000000000001?api-version=2024-04-01
retry-after: 5

Définitions

Nom Description
BillingRoleAssignment

Propriétés de l’attribution de rôle de facturation.
BillingRoleAssignmentProperties

Propriétés de l’attribution de rôle de facturation.
createdByType

Type d’identité qui a créé la ressource.
ErrorAdditionalInfo

Informations supplémentaires sur l’erreur de gestion des ressources.
ErrorDetail

Détail de l’erreur.
ErrorResponse

Réponse d’erreur
PrincipalType

Type d’attribution de rôle.
ProvisioningState

État d’approvisionnement de la ressource pendant une opération de longue durée.
systemData

Métadonnées relatives à la création et à la dernière modification de la ressource.

BillingRoleAssignment

Propriétés de l’attribution de rôle de facturation.

Nom Type Description
id

string

ID de ressource complet pour la ressource. Par exemple, « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} »
name

string

Nom de la ressource
properties

BillingRoleAssignmentProperties

Propriétés de l’attribution de rôle de facturation.
systemData

systemData

Métadonnées Azure Resource Manager contenant les informations createdBy et modifiedBy.
tags

object

Dictionnaire de métadonnées associées à la ressource. Il peut ne pas être rempli pour tous les types de ressources. Longueur maximale de clé/valeur prise en charge de 256 caractères. Les clés/valeur ne doivent pas être vides ni null. Les clés ne peuvent pas contenir <> % & \ ? /
type

string

Type de la ressource. Par exemple, « Microsoft.Compute/virtualMachines » ou « Microsoft.Storage/storageAccounts »

BillingRoleAssignmentProperties

Propriétés de l’attribution de rôle de facturation.

Nom Type Description
billingAccountDisplayName

string

Nom du compte de facturation.
billingAccountId

string

ID complet qui identifie de façon unique un compte de facturation.
billingProfileDisplayName

string

Nom du profil de facturation.
billingProfileId

string

ID complet qui identifie de façon unique un profil de facturation.
billingRequestId

string

ID de la demande de facturation créée pour l’attribution de rôle. Cela s’applique uniquement aux attributions de rôles entre locataires ou aux attributions de rôles créées par le biais de la demande de facturation.
createdByPrincipalId

string

ID d’objet de l’utilisateur qui a créé l’attribution de rôle.
createdByPrincipalPuid

string

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

string

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

string

Adresse e-mail de l’utilisateur qui a créé l’attribution de rôle. Cela est pris en charge uniquement pour les comptes de facturation avec le type Contrat Entreprise de type Contrat Entreprise.
createdOn

string

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

string

Nom du client.
customerId

string

ID complet qui identifie de façon unique un client.
invoiceSectionDisplayName

string

Nom de la section de facture.
invoiceSectionId

string

ID complet qui identifie de manière unique une section de facture.
modifiedByPrincipalId

string

PUID principal de l’utilisateur qui a modifié l’attribution de rôle.
modifiedByPrincipalPuid

string

PUID principal de l’utilisateur qui a modifié l’attribution de rôle.
modifiedByPrincipalTenantId

string

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

string

Adresse e-mail de l’utilisateur qui a modifié l’attribution de rôle. Cela est pris en charge uniquement pour les comptes de facturation avec le type Contrat Entreprise de type Contrat Entreprise.
modifiedOn

string

Date de modification de l’attribution de rôle.
principalDisplayName

string

Nom complet du principal auquel le rôle a été attribué.
principalId

string

ID d’objet de l’utilisateur auquel le rôle a été attribué.
principalPuid

string

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

string

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

string

Nom convivial du locataire de l’utilisateur auquel le rôle a été attribué. Il s’agit du « locataire principal » pour le locataire principal du compte de facturation.
principalType

PrincipalType

Type d’attribution de rôle.
provisioningState

ProvisioningState

État d’approvisionnement de la ressource pendant une opération de longue durée.
roleDefinitionId

string

ID de la définition de rôle.
scope

string

Étendue à laquelle le rôle a été attribué.
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é. Cela est pris en charge uniquement pour les comptes de facturation avec le type Contrat Entreprise de type Contrat Entreprise.
userEmailAddress

string

Adresse e-mail de l’utilisateur auquel le rôle a été attribué. Cela est pris en charge uniquement pour les comptes de facturation avec le type Contrat Entreprise de type Contrat Entreprise.

createdByType

Type d’identité qui a créé la ressource.

Nom Type Description
Application

string

Key

string

ManagedIdentity

string

User

string

ErrorAdditionalInfo

Informations supplémentaires sur l’erreur de gestion des ressources.

Nom Type Description
info

object

Informations supplémentaires.
type

string

Type d’informations supplémentaire.

ErrorDetail

Détail de l’erreur.

Nom Type Description
additionalInfo

ErrorAdditionalInfo[]

Informations supplémentaires sur l’erreur.
code

string

Code d’erreur.
details

ErrorDetail[]

Détails de l’erreur.
message

string

Message d’erreur.
target

string

Cible d’erreur.

ErrorResponse

Réponse d’erreur

Nom Type Description
error

ErrorDetail

Objet d’erreur.

PrincipalType

Type d’attribution de rôle.

Nom Type Description
DirectoryRole

string

Everyone

string

Group

string

None

string

ServicePrincipal

string

Unknown

string

User

string

ProvisioningState

État d’approvisionnement de la ressource pendant une opération de longue durée.

Nom Type Description
Canceled

string

Failed

string

New

string

Pending

string

Provisioning

string

Succeeded

string

systemData

Métadonnées relatives à la création et à la dernière modification de la ressource.

Nom Type Description
createdAt

string

Horodatage de la création de ressources (UTC).
createdBy

string

Identité qui a créé la ressource.
createdByType

createdByType

Type d’identité qui a créé la ressource.
lastModifiedAt

string

Horodatage de la dernière modification de ressource (UTC)
lastModifiedBy

string

Identité qui a modifié la ressource pour la dernière fois.
lastModifiedByType

createdByType

Type d’identité qui a modifié la ressource pour la dernière fois.