DigitalTwinsClient Klas
Hiermee maakt u een exemplaar van de Digital Twins-client.
- Overname
-
builtins.objectDigitalTwinsClient
Constructor
DigitalTwinsClient(endpoint: str, credential: AsyncTokenCredential, **kwargs)Parameters
- credential
- AsyncTokenCredential
Een referentie voor het verifiëren van aanvragen voor de service.
Methoden
| close | |
| create_models |
Maak een of meer modellen. Wanneer er een fout optreedt, worden er geen modellen geüpload. |
| decommission_model |
Een model buiten gebruik stellen. |
| delete_digital_twin |
Een digitale dubbel verwijderen. |
| delete_event_route |
Een gebeurtenisroute verwijderen. |
| delete_model |
Een model verwijderen. |
| delete_relationship |
Een relatie op een digitale dubbel verwijderen. |
| get_component |
Een onderdeel ophalen op een digitale dubbel. |
| get_digital_twin |
Download een digitale dubbel. |
| get_event_route |
Een gebeurtenisroute ophalen. |
| get_model |
Haal een model op, inclusief de metagegevens van het model en de modeldefinitie. |
| get_relationship |
Een relatie op een digitale dubbel ophalen. |
| list_event_routes |
Hiermee worden alle gebeurtenisroutes opgehaald. |
| list_incoming_relationships |
Alle binnenkomende relaties voor een digitale dubbel ophalen. |
| list_models |
De lijst met modellen ophalen. |
| list_relationships |
Relaties voor een digitale dubbel ophalen. |
| publish_component_telemetry |
Telemetrie publiceren vanuit het onderdeel van een digitale dubbel, die vervolgens wordt gebruikt door een of meer doeleindpunten (abonnees) die zijn gedefinieerd onder. |
| publish_telemetry |
Publiceer telemetrie van een digitale dubbel, die vervolgens wordt gebruikt door een of meer doeleindpunten (abonnees) die zijn gedefinieerd onder. |
| query_twins |
Query's uitvoeren op digitale dubbels. Opmerking: er kan een vertraging zijn tussen voordat wijzigingen in uw exemplaar worden doorgevoerd in query's. Zie voor meer informatie over querybeperkingen https://docs.microsoft.com/azure/digital-twins/how-to-query-graph#query-limitations |
| update_component |
Eigenschappen van een onderdeel op een digitale dubbel bijwerken met behulp van een JSON-patch. |
| update_digital_twin |
Een digitale dubbel bijwerken met behulp van een JSON-patch. |
| update_relationship |
Updates de eigenschappen van een relatie op een digitale dubbel met behulp van een JSON-patch. |
| upsert_digital_twin |
Een digitale dubbel maken of bijwerken. |
| upsert_event_route |
Een gebeurtenisroute maken of bijwerken. |
| upsert_relationship |
Een relatie op een digitale dubbel maken of bijwerken. |
close
async close() -> Nonecreate_models
Maak een of meer modellen. Wanneer er een fout optreedt, worden er geen modellen geüpload.
async create_models(dtdl_models: List[object], **kwargs) -> List[DigitalTwinsModelData]Parameters
De set modellen die moet worden gemaakt. Elk dict komt overeen met precies één model.
Retouren
De lijst met gemaakte modellen
Retourtype
Uitzonderingen
Een of meer van de opgegeven modellen bestaan al.
decommission_model
Een model buiten gebruik stellen.
async decommission_model(model_id: str, **kwargs) -> NoneParameters
Retouren
Geen
Retourtype
Uitzonderingen
Er is geen model met de opgegeven id.
delete_digital_twin
Een digitale dubbel verwijderen.
async delete_digital_twin(digital_twin_id: str, **kwargs) -> NoneParameters
- match_condition
- MatchConditions
De voorwaarde waaronder de bewerking moet worden uitgevoerd.
- etag
- str
Voer de bewerking alleen uit als de etag van de entiteit overeenkomt met de opgegeven waarde volgens de match_condition.
Retouren
Geen
Retourtype
Uitzonderingen
Als er geen digitale dubbel met de opgegeven id is.
delete_event_route
Een gebeurtenisroute verwijderen.
async delete_event_route(event_route_id: str, **kwargs) -> NoneParameters
Retouren
Geen
Retourtype
Uitzonderingen
Er is geen gebeurtenisroute met de opgegeven id.
delete_model
Een model verwijderen.
async delete_model(model_id: str, **kwargs) -> NoneParameters
Retouren
Geen
Retourtype
Uitzonderingen
Er is geen model met de opgegeven id.
Er zijn afhankelijkheden van het model waardoor het niet kan worden verwijderd.
delete_relationship
Een relatie op een digitale dubbel verwijderen.
async delete_relationship(digital_twin_id: str, relationship_id: str, **kwargs) -> NoneParameters
- match_condition
- MatchConditions
De voorwaarde waaronder de bewerking moet worden uitgevoerd.
- etag
- str
Voer de bewerking alleen uit als de etag van de entiteit overeenkomt met de opgegeven waarde volgens de match_condition.
Retouren
Geen
Retourtype
Uitzonderingen
Als er geen digitale dubbel of relatie met de opgegeven id is.
get_component
Een onderdeel ophalen op een digitale dubbel.
async get_component(digital_twin_id: str, component_name: str, **kwargs) -> Dict[str, object]Parameters
Retouren
Woordenlijst met het onderdeel.
Retourtype
Uitzonderingen
Als er geen digitale dubbel is met de opgegeven id of als de naam van het onderdeel ongeldig is.
get_digital_twin
Download een digitale dubbel.
async get_digital_twin(digital_twin_id: str, **kwargs) -> Dict[str, object]Parameters
Retouren
Woordenlijst met de dubbel.
Retourtype
Uitzonderingen
Als de digitale dubbel niet bestaat.
get_event_route
Een gebeurtenisroute ophalen.
async get_event_route(event_route_id: str, **kwargs) -> DigitalTwinsEventRouteParameters
Retouren
Het gebeurtenisrouteobject.
Retourtype
Uitzonderingen
Er is geen gebeurtenisroute met de opgegeven id.
get_model
Haal een model op, inclusief de metagegevens van het model en de modeldefinitie.
async get_model(model_id: str, **kwargs) -> DigitalTwinsModelDataParameters
- include_model_definition
- bool
Neem de modeldefinitie op als onderdeel van het resultaat. De standaardwaarde is False.
Retouren
De modelgegevens.
Retourtype
Uitzonderingen
Als er geen model is met de opgegeven id.
get_relationship
Een relatie op een digitale dubbel ophalen.
async get_relationship(digital_twin_id: str, relationship_id: str, **kwargs) -> Dict[str, object]Parameters
Retouren
Woordenlijst met de relatie.
Retourtype
Uitzonderingen
Als er geen digitale dubbel of relatie met de opgegeven id is.
list_event_routes
Hiermee worden alle gebeurtenisroutes opgehaald.
list_event_routes(**kwargs) -> AsyncItemPaged[DigitalTwinsEventRoute]Parameters
- results_per_page
- int
Het maximum aantal items dat per aanvraag moet worden opgehaald. De server kan ervoor kiezen om minder dan het aangevraagde maximum te retourneren.
Retouren
Een iterator-exemplaar van gebeurtenisroutes.
Retourtype
Uitzonderingen
list_incoming_relationships
Alle binnenkomende relaties voor een digitale dubbel ophalen.
list_incoming_relationships(digital_twin_id: str, **kwargs) -> AsyncItemPaged[IncomingRelationship]Parameters
Retouren
Een iteratorexemplaren van een lijst met binnenkomende relaties.
Retourtype
Uitzonderingen
Als er geen digitale dubbel met de opgegeven id is.
list_models
De lijst met modellen ophalen.
list_models(dependencies_for: List[str] | None = None, **kwargs) -> AsyncItemPaged[DigitalTwinsModelData]Parameters
De model-id's waarvoor afhankelijkheden moeten worden opgehaald. Als u dit weglaat, worden alle modellen opgehaald.
- include_model_definition
- bool
Neem de modeldefinitie op als onderdeel van de resultaten. De standaardwaarde is False.
- results_per_page
- int
Het maximum aantal items dat per aanvraag moet worden opgehaald. De server kan ervoor kiezen om minder dan het aangevraagde maximum te retourneren.
Retouren
Een iterator-exemplaar van een lijst met modelgegevens.
Retourtype
Uitzonderingen
list_relationships
Relaties voor een digitale dubbel ophalen.
list_relationships(digital_twin_id: str, relationship_id: str | None = None, **kwargs) -> AsyncItemPaged[Dict[str, object]]Parameters
- relationship_id
- str
De id van de relatie die moet worden opgehaald (als deze geen is, wordt alle relatie opgehaald).
Retouren
Een iteratorexemplaren van een lijst met relaties.
Retourtype
Uitzonderingen
Als er geen digitale dubbel met de opgegeven id is.
publish_component_telemetry
Telemetrie publiceren vanuit het onderdeel van een digitale dubbel, die vervolgens wordt gebruikt door een of meer doeleindpunten (abonnees) die zijn gedefinieerd onder.
async publish_component_telemetry(digital_twin_id: str, component_name: str, telemetry: object, **kwargs) -> NoneParameters
- message_id
- str
De bericht-id. Als u dit niet opgeeft, wordt er een UUID gegenereerd.
Retouren
Geen
Retourtype
Uitzonderingen
Als er geen digitale dubbel is met de opgegeven id of als de naam van het onderdeel ongeldig is.
publish_telemetry
Publiceer telemetrie van een digitale dubbel, die vervolgens wordt gebruikt door een of meer doeleindpunten (abonnees) die zijn gedefinieerd onder.
async publish_telemetry(digital_twin_id: str, telemetry: object, **kwargs) -> NoneParameters
- message_id
- str
De bericht-id. Als u dit niet opgeeft, wordt er een UUID gegenereerd.
Retouren
Geen
Retourtype
Uitzonderingen
Als er geen digitale dubbel met de opgegeven id is.
query_twins
Query's uitvoeren op digitale dubbels.
Opmerking: er kan een vertraging zijn tussen voordat wijzigingen in uw exemplaar worden doorgevoerd in query's. Zie voor meer informatie over querybeperkingen https://docs.microsoft.com/azure/digital-twins/how-to-query-graph#query-limitations
query_twins(query_expression: str, **kwargs) -> AsyncItemPaged[Dict[str, object]]Parameters
Retouren
Een iterable van queryresultaten.
Retourtype
Uitzonderingen
update_component
Eigenschappen van een onderdeel op een digitale dubbel bijwerken met behulp van een JSON-patch.
async update_component(digital_twin_id: str, component_name: str, json_patch: List[Dict[str, object]], **kwargs) -> NoneParameters
Een updatespecificatie die wordt beschreven door JSON Patch.
- match_condition
- MatchConditions
De voorwaarde waaronder de bewerking moet worden uitgevoerd.
- etag
- str
Voer de bewerking alleen uit als de etag van de entiteit overeenkomt met de opgegeven waarde volgens de match_condition.
Retouren
Geen
Retourtype
Uitzonderingen
Als er geen digitale dubbel is met de opgegeven id of als de naam van het onderdeel ongeldig is.
update_digital_twin
Een digitale dubbel bijwerken met behulp van een JSON-patch.
async update_digital_twin(digital_twin_id: str, json_patch: List[Dict[str, object]], **kwargs) -> NoneParameters
Een updatespecificatie die wordt beschreven door JSON Patch. Updates voor eigenschapswaarden en $model elementen kunnen plaatsvinden in dezelfde aanvraag. Bewerkingen zijn beperkt tot toevoegen, vervangen en verwijderen.
- match_condition
- MatchConditions
De voorwaarde waaronder de bewerking moet worden uitgevoerd.
- etag
- str
Voer de bewerking alleen uit als de etag van de entiteit overeenkomt met de opgegeven waarde volgens de match_condition.
Retouren
Geen
Retourtype
Uitzonderingen
Als er geen digitale dubbel met de opgegeven id is.
update_relationship
Updates de eigenschappen van een relatie op een digitale dubbel met behulp van een JSON-patch.
async update_relationship(digital_twin_id: str, relationship_id: str, json_patch: List[Dict[str, object]], **kwargs) -> NoneParameters
Beschrijving van de JSON-patch van de update van de relatie-eigenschappen.
- match_condition
- MatchConditions
De voorwaarde waaronder de bewerking moet worden uitgevoerd.
- etag
- str
Voer de bewerking alleen uit als de etag van de entiteit overeenkomt met de opgegeven waarde volgens de match_condition.
Retouren
Geen
Retourtype
Uitzonderingen
Als er geen digitale dubbel of relatie met de opgegeven id is.
upsert_digital_twin
Een digitale dubbel maken of bijwerken.
async upsert_digital_twin(digital_twin_id: str, digital_twin: Dict[str, object], **kwargs) -> Dict[str, object]Parameters
- match_condition
- MatchConditions
De voorwaarde waaronder de bewerking moet worden uitgevoerd.
- etag
- str
Voer de bewerking alleen uit als de etag van de entiteit overeenkomt met de opgegeven waarde volgens de match_condition.
Retouren
Woordenlijst met de gemaakte of bijgewerkte tweeling.
Retourtype
Uitzonderingen
Als de digitale dubbel al bestaat.
upsert_event_route
Een gebeurtenisroute maken of bijwerken.
async upsert_event_route(event_route_id: str, event_route: DigitalTwinsEventRoute, **kwargs) -> NoneParameters
Retouren
Geen
Retourtype
Uitzonderingen
upsert_relationship
Een relatie op een digitale dubbel maken of bijwerken.
async upsert_relationship(digital_twin_id: str, relationship_id: str, relationship: Dict[str, object], **kwargs) -> Dict[str, object]Parameters
- match_condition
- MatchConditions
De voorwaarde waaronder de bewerking moet worden uitgevoerd.
- etag
- str
Voer de bewerking alleen uit als de etag van de entiteit overeenkomt met de opgegeven waarde volgens de match_condition.
Retouren
De gemaakte of bijgewerkte relatie.
Retourtype
Uitzonderingen
Als er geen digitale dubbel is, richt u de digitale dubbel op of de relatie met de opgegeven id.
