Megosztás a következőn keresztül:

A Cloud for Sustainability API (előzetes verzió) áttekintése

  • Cikk

Microsoft Cloud for Sustainability ikon.

             Ingyenes próbaverzió

Fontos

Az egyes funkciók vagy az összes funkció az előzetes verzió részeként áll rendelkezésre. A tartalom és a funkciók tekintetében a változtatás jogát fenntartjuk.

Microsoft Cloud for Sustainability API-kat biztosít az Azure-ral és Microsoft 365 a használattal kapcsolatos kibocsátási adatok eléréséhez.

A pontos szén-dioxid-elszámoláshoz jó információkra van szükség a partnerektől, szállítóktól és beszállítóktól. A Cloud for Sustainability API-k átláthatóságot biztosítanak az Azure és Microsoft 365. A Microsoft szén-dioxid-elszámolása a kibocsátások mindhárom hatókörére kiterjed, harmadik fél által hitelesített módszertannal. Konzisztens és pontos szén-dioxid-elszámolással számszerűsíti az Azure hatását és Microsoft 365 az ügyfelek környezeti lábnyomát.

Az API részleteit az Microsoft Cloud for Sustainability API-referencia tartalmazza. További információkat tartalmaznak a műveletekről, a paraméterekről és a válaszokról.

Fontos

Az Microsoft Cloud for Sustainability API jelenleg előzetes verzió érhető el, és változhat. A korábbi kibocsátási adatok is frissülhetnek, mivel a Microsoft javítja az adatok pontosságát és teljességét. Ez a előzetes verzió nem jogi megfelelőségi, marketing- vagy jelentéskészítési célokat szolgál.

Első lépések a Cloud for Sustainability API-kkal

Feljegyzés

Ha a szervezet szeretne hozzáférni az API-hoz (előzetes verzió), Microsoft Cloud for Sustainability küldje el ezt a regisztrációs űrlapot.

Az API-k használatának első lépései az alábbi eljárásokkal:

Támogatott fiókok

  • Azure: Microsoft Cloud for Sustainability Az Azure-hoz készült API-k támogatják a közvetlen számlázású, MCA- és MPA-fiókokat a Microsofttal kapcsolatok. Azok az ügyfelek, akik egy felhőszolgáltatótól (CSP) vásárolják meg az Azure-t, nem támogatottak, és közvetlenül a CSP-vel kell dolgozniuk a felhőbeli kibocsátásuk megismeréséhez. Az örökölt fiókok, a kreditalapú fiókok, a kínai regisztrációk és a Azure Government fiókok nem támogatottak. A fiók típusának ellenőrzéséhez lépjen A fiók típusának ellenőrzése oldalra.

    Feljegyzés

    Azure Hybrid Benefit használat jelenleg nem jelenik meg és nem tükröződik a kibocsátásokban.

  • Microsoft 365 : Microsoft Cloud for Sustainability API-k Microsoft 365 az üzleti, nagyvállalati vagy oktatási előfizetések támogatásához a Microsoft 365 vagy Office 365. A nemzeti/területi felhőtelepítések, beleértve, de nem kizárólagosan a Microsoft US Government felhőit, és Office 365 amelyeket a 21Vianet üzemeltet, nem támogatottak.

Jelentkezzen be, és hozzon létre egy példányt

Miután hozzáférést kapott az API-khoz a Microsoft Cloud for Sustainability Microsofttól, jelentkezzen be az Azure Microsoft Entra ID hitelesítő adataival.

Az API-k eléréséhez létre kell hoznia Microsoft Cloud for Sustainability egy példányt. A példány létrehozásával Ön lesz a példány rendszergazdája. A példány rendszergazdája felhasználókat, csoportokat és alkalmazásokat adhat hozzá a példányhoz.

Tekintse meg ezt a videót, amely áttekintést nyújt a Cloud for Sustainability API-k és portál használatáról:

Adatforrások konfigurálása és az API-k engedélyezése

Fontos

