Billing Role Assignments - Create By Customer

Referens

Tjänst:: Billing

API-version:: 2024-04-01

Lägger till en rolltilldelning för en kund. Åtgärden stöds för faktureringskonton med avtalstypen Microsoft-partneravtal.

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/customers/{customerName}/createBillingRoleAssignment?api-version=2024-04-01

URI-parametrar

Name	I	Obligatorisk	Typ	Description
billingAccountName	path	True	string	Det ID som unikt identifierar ett faktureringskonto. Reguljärt uttrycksmönster: `^([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	Det ID som unikt identifierar en faktureringsprofil. Reguljärt uttrycksmönster: `^[a-zA-Z\d-_]{1,128}$`
customerName	path	True	string	Det ID som unikt identifierar en kund. Reguljärt uttrycksmönster: `^[a-zA-Z\d-_]{1,128}$`
api-version	query	True	string	Den version av API:et som ska användas med klientbegäran. Den aktuella versionen är 2024-04-01.

Begärandetext

Name	Obligatorisk	Typ	Description
roleDefinitionId	True	string	ID för rolldefinitionen.
principalId		string	Objekt-ID för den användare som rollen tilldelades till.
principalPuid		string	Huvud-PUID för den användare som rollen tilldelades till.
principalTenantId		string	Huvudklient-ID:t för den användare som rollen tilldelades till.
scope		string	Det omfång som rollen tilldelades till.
userAuthenticationType		string	Autentiseringstypen för användaren, oavsett om det är Organisation eller MSA, för den användare som rollen tilldelades till. Detta stöds endast för faktureringskonton med avtalstyp Enterprise-avtal.
userEmailAddress		string	E-postadressen till den användare som rollen tilldelades till. Detta stöds endast för faktureringskonton med avtalstyp Enterprise-avtal.

Svar

Name	Typ	Description
200 OK	BillingRoleAssignment	Egenskaperna för tilldelningen av faktureringsrollen.
202 Accepted		Egenskaperna för tilldelningen av faktureringsrollen. Sidhuvuden Location: string Retry-After: integer
Other Status Codes	ErrorResponse	Felsvar som beskriver varför åtgärden misslyckades.

Name

Typ

Description

200 OK

BillingRoleAssignment

Egenskaperna för tilldelningen av faktureringsrollen.

202 Accepted

Egenskaperna för tilldelningen av faktureringsrollen.

Sidhuvuden

Location: string
Retry-After: integer

Other Status Codes

ErrorResponse

Felsvar som beskriver varför åtgärden misslyckades.

Exempel

BillingRoleAssignmentCreateByCustomer

Exempelbegäran

HTTP

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/customers/703ab484-dda2-4402-827b-a74513b61e2d/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/billingProfileName/BKM6-54VH-BG7-PGB/customers/703ab484-dda2-4402-827b-a74513b61e2d/billingRoleDefinitions/30000000-aaaa-bbbb-cccc-100000000000",
  "userEmailAddress": "john@contoso.com"
}

Exempelsvar

Statuskod:: 200

{
  "id": "/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2018-09-30/billingProfileName/BKM6-54VH-BG7-PGB/customers/703ab484-dda2-4402-827b-a74513b61e2d/billingRoleAssignments/30000000-aaaa-bbbb-cccc-100000000000_00000000-0000-0000-0000-000000000000",
  "name": "30000000-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/billingProfileName/BKM6-54VH-BG7-PGB/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/billingProfileName/BKM6-54VH-BG7-PGB/customers/703ab484-dda2-4402-827b-a74513b61e2d",
    "principalType": "User"
  },
  "type": "Microsoft.Billing/billingAccounts/billingProfiles/customers/billingRoleAssignments"
}

Statuskod:: 202

location: https://management.azure.com/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000:00000000-0000-0000-0000-000000000000_2018-09-30/customers/703ab484-dda2-4402-827b-a74513b61e2d/operationResults/createBillingRoleAssignment_30000000-aaaa-bbbb-cccc-100000000000_00000000-0000-0000-0000-000000000000?api-version=2024-04-01
retry-after: 5

Definitioner

Name	Description
BillingRoleAssignment	Egenskaperna för tilldelningen av faktureringsrollen.
BillingRoleAssignmentProperties	Egenskaperna för tilldelningen av faktureringsrollen.
createdByType	Den typ av identitet som skapade resursen.
ErrorAdditionalInfo	Ytterligare information om resurshanteringsfelet.
ErrorDetail	Felinformationen.
ErrorResponse	Felsvar
PrincipalType	Typ av rolltilldelning.
ProvisioningState	Resursens etableringstillstånd under en långvarig åtgärd.
systemData	Metadata som rör skapande och senaste ändring av resursen.

BillingRoleAssignment

Egenskaperna för tilldelningen av faktureringsrollen.

Name	Typ	Description
id	string	Fullständigt kvalificerat resurs-ID för resursen. Till exempel "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	Namnet på resursen
properties	BillingRoleAssignmentProperties	Egenskaperna för tilldelningen av faktureringsrollen.
systemData	systemData	Azure Resource Manager-metadata som innehåller createdBy och modifiedBy information.
tags	object	Ordlista med metadata som är associerade med resursen. Den kanske inte fylls i för alla resurstyper. Maximal nyckel/värdelängd som stöds på 256 tecken. Nycklar/värde får inte vara tomt eller null. Nycklar kan inte innehålla <> % & \ ? /
type	string	Resurstypen. Till exempel "Microsoft.Compute/virtualMachines" eller "Microsoft.Storage/storageAccounts"

BillingRoleAssignmentProperties

Egenskaperna för tilldelningen av faktureringsrollen.

Name	Typ	Description
billingAccountDisplayName	string	Namnet på faktureringskontot.
billingAccountId	string	Det fullständigt kvalificerade ID som unikt identifierar ett faktureringskonto.
billingProfileDisplayName	string	Namnet på faktureringsprofilen.
billingProfileId	string	Det fullständigt kvalificerade ID som unikt identifierar en faktureringsprofil.
billingRequestId	string	ID för faktureringsbegäran som skapades för rolltilldelningen. Detta gäller endast för rolltilldelningar mellan klientorganisationer eller rolltilldelningar som skapats via faktureringsbegäran.
createdByPrincipalId	string	Objekt-ID för användaren som skapade rolltilldelningen.
createdByPrincipalPuid	string	Huvud-PUID för den användare som skapade rolltilldelningen.
createdByPrincipalTenantId	string	Klientorganisations-ID:t för den användare som skapade rolltilldelningen.
createdByUserEmailAddress	string	E-postadressen till den användare som skapade rolltilldelningen. Detta stöds endast för faktureringskonton med avtalstyp Enterprise-avtal.
createdOn	string	Det datum då rolltilldelningen skapades.
customerDisplayName	string	Kundens namn.
customerId	string	Det fullständigt kvalificerade ID som unikt identifierar en kund.
invoiceSectionDisplayName	string	Namnet på fakturaavsnittet.
invoiceSectionId	string	Det fullständigt kvalificerade ID som unikt identifierar ett fakturaavsnitt.
modifiedByPrincipalId	string	Huvud-PUID för den användare som ändrade rolltilldelningen.
modifiedByPrincipalPuid	string	Huvud-PUID för den användare som ändrade rolltilldelningen.
modifiedByPrincipalTenantId	string	Klientorganisations-ID:t för den användare som ändrade rolltilldelningen.
modifiedByUserEmailAddress	string	E-postadressen till den användare som ändrade rolltilldelningen. Detta stöds endast för faktureringskonton med avtalstyp Enterprise-avtal.
modifiedOn	string	Datumet då rolltilldelningen ändrades.
principalDisplayName	string	Visningsnamnet för det huvudnamn som rollen tilldelades till.
principalId	string	Objekt-ID för den användare som rollen tilldelades till.
principalPuid	string	Huvud-PUID för den användare som rollen tilldelades till.
principalTenantId	string	Huvudklient-ID:t för den användare som rollen tilldelades till.
principalTenantName	string	Det egna namnet på klientorganisationen för den användare som rollen tilldelades till. Detta blir "Primär klientorganisation" för den primära klientorganisationen för faktureringskontot.
principalType	PrincipalType	Typ av rolltilldelning.
provisioningState	ProvisioningState	Resursens etableringstillstånd under en långvarig åtgärd.
roleDefinitionId	string	ID för rolldefinitionen.
scope	string	Det omfång som rollen tilldelades till.
userAuthenticationType	string	Autentiseringstypen för användaren, oavsett om det är Organisation eller MSA, för den användare som rollen tilldelades till. Detta stöds endast för faktureringskonton med avtalstyp Enterprise-avtal.
userEmailAddress	string	E-postadressen till den användare som rollen tilldelades till. Detta stöds endast för faktureringskonton med avtalstyp Enterprise-avtal.

createdByType

Den typ av identitet som skapade resursen.

Name	Typ	Description
Application	string
Key	string
ManagedIdentity	string
User	string

ErrorAdditionalInfo

Ytterligare information om resurshanteringsfelet.

Name	Typ	Description
info	object	Ytterligare information.
type	string	Ytterligare informationstyp.

ErrorDetail

Felinformationen.

Name	Typ	Description
additionalInfo	ErrorAdditionalInfo[]	Ytterligare information om felet.
code	string	Felkoden.
details	ErrorDetail[]	Felinformationen.
message	string	Felmeddelandet.
target	string	Felmålet.

ErrorResponse

Felsvar

Name	Typ	Description
error	ErrorDetail	Felobjektet.

PrincipalType

Typ av rolltilldelning.

Name	Typ	Description
DirectoryRole	string
Everyone	string
Group	string
None	string
ServicePrincipal	string
Unknown	string
User	string

ProvisioningState

Resursens etableringstillstånd under en långvarig åtgärd.

Name	Typ	Description
Canceled	string
Failed	string
New	string
Pending	string
Provisioning	string
Succeeded	string

systemData

Metadata som rör skapande och senaste ändring av resursen.

Name	Typ	Description
createdAt	string	Tidsstämpeln för resursskapande (UTC).
createdBy	string	Identiteten som skapade resursen.
createdByType	createdByType	Den typ av identitet som skapade resursen.
lastModifiedAt	string	Tidsstämpeln för resursens senaste ändring (UTC)
lastModifiedBy	string	Identiteten som senast ändrade resursen.
lastModifiedByType	createdByType	Den typ av identitet som senast ändrade resursen.

Dela via

Billing Role Assignments - Create By Customer

URI-parametrar

Begärandetext

Svar

Exempel

BillingRoleAssignmentCreateByCustomer

Exempelbegäran

Exempelsvar

Definitioner

BillingRoleAssignment

BillingRoleAssignmentProperties

createdByType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

PrincipalType

ProvisioningState

systemData

Ytterligare resurser