DigitalTwinsClient クラス

Digital Twins クライアントのインスタンスを作成します。

継承
builtins.object
DigitalTwinsClient

コンストラクター

DigitalTwinsClient(endpoint: str, credential: TokenCredential, **kwargs: Any)

パラメーター

endpoint
str
必須

Azure 検索サービスの URL エンドポイント

credential
TokenCredential
必須

サービスに対する要求を認証するための資格情報

メソッド

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]

パラメーター

model_list
List[Dict[str,object]]
必須

作成するモデルのセット。 各ディクテーションは、1 つのモデルに正確に対応します。

戻り値

作成されたモデルの一覧。

の戻り値の型 :

例外

指定されたモデルの 1 つ以上が既に存在します。

decommission_model

モデルの使用を停止します。

decommission_model(model_id: str, **kwargs: Any) -> None

パラメーター

model_id
str
必須

モデルの ID。 ID はグローバルに一意であり、大文字と小文字が区別されます。

戻り値

なし

の戻り値の型 :

例外

指定された ID を持つモデルはありません。

delete_digital_twin

デジタル ツインを削除します。

delete_digital_twin(digital_twin_id: str, **kwargs: Any) -> None

パラメーター

digital_twin_id
str
必須

デジタル ツインの ID。

match_condition
MatchConditions

操作を実行する条件。

etag
str

エンティティの etag が、match_conditionに従って指定された値と一致する場合にのみ、操作を実行 します

戻り値

なし

の戻り値の型 :

例外

指定された ID を持つデジタル ツインがない場合。

delete_event_route

イベント ルートを削除します。

delete_event_route(event_route_id: str, **kwargs: Any) -> None

パラメーター

event_route_id
str
必須

削除するイベント ルートの ID。

戻り値

なし

の戻り値の型 :

例外

指定された ID を持つイベント ルートはありません。

delete_model

モデルを削除します。

delete_model(model_id: str, **kwargs: Any) -> None

パラメーター

model_id
str
必須

削除するモデルの ID。

戻り値

なし

の戻り値の型 :

例外

指定された ID を持つモデルはありません。

モデルには、削除されない依存関係があります。

delete_relationship

デジタル ツインのリレーションシップを削除します。

delete_relationship(digital_twin_id: str, relationship_id: str, **kwargs: Any) -> None

パラメーター

digital_twin_id
str
必須

デジタル ツインの ID。

relationship_id
str
必須

削除するリレーションシップの ID。

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]

パラメーター

digital_twin_id
str
必須

デジタル ツインの ID。

component_name
str
必須

取得するコンポーネント。

戻り値

コンポーネントを含むディクショナリ。

の戻り値の型 :

例外

指定された ID を持つデジタル ツインがない場合、またはコンポーネント名が無効な場合。

get_digital_twin

デジタル ツインを取得します。

get_digital_twin(digital_twin_id: str, **kwargs: Any) -> Dict[str, object]

パラメーター

digital_twin_id
str
必須

デジタル ツインの ID。

戻り値

ツインを含むディクショナリ。

の戻り値の型 :

例外

デジタル ツインが存在しない場合。

get_event_route

イベント ルートを取得します。

get_event_route(event_route_id: str, **kwargs: Any) -> DigitalTwinsEventRoute

パラメーター

event_route_id
str
必須

イベント ルートの ID。

戻り値

イベント ルート オブジェクト。

の戻り値の型 :

例外

指定された ID を持つイベント ルートはありません。

get_model

モデルメタデータやモデル定義を含むモデルを取得します。

get_model(model_id: str, **kwargs: Any) -> DigitalTwinsModelData

パラメーター

model_id
str
必須

モデルの ID。

include_model_definition
bool

モデル定義を結果の一部として含めます。 既定値は False です。

戻り値

モデル データ。

の戻り値の型 :

例外

指定された ID を持つモデルがない場合。

get_relationship

デジタル ツインのリレーションシップを取得します。

get_relationship(digital_twin_id: str, relationship_id: str, **kwargs: Any) -> Dict[str, object]

パラメーター

digital_twin_id
str
必須

デジタル ツインの ID。

relationship_id
str
必須

取得するリレーションシップの ID。

戻り値

リレーションシップを含むディクショナリ。

の戻り値の型 :

例外

