Partilhar via

az dt endpoint create

  • Referência

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 endpoint create . Saiba mais sobre extensões.

Adicione pontos de extremidade de saída a uma instância do Digital Twins.

Comandos

Name Description Tipo Estado
az dt endpoint create eventgrid

Adiciona um ponto de extremidade EventGrid Topic a uma instância do Digital Twins. Requer recurso pré-criado.

 Extensão GA
az dt endpoint create eventhub

Adiciona um ponto de extremidade do EventHub a uma instância do Digital Twins.

 Extensão GA
az dt endpoint create servicebus

Adiciona um ponto de extremidade ServiceBus Topic a uma instância do Digital Twins.

 Extensão GA

az dt endpoint create eventgrid

Adiciona um ponto de extremidade EventGrid Topic a uma instância do Digital Twins. Requer recurso pré-criado.

Os pontos de extremidade de tópico EventGrid não oferecem suporte à integração de ponto de extremidade baseada em identidade.

az dt endpoint create eventgrid --dt-name
                                --egt
                                --en
                                [--deadletter-sas-uri]
                                [--deadletter-uri]
                                [--egg]
                                [--egs]
                                [--no-wait]
                                [--resource-group]

Exemplos

Adiciona um ponto de extremidade EventGrid Topic a uma instância de destino.

az dt endpoint create eventgrid --endpoint-name {endpoint_name} --eventgrid-resource-group {eventgrid_resource_group} --eventgrid-topic {eventgrid_topic_name} -n {instance_name}

Parâmetros Obrigatórios

--dt-name --dtn -n

Nome da instância do Digital Twins.

--egt --eventgrid-topic

Nome do tópico EventGrid para integrar.

--en --endpoint-name

Nome do ponto final.

Parâmetros Opcionais

--deadletter-sas-uri --dsu

URL do contêiner de armazenamento de letra morta com token SAS para autenticação baseada em chave.

--deadletter-uri --du

URL do contêiner de armazenamento de carta morta para autenticação baseada em identidade.

--egg --eventgrid-resource-group

Nome do grupo de recursos EventGrid Topic. Se não for fornecido, o grupo de recursos de instância do Digital Twin será usado.

--egs --eventgrid-subscription

Nome ou id da assinatura onde o recurso de ponto de extremidade existe. Se nenhuma assinatura for fornecida, a assinatura padrão será usada.

--no-wait

Não espere que a operação de longa duração termine.

valor predefinido: False
--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 endpoint create eventhub

Adiciona um ponto de extremidade do EventHub a uma instância do Digital Twins.

Requer recurso pré-criado.

A instância deve ter uma identidade atribuída pelo sistema para dar suporte à integração de ponto de extremidade baseada em identidade atribuída pelo sistema. A instância deve ter a identidade atribuída pelo usuário associada para dar suporte à integração de ponto de extremidade baseada em identidade atribuída pelo usuário.

az dt endpoint create eventhub --dt-name
                               --eh
                               --ehn
                               --en
                               [--auth-type {IdentityBased, KeyBased}]
                               [--deadletter-sas-uri]
                               [--deadletter-uri]
                               [--ehg]
                               [--ehp]
                               [--ehs]
                               [--mi-system-assigned {false, true}]
                               [--mi-user-assigned]
                               [--no-wait]
                               [--resource-group]

Exemplos

Adiciona um ponto de extremidade do EventHub a uma instância de destino usando a autenticação baseada em chave.

az dt endpoint create eventhub --endpoint-name {endpoint_name} --eventhub-resource-group {eventhub_resource_group} --eventhub-namespace {eventhub_namespace} --eventhub {eventhub_name} --eventhub-policy {eventhub_policy} -n {instance_name}

Adiciona um ponto de extremidade do EventHub a uma instância de destino usando a identidade atribuída pelo sistema para autenticação.

az dt endpoint create eventhub --endpoint-name {endpoint_name} --eventhub-resource-group {eventhub_resource_group} --eventhub-namespace {eventhub_namespace} --eventhub {eventhub_name} --mi-system-assigned -n {instance_name}

Adiciona um ponto de extremidade do EventHub a uma instância de destino usando uma identidade atribuída pelo usuário para autenticação.

az dt endpoint create eventhub --endpoint-name {endpoint_name} --eventhub-resource-group {eventhub_resource_group} --eventhub-namespace {eventhub_namespace} --eventhub {eventhub_name} --mi-user-assigned {resource_id} -n {instance_name}

Parâmetros Obrigatórios

--dt-name --dtn -n

Nome da instância do Digital Twins.

--eh --eventhub

Nome do EventHub com o qual integrar.

--ehn --eventhub-namespace

Identificador de namespace EventHub.

--en --endpoint-name

Nome do ponto final.

Parâmetros Opcionais

--auth-type
Preterido

O argumento 'auth_type' foi preterido e será removido em uma versão futura. Em vez disso, use "identidade".

Tipo de autenticação de ponto de extremidade.

valores aceites: IdentityBased, KeyBased
valor predefinido: KeyBased
--deadletter-sas-uri --dsu

