Cloud for Sustainability API'sine (önizleme) genel bakış

Microsoft Cloud for Sustainability, Azure ve Microsoft 365 kullanımınıza ilişkin emisyon verilerine erişmek için API'ler sağlar.

Doğru karbon hesaplama için iş ortakları, satıcılar ve tedarikçilerden gelen bilgiler gereklidir. Cloud for Sustainability API'leri Azure ve Microsoft 365 kullanımınızdan ortaya çıkan karbon emisyonları hakkında şeffaflık sağlar. Microsoft'un karbon hesaplaması her üç emisyon kapsamına yayılır ve üçüncü taraflarca doğrulanmış bir metodoloji kullanılır. Azure ve Microsoft 365'in müşterilerin çevresel ayak izi üzerindeki etkisini ölçmek için tutarlı ve doğru karbon hesaplaması kullanır.

API ayrıntıları, Microsoft Cloud for Sustainability API'si başvurusunda listelenir. İşlemler, parametreler ve yanıtlar hakkında ek bilgiler içerirler.

• Sürdürülebilirlik için Bulut API'lerini kullanmaya başlayın
• Örnek sorgular
• İzinleri atama
• Örnekleri yönetme
• API kullanımını görüntüleme
• SSS

Cloud for Sustainability API'lerini kullanmaya başlama

API'leri aşağıdaki yordamlarla kullanmaya başlayın:

• Desteklenen hesapları inceleyin
• Oturum açın ve bir örnek oluşturun
• Veri kaynaklarını yapılandırma ve API'leri etkinleştirme
• API'leri deneyin

Desteklenen hesaplar

• Azure: Microsoft Cloud for Sustainability Azure için API'ler, Microsoft ile doğrudan faturalandırma İlişkiler EA Direct, MCA ve MPA hesaplarını destekler. Bir Bulut Çözüm Sağlayıcısından (CSP) Azure satın alan müşteriler desteklenmez ve bulut emisyonları hakkında bilgi edinmek için doğrudan CSP ile çalışmaları gerekir. Eski hesaplar, kredi tabanlı hesaplar, Çin kayıtları ve Azure Kamu hesapları desteklenmez. Hesap türünüzü denetlemek için Hesap türünüzü denetleme bölümüne gidin.

  Not

  Azure Hibrit Avantaj kullanımı şu anda yakalanmamakta veya emisyonlara yansıtılmamaktadır.

• Microsoft 365: Microsoft Cloud for Sustainability Veya Microsoft 365 için iş, kuruluş veya eğitim aboneliklerini desteklemek için Microsoft 365 Office 365API'ler. 21Vianet tarafından işletilen Microsoft US Government bulutları ve Office 365 dahil ancak bunlarla sınırlı olmamak üzere ulusal/bölgesel bulut dağıtımları desteklenmemektedir.

Oturum açın ve bir kurulum oluşturun

Microsoft'tan Microsoft Cloud for Sustainability API'lerine erişim elde ettikten sonra Azure Microsoft Entra ID kimlik bilgilerinizle oturum açın.

Microsoft Cloud for Sustainability API'lerine erişmek için bir kurulum oluşturmanız gerekir. Kurulumu oluşturarak, bu kurulumun Yöneticisi olursunuz. Kurulumun yöneticisi kuruluma kullanıcılar, gruplar ve uygulamalar ekleyebilir.

Cloud for Sustainability API'leri ve portalı kullanımına genel bakış için bu videoyu izleyin:

Veri kaynaklarını yapılandırın ve API'leri etkinleştirin

1. Azure veya Microsoft 365 emisyon verilerine bağlanmak için Veri Kaynakları sekmesinde bağlantıyı açık duruma getirin. API'leri kullanmadan önce durumun Kullanılabilir olarak listelendiğinden emin olun. Bu eylem, erişiminiz olan tüm kayıtlar veya fatura hesaplarıyla ilgili emisyon verilerini sunar. Herhangi bir emisyon verisine erişiminiz yoksa, yalnızca demo verileriyle devam edin.

   Not

   Veri kaynağı etkinleştirildikten sonra Microsoft 365 emisyon verilerinin kullanılabilir olması 48 saat kadar sürebilir. Microsoft 365 veri kaynağı devre dışı bırakıldığında geçmiş Microsoft 365 emisyon verileri kalıcı olarak silinir.

   

