Bagikan melalui

Manage billing - Get a customer's utilization records for Azure

  • Referensi
Service:
Partner Center Rest
API Version:
v1

Mendapatkan pemanfaatan untuk sumber daya milik langganan Azure yang dimiliki oleh pelanggan mitra.

GET https://api.partnercenter.microsoft.com/v1/customers/{customer_id}/subscriptions/{subscription_id}/utilizations/azure
With optional parameters: 
GET https://api.partnercenter.microsoft.com/v1/customers/{customer_id}/subscriptions/{subscription_id}/utilizations/azure?start_time={start_time}&end_time={end_time}&size={size}&granularity={granularity}&show_details={show_details}&seek_operation={seek_operation}

Parameter URI

Nama Dalam Diperlukan Jenis Deskripsi
customer_id
 path True

string

Id pelanggan yang memiliki langganan.
subscription_id
 path True

string

Id langganan Azure untuk mengambil pemanfaatannya.
end_time
 query

string

date-time

Waktu akhir ketika pemanfaatan diukur dalam sistem penagihan.
granularity
 query

string

Granularitas waktu penggunaan sumber daya. Bisa setiap hari atau per jam. Defalt adalah setiap hari.
seek_operation
 query

string

Operasi pencarian untuk dilakukan. Hanya Berikutnya yang didukung.
show_details
 query

boolean

Jika diatur ke true, rekaman pemanfaatan akan dibagi berdasarkan tingkat instans sumber daya. Jika diatur ke false, rekaman pemanfaatan akan diagregasi pada tingkat sumber daya. Defaultnya adalah true.
size
 query

integer

int32

Jumlah maksimum opsional rekaman yang akan dikembalikan. Defaultnya adalah 1000. Koleksi sumber daya yang dikembalikan akan menentukan tautan berikutnya jika ada lebih banyak catatan pemanfaatan yang tersedia.
start_time
 query

string

date-time

Waktu mulai ketika pemanfaatan diukur dalam sistem penagihan.

Header Permintaan

Nama Diperlukan Jenis Deskripsi
Authorization True

string

Token Pembawa Otorisasi
ms-correlationid

string

Digunakan untuk melacak permintaan secara internal. Jika ms-correlationid tidak disediakan, server akan menghasilkan yang baru untuk setiap permintaan
ms-cv

string

Digunakan untuk melacak permintaan secara internal. Jika ms-cv tidak disediakan, server akan menghasilkan yang baru untuk setiap permintaan
ms-requestid

string

Digunakan untuk idempotensi permintaan. Jika ms-requestid tidak disediakan, server akan menghasilkan yang baru untuk setiap permintaan

Respons

Nama Jenis Deskripsi
200 OK

Collections.ResourceCollection[Utilizations.AzureUtilizationRecord]

Permintaan berhasil. Isi respons berisi pengumpulan sumber daya rekaman pemanfaatan Azure.

Media Types: "application/json", "text/json", "application/xml", "text/xml"
204 No Content

Collections.ResourceCollection[Utilizations.AzureUtilizationRecord]

Data tidak tersedia untuk waktu mulai dan berakhir yang diberikan. Tidak ada konten yang dikembalikan dengan header coba lagi setelah.

Media Types: "application/json", "text/json", "application/xml", "text/xml"
400 Bad Request

Ada input yang hilang atau tidak valid. Isi respons akan memberikan detail kesalahan.

Media Types: "application/json", "text/json", "application/xml", "text/xml"
401 Unauthorized

Permintaan tidak diautentikasi. Klien perlu mengautentikasi dengan layanan API mitra terlebih dahulu.

Media Types: "application/json", "text/json", "application/xml", "text/xml"
403 Forbidden

Permintaan diautentikasi tetapi ditolak karena pemanggil tidak memiliki hak untuk memanggilnya.

Media Types: "application/json", "text/json", "application/xml", "text/xml"
404 Not Found

Sumber daya tidak ditemukan atau tidak tersedia dengan parameter input yang diberikan.

Media Types: "application/json", "text/json", "application/xml", "text/xml"
500 Internal Server Error

Layanan API mitra atau salah satu dependensinya gagal memenuhi permintaan. Penelepon dapat mencoba kembali ini.

Media Types: "application/json", "text/json", "application/xml", "text/xml"

Definisi

Nama Deskripsi
Collections.ResourceCollection[Utilizations.AzureUtilizationRecord]
Link
ResourceAttributes
ResourceLinks
System.Collections.Generic.KeyValuePair[System.String,System.String]
Utilizations.AzureInstanceData
Utilizations.AzureResource
Utilizations.AzureUtilizationRecord

Collections.ResourceCollection[Utilizations.AzureUtilizationRecord]

Nama Jenis Deskripsi
attributes

ResourceAttributes

items

Utilizations.AzureUtilizationRecord[]

links

ResourceLinks

totalCount

integer

Nama Jenis Deskripsi
headers

System.Collections.Generic.KeyValuePair[System.String,System.String][]

method

string

uri

string

ResourceAttributes

Nama Jenis Deskripsi
etag

string

objectType

string

Nama Jenis Deskripsi
next

Link

previous

Link

self

Link

System.Collections.Generic.KeyValuePair[System.String,System.String]

Nama Jenis Deskripsi
key

string

value

string

Utilizations.AzureInstanceData

Nama Jenis Deskripsi
additionalInfo

object

location

string

orderNumber

string

partNumber

string

resourceUri

string

tags

object

Utilizations.AzureResource

Nama Jenis Deskripsi
category

string

id

string

name

string

region

string

subcategory

string

Utilizations.AzureUtilizationRecord

Nama Jenis Deskripsi
attributes

ResourceAttributes

infoFields

object

instanceData

Utilizations.AzureInstanceData

quantity

number

resource

Utilizations.AzureResource

unit

string

usageEndTime

string

usageStartTime

string