Billing Role Assignments - Create By Invoice Section
Fatura bölümüne rol ataması ekler. İşlem, Microsoft Müşteri Sözleşmesi sözleşme türüne sahip ödeme hesapları için desteklenir.
POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/invoiceSections/{invoiceSectionName}/createBillingRoleAssignment?api-version=2024-04-01
URI Parametreleri
Name | İçinde | Gerekli | Tür | Description |
---|---|---|---|---|
billing
|
path | True |
string pattern: ^([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})?)$ |
Bir ödeme hesabını benzersiz olarak tanımlayan kimlik. |
billing
|
path | True |
string pattern: ^[a-zA-Z\d-_]{1,128}$ |
Faturalama profilini benzersiz olarak tanımlayan kimlik. |
invoice
|
path | True |
string pattern: ^[a-zA-Z\d-_]{1,128}$ |
Bir fatura bölümünü benzersiz olarak tanımlayan kimlik. |
api-version
|
query | True |
string |
İstemci isteğiyle kullanılacak API sürümü. Geçerli sürüm 2024-04-01'dir. |
İstek Gövdesi
Name | Gerekli | Tür | Description |
---|---|---|---|
roleDefinitionId | True |
string minLength: 1 |
Rol tanımının kimliği. |
principalId |
string |
Rolün atandığı kullanıcının nesne kimliği. |
|
principalPuid |
string |
Rolün atandığı kullanıcının asıl PUID değeri. |
|
principalTenantId |
string |
Rolün atandığı kullanıcının asıl kiracı kimliği. |
|
scope |
string |
Rolün atandığı kapsam. |
|
userAuthenticationType |
string |
Rolün atandığı kullanıcının kuruluş veya MSA kimlik doğrulama türü. Bu yalnızca anlaşma türü Kurumsal Anlaşma olan ödeme hesapları için desteklenir. |
|
userEmailAddress |
string |
Rolün atandığı kullanıcının e-posta adresi. Bu yalnızca anlaşma türü Kurumsal Anlaşma olan ödeme hesapları için desteklenir. |
Yanıtlar
Name | Tür | Description |
---|---|---|
200 OK |
Faturalama rolü atamasının özellikleri. |
|
202 Accepted |
Faturalama rolü atamasının özellikleri. Üst Bilgiler
|
|
Other Status Codes |
İşlemin neden başarısız olduğunu açıklayan hata yanıtı. |
Örnekler
BillingRoleAssignmentCreateByInvoiceSection
Örnek isteği
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"
}
Örnek yanıt
{
"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
Tanımlar
Name | Description |
---|---|
Billing |
Faturalama rolü atamasının özellikleri. |
Billing |
Faturalama rolü atamasının özellikleri. |
created |
Kaynağı oluşturan kimliğin türü. |
Error |
Kaynak yönetimi hatası ek bilgileri. |
Error |
Hata ayrıntısı. |
Error |
Hata yanıtı |
Principal |
Rol Ataması türü. |
Provisioning |
Uzun süre çalışan bir işlem sırasında kaynağın sağlama durumu. |
system |
Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler. |
BillingRoleAssignment
Faturalama rolü atamasının özellikleri.
Name | Tür | Description |
---|---|---|
id |
string (arm-id) |
Kaynağın tam kaynak kimliği. Örneğin, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
name |
string |
Kaynağın adı |
properties |
Faturalama rolü atamasının özellikleri. |
|
systemData |
createdBy ve modifiedBy bilgilerini içeren Azure Resource Manager meta verileri. |
|
tags |
object |
Kaynakla ilişkilendirilmiş meta verilerin sözlüğü. Tüm kaynak türleri için doldurulmayabilir. Desteklenen en fazla anahtar/değer uzunluğu 256 karakterdir. Anahtarlar/değer boş değer veya null olmamalıdır. Anahtarlar <> % & \ ? içeremez / |
type |
string |
Kaynağın türü. Örneğin, "Microsoft.Compute/virtualMachines" veya "Microsoft.Storage/storageAccounts" |
BillingRoleAssignmentProperties
Faturalama rolü atamasının özellikleri.
Name | Tür | Description |
---|---|---|
billingAccountDisplayName |
string |
Ödeme hesabının adı. |
billingAccountId |
string |
Bir ödeme hesabını benzersiz olarak tanımlayan tam kimlik. |
billingProfileDisplayName |
string |
Faturalama profilinin adı. |
billingProfileId |
string |
Faturalama profilini benzersiz olarak tanımlayan tam kimlik. |
billingRequestId |
string |
Rol ataması için oluşturulan faturalama isteğinin kimliği. Bu yalnızca faturalama isteği aracılığıyla oluşturulan kiracılar arası rol atamaları veya rol atamaları için geçerlidir. |
createdByPrincipalId |
string |
Rol atamasını oluşturan kullanıcının nesne kimliği. |
createdByPrincipalPuid |
string |
Rol atamasını oluşturan kullanıcının asıl PUID değeri. |
createdByPrincipalTenantId |
string |
Rol atamasını oluşturan kullanıcının kiracı kimliği. |
createdByUserEmailAddress |
string |
Rol atamasını oluşturan kullanıcının e-posta adresi. Bu yalnızca anlaşma türü Kurumsal Anlaşma olan ödeme hesapları için desteklenir. |
createdOn |
string (date-time) |
Rol atamasının oluşturulduğu tarih. |
customerDisplayName |
string |
Müşterinin adı. |
customerId |
string |
Bir müşteriyi benzersiz olarak tanımlayan tam kimlik. |
invoiceSectionDisplayName |
string |
Fatura bölümünün adı. |
invoiceSectionId |
string |
Bir fatura bölümünü benzersiz olarak tanımlayan tam kimlik. |
modifiedByPrincipalId |
string |
Rol atamasını değiştiren kullanıcının asıl PUID değeri. |
modifiedByPrincipalPuid |
string |
Rol atamasını değiştiren kullanıcının asıl PUID değeri. |
modifiedByPrincipalTenantId |
string |
Rol atamasını değiştiren kullanıcının kiracı kimliği. |
modifiedByUserEmailAddress |
string |
Rol atamasını değiştiren kullanıcının e-posta adresi. Bu yalnızca anlaşma türü Kurumsal Anlaşma olan ödeme hesapları için desteklenir. |
modifiedOn |
string (date-time) |
Rol atamasının değiştirildiği tarih. |
principalDisplayName |
string |
Rolün atandığı sorumlunun görünen adı. |
principalId |
string |
Rolün atandığı kullanıcının nesne kimliği. |
principalPuid |
string |
Rolün atandığı kullanıcının asıl PUID değeri. |
principalTenantId |
string |
Rolün atandığı kullanıcının asıl kiracı kimliği. |
principalTenantName |
string |
Rolün atandığı kullanıcının kiracısının kolay adı. Bu, ödeme hesabının birincil kiracısı için 'Birincil Kiracı' olacaktır. |
principalType |
Rol Ataması türü. |
|
provisioningState |
Uzun süre çalışan bir işlem sırasında kaynağın sağlama durumu. |
|
roleDefinitionId |
string minLength: 1 |
Rol tanımının kimliği. |
scope |
string |
Rolün atandığı kapsam. |
userAuthenticationType |
string |
Rolün atandığı kullanıcının kuruluş veya MSA kimlik doğrulama türü. Bu yalnızca anlaşma türü Kurumsal Anlaşma olan ödeme hesapları için desteklenir. |
userEmailAddress |
string |
Rolün atandığı kullanıcının e-posta adresi. Bu yalnızca anlaşma türü Kurumsal Anlaşma olan ödeme hesapları için desteklenir. |
createdByType
Kaynağı oluşturan kimliğin türü.
Değer | Description |
---|---|
Application | |
Key | |
ManagedIdentity | |
User |
ErrorAdditionalInfo
Kaynak yönetimi hatası ek bilgileri.
Name | Tür | Description |
---|---|---|
info |
object |
Ek bilgiler. |
type |
string |
Ek bilgi türü. |
ErrorDetail
Hata ayrıntısı.
Name | Tür | Description |
---|---|---|
additionalInfo |
Hata ek bilgileri. |
|
code |
string |
Hata kodu. |
details |
Hata ayrıntıları. |
|
message |
string |
Hata iletisi. |
target |
string |
Hata hedefi. |
ErrorResponse
Hata yanıtı
Name | Tür | Description |
---|---|---|
error |
Hata nesnesi. |
PrincipalType
Rol Ataması türü.
Değer | Description |
---|---|
DirectoryRole | |
Everyone | |
Group | |
None | |
ServicePrincipal | |
Unknown | |
User |
ProvisioningState
Uzun süre çalışan bir işlem sırasında kaynağın sağlama durumu.
Değer | Description |
---|---|
Canceled | |
Failed | |
New | |
Pending | |
Provisioning | |
Succeeded |
systemData
Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.
Name | Tür | Description |
---|---|---|
createdAt |
string (date-time) |
Kaynak oluşturma (UTC) zaman damgası. |
createdBy |
string |
Kaynağı oluşturan kimlik. |
createdByType |
Kaynağı oluşturan kimliğin türü. |
|
lastModifiedAt |
string (date-time) |
Kaynağın son değişikliğinin zaman damgası (UTC) |
lastModifiedBy |
string |
Kaynağı en son değiştiren kimlik. |
lastModifiedByType |
Kaynağı en son değiştiren kimlik türü. |