2. API Yönetimi sekmesini ve ardından Etkinleştir'i seçin.

   API'nin etkinleştirilmesi, kurulumunuzun API isteklerini kullanabilmesi için birincil ve ikincil API anahtarları oluşturur. Anahtarları yeniden oluşturmak için öğesini seçin. Anahtarları kopylamak için öğesini seçin.

Cloud for Sustainability API'sini çağırmak için bir uygulama yapılandırmakla ilgileniyor musunuz? Bu tanıtımı izleyin:

API'leri deneyin

API Yönetimi sekmesinde OData ve Dışarı Aktarma API'lerini keşfetmek için API'yi dene'yi seçin. Düşük gecikmeli OData API'lerini panolarınıza bağlayarak emisyon verilerinizi etkileşimli olarak sorgulayın. Veya, emisyon verilerinizi Dışarı Aktarma API'lerini kullanarak doğrudan Azure Data Lake Storage'a aktararak kendi toplu işlemenizi yapın. Geliştirici portalı, istek ve yanıt şemalarını araştıralabileceğiniz ve Microsoft Cloud for Sustainability API'lerine karşı canlı istekler oluşturabileceğiniz yeni bir sekmede açılır.

OData API'lerini deneme

1. Sol gezinti bölmesinde, Gruplama ölçütü etiketinin etkin olduğundan emin olun ve Azure ve Microsoft 365 OData API'lerini incelemek için OData gruplandırmasını seçin.

2. Canlı bir istekte bulunmak için Deneyin'i seçin. Tüm gerekli alanları doldurun:

   • Yetkilendirme: Otomatik olarak doldurulan yetkilendirme belirteci
   • Abonelik anahtarı: API Management sekmesindeki API anahtarıyla otomatik olarak doldurulur
   • enrollmentId: Ödeme hesabı kimliği olarak da bilinen kayıt kimliğiniz. Yalnızca Azure. Bir kayda erişiminiz yoksa, bu alana demodata girerek demo verileri kullanıp API'yi keşfedebilirsiniz.
   • instanceId: API portalının URL'sinde Microsoft Cloud for Sustainability bulunur
   • tenantId: Microsoft 365 kiracı kimliği.

   

3. Tüm gerekli sorgu parametrelerini ekleyin. Yan bölmenin alt kısmına gidin ve Gönder'i seçin. HTTP yanıtı, bölmenin alt kısmında görüntülenir.

OData ile Cloud for Sustainability hakkında daha fazla bilgi edinmek üzere bu videoyu izleyin:

Dışarı Aktarma API'lerini deneme

1. Sol gezinti bölmesinde, Etikete göre grupla'nın etkin olduğundan emin olun ve emisyonlar ile kullanım verilerini veri gölünüze aktarmaya başlamak için Dışarı Aktar gruplandırmasını seçin. RunExportJob öğesini seçin.

2. Deneyin'i seçin. Tüm gerekli alanları girin ve Gönder'i seçin.

   • Yetkilendirme: Otomatik olarak doldurulan yetkilendirme belirteci
   • Abonelik anahtarı: API Management sekmesindeki API anahtarıyla otomatik olarak doldurulur
   • instanceId: API portalının URL'sinde Microsoft Cloud for Sustainability bulunur
   • exportJobType: Dışarı aktarılacak emisyonlar ve kullanım verileri için veri kaynağı belirlemek için Azure veya Microsoft 365 öğesini seçin.
   • demodata: Demo verilerini dışa aktararak bu işlevi keşfetmek istiyorsanız "true" girin.

3. Gönder'i seçtikten sonra, HTTP yanıtını görmek için aşağı kaydırın. Azure verileri dışarı aktarıyorsanız yanıt dışarı aktarılan veriler için kayıt kimliklerini listeler. Azure veya Microsoft 365 verilerine erişiminiz yoksa, bu işlem başarısız olur. Veri kaynaklarınızı doğru yapılandırdığınızdan emin olun.

   Başlangıçta yanır işin NotStarted durumunda olduğunu belirtir. Dışarı aktarma işinin tamamlanması 2-3 dakika sürer ve ExportJobStatus API'sini kullanarak dışarı aktarmanın durumunu denetlemek için JobID öğesini kullanabilirsiniz. İşin başarılı olduğundan emin olun; bu, dışarı aktarılan verilerin artık hazırlama blob depolamasında kullanılabildiğini gösterir.

   Son dışarı aktarma işiniz ile ilgili bilgileri gözden geçirmek için LatestExportJob kullanabilirsiniz.

   Geçmiş dışarı aktarmalarınız ile ilgili bilgileri gözden geçirmek için ExportJobs API'sini kullanabilirsiniz.

