Pregled API-ja za održivost (Pregled)

  • Članak

Važno

Neke ili sve ove funkcionalnosti dostupne su kao deo izdanja za pregled. Sadržaj i funkcionalnost su podložni promenama.

Microsoft Cloud for Sustainability obezbeđuje API-je za pristup podacima o emisijama u vezi sa vašim Azure i korišćenjem Microsoft 365 .

Precizno knjigovodstvo ugljenika zahteva dobre informacije od partnera, dobavljača i dobavljača. API-ja o održivosti vam daje transparentnost emisije ugljenika generisane vašom upotrebom Azure i Microsoft 365. Microsoftovo knjigovodstvo ugljenika se prostire na sva tri opsega emisija metodologijom proverene treće strane. Koristi dosledno i precizno knjigovodstvo ugljenika da kvantifikuje efekat Azure i ekološki Microsoft 365 otisak klijenata.

Detalji API-ja su navedeni u Microsoft Cloud for Sustainability API referenci. Sadrže dodatne informacije o operacijama, parametrima i odgovorima.

Važno

API Microsoft Cloud for Sustainability je trenutno u pregledu i podložn je promenama. Vaše istorijske cifre izduvnih gasova takođe mogu biti ažurirane jer Microsoft unavršavanje tačnosti i potpunosti podataka. Ovaj pregled nije namenjen za pravnu usaglašenost, marketing ili potrebe izveštavanja.

Prvi koraci sa CLOUD-om za API-je održivosti

Belešku

Ako vaša organizacija želi da dobije pristup API-u Microsoft Cloud for Sustainability (Preview),prosledite ovaj obrazac za prijavljivanje.

Prvi koraci sa API-jem pomoću sledećih procedura:

Podržani nalozi

  • Azure:API za Azure podržavaju EA Direct, MCA i MPA naloge Microsoft Cloud for Sustainability sa direktnim odnosi microsoftom. Klijenti koji kupe Azure od Dobavljača cloud rešenja (CSP) nisu podržani i moraju direktno da rade sa svojim CSP-om da bi saznali više o emisijama u oblaku. Zastareli računi, računi zasnovani na kreditima, upisi u Kinu i računi Azurne vlade nisu podržani. Da biste proverili tip naloga, idite na lokaciju Provera tipa naloga.

    Belešku

    Upotreba Azure Hybrid Benefit trenutno nije uhvaćena ili se odražava na emisije.

  • Microsoft 365: Microsoft Cloud for Sustainability API za podršku Microsoft 365 poslovnim, poslovnim ili edukativnim pretplatama za Microsoft 365 ili Office 365. Nacionalna/regionalna raspoređivanja u oblaku, uključujući, ali ne ograničavajući se na oblake američke Office 365 vlade korporacije Microsoft i kojima upravlja 21Vianet nisu podržana.

Prijavljivanje i kreiranje instance

Kada dobijete pristup API-je Microsoft Cloud for Sustainability od korporacije Microsoft, prijavite se pomoću svojih Azure Active Directory (Azure AD) akreditiva.

Morate da kreirate instancu da biste pristupili Microsoft Cloud for Sustainability API-jem. Kreiranjem instance postajete administrator te instance. Administrator instance može da doda korisnike, grupe i aplikacije instanci.

Pogledajte ovaj video za pregled korišćenja CLOUD-a za API-je održivosti i portala:

Konfigurisanje izvora podataka i omogućavanje API-ja

Važno

