Compartir a través de

az dt endpoint create

Note

Esta referencia forma parte de la extensión azure-iot para la CLI de Azure (versión 2.67.0 o posterior). La extensión instalará automáticamente la primera vez que ejecute un comando az dt endpoint create. Obtenga más información sobre las extensiones.

Agregue puntos de conexión de salida a una instancia de Digital Twins.

Comandos

Nombre Description Tipo Estado
az dt endpoint create eventgrid

Agrega un punto de conexión de tema de EventGrid a una instancia de Digital Twins. Requiere un recurso creado previamente.

 Extension GA
az dt endpoint create eventhub

Agrega un punto de conexión de EventHub a una instancia de Digital Twins.

 Extension GA
az dt endpoint create servicebus

Agrega un punto de conexión de tema de ServiceBus a una instancia de Digital Twins.

 Extension GA

az dt endpoint create eventgrid

Agrega un punto de conexión de tema de EventGrid a una instancia de Digital Twins. Requiere un recurso creado previamente.

Los puntos de conexión de temas de EventGrid no admiten la integración de puntos de conexión basados en identidades.

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]

Ejemplos

Agrega un punto de conexión de tema de EventGrid a una instancia 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 requeridos

--dt-name --dtn -n

Nombre de instancia de Digital Twins.

--egt --eventgrid-topic

Nombre del tema de EventGrid con el que se va a integrar.

Propiedad Valor
Grupo de parámetros: Event Grid Topic Arguments
--en --endpoint-name

Nombre del punto de conexión.

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--deadletter-sas-uri --dsu

Dirección URL del contenedor de almacenamiento de mensajes fallidos con el token de SAS para la autenticación basada en claves.

Propiedad Valor
Grupo de parámetros: Dead-letter Endpoint Arguments
--deadletter-uri --du

Dirección URL del contenedor de almacenamiento de mensajes fallidos para la autenticación basada en identidades.

Propiedad Valor
Grupo de parámetros: Dead-letter Endpoint Arguments
--egg --eventgrid-resource-group

Nombre del grupo de recursos EventGrid Topic. Si no se proporciona, se usará el grupo de recursos de instancia de Digital Twin.

Propiedad Valor
Grupo de parámetros: Event Grid Topic Arguments
--egs --eventgrid-subscription

Nombre o identificador de la suscripción donde existe el recurso de punto de conexión. Si no se proporciona ninguna suscripción, se usa la suscripción predeterminada.

Propiedad Valor
Grupo de parámetros: Event Grid Topic Arguments
--no-wait

No espere a que finalice la operación de ejecución prolongada.

Propiedad Valor
Valor predeterminado: False
--resource-group -g

Grupo de recursos de instancia de Digital Twins. Puede configurar el grupo predeterminado mediante az configure --defaults group={name}.

Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az dt endpoint create eventhub

Agrega un punto de conexión de EventHub a una instancia de Digital Twins.

Requiere un recurso creado previamente.

La instancia debe tener una identidad asignada por el sistema para admitir la integración de puntos de conexión basados en identidades asignadas por el sistema. La instancia debe tener asociada la identidad asignada por el usuario para admitir la integración de puntos de conexión basados en identidades asignadas por el usuario.

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]

Ejemplos

Agrega un punto de conexión de EventHub a una instancia de destino mediante la autenticación basada en claves.

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}

Agrega un punto de conexión de EventHub a una instancia de destino mediante la identidad asignada por el sistema para la autenticación.

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}

Agrega un punto de conexión de EventHub a una instancia de destino mediante una identidad asignada por el usuario para la autenticación.

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 requeridos

--dt-name --dtn -n

Nombre de instancia de Digital Twins.

--eh --eventhub

Nombre de EventHub con el que se va a integrar.

Propiedad Valor
Grupo de parámetros: Event Hub Arguments
--ehn --eventhub-namespace

Identificador del espacio de nombres de EventHub.

Propiedad Valor
Grupo de parámetros: Event Hub Arguments
--en --endpoint-name

Nombre del punto de conexión.

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--auth-type
Obsoleto

El argumento "auth_type" está en desuso y se quitará en una versión futura. Use 'identity' en su lugar.

Tipo de autenticación de punto de conexión.

Propiedad Valor
Valor predeterminado: KeyBased
Valores aceptados: IdentityBased, KeyBased
--deadletter-sas-uri --dsu

Dirección URL del contenedor de almacenamiento de mensajes fallidos con el token de SAS para la autenticación basada en claves.

Propiedad Valor
Grupo de parámetros: Dead-letter Endpoint Arguments
--deadletter-uri --du

Dirección URL del contenedor de almacenamiento de mensajes fallidos para la autenticación basada en identidades.

Propiedad Valor
Grupo de parámetros: Dead-letter Endpoint Arguments
--ehg --eventhub-resource-group

