Dela via

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.

Exempel

BillingRoleAssignmentCreateByCustomer

Exempelbegäran

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.