Billing Role Assignments - List By Invoice Section
Répertorie les attributions de rôles pour l’appelant dans une section de facture. L’opération est prise en charge pour les comptes de facturation avec le type contrat client Microsoft.
GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/invoiceSections/{invoiceSectionName}/billingRoleAssignments?api-version=2024-04-01
GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/invoiceSections/{invoiceSectionName}/billingRoleAssignments?api-version=2024-04-01&filter={filter}&top={top}&skip={skip}
Paramètres URI
Nom | Dans | Obligatoire | Type | Description |
---|---|---|---|---|
billing
|
path | True |
string |
ID qui identifie de façon unique un compte de facturation. Modèle d’expression régulière: |
billing
|
path | True |
string |
ID qui identifie de façon unique un profil de facturation. Modèle d’expression régulière: |
invoice
|
path | True |
string |
ID qui identifie de façon unique une section de facture. Modèle d’expression régulière: |
api-version
|
query | True |
string |
Version de l’API à utiliser avec la demande cliente. La version actuelle est 2024-04-01. |
filter
|
query |
string |
L’option de requête de filtre permet aux clients de filtrer une collection de ressources qui sont traitées par une URL de requête. |
|
skip
|
query |
integer int64 |
L’option ignorer la requête demande le nombre d’éléments de la collection interrogée à ignorer et non inclus dans le résultat. |
|
top
|
query |
integer int64 |
L’option de requête supérieure demande le nombre d’éléments de la collection interrogée à inclure dans le résultat. La valeur maximale prise en charge pour le haut est 50. |
Réponses
Nom | Type | Description |
---|---|---|
200 OK |
Liste des attributions de rôles de facturation. |
|
Other Status Codes |
Réponse d’erreur décrivant pourquoi l’opération a échoué. |
Exemples
BillingRoleAssignmentListByInvoiceSection
Exemple de requête
GET 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/billingRoleAssignments?api-version=2024-04-01
Exemple de réponse
{
"value": [
{
"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_6fd330f6-7d26-4aff-b9cf-7bd699f965b9",
"name": "10000000-aaaa-bbbb-cccc-100000000000_6fd330f6-7d26-4aff-b9cf-7bd699f965b9",
"properties": {
"createdOn": "2023-10-19T20:10:50.1028398Z",
"createdByPrincipalTenantId": "076915e7-de10-4323-bb34-a58c904068bb",
"createdByPrincipalId": "00000000-0000-0000-0000-000000000001",
"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/30000000-aaaa-bbbb-cccc-100000000002",
"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"
},
{
"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_b1839933-b3ac-42ca-8112-d29c43f3ab47",
"name": "10000000-aaaa-bbbb-cccc-100000000000_b1839933-b3ac-42ca-8112-d29c43f3ab47",
"properties": {
"createdOn": "2023-10-19T20:10:50.1028398Z",
"createdByPrincipalTenantId": "076915e7-de10-4323-bb34-a58c904068bb",
"createdByPrincipalId": "00000000-0000-0000-0000-000000000001",
"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/30000000-aaaa-bbbb-cccc-100000000001",
"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"
}
]
}
Définitions
Nom | Description |
---|---|
Billing |
Propriétés de l’attribution de rôle de facturation. |
Billing |
Conteneur pour une liste de ressources |
Billing |
Propriétés de l’attribution de rôle de facturation. |
created |
Type d’identité qui a créé la ressource. |
Error |
Informations supplémentaires sur l’erreur de gestion des ressources. |
Error |
Détail de l’erreur. |
Error |
Réponse d’erreur |
Principal |
Type d’attribution de rôle. |
Provisioning |
État d’approvisionnement de la ressource pendant une opération de longue durée. |
system |
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 |
Propriétés de l’attribution de rôle de facturation. |
|
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 » |
BillingRoleAssignmentListResult
Conteneur pour une liste de ressources
Nom | Type | Description |
---|---|---|
nextLink |
string |
Lien (URL) vers la page suivante des résultats. |
value |
Liste des ressources. |
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 |
Type d’attribution de rôle. |
|
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 |
Informations supplémentaires sur l’erreur. |
|
code |
string |
Code d’erreur. |
details |
Détails de l’erreur. |
|
message |
string |
Message d’erreur. |
target |
string |
Cible d’erreur. |
ErrorResponse
Réponse d’erreur
Nom | Type | Description |
---|---|---|
error |
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 |
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 |
Type d’identité qui a modifié la ressource pour la dernière fois. |