A szervezet adataihoz való hozzáférés sikeres engedélyezéséhez ezt a lépés a megfelelő rendszergazdának kell végrehajtania. Azure MCA-fiókok esetén számlázási fiók rendszergazdája szükséges, aki számlázási fiók olvasó, közreműködő vagy tulajdonosi szerepkörrel rendelkezik. Azure EA-fiókok esetén vállalati rendszergazda vagy vállalati rendszergazda szükséges – csak olvasható. Ellenőrizze szerepkörét a Azure Portal. A Microsoft 365 következő szerepkörök egyike szükséges: Exchange-rendszergazda, Skype Vállalati verzió rendszergazdája, SharePoint rendszergazda, globális olvasó, jelentés olvasó. Az Azure és Microsoft 365 a rendszergazdák létrehozhatnak példányokat, vagy hozzáadhatók példányokhoz az adatforrások engedélyezéséhez és az API engedélyezéséhez. Ha nem rendelkezik az adatok engedélyezéséhez szükséges rendszergazdai szerepkörrel, csak bemutató adatokkal fedezheti fel az API-t.

  1. Az Adatforrások lapon kapcsolja be a kapcsolatot az Azure- vagy Microsoft 365 kibocsátási adatok csatlakoztatásához. Az API-k használata előtt győződjön meg arról, hogy az állapot Elérhető . Ez a művelet engedélyezi az összes olyan regisztrációhoz vagy számlázási fiókhoz kapcsolódó kibocsátási adatokat, amelyekhez hozzáféréssel rendelkezik. Ha nem fér hozzá kibocsátási adatokhoz, folytassa csak a bemutató adatokkal.

    Feljegyzés

    A adatforrás engedélyezése után akár 48 órát is igénybe vehet, amíg Microsoft 365 a kibocsátási adatok elérhetővé válnak. A adatforrás letiltása véglegesen törli a Microsoft 365 korábbi Microsoft 365 kibocsátási adatokat.

    Adatforrások.

  2. Válassza a API Management lapot, majd az Engedélyezés lehetőséget.

    Az API engedélyezése elsődleges és másodlagos API-kulcsokat hoz létre a példány számára az API-kérésekben való használatra. A kulcsok újragenerálásához válassza a lehetőséget Frissítés ikon. . A kulcsok másolásához válassza a lehetőséget Másolás ikon. .

Szeretne konfigurálni egy alkalmazást a Cloud for Sustainability API meghívására? Tekintse meg ezt a bemutatót:

Próbálja ki az API-kat

A API Management válassza az API kipróbálása lehetőséget az OData és az API-k exportálása megismeréséhez. Interaktív módon lekérdezheti a kibocsátási adatokat kis késésű OData API-k irányítópultokhoz való csatlakoztatásával. Vagy végezzen saját tömeges feldolgozást úgy, hogy a kibocsátási adatokat közvetlenül az Azure Data Lake Storage Export API-k használatával továbbítja. Megnyílik egy fejlesztői portál egy új lapon, ahol feltárhatja a kérést, válasz sémákat, és élő kéréseket küldhet az Microsoft Cloud for Sustainability API-kra.

OData API-k kipróbálása

  1. A bal oldali navigációs sávon győződjön meg arról, hogy a Csoportosítás címke szerint engedélyezve van, és válassza ki az OData-csoportosítást az Azure és OData Microsoft 365 API-k áttekintéséhez.

  2. Élő kérés küldéséhez válassza a Kipróbálom lehetőséget . Adja meg az összes kötelező mezőt:

    • Engedélyezés: Automatikusan kitöltött engedélyezési jogkivonat
    • Előfizetői kulcs: Automatikusan ki van töltve az API-kulccsal a API Management lapon
    • enrollmentId: A regisztrációs azonosító, más néven a számlázási fiók azonosítója. Csak Azure. Ha nincs hozzáférése egy regisztrációhoz, bemutató adatokkal is megismerheti az API-t, ha demóadatokat ad meg ebben a mezőben.
    • instanceId: Az API-portál URL-címében Microsoft Cloud for Sustainability található
    • tenantId: Microsoft 365 bérlőazonosító.

    Próbálja ki oldalt.

  3. Adja hozzá az összes szükséges lekérdezési paramétert. Görgessen az oldalsó panel aljára, és válassza a Küldés lehetőséget. A HTTP-válasz a panel alján jelenik meg.

Tekintse meg ezt a videót, ha többet szeretne megtudni a Cloud for Sustainability API-król az OData-val:

API-k exportálása

  1. A bal oldali navigációs sávon győződjön meg arról, hogy a Csoportosítás címke szerint engedélyezve van, és válassza a Csoportosítás exportálása lehetőséget a kibocsátási és használati adatok Data Lake-be való exportálásának megkezdéséhez. Válassza a RunExportJob lehetőséget .

  2. Válassza a Try it lehetőséget . Adja meg az összes kötelező mezőt, és válassza a Küldés lehetőséget.

    • Engedélyezés: Automatikusan kitöltött engedélyezési jogkivonat
    • Előfizetői kulcs: Automatikusan ki van töltve az API-kulccsal a API Management lapon
    • instanceId: Az API-portál URL-címében Microsoft Cloud for Sustainability található
    • exportJobType: Válassza az Azure lehetőséget, vagy Microsoft 365 jelölje ki az exportálni kívánt kibocsátási és használati adatok adatforrás.
    • demodata: Adja meg az "true" értéket, ha bemutató adatok exportálásával szeretné felfedezni ezt a funkciót.

  3. Miután kiválasztotta a Küldés lehetőséget, görgessen le a HTTP-válasz megtekintéséhez. Ha Azure-adatokat exportál, a válasz felsorolja az exportált adatok regisztrációs azonosítóit. Ha nem fér hozzá az Azure-hoz vagy Microsoft 365 az adatokhoz, ez a művelet nem sikerül. Győződjön meg arról, hogy megfelelően konfigurálta az adatforrásokat.

    Kezdetben a válasz azt jelzi, hogy a feladat NotStarted lett. Az exportálási feladat 2–3 percet vesz igénybe, és a jobID használatával ellenőrizheti az exportálás állapotát az ExportJobStatus API használatával. Győződjön meg arról, hogy a feladat sikeres volt, ami azt jelzi, hogy az exportált adatok most már elérhetők az átmeneti blobtárolóban.

    A LatestExportJob használatával áttekintheti a legutóbbi exportálási feladattal kapcsolatos információkat.

    Az ExportJobs API használatával áttekintheti az előzményexportálásokkal kapcsolatos információkat.

  4. Az ExportLocation API-val szerezze be az SAS URL-címet. A SAS URL-címe egy óra múlva lejár. Másolja az SAS URL-címet az exportált adatok eléréséhez az átmeneti blobtárolóból.

  5. Az adatok az exportálási feladat futtatása után 28 nappal lejárnak, és a lejárat előtt másolni kell őket. Ellenkező esetben az adatok törlődnek az előkészítési helyről. A felhasználók bármikor újrafuttathatnak egy exportálási feladatot, hogy újabb adatköteget szerezzenek be 28 napos lejárattal, beleértve a legújabb adatkészlet is. Az exportált adatokhoz többféleképpen is hozzáférhet.

    1. Azure Storage Explorer

      Telepítse és nyissa meg Azure Storage Explorer. Válassza a Csatlakozás párbeszédpanel megnyitása gombot, majd válassza az ADLS Gen2 tároló vagy könyvtár lehetőséget. Válassza a Közös hozzáférésű jogosultságkód URL-címe (SAS) lehetőséget, és illessze be az SAS URL-címet a 4. lépés blobtárolóba vagy címtár SAS URL-bemenetébe . Válassza a Tovább , majd a Csatlakozás lehetőséget. Meg kell keresnie vagy létre kell hoznia egy tárolót egy új vagy meglévő tárfiókban az exportált adatok tárolásához. Másolja ki az Azure-t vagy Microsoft 365 az adatokat az átmeneti blobtárolóból, és illessze be a kívánt tárolóba.

    2. Használja az azcopy parancsot. A 4. lépés SAS URL-címének és annak a tárfióknak az URL-címének használatával, ahol az exportált kibocsátásokat tárolja (cél URL-cím), futtassa a azcopy.exe parancsot:

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

    3. Spark-szkript

      Használja az mssparkutils vagy a Synapse használatát. Microsoft Fabric Választhat alternatív kódtárak és környezetek használatát.

      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)

Minta lekérdezések

Az API-kkal való munkához szükséges OData-mintalekérdezések rövid listájáért tekintse meg az OData-lekérdezési példákat.

Engedélyek hozzárendelése

Az API-khoz Microsoft Cloud for Sustainability való hozzáférés a szervezet azon felhasználóira korlátozódik, akiket egy példány rendszergazdája ad hozzá az alkalmazáshoz. A felhasználó lehet egyetlen felhasználó, csoport vagy alkalmazás. A vendégfiókok nem támogatottak. Háromféle szerepkör rendelhető hozzá:

  • Megtekintő: Megtekintheti az Microsoft Cloud for Sustainability API-n belüli összes oldalt.
  • közreműködő: Az API-portál összes oldalával Microsoft Cloud for Sustainability kommunikálhat. Nem adhat hozzá és nem távolíthat el felhasználókat.
  • Rendszergazda: Minden elérhető engedély, beleértve a felhasználók hozzáadásának és eltávolításának lehetőségét is.