Da biste uspešno omogućili pristup podacima vaše organizacije, ovaj korak mora da izvrši odgovarajući administrator. Za Azure MCA naloge potreban je administrator naloga za naplatu sa ulogom čitalac naloga čitalac, saradnik ili vlasnika. Za Azure EA naloge potreban je administrator preduzeća ili administrator preduzeća - potrebno je samo za čitanje. Proverite svoju ulogu na Azure portalu. Za Microsoft 365, potrebna je jedna od sledećih uloga: Global admin, Exchange admin, Skype za posao admin,admin SharePoint , Global čitalac, Report čitalac. Azure i administratori mogu da kreiraju instance ili da budu Microsoft 365 dodati instancama da bi omogućili izvore podataka i omogućili API. Ako nemate potrebnu ulogu administratora da biste omogućili podatke, API možete da istražite samo pomoću demo podataka.

  1. Na kartici "Izvori podataka " prebacite vezu da biste povezali Azure podatke ili podatke Microsoft 365 o emisijama. Uverite se da je status naveden kao dostupan pre korišćenja API-ja. Ova radnja omogućava podatke o emisijama koje se odnose na sve upisne ili naloge za naplatu za koje imate pristup. Ako nemate pristup podacima o emisijama, nastavite samo sa demo podacima.

    Belešku

    Možda će biti potrebno do 48 sati da podaci o Microsoft 365 emisijama postanu dostupni nakon što se izvor podataka. Onemogućavanje izvor podataka Microsoft 365 izbrisaće istorijske podatke o emisijama Microsoft 365 .

    Izvori podataka.

  2. Izaberite karticu API Upravljanje , a zatim kliknite na dugme Omogući .

    Omogućavanje API-ja generiše primarne i sekundarne API ključeve koje instanca koristi u API zahtevima. Da biste ponovo generisali tastere, izaberite Osveži ikonu. . Da biste kopirali ključeve, izaberite Kopiraj ikonu. .

Zainteresovani ste za konfigurisanje aplikacije za pozivanje CLOUD-a za API održivosti? Pogledajte ovu demonstraciju:

Isprobajte API-je

Na kartici API Upravljanje izaberite pokušajte API da biste istražili OData i Izvoz API-ja. Interaktivno ispitajte podatke o emisijama tako što ćete povezati OData API-je sa niskom kašnjenjem sa kontrolnim tablama. Ili izvršite sopstvenu masovnu obradu tako što ćete podatke o emisijama preneti direktno na API-je Azure Data Lake Storage za izvoz. Portal za projektante se otvara na novoj kartici na kojoj možete da istražite šeme zahteva i odgovora i da uživo zatražite API-je Microsoft Cloud for Sustainability .

Isprobajte OData API-je

  1. Na levoj navigaciji uverite se da je oznaka "Grupiši po" omogućena i izaberite grupisanje OData da biste pregledali Azure Microsoft 365 i OData API-je.

  2. Da biste napravili zahtev uživo, izaberite pokušajte . Unesite sva obavezna polja:

    • Autorizacija: Automatski popunjen simbol autorizacije
    • Ključ pretplate: Automatski popunjen API ključem sa kartice " UPRAVLJANJE API-jem "
    • ID upisa: ID vašeg upisa, poznat i kao ID naloga za naplatu. Samo Azure. Ako nemate pristup upisu, API možete da istražite pomoću demo podataka unošenjem demodata u ovo polje.
    • instanceId: Pronađeno u URL adresi API Microsoft Cloud for Sustainability portala
    • stanarId:ID Microsoft 365 stanara.

    Probaj na stranici.

  3. Dodajte sve neophodne parametre upita. Pomerite se na dno bočnog okna i izaberite pošalji . HTTP odgovor se prikazuje na dnu okna.

Pogledajte ovaj video da biste saznali više o API-jem za održivost cloud-a sa OData- om:

Pokušajte da izvezete API-je

  1. Na levoj navigaciji uverite se da je omogućena oznaka "Grupiši po" i izaberite grupisanje izvoza da biste započeli izvoz emisija i podataka o korišćenju u jezero sa podacima. Izaberite RunExportJob.

  2. Izaberite pokušajte. Unesite sva potrebna polja i izaberite Pošalji .

    • Autorizacija: Automatski popunjen simbol autorizacije
    • Ključ pretplate: Automatski popunjen API ključem sa kartice " UPRAVLJANJE API-jem "
    • instanceId: Pronađeno u URL adresi API Microsoft Cloud for Sustainability portala
    • exportJobType: Izaberite Azure ili odredite Microsoft 365 izvor podataka za izvoz emisija i podataka o korišćenju.
    • demodata: Unos "tačno" ako želite da istražite ovu funkcionalnost izvozom demo podataka.

  3. Kada izaberete opciju " Pošalji", pomerite se nadole da biste videli HTTP odgovor. Ako izvozite Azure podatke, odgovor navodi ID-ove za upis za izvezene podatke. Ako nemate pristup Azure ili podacima Microsoft 365 , ova operacija neće uspeti. Uverite se da ste pravilno konfigurisali izvore podataka.

    U početku, odgovor ukazuje na to da posao nema "NotStarted". Dovršavanje izvoznog posla traje 2-3 minuta, a ID posla možete da koristite za proveru statusa izvoza pomoću EXPORTJobStatus API. Uverite se da je posao uspeo, što ukazuje na to da su izvezeni podaci sada dostupni u prostornom skladištu bloba.

    Funkciju LatestExportJob možete da koristite za pregled informacija u vezi sa poslednjim izvoznim poslom.

    ExportJobs API možete koristiti za pregled informacija u vezi sa istorijskim izvozom.

  4. Koristite API za exportLocation da biste dobili URL adresu SAS-a. URL adresa SAS-a ističe posle dva sata. Kopirajte URL adresu SAS-a da biste pristupili izvezenim podacima iz pripremnog skladišta bloba.

  5. Podaci treba da isteknu 28 dana nakon završetka izvoznog posla i moraju da se kopiraju pre isteka roka važenja. U suprotnom, podaci se brišu sa pripremne lokacije. Korisnici mogu da ponovo pokretanje izvozne obrade u bilo kom trenutku da bi dobili drugu grupu podataka sa rokom važenja od 28 dana i uključujući najnoviju skup podataka. Postoji nekoliko načina za pristup izvezenim podacima.

    1. Azure Storage Explorer

      Instalirajte i otvorite Azure istraživač skladišta. Kliknite na dugme "Otvori dijalog povezivanja", a zatim izaberite kontejner ili direktorijum ADLS Gen2. Izaberite URL adresu sa potpisom za deljeni pristup (SAS) i nalepite URL adresu SAS-a iz koraka 4 u Blob kontejner ili unos URL adrese SAS-a direktorijuma . Kliknite na dugme Dalje , a zatim izaberite stavku Poveži se. Potrebno je da pronađete ili kreirate kontejner u novom ili postojećem nalogu za skladištenje 000 izvezenih podataka. Kopirajte Azure ili podatke Microsoft 365 iz skladišta bloba i nalepite u kontejner po vašem izboru.

    2. Koristi azkopiju. Koristeći URL adresu SAS-a iz koraka 4 i URL adresu naloga za skladištenje izvezenih emisija (odredišna URL adresa), pokrenite komandu azcopy.exe a:

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

    3. Spark scenario

      Koristite mssparkutils u Microsoft Fabric ili Synapse. Možete odabrati da koristite alternativne biblioteke i okruženja.

      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)

Probni upiti

Da bi kratka lista probnih upita OData radila sa API-jem, idite na primere upita OData.

Dodeljivanje dozvola

Microsoft Cloud for Sustainability Pristup API-jejima je ograničen na korisnike u vašoj organizaciji koje administrator instance dodaje aplikaciji. Korisnik može biti jedan korisnik, grupa ili aplikacija. Nalozi gosta nisu podržani. Postoje tri tipa uloga koje mogu biti dodeljene:

  • Prikazivač: Može da prikaže sve stranice unutar Microsoft Cloud for Sustainability API-ja.
  • saradnik: Može da komunicira sa svim stranicama na Microsoft Cloud for Sustainability API portalu. Nije moguće dodati ili ukloniti korisnike.
  • Administrator: Sve dostupne dozvole, uključujući mogućnost dodavanja ili uklanjanja korisnika.

