Porównaj spis eksportu danych z interfejsem API spisu platformy Power Platform

Interfejs API spisu platformy Power Platform udostępnia bieżące dane spisu za pośrednictwem tabeli PowerPlatformResources w Azure Resource Graph. Interfejs API zawiera podstawowe informacje o zasobie, właścicielu, środowisku i łączniku, ale jego schemat różni się od schematu spisu eksportu danych.

W tym artykule opisano:

  • Dane spisu zasobów dostępne za pośrednictwem interfejsu API spisu zasobów platformy Power Platform.
  • Właściwości spisu eksportu danych, które są niedostępne
  • Właściwości, które mają częściową lub inną ochronę.

Aby uzyskać informacje na temat wykonywania zapytań dotyczących spisu zasobów, zobacz Interfejs API spisu zasobów Power Platform. Aby uzyskać pełny schemat interfejsu API, zobacz Informacje o schemacie spisu usługi Power Platform.

Note

Microsoft wycofuje wersję zapoznawczą eksportu danych. Eksporty danych magazynowych przestaną działać po 1 grudnia 2026 r. Eksporty danych użycia i środowiska nadal działają w istniejących i nowych konfiguracjach, a dane, które zostały już wyeksportowane, pozostają w usłudze Data Lake. Spodziewaj się kolejnego powiadomienia od Microsoft, gdy eksport danych spisu zostanie zatrzymany.

Aby się przygotować, użyj interfejsu API spisu Power Platform, aby programowo wyeksportować dane spisu. Przed przeprowadzeniem migracji przejrzyj mapowania pól i znane luki. Niektóre pola inwentarza eksportu danych nie są dostępne za pośrednictwem interfejsu API lub mają inny zakres danych.

Interfejs API spisu zasobów platformy Power Platform nie eksportuje automatycznie danych do magazynu należącego do klienta. Aby utworzyć eksport cykliczny, użyj usługi Azure, takiej jak Azure Functions, Azure Logic Apps lub Azure Automation, aby wykonać zapytanie względem interfejsu API spisu platformy Power Platform zgodnie z harmonogramem i zapisać wyniki w Azure Blob Storage, Azure Data Lake Storage lub innym obsługiwanym miejscu docelowym.

Obsługiwane typy zasobów

Interfejs API spisu platformy Power Platform obejmuje następujące typy zasobów:

Resource Typ interfejsu API inwentaryzacji Power Platform
Aplikacje kanwy microsoft.powerapps/canvasapps
Aplikacje oparte na modelu microsoft.powerapps/modeldrivenapps
Aplikacje do kodowania microsoft.powerapps/codeapps
Aplikacje zarządzane i aplikacje utworzone za pomocą kreatora microsoft.powerapps/apps
Przepływy danych w chmurze microsoft.powerautomate/cloudflows
Przepływy agentów microsoft.powerautomate/agentflows
Przepływy procesów roboczych agenta microsoft.powerautomate/m365agentflows
Agenci programu Copilot Studio microsoft.copilotstudio/agents
Connectors microsoft.powerplatformconnector/connectors
Environments microsoft.powerplatform/environments
Grupy środowiskowe microsoft.powerplatform/environmentgroups

Dostępne dane o stanach magazynowych

W poniższych sekcjach opisano dostępne pola według typu zasobu i kategorii danych.

Informacje o zasobie udostępnionym

Następujące pola są dostępne dla obsługiwanych typów zasobów. Konektory są encjami katalogu i obsługują tylko pola współdzielone zidentyfikowane w opisie referencyjnym schematu inventory.

Kategoria danych Dostępne informacje Pole interfejsu API spisu usługi Power Platform
identyfikator zasobu Unikatowy identyfikator zasobu magazynowego name
Nazwa zasobu Nazwa wyświetlana zasobu properties.displayName
Typ zasobu Ustandaryzowany typ zasobu platformy Power Platform type
Tenant Identyfikator dzierżawcy tenantId
Location Lokalizacja geograficzna zasobu location
Data utworzenia Data i godzina utworzenia zasobu properties.createdAt
Utworzone przez Identyfikator obiektu użytkownika, który utworzył zasób properties.createdBy

Informacje o aplikacji

Poniższe informacje są dostępne dla obsługiwanych typów aplikacji.

Kategoria danych Dostępne informacje Pole interfejsu API spisu usługi Power Platform
Owner Identyfikator obiektu właściciela aplikacji properties.ownerId
Environment Identyfikator środowiska zawierającego aplikację properties.environmentId
Ostatnia modyfikacja Data i godzina ostatniej modyfikacji aplikacji properties.lastModifiedAt
Ostatnio zmodyfikowane przez Identyfikator obiektu użytkownika, który ostatnio zmodyfikował aplikację properties.lastModifiedBy
Stan kwarantanny Czy aplikacja jest poddana kwarantannie properties.isQuarantined
Identyfikator aplikacji opartej na modelu Identyfikator modułu aplikacji Dataverse properties.appModuleId
Nazwa logiczna aplikacji opartej na modelu Nazwa logiczna Dataverse properties.logicalName
Podtyp aplikacji Code-app byocApp lub vibeApp properties.subType
Podtyp aplikacji zarządzanej microsoftApp properties.subType
Podtyp App Builder appBuilderApp properties.subType

