Bemærk
Adgang til denne side kræver godkendelse. Du kan prøve at logge på eller ændre mapper.
Adgang til denne side kræver godkendelse. Du kan prøve at ændre mapper.
[Denne artikel er dokumentation til en foreløbig version og er med forbehold for ændringer.]
Få mere at vide om, hvordan du indsender, poller og downloader Copilot kreditforbrugsrapporter med Power Automate, kommandolinjegrænsefladen for Power Platform og PowerShell og derefter reagerer på rapportrækkerne.
API'et til Copilot-kreditforbrugsrapporter giver dig mulighed for at downloade de samme Copilot-kreditberettigelses- og forbrugsdata, der er tilgængelige i Power Platform Administration Center. Brug disse data til at automatisere beslutninger, kombinere dem med andre datakilder eller vedligeholde en langsigtet historik ud over det 30-dages rapporteringsvindue.
Vigtig
Brugsrapporter-API'en er i en offentlig prøveversion. Nationale cloudmiljøer understøttes ikke i øjeblikket. Prøveversionsfunktioner er ikke beregnet til produktionsbrug og kan have begrænset funktionalitet. Prøveversionsfunktioner er underlagt separate supplerende vilkår for anvendelse
Oprettelse af rapporter er asynkron. Hver klient i dette selvstudium følger de samme tre trin:
-
Send en rapportanmodning. Tjenesten returnerer
202 Acceptedmed enLocationheader (URL-adressen for handlingsstatus) og enRetry-Afterheader. -
Afstem handlingen, indtil den
statuserSucceededellerFailed. Følg det pollinginterval, der er angivet afRetry-After. Status-API'en returnerer200 OK, selvom oprettelsen er i gang (status: Running), så kontrollér svarteksten i stedet for at behandle HTTP 200 som en bekræftelse på, at rapporten er klar. -
Download den genererede fil, og iterér derefter gennem rækkerne. REST-eksemplet følger handlingssvarets
LocationURL-adresse. Connector- og CLI-eksemplerne sender det returneredefileNametil deres downloadhandling eller -kommando.
I dette selvstudium lærer du, hvordan du kan:
- Download en forbrugsrapport i arbejdsprocesser i Power Automate eller Copilot Studio ved hjælp af de samme forbindelseshandlinger og trin i Power Platform for Admins V2.
- Download en forbrugsrapport fra PowerShell ved hjælp af Power Platform CLI (
pac). - Hent en forbrugsrapport fra PowerShell ved at kalde Power Platform-API'en direkte.
Vælg en rapport
Alle eksempler i dette selvstudium bruger FeatureDetailsPerResource som standard rapporten med Summary granularitet og anmoder om de forrige 14 hele UTC-dage, der slutter i går (UTC). Vælg en anden rapport eller granularitet efter behov.
| Report | Brug det til at | Kolonner for kredit |
|---|---|---|
FeatureDetailsPerResource |
Få vist Copilot Kreditforbrug efter agent eller ressource, miljø, produkt og funktion. |
BilledCredits, NonBilledCredits |
BillingDetailsPerEnvironment |
Få vist rettighed og forbrug efter miljø, rettighed og faktureringspolitik, herunder forbrug af forudbetalte og betalt efter forbrug. |
CapacityPackCreditsConsumed, PayGoConsumedQuantity |
| Granularitet | Returnerede rækker |
|---|---|
Daily |
Én række pr. dag for hver kombination af rapportdimensioner. Indeholder datokolonnen. |
Summary |
Forbrug, der er opsummeret på tværs af de ønskede datoer for hver kombination af rapportdimensioner. Datokolonnen er udeladt. |
Du kan se en komplet liste over kolonner i hver rapport under Download licensrapportfil: Rapportfilskemaer.
Bemærkning
Der skelnes mellem store og små bogstaver i kolonnenavne i både CSV- og JSON-output. Du kan f.eks. læse agent-id'et som ResourceID, agentnavnet som ResourceName og fakturerede kreditter som BilledCredits. Tærskeleksemplerne evaluerer hver rapportrække uafhængigt af hinanden; De aggregerer ikke alle rækker for en agent.
Forudsætninger
- En Microsoft Entra brugerkonto med en af disse roller i din tenant: Global Administrator, Power Platform-administrator eller Dynamics 365 Administrator. Api'en til forbrugsrapporter understøtter kun delegeret (bruger)godkendelse; programtokens (tjenesteprincipal) understøttes ikke.
- Copilot-forbrug af kreditter i din tenant inden for det valgte tidsinterval.
- Værktøjerne for den kunde, du vælger:
| Klient | Det skal du bruge |
|---|---|
| Power Automate | En Power Automate-licens, der indeholder standardforbindelser, og tilladelse til at oprette en Power Platform for Admins V2-forbindelse med godkendelsestypen OAuth Connection. |
| Copilot Studio arbejdsprocesser | Adgang til Copilot Studio med tilladelse til at oprette arbejdsprocesser, en Power Platform for Admins V2-forbindelse med godkendelsestypen OAuth Connection og tilstrækkelige Copilot Credits til at køre arbejdsprocessen. |
| Power Platform CLI | PowerShell 7 og den nyeste Microsoft Power Platform CLI. |
| PowerShell (REST) | PowerShell 7 og Azure CLI. |
Håndter svar på tjenestebeskyttelse
Rapportindsendelser kan returnere 429 Too Many Requests, når tjenestebeskyttelse gennemtvinges. En afvist afsendelse starter ikke en rapport.
Sådan reducerer du unødvendige indsendelser:
- Planlæg rapporter (f.eks. én gang om dagen eller en gang om ugen) i stedet for at generere dem efter behov i en stram løkke.
- Genbrug en downloadet fil i stedet for at sende den samme rapport igen.
- Hvis tjenesten leverer
Retry-Afteret429svar, skal du vente mindst så længe, før du indsender en anden anmodning.
Du kan finde flere oplysninger under Generér licensrapport: Grænser for beskyttelse af tjenester i hele lejeren.
Download en forbrugsrapport, og handl på resultaterne
Brug fanerne i følgende afsnit til at vælge en klient. Hvert eksempel sender en FeatureDetailsPerResource anmodning, poller, indtil handlingen er fuldført, downloader filen og viser derefter hver række, hvor BilledCredits plus NonBilledCredits er større end 1.000. Tærsklen gælder for individuelle rækker, ikke akkumuleret forbrug pr. agent. Der vælges f.eks. ikke to rækker med 600 kreditter for den samme agent, selvom deres samlede total er 1.200. Separate rækker kan repræsentere forskellige produkter, funktioner, kanaler, videnkilder, værktøjer, modeller, scenarier eller miljøer.
- Copilot Studio arbejdsprocesser og Power Automate cloudflow
- Kommandolinjegrænseflade for Power Platform
- PowerShell (REST)
Bemærkning
En ny handling for Power Platform for Admins V2-connectoren er planlagt til at blive udrullet i december 2026. Den kombinerer indsendelse af rapportanmodninger, statusforespørgsel og download af rapporter i en enkelt handling for både Power Automate og Copilot Studio arbejdsprocesser, hvilket fjerner behovet for at administrere afstemninger i arbejdsprocessen.
Bemærkning
Understøttelse af anmodning om rapporter i JSON-format via connectoren er også planlagt til at blive udrullet i december 2026. Connectoren genererer i øjeblikket rapporter i CSV-format som standard. Det JSON-baserede connectoreksempel nedenfor kræver denne kommende support.
I dette eksempel oprettes et planlagt cloudflow, der kører hver mandag, downloader en rapport for de forrige 14 hele UTC-dage og sender en mail til en tabel med agenter, hvis rapportrækker overskrider forbrugsgrænsen. Der bruges tre handlinger fra connectoren Power Platform for Admins V2.
Trinene i følgende afsnit gælder for både Copilot Studio arbejdsprocesser og Power Automate cloudflows. Instruktionerne til oprettelse af flowet bruger navigationen i Power Automate. Hvis du bruger Copilot Studio, skal du oprette en planlagt arbejdsproces der og derefter følge de samme trin for at konfigurere variabler, connectorhandlinger, udtryk, betingelser og rapportbehandling. Generér licensrapport returnerer det indledende afsendelsessvar uden automatisk forespørgsel. flowet administrerer efterfølgende forespørgsler eksplicit.
| Trin | Forbindelseshandling |
|---|---|
| Indsend | Generér licensrapport |
| Afstemning | Status for handlingen "Hent licensrapport" |
| Hent | Hent licensrapportfil |
Flowet forespørger den samme handling i en Do until-løkke . Efter hver poll kontrollerer en betingelse, om status er Running. Det er kun forgreningen for den pågældende status, der læser forespørgselssvarets Retry-After header og venter før den næste gentagelse. En status for Succeeded eller Failed afslutter løkken uden en anden forsinkelse. Løkken kontrollerer svarteksten og kræver ikke, at statusendepunktet returnerer HTTP 202.
Hvis du er ny i Power Automate, kan du se Kør flow efter en tidsplan.
Trin 1: Opret flowet og variablerne
Log på Power Automate, og vælg derefter Opret>planlagt cloudflow.
Navngiv flowet Ugentlig Copilot-kreditrapport, angiv det til at gentage hver 1. uge på mandag, og vælg derefter Opret.
Tilføj tre handlinger af typen Initialize variable:
Name Type Værdi StartDateStreng formatDateTime(addDays(utcNow(),-14),'yyyy-MM-dd')EndDateStreng formatDateTime(addDays(utcNow(),-1),'yyyy-MM-dd')CreditThresholdFloat 1000Angiv datoværdierne som udtryk. Tilsammen anmoder de om de forrige 14 fulde UTC-dage.
Trin 2: Send rapportanmodningen, og registrer operationen
Tilføj handlingen Power Platform for Admins V2>Generér licensrapport. Når du bliver bedt om det, skal du oprette en forbindelse med godkendelsestypen OAuth-forbindelse og logge på med en konto, der har en af de påkrævede roller.
Angiv parametrene:
Parameter Værdi Rapportnavn FeatureDetailsPerResourceApi-version 2024-10-01startDate StartDatevariabelslutdato EndDatevariabelgranularitet Summaryformat jsonGenerér licensrapport sender anmodningen og returnerer
202 Acceptedmed start-LocationogRetry-After-headeren. Den poller ikke handlingen.Bekræft, at handlingens output indeholder de indledende afsendelsesheadere, før du fortsætter. Hvis handlingen i stedet returnerer et senere handlingsstatussvar uden operationens URL, skal du stoppe og kontrollere connectorversionen og svarhåndteringen; de eksplicitte forespørgselstrin kræver den indledende
Location.Efter afsendelseshandlingen skal du tilføje handlingen Compose med navnet Rapportér operations-URL:
coalesce(outputs('Generate_Licensing_Report')?['headers']?['Location'],outputs('Generate_Licensing_Report')?['headers']?['location'])Tilføj en Compose-handling med navnet Rapportér handlings-id:
last(split(uriPath(outputs('Report_operation_URL')),'/'))Dette udtrækker handlings-id'et fra den returnerede URL-adresse for connectorens parameter Operation ID. Behold den oprindelige URL-adresse til fejlfinding eller genoptagelse af operationen. Opret ikke en ny URL-adresse, eller send en ny rapport ved hver forespørgsel.
Tilføj en forsinkelseshandling med navnet Indledende ventetid for rapport. Angiv Enhed til Sekund og Antal til:
int(coalesce(outputs('Generate_Licensing_Report')?['headers']?['Retry-After'],outputs('Generate_Licensing_Report')?['headers']?['retry-after']))Den indledende værdi for
Retry-Afterer som standard300sekunder (fem minutter). Brug den værdi, der returneres af tjenesten; den angiver, hvornår der skal polles, ikke hvor lang tid genereringen tager. API'en leverer et numerisk interval i sekunder. Hvis headeren mangler eller er forkert udformet, skal du undersøge svaret i stedet for at erstatte en forsinkelse på nul sekunder.
Tips
Hvis kørselshistorikken viser en 429 status for Generér licensrapport, skal du ikke sende den igen med det samme. Hvis svaret indeholder Retry-After, skal du vente mindst så mange sekunder, før du kører flowet igen.
Trin 3: Poll, kontrollér status, og vent kun, mens den kører
Efter Indledende rapportventetid skal du tilføje kontrolelementet Do until. Indstil den venstre værdi til:
body('Feature_Poll_Status')?['status']Vælg er ikke lig med, og angiv
Runningtil højre. Api'ens nøjagtige igangværende værdi erRunning, ikkeInProgressellerIn Progress. En Gør indtil kører handlingerne, før denne afslutningsbetingelse evalueres.I kontrolelementets Parametre>> skal du angive Antal til og
120tilPT2H. Disse grænser forhindrer uendelig polling; De garanterer ikke, at oprettelse af rapporter afsluttes inden for disse grænser.I Do until skal du tilføje Power Platform for Admins V2>Get Licensing Report Operation Status og omdøbe den til Pollingstatus for funktion:
Parameter Værdi Rapportnavn FeatureDetailsPerResourceOperations-id outputs('Report_operation_ID')Api-version 2024-10-01Umiddelbart efter Feature Poll Status, der stadig er inden for løkken, skal du tilføje en Condition med navnet Feature Wait If Running. Sammenlign dette udtryk med teksten
Runningved hjælp af er lig med:body('Feature_Poll_Status')?['status']I forgreningen Sand skal du tilføje en Delay med navnet Feature Poll Delay. Angiv Enhed til Sekund og Antal til:
int(coalesce(outputs('Feature_Poll_Status')?['headers']?['Retry-After'],outputs('Feature_Poll_Status')?['headers']?['retry-after']))Læs headeren fra den seneste polling, ikke den første indsendelse: Det anbefalede interval kan ændres. Hvis et
Runningsvar ikke har et gyldigt interval, skal du stoppe og undersøge svaret i stedet for at forespørge i en tæt løkke.Lad forgreningen False være tom. Når betingelsen er afsluttet, kontrollerer Do until den seneste status:
Runninggentager statuskontrollen efter forsinkelsen; alle andre værdier fortsætter til kontrollen af terminalstatus.
Løkkelayoutet er Feature Poll Status>Feature Wait If Running>True: Feature Poll Delay / False: ingen handlinger, der svarer til den samme logik for afstemningskontrol, som bruges af PowerShell REST-eksemplet. HTTP 200 betyder, at statusanmodningen lykkedes, ikke at rapporten er klar.
Trin 4: Kontrollér status for fuldført rapport
Efter Gør indtil skal du tilføje en betingelse uden for løkken. Angiv den venstre værdi til dette udtryk, vælg er lig med, og angiv den højre værdi til udtrykket
true:and(equals(body('Feature_Poll_Status')?['status'],'Succeeded'),not(empty(body('Feature_Poll_Status')?['fileName'])))Kontrollér den returnerede rapportstatus, selvom selve handlingen viser Lykkedes. Fortsæt kun, når oprettelsen lykkedes, og der findes et filnavn.
I forgreningen False skal du tilføje handlingen Terminate med Status = Failed. Angiv Meddelelse til dette udtryk:
if(empty(body('Feature_Poll_Status')?['error']),concat('Report generation did not return Succeeded with a file name. Status: ',string(body('Feature_Poll_Status')?['status'])),string(body('Feature_Poll_Status')?['error']))En
Failedrapportoperation kan ikke genoptages. Denne kontrol mislykkes også, hvis status mangler eller er uventet, eller hvis status erSucceeded, men der ikke findes noget filnavn. Hvis en løkkegrænse nås, mens rapporten stadig erRunning, skal du ikke downloade rapporten eller straks sende en anden anmodning. Hvis indsendelse, forespørgsel eller en forsinkelse mislykkes, eller hvis løkken får timeout, springes efterfølgende handlinger, der kræver succes, over. Undersøg kørselsoversigten, og bevar handlingens URL, før du prøver igen eller genoptager.
Trin 5: Hent rapporten
I forgreningen True i betingelsen:
Tilføj Power Platform for Admins V2>Download licensrapportfil:
Parameter Værdi Rapportnavn FeatureDetailsPerResourceFilnavn body('Feature_Poll_Status')?['fileName']Api-version 2024-10-01Tilføj en Parse JSON-handling, omdøb den til Parse report JSON, og brug følgende for Indhold:
body('Download_Licensing_Report_File')Brug følgende skema, der dækker alle 18 eksporterede egenskaber i rapportrækkefølgen.
ConsumptionDateer til stede forDailyrapporter og udeladt forSummaryrapporter, så det er ikke påkrævet. Roden kan være en tom matrix, men hver returnerede række skal indeholde numeriske værdier forBilledCreditsogNonBilledCredits. Andre strengnavne og id'er kan være null eller udeladt.{ "type": "array", "items": { "type": "object", "required": [ "BilledCredits", "NonBilledCredits" ], "properties": { "ConsumptionDate": { "type": ["string", "null"] }, "BillingPlatform": { "type": ["string", "null"] }, "EnvironmentID": { "type": ["string", "null"] }, "EnvironmentName": { "type": ["string", "null"] }, "EnvironmentType": { "type": ["string", "null"] }, "ResourceID": { "type": ["string", "null"] }, "ResourceName": { "type": ["string", "null"] }, "ResourceType": { "type": ["string", "null"] }, "Product": { "type": ["string", "null"] }, "HarnessType": { "type": ["string", "null"] }, "ScenarioName": { "type": ["string", "null"] }, "Feature": { "type": ["string", "null"] }, "Channel": { "type": ["string", "null"] }, "KnowledgeSources": { "type": ["string", "null"] }, "ToolUsed": { "type": ["string", "null"] }, "LLMModel": { "type": ["string", "null"] }, "BilledCredits": { "type": "number" }, "NonBilledCredits": { "type": "number" } }, "additionalProperties": true } }Fortolk rapport-JSON gør alle navngivne egenskaber tilgængelige som dynamisk indhold. Test med en rapport, der indeholder rækker, for at bekræfte, at alle eksporterede egenskaber er tilgængelige og udfyldt som forventet. En tom array bekræfter kun arraystrukturen. Det bekræfter ikke, at rækkeegenskaberne findes. Hvis du vil undersøge felterne sammen, skal du tilføje en midlertidig Select-handling, angive From til
body('Parse_report_JSON')og tilknytte hver navngiven egenskab for dynamisk indhold. Fjern handlingen efter validering.I nogle connector runtimes er den downloadede brødtekst en binær indpakning med
$content-typeog base64$content. I så fald skal du ændre Content til:json(base64ToString(body('Download_Licensing_Report_File')?['$content']))Base64-værdien repræsenterer HTTP-nyttedata efter standardhåndtering
Content-Encoding. Afkodning af den skal producere almindelig JSON-tekst. Base64-afkodning dekomprimerer ikke gzip-data. Hvis den afkodede værdi stadig er gzip-komprimerede binære data eller ikke er gyldige JSON, skal du stoppe flowet og undersøge, hvordan connectoren håndterer svaret.
Trin 6: Find rækker over 1.000 kreditter, og send en meddelelse
Tilføj handlingen Vælg, omdøb den til Rapportér rækker, og angiv Fra til dette udtryk:
body('Parse_report_JSON')Angiv hver værdi via udtrykseditoren, ikke som konstanttekst. I den nye designer skal du angive
/i værdifeltet og vælge Indsæt udtryk.Nøgle Værdi Agentif(empty(item()?['ResourceName']),coalesce(item()?['ResourceID'],''),item()?['ResourceName'])Agent IDcoalesce(item()?['ResourceID'], '')Environmentif(empty(item()?['EnvironmentName']),coalesce(item()?['EnvironmentID'],''),item()?['EnvironmentName'])Featurecoalesce(item()?['Feature'], '')Total creditsadd(item()?['BilledCredits'], item()?['NonBilledCredits'])Udtrykkene
if(empty(...))bruger id'et, når et visningsnavn er null eller en tom streng. Skemaet kræver, at begge kreditfelter er tal. Hvis en af værdierne mangler, er null eller er tekst, mislykkes Parse report JSON i stedet for stiltiende at behandle værdien som nul.Som et alternativ til at angive hver værdi separat skal du vælge Skift til teksttilstand i rapportrækker og indsætte dette JSON-objekt:
{ "Agent": "@if(empty(item()?['ResourceName']),coalesce(item()?['ResourceID'],''),item()?['ResourceName'])", "Agent ID": "@coalesce(item()?['ResourceID'],'')", "Environment": "@if(empty(item()?['EnvironmentName']),coalesce(item()?['EnvironmentID'],''),item()?['EnvironmentName'])", "Feature": "@coalesce(item()?['Feature'],'')", "Total credits": "@add(item()?['BilledCredits'],item()?['NonBilledCredits'])" }Angiv hver værdi som en
@expression, ikke en@{...}interpoleret streng eller konstanttekst. Efter en testkørsel skal du undersøge outputtet af rapportrækkerne og bekræfte, at Total credits er et ikke-citeret tal i stedet for en streng i anførselstegn.Tilføj en Filter array-handling, omdøb den til Rækker med højt forbrug, og angiv Fra til Output fra Report rows. Vælg Rediger i avanceret tilstand, og angiv:
@greater(item()?['Total credits'], variables('CreditThreshold'))Tilføj en betingelse , der kontrollerer, om
length(body('High_usage_rows'))er større end0. I forgreningen Sand skal du tilføje Opret HTML-tabel (Fra = Output af rækker med højt forbrug, navngivet Brødtekst i nogle designere eller udtrykketbody('High_usage_rows')) efterfulgt af Office 365 Outlook>Send en mail (V2) med HTML-tabellen i brødteksten.Vælg Gem, og vælg derefter Test>manuelt for at køre flowet nu.
Hvis Rækker med højt forbrug er tomme, springes de handlinger, der opretter HTML-tabellen og sender mailen, over. Hvis du vil teste forgreningen Sand , skal du midlertidigt sænke CreditThreshold (f.eks. til 0), mens du bruger godkendte testdata, køre flowet og derefter gendanne tærsklen til 1000.
Valgfrit: Rapportér faktureringsoplysninger efter miljø
Hvis du vil bruge BillingDetailsPerEnvironment, skal du bevare det samme flow og foretage disse ændringer:
Angiv Report Name til
BillingDetailsPerEnvironmenti alle tre connectorhandlinger: Generate Licensing Report, Get Licensing Report Operation Status (med navnet Feature Poll Status) og Download Licensing Report File. Bevar handlingsnavnene uændret, så udtrykkene stadig løses korrekt.Erstat Parse report JSON-skemaet med følgende fulde skema med 11 egenskaber.
BilledDateogAllocatedCapacityPackCreditser til stede forDailyrapporter og udeladt forSummaryrapporter. De to felter med forbrugt kredit forbliver obligatoriske tal. Strengetiketter og id'er kan være null eller udeladt.{ "type": "array", "items": { "type": "object", "required": [ "CapacityPackCreditsConsumed", "PayGoConsumedQuantity" ], "properties": { "BilledDate": { "type": ["string", "null"] }, "BillingPlatform": { "type": ["string", "null"] }, "TenantID": { "type": ["string", "null"] }, "EnvironmentID": { "type": ["string", "null"] }, "EnvironmentName": { "type": ["string", "null"] }, "EnvironmentType": { "type": ["string", "null"] }, "EntitlementID": { "type": ["string", "null"] }, "BillingPolicyId": { "type": ["string", "null"] }, "AllocatedCapacityPackCredits": { "type": "number" }, "CapacityPackCreditsConsumed": { "type": "number" }, "PayGoConsumedQuantity": { "type": "number" } }, "additionalProperties": true } }I rapportrækker skal du bevare Fra som
body('Parse_report_JSON')og bruge denne tilknytning:Nøgle Værdi Environment IDcoalesce(item()?['EnvironmentID'], '')Environmentif(empty(item()?['EnvironmentName']),coalesce(item()?['EnvironmentID'],''),item()?['EnvironmentName'])Entitlement IDcoalesce(item()?['EntitlementID'], '')Billing policy IDcoalesce(item()?['BillingPolicyId'], '')Total creditsadd(item()?['CapacityPackCreditsConsumed'], item()?['PayGoConsumedQuantity'])
Bevar det eksisterende filterudtryk for rækker med højt forbrug, betingelse, HTML-tabel og mailhandlinger. Totalen kombinerer kapacitetspakke og forbrugsbaseret forbrug for hver returnerede miljøfaktureringsrække. Disse finansieringskategorier adskiller sig fra funktionsrapportens fakturerede og ikke-fakturerede kreditklassificeringer. Flowet aggregerer ikke alle rækker for et miljø.
Du kan erstatte mailhandlingen med anden forretningslogik, f.eks. at sende til en Teams-kanal, oprette en Dataverse-række eller gemme rapporten i SharePoint for at bevare en langsigtet historik.
Kontrollér dine resultater
- Bekræft, at rapportfilen er en CSV-fil med en overskriftsrække eller en JSON-array. En CSV- eller en tom JSON-matrix (
[]), der kun er header, er et gyldigt resultat, når der ikke findes et kvalificeret forbrug for de ønskede datoer. - Sammenlign nogle få værdier fra rapportrækker med de tilsvarende dimensioner under Licensering>Copilot Studio i Power Platform Administration Center. Der forventes små forskelle for datoer i opdateringsvinduet på 30 dage, fordi forsinkede data og rettelser kan ændre værdierne.
-
FeatureDetailsPerResourceklassificerer kreditter som fakturerede og ikke-fakturerede.BillingDetailsPerEnvironmentgrupperer i stedet forbruget efter forudbetalt kapacitet og forbrugsbaseret finansiering. Disse klassificeringer svarer ikke nødvendigvis direkte til hinanden. Rapporterne kan også bruge forskellige dato- og behandlingsbaser, så deres totaler kan derfor ikke forventes at stemme overens. Se Kreditklassificering og -fortolkning.
Troubleshooting
| Problem | Sådan gør du |
|---|---|
400 Bad Request med InvalidRequestContent |
Kontrollér, at endDate er på eller efter startDate, datoerne bruger yyyy-MM-dd, og startDate er inden for lookback (30 dage som standard). Fejlmeddelelsen navngiver den tidligst tilladte dato. |
401 Unauthorized |
Log på igen. Ved direkte API-kald skal du anmode om et token for ressourcen https://api.powerplatform.com . Hvis der allerede findes en sendt handling, skal du registrere og genbruge handlingens Location URL-adresse efter at have fornyet tokenet i stedet for at sende en anden rapport. |
403 Forbidden |
Log på med en brugerkonto, der har rollen Global administrator, Power Platform-administrator eller Dynamics 365 administrator. Service principal-forbindelser understøttes ikke. |
404 Not Found |
Kontrollér rapportnavnet. I forbindelse med forespørgsler og downloads skal du bruge de Location URL-adresser, der returneres af tjenesten, uændret. |
429 Too Many Requests |
Hvis beskyttelse mod afsendelse gennemtvinges, skal du vente på det interval, der er angivet af tjenesten, før du sender en anden rapport. REST- og connectorklienter skal overholde Retry-After. Den oprindelige kommandolinjegrænseflade viser i øjeblikket ikke headeren, så forsøg ikke automatisk igen med et antaget interval. Brug REST-eksemplet, når du har brug for dynamisk headerhåndtering. |
Handlingsstatus er Failed |
Stop med at polle denne operation, og send en ny anmodning senere. |
| Den downloadede fil ligner binær data | PowerShell 7 respekterer normalt gzip Content-Encoding. Dekomprimer ikke manuelt indhold, der allerede er afkodet. For en binær connector-wrapper skal du base64-afkode $content til tekst og fortolke den resulterende JSON. Hvis den afkodede nyttedata stadig er gzip-komprimerede data, skal du stoppe og undersøge, hvordan klienten eller connectoren håndterer svaret i stedet for at behandle det som JSON. |
I Power Automate eller Copilot Studio er de første 202 svarheadere ikke tilgængelige efter Generér licensrapport |
Afsendelseshandlingen skal returnere start- Location og Retry-After uden polling med asynkront mønster slået til (standarden). Stop og kontrollér connectorversionen og svarhåndteringen, hvis disse headere ikke findes. Udtræk ikke et handlings-id fra et senere statussvar, deaktiver ikke indstillingen, og skift ikke designer. |
Feature Poll Status returnerer HTTP 200 med status: Running |
Dette er forventet.
Feature Wait If Running skal læse den seneste Retry-After, vente i så mange sekunder og lade Do until polle igen. Download først, når terminalkontrollen bekræfter Succeeded med et filnavn. |
Et Running-svar har et manglende eller ugyldigt Retry-After, eller pollingløkken når en grænse |
Stop og undersøg kørselsoversigten. Du må ikke erstatte en forsinkelse på nul sekunder, downloade en ufuldstændig rapport eller sende en anden rapport i en stram løkke. Bevar handlingens URL-adresse for at genoptage polling af den samme handling, når problemet er løst. |
I Power Automate modtager $content-type og $content |
Connectoren returnerede en binær indpakning. Brug json(base64ToString(body('Download_Licensing_Report_File')?['$content'])) som indholdet i Fortolk rapport-JSON. Dette afkoder wrapperen. Det dekomprimerer ikke gzip-data. |
| I Power Automate mislykkes Fortolk rapport-JSON | Bekræft den anvendte format=jsonanmodning, connectorversionen viser JSON, og roden er en array. Skemaet mislykkes bevidst, når et af de to påkrævede kreditfelter mangler, er nul eller ikke-numerisk. Opdater skemaet og tilknytningerne, hvis du bevidst skifter rapporttyper. |
| En beskrivende værdi er tom | Valgfrie mærkater kan være tomme eller null, så eksemplerne bruger ressource- eller miljø-id'er, hvor de er tilgængelige. Obligatoriske kreditfelter skal være til stede og numeriske; eksemplerne stopper i stedet for at behandle manglende kreditdata som nul. |
Relaterede oplysninger
- Generer licensrapport
- Hent operationen for licensrapport
- Hent licensrapportfil
- Reference til Power Platform for Admins V2-connector
- Microsoft Power Platform CLI copilot-studio kommandogruppe
- Installér Microsoft Power Platform CLI
- Selvstudium: Administrer tildelinger af Copilot-kreditter programmatisk