Billing Role Assignments - Create Or Update By Department

Referencia

Szolgáltatás:: Billing

API-verzió:: 2024-04-01

Számlázási szerepkör-hozzárendelés létrehozása vagy frissítése. A művelet csak nagyvállalati szerződés típusú számlázási fiókok esetében támogatott.

PUT https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/departments/{departmentName}/billingRoleAssignments/{billingRoleAssignmentName}?api-version=2024-04-01

URI-paraméterek

Name	In	Kötelező	Típus	Description
billingAccountName	path	True	string	A számlázási fiókot egyedileg azonosító azonosító. Reguláris kifejezési minta: `^([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})?)$`
billingRoleAssignmentName	path	True	string	A szerepkör-hozzárendelést egyedileg azonosító azonosító. Reguláris kifejezési minta: `^[a-fA-F0-9]{8}[-]?([a-fA-F0-9]{4}[-]?){3}[a-fA-F0-9]{12}(_[a-fA-F0-9]{8}[-]?([a-fA-F0-9]{4}[-]?){3}[a-fA-F0-9]{12})?$`
departmentName	path	True	string	A részleg neve. Reguláris kifejezési minta: `^[a-zA-Z\d-_]{1,128}$`
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	Típus	Description
properties	BillingRoleAssignmentProperties	A számlázási szerepkör-hozzárendelés tulajdonságai.
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 <> % & \ ? /

Válaszok

Name	Típus	Description
200 OK	BillingRoleAssignment	A számlázási szerepkör-hozzárendelés tulajdonságai.
201 Created	BillingRoleAssignment	A számlázási szerepkör-hozzárendelés tulajdonságai. Fejlécek Location: string Retry-After: integer
Other Status Codes	ErrorResponse	Hibaválasz, amely leírja, hogy miért nem sikerült a művelet.

Name

Típus

Description

200 OK

BillingRoleAssignment

A számlázási szerepkör-hozzárendelés tulajdonságai.

201 Created

BillingRoleAssignment

A számlázási szerepkör-hozzárendelés tulajdonságai.

Fejlécek

Location: string
Retry-After: integer

Other Status Codes

ErrorResponse

Hibaválasz, amely leírja, hogy miért nem sikerült a művelet.

Példák

BillingRoleAssignmentCreateOrUpdateByDepartment

Mintakérelem

HTTP

PUT https://management.azure.com/providers/Microsoft.Billing/billingAccounts/7898901/departments/12345/billingRoleAssignments/9dfd08c2-62a3-4d47-85bd-1cdba1408402?api-version=2024-04-01

{
  "properties": {
    "principalId": "00000000-0000-0000-0000-000000000000",
    "principalTenantId": "076915e7-de10-4323-bb34-a58c904068bb",
    "roleDefinitionId": "/providers/Microsoft.Billing/billingAccounts/7898901/departments/12345/billingRoleDefinitions/9f1983cb-2574-400c-87e9-34cf8e2280db",
    "userEmailAddress": "john@contoso.com"
  }
}

Mintaválasz

Állapotkód:: 200

{
  "id": "/providers/Microsoft.Billing/billingAccounts/7898901/departments/12345/billingRoleAssignments/9dfd08c2-62a3-4d47-85bd-1cdba1408402",
  "name": "9dfd08c2-62a3-4d47-85bd-1cdba1408402",
  "properties": {
    "createdOn": "2023-10-19T20:10:50.1028398Z",
    "createdByPrincipalTenantId": "076915e7-de10-4323-bb34-a58c904068bb",
    "createdByPrincipalId": "60d97094-2be4-46cc-a4fe-3633021a25b9",
    "principalId": "00000000-0000-0000-0000-000000000000",
    "principalTenantId": "7ca289b9-c32d-4f01-8566-7ff93261d76f",
    "roleDefinitionId": "/providers/Microsoft.Billing/billingAccounts/7898901/departments/12345/billingRoleDefinitions/9f1983cb-2574-400c-87e9-34cf8e2280db",
    "scope": "/providers/Microsoft.Billing/billingAccounts/7898901/departments/12345"
  },
  "type": "Microsoft.Billing/billingAccounts/departments/billingRoleAssignments"
}

Állapotkód:: 201

{
  "id": "/providers/Microsoft.Billing/billingAccounts/7898901/departments/12345/billingRoleAssignments/9dfd08c2-62a3-4d47-85bd-1cdba1408402",
  "name": "9dfd08c2-62a3-4d47-85bd-1cdba1408402",
  "properties": {
    "createdOn": "2023-10-19T20:10:50.1028398Z",
    "createdByPrincipalTenantId": "076915e7-de10-4323-bb34-a58c904068bb",
    "createdByPrincipalId": "60d97094-2be4-46cc-a4fe-3633021a25b9",
    "principalId": "00000000-0000-0000-0000-000000000000",
    "principalTenantId": "7ca289b9-c32d-4f01-8566-7ff93261d76f",
    "roleDefinitionId": "/providers/Microsoft.Billing/billingAccounts/7898901/departments/12345/billingRoleDefinitions/9f1983cb-2574-400c-87e9-34cf8e2280db",
    "scope": "/providers/Microsoft.Billing/billingAccounts/7898901/departments/12345"
  },
  "type": "Microsoft.Billing/billingAccounts/departments/billingRoleAssignments"
}

Definíciók

Name	Description
BillingRoleAssignment	A számlázási szerepkör-hozzárendelés tulajdonságai.
BillingRoleAssignmentProperties	A számlázási szerepkör-hozzárendelés tulajdonságai.
createdByType	Az erőforrást létrehozó identitás típusa.
ErrorAdditionalInfo	Az erőforrás-kezelési hiba további információi.
ErrorDetail	A hiba részletei.
ErrorResponse	Hibaválasz
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.
systemData	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	BillingRoleAssignmentProperties	A számlázási szerepkör-hozzárendelés tulajdonságai.
systemData	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	PrincipalType	A szerepkör-hozzárendelés típusa.
provisioningState	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	ErrorAdditionalInfo[]	A hiba további információi.
code	string	A hibakód.
details	ErrorDetail[]	A hiba részletei.
message	string	A hibaüzenet.
target	string	A hibacél.

ErrorResponse

Hibaválasz

Name	Típus	Description
error	ErrorDetail	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	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	createdByType	Az erőforrást legutóbb módosító identitás típusa.

Megosztás a következőn keresztül:

Billing Role Assignments - Create Or Update By Department

URI-paraméterek

Kérelem törzse

Válaszok

Példák

BillingRoleAssignmentCreateOrUpdateByDepartment

Mintakérelem

Mintaválasz

Definíciók

BillingRoleAssignment

BillingRoleAssignmentProperties

createdByType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

PrincipalType

ProvisioningState

systemData

További források