Billing Role Assignments - List By Invoice Section
Çağıranın rol atamalarını bir fatura bölümünde listeler. İşlem, Microsoft Müşteri Sözleşmesi sözleşme türüne sahip ödeme hesapları için desteklenir.
GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/invoiceSections/{invoiceSectionName}/billingRoleAssignments?api-version=2024-04-01
GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/invoiceSections/{invoiceSectionName}/billingRoleAssignments?api-version=2024-04-01&filter={filter}&top={top}&skip={skip}
URI Parametreleri
Name | İçinde | Gerekli | Tür | Description |
---|---|---|---|---|
billing
|
path | True |
string |
Bir ödeme hesabını benzersiz olarak tanımlayan kimlik. Normal ifade deseni: |
billing
|
path | True |
string |
Faturalama profilini benzersiz olarak tanımlayan kimlik. Normal ifade deseni: |
invoice
|
path | True |
string |
Bir fatura bölümünü benzersiz olarak tanımlayan kimlik. Normal ifade deseni: |
api-version
|
query | True |
string |
İstemci isteğiyle kullanılacak API sürümü. Geçerli sürüm 2024-04-01'dir. |
filter
|
query |
string |
Sorguyu filtrele seçeneği, istemcilerin istek URL'si tarafından ele alınan bir kaynak koleksiyonunu filtrelemesine olanak tanır. |
|
skip
|
query |
integer int64 |
Sorgu atla seçeneği sorgulanan koleksiyonda atlanacak ve sonube dahil edilmeyecek öğe sayısını istemektedir. |
|
top
|
query |
integer int64 |
En üstteki sorgu seçeneği sorgulanan koleksiyondaki öğelerin sayısının sonube eklenmesini istemektedir. En üst için desteklenen en yüksek değer 50'dir. |
Yanıtlar
Name | Tür | Description |
---|---|---|
200 OK |
Faturalama rolü atamalarının listesi. |
|
Other Status Codes |
İşlemin neden başarısız olduğunu açıklayan hata yanıtı. |
Örnekler
BillingRoleAssignmentListByInvoiceSection
Örnek isteği
GET 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/billingRoleAssignments?api-version=2024-04-01
Örnek yanıt
{
"value": [
{
"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_6fd330f6-7d26-4aff-b9cf-7bd699f965b9",
"name": "10000000-aaaa-bbbb-cccc-100000000000_6fd330f6-7d26-4aff-b9cf-7bd699f965b9",
"properties": {
"createdOn": "2023-10-19T20:10:50.1028398Z",
"createdByPrincipalTenantId": "076915e7-de10-4323-bb34-a58c904068bb",
"createdByPrincipalId": "00000000-0000-0000-0000-000000000001",
"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/30000000-aaaa-bbbb-cccc-100000000002",
"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"
},
{
"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_b1839933-b3ac-42ca-8112-d29c43f3ab47",
"name": "10000000-aaaa-bbbb-cccc-100000000000_b1839933-b3ac-42ca-8112-d29c43f3ab47",
"properties": {
"createdOn": "2023-10-19T20:10:50.1028398Z",
"createdByPrincipalTenantId": "076915e7-de10-4323-bb34-a58c904068bb",
"createdByPrincipalId": "00000000-0000-0000-0000-000000000001",
"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/30000000-aaaa-bbbb-cccc-100000000001",
"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"
}
]
}
Tanımlar
Name | Description |
---|---|
Billing |
Faturalama rolü atamasının özellikleri. |
Billing |
Kaynak listesi için kapsayıcı |
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 |
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" |
BillingRoleAssignmentListResult
Kaynak listesi için kapsayıcı
Name | Tür | Description |
---|---|---|
nextLink |
string |
Sonuçların sonraki sayfasına bağlantı (URL). |
value |
Kaynak listesi. |
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 |
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 |
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 |
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ü.
Name | Tür | Description |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
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ü.
Name | Tür | Description |
---|---|---|
DirectoryRole |
string |
|
Everyone |
string |
|
Group |
string |
|
None |
string |
|
ServicePrincipal |
string |
|
Unknown |
string |
|
User |
string |
ProvisioningState
Uzun süre çalışan bir işlem sırasında kaynağın sağlama durumu.
Name | Tür | Description |
---|---|---|
Canceled |
string |
|
Failed |
string |
|
New |
string |
|
Pending |
string |
|
Provisioning |
string |
|
Succeeded |
string |
systemData
Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.
Name | Tür | Description |
---|---|---|
createdAt |
string |
Kaynak oluşturma (UTC) zaman damgası. |
createdBy |
string |
Kaynağı oluşturan kimlik. |
createdByType |
Kaynağı oluşturan kimliğin türü. |
|
lastModifiedAt |
string |
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ü. |