Billing Role Assignments - Create By Billing Profile
Szerepkör-hozzárendelést ad hozzá egy számlázási profilhoz. A műveletet a Microsoft Partnerszerződés vagy a Microsoft Ügyfélszerződés típusú számlázási fiókok támogatják.
POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/createBillingRoleAssignment?api-version=2024-04-01
URI-paraméterek
Name | In | Kötelező | Típus | Description |
---|---|---|---|---|
billing
|
path | True |
string |
A számlázási fiókot egyedileg azonosító azonosító. Reguláris kifejezési minta: |
billing
|
path | True |
string |
A számlázási profilt egyedileg azonosító azonosító. Reguláris kifejezési minta: |
api-version
|
query | True |
string |
Az ügyfélkéréshez használni kívánt API verziója. A jelenlegi verzió: 2024-04-01. |
Kérelem törzse
Name | Kötelező | Típus | Description |
---|---|---|---|
roleDefinitionId | True |
string |
A szerepkördefiníció azonosítója. |
principalId |
string |
Annak a felhasználónak az objektumazonosítója, amelyhez a szerepkör hozzá lett rendelve. |
|
principalPuid |
string |
Annak a felhasználónak az elsődleges PUID-azonosítója, amelyhez a szerepkör hozzá lett rendelve. |
|
principalTenantId |
string |
Annak a felhasználónak az elsődleges bérlőazonosítója, amelyhez a szerepkör hozzá lett rendelve. |
|
scope |
string |
Az a hatókör, amelyhez a szerepkör hozzá lett rendelve. |
|
userAuthenticationType |
string |
Annak a felhasználónak a hitelesítési típusa, akár szervezet, akár MSA, ahhoz a felhasználóhoz, amelyhez a szerepkör hozzá lett rendelve. Ez csak nagyvállalati szerződés típusú számlázási fiókok esetében támogatott. |
|
userEmailAddress |
string |
Annak a felhasználónak az e-mail-címe, amelyhez a szerepkör hozzá lett rendelve. Ez csak nagyvállalati szerződés típusú számlázási fiókok esetében támogatott. |
Válaszok
Name | Típus | Description |
---|---|---|
200 OK |
A számlázási szerepkör-hozzárendelés tulajdonságai. |
|
202 Accepted |
A számlázási szerepkör-hozzárendelés tulajdonságai. Fejlécek
|
|
Other Status Codes |
Hibaválasz, amely leírja, hogy miért nem sikerült a művelet. |
Példák
BillingRoleAssignmentCreateByBillingProfile
Mintakérelem
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/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/billingRoleDefinitions/10000000-aaaa-bbbb-cccc-100000000000",
"userEmailAddress": "john@contoso.com"
}
Mintaválasz
{
"id": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2018-09-30/billingProfiles/BKM6-54VH-BG7-PGB/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/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",
"principalType": "User"
},
"type": "Microsoft.Billing/billingAccounts/billingProfiles/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/operationResults/createBillingRoleAssignment_10000000-0000-0000-0000-000000000001?api-version=2024-04-01
retry-after: 5
Definíciók
Name | Description |
---|---|
Billing |
A számlázási szerepkör-hozzárendelés tulajdonságai. |
Billing |
A számlázási szerepkör-hozzárendelés tulajdonságai. |
created |
Az erőforrást létrehozó identitás típusa. |
Error |
Az erőforrás-kezelési hiba további információi. |
Error |
A hiba részletei. |
Error |
Hibaválasz |
Principal |
A szerepkör-hozzárendelés típusa. |
Provisioning |
Az erőforrás kiépítési állapota egy hosszú ideig futó művelet során. |
system |
Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok. |
BillingRoleAssignment
A számlázási szerepkör-hozzárendelés tulajdonságai.
Name | Típus | Description |
---|---|---|
id |
string |
Az erőforrás teljes erőforrás-azonosítója. Például: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
name |
string |
Az erőforrás neve |
properties |
A számlázási szerepkör-hozzárendelés tulajdonságai. |
|
systemData |
A createdBy és a modifiedBy adatokat tartalmazó Azure Resource Manager-metaadatok. |
|
tags |
object |
Az erőforráshoz társított metaadatok szótára. Lehet, hogy nem minden erőforrástípushoz van feltöltve. Legfeljebb 256 karakter hosszúságú kulcs/érték. A kulcsok/értékek nem üresek és nem lehet nullak. A kulcsok nem tartalmazhatnak <> % & \ ? / |
type |
string |
Az erőforrás típusa. Pl. "Microsoft.Compute/virtualMachines" vagy "Microsoft.Storage/storageAccounts" |
BillingRoleAssignmentProperties
A számlázási szerepkör-hozzárendelés tulajdonságai.
Name | Típus | Description |
---|---|---|
billingAccountDisplayName |
string |
A számlázási fiók neve. |
billingAccountId |
string |
A számlázási fiók egyedi azonosítóját egyedileg azonosító teljes azonosító. |
billingProfileDisplayName |
string |
A számlázási profil neve. |
billingProfileId |
string |
A számlázási profilt egyedileg azonosító teljes körű azonosító. |
billingRequestId |
string |
A szerepkör-hozzárendeléshez létrehozott számlázási kérelem azonosítója. Ez csak a számlázási kérelemben létrehozott bérlői szerepkör-hozzárendelésekre vagy szerepkör-hozzárendelésekre vonatkozik. |
createdByPrincipalId |
string |
A szerepkör-hozzárendelést létrehozó felhasználó objektumazonosítója. |
createdByPrincipalPuid |
string |
A szerepkör-hozzárendelést létrehozó felhasználó egyszerű PUID azonosítója. |
createdByPrincipalTenantId |
string |
A szerepkör-hozzárendelést létrehozó felhasználó bérlőazonosítója. |
createdByUserEmailAddress |
string |
A szerepkör-hozzárendelést létrehozó felhasználó e-mail-címe. Ez csak nagyvállalati szerződés típusú számlázási fiókok esetében támogatott. |
createdOn |
string |
A szerepkör-hozzárendelés létrehozásának dátuma. |
customerDisplayName |
string |
Az ügyfél neve. |
customerId |
string |
A teljes azonosító, amely egyedileg azonosítja az ügyfelet. |
invoiceSectionDisplayName |
string |
A számlaszakasz neve. |
invoiceSectionId |
string |
A számlaszakaszt egyedileg azonosító teljes azonosító. |
modifiedByPrincipalId |
string |
A szerepkör-hozzárendelést módosító felhasználó elsődleges PUID azonosítója. |
modifiedByPrincipalPuid |
string |
A szerepkör-hozzárendelést módosító felhasználó elsődleges PUID azonosítója. |
modifiedByPrincipalTenantId |
string |
A szerepkör-hozzárendelést módosító felhasználó bérlőazonosítója. |
modifiedByUserEmailAddress |
string |
A szerepkör-hozzárendelést módosító felhasználó e-mail-címe. Ez csak nagyvállalati szerződés típusú számlázási fiókok esetében támogatott. |
modifiedOn |
string |
A szerepkör-hozzárendelés módosításának dátuma. |
principalDisplayName |
string |
Annak az egyszerűnek a megjelenítendő neve, amelyhez a szerepkör hozzá lett rendelve. |
principalId |
string |
Annak a felhasználónak az objektumazonosítója, amelyhez a szerepkör hozzá lett rendelve. |
principalPuid |
string |
Annak a felhasználónak az elsődleges PUID-azonosítója, amelyhez a szerepkör hozzá lett rendelve. |
principalTenantId |
string |
Annak a felhasználónak az elsődleges bérlőazonosítója, amelyhez a szerepkör hozzá lett rendelve. |
principalTenantName |
string |
Annak a felhasználónak a bérlőjének rövid neve, amelyhez a szerepkör hozzá lett rendelve. Ez lesz az elsődleges bérlő a számlázási fiók elsődleges bérlője számára. |
principalType |
A szerepkör-hozzárendelés típusa. |
|
provisioningState |
Az erőforrás kiépítési állapota egy hosszú ideig futó művelet során. |
|
roleDefinitionId |
string |
A szerepkördefiníció azonosítója. |
scope |
string |
Az a hatókör, amelyhez a szerepkör hozzá lett rendelve. |
userAuthenticationType |
string |
Annak a felhasználónak a hitelesítési típusa, akár szervezet, akár MSA, ahhoz a felhasználóhoz, amelyhez a szerepkör hozzá lett rendelve. Ez csak nagyvállalati szerződés típusú számlázási fiókok esetében támogatott. |
userEmailAddress |
string |
Annak a felhasználónak az e-mail-címe, amelyhez a szerepkör hozzá lett rendelve. Ez csak nagyvállalati szerződés típusú számlázási fiókok esetében támogatott. |
createdByType
Az erőforrást létrehozó identitás típusa.
Name | Típus | Description |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
ErrorAdditionalInfo
Az erőforrás-kezelési hiba további információi.
Name | Típus | Description |
---|---|---|
info |
object |
A további információk. |
type |
string |
A további információtípus. |
ErrorDetail
A hiba részletei.
Name | Típus | Description |
---|---|---|
additionalInfo |
A hiba további információi. |
|
code |
string |
A hibakód. |
details |
A hiba részletei. |
|
message |
string |
A hibaüzenet. |
target |
string |
A hibacél. |
ErrorResponse
Hibaválasz
Name | Típus | Description |
---|---|---|
error |
A hibaobjektum. |
PrincipalType
A szerepkör-hozzárendelés típusa.
Name | Típus | Description |
---|---|---|
DirectoryRole |
string |
|
Everyone |
string |
|
Group |
string |
|
None |
string |
|
ServicePrincipal |
string |
|
Unknown |
string |
|
User |
string |
ProvisioningState
Az erőforrás kiépítési állapota egy hosszú ideig futó művelet során.
Name | Típus | Description |
---|---|---|
Canceled |
string |
|
Failed |
string |
|
New |
string |
|
Pending |
string |
|
Provisioning |
string |
|
Succeeded |
string |
systemData
Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.
Name | Típus | Description |
---|---|---|
createdAt |
string |
Az erőforrás-létrehozás időbélyege (UTC). |
createdBy |
string |
Az erőforrást létrehozó identitás. |
createdByType |
Az erőforrást létrehozó identitás típusa. |
|
lastModifiedAt |
string |
Az erőforrás utolsó módosításának időbélyege (UTC) |
lastModifiedBy |
string |
Az erőforrást legutóbb módosító identitás. |
lastModifiedByType |
Az erőforrást legutóbb módosító identitás típusa. |