az dt twin relationship

Kommentar

Den här referensen är en del av azure-iot-tillägget för Azure CLI (version 2.46.0 eller senare). Tillägget installeras automatiskt första gången du kör ett az dt twin-relationskommando . Läs mer om tillägg.

Hantera och konfigurera digitala tvillingrelationer för en Digital Twins-instans.

Kommandon

Name Description Typ Status
az dt twin relationship create

Skapa en relation mellan digitala käll- och måltvillingar.

Anknytning Allmän tillgänglighet
az dt twin relationship delete

Ta bort en digital tvillingrelation på en Digital Twins-instans.

Anknytning Allmän tillgänglighet
az dt twin relationship delete-all

Tar bort alla digitala tvillingrelationer i en Digital Twins-instans, inklusive inkommande relationer.

Anknytning Allmän tillgänglighet
az dt twin relationship list

Visa en lista över relationerna för en digital tvilling.

Anknytning Allmän tillgänglighet
az dt twin relationship show

Visa information om en digital tvillingrelation.

Anknytning Allmän tillgänglighet
az dt twin relationship update

Uppdaterar egenskaperna för en relation mellan två digitala tvillingar via JSON-korrigeringsspecifikationen.

Anknytning Allmän tillgänglighet

az dt twin relationship create

Skapa en relation mellan digitala käll- och måltvillingar.

--properties kan vara infogad JSON eller filsökväg.

az dt twin relationship create --dt-name
                               --kind
                               --relationship-id
                               --source
                               --target
                               [--if-none-match]
                               [--properties]
                               [--resource-group]

Exempel

Skapa en relation mellan två digitala tvillingar.

az dt twin relationship create -n {instance_or_hostname} --relationship-id {relationship_id} --relationship contains --twin-id {source_twin_id} --target {target_twin_id}

Skapa en relation mellan två digitala tvillingar med taggen if-none-match

az dt twin relationship create -n {instance_or_hostname} --relationship-id {relationship_id} --relationship contains --twin-id {source_twin_id} --target {target_twin_id} --if-none-match

Skapa en relation med initierade egenskaper mellan två digitala tvillingar.

az dt twin relationship create -n {instance_or_hostname} --relationship-id {relationship_id} --relationship contains --twin-id {source_twin_id} --target {target_twin_id} --properties '{"ownershipUser": "me", "ownershipDepartment": "Computer Science"}'

Obligatoriska parametrar

--dt-name --dtn -n

Digital Twins-instansnamn eller värdnamn. Om ett instansnamn anges efterfrågas först användarprenumerationen för målinstansen för att hämta värdnamnet. Om ett värdnamn anges hoppas prenumerationsfrågan över och det angivna värdet används för efterföljande interaktion.

--kind --relationship

Relationsnamn eller typ. Till exempel: "contains".

--relationship-id -r

Relations-ID.

--source --twin-id -t

Källtvillingens ID för en relation.

--target --target-twin-id

Måltvillingens ID för en relation.

Valfria parametrar

--if-none-match

Anger att åtgärden create ska misslyckas om det finns en befintlig tvilling med samma ID.

standardvärde: False
--properties -p

Inledande egenskapsvärden för instansiering av en digital tvillingrelation. Ange filsökväg eller infogad JSON.

--resource-group -g

Digital Twins-instansresursgrupp. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az dt twin relationship delete

Ta bort en digital tvillingrelation på en Digital Twins-instans.

az dt twin relationship delete --dt-name
                               --relationship-id
                               --source
                               [--etag]
                               [--resource-group]

Exempel

Ta bort en digital tvillingrelation.

az dt twin relationship delete -n {instance_or_hostname} --twin-id {twin_id} --relationship-id {relationship_id}

Ta bort en digital tvillingrelation med hjälp av etag.

az dt twin relationship delete -n {instance_or_hostname} --twin-id {twin_id} --relationship-id {relationship_id} --etag {etag}

Obligatoriska parametrar

--dt-name --dtn -n

Digital Twins-instansnamn eller värdnamn. Om ett instansnamn anges efterfrågas först användarprenumerationen för målinstansen för att hämta värdnamnet. Om ett värdnamn anges hoppas prenumerationsfrågan över och det angivna värdet används för efterföljande interaktion.

--relationship-id -r

Relations-ID.

--source --twin-id -t

Källtvillingens ID för en relation.

Valfria parametrar

--etag -e

Entitetstaggvärde. Kommandot lyckas om etag matchar resursens aktuella etag.

--resource-group -g

Digital Twins-instansresursgrupp. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az dt twin relationship delete-all

Tar bort alla digitala tvillingrelationer i en Digital Twins-instans, inklusive inkommande relationer.

az dt twin relationship delete-all --dt-name
                                   [--resource-group]
                                   [--source]
                                   [--yes]

Exempel

Ta bort alla digitala tvillingrelationer som är associerade med tvillingen.

az dt twin relationship delete-all -n {instance_or_hostname} --twin-id {twin_id}

Ta bort alla digitala tvillingrelationer i Digital Twins-instace.

az dt twin relationship delete-all -n {instance_or_hostname}

Obligatoriska parametrar

--dt-name --dtn -n

Digital Twins-instansnamn eller värdnamn. Om ett instansnamn anges efterfrågas först användarprenumerationen för målinstansen för att hämta värdnamnet. Om ett värdnamn anges hoppas prenumerationsfrågan över och det angivna värdet används för efterföljande interaktion.