4. SAS URL'yi almak için ExportLocation API'sini kullanın. SAS URL'sinin süresi bir saat sonunda dolar. Hazırlama blob depolama alanında dışarı aktarılan verilere erişmek için SAS URL'sini kopyalayın.

5. Veriler, dışarı aktarma işi çalıştırıldıktan sonra 28 gün içinde süresi dolacak şekilde ayarlanır ve süre sonu öncesinde kopyalanmaları gerekir. Aksi takdirde veriler hazırlama konumundan silinir. Kullanıcılar, 28 günlük sona erme süresi olan ve en yeni veri kümesini içeren başka bir toplu veri elde etmek için istedikleri zaman yeniden bir dışarı aktarma işi çalıştırabilirler. Dışarı aktarılan verilere erişmenin birkaç yolu vardır.

   1. Azure Depolama Gezgini

      Azure Depolama Gezgini'ni yükleyin ve açın. Bağlan İletişim Kutusunu Aç düğmesini ve ardından ADLS 2. Nesil kapsayıcı veya dizini seçin. Paylaşılan erişim imzası URL'sini (SAS) seçin ve adım 4'teki SAS URL'sini Blob kapsayıcısı veya dizini SAS URL girişine yapıştırın. İleri'yi seçip Bağlan'ı seçin. Dışarı aktarılan bu verileri depolamak için kullanmak üzere yeni veya mevcut bir depolama hesabında bir kapsayıcı bulmanız veya oluşturmanız gerekir. Hazırlama blob depolama alanından Azure veya Microsoft 365 verilerini kopyalayın ve istediğiniz kapsayıcıya yapıştırın.

   2. azcopy kullanın. 4. adımdaki SAS URL'sini ve dışarı aktarılan emisyonlarınızı depoladığınız depolama hesabının URL'sini (hedef URL) kullanarak, azcopy.exe komutunu çalıştırın:

      • azcopy login
      • azcopy list <SAS URL>
      • azcopy cp <SAS URL> <destination URL>

   3. Spark betiği

      Microsoft Fabric veya Synapse'de mssparkutils kullanın. Alternatif kitaplıkları ve ortamları kullanmayı tercih edebilirsiniz.

      import subprocess
      from notebookutils import mssparkutils
      
      result = subprocess.run(['pip', 'install', 'azure-storage-blob'], capture_output=True)
      
      # replace with SAS URI from API request
      source_sas_url = 'https://<account_name>.blob.windows.net/<container_name>/<path>?<sas_token>'
      
      start_index = source_sas_url.find('https://') + len('https://')
      end_index = source_sas_url.find('.blob', start_index)
      account_name = source_sas_url[start_index:end_index]
      split = source_sas_url.split('?', 1)
      domain_path = split[0]
      sas_token = split[1]
      container_name = domain_path.split('/')[3]
      
      source_mount_point = '/src'
      destination_mount_point = '/dest'
      
      mssparkutils.fs.unmount(source_mount_point)
      mssparkutils.fs.mount(
          f'abfss://{container_name}@{account_name}.blob.core.windows.net',
          source_mount_point,
          { 'sasToken': sas_token })
      
      mssparkutils.fs.unmount(destination_mount_point)
      mssparkutils.fs.mount( 
          'abfss://<destinationPath>', # replace with destination connection string
          destination_mount_point)
      
      mssparkutils.fs.cp(src_path, dest_path, True)
      

Örnek sorgular

API'lerle çalışacak şekilde OData örneklerinin kısa bir listesi için bkz. OData sorgu örnekleri.

İzin atama

