Udostępnij przez

Azure Digital Twins (wersja zapoznawcza)

Azure Digital Twins to platforma Internetu rzeczy (IoT), która umożliwia tworzenie cyfrowej reprezentacji rzeczywistych rzeczy, miejsc, procesów biznesowych i osób. Ten łącznik umożliwia wykonywanie operacji na cyfrowych reprezentacjach bliźniaczych i modelach, a także uruchamianie zapytań ADT.

Ten łącznik jest dostępny w następujących produktach i regionach:

Usługa Class Regions
Copilot Studio Standard Wszystkie regiony usługi Power Automate z wyjątkiem następujących:
     - Rząd USA (GCC)
     - Rząd USA (GCC High)
     - China Cloud obsługiwane przez firmę 21Vianet
     - Departament Obrony USA (DoD)
Logic Apps Standard Wszystkie regiony usługi Logic Apps z wyjątkiem następujących:
     — Regiony platformy Azure Government
     — Regiony platformy Azure (Chiny)
     - Departament Obrony USA (DoD)
Power Apps Standard Wszystkie regiony usługi Power Apps z wyjątkiem następujących:
     - Rząd USA (GCC)
     - Rząd USA (GCC High)
     - China Cloud obsługiwane przez firmę 21Vianet
     - Departament Obrony USA (DoD)
Power Automate Standard Wszystkie regiony usługi Power Automate z wyjątkiem następujących:
     - Rząd USA (GCC)
     - Rząd USA (GCC High)
     - China Cloud obsługiwane przez firmę 21Vianet
     - Departament Obrony USA (DoD)
Kontakt
Name Microsoft
adres URL https://azure.microsoft.com/support/
Metadane łącznika
Publisher Microsoft Corporation
Witryna internetowa https://azure.microsoft.com/products/digital-twins/
Zasady ochrony prywatności https://privacy.microsoft.com
Kategorie Internet rzeczy

Azure Digital Twins to platforma Internetu rzeczy (IoT), która umożliwia tworzenie cyfrowej reprezentacji rzeczywistych rzeczy, miejsc, procesów biznesowych i osób. Uzyskaj szczegółowe informacje, które ułatwiają wspieranie lepszych produktów, optymalizowanie operacji i kosztów oraz tworzenie przełomowych środowisk klientów. Te łączniki umożliwiają interakcję z interfejsem API cyfrowych reprezentacji bliźniaczych. Umożliwi to tworzenie bliźniaczych reprezentacji bliźniaczych, zarządzanie nimi i wykonywanie względem niej zapytań.

Wymagania wstępne

Aby kontynuować, musisz wykonać następujące czynności:

  • Plan usługi Microsoft Power Apps lub Power Automate z funkcją łącznika niestandardowego
  • Subskrypcja platformy Azure
  • Narzędzia interfejsu wiersza polecenia platformy Power Platform
  • Wystąpienie usługi Azure Digital Twin

Jak uzyskać poświadczenia

Użyj identyfikatora użytkownika i hasła identyfikatora entra firmy Microsoft, który ma uprawnienia dostępu do punktów końcowych usługi Digital Twins.

Wprowadzenie do łącznika