Valfria parametrar

--resource-group -g

Digital Twins-instansresursgrupp. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

--source --twin-id -t

Källtvillingens ID för en relation.

--yes -y

Fråga inte efter bekräftelse.

standardvärde: False
Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az dt twin relationship list

Visa en lista över relationerna för en digital tvilling.

az dt twin relationship list --dt-name
                             --source
                             [--incoming {false, true}]
                             [--kind]
                             [--resource-group]

Exempel

Lista utgående relationer för en digital tvilling.

az dt twin relationship list -n {instance_or_hostname} --twin-id {twin_id}

Lista utgående relationer för en digital tvilling och filtrera på relationen "innehåller"

az dt twin relationship list -n {instance_or_hostname} --twin-id {twin_id} --relationship contains

Visa en lista över inkommande relationer för en digital tvilling.

az dt twin relationship list -n {instance_or_hostname} --twin-id {twin_id} --incoming

Lista inkommande relationer för en digital tvilling och filtrera på relationen "contains".

az dt twin relationship list -n {instance_or_hostname} --twin-id {twin_id} --relationship contains --incoming

Obligatoriska parametrar

--dt-name --dtn -n

Digital Twins-instansnamn eller värdnamn. Om ett instansnamn anges efterfrågas först användarprenumerationen för målinstansen för att hämta värdnamnet. Om ett värdnamn anges hoppas prenumerationsfrågan över och det angivna värdet används för efterföljande interaktion.

--source --twin-id -t

Källtvillingens ID för en relation.

Valfria parametrar

--incoming

Hämtar alla inkommande relationer för en digital tvilling.

accepterade värden: false, true
standardvärde: False
--kind --relationship

Filtrera resultatet efter typen av relation.

--resource-group -g

Digital Twins-instansresursgrupp. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az dt twin relationship show

Visa information om en digital tvillingrelation.

az dt twin relationship show --dt-name
                             --relationship-id
                             --source
                             [--resource-group]

Exempel

Visa information om en digital tvillingrelation.

az dt twin relationship show -n {instance_or_hostname} --twin-id {twin_id} --relationship-id {relationship_id}

Obligatoriska parametrar

--dt-name --dtn -n

Digital Twins-instansnamn eller värdnamn. Om ett instansnamn anges efterfrågas först användarprenumerationen för målinstansen för att hämta värdnamnet. Om ett värdnamn anges hoppas prenumerationsfrågan över och det angivna värdet används för efterföljande interaktion.

--relationship-id -r

Relations-ID.

--source --twin-id -t

Källtvillingens ID för en relation.

Valfria parametrar

--resource-group -g

Digital Twins-instansresursgrupp. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az dt twin relationship update

Uppdaterar egenskaperna för en relation mellan två digitala tvillingar via JSON-korrigeringsspecifikationen.

Åtgärderna är begränsade till att lägga till, ersätta och ta bort.

az dt twin relationship update --dt-name
                               --json-patch
                               --relationship-id
                               --source
                               [--etag]
                               [--resource-group]

Exempel

Uppdatera en digital tvillingrelation via JSON-korrigeringsspecifikationen.

az dt twin relationship update -n {instance_or_hostname} --twin-id {twin_id} --relationship-id {relationship_id} --relationship contains --json-patch '{"op":"replace", "path":"/Temperature", "value": 20.5}'

Uppdatera en digital tvillingrelation via JSON-korrigeringsspecifikationen och med hjälp av etag.

az dt twin relationship update -n {instance_or_hostname} --twin-id {twin_id} --relationship-id {relationship_id} --relationship contains --json-patch '{"op":"replace", "path":"/Temperature", "value": 20.5}' --etag {etag}

Uppdatera en digital tvillingrelation via JSON-korrigeringsspecifikationen.

az dt twin relationship update -n {instance_or_hostname} --twin-id {twin_id} --relationship-id {relationship_id} --relationship contains --json-patch '[
  {"op":"replace", "path":"/Temperature", "value": 20.5},
  {"op":"add", "path":"/Areas", "value": ["ControlSystem"]}
]'

Uppdatera en digital tvillingrelation via JSON-korrigeringsspecifikationen som definierats i en fil.

az dt twin relationship update -n {instance_or_hostname} --twin-id {twin_id} --relationship-id {relationship_id} --relationship contains --json-patch ./my/patch/document.json

Obligatoriska parametrar

--dt-name --dtn -n

Digital Twins-instansnamn eller värdnamn. Om ett instansnamn anges efterfrågas först användarprenumerationen för målinstansen för att hämta värdnamnet. Om ett värdnamn anges hoppas prenumerationsfrågan över och det angivna värdet används för efterföljande interaktion.

--json-patch --patch

En uppdateringsspecifikation som beskrivs av JSON-patch. Uppdateringar av egenskapsvärden och $model element kan inträffa i samma begäran. Åtgärderna är begränsade till att lägga till, ersätta och ta bort. Ange filsökväg eller infogad JSON.

--relationship-id -r

Relations-ID.

--source --twin-id -t

Källtvillingens ID för en relation.

Valfria parametrar

--etag -e

Entitetstaggvärde. Kommandot lyckas om etag matchar resursens aktuella etag.

--resource-group -g

Digital Twins-instansresursgrupp. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.