Informacje o przepływie

Poniższe informacje są dostępne dla przepływów w chmurze, przepływów agentów i przepływów agenta obiegu pracy.

Kategoria danych Dostępne informacje Pole interfejsu API spisu usługi Power Platform
Owner Identyfikator obiektu właściciela przepływu properties.ownerId
Environment Identyfikator środowiska zawierającego przepływ properties.environmentId
Ostatnia modyfikacja Data i godzina ostatniej modyfikacji przepływu properties.lastModifiedAt
Ostatnio zmodyfikowane przez Identyfikator obiektu użytkownika, który ostatnio zmodyfikował przepływ properties.lastModifiedBy
Encja przepływu pracy Identyfikator encji przepływu pracy usługi Dataverse properties.workflowEntityId
Konektor wyzwalacza Łącznik, który inicjuje przepływ properties.trigger
Wyzwól operację Operacja konektora, która inicjuje przepływ properties.triggerOperation

Pola wyzwalacza są puste, gdy przepływ używa wyzwalacza, który nie jest oparty na łączniku, na przykład cyklu lub wyzwalacza ręcznego.

Użycie konektora

Użycie łącznika jest dostępne dla obsługiwanych aplikacji, przepływów i agentów.

Kategoria danych Dostępne informacje Pole interfejsu API spisu usługi Power Platform
Używane łączniki Identyfikatory konektorów używanych przez zasób properties.powerPlatformConnectors[].connectorId
Użyte operacje Identyfikatory operacji wywoływanych w konektorze properties.powerPlatformConnectors[].operations[].operationId
Wyzwalacz przepływu pracy Łącznik, który inicjuje obsługiwany przepływ pracy properties.trigger
Operacja wyzwalania przepływu Operacja konektora, która inicjuje obsługiwany przepływ pracy properties.triggerOperation

Informacje katalogowe dotyczące łączników

Łączniki można również znaleźć jako poszczególne zasoby magazynowe.

Kategoria danych Dostępne informacje Pole interfejsu API spisu usługi Power Platform
Identyfikator łącznika Identyfikator konektora properties.connectorId
Opis Opis łącznika properties.description
Publisher Publisher konektora properties.publisher
Tier Klasyfikacja standardowa lub premium properties.tier
Etap wydania Oznaczenie wydania, takie jak Produkcyjna lub wersja zapoznawcza properties.releaseTag
Stan deprecjacji Czy konektor jest przestarzały properties.isDeprecated
Operations Operacje uwidocznione przez konektor properties.operations
Identyfikator operacji Unikatowy identyfikator operacji properties.operations[].operationId
Nazwa operacji Wyświetlana nazwa operacji properties.operations[].displayName
Opis operacji Opis operacji properties.operations[].description
metoda HTTP Metoda HTTP używana przez operację properties.operations[].method

Informacje o środowisku

Poniższe informacje można znaleźć w rekordach spisu środowiska.

Kategoria danych Dostępne informacje Pole interfejsu API spisu usługi Power Platform
Identyfikator środowiska Unikatowy identyfikator środowiska name
Nazwa środowiska Nazwa wyświetlana środowiska properties.displayName
Location Lokalizacja geograficzna środowiska location
Typ środowiska Środowisko produkcyjne, domyślne, środowisko piaskownicy, wersja próbna, Deweloper lub usługa Dataverse dla usługi Teams properties.environmentType
Status zarządzany Czy środowisko jest środowiskiem zarządzanym properties.isManaged
Grupa środowiskowa Nazwa przypisanej grupy środowiska properties.environmentGroup
Identyfikator grupy środowiska Identyfikator przypisanej grupy środowiska properties.environmentGroupId
Ostatnia modyfikacja Data i godzina ostatniej modyfikacji środowiska properties.lastModifiedAt

Dane są niedostępne

Następujące właściwości spisu eksportu danych nie mają bezpośrednich odpowiedników w opublikowanym schemacie interfejsu API spisu usługi Power Platform.

