Billing Role Assignments - Create By Invoice Section
Dodaje przypisanie roli w sekcji faktury. Ta operacja jest obsługiwana w przypadku kont rozliczeniowych z typem umowy z Umową z Klientem Microsoft.
POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/invoiceSections/{invoiceSectionName}/createBillingRoleAssignment?api-version=2024-04-01
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: |
invoice
|
path | True |
string |
Identyfikator, który jednoznacznie identyfikuje sekcję faktury. 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. |
Treść żądania
Nazwa | Wymagane | Typ | Opis |
---|---|---|---|
roleDefinitionId | True |
string |
Identyfikator definicji roli. |
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ę. |
|
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. |
Odpowiedzi
Nazwa | Typ | Opis |
---|---|---|
200 OK |
Właściwości przypisania roli rozliczeń. |
|
202 Accepted |
Właściwości przypisania roli rozliczeń. Nagłówki
|
|
Other Status Codes |
Odpowiedź na błąd opisująca, dlaczego operacja nie powiodła się. |
Przykłady
BillingRoleAssignmentCreateByInvoiceSection
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/BKM6-54VH-BG7-PGB/invoiceSections/xxxx-xxxx-xxx-xxx/createBillingRoleAssignment?api-version=2024-04-01
{
"principalId": "00000000-0000-0000-0000-000000000000",
"principalTenantId": "076915e7-de10-4323-bb34-a58c904068bb",
"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/10000000-aaaa-bbbb-cccc-100000000000",
"userEmailAddress": "john@contoso.com"
}
Przykładowa odpowiedź
{
"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_00000000-0000-0000-0000-000000000000",
"name": "10000000-aaaa-bbbb-cccc-100000000000_00000000-0000-0000-0000-000000000000",
"properties": {
"createdOn": "2023-10-19T20:10:50.1028398Z",
"createdByPrincipalTenantId": "076915e7-de10-4323-bb34-a58c904068bb",
"createdByPrincipalId": "47309529-17e6-4104-b9e8-39f62fa1e5ed",
"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/10000000-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/xxxx-xxxx-xxx-xxx/invoiceSections/xxxx-xxxx-xxx-xxx/operationResults/createBillingRoleAssignment_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 |
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" |
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. |