Aracılığıyla paylaş

Cloud for Sustainability API'si (önizleme) OData sorgu örnekleri

  • Makale

Ücretsiz deneme

Önemli

Bu işlevin bir kısmı veya tümü, önizleme sürümü kapsamında kullanılabilir. İçerik ve işlev değiştirilebilir.

Açık Veri Protokolü (OData), HTTP gibi temel protokollerde oluşturulmuş bir veri erişim protokolüdür. Web için REST gibi sık kabul edilen yöntemlerden yararlanır. OData hizmetlerini tüketmek için çeşitli kitaplık ve araçlar kullanabilirsiniz.

Microsoft Cloud for Sustainability API'sini temel alan kendi uygulamalarınızı oluşturmanıza yardımcı olması için çok sık talep edilen bu sorgu örneklerinden bazılarını inceleyebilirsiniz.

Sorgu örneklerini hedef ortamlarınızda çalıştırmak için değiştirin:

  • {serviceRoot}: https://api.mcfs.microsoft.com/api/v1.0/instances/{instanceId}

  • {instanceId}: Sorgulamak istediğiniz Sürdürülebilirlik için Bulut ortamının GUID'si, örneğin 20aec369-f1c8-4814-a89d-4d449dd7e8a1.

  • {serviceRootM365}: {serviceRoot}/m365

  • {serviceRootAzure}: {serviceRoot}/enrollments/{enrollmentId}

  • {enrollmentId}: Ödeme hesabı kimliği olarak da bilinen kayıt kimliği. Örnek: 12345678.

  • {tenantId}: Microsoft 365 kiracı kimliği.

Not

Bazı API sorguları birçok sonuç içerir ve birden çok sayfaya ayrılır. API, sayfa başına en fazla 1000 sonuç döndürür. Kullanılabilir daha fazla sonuç varsa API, sonraki sonuç sayfasına bir URL içeren bir @odata.nextLink özelliği döndürür.

EnrollmentEmission varlığı (Azure emisyonları için)

Bir fatura hesabına ilişkin emisyon verilerini temsil eder (kayıt olarak da adlandırılır).

Özellik Türü Notes
dateKey int32 yyyymmdd biçiminde tarih; dd her zaman 01'dir.
enrollmentId Diize Fatura hesap kimliği olarak da bilinir.
orgName Diize TP Adı veya En Üst Üst Öğe Adı ile aynı.
subscriptionId Diize Abonelik kimliği.
subscriptionName Diize Abonelik adı.
azureServiceName Diize Bir Azure hizmetinin adı, örneğin, Uygulama Hizmeti
subService Diize Örneğin, Azure Depolama veya Azure İşlem.
azureRegionName Diize Servisin dağıtıldığı Azure bölgesi.
kapsam Diize Sera gazı kapsamı, örneğin, kapsam 1, kapsam 2 veya kapsam 3.
scopeId int32 Kapsam kimliği.
totalEmissions çift Kayıt için toplam emisyonlar (mtCO2e).

EnrollmentEmission varlığı (Azure emisyonları için) örnek sorguları

Sorgu türü Örnek
Kayıt başına emisyonlar {serviceRootAzure}/Emisyon
Belirli alanları seç {serviceRootAzure}/emissions?$select=enrollmentId,totalEmissions,scopeId
Sayı ekle {serviceRootAzure}/emisyonlar?$count=doğru
Sonuç sayısını sınırla {serviceRootAzure}/emisyon?$top=100
Sayfalandırma {serviceRootAzure}/emisyonlar?$skip=100&$top=50
Kapsama göre filtrele {serviceRootAzure}/emisyonlar?$filter=ScopeId eq 1
Filtreleme ve toplama {serviceRootAzure}/emissions?$apply=filter(ScopeId eq 1)/aggregate($count Sayı olarak, totalEmissions ile ortalama Average, totalEmissions ile sum as Sum)
Filtreleme ve gruplama {serviceRootAzure}/emissions?$apply=filter(totalEmissions gt 0.05)/groupby((ScopeId), aggregate($count as Count))'

Microsoft365Emission varlığı (Microsoft 365 emisyonları için)

Aşağıdaki uygulamalarla ilişkilendirilen Microsoft 365 veri merkezi emisyonlarını temsil eder:

  • Exchange Online
  • SharePoint
  • OneDrive
  • Microsoft Teams
  • Word
  • Excel
  • PowerPoint
  • Outlook
Özellik Türü Notes
dateKey int32 yyyymmdd biçiminde tarih; dd her zaman 01'dir.
tenantId Diize Kiracının kimliği.
tenantName Diize Kiracının adı.
officeRegionName Diize Microsoft 365 veri merkezi bölgesi.
kapsam Diize Sera gazı kapsamı, örneğin, kapsam 1, kapsam 2 veya kapsam 3.
totalEmissions çift Kayıt için toplam emisyonlar (mtCO2e).

Microsoft365Emission varlığı (Microsoft 365 emisyonları için) örnek sorguları