Znane problemy i ograniczenia

  • Ponieważ usługa ADT obsługuje odpowiedzi schematu dynamicznego. Deweloper aplikacji powinien przeanalizować kod JSON do modelu przed jego użyciem. np. Set(jsonVal, AzureDigitalTwins.GetTwinById(TextInput1.Text).result); Set(parsedResp, ParseJSON(jsonVal)); Set( DtId, Text(parsedResp). $dtId'));

Typowe błędy i środki zaradcze

  • Błąd analizatora Json:
    • Jeśli model nie jest zgodny z przeanalizowanym plikiem json, zostanie wyświetlony błąd analizatora json. Aby rozwiązać ten problem, sprawdź plik XML odpowiedzi i odpowiednio uzyskaj dostęp do wartości.

Często zadawane pytania

  • Czy można utworzyć wystąpienie usługi ADT za pośrednictwem łącznika?

    • Przejdź do platformy Azure, aby utworzyć i usunąć wystąpienie usługi ADT.

  • Czy strona jest dostępna?

    • Stronicowanie odbywa się w ramach tworzenia aplikacji przy użyciu tokenu kontynuacji.

  • Czy można uzyskać dostęp do wielu wystąpień usługi ADT w jednej aplikacji?

    • Aby uzyskać dostęp do wielu wystąpień usługi ADT, należy ustanowić nowe połączenie i użyć go odpowiednio w aplikacji.

Tworzenie połączenia

Łącznik obsługuje następujące typy uwierzytelniania:
Wartość domyślna Parametry tworzenia połączenia. Wszystkie regiony Nie można udostępniać

Domyślny

Dotyczy: wszystkie regiony

Parametry tworzenia połączenia.

Nie jest to możliwe do udostępnienia połączenie. Jeśli aplikacja power zostanie udostępniona innemu użytkownikowi, zostanie wyświetlony monit o jawne utworzenie nowego połączenia.

Name Typ Description Wymagane
Nazwa wystąpienia usługi ADT: ciąg Wprowadź identyfikator URI wystąpienia usługi ADT Prawda

Limity ograniczania

Nazwa Wywołania Okres odnowienia
Wywołania interfejsu API na połączenie 300 60 sekund

Akcje

Aktualizowanie właściwości modelu

Aktualizuje metadane modelu.
Aktualizuj bliźniaczą wersję

Aktualizuje właściwości bliźniaczej reprezentacji.
Aktualizuj relację

Aktualizuje właściwości liczb całkowitych w relacji między dwiema cyfrowymi reprezentacjami bliźniaczymi.
Aktualizuj składnik

Aktualizuje właściwości liczb całkowitych w składniku reprezentacji bliźniaczej.
API zapytań

Wykonuje zapytanie, które umożliwia przechodzenie relacji i filtrowanie według wartości właściwości.
Dodaj relację

Dodaje relację między dwoma cyfrowymi reprezentacjami bliźniaczymi.
Dodawanie bliźniaczej reprezentacji

Dodaje lub zastępuje cyfrową reprezentację bliźniaczą.
Dodawanie modelu

Przekazuje co najmniej jeden model. W przypadku wystąpienia dowolnego błędu nie są przekazywane żadne modele.
Lista modeli

Pobiera metadane modelu i, opcjonalnie, definicje modelu.
Pobieranie modelu według identyfikatora

Pobiera metadane modelu i, opcjonalnie, definicję modelu.
Pobieranie relacji według identyfikatora

Pobiera relację między dwiema cyfrowymi reprezentacjami bliźniaczymi.
Pobieranie reprezentacji bliźniaczej według identyfikatora

Pobiera cyfrową reprezentację bliźniaczą i jego dane.
Pobieranie składnika

Pobiera składnik z cyfrowej reprezentacji bliźniaczej.
Usuwanie bliźniaczej reprezentacji

Usuwa cyfrową reprezentację bliźniaczą. Wszystkie relacje odwołujące się do cyfrowej reprezentacji bliźniaczej muszą już zostać usunięte.
Usuń model

Usuwa model. Model można usunąć tylko wtedy, gdy nie odwołują się do niego żadne inne modele.
Usuń relację

Usuwa relację między dwiema cyfrowymi reprezentacjami bliźniaczymi.
Wysyłanie danych telemetrycznych

Wysyła dane telemetryczne w imieniu cyfrowej reprezentacji bliźniaczej.
Wysyłanie telemetrii składnika

Wysyła dane telemetryczne w imieniu składnika w cyfrowej reprezentacji bliźniaczej.
Wyświetlanie listy relacji

Pobiera wszystkie relacje wychodzące z cyfrowej reprezentacji bliźniaczej.
Wyświetlanie listy relacji przychodzących

Pobiera wszystkie relacje przychodzące dla cyfrowej reprezentacji bliźniaczej.

Aktualizowanie właściwości modelu

Identyfikator operacji:
UpdateModel

Aktualizuje metadane modelu.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator modelu
 modelid True string

Identyfikator modelu. Identyfikator jest unikatowy w usłudze i uwzględnia wielkość liter.
Żądanie
 value string

Żądanie dotyczące interfejsu API.

Aktualizuj bliźniaczą wersję

Identyfikator operacji:
UpdateTwin

Aktualizuje właściwości bliźniaczej reprezentacji.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator cyfrowej reprezentacji bliźniaczej
 twinid True string

Identyfikator cyfrowej reprezentacji bliźniaczej. Identyfikator jest unikatowy w usłudze i uwzględnia wielkość liter.
Żądanie
 value string

Żądanie dotyczące interfejsu API.

Aktualizuj relację

Identyfikator operacji:
UpdateRelationship

Aktualizuje właściwości liczb całkowitych w relacji między dwiema cyfrowymi reprezentacjami bliźniaczymi.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator cyfrowej reprezentacji bliźniaczej
 twinid True string

Identyfikator cyfrowej reprezentacji bliźniaczej. Identyfikator jest unikatowy w usłudze i uwzględnia wielkość liter.
Identyfikator relacji
 relationshipId True string

Identyfikator relacji. Identyfikator jest unikatowy w cyfrowej reprezentacji bliźniaczej i uwzględnia wielkość liter.
Żądanie
 value string

Żądanie dotyczące interfejsu API.

Aktualizuj składnik

Identyfikator operacji:
UpdateComponent

Aktualizuje właściwości liczb całkowitych w składniku reprezentacji bliźniaczej.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator cyfrowej reprezentacji bliźniaczej
 twinid True string

Identyfikator cyfrowej reprezentacji bliźniaczej. Identyfikator jest unikatowy w usłudze i uwzględnia wielkość liter.
Składnik DTDL
 componentPath True string

Nazwa składnika DTDL.
Żądanie
 value string

Żądanie dotyczące interfejsu API.

API zapytań

Identyfikator operacji:
QueryTwins

Wykonuje zapytanie, które umożliwia przechodzenie relacji i filtrowanie według wartości właściwości.

Parametry

Nazwa Klucz Wymagane Typ Opis
kwerenda
 query string

Wykonaj zapytanie dotyczące bliźniaczych reprezentacji.
continuationToken
 continuationToken string

Połącz, aby pobrać następny zestaw elementów.

Zwraca

Body
QueryResult

Dodaj relację

Identyfikator operacji:
AddRelationship

Dodaje relację między dwoma cyfrowymi reprezentacjami bliźniaczymi.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator cyfrowej reprezentacji bliźniaczej
 twinid True string

Identyfikator cyfrowej reprezentacji bliźniaczej. Identyfikator jest unikatowy w usłudze i uwzględnia wielkość liter.
Identyfikator relacji
 relationshipId True string

Identyfikator relacji. Identyfikator jest unikatowy w cyfrowej reprezentacji bliźniaczej i uwzględnia wielkość liter.
Żądanie
 value string

Żądanie dotyczące interfejsu API.

Zwraca

Body
TwinRelationship

Dodawanie bliźniaczej reprezentacji

Identyfikator operacji:
AddTwin

Dodaje lub zastępuje cyfrową reprezentację bliźniaczą.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator cyfrowej reprezentacji bliźniaczej
 twinid True string

Identyfikator cyfrowej reprezentacji bliźniaczej. Identyfikator jest unikatowy w usłudze i uwzględnia wielkość liter.
Żądanie
 value string

Żądanie dotyczące interfejsu API.

Zwraca

Body
TwinResult

Dodawanie modelu

Identyfikator operacji:
AddModels

Przekazuje co najmniej jeden model. W przypadku wystąpienia dowolnego błędu nie są przekazywane żadne modele.

Parametry

Nazwa Klucz Wymagane Typ Opis
@id
 @id string

Identyfikator modelu określony w definicji modelu.
@type
 @type string

Typ interfejsu.
nazwa wyświetlana
 displayName string

Mapa języka zawierająca zlokalizowane nazwy wyświetlane określone w definicji modelu.
@type
 @type string

Typ właściwości.
nazwa
 name string

Nazwa właściwości.
nazwa wyświetlana
 displayName string

Nazwa właściwości.
schemat
 schema string

Schemat proerty.
@context
 @context string

Kontekst metadanych.

Zwraca

Nazwa Ścieżka Typ Opis
array of object
id
 id string

Identyfikator modelu określony w definicji modelu.
additionalProperties
 displayName.additionalProperties string

Wartości właściwości.
uploadTime
 uploadTime string

Czas przekazania modelu do usługi.
Wycofany ze służby
 decommissioned boolean

Wskazuje, czy model jest zlikwidowany. Likwidowane modele nie mogą być przywoływane przez nowo utworzone cyfrowe reprezentacje bliźniacze.

Lista modeli

Identyfikator operacji:
ListModels

Pobiera metadane modelu i, opcjonalnie, definicje modelu.

Parametry

Nazwa Klucz Wymagane Typ Opis
Zależności dla modelu
 dependenciesFor string

Zestaw modeli, które będą miały pobrane zależności. W przypadku pominięcia wszystkie modele zostaną pobrane.
Uwzględnij definicję modelu
 includeModelDefinition string

W przypadku wartości true definicja modelu zostanie zwrócona w ramach wyniku.
Token kontynuacji
 continuationToken string

Token używany do pobierania następnego zestawu wyników z poprzedniego zapytania.

Zwraca

Nazwa Ścieżka Typ Opis
value
 value array of object

Wartości tablicy.
id
 value.id string

Identyfikator modelu określony w definicji modelu.
uploadTime
 value.uploadTime string

Czas przekazania modelu do usługi.
Wycofany ze służby
 value.decommissioned boolean

Wskazuje, czy model jest zlikwidowany. Likwidowane modele nie mogą być przywoływane przez nowo utworzone cyfrowe reprezentacje bliźniacze.
@id
 value.model.@id string

Identyfikator modelu określony w definicji modelu.
@type
 value.model.@type string

Typ interfejsu.
contents
 value.model.contents array of object

Zawartość odpowiedzi.
@type
 value.model.contents.@type string

Typ właściwości.
nazwa
 value.model.contents.name string

Nazwa właściwości.
nazwa wyświetlana
 value.model.contents.displayName string

Właściwość displayName.
schemat
 value.model.contents.schema string

Schemat właściwości.
@context
 value.model.@context string

Kontekst metadanych.
nazwa wyświetlana
 value.model.displayName string

Nazwa wyświetlana modelu.
additionalProperties
 value.displayName.additionalProperties string

Wartości właściwości.
continuationToken
 continuationToken string

Token kontynuacji na następnej stronie relacji bliźniaczej.
nextLink
 nextLink string

Adres URL umożliwiający pobranie następnej strony modeli.

Pobieranie modelu według identyfikatora

Identyfikator operacji:
GetModelById

Pobiera metadane modelu i, opcjonalnie, definicję modelu.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator modelu
 modelid True string

Identyfikator modelu. Identyfikator jest unikatowy w usłudze i uwzględnia wielkość liter.
Uwzględnij definicję modelu
 includeModelDefinition string

W przypadku wartości true definicja modelu zostanie zwrócona w ramach wyniku.

Zwraca

Nazwa Ścieżka Typ Opis
id
 id string

Identyfikator modelu określony w definicji modelu.
uploadTime
 uploadTime string

Czas przekazania modelu do usługi.
Wycofany ze służby
 decommissioned boolean

Wskazuje, czy model jest zlikwidowany. Likwidowane modele nie mogą być przywoływane przez nowo utworzone cyfrowe reprezentacje bliźniacze.
@id
 model.@id string

Identyfikator modelu określony w definicji modelu.
@type
 model.@type string

Typ interfejsu.
contents
 model.contents array of object

Zawartość odpowiedzi.
@type
 model.contents.@type string

Typ właściwości.
nazwa
 model.contents.name string

Nazwa właściwości.
nazwa wyświetlana
 model.contents.displayName string

Właściwość displayName.
schemat
 model.contents.schema string

Schemat właściwości.
@context
 model.@context string

Kontekst metadanych.

Pobieranie relacji według identyfikatora

Identyfikator operacji:
GetRelationshipById

Pobiera relację między dwiema cyfrowymi reprezentacjami bliźniaczymi.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator cyfrowej reprezentacji bliźniaczej
 twinid True string

Identyfikator cyfrowej reprezentacji bliźniaczej. Identyfikator jest unikatowy w usłudze i uwzględnia wielkość liter.
Identyfikator relacji
 relationshipId True string

Identyfikator relacji. Identyfikator jest unikatowy w cyfrowej reprezentacji bliźniaczej i uwzględnia wielkość liter.

Zwraca

Body
TwinRelationship

Pobieranie reprezentacji bliźniaczej według identyfikatora

Identyfikator operacji:
GetTwinById

Pobiera cyfrową reprezentację bliźniaczą i jego dane.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator cyfrowej reprezentacji bliźniaczej
 twinid True string

Identyfikator cyfrowej reprezentacji bliźniaczej. Identyfikator jest unikatowy w usłudze i uwzględnia wielkość liter.

Zwraca

Body
TwinResult

Pobieranie składnika

Identyfikator operacji:
GetComponent

Pobiera składnik z cyfrowej reprezentacji bliźniaczej.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator cyfrowej reprezentacji bliźniaczej
 twinid True string

Identyfikator cyfrowej reprezentacji bliźniaczej. Identyfikator jest unikatowy w usłudze i uwzględnia wielkość liter.
Składnik DTDL
 componentPath True string

Nazwa składnika DTDL.

Zwraca

Body
GetComponentResult

Usuwanie bliźniaczej reprezentacji

Identyfikator operacji:
DeleteTwin

Usuwa cyfrową reprezentację bliźniaczą. Wszystkie relacje odwołujące się do cyfrowej reprezentacji bliźniaczej muszą już zostać usunięte.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator cyfrowej reprezentacji bliźniaczej
 twinid True string

Identyfikator cyfrowej reprezentacji bliźniaczej. Identyfikator jest unikatowy w usłudze i uwzględnia wielkość liter.

Usuń model

Identyfikator operacji:
DeleteModel

Usuwa model. Model można usunąć tylko wtedy, gdy nie odwołują się do niego żadne inne modele.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator modelu
 modelid True string

Identyfikator modelu. Identyfikator jest unikatowy w usłudze i uwzględnia wielkość liter.

Usuń relację

Identyfikator operacji:
DeleteRelationship

Usuwa relację między dwiema cyfrowymi reprezentacjami bliźniaczymi.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator cyfrowej reprezentacji bliźniaczej
 twinid True string

Identyfikator cyfrowej reprezentacji bliźniaczej. Identyfikator jest unikatowy w usłudze i uwzględnia wielkość liter.
Identyfikator relacji
 relationshipId True string

Identyfikator relacji. Identyfikator jest unikatowy w cyfrowej reprezentacji bliźniaczej i uwzględnia wielkość liter.

Wysyłanie danych telemetrycznych

Identyfikator operacji:
SendTelemetry

Wysyła dane telemetryczne w imieniu cyfrowej reprezentacji bliźniaczej.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator cyfrowej reprezentacji bliźniaczej
 twinid True string

Identyfikator cyfrowej reprezentacji bliźniaczej. Identyfikator jest unikatowy w usłudze i uwzględnia wielkość liter.
Identyfikator wiadomości
 Message-Id True string

Unikatowy identyfikator komunikatu (w zakresie identyfikatora cyfrowej reprezentacji bliźniaczej), który jest często używany do deduplikowania komunikatów.
Sygnatura czasowa
 Telemetry-Source-Time string

Sygnatura czasowa RFC 3339 identyfikująca czas pomiaru telemetrii.
Żądanie telemetrii
 value string

Wysyłanie danych wejściowych telemetrii.

Wysyłanie telemetrii składnika

Identyfikator operacji:
SendComponentTelemetry

Wysyła dane telemetryczne w imieniu składnika w cyfrowej reprezentacji bliźniaczej.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator cyfrowej reprezentacji bliźniaczej
 twinid True string

Identyfikator cyfrowej reprezentacji bliźniaczej. Identyfikator jest unikatowy w usłudze i uwzględnia wielkość liter.
Składnik DTDL
 componentPath True string

Nazwa składnika DTDL.
Identyfikator wiadomości
 Message-Id True string

Unikatowy identyfikator komunikatu (w zakresie identyfikatora cyfrowej reprezentacji bliźniaczej), który jest często używany do deduplikowania komunikatów.
Sygnatura czasowa
 Telemetry-Source-Time string

Sygnatura czasowa RFC 3339 identyfikująca czas pomiaru telemetrii.
Żądanie telemetrii składnika
 value string

Wysyłanie danych wejściowych telemetrycznych składnika.

Wyświetlanie listy relacji

Identyfikator operacji:
ListRelationships

Pobiera wszystkie relacje wychodzące z cyfrowej reprezentacji bliźniaczej.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator cyfrowej reprezentacji bliźniaczej
 twinid True string

Identyfikator cyfrowej reprezentacji bliźniaczej. Identyfikator jest unikatowy w usłudze i uwzględnia wielkość liter.
Token kontynuacji
 continuationToken string

Token używany do pobierania następnego zestawu wyników z poprzedniego zapytania.

Zwraca

Nazwa Ścieżka Typ Opis
value
 value array of TwinRelationship

Kolekcja relacji bliźniaczych.
continuationToken
 continuationToken string

Token kontynuacji na następnej stronie relacji bliźniaczej.
nextLink
 nextLink string

Adres URL, aby uzyskać następną stronę relacji bliźniaczej reprezentacji.

Wyświetlanie listy relacji przychodzących

Identyfikator operacji:
ListIncomingRelationships

Pobiera wszystkie relacje przychodzące dla cyfrowej reprezentacji bliźniaczej.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator cyfrowej reprezentacji bliźniaczej
 twinid True string

Identyfikator cyfrowej reprezentacji bliźniaczej. Identyfikator jest unikatowy w usłudze i uwzględnia wielkość liter.
Token kontynuacji
 continuationToken string

Token używany do pobierania następnego zestawu wyników z poprzedniego zapytania.

Zwraca

Nazwa Ścieżka Typ Opis
value
 value array of IncomingRelationship

Kolekcja relacji przychodzących.
continuationToken
 continuationToken string

Token kontynuacji na następnej stronie relacji bliźniaczej.
nextLink
 nextLink string

Adres URL umożliwiający uzyskanie następnej strony relacji przychodzącej.

Definicje

IncomingRelationship

Nazwa Ścieżka Typ Opis
$sourceId
 $sourceId string

Identyfikator źródła.
$relationshipId
 $relationshipId string

Identyfikator relacji.
$relationshipName
 $relationshipName string

Nazwa relacji.
$relationshipLink
 $relationshipLink string

Łącze relacji.

TwinRelationship

Nazwa Ścieżka Typ Opis
$sourceId
 $sourceId string

Identyfikator źródła.
$relationshipId
 $relationshipId string

Identyfikator relacji.
$targetId
 $targetId string

Identyfikator docelowy.
$relationshipName
 $relationshipName string

Nazwa relacji.
$etag
 $etag string

Łącze tagu E.
additionalProperties
 additionalProperties string

Wartości właściwości.

TwinResult

Nazwa Ścieżka Typ Opis
Wynik
 result string

Wyniki z bliźniaczej reprezentacji.

GetComponentResult

Nazwa Ścieżka Typ Opis
Wynik
 result string

Wyniki z bliźniaczej reprezentacji.

ZapytanieWybieranie

Nazwa Ścieżka Typ Opis
Wartość
 value string

Wyniki z bliźniaczej reprezentacji.
Token kontynuacji
 continuationToken string

Połącz, aby pobrać następny zestaw elementów.