Billing Role Assignments - List By Invoice Section

Layanan:: Billing

Versi API:: 2024-04-01

Mencantumkan penetapan peran untuk pemanggil di bagian faktur. Operasi ini didukung untuk akun penagihan dengan jenis perjanjian Perjanjian Pelanggan Microsoft.

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/invoiceSections/{invoiceSectionName}/billingRoleAssignments?api-version=2024-04-01

Dengan parameter opsional:

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}

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
billingAccountName	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})?)$	ID yang secara unik mengidentifikasi akun penagihan.
billingProfileName	path	True	string pattern: ^[a-zA-Z\d-_]{1,128}$	ID yang secara unik mengidentifikasi profil penagihan.
invoiceSectionName	path	True	string pattern: ^[a-zA-Z\d-_]{1,128}$	ID yang secara unik mengidentifikasi bagian faktur.
api-version	query	True	string minLength: 1	Versi API yang digunakan untuk operasi ini.
filter	query		string	Opsi kueri filter memungkinkan klien memfilter kumpulan sumber daya yang ditangani oleh URL permintaan.
skip	query		integer (int64)	Opsi lewati kueri meminta jumlah item dalam koleksi yang dikueri yang akan dilewati dan tidak disertakan dalam hasilnya.
top	query		integer (int64)	Opsi kueri teratas meminta jumlah item dalam koleksi yang dikueri untuk disertakan dalam hasilnya. Nilai maksimum yang didukung untuk yang teratas adalah 50.

Respons

Nama	Jenis	Deskripsi
200 OK	BillingRoleAssignmentListResult	Operasi Azure berhasil diselesaikan.
Other Status Codes	ErrorResponse	Respons kesalahan tak terduga.

Keamanan

azure_auth

Alur OAuth2 Azure Active Directory.

Jenis: oauth2
Alur: implicit
URL Otorisasi: https://login.microsoftonline.com/common/oauth2/authorize

Cakupan

Nama	Deskripsi
user_impersonation	meniru akun pengguna Anda

Contoh

BillingRoleAssignmentListByInvoiceSection

Permintaan sampel

HTTP

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

Respon sampel

Kode status:: 200

{
  "value": [
    {
      "name": "10000000-aaaa-bbbb-cccc-100000000000_6fd330f6-7d26-4aff-b9cf-7bd699f965b9",
      "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_6fd330f6-7d26-4aff-b9cf-7bd699f965b9",
      "properties": {
        "createdByPrincipalId": "00000000-0000-0000-0000-000000000001",
        "createdByPrincipalTenantId": "076915e7-de10-4323-bb34-a58c904068bb",
        "createdOn": "2023-10-19T20:10:50.1028398Z",
        "principalId": "00000000-0000-0000-0000-000000000000",
        "principalType": "User",
        "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"
      }
    },
    {
      "name": "10000000-aaaa-bbbb-cccc-100000000000_b1839933-b3ac-42ca-8112-d29c43f3ab47",
      "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",
      "properties": {
        "createdByPrincipalId": "00000000-0000-0000-0000-000000000001",
        "createdByPrincipalTenantId": "076915e7-de10-4323-bb34-a58c904068bb",
        "createdOn": "2023-10-19T20:10:50.1028398Z",
        "principalId": "00000000-0000-0000-0000-000000000000",
        "principalType": "User",
        "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"
      }
    }
  ]
}

Definisi

Nama	Deskripsi
BillingRoleAssignment	Properti penetapan peran penagihan.
BillingRoleAssignmentListResult	Kumpulan halaman item BillingRoleAssignment
BillingRoleAssignmentProperties	Properti penetapan peran penagihan.
createdByType	Jenis identitas yang membuat sumber daya.
ErrorAdditionalInfo	Info tambahan kesalahan manajemen sumber daya.
ErrorDetail	Detail kesalahan.
ErrorResponse	Respons kesalahan
PrincipalType	Jenis penetapan peran.
ProvisioningState	Status provisi sumber daya selama operasi jangka panjang.
systemData	Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.

BillingRoleAssignment

Objek

Properti penetapan peran penagihan.

Nama	Jenis	Deskripsi
id	string (arm-id)	ID sumber daya yang sepenuhnya memenuhi syarat untuk sumber daya. Misalnya "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	Nama sumber daya
properties	BillingRoleAssignmentProperties	Properti penetapan peran penagihan.
systemData	systemData	Metadata Azure Resource Manager yang berisi informasi createBy dan modifiedBy.
tags	object	Kamus metadata yang terkait dengan sumber daya. Ini mungkin tidak diisi untuk semua jenis sumber daya. Panjang kunci/nilai maksimum yang didukung 256 karakter. Kunci/nilai tidak boleh kosong nilai atau null. Kunci tidak dapat berisi <> % & \ ? /
type	string	Jenis sumber daya. Misalnya, "Microsoft.Compute/virtualMachines" atau "Microsoft.Storage/storageAccounts"

BillingRoleAssignmentListResult

Objek

Kumpulan halaman item BillingRoleAssignment

Nama	Jenis	Deskripsi
nextLink	string (uri)	Tautan ke halaman item berikutnya
value	BillingRoleAssignment[]	Item BillingRoleAssignment di halaman ini

BillingRoleAssignmentProperties

Objek

Properti penetapan peran penagihan.