Belešku

Saradnici i administratori ne mogu onemogućiti Microsoft 365 ili omogućiti izvor podataka osim ako nisu Globalni administrator, Exchange administrator, Skype za posao administrator, SharePoint administrator, Global čitalac ili Report čitalac.

Da biste dodali korisnike, grupe ili aplikacije kao administratora:

  1. Izaberite karticu Dozvole , a zatim kliknite na dugme Dodaj korisnike.
  2. Koristite polje za pretragu da biste pronašli Azure AD korisnika, aplikaciju ili grupu koju želite da dodate.
  3. Izaberite dodelu uloga, a zatim kliknite na dugme Sačuvaj .

Upravljanje instancama

Krećite se do ikone Ikona instance da biste pronašli listu svih instanci, kreirali instance ili uklonili instance.

Prikaži upotrebu API-ja

Prikažite detalje o korišćenju API-ja u realnom vremenu.

  1. Krećite se do kartice "Upravljanje API-jem ", a zatim izaberite stavku Korišćenje.
  2. Izaberite vremenski okvir za prikaz.

Stranica za upotrebu API-ja sadrži tri odeljka:

  • API poziva: grafikon koji vizuelizuje zbirni broj poziva API-u u izabranom vremenski okvir.
  • Prenos podataka: grafikon koji prikazuje količinu podataka koji su preneti preko API-ja u izabranom vremenski okvir.
  • Operacije: Tabela sa redovima za svaku dostupnu API operaciju i detaljima o korišćenju operacija.

Najčešća pitanja

Kako Microsoft izračunava emisije ugljenika u oblaku koje je API stavio na raspolaganje?

Za informacije o Microsoft metodologiji izračunavanja pogledajte API Microsoft Cloud for Sustainability metodologiju izračunavanja.

Gde mogu da saznam više o pisanju upita pomoću OData?

Da biste saznali više o ODatama, idite na pregled opcija upita.

Gde se čuvaju podaci za izradu ovog izveštaja?

Podaci se čuvaju u Sjedinjenim Državama.

Zašto ne mogu da vidim podatke o emisijama za prethodni mesec?

Podaci o emisijama za dati mesec biće dostupni do 14.

Ne mogu da stvorim instancu. Zašto?

Možda pokušavate da pristupite CLOUD for Sustainability API portalu sa nalogom koji je povezan sa ID-om zakupca drugog domaćina od onog koji je naveden u obrascu za ukrcavanje. Do ove situacije može doći kada koristite nalog gosta. Nalozi gosta nisu podržani. Ako želite da se ukrcamo na drugog stanara, ponovo pridružite formular za ukrcavanje.

Imam drugu liиnu idu stanara Microsoft 365 za i Azure. Da li još uvek mogu da Microsoft Cloud for Sustainability koristim API?

I dalje možete da pristupite API-jem, ali portal ne podržava više stanara po instanci. Potrebno je da se ukrcate na ove stanare u API odvojeno.

Kako da konfigurišem aplikaciju za pozivanje Microsoft Cloud for Sustainability API-ja?

Zainteresovani ste za konfigurisanje aplikacije za pozivanje CLOUD-a za API održivosti? Pogledajte ovu demonstraciju:

Na Azure portalu idite na svoje, izaberite Azure Active Directory Registracije aplikacija i zatim na + Novu registraciju. Na novoj stranici za registraciju dajte ime za registraciju aplikacije, prilagodite opcije svojim potrebama, a zatim izaberite stavku Registruj se. Idite na stranicu Azure AD , izaberite oštricu Enterprise aplikacija, podesite tip aplikacije da bude Microsoft Applications i pretražite po imenu aplikacije MCFS SDS. Parametar ApplicationId koji ste prosledili u komandi New-AzADServicePrincipal koja je potrebna tokom ukrcavanja je ID Microsoft Cloud for Sustainability aplikacije API (c3163bf1-092f-436b-b260-7ade5973e5b9) sa kojim ste kreirali instancu (poslovnu aplikaciju) Microsoft Cloud for Sustainability registracije API aplikacije u sopstvenom zakupcu.

