Partilhar via


az dt twin relationship

Nota

Essa referência faz parte da extensão azure-iot para a CLI do Azure (versão 2.46.0 ou superior). A extensão será instalada automaticamente na primeira vez que você executar um comando az dt twin relationship . Saiba mais sobre extensões.

Gerencie e configure as relações de gêmeos digitais de uma instância de gêmeos digitais.

Comandos

Name Description Tipo Estado
az dt twin relationship create

Crie uma relação entre gêmeos digitais de origem e de destino.

Extensão GA
az dt twin relationship delete

Exclua um relacionamento de gêmeos digitais em uma instância de gêmeos digitais.

Extensão GA
az dt twin relationship delete-all

Exclui todos os relacionamentos de gêmeos digitais em uma instância de gêmeos digitais, incluindo relacionamentos de entrada.

Extensão GA
az dt twin relationship list

Liste as relações de um gêmeo digital.

Extensão GA
az dt twin relationship show

Mostrar detalhes de uma relação de gêmeos digitais.

Extensão GA
az dt twin relationship update

Atualiza as propriedades de um relacionamento entre dois gêmeos digitais por meio da especificação de patch JSON.

Extensão GA

az dt twin relationship create

Crie uma relação entre gêmeos digitais de origem e de destino.

--properties pode ser JSON embutido ou caminho de arquivo.

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

Exemplos

Crie uma relação entre dois gémeos digitais.

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

Crie uma relação entre dois gêmeos digitais com a tag 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

Crie uma relação com propriedades inicializadas entre dois gêmeos digitais.

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"}'

Parâmetros Obrigatórios

--dt-name --dtn -n

Nome da instância ou nome do host do Digital Twins. Se um nome de instância for fornecido, a assinatura do usuário será consultada primeiro para que a instância de destino recupere o nome do host. Se um nome de host for fornecido, a consulta de assinatura será ignorada e o valor fornecido será usado para interação subsequente.

--kind --relationship

Nome ou tipo de relacionamento. Por exemplo: «contém».

--relationship-id -r

Id do relacionamento.

--source --twin-id -t

O gêmeo de origem Id para um relacionamento.

--target --target-twin-id

O Id gêmeo alvo para um relacionamento.

Parâmetros Opcionais

--if-none-match

Indica que a operação create deve falhar se existir um gêmeo existente com a mesma id.

valor predefinido: False
--properties -p

Valores de propriedade iniciais para instanciar uma relação de gêmeo digital. Forneça o caminho do arquivo ou JSON embutido.

--resource-group -g

Grupo de recursos de instância de gêmeos digitais. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az dt twin relationship delete

Exclua um relacionamento de gêmeos digitais em uma instância de gêmeos digitais.

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

Exemplos

Excluir uma relação de gêmeo digital.

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

Exclua uma relação de gêmeo digital usando o etag.

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

Parâmetros Obrigatórios

--dt-name --dtn -n

Nome da instância ou nome do host do Digital Twins. Se um nome de instância for fornecido, a assinatura do usuário será consultada primeiro para que a instância de destino recupere o nome do host. Se um nome de host for fornecido, a consulta de assinatura será ignorada e o valor fornecido será usado para interação subsequente.

--relationship-id -r

Id do relacionamento.

--source --twin-id -t

O gêmeo de origem Id para um relacionamento.

Parâmetros Opcionais

--etag -e

Valor da tag de entidade. O comando terá êxito se o etag corresponder ao etag atual do recurso.

--resource-group -g

Grupo de recursos de instância de gêmeos digitais. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az dt twin relationship delete-all

Exclui todos os relacionamentos de gêmeos digitais em uma instância de gêmeos digitais, incluindo relacionamentos de entrada.

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

Exemplos

Exclua todas as relações de gêmeo digital associadas ao gêmeo.

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

Exclua todos os relacionamentos de gêmeos digitais dentro da instace Digital Twins.

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

Parâmetros Obrigatórios

--dt-name --dtn -n

