Tüm Azure kullanım analizi bilgilerini alma

  • Makale
  • Okumak için 2 dakika

Uygulama hedefi: Iş Ortağı Merkezi | 21Vianet tarafından işletilen iş ortağı Merkezi | Microsoft Bulut Almanya için iş ortağı Merkezi | Microsoft Cloud for US Government için iş ortağı Merkezi

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

Önkoşullar

REST isteği

İstek sözdizimi

Yöntem İstek URI'si
AL {BaseUrl}/partner/v1/analiz Tics/Usage/Azure http/1.1

URI parametreleri

Parametre Tür Description
top string İstekte döndürülecek veri satır sayısı. Belirtilen en büyük değer ve varsayılan değer 10000 ' dir. Sorguda daha fazla satır varsa, yanıt gövdesi sonraki veri sayfasını istemek için kullanabileceğiniz bir sonraki bağlantıyı içerir.
Atla int Sorgudaki atlanacak satır sayısı. Büyük veri kümeleri üzerinden sayfa eklemek 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 ve bu şekilde devam eder.
filtre string İsteğin filtre parametresi, yanıttaki satırları filtreleyen bir veya daha fazla deyim içeriyor. Her deyim, veya işleçleriyle ilişkili bir alan ve değer içerir eqne ve deyimler or kullanılarak birleştirilebilir andor . Aşağıdaki dizeleri belirtebilirsiniz:

customerTenantId
customerName
subscriptionId
subscriptionName
usageDate
resourceLocation
meterCategory
meterSubcategory
meterUnit
reservationOrderId
reservationId
consumptionMeterId
serviceType

Ö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 Toplam verilerinin alınacağı zaman aralığını belirtir. Aşağıdaki dizelerden biri olabilir: day , week , veya month . Belirtilmemişse, varsayılan olur day .

aggregationLevelParametresi, olmadan desteklenmez groupby . aggregationLevelParametresi, içinde bulunan tüm tarih alanları için geçerlidir groupby .
OrderBy string Her bir yüklemenin sonuç verileri değerlerini sıralayan bir ifade. Söz dizimi ...&orderby=field [order],field [order],... şeklindedir. fieldParametresi aşağıdaki dizelerden biri olabilir:

customerTenantId
customerName
subscriptionId
subscriptionName
usageDate
resourceLocation
meterCategory
meterSubcategory
meterUnit
reservationOrderId
reservationId
consumptionMeterId
serviceType

Order parametresi isteğe bağlıdır ve desc sırasıyla her bir alan için artan veya azalan sıralama belirtmek için ya da olabilir. Varsayılan değer: asc.

Örnek:
...&orderby=meterCategory,meterUnit
ölçütü string Yalnızca belirtilen alanlara veri toplamayı uygulayan bir ifade. Aşağıdaki alanları belirtebilirsiniz:

customerTenantId
customerName
subscriptionId
subscriptionName
usageDate
resourceLocation
meterCategory
meterSubcategory
meterUnit
reservationOrderId
reservationId
consumptionMeterId
serviceType

Döndürülen veri satırları, parametresinde belirtilen alanları groupby ve groupbyiçerir.

groupbyParametresi parametresiyle birlikte kullanılabilir aggregationLevel .

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

İstek üst bilgileri

Daha fazla bilgi için bkz. Iş ortağı MERKEZI Rest üstbilgileri.

İ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ı veya başarısızlık ve ek hata ayıklama bilgilerini gösteren bir HTTP durum kodu ile 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": "EC649980-D623-49F5-B7C1-80CC772B83A8",
  "subscriptionName": "AZURE PURCHSE SAMPLE APP",
  "usageDate": "2018-05-27T00:00:00",
  "resourceLocation": "useast",
  "meterCategory": "Data Management",
  "meterSubcategory": "None",
  "meterUnit": "10,000s",
  "reservationOrderId": "",
  "reservationId": "",
  "consumptionMeterId": "",
  "serviceType": "",
  "quantity": 20
}

Ayrıca bkz.