Cloud for Sustainability API (aurreargitalpen) ikuspegi orokorra

Microsoft Cloud for Sustainability Tech Summit 2024ko azaroa.

Garrantzitsua

Aurreargitalpen bertsioaren zati gisa erabilgarri dago funtzionaltasun hori guztia. Edukia eta funtzionalitatea aldatu egin daitezke.

Microsoft Cloud for Sustainability APIak eskaintzen ditu zure Azure eta Microsoft 365 erabilerarekin erlazionatutako isurien datuak atzitzeko.

karbono-kontabilitate zehatzak bazkide, saltzaile eta hornitzaileen informazio ona behar du. Cloud for Sustainability APIek gardentasuna ematen dizu Azure eta zure erabilerak sortutako karbono-isuriei buruz Microsoft 365. Microsoft-en karbono-kontabilitate hiru isuri-esparruetan hedatzen da hirugarrenek baliozkotutako metodologia batekin. karbono-kontabilitate koherentea eta zehatza erabiltzen du Azure eta Microsoft 365 bezeroen ingurumen-aztarnaren eragina kuantifikatzeko.

APIaren xehetasunak Microsoft Cloud for Sustainability API erreferentzian ageri dira. Eragiketei, parametroei eta erantzunen inguruko informazio osagarria biltzen dute.

Garrantzitsua

Microsoft Cloud for Sustainability APIa aurreargitalpen-en dago une honetan eta alda daiteke. Baliteke zure isurien zifra historikoak ere eguneratzea, Microsoft-ek datuen zehaztasuna eta osotasuna hobetzen dituen heinean. Aurreargitalpen hau ez dago lege-betetze, marketin edo txostenetarako helburuetarako.

Hasi Cloud for Sustainability APIekin

Oharra

Zure erakundeak Microsoft Cloud for Sustainability APIra (aurreargitalpen) sarbidea lortu nahi badu, bidali izena emateko inprimaki hau.

Hasi APIekin prozedura hauekin:

Onartutako kontuak

  • Azure: Microsoft Cloud for Sustainability Azurerako APIek Microsoft-ekin zuzeneko fakturazio harremanak dituzten EA Direct, MCA eta MPA kontuak onartzen dituzte. Cloud Solution Provider (CSP) Azure erosten duten bezeroek ez dute onartzen eta zuzenean beren CSPrekin lan egin behar dute hodeiko emisioei buruz ikasteko. Ez dira onartzen antzinako kontuak, kredituetan oinarritutako kontuak, Txinako matrikulak eta Azure Government kontuak. Zure kontu mota egiaztatzeko, joan Egiaztatu zure kontu mota atalera.

    Oharra

    Azure Hybrid Benefit erabilera ez da isurietan jasotzen edo islatzen.

  • Microsoft 365: Microsoft Cloud for Sustainability Microsoft 365 Microsoft 365 edo Office 365-rako enpresen, enpresen edo hezkuntza-harpidetzak onartzen dituzten APIak. Ez dira onartzen nazio/eskualdeetako hodei inplementazioak, besteak beste, Microsoft-en AEBetako Gobernuaren hodeiak eta Office 365 21Vianet-ek kudeatzen dituena barne.

Hasi saioa eta sortu instantzia bat

Microsoft-en Microsoft Cloud for Sustainability APIetarako sarbidea jaso ondoren, hasi saioa zure Azure Microsoft Entra ID kredentzialekin.

Instantzia bat sortu behar duzu Microsoft Cloud for Sustainability APIetara sartzeko. Instantzia sortuz gero, instantzia horren administratzaile bihurtzen zara. Instantziaren administratzaileak erabiltzaileak, taldeak eta aplikazioak gehi ditzake instantzian.

Ikusi bideo hau Cloud for Sustainability APIak eta ataria erabiltzeari buruzko ikuspegi orokorra lortzeko:

Konfiguratu datu-iturriak eta gaitu APIak

Garrantzitsua