Nome da instância ou nome do host do Digital Twins. Se um nome de instância for fornecido, a assinatura do usuário será consultada primeiro para que a instância de destino recupere o nome do host. Se um nome de host for fornecido, a consulta de assinatura será ignorada e o valor fornecido será usado para interação subsequente.

Parâmetros Opcionais

--resource-group -g

Grupo de recursos de instância de gêmeos digitais. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--source --twin-id -t

O gêmeo de origem Id para um relacionamento.

--yes -y

Não solicite confirmação.

valor predefinido: False
Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az dt twin relationship list

Liste as relações de um gêmeo digital.

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

Exemplos

Listar relacionamentos de saída de um gêmeo digital.

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

Listar relacionamentos de saída de um gêmeo digital e filtrar o relacionamento 'contém'

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

Liste os relacionamentos de entrada de um gêmeo digital.

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

Liste as relações de entrada de um gêmeo digital e filtre o relacionamento "contém".

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

Parâmetros Obrigatórios

--dt-name --dtn -n

Nome da instância ou nome do host do Digital Twins. Se um nome de instância for fornecido, a assinatura do usuário será consultada primeiro para que a instância de destino recupere o nome do host. Se um nome de host for fornecido, a consulta de assinatura será ignorada e o valor fornecido será usado para interação subsequente.

--source --twin-id -t

O gêmeo de origem Id para um relacionamento.

Parâmetros Opcionais

--incoming

Recupera todos os relacionamentos de entrada para um gêmeo digital.

valores aceites: false, true
valor predefinido: False
--kind --relationship

Filtrar o resultado pelo tipo de relação.

--resource-group -g

Grupo de recursos de instância de gêmeos digitais. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az dt twin relationship show

Mostrar detalhes de uma relação de gêmeos digitais.

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

Exemplos

Mostrar detalhes de uma relação de gêmeos digitais.

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

Parâmetros Obrigatórios

--dt-name --dtn -n

Nome da instância ou nome do host do Digital Twins. Se um nome de instância for fornecido, a assinatura do usuário será consultada primeiro para que a instância de destino recupere o nome do host. Se um nome de host for fornecido, a consulta de assinatura será ignorada e o valor fornecido será usado para interação subsequente.

--relationship-id -r

Id do relacionamento.

--source --twin-id -t

O gêmeo de origem Id para um relacionamento.

Parâmetros Opcionais

--resource-group -g

Grupo de recursos de instância de gêmeos digitais. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az dt twin relationship update

Atualiza as propriedades de um relacionamento entre dois gêmeos digitais por meio da especificação de patch JSON.

As operações são limitadas para adicionar, substituir e remover.

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

Exemplos

Atualize uma relação de gêmeo digital via especificação de patch JSON.

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}'

Atualize um relacionamento de gêmeos digitais via especificação de patch JSON e usando 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}

Atualize uma relação de gêmeo digital via especificação de patch JSON.

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"]}
]'

Atualize uma relação de gêmeo digital por meio da especificação de patch JSON definida em um arquivo.

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

Parâmetros Obrigatórios

--dt-name --dtn -n

Nome da instância ou nome do host do Digital Twins. Se um nome de instância for fornecido, a assinatura do usuário será consultada primeiro para que a instância de destino recupere o nome do host. Se um nome de host for fornecido, a consulta de assinatura será ignorada e o valor fornecido será usado para interação subsequente.

--json-patch --patch

Uma especificação de atualização descrita pelo JSON-patch. Atualizações de valores de propriedade e elementos $model podem ocorrer na mesma solicitação. As operações são limitadas para adicionar, substituir e remover. Forneça o caminho do arquivo ou JSON embutido.

--relationship-id -r

Id do relacionamento.

--source --twin-id -t

O gêmeo de origem Id para um relacionamento.

Parâmetros Opcionais

--etag -e

Valor da tag de entidade. O comando terá êxito se o etag corresponder ao etag atual do recurso.

--resource-group -g

Grupo de recursos de instância de gêmeos digitais. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.