Partilhar via


az dt twin telemetry

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 de telemetria az dt twin. Saiba mais sobre extensões.

Teste e valide as rotas de evento e os pontos de extremidade de uma instância do Digital Twins.

Comandos

Name Description Tipo Estado
az dt twin telemetry send

Envia telemetria em nome de um gêmeo digital. Se o caminho do componente for fornecido, a telemetria emitida será em nome do componente.

Extensão GA

az dt twin telemetry send

Envia telemetria em nome de um gêmeo digital. Se o caminho do componente for fornecido, a telemetria emitida será em nome do componente.

az dt twin telemetry send --dt-name
                          --twin-id
                          [--component]
                          [--dt-id]
                          [--resource-group]
                          [--telemetry]
                          [--telemetry-source-time]

Exemplos

Enviar telemetria dupla

az dt twin telemetry send -n {instance_or_hostname} --twin-id {twin_id}

Enviar telemetria dupla com um carimbo de data/hora de origem de telemetria personalizado e identificador de mensagem

az dt twin telemetry send -n {instance_or_hostname} --twin-id {twin_id} --tst {telemetry_source_timestamp} --dt-id {dt_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.

--twin-id -t

O gêmeo digital Id.

Parâmetros Opcionais

--component

O caminho para o componente DTDL. Se definido, a telemetria será emitida em nome do componente.

--dt-id

Um identificador de mensagem exclusivo (no escopo do id de gêmeo digital) que é comumente usado para eliminar a duplicação de mensagens. Se nenhum valor for fornecido, um GUID será gerado automaticamente.

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

--telemetry

JSON de telemetria embutida ou caminho de arquivo para JSON de telemetria. A carga útil padrão é um objeto vazio: {}.

--telemetry-source-time --tst

Um carimbo de data/hora RFC 3339 que identifica a hora em que a telemetria foi medida.

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.