Notatka
Dostęp do tej strony wymaga autoryzacji. Może spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
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
- Informacje o aplikacji
- Informacje o przepływie
- Użycie konektora
- Informacje o katalogu konektorów
- Informacje o środowisku
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.