Zure erakundearen datuetarako sarbidea behar bezala gaitzeko, urrats hau dagokion administratzaileak egin behar du. Azure MCA kontuetarako, fakturazio kontuaren irakurle, laguntzaile edo jabe gisa rola duen fakturazio-kontuaren administratzailea behar da. Azure EA kontuetarako, enpresa-administratzailea edo enpresa-administratzailea behar da - irakurtzeko soilik. Egiaztatu zure rola Azure atarian. Microsoft 365rako, eginkizun hauetako bat behar da: Exchange administratzailea, Skype for Business administratzailea, SharePoint administratzailea, irakurle globala, txostenen irakurlea. Azure eta Microsoft 365 administratzaileek instantziak sor ditzakete edo instantzietara gehitu datu iturriak gaitzeko eta APIa gaitzeko. Datuak gaitzeko beharrezko administratzaile-funtziorik ez baduzu, APIa araka dezakezu demo-datuak soilik erabiliz.

  1. Datu-iturriak fitxan, aktibatu konexioa aktibatu Azure edo Microsoft 365 emisioak konektatzeko datuak. Ziurtatu egoera Eskuragarri gisa zerrendatuta dagoela APIak erabili aurretik. Ekintza honek sarbidea daukazun matrikula edo fakturazio-kontu guztiei lotutako isurketen datuak gaitu. Ez baduzu igorpenen datuetarako sarbiderik, jarraitu demo-datuekin soilik.

    Oharra

    Baliteke 48 ordu behar izatea Microsoft 365 isurien datuak datu-iturburu gaitu ondoren eskuragarri egon daitezen. Microsoft 365 datu-iturburu desgaituz gero, behin betiko ezabatuko dira Microsoft 365 isurien datu historikoak.

    Datu-iturburuak.

  2. Hautatu APIen kudeaketa fitxa eta, ondoren, hautatu Gaitu.

    APIa gaituz gero, lehen eta bigarren mailako API gakoak sortzen dira zure instantzia API-eskaeretan erabiltzeko. Teklak birsortzeko, hautatu Freskatu ikonoa. . Gakoak kopiatzeko, hautatu Kopiatu ikonoa. .

Hodeia Iraunkortasunerako APIra deitzeko aplikazio bat konfiguratzea interesatzen zaizu? Ikusi demo hau:

Saiatu APIak

APIaren kudeaketa fitxan, hautatu Probatu APIa OData eta esportatu APIak arakatzeko. Kontsultatu interaktiboki isurketen datuak latentzia baxuko OData APIak zure paneletara konektatuz. Edo, egin zure prozesatze masiboa zure isurien datuak zuzenean zure Azure Data Lake Storage esportazio APIak erabiliz transferituz. Garatzaileen atari bat fitxa berri batean irekitzen da, non eskaera eta erantzun eskemak arakatu eta Microsoft Cloud for Sustainability APIen aurka zuzeneko eskaerak egiteko.

Probatu OData APIak

  1. Ezkerreko nabigazioan, ziurtatu Taldeka etiketaz gaituta dagoela eta hautatu OData taldekatzea Azure eta< berrikusteko. a38> Microsoft 365 OData APIak.

  2. Zuzeneko eskaera bat egiteko, hautatu Probatu. Sartu beharrezko eremu guztiak:

    • Baimena: automatikoki betetako baimen-tokena
    • Harpidetza-gakoa: API-kudeaketa fitxako API gakoarekin automatikoki betetzen da.
    • enrollmentId: zure matrikularen IDa, fakturazio kontuaren ID gisa ere ezaguna. Azure bakarrik. Ez baduzu matrikularako sarbiderik, APIa araka dezakezu demo datuak erabiliz, eremu honetan demodata idatzita.
    • instanceId: Microsoft Cloud for Sustainability API atariaren URLan aurkitu da
    • tenantId: Microsoft 365 errenter ID.

    Probatu orria.

  3. Gehitu beharrezko kontsulta-parametro guztiak. Joan alboko panelaren behealdera eta hautatu Bidali. HTTP erantzun panelaren behealdean bistaratzen da.

Ikusi bideo hau OData-rekin Cloud for Sustainability APIei buruz gehiago jakiteko:

Saiatu Esportatu APIak

  1. Ezkerreko nabigazioan, ziurtatu Taldeka etiketa gaituta dagoela eta hautatu Esportatu taldekatzea emisioak eta erabilera esportatzen hasteko. datuak zure data Lake-ra. Hautatu ExekutatuExportJob.

  2. Hautatu Probatu. Sartu beharrezko eremu guztiak eta hautatu Bidali.

    • Baimena: automatikoki betetako baimen-tokena
    • Harpidetza-gakoa: API-kudeaketa fitxako API gakoarekin automatikoki betetzen da.
    • instanceId: Microsoft Cloud for Sustainability API atariaren URLan aurkitu da
    • exportJobType: Hautatu Azure edo Microsoft 365 datu-iturburu isurpenen eta erabilera-datuen esportatzeko datu-iturburu izendatzeko.
    • demodata: Idatzi "egia" funtzionalitate hau arakatu nahi baduzu demo datuak esportatuz.
  3. Bidali hautatu ondoren, joan behera HTTP erantzun ikusteko. Azure datuak esportatzen ari bazara, erantzun-ek esportatutako datuen matrikula-IDak zerrendatzen ditu. Azure edo Microsoft 365 datuetarako sarbiderik ez baduzu, eragiketa honek ez du arrakastarik izango. Ziurtatu zure datu-iturriak behar bezala konfiguratu dituzula.

    Hasieran, erantzun-ek lana Hasi gabe dela adierazten du. Esportazio lanak 2-3 minutu behar ditu burutzeko, eta lanaren IDa erabil dezakezu esportazioaren egoera egiaztatzeko ExportJobStatus APIa erabiliz. Ziurtatu lanak arrakasta izan duela, eta horrek adierazten du esportatutako datuak orain erabilgarri daudela faseko blob biltegian.

    LatestExportJob erabili dezakezu zure azken esportazio-lanari buruzko informazioa berrikusteko.

    ExportJobs APIa erabil dezakezu esportazio historikoei buruzko informazioa berrikusteko.

  4. Erabili ExportLocation APIa SAS URLa lortzeko. SAS URLa ordubete igaro ondoren iraungiko da. Kopiatu SAS URLa eszenaratzeko blob biltegitik esportatutako datuetara atzitzeko.

  5. Datuak esportazio-lana exekutatu eta 28 egunera iraungiko dira eta iraungi baino lehen kopiatu behar dira. Bestela, datuak eszenatze-kokapenetik ezabatzen dira. Erabiltzaileek esportazio-lan bat berriro exekutatu dezakete edozein unetan, 28 eguneko iraungipena duen beste datu sorta bat lortzeko eta datu-multzo berriena barne. Esportatutako datuetara sartzeko modu batzuk daude.

    1. Azure Storage arakatzailea

      Instalatu eta ireki Azure Storage Explorer. Hautatu Ireki Konektatzeko elkarrizketa botoia eta, ondoren, hautatu ADLS Gen2 edukiontzia edo direktorioa. Hautatu Sarbide partekatuko sinadura URLa (SAS) eta itsatsi urrats 4-ko SAS URLa Blob edukiontzi edo direktorioko SAS URL n. a40> sarrera. Hautatu Hurrengoa eta gero hautatu Konektatu. Biltegiratze-kontu berri batean edo lehendik dagoen edukiontzi bat aurkitu edo sortu behar duzu esportatutako datu hauek gordetzeko erabiltzeko. Kopiatu Azure edo Microsoft 365 datuak eszenaratzeko blob biltegitik eta itsatsi nahi duzun edukiontzian.

    2. Erabili azcopy. Urrats 4-ko SAS URLa eta esportatutako isuriak gordetzen ari zaren biltegiratze-kontuaren URLa erabiliz (helmuga URLa), exekutatu azcopy.exe komandoa:

      • azcopy login
      • azcopy list <SAS URL>
      • azcopy cp <SAS URL> <destination URL>
    3. Spark gidoia

      Erabili mssparkutils in Microsoft Fabric edo Synapse. Liburutegi eta ingurune alternatiboak erabiltzea aukera dezakezu.

      Python
      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)
      

Lagin-kontsultak

APIekin lan egiteko OData lagin-kontsulten zerrenda laburra lortzeko, joan OData-ren kontsulta-adibideetara.

Esleitu baimenak

Microsoft Cloud for Sustainability APIetarako sarbidea zure erakundeko erabiltzaileei mugatuta dago instantzia baten administratzaileak aplikazioan gehitzen dituenak. Erabiltzaile bat erabiltzaile, talde edo aplikazio bakarra izan daiteke. Gonbidatuen kontuak ez dira onartzen. Esleitu ditzakezun hiru rol mota daude:

  • Ikuslea: Microsoft Cloud for Sustainability APIaren orrialde guztiak ikus ditzake.
  • Laguntzailea: Microsoft Cloud for Sustainability API atariko orrialde guztiekin elkarreragin dezake. Ezin dira erabiltzaileak gehitu edo kendu.
  • Administratzailea: erabilgarri dauden baimen guztiak, erabiltzaileak gehitzeko edo kentzeko gaitasuna barne.