Sorgu türü Örnek
Kiracı için emisyonlar {serviceRootM365}/kiracı emisyonları
Belirli alanları seç {serviceRootM365}/emisyonlar?$select=tenantId,totalEmissions,kapsam
Sayı ekle {serviceRootM365}/kiracıemisyonları?$count=doğru
Sonuç sayısını sınırla {serviceRootM365}/kiracıemisyonları?$top=100
Sayfalandırma {serviceRootM365}/kiracıemisyonları?$skip=100&$top=50
Kapsama göre filtrele {serviceRootM365}/tenantemissions?$filter=Kapsam eq 'FILLMEIN'
Filtreleme ve toplama {serviceRootserviceRootM365Azure}/tenantemissions?$apply=filter(scope eq 'FILLMEIN')/aggregate($count Sayı olarak, totalEmissions ile ortalama olarak, totalEmissions ile sum as Sum)
Filtreleme ve gruplama {serviceRootM365}/tenantemissions?$apply=filter(totalEmissions gt 0.05)/groupby((Kapsam), aggregate($count as Count))'

EnrollmentUsage varlığı (Azure emisyonları için)

Microsoft bulut kaynaklarnın hesaplanmış kullanım faktörünü temsil eder.

Özellik Türü Notes
dateKey int32 yyyymmdd biçiminde tarih; dd her zaman 01'dir.
enrollmentId Diize Fatura hesap kimliği olarak da bilinir.
orgName Diize TP Adı veya En Üst Üst Ad ile aynı.
subscriptionId Diize Abonelik kimliği.
subscriptionName Diize Abonelik adı.
subService Diize Örneğin, Azure Depolama veya Azure İşlem.
azureRegionName Diize Servisin dağıtıldığı Azure bölgesi.
kullanım çift Kaydın toplam kullanımı. Belirtilen bölgedeki servisin normalleştirilmiş kullanımını temsil ettiği için birimi yoktur.

Microsoft'un hesaplama metodolojisi hakkında daha fazla bilgi edinmek için Microsoft Cloud for Sustainability API hesaplama metodlolojisine gidin.|

EnrollmentUsage varlığı için örnek sorgular

Sorgu türü Örnek Not
Tüm kullanım verileri {serviceRootAzure}/Kullanım
Abonelik başına aylık toplam kullanım {serviceRootAzure}/usage?$apply=groupby((SubscriptionName,DateKey),aggregate(usage with sum as TotalUsage))&$orderby=SubscriptionName,DateKey

EnrollmentProjection varlığı (Azure emisyonları için)

Önceki beş ayın hareketli ortalamasını temel alarak takvim yılının kalanı için tahmin sedilen emisyonları temsil eder. Yıllık olarak tasarlanmış görsel öğeler içindir.

Özellik Türü Notes
dateKey int32 yyyymmdd biçiminde tarih; dd her zaman 01'dir.
enrollmentId Dize Fatura hesap kimliği olarak da bilinir.
actualEmissions çift Yalnızca geçmiş tarihlere (mtCO2e) dahil edilmiştir.
projectedEmissions çift Geçerli yıl için (mtCO2e) kullanılabilir gerçek verilere dayalı olarak, önceki beş ayın veya daha düşük bir ortalamanın hareketli ortalamasına dayalı olarak.
actualUsage çift Yalnızca geçmiş tarihler için dahil edilir.
projectedUsage çift Geçerli yıl için kullanılabilir gerçek verilere dayalı olarak, önceki beş ayın veya daha düşük bir ortalamanın hareketli ortalamasına dayalı olarak.

EnrollmentProjection varlığı (Azure emisyonları için) örnek sorguları

Sorgu türü Örnek Not
Tahminler geçmişi 7-2022 {serviceRootAzure}/projeksiyonlar?$filter=dateKey gt 20220701
Yıl için tüm tahminler {serviceRootAzure}/Projeksiyon

Önemli

Microsoft Cloud for Sustainability API'si şu anda önizlemededir ve değiştirilebilir. Microsoft, veri doğruluğuna ve bütünlüğünde geliştirmeler yaptığından geçmiş emisyon rakamlarınız da güncelleştirilebilir.

SSS

Microsoft emisyon ve kullanımı nasıl hesaplar?

Microsoft'un hesaplama metodolojisi hakkında bilgi edinmek için Microsoft Cloud for Sustainability API hesaplama metodlolojisine gidin.

Rownum nedir?

API tutarlı sayfalandırma için rownum kullanır. Bu değer, uygulamanızın bağımlılığı olmaması için değişikliğe tabidir.

Kayıt kimliği nedir?

Kayıt kimliği fatura hesabı kimliğini ifade eder. Azure portalında kayıt kimliğinizi ve ödeme hesabı kimliğinizi bulun.

Hedef ortamım için nasıl yetkilendirme belirteci edinebilirim?

API, bir OAuth yetkilendirme belirteci gerektirir. Microsoft Kimlik Doğrulama Kitaplığını (MSAL) kullanmanızı öneririz:

Geçerli yanıtta döndürülenden daha fazla sonuç varsa, API bir @odata.nextLink özelliği döndürür. Uygulamanız, bir sonraki sonuç sayfasını almak için bu nextLink'te başka bir GET gerçekleştirmelidir. Son sayfa nextLink içermiyor. OData istemci kitaplığıyla sayfalandırma hakkında daha fazla bilgi için bu kod örneğini inceleyin.

📄 Ürün sayfası
🎓 Eğitim

✅ Ücretsiz deneme
🎥 YouTube kanalı

💻 Topluluk
LinkedIn simgesi.LinkedIn grubu