URL do contêiner de armazenamento de letra morta com token SAS para autenticação baseada em chave.

--deadletter-uri --du

URL do contêiner de armazenamento de carta morta para autenticação baseada em identidade.

--ehg --eventhub-resource-group

Nome do grupo de recursos do EventHub. Se não for fornecido, o grupo de recursos de instância do Digital Twin será usado.

--ehp --eventhub-policy

Política do EventHub a ser usada para configuração de ponto de extremidade. Necessário quando --auth-type é KeyBased.

--ehs --eventhub-subscription

Nome ou id da assinatura onde o recurso de ponto de extremidade existe. Se nenhuma assinatura for fornecida, a assinatura padrão será usada.

--mi-system-assigned --system

Use a identidade gerenciada atribuída pelo sistema para autenticação de ponto de extremidade.

valores aceites: false, true
--mi-user-assigned --user

Use uma identidade gerenciada atribuída pelo usuário para autenticação de ponto de extremidade. Aceita a ID do recurso de identidade.

--no-wait

Não espere que a operação de longa duração termine.

valor predefinido: False
--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 endpoint create servicebus

Adiciona um ponto de extremidade ServiceBus Topic a uma instância do Digital Twins.

Requer recurso pré-criado.

A instância deve ter uma identidade atribuída pelo sistema para dar suporte à integração de ponto de extremidade baseada em identidade atribuída pelo sistema. A instância deve ter a identidade atribuída pelo usuário associada para dar suporte à integração de ponto de extremidade baseada em identidade atribuída pelo usuário.

az dt endpoint create servicebus --dt-name
                                 --en
                                 --sbn
                                 --sbt
                                 [--auth-type {IdentityBased, KeyBased}]
                                 [--deadletter-sas-uri]
                                 [--deadletter-uri]
                                 [--mi-system-assigned {false, true}]
                                 [--mi-user-assigned]
                                 [--no-wait]
                                 [--resource-group]
                                 [--sbg]
                                 [--sbp]
                                 [--sbs]

Exemplos

Adiciona um ponto de extremidade ServiceBus Topic a uma instância de destino usando AUTH baseado em chave.

az dt endpoint create servicebus --endpoint-name {endpoint_name} --servicebus-resource-group {servicebus_resource_group} --servicebus-namespace {servicebus_namespace} --servicebus-topic {servicebus_topic_name} --servicebus-policy {servicebus_policy} -n {instance_name}

Adiciona um ponto de extremidade ServiceBus Topic a uma instância de destino usando a identidade atribuída pelo sistema para autenticação.

az dt endpoint create servicebus --endpoint-name {endpoint_name} --servicebus-resource-group {servicebus_resource_group} --servicebus-namespace {servicebus_namespace} --servicebus-topic {servicebus_topic_name} --mi-system-assigned -n {instance_name}

Adiciona um ponto de extremidade ServiceBus Topic a uma instância de destino usando uma identidade atribuída pelo usuário para autenticação.

az dt endpoint create servicebus --endpoint-name {endpoint_name} --servicebus-resource-group {servicebus_resource_group} --servicebus-namespace {servicebus_namespace} --servicebus-topic {servicebus_topic_name} --mi-user-assigned {resource_id} -n {instance_name}

Parâmetros Obrigatórios

--dt-name --dtn -n

Nome da instância do Digital Twins.

--en --endpoint-name

Nome do ponto final.

--sbn --servicebus-namespace

Identificador de namespace do ServiceBus.

--sbt --servicebus-topic

Nome do tópico do ServiceBus com o qual integrar.

Parâmetros Opcionais

--auth-type
Preterido

O argumento 'auth_type' foi preterido e será removido em uma versão futura. Em vez disso, use "identidade".

Tipo de autenticação de ponto de extremidade.

valores aceites: IdentityBased, KeyBased
valor predefinido: KeyBased
--deadletter-sas-uri --dsu

URL do contêiner de armazenamento de letra morta com token SAS para autenticação baseada em chave.

--deadletter-uri --du

URL do contêiner de armazenamento de carta morta para autenticação baseada em identidade.

--mi-system-assigned --system

Use a identidade gerenciada atribuída pelo sistema para autenticação de ponto de extremidade.

valores aceites: false, true
--mi-user-assigned --user

Use uma identidade gerenciada atribuída pelo usuário para autenticação de ponto de extremidade. Aceita a ID do recurso de identidade.

--no-wait

Não espere que a operação de longa duração termine.

valor predefinido: False
--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>.

--sbg --servicebus-resource-group

Nome do grupo de recursos do ServiceBus. Se não for fornecido, o grupo de recursos de instância do Digital Twin será usado.

--sbp --servicebus-policy

Política de tópico do ServiceBus a ser usada para configuração de ponto de extremidade. Necessário quando --auth-type é KeyBased.

--sbs --servicebus-subscription

Nome ou id da assinatura onde o recurso de ponto de extremidade existe. Se nenhuma assinatura for fornecida, a assinatura padrão será usada.

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.