Oharra

Kolaboratzaileek eta administratzaileek ezin dute desgaitu edo gaitu Microsoft 365 datu-iturburu Exchange administratzailea, Skype for Business administratzailea, SharePoint administratzailea, Global reader edo Report reader ez badira.

Erabiltzaileak, taldeak edo aplikazioak administratzaile gisa gehitzeko:

  1. Hautatu Baimenak fitxa, eta, ondoren, hautatu Gehitu erabiltzaileak.
  2. Erabili Bilaketa eremua gehitu nahi duzun Microsoft Entra ID erabiltzailea, aplikazioa edo taldea aurkitzeko.
  3. Hautatu rol-esleipena eta, ondoren, hautatu Gorde.

Instantziak

Nabigatu instantziaren ikonora Instantziaren ikonoa instantzia guztien zerrenda aurkitzeko, instantziak sortzeko edo instantziak kentzeko.

Ikusi APIaren erabilera

Ikusi zure denbora errealeko APIaren erabilerari buruzko xehetasunak.

  1. Nabigatu APIen kudeaketa fitxara eta, ondoren, hautatu Erabilera.
  2. Hautatu ikusteko denbora tarte bat.

API erabilera-orriak hiru atal ditu:

  • API deiak: hautatutako denbora-tartean APIra egindako dei-kopuru agregatua bistaratzen duen grafikoa.
  • Datu-transferentzia: hautatutako denbora-tartean APIaren bidez transferitutako datu kopurua erakusten duen grafikoa.
  • Eragiketak: erabilgarri dagoen API eragiketa bakoitzaren errenkadak eta eragiketen erabilerari buruzko xehetasunak dituen taula.

FAQa

Nola kalkulatzen ditu Microsoft-ek APIak eskuragarri jartzen dituen hodeiko karbono-isuriak?

Microsoft-en kalkulu-metodologiari buruzko informazio gehiago lortzeko, joan Microsoft Cloud for Sustainability API kalkulu-metodologiara.

Non lor dezaket OData-rekin kontsultak idazteari buruz?

OData-ri buruzko informazio gehiago lortzeko, joan Kontsulta aukeren ikuspegi orokorrara.

Non gordetzen dira txosten hau egiteko erabilitako datuak?

Datuak Estatu Batuetan gordetzen dira.

Zergatik ezin ditut ikusi aurreko hilabeteko isurien datuak?

Hilabete jakin bateko isurien datuak hilabete hori amaitu ondorengo 14. egunean egongo dira eskuragarri (lanegunak ez diren egunak barne).

Ezin dut instantziarik sortu. Zergatik?

Baliteke Cloud for Sustainability API atarira sartzen saiatzen ari zarela barneratzeko inprimakian ematen den ostalari maizterraren ID ezberdin batekin lotutako kontu batekin. Egoera hau gerta daiteke gonbidatu kontu bat erabiltzen duzunean. Gonbidatuen kontuak ez dira onartzen. Beste maizterren bat ontziratu nahi baduzu, bidali berriro sartzeko inprimakia.

Maizterraren ID desberdina dut Microsoft 365 eta Azurerentzat. Oraindik erabil al dezaket Microsoft Cloud for Sustainability APIa?

Oraindik ere sar zaitezke APIetara, baina atariak ez ditu hainbat maizter onartzen instantzia bakoitzeko. Maizter hauek APIetan txertatu behar dituzu bereizita.

Nola konfigura dezaket aplikazio bat Microsoft Cloud for Sustainability APIra deitzeko?

Hodeia Iraunkortasunerako APIra deitzeko aplikazio bat konfiguratzea interesatzen zaizu? Ikusi demo hau:

Azure atarian, joan zure Microsoft Entra IDra, hautatu Aplikazioen erregistroak eta gero . + Erregistro berria. Erregistro-orri berrian, eman izena zure aplikazioa erregistratzeko, pertsonalizatu aukerak zure beharretara eta, ondoren, hautatu Erregistratu. Joan Microsoft Entra ID orrira, hautatu Enpresa aplikazioak blade, ezarri Aplikazio mota izan Microsoft Applications eta bilatu aplikazioaren izenaren arabera MCFS SDS. Sartzean beharrezkoa den New-AzADServicePrincipal komandoan pasatu duzun ApplicationId parametroa Microsoft Cloud for Sustainability APIaren (c3163bf1-092f-436b-b260-7ade5973e5b9) aplikazioaren IDa da, zeinarekin sortu zenuen Microsoft Cloud for Sustainability API aplikazioaren erregistroa zure maizterrean.

Hori eginda, aplikazioa erregistratzeko orrira joan eta API baimenak blade hauta dezakezu. Zure aplikazioa erregistratzeko baimena gehitzeko Microsoft Cloud for Sustainability APIra deitu ahal izateko, hautatu + Gehitu baimena, eta ondoren . a53>Nire erakundeak erabiltzen dituen APIak aukera. Ondoren, bilatu Microsoft Cloud for Sustainability APIaren ApplicationId (c3163bf1-092f-436b-b260-7ade5973e5b9), hautatu MCFS SDS eta, ondoren, hautatu App.Emissions.Irakurri baimena Aplikazioen baimenak blade.

Aplikazio mota honen baimena administratzailearen baimena eman behar da Eman administratzailearen baimena {your-tenant} hautatuta.

Azkenik, bisitatu Microsoft Cloud for Sustainability APIaren hasierako orrira, nabigatu Baimenak bladera eta, ondoren, hautatu + Gehitu. Agertzen den alboko panelean, aukeratu Ikuslea Erabiltzaile, Talde edo Aplikazioaren sarrerako rol gisa eta jarraitu zure aplikazioaren erregistroa bilatzen. Hautatu Gorde.

Nire aplikaziorako sarbide-token bat lortzen ari naiz, zein da baliabidearen URLa?

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

Zenbat datu historiko daude eskuragarri?

  • Azure: erabilera eta isurketen datuek matrikularekin lotutako azken bost urteetako datuak hartzen dituzte.
  • Microsoft 365: Isurien datuek Microsoft 365 harpidetzari lotutako azken 12 hilabeteetako datuak hartzen dituzte.

Ezespena

Microsoft Cloud for Sustainability APIa (aurreargitalpen) zerbitzarien karbonoa kalkulatzeko industriako estandarretan oinarritzen da. Estimazio orokorrak eskaintzen ditu erakundeei Azure hodeiko zerbitzuen erabilerarekin lotutako IT azpiegituraren karbono isuriei buruzko ikuspegia lortzen laguntzeko. Microsoft Cloud for Sustainability APIarekin (aurreargitalpen) aurkezten diren aurkikuntzak, interpretazioak eta ondorioak, kalkuluak barne, ez dira aholku edo gomendio zehatzak. Adierazitako informazioa eta iritziak jakinarazi gabe alda daitezke. Microsoft Cloud for Sustainability APIa (aurreargitalpen) dagoen moduan ematen da, inolako adierazpenik edo bermerik gabe, adierazi edo inplizituan, erabilera, emaitzei edo errendimenduari buruzko adierazpenak edo abalak barne. Microsoft Cloud for Sustainability APIaren (aurreargitalpen), egokitasuna, zehaztasuna, fidagarritasuna edo zuzentasuna. Microsoft Cloud for Sustainability APIa (aurreargitalpen) erabiltzeko arrisku osoa zuk hartzen duzu bere gain. Microsoft-ek ez du bere gain hartzen Microsoft Cloud for Sustainability APIa (aurreargitalpen) erabiltzearen erantzukizuna. Microsoft ez da inolaz ere erantzukizunik izango zuzeneko edo zeharkako beste kalte batzuen erantzule, besteak beste, etekinak, galdutako aurrezkiak edo edozein akatsen ondorioz sortutako gorabehera edo ondoriozko kalteak, edo Microsoft Cloud for Sustainability APIa erabiltzea edo erabiltzeko ezintasuna ( aurreargitalpen), Microsoft-i kalte horiek gerta daitezkeela jakinarazi badute ere.

Microsoft Cloud for Sustainability API OData kontsultaren adibideak
Microsoft Cloud for Sustainability API kalkulatzeko metodologia
Microsoft Cloud for Sustainability API