Pošto je to na svom mestu, sada možete da odete na stranicu za registraciju aplikacija i izaberete sečivo za API dozvole. Da biste dodali dozvolu za registraciju aplikacije da biste mogli da pozovete Microsoft Cloud for Sustainability API, izaberite + Dodajte dozvolu, a zatim API-je koje moja organizacija koristi. Zatim pretražite ID aplikacije Microsoft Cloud for Sustainability API (c3163bf1-092f-436b-b260-7ade5973e5b9), izaberite MCFS SDS, a zatim izaberite App.Emissions.Pročitajtedozvolu sečiva dozvola aplikacije.

Ova dozvola tipa aplikacije treba da dobije saglasnost administratora tako što ćete izabrati saglasnost administratora Granta za {your-tenant}.

Na kraju, posetite MATIČNU Microsoft Cloud for Sustainability stranicu API-ja, dođite do sečiva dozvola , a zatim izaberite + Dodaj. Na bočnoj tabli koja se pojavljuje odaberite opciju "Prikazivač " kao ulogu u unosu korisnika, grupe ili aplikacije i nastavite potragu za registracijom aplikacije. Izaberite stavku Sačuvaj.

Pribavljam nalog za token za pristup, koja je URL adresa resursa?

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

Koliko istorijskih podataka je dostupno?

  • Azure: Podaci o korišćenju i emisijama pokrivaju poslednjih pet godina podataka povezanih sa upisom.
  • Microsoft 365: Podaci o emisijama pokrivaju poslednjih 12 meseci podataka povezanih sa pretplatom Microsoft 365 .

Odricanje odgovornosti

Microsoft Cloud for Sustainability API (pregled) se zasniva na industrijskim standardima za izračunavanje ugljenika servera i daje opšte procene koje pomažu organizacijama da steknu uvid u emisiju ugljenika IT infrastrukture povezane sa korišćenjem Azure cloud usluga. Nalazi, tumačenja i zaključci predstavljeni Microsoft Cloud for Sustainability api (pregled), uključujući proračune, nisu specifični saveti ili preporuke. Informacije i izraženi stavovi mogu se promeniti bez prethodne najave. Microsoft Cloud for Sustainability API (pregled) je obezbeđen onako kako jeste, bez ikakvog zastupanja ili garancije bilo koje vrste, izražene ili podrazumevane, uključujući bez ograničenja bilo kakve zastupnike ili odobrenja u vezi sa korišćenjem, rezultatima ili performansama API -a Microsoft Cloud for Sustainability (preview), njegovom prikladnošću, tačnošću, odgovornošću ili ispravnošću. Ceo rizik u korišćenju API-ja Microsoft Cloud for Sustainability (preview) pretpostavljate vi. Microsoft ne preuzima odgovornost za korišćenje API-ja Microsoft Cloud for Sustainability (preview). Microsoft ni u kom slučaju neće biti podložan dodatnoj direktnoj ili indirektnoj šteti, uključujući bilo kakvu izgubljenu dobit, izgubljenu ušteđevinu ili bilo kakvu slučajnu ili posledičnu štetu nastalu usled bilo kakvih nedostataka ili upotrebu ili nemogućnost Microsoft Cloud for Sustainability korišćenja API-ja (preview), čak i ako je korporaciji Microsoft savetovana mogućnost takve štete.

Pogledajte i ovo

Microsoft Cloud for Sustainability API OData upit primeri
Microsoft Cloud for Sustainability API metodologije izračunavanja
Microsoft Cloud for Sustainability API