Feljegyzés

A közreműködők és rendszergazdák csak akkor tilthatják le vagy engedélyezhetik a Microsoft 365 adatforrás ha Exchange-rendszergazda, Skype Vállalati verzió rendszergazdája, SharePoint rendszergazdája, globális olvasó vagy jelentési olvasó.

Felhasználók, csoportok vagy alkalmazások hozzáadása rendszergazdaként:

  1. Válassza az Engedélyek lapot, majd a Felhasználók hozzáadása lehetőséget .
  2. A Keresés mező segítségével keresse meg a Microsoft Entra hozzáadni kívánt azonosítófelhasználót, alkalmazást vagy csoportot.
  3. Válasszon ki egy szerepkör-hozzárendelést, majd válassza a Mentés lehetőséget .

Példányok kezelése

Lépjen a példány ikonjára Példány ikon az összes példány listájának megkereséséhez, példányok létrehozásához vagy példányok eltávolításához.

API-használat megtekintése

Tekintse meg a valós idejű API-használat részleteit.

  1. Lépjen a API Management lapra, majd válassza a Használat lehetőséget .
  2. Válassza ki a megtekinteni kívánt időkeret.

Az API-használat oldal három szakaszból áll:

  • API-hívások: Egy diagram, amely megjeleníti az API-hívások összesített számát a kiválasztott időkeret.
  • Adatátvitel: Egy diagram, amely az API-n keresztül átvitt adatok mennyiségét mutatja a kiválasztott időkeret.
  • Műveletek: Az egyes elérhető API-műveletek sorait és a műveletek használatának részleteit tartalmazó táblázat.

GYIK

Hogyan számítja ki a Microsoft az API által elérhetővé tett felhőbeli szén-dioxid-kibocsátást?

További információ a Microsoft számítási módszertanáról: Microsoft Cloud for Sustainability API-számítási módszer.

Hol tudhatok meg többet a lekérdezések OData használatával történő írásáról?

Ha többet szeretne megtudni az OData-ról, tekintse meg a lekérdezési beállítások áttekintését.

Hol tárolják a jelentés elkészítéséhez használt adatokat?

Az adatokat az Egyesült Államokban tárolják.

Miért nem látom az előző hónap kibocsátási adatait?

Az adott hónapra vonatkozó kibocsátási adatok az adott hónap végét követő 14. napig állnak rendelkezésre (beleértve a munkaszüneti napokat is).

Nem tudok példányt létrehozni. Miért?

Előfordulhat, hogy a Cloud for Sustainability API-portált egy olyan fiókkal próbálja elérni, amely a bevezetési űrlapon megadottól eltérő gazdagép-bérlőazonosítóhoz van társítva. Ez a helyzet akkor fordulhat elő, ha vendégfiókot használ. A vendégfiókok nem támogatottak. Ha azt szeretné, hogy egy másik bérlőt is bevezessünk, küldje el újra a bevezetési űrlapot.

Más bérlőazonosítóval rendelkezem a és az Azure-hoz Microsoft 365 . Továbbra is használhatom az Microsoft Cloud for Sustainability API-t?

Az API-k továbbra is elérhetők, de a portál példányonként nem támogat több bérlőt. Ezeket a bérlőket külön kell előkészítenie az API-kba.

Hogyan egy alkalmazást az Microsoft Cloud for Sustainability API hívására?

Szeretne konfigurálni egy alkalmazást a Cloud for Sustainability API meghívására? Tekintse meg ezt a bemutatót:

A Azure Portal az azonosítójához, válassza a Microsoft Entra Alkalmazásregisztrációk, majd az + Új regisztráció lehetőséget . Az új regisztrációs lapon adjon nevet az alkalmazásregisztrációnak, szabja testre a beállításokat az igényeinek megfelelően, majd válassza a Regisztráció lehetőséget. Az Azonosító lapon válassza a Microsoft Entra Vállalati alkalmazások panelt, állítsa az Alkalmazás típusát Microsoft-alkalmazások értékre, és keressen az MCFS SDS alkalmazásnévalapján. A bevezetés során szükséges New-AzADServicePrincipal parancsban átadott ApplicationId paraméter annak az API-nak ( Microsoft Cloud for Sustainability ) az ApplicationId-jec3163bf1-092f-436b-b260-7ade5973e5b9, amellyel létrehozta az Microsoft Cloud for Sustainability API-alkalmazásregisztráció példányát (vállalati alkalmazását) a saját bérlőjében.

