Běžné dotazy k programovému přístupu k analytickým datům

Tento článek se zabývá nejčastějšími dotazy týkajícími se přístupu k datům přehledů partnerů v Partnerském centru prostřednictvím kódu programu.

Odpovědi rozhraní API

Jaké jsou různé scénáře, ve kterých můžu obdržet jinou odpověď rozhraní API než 200 (Úspěch)?

Tato tabulka popisuje odpovědi rozhraní API a co dělat, pokud je obdržíte.

Popis chyby	Kód chyby	Odstraňování potíží
Neautorizováno	401	Toto je výjimka ověřování. Zkontrolujte správnost tokenu MICROSOFT Entra ID. Token Microsoft Entra je platný po dobu 60 minut, po které byste museli znovu vygenerovat token Microsoft Entra.
Neplatný název tabulky	400	Název datové sady je nesprávný. Znovu zkontrolujte název datové sady voláním rozhraní API Získat všechny datové sady.
Nesprávný název sloupce	400	Název sloupce v dotazu je nesprávný. Znovu zkontrolujte název sloupce zavoláním rozhraní API Get All Datasets nebo odkazováním na názvy sloupců v definicích dat.
Hodnota null nebo chybějící hodnota	400	V datové části požadavku rozhraní API možná chybí povinné parametry.
Neplatné parametry sestavy	400	Ujistěte se, že jsou parametry sestavy správné. Například pro parametr RecurrenceInterval můžete zadat hodnotu menší než 4.
Interval opakování musí být mezi 4 a 2160.	400	Ujistěte se, že hodnota parametru požadavku RecurrenceInterval je mezi 4 a 2160.
Neplatné ID dotazu	400	Znovu zkontrolujte vygenerované ID dotazu.
Neplatné parametry sestavy pro vytvoření – Počáteční čas sestavy by měl být alespoň 4 hodiny od aktuálního času UTC.	400	Parametr Čas spuštění v rámci datové části požadavku by neměl být v minulosti. Počáteční čas sestavy by měl být od aktuálního času UTC aspoň 4 hodiny.
Požadovaná hodnota string nebyla nalezena.	400	Zkontrolujte, jestli jste aktualizovali parametry callbackurl požadavku nebo formát.
Nebyla nalezena žádná položka s danými filtry.	404	Zkontrolujte parametr reportID použitý v rozhraní API Get Report Executions.
Pro dané podmínky filtru nedošlo k žádným spuštěním. Pečlivě zkontrolujte ID sestavy nebo executionId a po plánované době provádění sestavy zkuste rozhraní API zopakovat.	404	Ujistěte se, že je id sestavy správné. Zkuste rozhraní API zopakovat po plánované době provádění sestavy podle toho, jak je uvedeno v datové části požadavku.
Při vytváření sestavy došlo k vnitřní chybě. ID korelace <>	500	Ujistěte se, že je správný formát data pro pole StartTime, QueryStartTime a QueryEndTime .
Nedostupná služba	500	Pokud nepřetržitě obdržíte nedostupnou službu (chyba 5xx), otevřete lístek podpory.

Žádné záznamy

Při stahování sestavy ze zabezpečeného umístění obdržím odpověď rozhraní API 200. Proč nedostávám žádné záznamy? Zkontrolujte, jestli řetězec v dotazu obsahuje jednu z povolených hodnot záhlaví sloupce. Tento dotaz například vrátí nulové výsledky:

SELECT CustomerTenantId, CustomerTpId, WorkloadName, Month, MonthlyActiveUsers
FROM OfficeUsage
WHERE IsDuplicateRowForPGA = 'False'
ORDER BY CustomerTenantId DESC

V tomto příkladu jsou povolené hodnoty IsDuplicateRowForPGA 0 nebo 1. Všechny možné hodnoty pro různé sloupce najdete v definicích dat.