Delen via


Billing Role Assignments - List By Customer

Geeft een lijst weer van de roltoewijzingen voor de beller op de klant. De bewerking wordt ondersteund voor factureringsaccounts met het overeenkomsttype Microsoft Partner-overeenkomst.

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/customers/{customerName}/billingRoleAssignments?api-version=2024-04-01
GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/customers/{customerName}/billingRoleAssignments?api-version=2024-04-01&filter={filter}&top={top}&skip={skip}

URI-parameters

Name In Vereist Type Description
billingAccountName
path True

string

De id waarmee een factureringsrekening uniek wordt geïdentificeerd.

Regex-patroon: ^([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

De id waarmee een factureringsprofiel uniek wordt geïdentificeerd.

Regex-patroon: ^[a-zA-Z\d-_]{1,128}$

customerName
path True

string

De id waarmee een klant uniek wordt geïdentificeerd.

Regex-patroon: ^[a-zA-Z\d-_]{1,128}$

api-version
query True

string

De versie van de API die moet worden gebruikt met de clientaanvraag. De huidige versie is 2024-04-01.

filter
query

string

Met de filterqueryoptie kunnen clients een verzameling resources filteren die worden geadresseerd door een aanvraag-URL.

skip
query

integer

int64

De optie voor het overslaan van query's vraagt het aantal items in de opgevraagde verzameling op die moeten worden overgeslagen en niet in het resultaat worden opgenomen.

top
query

integer

int64

De bovenste queryoptie vraagt het aantal items in de opgevraagde verzameling op om in het resultaat te worden opgenomen. De maximaal ondersteunde waarde voor top is 50.

Antwoorden

Name Type Description
200 OK

BillingRoleAssignmentListResult

De lijst met factureringsroltoewijzingen.

Other Status Codes

ErrorResponse

Foutreactie waarin wordt beschreven waarom de bewerking is mislukt.

Voorbeelden

BillingRoleAssignmentListByCustomer

Voorbeeldaanvraag

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/customers/703ab484-dda2-4402-827b-a74513b61e2d/billingRoleAssignments?api-version=2024-04-01

Voorbeeldrespons

{
  "value": [
    {
      "id": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2018-09-30/billingProfiles/BKM6-54VH-BG7-PGB/customers/703ab484-dda2-4402-827b-a74513b61e2d/billingRoleAssignments/30000000-aaaa-bbbb-cccc-100000000000_6fd330f6-7d26-4aff-b9cf-7bd699f965b9",
      "name": "30000000-aaaa-bbbb-cccc-100000000000_6fd330f6-7d26-4aff-b9cf-7bd699f965b9",
      "properties": {
        "createdOn": "2023-10-19T20:10:50.1028398Z",
        "createdByPrincipalTenantId": "076915e7-de10-4323-bb34-a58c904068bb",
        "createdByPrincipalId": "",
        "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/customers/703ab484-dda2-4402-827b-a74513b61e2d/billingRoleDefinitions/30000000-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/customers/703ab484-dda2-4402-827b-a74513b61e2d",
        "principalType": "User"
      },
      "type": "Microsoft.Billing/billingAccounts/billingProfiles/customers/billingRoleAssignments"
    },
    {
      "id": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2018-09-30/billingProfiles/BKM6-54VH-BG7-PGB/customers/703ab484-dda2-4402-827b-a74513b61e2d/billingRoleAssignments/30000000-aaaa-bbbb-cccc-100000000000_b1839933-b3ac-42ca-8112-d29c43f3ab47",
      "name": "30000000-aaaa-bbbb-cccc-100000000000_b1839933-b3ac-42ca-8112-d29c43f3ab47",
      "properties": {
        "createdOn": "2023-10-19T20:10:50.1028398Z",
        "createdByPrincipalTenantId": "076915e7-de10-4323-bb34-a58c904068bb",
        "createdByPrincipalId": "",
        "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/customers/703ab484-dda2-4402-827b-a74513b61e2d/billingRoleDefinitions/30000000-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/customers/703ab484-dda2-4402-827b-a74513b61e2d",
        "principalType": "User"
      },
      "type": "Microsoft.Billing/billingAccounts/billingProfiles/customers/billingRoleAssignments"
    }
  ]
}

Definities

Name Description
BillingRoleAssignment

De eigenschappen van de toewijzing van de factureringsrol.

BillingRoleAssignmentListResult

Een container voor een lijst met resources

BillingRoleAssignmentProperties

De eigenschappen van de toewijzing van de factureringsrol.

createdByType

Het type identiteit waarmee de resource is gemaakt.

ErrorAdditionalInfo

Aanvullende informatie over de resourcebeheerfout.

ErrorDetail

De foutdetails.

ErrorResponse

Foutreactie

PrincipalType

Het type roltoewijzing.

ProvisioningState

De inrichtingsstatus van de resource tijdens een langdurige bewerking.

systemData

Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.

BillingRoleAssignment

De eigenschappen van de toewijzing van de factureringsrol.

Name Type Description
id

string

Volledig gekwalificeerde resource-id voor de resource. Bijvoorbeeld /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceType}/{resourceName}"

name

string

De naam van de resource

properties

BillingRoleAssignmentProperties

De eigenschappen van de toewijzing van de factureringsrol.

systemData

systemData

Azure Resource Manager-metagegevens met createdBy- en modifiedBy-gegevens.

tags

object

Woordenlijst met metagegevens die zijn gekoppeld aan de resource. Deze kan niet worden ingevuld voor alle resourcetypen. Maximale lengte van sleutel/waarde die wordt ondersteund door 256 tekens. Sleutels/waarde mogen geen lege waarde of null zijn. Sleutels kunnen geen <> % & \ bevatten? /

type

string

Het type resource. Bijvoorbeeld 'Microsoft.Compute/virtualMachines' of 'Microsoft.Storage/storageAccounts'

BillingRoleAssignmentListResult

Een container voor een lijst met resources

Name Type Description
nextLink

string

De koppeling (URL) naar de volgende pagina met resultaten.

value

BillingRoleAssignment[]

De lijst met resources.

BillingRoleAssignmentProperties

De eigenschappen van de toewijzing van de factureringsrol.

Name Type Description
billingAccountDisplayName

string

De naam van de factureringsrekening.

billingAccountId

string

De volledig gekwalificeerde id waarmee een factureringsrekening uniek wordt geïdentificeerd.

billingProfileDisplayName

string

De naam van het factureringsprofiel.

billingProfileId

string

De volledig gekwalificeerde id waarmee een factureringsprofiel uniek wordt geïdentificeerd.

billingRequestId

string

De id van de factureringsaanvraag die is gemaakt voor de roltoewijzing. Dit is alleen van toepassing op roltoewijzingen voor meerdere tenants of roltoewijzingen die zijn gemaakt via de factureringsaanvraag.

createdByPrincipalId

string

De object-id van de gebruiker die de roltoewijzing heeft gemaakt.

createdByPrincipalPuid

string

De principal PUID van de gebruiker die de roltoewijzing heeft gemaakt.

createdByPrincipalTenantId

string

De tenant-id van de gebruiker die de roltoewijzing heeft gemaakt.

createdByUserEmailAddress

string

Het e-mailadres van de gebruiker die de roltoewijzing heeft gemaakt. Dit wordt alleen ondersteund voor factureringsaccounts met enterprise agreement-type.

createdOn

string

De datum waarop de roltoewijzing is gemaakt.

customerDisplayName

string

De naam van de klant.

customerId

string

De volledig gekwalificeerde id waarmee een klant uniek wordt geïdentificeerd.

invoiceSectionDisplayName

string

De naam van de factuursectie.

invoiceSectionId

string

De volledig gekwalificeerde id waarmee een factuursectie uniek wordt geïdentificeerd.

modifiedByPrincipalId

string

De principal PUID van de gebruiker die de roltoewijzing heeft gewijzigd.

modifiedByPrincipalPuid

string

De principal PUID van de gebruiker die de roltoewijzing heeft gewijzigd.

modifiedByPrincipalTenantId

string

De tenant-id van de gebruiker die de roltoewijzing heeft gewijzigd.

modifiedByUserEmailAddress

string

Het e-mailadres van de gebruiker die de roltoewijzing heeft gewijzigd. Dit wordt alleen ondersteund voor factureringsaccounts met enterprise agreement-type.

modifiedOn

string

De datum waarop de roltoewijzing is gewijzigd.

principalDisplayName

string

De weergavenaam van de principal aan wie de rol is toegewezen.

principalId

string

De object-id van de gebruiker aan wie de rol is toegewezen.

principalPuid

string

De principal PUID van de gebruiker aan wie de rol is toegewezen.

principalTenantId

string

De principal-tenant-id van de gebruiker aan wie de rol is toegewezen.

principalTenantName

string

De beschrijvende naam van de tenant van de gebruiker aan wie de rol is toegewezen. Dit is 'Primaire tenant' voor de primaire tenant van de factureringsrekening.

principalType

PrincipalType

Het type roltoewijzing.

provisioningState

ProvisioningState

De inrichtingsstatus van de resource tijdens een langdurige bewerking.

roleDefinitionId

string

De id van de roldefinitie.

scope

string

Het bereik waaraan de rol is toegewezen.

userAuthenticationType

string

Het verificatietype van de gebruiker, organisatie of MSA, van de gebruiker aan wie de rol is toegewezen. Dit wordt alleen ondersteund voor factureringsaccounts met enterprise agreement-type.

userEmailAddress

string

Het e-mailadres van de gebruiker aan wie de rol is toegewezen. Dit wordt alleen ondersteund voor factureringsaccounts met enterprise agreement-type.

createdByType

Het type identiteit waarmee de resource is gemaakt.

Name Type Description
Application

string

Key

string

ManagedIdentity

string

User

string

ErrorAdditionalInfo

Aanvullende informatie over de resourcebeheerfout.

Name Type Description
info

object

De aanvullende informatie.

type

string

Het extra informatietype.

ErrorDetail

De foutdetails.

Name Type Description
additionalInfo

ErrorAdditionalInfo[]

De fout bevat aanvullende informatie.

code

string

De foutcode.

details

ErrorDetail[]

De foutdetails.

message

string

Het foutbericht.

target

string

Het foutdoel.

ErrorResponse

Foutreactie

Name Type Description
error

ErrorDetail

Het foutobject.

PrincipalType

Het type roltoewijzing.

Name Type Description
DirectoryRole

string

Everyone

string

Group

string

None

string

ServicePrincipal

string

Unknown

string

User

string

ProvisioningState

De inrichtingsstatus van de resource tijdens een langdurige bewerking.

Name Type Description
Canceled

string

Failed

string

New

string

Pending

string

Provisioning

string

Succeeded

string

systemData

Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.

Name Type Description
createdAt

string

De tijdstempel van het maken van resources (UTC).

createdBy

string

De identiteit waarmee de resource is gemaakt.

createdByType

createdByType

Het type identiteit waarmee de resource is gemaakt.

lastModifiedAt

string

De tijdstempel van de laatste wijziging van de resource (UTC)

lastModifiedBy

string

De identiteit die de resource voor het laatst heeft gewijzigd.

lastModifiedByType

createdByType

Het type identiteit dat de resource voor het laatst heeft gewijzigd.