Microsoft Cloud for Sustainability API'lerine erişim, bir kurulumun yöneticisinin uygulamaya eklediği kuruluşunuzdaki kullanıcılar ile kısıtlıdır. Kullanıcı tek bir kullanıcı, grup veya uygulama olabilir. Konuk hesaplar desteklenmez. Atayabileceğiniz üç tür rol vardır:

• Görüntüleyici: API içindeki Microsoft Cloud for Sustainability tüm sayfaları görüntüleyebilir.
• Katılımcı: API portalındaki Microsoft Cloud for Sustainability tüm sayfalarla etkileşim kurabilir. Kullanıcı ekleyemez veya kaldıramaz.
• Yönetici: Kullanıcı ekleme veya kaldırma özelliği de dahil olmak üzere tüm izinler kullanılabilir.

Kullanıcıları, grupları veya uygulamaları yönetici olarak eklemek için:

1. İzinler sekmesini seçin ve sonra Kullanıcı Ekle'yi seçin.
2. Eklemek istediğiniz Microsoft Entra ID kullanıcısını, uygulamayı veya grubu bulmak için Arama alanını kullanın.
3. Bir rol ataması seçin ve ardından Kaydet'i seçin.

Kopyaları yönetme

Tüm kurulumların listesini bulmak için kurulum simgesine gidin, kurulumlar oluşturun veya kurulumları kaldırın.

API kullanımını görüntüleme

Gerçek zamanlı API kullanımı hakkındaki ayrıntıları görüntüleme

1. API Yönetimi sekmesine gidin ve Kullanım'ı seçin.
2. Görüntülemek için zaman dilimi seçin.

API kullanımı sayfası üç bölüm içerir:

• API çağrıları: Seçilen zaman dilimi içinde API'ye yapılan çağrıların toplam sayısını görselleştiren bir grafik.
• Veri aktarımı: Seçilen zaman dilimi içinde API aracılığıyla aktarılan veri miktarını gösteren bir grafik.
• İşlemler: Kullanılabilir her API işlemi için satırları ve işlemlerin kullanımıyla ilgili ayrıntıları içeren bir tablo.

SSS

Microsoft, API tarafından kullanılabilir duruma getirilen bulut karbon emisyon değerlerini nasıl hesaplar?

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

Sorguları OData ile yazma hakkında nasıl daha fazla bilgi edinebilirim?

OData hakkında daha fazla bilgi için Sorgu seçeneklerine genel bakış bölümüne gidin.

Bu raporu oluşturmak için kullanılan veriler nerede depolanır?

Veriler Amerika Birleşik Devletleri'nde depolanır.

Önceki aya ait emisyon verilerini neden göremiyorum?

Belirli bir aya ilişkin emisyon verileri, (iş dışı günler dahil olmak üzere) bu ayın bitiminden sonraki 14. günde kullanıma sunulur.

Bir kurulum oluşturamıyorum. Neden?

Cloud for Sustainability API portalına, katılım formunda belirtilenden farklı bir barındıran kiracı kimliğiyle ilişkilendirilmiş bir hesap kullanarak erişmeye çalışıyor olabilirsiniz. Bu durum, bir konuk hesabı kullandığınızda oluşabilir. Konuk hesaplar desteklenmez. Başka bir kiracıyı eklemememizi istiyorsanız, ekleme formunu yeniden gönderin.

Microsoft 365 ve Azure için farklı kiracı kimliğim var. Microsoft Cloud for Sustainability API'sini kullanmaya devam edebilir miyim?

API'lere erişmeye devam edebilirsiniz ancak portal her kurulum için birden çok kiracıyı desteklemez. Bu kiracıları API'lere ayrı olarak eklemeniz gerekir.

Bir uygulamayı Microsoft Cloud for Sustainability API'sini çağıracak şekilde nasıl yapılandırabilirim?

Cloud for Sustainability API'sini çağırmak için bir uygulama yapılandırmakla ilgileniyor musunuz? Bu tanıtımı izleyin:

Azure portalında Microsoft Entra ID'ye gidin, Uygulama kayıtları'nı ve ardından + Yeni kayıt'ı seçin. Yeni kayıt sayfasında, uygulama kaydınız için bir ad verin, seçenekleri ihtiyaçlarınıza göre özelleştirin ve sonra Kaydet'i seçin. Microsoft Entra ID sayfasına gidin, Kurumsal uygulamalar dikey penceresini seçin, Uygulama türünü Microsoft Uygulamaları olarak ayarlayın ve MCFS SDS uygulama adına göre arama yapın. Ekleme sırasında gereken New-AzADServicePrincipal komutunda geçirdiğiniz ApplicationId parametresi, kendi kiracınızda API uygulama kaydının bir örneğini (kurumsal uygulama) oluşturduğunuz API'nin Microsoft Cloud for Sustainability (00001111-aaaa-2222-bbbb-3333cccc4444) ApplicationId Microsoft Cloud for Sustainability değeridir.

Bu şekilde, uygulama kayıt sayfanıza gidip API izinleri dikey öğesini seçebilirsiniz. Uygulama kaydınızın Microsoft Cloud for Sustainability API'sini çağırabilmesi için izin eklemek üzere + İzin ekle'yi ve ardından Kuruluşumun kullandığı API'leri seçin. Ardından API'nin ApplicationId () ' de Microsoft Cloud for Sustainability arama yapın, MCFS SDS'yi00001111-aaaa-2222-bbbb-3333cccc4444 seçin ve ardından Uygulama izinleridikey penceresinin App.Emissions.Read iznini seçin .

Bu uygulama türü izni, {your-tenant} için yönetici izni ver seçilerek yönetici onayı verilmesini gerektirir.

Son olarak, Microsoft Cloud for Sustainability API'si giriş sayfasını ziyaret edin, İzinler penceresine gidin ve ardından + Ekle'yi seçin. Görüntülenen yan bölmede, Kullanıcı, Grup veya Uygulama girişinde Rol olarak Görüntüleyici'yi seçin ve uygulama kaydınızı aramaya devam edin. Kaydet'i seçin.

Uygulamam için erişim belirteci aldım, kaynak URL nedir?

00001111-aaaa-2222-bbbb-3333cccc4444/.default

Ne kadar geçmiş veri var?

• Azure: Kullanım ve emisyon verileri, kayıtla ilişkili son beş yıllık verileri kapsar.
• Microsoft 365: Emisyon verileri, abonelikle Microsoft 365 ilişkili son 12 aylık verileri kapsar.

Bildirim

Microsoft Cloud for Sustainability API'si (önizleme) sunucuların karbon hesaplaması için endüstri standartlarını temel alır. Kuruluşların Azure bulut hizmetleri kullanımıyla ilişkili BT altyapısı karbon emisyonları hakkında içgörüler edinmelerine yardımcı olmak için genel tahminler sunar. Hesaplamalar da dahil olmak üzere Microsoft Cloud for Sustainability API'si (Önizleme) ile sunulan bulgular, yorumlamalar ve sonuçlar özel tavsiyeler veya öneriler değildir. İfade edilen bilgiler ve görünümler, haber verilmeksizin değiştirilebilir. Microsoft Cloud for Sustainability API'si (önizleme) Microsoft Cloud for Sustainability API'si (önizleme) kullanımı, sonuçları ve performansına, uygunluğuna, doğruluğuna, güvenilirliğine veya hatasızlığına ilişkin sunumlar ve desteklemeler dahil herhangi bir gösterim veya garanti olmadan olduğu gibi sunulur. Microsoft Cloud for Sustainability API'si (önizleme) kullanımına yönelik tüm risklerin size ait olduğu varsayılır. Microsoft, Microsoft Cloud for Sustainability API'sinin (önizleme) kullanımına ilişkin yükümlülük üstlenmez. Hiçbir durumda Microsoft, söz konusu hasar olasılığı konusunda Microsoft'a bilgi verilmiş olsa bile, herhangi bir kazanç kaybı, tasarruf kaybı veya herhangi bir kusurdan kaynaklanan arızi ya da sonuç olarak ortaya çıkan hasarlardan ya da Microsoft Cloud for Sustainability API'sini (önizleme) kullanma ya da kullanamama dahil olmak üzere, diğer doğrudan veya dolaylı zararlardan sorumlu tutulmayacaktır.

İlgili bilgiler

Microsoft Cloud for Sustainability API OData sorgu örnekleri
Microsoft Cloud for Sustainability API hesaplama metodolojisi
Microsoft Cloud for Sustainability API