Billing Role Assignments - List By Invoice Section
Zobrazí seznam přiřazení rolí volajícího v oddílu faktury. Operace je podporovaná pro fakturační účty s typem Smlouvy se zákazníkem Microsoftu.
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}
Parametry identifikátoru URI
Name | V | Vyžadováno | Typ | Description |
---|---|---|---|---|
billing
|
path | True |
string |
ID, které jednoznačně identifikuje fakturační účet. Vzor regulárního výrazu: |
billing
|
path | True |
string |
ID, které jednoznačně identifikuje fakturační profil. Vzor regulárního výrazu: |
invoice
|
path | True |
string |
ID, které jednoznačně identifikuje oddíl faktury. Vzor regulárního výrazu: |
api-version
|
query | True |
string |
Verze rozhraní API, která se má použít s požadavkem klienta. Aktuální verze je 2024-04-01. |
filter
|
query |
string |
Možnost dotazu filtru umožňuje klientům filtrovat kolekci prostředků adresovaných adresou URL požadavku. |
|
skip
|
query |
integer int64 |
Možnost přeskočit dotaz vyžaduje počet položek v dotazované kolekci, které se mají přeskočit a nejsou zahrnuty do výsledku. |
|
top
|
query |
integer int64 |
Horní možnost dotazu požaduje, aby se do výsledku zahrnul počet položek v dotazované kolekci. Maximální podporovaná hodnota pro top je 50. |
Odpovědi
Name | Typ | Description |
---|---|---|
200 OK |
Seznam přiřazení fakturačních rolí. |
|
Other Status Codes |
Chybová odpověď popisující, proč operace selhala. |
Příklady
BillingRoleAssignmentListByInvoiceSection
Ukázkový požadavek
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
Ukázková odpověď
{
"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"
}
]
}
Definice
Name | Description |
---|---|
Billing |
Vlastnosti přiřazení fakturační role. |
Billing |
Kontejner pro seznam prostředků |
Billing |
Vlastnosti přiřazení fakturační role. |
created |
Typ identity, která prostředek vytvořila. |
Error |
Další informace o chybě správy prostředků |
Error |
Podrobnosti o chybě. |
Error |
Chybová odpověď |
Principal |
Typ přiřazení role. |
Provisioning |
Stav zřizování prostředku během dlouhotrvající operace. |
system |
Metadata týkající se vytvoření a poslední změny prostředku. |
BillingRoleAssignment
Vlastnosti přiřazení fakturační role.
Name | Typ | Description |
---|---|---|
id |
string |
Plně kvalifikované ID prostředku pro prostředek. Například /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
name |
string |
Název prostředku |
properties |
Vlastnosti přiřazení fakturační role. |
|
systemData |
Metadata Azure Resource Manageru obsahující informace createdBy a modifiedBy |
|
tags |
object |
Slovník metadat přidružených k prostředku Nemusí být vyplněna pro všechny typy prostředků. Maximální podporovaná délka klíče a hodnoty 256 znaků. Klíče nebo hodnota by neměly být prázdné ani null. Klíče nemohou obsahovat <> % & \ ? / |
type |
string |
Typ prostředku. Například Microsoft.Compute/virtualMachines nebo Microsoft.Storage/storageAccounts |
BillingRoleAssignmentListResult
Kontejner pro seznam prostředků
Name | Typ | Description |
---|---|---|
nextLink |
string |
Odkaz (url) na další stránku výsledků. |
value |
Seznam prostředků. |
BillingRoleAssignmentProperties
Vlastnosti přiřazení fakturační role.
Name | Typ | Description |
---|---|---|
billingAccountDisplayName |
string |
Název fakturačního účtu. |
billingAccountId |
string |
Plně kvalifikované ID, které jednoznačně identifikuje fakturační účet. |
billingProfileDisplayName |
string |
Název fakturačního profilu. |
billingProfileId |
string |
Plně kvalifikované ID, které jednoznačně identifikuje fakturační profil. |
billingRequestId |
string |
ID žádosti o fakturaci vytvořené pro přiřazení role. To platí jenom pro přiřazení rolí mezi tenanty nebo přiřazení rolí vytvořených prostřednictvím žádosti o fakturaci. |
createdByPrincipalId |
string |
ID objektu uživatele, který vytvořil přiřazení role. |
createdByPrincipalPuid |
string |
Hlavní PUID uživatele, který vytvořil přiřazení role. |
createdByPrincipalTenantId |
string |
ID tenanta uživatele, který vytvořil přiřazení role. |
createdByUserEmailAddress |
string |
E-mailová adresa uživatele, který vytvořil přiřazení role. To se podporuje jenom u fakturačních účtů s typem smlouvy Enterprise. |
createdOn |
string |
Datum vytvoření přiřazení role. |
customerDisplayName |
string |
Jméno zákazníka. |
customerId |
string |
Plně kvalifikované ID, které jednoznačně identifikuje zákazníka. |
invoiceSectionDisplayName |
string |
Název oddílu faktury. |
invoiceSectionId |
string |
Plně kvalifikované ID, které jednoznačně identifikuje oddíl faktury. |
modifiedByPrincipalId |
string |
Hlavní PUID uživatele, který změnil přiřazení role. |
modifiedByPrincipalPuid |
string |
Hlavní PUID uživatele, který změnil přiřazení role. |
modifiedByPrincipalTenantId |
string |
ID tenanta uživatele, který změnil přiřazení role. |
modifiedByUserEmailAddress |
string |
E-mailová adresa uživatele, který změnil přiřazení role. To se podporuje jenom u fakturačních účtů s typem smlouvy Enterprise. |
modifiedOn |
string |
Datum změny přiřazení role. |
principalDisplayName |
string |
Zobrazovaný název objektu zabezpečení, kterému byla role přiřazena. |
principalId |
string |
ID objektu uživatele, kterému byla role přiřazena. |
principalPuid |
string |
Hlavní PUID uživatele, kterému byla role přiřazena. |
principalTenantId |
string |
ID hlavního tenanta uživatele, kterému byla role přiřazena. |
principalTenantName |
string |
Popisný název tenanta uživatele, kterému byla role přiřazena. Bude to primární tenant pro primárního tenanta fakturačního účtu. |
principalType |
Typ přiřazení role. |
|
provisioningState |
Stav zřizování prostředku během dlouhotrvající operace. |
|
roleDefinitionId |
string |
ID definice role. |
scope |
string |
Obor, ke kterému byla role přiřazena. |
userAuthenticationType |
string |
Typ ověřování uživatele, ať už organizace nebo msa, uživatele, kterému byla role přiřazena. To se podporuje jenom u fakturačních účtů s typem smlouvy Enterprise. |
userEmailAddress |
string |
E-mailová adresa uživatele, kterému byla role přiřazena. To se podporuje jenom u fakturačních účtů s typem smlouvy Enterprise. |
createdByType
Typ identity, která prostředek vytvořila.
Name | Typ | Description |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
ErrorAdditionalInfo
Další informace o chybě správy prostředků
Name | Typ | Description |
---|---|---|
info |
object |
Další informace. |
type |
string |
Další typ informací. |
ErrorDetail
Podrobnosti o chybě.
Name | Typ | Description |
---|---|---|
additionalInfo |
Další informace o chybě. |
|
code |
string |
Kód chyby. |
details |
Podrobnosti o chybě. |
|
message |
string |
Chybová zpráva. |
target |
string |
Cíl chyby. |
ErrorResponse
Chybová odpověď
Name | Typ | Description |
---|---|---|
error |
Objekt chyby. |
PrincipalType
Typ přiřazení role.
Name | Typ | Description |
---|---|---|
DirectoryRole |
string |
|
Everyone |
string |
|
Group |
string |
|
None |
string |
|
ServicePrincipal |
string |
|
Unknown |
string |
|
User |
string |
ProvisioningState
Stav zřizování prostředku během dlouhotrvající operace.
Name | Typ | Description |
---|---|---|
Canceled |
string |
|
Failed |
string |
|
New |
string |
|
Pending |
string |
|
Provisioning |
string |
|
Succeeded |
string |
systemData
Metadata týkající se vytvoření a poslední změny prostředku.
Name | Typ | Description |
---|---|---|
createdAt |
string |
Časové razítko vytvoření prostředku (UTC). |
createdBy |
string |
Identita, která prostředek vytvořila. |
createdByType |
Typ identity, která prostředek vytvořila. |
|
lastModifiedAt |
string |
Časové razítko poslední změny zdroje (UTC) |
lastModifiedBy |
string |
Identita, která naposledy změnila prostředek. |
lastModifiedByType |
Typ identity, která naposledy změnila prostředek. |