Ha ez megtörtént, most már az alkalmazásregisztrációs oldalon kiválaszthatja az API-engedélyek panelt. Ha engedélyt szeretne hozzáadni az alkalmazásregisztrációhoz az API hívásához, válassza az Microsoft Cloud for Sustainability + Engedély hozzáadása lehetőséget, majd a szervezet által használt API-k lehetőséget. Ezután keressen rá az API ApplicationId azonosítójára ( Microsoft Cloud for Sustainability ), válassza azc3163bf1-092f-436b-b260-7ade5973e5b9MCFS SDS lehetőséget, majd válassza ki az App.Emissions.Read engedélyt az Alkalmazásengedélyek panelen.

Ennek az alkalmazástípus-engedélynek rendszergazdai jóváhagyást kell adni a Rendszergazdai jóváhagyás megadása a következőhöz lehetőség kiválasztásával {your-tenant}.

Végül látogasson el az API kezdőlapjára, lépjen az Engedélyek panelre, majd válassza a Microsoft Cloud for Sustainability + Hozzáadás lehetőséget . A megjelenő oldalsó panelen válassza a Megtekintő lehetőséget szerepkörként a Felhasználó, Csoport vagy Alkalmazás bemenetben, és folytassa az alkalmazásregisztráció keresésével. Válassza a Mentés parancsot.

Hozzáférési token szerzek be az alkalmazásomhoz, mi az erőforrás URL-címe?

c3163bf1-092f-436b-b260-7ade5973e5b9/.default

Mennyi előzményadat áll rendelkezésre?

  • Azure: A használati és kibocsátási adatok a regisztrációhoz társított adatok elmúlt öt évét fedik le.
  • Microsoft 365 : A kibocsátási adatok az előfizetéshez Microsoft 365 kapcsolódó utolsó 12 hónap adatait fedik le.

Felelősséget kizáró nyilatkozat

Az Microsoft Cloud for Sustainability API (előzetes verzió) a szerverek szén-dioxid-számítására vonatkozó iparági szabványokon alapul. Általános becsléseket biztosít, amelyek segítségével a szervezetek betekintést nyerhetnek az Azure-felhőszolgáltatások használatával kapcsolatos it-infrastruktúra szén-dioxid-kibocsátásába. Az API-val (előzetes verzió) bemutatott Microsoft Cloud for Sustainability megállapítások, értelmezések és következtetések, beleértve a számításokat is, nem konkrét tanácsok vagy javaslatok. A kifejezett információk és vélemények előzetes értesítés nélkül változhatnak. Az Microsoft Cloud for Sustainability API-t (előzetes verzió) jelenlegi állapotában biztosítjuk, mindennemű kifejezett vagy hallgatólagos képviselet vagy garancia nélkül, korlátozás nélkül beleértve az Microsoft Cloud for Sustainability API (előzetes verzió) használatával, eredményeivel vagy teljesítményével, megfelelőségével, pontosságával, megbízhatóságával vagy helyességével kapcsolatos nyilatkozatokat vagy jóváhagyásokat. Az API (előzetes verzió) használatával Microsoft Cloud for Sustainability kapcsolatos teljes kockázatot Ön vállalja. A Microsoft nem vállal felelősséget az Microsoft Cloud for Sustainability API (előzetes verzió) használatáért. A Microsoft semmilyen esetben sem tehető felelőssé egyéb közvetlen vagy közvetett károkért, beleértve az elmaradt hasznot, az elmaradt megtakarításokat, illetve a hibákból, illetve az Microsoft Cloud for Sustainability API használatából vagy használhatatlanságából eredő véletlen vagy következményes károkat (előzetes verzió), még akkor sem, ha a Microsoftot tájékoztatták az ilyen károk bekövetkezésének lehetőségéről.

Microsoft Cloud for Sustainability API OData lekérdezési példák
Microsoft Cloud for Sustainability API számítási módszertan
Microsoft Cloud for Sustainability API

📄 Termékoldal
🎓 Képzés

✅ Ingyenes próbacsatorna
🎥 YouTube

💻 Közösségi
LinkedIn ikon. LinkedIn csoport