Aracılığıyla paylaş

Tüm Azure kullanım analizi bilgilerini alma

  • Makale

Şunlar için geçerlidir: İş Ortağı Merkezi | 21Vianet tarafından sağlanan İş Ortağı Merkezi | Microsoft Cloud for US Government için İş Ortağı Merkezi

Müşterileriniz için tüm Azure kullanım analizi bilgilerini alma.

Önkoşullar

REST isteği

İstek söz dizimi

Yöntem İstek URI'si
GET {baseURL}/partner/v1/analytics/usage/azure HTTP/1.1

URI parametreleri

Parametre Tür Description
top string İstekte döndürülecek veri satırlarının sayısı. En büyük değer ve belirtilmezse varsayılan değer 10000'dir. Sorguda daha fazla satır varsa, yanıt gövdesi bir sonraki veri sayfasını istemek için kullanabileceğiniz bir sonraki bağlantıyı içerir.
Atla int Sorguda atlana satır sayısı. Büyük veri kümelerini sayfalandırmak için bu parametreyi kullanın. Örneğin, top=10000 and skip=0 ilk 10000 veri satırını alır, top=10000 and skip=10000 sonraki 10000 veri satırını alır, vb.
filtre string İsteğin filter parametresi, yanıttaki satırları filtreleyen bir veya daha fazla deyim içerir. Her deyim, veya işleçleriyle eq ilişkili bir alan ve değer içerir ve deyimler veya orkullanılarak and birleştirilebilir.ne Aşağıdaki dizeleri belirtebilirsiniz:

customerTenantId
customerName
subscriptionId
subscriptionName
usageDate
resourceLocation
meterCategory
meterSubcategory
meterUnit


Örnek:
.../usage/azure?filter=meterCategory eq 'Data Management'

Örnek:
.../usage/azure?filter=meterCategory eq 'Data Management' or (usageDate le cast('2018-01-01', Edm.DateTimeOffset) and usageDate le cast('2018-04-01', Edm.DateTimeOffset))
aggregationLevel string Toplama verilerinin alındığı zaman aralığını belirtir. Şu dizelerden biri olabilir: day, week, veya month. Belirtilmemişse, varsayılan değer olur day.

aggregationLevel parametresi olmadan groupbydesteklenmez. parametresi içinde aggregationLevel bulunan groupbytüm tarih alanlarına uygulanır.
Orderby string Her yükleme için sonuç veri değerlerini sıralayan bir deyim. Söz dizimi ...&orderby=field [order],field [order],... şeklindedir. field parametresi aşağıdaki dizelerden biri olabilir:

customerTenantId
customerName
subscriptionId
subscriptionName
usageDate
resourceLocation
meterCategory
meterSubcategory
meterUnit


Order parametresi isteğe bağlıdır ve her alan için sırasıyla artan veya azalan düzen belirtilebilir ascdesc. Varsayılan değer: asc.

Örnek:
...&orderby=meterCategory,meterUnit
Groupby string Veri toplamayı yalnızca belirtilen alanlara uygulayan bir deyim. Aşağıdaki alanları belirtebilirsiniz:

customerTenantId
customerName
subscriptionId
subscriptionName
usageDate
resourceLocation
meterCategory
meterSubcategory
meterUnit


Döndürülen veri satırları, parametresinde ve Quantity'dagroupby belirtilen alanları içerir.

groupby parametresi parametresiyle aggregationLevel birlikte kullanılabilir.

Örnek:
...&groupby=meterCategory,meterUnit

İstek üst bilgileri

Daha fazla bilgi için bkz . İş Ortağı Merkezi REST üst bilgileri.

İstek gövdesi

Yok.

İstek örneği

GET https://api.partnercenter.microsoft.com/partner/v1/analytics/usage/azure HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
Content-Type: application/json
Content-Length: 0

REST yanıtı

Başarılı olursa, yanıt gövdesi bir Azure kullanım kaynakları koleksiyonu içerir.

Yanıt başarısı ve hata kodları

Her yanıt, başarıyı veya başarısızlığı ve ek hata ayıklama bilgilerini gösteren bir HTTP durum koduyla birlikte gelir. Bu kodu, hata türünü ve ek parametreleri okumak için bir ağ izleme aracı kullanın. Tam liste için bkz. Hata Kodları.

Yanıt örneği

{
  "customerTenantId": "39A1DFAC-4969-4F31-AF94-D76588189CFE",
  "customerName": "A",
  "subscriptionId": "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
  "subscriptionName": "AZURE PURCHSE SAMPLE APP",
  "usageDate": "2018-05-27T00:00:00",
  "resourceLocation": "useast",
  "meterCategory": "Data Management",
  "meterSubcategory": "None",
  "meterUnit": "10,000s",
  "quantity": 20
}

Ayrıca bkz.