Kategoria danych Informacje o spisie eksportowanych danych nie są dostępne w interfejsie API spisu w Power Platform
Opis aplikacji Opis kanwy lub aplikacji opartej na modelu
Linki aplikacji Identyfikator URI aplikacji, identyfikator URI dokumentu, identyfikator URI ikony i adres URL formularza SharePoint
Udostępnianie Liczba użytkowników i grup, którym udostępniono aplikację
Stan usuwania Jawny wskaźnik usuniętego zasobu
Historia włączenia Data ostatniego włączenia aplikacji i jednostka, która ją włączyła
Informacje o rozwiązaniu i ALM Powiązanie rozwiązania i tryb ALM
Ocena DLP Stan oceny, data oceny, komunikat o naruszeniu i naruszenia według zasad zabezpieczeń
Konfiguracja aplikacji Ustawienia, typ tworzenia, typ urządzenia klienckiego, host osadzający, niestandardowe rozszerzenia i ustawienie optymalizacji wydajności
Prezentacja aplikacji Obraz tła, kolor tła, oznaczenie aplikacji hero-app, oznaczenie featured-app i klasyfikacja planu aplikacji
Zgoda i licencjonowanie Obejście ustawienia zgody i kwalifikowanie do app-pass
Wersja dokumentu Wersja dokumentu skojarzona z aplikacją
Użycie bramy lokalnej (on-premises) Jawny wskaźnik, że aplikacja używa lokalnej bramy danych on-premises
Użycie tabeli Dataverse Jawny wskaźnik, że aplikacja używa tabel Dataverse
Użycie usługi zewnętrznej PCF Jawny wskaźnik, że kontrolka platformy Power Apps Component Framework używa usługi zewnętrznej

Important

properties.isQuarantined wskazuje, czy aplikacja jest poddana kwarantannie. Nie jest to odpowiednik wskaźnika usunięcia eksportu danych.

Dane dostępne z różnym zakresem

Niektóre pola interfejsu API spisu Power Platform zawierają powiązane informacje, ale nie są bezpośrednimi odpowiednikami właściwości eksportu danych.

Kategoria danych Spis eksportu danych Zakres interfejsu API inwentaryzacji Power Platform
Typ zasobu Oddzielne wartości type i subType Ustandaryzowany identyfikator zasobu w type. Niektóre typy zasobów również udostępniają properties.subType
Status i cykl życia Stan zasobu i cyklu życia zasobu Stan kwarantanny jest dostępny dla obsługiwanych typów aplikacji, ale nie reprezentuje wszystkich wartości stanu ani cyklu życia
Owner Wartość właściciela i identyfikator obiektu właściciela properties.ownerId udostępnia identyfikator obiektu, jeśli jest dostępny. Nazwa wyświetlana właściciela nie jest uwzględniona
Użycie niestandardowego interfejsu API Określony explicite niestandardowy wskaźnik interfejsu API Identyfikatory łączników są dostępne dla obsługiwanych zasobów, ale równoważny niestandardowy wskaźnik interfejsu API nie jest dostępny
Korzystanie z konektora Premium Wyraźny wskaźnik interfejsu API Premium Kategoria jednostki SKU łącznika jest dostępna w rekordach katalogu łączników, ale równoważny wskaźnik na poziomie zasobu nie jest dostępny
Akcje przepływu pracy Akcje przepływu pracy i wskaźniki związane z łącznikiem Ustrukturyzowany łącznik i identyfikatory operacji są dostępne dla obsługiwanych typów zasobów
Informacje o środowisku Identyfikator środowiska na zasobie i oddzielne dane eksportu środowiska Zasób obejmuje properties.environmentIdelement. Szczegóły środowiska są dostępne za pośrednictwem rekordów inwentaryzacji środowiska

Mapowanie identyfikatorów

Identyfikatory zasobów nie są reprezentowane identycznie w przypadku eksportu danych i interfejsu API inwentaryzacji usługi Power Platform.

Aplikacje oparte na modelu

Użyj następującego mapowania dla aplikacji opartych na modelu:

Pole inwentarza eksportu danych Pole interfejsu API spisu usługi Power Platform
environmentId properties.environmentId
resourceId properties.appModuleId
name properties.displayName
type i subType type

Pole najwyższego poziomu name interfejsu API inwentaryzacji platformy Power Platform to unikatowy identyfikator zasobu inwentaryzacji. Nie jest ona równoważna eksportowi danych resourceId dla aplikacji opartych na modelu.

Aby skorelować aplikację opartą na modelu między dwoma schematami, użyj zarówno properties.environmentId, jak i properties.appModuleId.

Ograniczenia listy konektorów

Inwentarz konektorów ma następujące udokumentowane ograniczenia:

  • Łączniki tabelaryczne mogą występować z pustą tablicą operacji.
  • Wbudowane akcje Power Automate, w tym operacje HTTP, Control i Data, nie są reprezentowane jako konektory.
  • Aplikacje Code apps, aplikacje vibe apps, aplikacje zarządzane i aplikacje programu App Builder nie emitują danych użycia łącznika.
  • Aplikacje oparte na modelu rzadko zgłaszają konektory bezpośrednio.
  • Użycie łącznika przez osadzoną stronę kanwy jest skojarzone z rekordem strony kanwy zamiast zawierającej ją aplikacji opartej na modelu.
  • Dane łącznika dla zasobów obejmują łącznik i identyfikatory operacji, ale nie zawierają nazw wyświetlanych łączników, informacji o wydawcy ani tieru.
  • Nazwy wyświetlane łącznika, informacje o wydawcy i warstwa cenowa są dostępne w rekordach spisu łączników.
  • Obecność łącznika nie wskazuje, czy jest używana brama lokalna/on-premises.