Nombre del grupo de recursos de EventHub. Si no se proporciona, se usará el grupo de recursos de instancia de Digital Twin.

Propiedad Valor
Grupo de parámetros: Event Hub Arguments
--ehp --eventhub-policy

Directiva de EventHub que se va a usar para la configuración del punto de conexión. Obligatorio cuando --auth-type es KeyBased.

Propiedad Valor
Grupo de parámetros: Event Hub Arguments
--ehs --eventhub-subscription

Nombre o identificador de la suscripción donde existe el recurso de punto de conexión. Si no se proporciona ninguna suscripción, se usa la suscripción predeterminada.

Propiedad Valor
Grupo de parámetros: Event Hub Arguments
--mi-system-assigned --system

Use la identidad administrada asignada por el sistema para la autenticación de punto de conexión.

Propiedad Valor
Valores aceptados: false, true
--mi-user-assigned --user

Use una identidad administrada asignada por el usuario para la autenticación de punto de conexión. Acepta el identificador del recurso de identidad.

--no-wait

No espere a que finalice la operación de ejecución prolongada.

Propiedad Valor
Valor predeterminado: False
--resource-group -g

Grupo de recursos de instancia de Digital Twins. Puede configurar el grupo predeterminado mediante az configure --defaults group={name}.

Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az dt endpoint create servicebus

Agrega un punto de conexión de tema de ServiceBus a una instancia de Digital Twins.

Requiere un recurso creado previamente.

La instancia debe tener una identidad asignada por el sistema para admitir la integración de puntos de conexión basados en identidades asignadas por el sistema. La instancia debe tener asociada la identidad asignada por el usuario para admitir la integración de puntos de conexión basados en identidades asignadas por el usuario.

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]

Ejemplos

Agrega un punto de conexión de tema de ServiceBus a una instancia de destino mediante la autenticación basada en claves.

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}

Agrega un punto de conexión de Tema de ServiceBus a una instancia de destino mediante la identidad asignada por el sistema para la autenticación.

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}

Agrega un punto de conexión de Tema de ServiceBus a una instancia de destino mediante una identidad asignada por el usuario para la autenticación.

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 requeridos

--dt-name --dtn -n

Nombre de instancia de Digital Twins.

--en --endpoint-name

Nombre del punto de conexión.

--sbn --servicebus-namespace

Identificador del espacio de nombres de ServiceBus.

Propiedad Valor
Grupo de parámetros: Service Bus Topic Arguments
--sbt --servicebus-topic

Nombre del tema de ServiceBus con el que se va a integrar.

Propiedad Valor
Grupo de parámetros: Service Bus Topic Arguments

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--auth-type
Obsoleto

El argumento "auth_type" está en desuso y se quitará en una versión futura. Use 'identity' en su lugar.

Tipo de autenticación de punto de conexión.

Propiedad Valor
Valor predeterminado: KeyBased
Valores aceptados: IdentityBased, KeyBased
--deadletter-sas-uri --dsu

Dirección URL del contenedor de almacenamiento de mensajes fallidos con el token de SAS para la autenticación basada en claves.

Propiedad Valor
Grupo de parámetros: Dead-letter Endpoint Arguments
--deadletter-uri --du

Dirección URL del contenedor de almacenamiento de mensajes fallidos para la autenticación basada en identidades.

Propiedad Valor
Grupo de parámetros: Dead-letter Endpoint Arguments
--mi-system-assigned --system

Use la identidad administrada asignada por el sistema para la autenticación de punto de conexión.

Propiedad Valor
Valores aceptados: false, true
--mi-user-assigned --user

Use una identidad administrada asignada por el usuario para la autenticación de punto de conexión. Acepta el identificador del recurso de identidad.

--no-wait

No espere a que finalice la operación de ejecución prolongada.

Propiedad Valor
Valor predeterminado: False
--resource-group -g

Grupo de recursos de instancia de Digital Twins. Puede configurar el grupo predeterminado mediante az configure --defaults group={name}.

--sbg --servicebus-resource-group

Nombre del grupo de recursos serviceBus. Si no se proporciona, se usará el grupo de recursos de instancia de Digital Twin.

Propiedad Valor
Grupo de parámetros: Service Bus Topic Arguments
--sbp --servicebus-policy

Directiva de tema de ServiceBus que se va a usar para la configuración del punto de conexión. Obligatorio cuando --auth-type es KeyBased.

Propiedad Valor
Grupo de parámetros: Service Bus Topic Arguments
--sbs --servicebus-subscription

Nombre o identificador de la suscripción donde existe el recurso de punto de conexión. Si no se proporciona ninguna suscripción, se usa la suscripción predeterminada.

Propiedad Valor
Grupo de parámetros: Service Bus Topic Arguments
Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False