Partilhar via

az dt endpoint create

Note

Essa referência faz parte da extensão azure-iot para a CLI do Azure (versão 2.67.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 Status
az dt endpoint create eventgrid

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

 Extension disponibilidade geral
az dt endpoint create eventhub

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

 Extension disponibilidade geral
az dt endpoint create servicebus

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

 Extension disponibilidade geral

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 --dtn
                                --egt --eventgrid-topic
                                --en --endpoint-name
                                [--deadletter-sas-uri --dsu]
                                [--deadletter-uri --du]
                                [--egg --eventgrid-resource-group]
                                [--egs --eventgrid-subscription]
                                [--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.

Propriedade Valor
Grupo de parâmetros: Event Grid Topic Arguments
--en --endpoint-name

Nome do ponto final.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--deadletter-sas-uri --dsu

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

Propriedade Valor
Grupo de parâmetros: Dead-letter Endpoint Arguments
--deadletter-uri --du

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

Propriedade Valor
Grupo de parâmetros: Dead-letter Endpoint Arguments
--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.

Propriedade Valor
Grupo de parâmetros: Event Grid Topic Arguments
--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.

Propriedade Valor
Grupo de parâmetros: Event Grid Topic Arguments
--no-wait

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

Propriedade Valor
Default value: 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.

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

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

--verbose

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

Propriedade Valor
Default value: False

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 --dtn
                               --eh --eventhub
                               --ehn --eventhub-namespace
                               --en --endpoint-name
                               [--auth-type {IdentityBased, KeyBased}]
                               [--deadletter-sas-uri --dsu]
                               [--deadletter-uri --du]
                               [--ehg --eventhub-resource-group]
                               [--ehp --eventhub-policy]
                               [--ehs --eventhub-subscription]
                               [--mi-system-assigned --system {false, true}]
                               [--mi-user-assigned --user]
                               [--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.

Propriedade Valor
Grupo de parâmetros: Event Hub Arguments
--ehn --eventhub-namespace

Identificador de namespace EventHub.

Propriedade Valor
Grupo de parâmetros: Event Hub Arguments
--en --endpoint-name

Nome do ponto final.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

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

Propriedade Valor
Default value: KeyBased
Valores aceites: IdentityBased, KeyBased
--deadletter-sas-uri --dsu

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

Propriedade Valor
Grupo de parâmetros: Dead-letter Endpoint Arguments
--deadletter-uri --du

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

Propriedade Valor
Grupo de parâmetros: Dead-letter Endpoint Arguments
--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.

Propriedade Valor
Grupo de parâmetros: Event Hub Arguments
--ehp --eventhub-policy

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

Propriedade Valor
Grupo de parâmetros: Event Hub Arguments
--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.

Propriedade Valor
Grupo de parâmetros: Event Hub Arguments
--mi-system-assigned --system

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

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

Propriedade Valor
Default value: 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.

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

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

--verbose

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

Propriedade Valor
Default value: False

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 --dtn
                                 --en --endpoint-name
                                 --sbn --servicebus-namespace
                                 --sbt --servicebus-topic
                                 [--auth-type {IdentityBased, KeyBased}]
                                 [--deadletter-sas-uri --dsu]
                                 [--deadletter-uri --du]
                                 [--mi-system-assigned --system {false, true}]
                                 [--mi-user-assigned --user]
                                 [--no-wait]
                                 [--resource-group]
                                 [--sbg --servicebus-resource-group]
                                 [--sbp --servicebus-policy]
                                 [--sbs --servicebus-subscription]

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.

Propriedade Valor
Grupo de parâmetros: Service Bus Topic Arguments
--sbt --servicebus-topic

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

Propriedade Valor
Grupo de parâmetros: Service Bus Topic Arguments

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

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

Propriedade Valor
Default value: KeyBased
Valores aceites: IdentityBased, KeyBased
--deadletter-sas-uri --dsu

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

Propriedade Valor
Grupo de parâmetros: Dead-letter Endpoint Arguments
--deadletter-uri --du

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

Propriedade Valor
Grupo de parâmetros: Dead-letter Endpoint Arguments
--mi-system-assigned --system

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

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

Propriedade Valor
Default value: 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.

Propriedade Valor
Grupo de parâmetros: Service Bus Topic Arguments
--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.

Propriedade Valor
Grupo de parâmetros: Service Bus Topic Arguments
--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.

Propriedade Valor
Grupo de parâmetros: Service Bus Topic Arguments
Parâmetros de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

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

--verbose

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

Propriedade Valor
Default value: False