Billing Role Assignments - Resolve By Customer
Wyświetla listę przypisań ról dla obiektu wywołującego klienta podczas pobierania informacji o użytkowniku dla każdego przypisania roli. Ta operacja jest obsługiwana w przypadku kont rozliczeniowych z typem umowy Microsoft Partner Agreement.
POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/customers/{customerName}/resolveBillingRoleAssignments?api-version=2024-04-01
POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/customers/{customerName}/resolveBillingRoleAssignments?resolveScopeDisplayNames={resolveScopeDisplayNames}&api-version=2024-04-01&filter={filter}
Parametry identyfikatora URI
Nazwa | W | Wymagane | Typ | Opis |
---|---|---|---|---|
billing
|
path | True |
string |
Identyfikator, który jednoznacznie identyfikuje konto rozliczeniowe. Wzorzec wyrażenia regularnego: |
billing
|
path | True |
string |
Identyfikator, który jednoznacznie identyfikuje profil rozliczeniowy. Wzorzec wyrażenia regularnego: |
customer
|
path | True |
string |
Identyfikator, który jednoznacznie identyfikuje klienta. Wzorzec wyrażenia regularnego: |
api-version
|
query | True |
string |
Wersja interfejsu API, która ma być używana z żądaniem klienta. Bieżąca wersja to 2024-04-01. |
filter
|
query |
string |
Opcja zapytania filtru umożliwia klientom filtrowanie kolekcji zasobów, które są adresowane przez adres URL żądania. |
|
resolve
|
query |
boolean |
Rozpoznaje nazwę wyświetlaną zakresu dla każdego z przypisań ról. |
Odpowiedzi
Nazwa | Typ | Opis |
---|---|---|
200 OK |
Lista przypisań ról rozliczeń. |
|
202 Accepted |
Lista przypisań ról rozliczeń. Nagłówki
|
|
Other Status Codes |
Odpowiedź na błąd opisująca, dlaczego operacja nie powiodła się. |
Przykłady
ResolveBillingRoleAssignmentByCustomer
Przykładowe żądanie
POST 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/customers/703ab484-dda2-4402-827b-a74513b61e2d/resolveBillingRoleAssignments?api-version=2024-04-01
Przykładowa odpowiedź
{
"value": [
{
"id": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2018-09-30/billingProfiles/xxxx-xxxx-xxx-xxx/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": "00000000-0000-0000-0000-000000000001",
"principalId": "00000000-0000-0000-0000-000000000000",
"principalTenantId": "c360d6f1-2709-476d-81bb-d075b213d9fc",
"roleDefinitionId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2018-09-30/billingProfiles/xxxx-xxxx-xxx-xxx/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/xxxx-xxxx-xxx-xxx/customers/703ab484-dda2-4402-827b-a74513b61e2d",
"userEmailAddress": "foo@bar.com",
"principalTenantName": "Foo Bar",
"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/xxxx-xxxx-xxx-xxx/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": "00000000-0000-0000-0000-000000000001",
"principalId": "00000000-0000-0000-0000-000000000000",
"principalTenantId": "c360d6f1-2709-476d-81bb-d075b213d9fc",
"roleDefinitionId": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2018-09-30/billingProfiles/xxxx-xxxx-xxx-xxx/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/xxxx-xxxx-xxx-xxx/customers/703ab484-dda2-4402-827b-a74513b61e2d",
"userEmailAddress": "foo@bar.com",
"principalTenantName": "Foo Bar",
"principalType": "User"
},
"type": "Microsoft.Billing/billingAccounts/billingProfiles/customers/billingRoleAssignments"
}
]
}
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/customers/703ab484-dda2-4402-827b-a74513b61e2d/operationResults/resolveBillingRoleAssignments_10000000-0000-0000-0000-000000000001?api-version=2024-04-01
retry-after: 5
Definicje
Nazwa | Opis |
---|---|
Billing |
Właściwości przypisania roli rozliczeń. |
Billing |
Kontener dla listy zasobów |
Billing |
Właściwości przypisania roli rozliczeń. |
created |
Typ tożsamości, która utworzyła zasób. |
Error |
Dodatkowe informacje o błędzie zarządzania zasobami. |
Error |
Szczegóły błędu. |
Error |
Odpowiedź na błąd |
Principal |
Typ przypisania roli. |
Provisioning |
Stan aprowizacji zasobu podczas długotrwałej operacji. |
system |
Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu. |
BillingRoleAssignment
Właściwości przypisania roli rozliczeń.
Nazwa | Typ | Opis |
---|---|---|
id |
string |
W pełni kwalifikowany identyfikator zasobu dla zasobu. Np. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
name |
string |
Nazwa zasobu |
properties |
Właściwości przypisania roli rozliczeń. |
|
systemData |
Metadane usługi Azure Resource Manager zawierające informacje createdBy i modifiedBy. |
|
tags |
object |
Słownik metadanych skojarzonych z zasobem. Nie można go wypełnić dla wszystkich typów zasobów. Maksymalna długość klucza/wartości obsługiwana przez 256 znaków. Klucze/wartość nie powinny być puste ani mieć wartości null. Klucze nie mogą zawierać <> % & \ ? / |
type |
string |
Typ zasobu. Np. "Microsoft.Compute/virtualMachines" lub "Microsoft.Storage/storageAccounts" |
BillingRoleAssignmentListResult
Kontener dla listy zasobów
Nazwa | Typ | Opis |
---|---|---|
nextLink |
string |
Link (adres URL) do następnej strony wyników. |
value |
Lista zasobów. |
BillingRoleAssignmentProperties
Właściwości przypisania roli rozliczeń.
Nazwa | Typ | Opis |
---|---|---|
billingAccountDisplayName |
string |
Nazwa konta rozliczeniowego. |
billingAccountId |
string |
W pełni kwalifikowany identyfikator, który jednoznacznie identyfikuje konto rozliczeniowe. |
billingProfileDisplayName |
string |
Nazwa profilu rozliczeniowego. |
billingProfileId |
string |
W pełni kwalifikowany identyfikator, który jednoznacznie identyfikuje profil rozliczeniowy. |
billingRequestId |
string |
Identyfikator żądania rozliczeniowego, który został utworzony dla przypisania roli. Dotyczy to tylko przypisań ról między dzierżawami lub przypisań ról utworzonych za pośrednictwem żądania rozliczeniowego. |
createdByPrincipalId |
string |
Identyfikator obiektu użytkownika, który utworzył przypisanie roli. |
createdByPrincipalPuid |
string |
Główny identyfikator PUID użytkownika, który utworzył przypisanie roli. |
createdByPrincipalTenantId |
string |
Identyfikator dzierżawy użytkownika, który utworzył przypisanie roli. |
createdByUserEmailAddress |
string |
Adres e-mail użytkownika, który utworzył przypisanie roli. Jest to obsługiwane tylko w przypadku kont rozliczeniowych z typem umowy Enterprise Agreement. |
createdOn |
string |
Data utworzenia przypisania roli. |
customerDisplayName |
string |
Nazwa klienta. |
customerId |
string |
W pełni kwalifikowany identyfikator, który jednoznacznie identyfikuje klienta. |
invoiceSectionDisplayName |
string |
Nazwa sekcji faktury. |
invoiceSectionId |
string |
W pełni kwalifikowany identyfikator, który jednoznacznie identyfikuje sekcję faktury. |
modifiedByPrincipalId |
string |
Identyfikator PUID podmiotu zabezpieczeń użytkownika, który zmodyfikował przypisanie roli. |
modifiedByPrincipalPuid |
string |
Identyfikator PUID podmiotu zabezpieczeń użytkownika, który zmodyfikował przypisanie roli. |
modifiedByPrincipalTenantId |
string |
Identyfikator dzierżawy użytkownika, który zmodyfikował przypisanie roli. |
modifiedByUserEmailAddress |
string |
Adres e-mail użytkownika, który zmodyfikował przypisanie roli. Jest to obsługiwane tylko w przypadku kont rozliczeniowych z typem umowy Enterprise Agreement. |
modifiedOn |
string |
Data modyfikacji przypisania roli. |
principalDisplayName |
string |
Nazwa wyświetlana podmiotu zabezpieczeń, któremu przypisano rolę. |
principalId |
string |
Identyfikator obiektu użytkownika, któremu przypisano rolę. |
principalPuid |
string |
Główny identyfikator PUID użytkownika, któremu przypisano rolę. |
principalTenantId |
string |
Identyfikator głównej dzierżawy użytkownika, któremu przypisano rolę. |
principalTenantName |
string |
Przyjazna nazwa dzierżawy użytkownika, któremu przypisano rolę. Będzie to "Dzierżawa podstawowa" dla dzierżawy podstawowej konta rozliczeniowego. |
principalType |
Typ przypisania roli. |
|
provisioningState |
Stan aprowizacji zasobu podczas długotrwałej operacji. |
|
roleDefinitionId |
string |
Identyfikator definicji roli. |
scope |
string |
Zakres, w którym przypisano rolę. |
userAuthenticationType |
string |
Typ uwierzytelniania użytkownika, niezależnie od tego, czy jest to organizacja, czy MSA użytkownika, któremu przypisano rolę. Jest to obsługiwane tylko w przypadku kont rozliczeniowych z typem umowy Enterprise Agreement. |
userEmailAddress |
string |
Adres e-mail użytkownika, któremu przypisano rolę. Jest to obsługiwane tylko w przypadku kont rozliczeniowych z typem umowy Enterprise Agreement. |
createdByType
Typ tożsamości, która utworzyła zasób.
Nazwa | Typ | Opis |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
ErrorAdditionalInfo
Dodatkowe informacje o błędzie zarządzania zasobami.
Nazwa | Typ | Opis |
---|---|---|
info |
object |
Dodatkowe informacje. |
type |
string |
Dodatkowy typ informacji. |
ErrorDetail
Szczegóły błędu.
Nazwa | Typ | Opis |
---|---|---|
additionalInfo |
Dodatkowe informacje o błędzie. |
|
code |
string |
Kod błędu. |
details |
Szczegóły błędu. |
|
message |
string |
Komunikat o błędzie. |
target |
string |
Element docelowy błędu. |
ErrorResponse
Odpowiedź na błąd
Nazwa | Typ | Opis |
---|---|---|
error |
Obiekt błędu. |
PrincipalType
Typ przypisania roli.
Nazwa | Typ | Opis |
---|---|---|
DirectoryRole |
string |
|
Everyone |
string |
|
Group |
string |
|
None |
string |
|
ServicePrincipal |
string |
|
Unknown |
string |
|
User |
string |
ProvisioningState
Stan aprowizacji zasobu podczas długotrwałej operacji.
Nazwa | Typ | Opis |
---|---|---|
Canceled |
string |
|
Failed |
string |
|
New |
string |
|
Pending |
string |
|
Provisioning |
string |
|
Succeeded |
string |
systemData
Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.
Nazwa | Typ | Opis |
---|---|---|
createdAt |
string |
Sygnatura czasowa tworzenia zasobu (UTC). |
createdBy |
string |
Tożsamość, która utworzyła zasób. |
createdByType |
Typ tożsamości, która utworzyła zasób. |
|
lastModifiedAt |
string |
Znacznik czasu ostatniej modyfikacji zasobu (UTC) |
lastModifiedBy |
string |
Tożsamość, która ostatnio zmodyfikowała zasób. |
lastModifiedByType |
Typ tożsamości, która ostatnio zmodyfikowała zasób. |