デジタル ツインまたは指定された 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]

パラメーター

digital_twin_id
str
必須

デジタル ツインの ID。

戻り値

いずれかの Relationship のインスタンスのような反復子。

の戻り値の型 :

例外

指定された ID を持つデジタル ツインがない場合。

list_models

モデルの一覧を取得します。

list_models(dependencies_for: List[str] | None = None, **kwargs: Any) -> ItemPaged[DigitalTwinsModelData]

パラメーター

dependencies_for
List[str]
必須

依存関係を取得するモデル ID。 省略すると、すべてのモデルが取得されます。

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]]

パラメーター

digital_twin_id
str
必須

デジタル ツインの ID。

relationship_id
str
必須

取得するリレーションシップの ID (None の場合、すべてのリレーションシップが取得されます)。

戻り値

リレーションシップのリストの反復子インスタンス

の戻り値の型 :

例外

指定された ID を持つデジタル ツインがない場合。

publish_component_telemetry

デジタル ツインのコンポーネントからテレメトリを発行します。このコンポーネントは、 で定義されている 1 つまたは複数の宛先エンドポイント (サブスクライバー) によって使用されます。

publish_component_telemetry(digital_twin_id: str, component_name: str, telemetry: object, **kwargs: Any) -> None

パラメーター

digital_twin_id
str
必須

デジタル ツインの ID。

component_name
str
必須

DTDL コンポーネントの名前。

telemetry
object
必須

送信するテレメトリ データ。

message_id
str

メッセージ ID。 指定しない場合は、UUID が生成されます。

戻り値

なし

の戻り値の型 :

例外

指定された ID を持つデジタル ツインがない場合、またはコンポーネント名が無効です。

publish_telemetry

デジタル ツインからテレメトリを発行します。このテレメトリは、 で定義されている 1 つまたは複数の宛先エンドポイント (サブスクライバー) によって使用されます。

publish_telemetry(digital_twin_id: str, telemetry: object, **kwargs: Any) -> None

パラメーター

digital_twin_id
str
必須

デジタル ツインの ID

telemetry
object
必須

送信するテレメトリ データ

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]]

パラメーター

query_expression
str
必須

実行するクエリ式。

戻り値

クエリ結果の許容量。

の戻り値の型 :

例外

update_component

JSON パッチを使用して、デジタル ツイン上のコンポーネントのプロパティを更新します。

update_component(digital_twin_id: str, component_name: str, json_patch: List[Dict[str, object]], **kwargs: Any) -> None

パラメーター

digital_twin_id
str
必須

デジタル ツインの ID。

component_name
str
必須

更新されるコンポーネント。

json_patch
List[Dict[str,object]]
必須

JSON Patch で説明されている更新プログラムの仕様。

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

パラメーター

digital_twin_id
str
必須

デジタル ツインの ID。

json_patch
List[Dict[str,object]]
必須

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

パラメーター

digital_twin_id
str
必須

デジタル ツインの ID。

relationship_id
str
必須

取得するリレーションシップの ID。

json_patch
List[Dict[str,object]]
必須

リレーションシップ プロパティの更新に関する JSON パッチの説明。

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]

パラメーター

digital_twin_id
str
必須

デジタル ツインの ID。

digital_twin
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

パラメーター

event_route_id
str
必須

作成または更新するイベント ルートの ID。

event_route
DigitalTwinsEventRoute
必須

イベント ルート データ。

戻り値

なし

の戻り値の型 :

例外

upsert_relationship

デジタル ツインでリレーションシップを作成または更新します。

upsert_relationship(digital_twin_id: str, relationship_id: str, relationship: Dict[str, object], **kwargs: Any) -> Dict[str, object]

パラメーター

digital_twin_id
str
必須

デジタル ツインの ID。

relationship_id
str
必須

取得するリレーションシップの ID。

relationship
Dict[str,object]
必須

リレーションシップを含むディクショナリ。

match_condition
MatchConditions

操作を実行する条件。

etag
str

エンティティの etag が、 match_conditionに従って指定された値と一致する場合にのみ、操作を実行します。

戻り値

作成または更新されたリレーションシップ。

の戻り値の型 :

例外

デジタル ツインがない場合は、指定された ID を使用してデジタル ツインまたはリレーションシップをターゲットにします。