Sdílet prostřednictvím


Billing Role Assignments - Resolve By Invoice Section

Zobrazuje seznam přiřazení rolí volajícího v oddílu faktury při načítání informací o uživateli pro každé přiřazení role. Operace je podporovaná pro fakturační účty s typem Smlouvy se zákazníkem Microsoftu.

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

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
billingAccountName
path True

string

ID, které jednoznačně identifikuje fakturační účet.

Vzor regulárního výrazu: ^([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, které jednoznačně identifikuje fakturační profil.

Vzor regulárního výrazu: ^[a-zA-Z\d-_]{1,128}$

invoiceSectionName
path True

string

ID, které jednoznačně identifikuje oddíl faktury.

Vzor regulárního výrazu: ^[a-zA-Z\d-_]{1,128}$

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.

resolveScopeDisplayNames
query

boolean

Řeší zobrazovaný název oboru pro každé přiřazení rolí.

Odpovědi

Name Typ Description
200 OK

BillingRoleAssignmentListResult

Seznam přiřazení fakturačních rolí.

202 Accepted

Seznam přiřazení fakturačních rolí.

Hlavičky

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

ErrorResponse

Chybová odpověď popisující, proč operace selhala.

Příklady

ResolveBillingRoleAssignmentByInvoiceSection

Ukázkový požadavek

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/resolveBillingRoleAssignments?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-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"
    },
    {
      "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-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"
    }
  ]
}
location: 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/operationResults/resolveBillingRoleAssignments_10000000-0000-0000-0000-000000000001?api-version=2024-04-01
retry-after: 5

Definice

Name Description
BillingRoleAssignment

Vlastnosti přiřazení fakturační role.

BillingRoleAssignmentListResult

Kontejner pro seznam prostředků

BillingRoleAssignmentProperties

Vlastnosti přiřazení fakturační role.

createdByType

Typ identity, která prostředek vytvořila.

ErrorAdditionalInfo

Další informace o chybě správy prostředků

ErrorDetail

Podrobnosti o chybě.

ErrorResponse

Chybová odpověď

PrincipalType

Typ přiřazení role.

ProvisioningState

Stav zřizování prostředku během dlouhotrvající operace.

systemData

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

BillingRoleAssignmentProperties

Vlastnosti přiřazení fakturační role.

systemData

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

BillingRoleAssignment[]

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

PrincipalType

Typ přiřazení role.

provisioningState

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

ErrorAdditionalInfo[]

Další informace o chybě.

code

string

Kód chyby.

details

ErrorDetail[]

Podrobnosti o chybě.

message

string

Chybová zpráva.

target

string

Cíl chyby.

ErrorResponse

Chybová odpověď

Name Typ Description
error

ErrorDetail

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

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

createdByType

Typ identity, která naposledy změnila prostředek.