DigitalTwinsClient クラス
Digital Twins クライアントのインスタンスを作成します。
- 継承
-
builtins.objectDigitalTwinsClient
コンストラクター
DigitalTwinsClient(endpoint: str, credential: TokenCredential, **kwargs: Any)
パラメーター
メソッド
create_models |
1 つ以上のモデルを作成します。 エラーが発生した場合、モデルはアップロードされません。 |
decommission_model |
モデルの使用を停止します。 |
delete_digital_twin |
デジタル ツインを削除します。 |
delete_event_route |
イベント ルートを削除します。 |
delete_model |
モデルを削除します。 |
delete_relationship |
デジタル ツインのリレーションシップを削除します。 |
get_component |
デジタル ツインのコンポーネントを取得します。 |
get_digital_twin |
デジタル ツインを取得します。 |
get_event_route |
イベント ルートを取得します。 |
get_model |
モデルメタデータやモデル定義を含むモデルを取得します。 |
get_relationship |
デジタル ツインのリレーションシップを取得します。 |
list_event_routes |
すべてのイベント ルートを取得します。 |
list_incoming_relationships |
デジタル ツインのすべての受信リレーションシップを取得します。 |
list_models |
モデルの一覧を取得します。 |
list_relationships |
デジタル ツインのリレーションシップを取得します。 |
publish_component_telemetry |
デジタル ツインのコンポーネントからテレメトリを発行します。このコンポーネントは、 で定義されている 1 つまたは複数の宛先エンドポイント (サブスクライバー) によって使用されます。 |
publish_telemetry |
デジタル ツインからテレメトリを発行します。このテレメトリは、 で定義されている 1 つまたは複数の宛先エンドポイント (サブスクライバー) によって使用されます。 |
query_twins |
デジタル ツインのクエリ。 注: インスタンスの変更がクエリに反映されるまでに遅延が発生する可能性があります。 クエリの制限の詳細については、次を参照してください。 https://docs.microsoft.com/azure/digital-twins/how-to-query-graph#query-limitations |
update_component |
JSON パッチを使用して、デジタル ツイン上のコンポーネントのプロパティを更新します。 |
update_digital_twin |
JSON パッチを使用してデジタル ツインを更新します。 |
update_relationship |
JSON パッチを使用して、デジタル ツイン上のリレーションシップのプロパティを更新します。 |
upsert_digital_twin |
デジタル ツインを作成または更新します。 |
upsert_event_route |
イベント ルートを作成または更新します。 |
upsert_relationship |
デジタル ツインでリレーションシップを作成または更新します。 |
create_models
1 つ以上のモデルを作成します。 エラーが発生した場合、モデルはアップロードされません。
create_models(dtdl_models: List[Dict[str, object]], **kwargs: Any) -> List[DigitalTwinsModelData]
パラメーター
戻り値
作成されたモデルの一覧。
の戻り値の型 :
例外
指定されたモデルの 1 つ以上が既に存在します。
decommission_model
モデルの使用を停止します。
decommission_model(model_id: str, **kwargs: Any) -> None
パラメーター
戻り値
なし
の戻り値の型 :
例外
指定された ID を持つモデルはありません。
delete_digital_twin
デジタル ツインを削除します。
delete_digital_twin(digital_twin_id: str, **kwargs: Any) -> None
パラメーター
- match_condition
- MatchConditions
操作を実行する条件。
- etag
- str
エンティティの etag が、match_conditionに従って指定された値と一致する場合にのみ、操作を実行 します。
戻り値
なし
の戻り値の型 :
例外
指定された ID を持つデジタル ツインがない場合。
delete_event_route
イベント ルートを削除します。
delete_event_route(event_route_id: str, **kwargs: Any) -> None
パラメーター
戻り値
なし
の戻り値の型 :
例外
指定された ID を持つイベント ルートはありません。
delete_model
モデルを削除します。
delete_model(model_id: str, **kwargs: Any) -> None
パラメーター
戻り値
なし
の戻り値の型 :
例外
指定された ID を持つモデルはありません。
モデルには、削除されない依存関係があります。
delete_relationship
デジタル ツインのリレーションシップを削除します。
delete_relationship(digital_twin_id: str, relationship_id: str, **kwargs: Any) -> None
パラメーター
- match_condition
- MatchConditions
操作を実行する条件。
- etag
- str
エンティティの etag が、match_conditionに従って指定された値と一致する場合にのみ、操作を実行 します。
戻り値
なし
の戻り値の型 :
例外
デジタル ツインまたは指定された ID との関係がない場合。
get_component
デジタル ツインのコンポーネントを取得します。
get_component(digital_twin_id: str, component_name: str, **kwargs: Any) -> Dict[str, object]
パラメーター
戻り値
コンポーネントを含むディクショナリ。
の戻り値の型 :
例外
指定された ID を持つデジタル ツインがない場合、またはコンポーネント名が無効な場合。
get_digital_twin
デジタル ツインを取得します。
get_digital_twin(digital_twin_id: str, **kwargs: Any) -> Dict[str, object]
パラメーター
戻り値
ツインを含むディクショナリ。
の戻り値の型 :
例外
デジタル ツインが存在しない場合。
get_event_route
イベント ルートを取得します。
get_event_route(event_route_id: str, **kwargs: Any) -> DigitalTwinsEventRoute
パラメーター
戻り値
イベント ルート オブジェクト。
の戻り値の型 :
例外
指定された ID を持つイベント ルートはありません。
get_model
モデルメタデータやモデル定義を含むモデルを取得します。
get_model(model_id: str, **kwargs: Any) -> DigitalTwinsModelData
パラメーター
- include_model_definition
- bool
モデル定義を結果の一部として含めます。 既定値は False です。
戻り値
モデル データ。
の戻り値の型 :
例外
指定された ID を持つモデルがない場合。
get_relationship
デジタル ツインのリレーションシップを取得します。
get_relationship(digital_twin_id: str, relationship_id: str, **kwargs: Any) -> Dict[str, object]
パラメーター
戻り値
リレーションシップを含むディクショナリ。
の戻り値の型 :
例外
デジタル ツインまたは指定された ID との関係がない場合。
list_event_routes
すべてのイベント ルートを取得します。
list_event_routes(**kwargs: Any) -> ItemPaged[DigitalTwinsEventRoute]
パラメーター
- results_per_page
- int
要求ごとに取得するアイテムの最大数。 サーバーは、要求された最大値より小さい値を返すように選択できます。
戻り値
イベント ルートの反復子インスタンス。
の戻り値の型 :
例外
list_incoming_relationships
デジタル ツインのすべての受信リレーションシップを取得します。
list_incoming_relationships(digital_twin_id: str, **kwargs: Any) -> ItemPaged[IncomingRelationship]
パラメーター
戻り値
いずれかの Relationship のインスタンスのような反復子。
の戻り値の型 :
例外
指定された ID を持つデジタル ツインがない場合。
list_models
モデルの一覧を取得します。
list_models(dependencies_for: List[str] | None = None, **kwargs: Any) -> ItemPaged[DigitalTwinsModelData]
パラメーター
- include_model_definition
- bool
モデル定義を結果の一部として含めます。 既定値は False です。
- results_per_page
- int
要求ごとに取得するアイテムの最大数。 サーバーは、要求された最大値より小さい値を返すように選択できます。
戻り値
モデル データのリストの反復子インスタンス。
の戻り値の型 :
例外
list_relationships
デジタル ツインのリレーションシップを取得します。
list_relationships(digital_twin_id: str, relationship_id: str | None = None, **kwargs: Any) -> ItemPaged[Dict[str, object]]
パラメーター
戻り値
リレーションシップのリストの反復子インスタンス
の戻り値の型 :
例外
指定された ID を持つデジタル ツインがない場合。
publish_component_telemetry
デジタル ツインのコンポーネントからテレメトリを発行します。このコンポーネントは、 で定義されている 1 つまたは複数の宛先エンドポイント (サブスクライバー) によって使用されます。
publish_component_telemetry(digital_twin_id: str, component_name: str, telemetry: object, **kwargs: Any) -> None
パラメーター
- message_id
- str
メッセージ ID。 指定しない場合は、UUID が生成されます。
戻り値
なし
の戻り値の型 :
例外
指定された ID を持つデジタル ツインがない場合、またはコンポーネント名が無効です。
publish_telemetry
デジタル ツインからテレメトリを発行します。このテレメトリは、 で定義されている 1 つまたは複数の宛先エンドポイント (サブスクライバー) によって使用されます。
publish_telemetry(digital_twin_id: str, telemetry: object, **kwargs: Any) -> None
パラメーター
- message_id
- str
メッセージ ID。 指定しない場合は、UUID が生成されます。
戻り値
なし
の戻り値の型 :
例外
指定された ID を持つデジタル ツインがない場合。
query_twins
デジタル ツインのクエリ。
注: インスタンスの変更がクエリに反映されるまでに遅延が発生する可能性があります。 クエリの制限の詳細については、次を参照してください。 https://docs.microsoft.com/azure/digital-twins/how-to-query-graph#query-limitations
query_twins(query_expression: str, **kwargs: Any) -> ItemPaged[Dict[str, object]]
パラメーター
戻り値
クエリ結果の許容量。
の戻り値の型 :
例外
update_component
JSON パッチを使用して、デジタル ツイン上のコンポーネントのプロパティを更新します。
update_component(digital_twin_id: str, component_name: str, json_patch: List[Dict[str, object]], **kwargs: Any) -> None
パラメーター
- match_condition
- MatchConditions
操作を実行する条件。
- etag
- str
エンティティの etag が、 match_conditionに従って指定された値と一致する場合にのみ、操作を実行します。
戻り値
なし
の戻り値の型 :
例外
指定された ID を持つデジタル ツインがない場合、またはコンポーネント名が無効な場合。
update_digital_twin
JSON パッチを使用してデジタル ツインを更新します。
update_digital_twin(digital_twin_id: str, json_patch: List[Dict[str, object]], **kwargs: Any) -> None
パラメーター
JSON Patch で説明されている更新プログラムの仕様。 プロパティ値と$model要素への更新は、同じ要求で発生する可能性があります。 操作は、 追加、 置換 、 および削除に制限されます。
- match_condition
- MatchConditions
操作を実行する条件。
- etag
- str
エンティティの etag が、 match_conditionに従って指定された値と一致する場合にのみ、操作を実行します。
戻り値
なし
の戻り値の型 :
例外
指定された ID を持つデジタル ツインがない場合。
update_relationship
JSON パッチを使用して、デジタル ツイン上のリレーションシップのプロパティを更新します。
update_relationship(digital_twin_id: str, relationship_id: str, json_patch: List[Dict[str, object]], **kwargs: Any) -> None
パラメーター
- match_condition
- MatchConditions
操作を実行する条件。
- etag
- str
エンティティの etag が、 match_conditionに従って指定された値と一致する場合にのみ、操作を実行します。
戻り値
なし
の戻り値の型 :
例外
指定された ID を持つデジタル ツインまたはリレーションシップがない場合。
upsert_digital_twin
デジタル ツインを作成または更新します。
upsert_digital_twin(digital_twin_id: str, digital_twin: Dict[str, object], **kwargs: Any) -> Dict[str, object]
パラメーター
- match_condition
- MatchConditions
操作を実行する条件。
- etag
- str
エンティティの etag が、 match_conditionに従って指定された値と一致する場合にのみ、操作を実行します。
戻り値
作成または更新されたツインを含むディクショナリ。
の戻り値の型 :
例外
デジタル ツインが既に存在する場合。
upsert_event_route
イベント ルートを作成または更新します。
upsert_event_route(event_route_id: str, event_route: DigitalTwinsEventRoute, **kwargs: Any) -> None
パラメーター
戻り値
なし
の戻り値の型 :
例外
upsert_relationship
デジタル ツインでリレーションシップを作成または更新します。
upsert_relationship(digital_twin_id: str, relationship_id: str, relationship: Dict[str, object], **kwargs: Any) -> Dict[str, object]
パラメーター
- match_condition
- MatchConditions
操作を実行する条件。
- etag
- str
エンティティの etag が、 match_conditionに従って指定された値と一致する場合にのみ、操作を実行します。
戻り値
作成または更新されたリレーションシップ。
の戻り値の型 :
例外
デジタル ツインがない場合は、指定された ID を使用してデジタル ツインまたはリレーションシップをターゲットにします。
Azure SDK for Python