Nama	Jenis	Deskripsi
billingAccountDisplayName	string	Nama akun penagihan.
billingAccountId	string	ID yang sepenuhnya memenuhi syarat yang secara unik mengidentifikasi akun penagihan.
billingProfileDisplayName	string	Nama profil penagihan.
billingProfileId	string	ID yang sepenuhnya memenuhi syarat yang secara unik mengidentifikasi profil penagihan.
billingRequestId	string	ID permintaan penagihan yang dibuat untuk penetapan peran. Ini hanya berlaku untuk penetapan peran lintas penyewa atau penetapan peran yang dibuat melalui permintaan penagihan.
createdByPrincipalId	string	ID objek pengguna yang membuat penetapan peran.
createdByPrincipalPuid	string	PUID utama pengguna yang membuat penetapan peran.
createdByPrincipalTenantId	string	Id penyewa pengguna yang membuat penetapan peran.
createdByUserEmailAddress	string	Alamat email pengguna yang membuat penetapan peran. Ini hanya didukung untuk akun penagihan dengan jenis perjanjian Perjanjian Enterprise.
createdOn	string (date-time)	Tanggal penetapan peran dibuat.
customerDisplayName	string	Nama pelanggan.
customerId	string	ID yang sepenuhnya memenuhi syarat yang secara unik mengidentifikasi pelanggan.
invoiceSectionDisplayName	string	Nama bagian faktur.
invoiceSectionId	string	ID yang sepenuhnya memenuhi syarat yang secara unik mengidentifikasi bagian faktur.
modifiedByPrincipalId	string	PUID utama pengguna yang memodifikasi penetapan peran.
modifiedByPrincipalPuid	string	PUID utama pengguna yang memodifikasi penetapan peran.
modifiedByPrincipalTenantId	string	Id penyewa pengguna yang memodifikasi penetapan peran.
modifiedByUserEmailAddress	string	Alamat email pengguna yang memodifikasi penetapan peran. Ini hanya didukung untuk akun penagihan dengan jenis perjanjian Perjanjian Enterprise.
modifiedOn	string (date-time)	Tanggal penetapan peran dimodifikasi.
principalDisplayName	string	Nama tampilan prinsipal yang perannya ditetapkan.
principalId	string	Id objek pengguna yang perannya ditetapkan.
principalPuid	string	PUID utama pengguna yang perannya ditetapkan.
principalTenantId	string	Id penyewa utama pengguna yang perannya ditetapkan.
principalTenantName	string	Nama yang mudah diingat dari penyewa pengguna yang perannya ditetapkan. Ini akan menjadi 'Penyewa Utama' untuk penyewa utama akun penagihan.
principalType	PrincipalType	Jenis penetapan peran.
provisioningState	ProvisioningState	Status provisi sumber daya selama operasi jangka panjang.
roleDefinitionId	string minLength: 1	ID definisi peran.
scope	string	Cakupan tempat peran ditetapkan.
userAuthenticationType	string	Jenis autentikasi pengguna, baik Organisasi atau MSA, dari pengguna yang perannya ditetapkan. Ini hanya didukung untuk akun penagihan dengan jenis perjanjian Perjanjian Enterprise.
userEmailAddress	string	Alamat email pengguna yang perannya ditetapkan. Ini hanya didukung untuk akun penagihan dengan jenis perjanjian Perjanjian Enterprise.

createdByType

Enumerasi

Jenis identitas yang membuat sumber daya.

Nilai	Deskripsi
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Objek

Info tambahan kesalahan manajemen sumber daya.

Nama	Jenis	Deskripsi
info	object	Info tambahan.
type	string	Jenis info tambahan.

ErrorDetail

Objek

Detail kesalahan.

Nama	Jenis	Deskripsi
additionalInfo	ErrorAdditionalInfo[]	Info tambahan kesalahan.
code	string	Kode kesalahan.
details	ErrorDetail[]	Detail kesalahan.
message	string	Pesan kesalahan.
target	string	Target kesalahan.

ErrorResponse

Objek

Respons kesalahan

Nama	Jenis	Deskripsi
error	ErrorDetail	Objek kesalahan.

PrincipalType

Enumerasi

Jenis penetapan peran.

Nilai	Deskripsi
Unknown	Unknown
None	Tidak
User	Pengguna
Group	Kelompok
DirectoryRole	Peran Direktori
ServicePrincipal	ServicePrincipal
Everyone	Semua orang

ProvisioningState

Enumerasi

Status provisi sumber daya selama operasi jangka panjang.

Nilai	Deskripsi
Succeeded	Berhasil
Canceled	Dibatalkan
Failed	Kegagalan
New	Baru
Pending	Pending
Provisioning	Provisioning
PendingBilling	Penagihan Tertunda
ConfirmedBilling	Penagihan yang Dikonfirmasi
Creating	Membuat
Created	Telah dibuat
Expired	Kedaluwarsa

systemData

Objek

Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.

Nama	Jenis	Deskripsi
createdAt	string (date-time)	Tanda waktu pembuatan sumber daya (UTC).
createdBy	string	Identitas yang membuat sumber daya.
createdByType	createdByType	Jenis identitas yang membuat sumber daya.
lastModifiedAt	string (date-time)	Tanda waktu modifikasi terakhir sumber daya (UTC)
lastModifiedBy	string	Identitas yang terakhir mengubah sumber daya.
lastModifiedByType	createdByType	Jenis identitas yang terakhir memodifikasi sumber daya.

Bagikan melalui

Billing Role Assignments - List By Invoice Section

Parameter URI

Respons

Keamanan

azure_auth

Cakupan

Contoh

BillingRoleAssignmentListByInvoiceSection

Permintaan sampel

Respon sampel

Definisi

BillingRoleAssignment

BillingRoleAssignmentListResult

BillingRoleAssignmentProperties

createdByType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

PrincipalType

ProvisioningState

systemData