Share via


az iot hub message-endpoint create

Nota:

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

El grupo de comandos "iot hub message-endpoint" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Agregue un punto de conexión a una instancia de IoT Hub.

Comandos

Nombre Description Tipo Estado
az iot hub message-endpoint create cosmosdb-container

Agregue un punto de conexión de contenedor de Cosmos DB para una instancia de IoT Hub.

Extensión Vista previa
az iot hub message-endpoint create eventhub

Agregue un punto de conexión del centro de eventos para una instancia de IoT Hub.

Extensión Vista previa
az iot hub message-endpoint create servicebus-queue

Agregue un punto de conexión de cola de Service Bus para una instancia de IoT Hub.

Extensión Vista previa
az iot hub message-endpoint create servicebus-topic

Agregue un punto de conexión de tema de Service Bus para una instancia de IoT Hub.

Extensión Vista previa
az iot hub message-endpoint create storage-container

Agregue un punto de conexión de contenedor de almacenamiento para una instancia de IoT Hub.

Extensión Vista previa

az iot hub message-endpoint create cosmosdb-container

Vista previa

El grupo de comandos "iot hub message-endpoint" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Agregue un punto de conexión de contenedor de Cosmos DB para una instancia de IoT Hub.

az iot hub message-endpoint create cosmosdb-container --container
                                                      --database-name
                                                      --en
                                                      --hub-name
                                                      [--connection-string]
                                                      [--endpoint-account]
                                                      [--endpoint-resource-group]
                                                      [--endpoint-subscription-id]
                                                      [--endpoint-uri]
                                                      [--identity]
                                                      [--partition-key-name]
                                                      [--partition-key-template]
                                                      [--pk]
                                                      [--resource-group]
                                                      [--secondary-key]

Ejemplos

Cree un punto de conexión de contenedor de Cosmos DB basado en claves para una instancia de IoT Hub.

az iot hub message-endpoint create cosmosdb-container -n {iothub_name} --en {endpoint_name} --container {container} --db {database} --endpoint-account {account_name}

Cree un punto de conexión de contenedor de Cosmos DB para una instancia de IoT Hub mediante un cadena de conexión.

az iot hub message-endpoint create cosmosdb-container -n {iothub_name} --en {endpoint_name} -c {connection_string} --container {container} --db {database}

Cree un punto de conexión de contenedor de Cosmos DB para ioT Hub mediante la clave principal y el URI de punto de conexión especificados.

az iot hub message-endpoint create cosmosdb-container -n {iothub_name} --en {endpoint_name} --pk {primary_key} --endpoint-uri {endpoint_uri} --container {container} --db {database}

Cree un punto de conexión de contenedor de Cosmos DB para ioT Hub mediante la identidad asignada por el sistema y un nombre de clave de partición. La plantilla de clave de partición será la predeterminada.

az iot hub message-endpoint create cosmosdb-container -n {iothub_name} --en {endpoint_name} --endpoint-uri {endpoint_uri} --container {container} --db {database} --pkn {partition_key_name} --identity [system]

Cree un punto de conexión de contenedor de Cosmos DB para ioT Hub mediante la identidad asignada por el usuario, el nombre de clave de partición y la plantilla de clave de partición.

az iot hub message-endpoint create cosmosdb-container -n {iothub_name} --en {endpoint_name} --endpoint-uri {endpoint_uri} --container {container} --db {database} --pkn {partition_key_name} --pkt {partition_key_template} --identity {user_identity_resource_id}

Parámetros requeridos

--container --container-name

Nombre del contenedor sql de Cosmos DB en la base de datos de cosmos DB.

--database-name --db

Nombre de la base de datos de Cosmos DB en la cuenta de cosmos DB.

--en --endpoint --endpoint-name

Nombre del punto de conexión de enrutamiento.

--hub-name -n

Nombre de IoT Hub.

Parámetros opcionales

--connection-string -c

Conectar cadena de enrutamiento del punto de conexión de enrutamiento.

--endpoint-account

Nombre de cuenta del recurso de punto de conexión.

--endpoint-resource-group --erg -r

Grupo de recursos del punto de conexión. Si no se proporciona, se usará el grupo de recursos de IoT Hub.

--endpoint-subscription-id -s

Identificador de suscripción del recurso punto de conexión. Si no se proporciona, se usará la suscripción de IoT Hub.

--endpoint-uri

Identificador URI del recurso de punto de conexión.

--identity

Use una identidad administrada asignada por el sistema o asignada por el usuario para la autenticación de punto de conexión. Use "[system]" para hacer referencia a la identidad asignada por el sistema o a un identificador de recurso para hacer referencia a una identidad asignada por el usuario.

--partition-key-name --pkn

Nombre de la clave de partición asociada a este contenedor SQL de Cosmos DB si existe.

--partition-key-template --pkt

Plantilla para generar un valor de clave de partición sintética para su uso con este contenedor sql de Cosmos DB. La plantilla debe incluir al menos uno de los siguientes marcadores de posición: {iothub}, {deviceid}, {DD}, {MM}y {AAAA}. Se puede especificar un marcador de posición como máximo una vez, pero los componentes order y non-placeholder son arbitrarios. Si se proporciona el nombre de clave de partición, la plantilla de clave de partición tiene como valor predeterminado {deviceid}-{AAAA}-{MM}.

--pk --primary-key

Clave principal de la cuenta de Cosmos DB.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--secondary-key --sk

Clave secundaria de la cuenta de Cosmos DB.

Parámetros globales
--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener registros de depuración completos.

az iot hub message-endpoint create eventhub

Vista previa

El grupo de comandos "iot hub message-endpoint" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Agregue un punto de conexión del centro de eventos para una instancia de IoT Hub.

az iot hub message-endpoint create eventhub --en
                                            --hub-name
                                            [--connection-string]
                                            [--endpoint-namespace-name]
                                            [--endpoint-policy-name]
                                            [--endpoint-resource-group]
                                            [--endpoint-subscription-id]
                                            [--endpoint-uri]
                                            [--entity-path]
                                            [--identity]
                                            [--resource-group]

Ejemplos

Cree un punto de conexión de Centro de eventos basado en claves para una instancia de IoT Hub.

az iot hub message-endpoint create eventhub -n {iothub_name} --en {endpoint_name} --namespace {namespace_name} --entity-path {entity_path} --policy {policy_name}

Cree un punto de conexión de Centro de eventos para una instancia de IoT Hub mediante un cadena de conexión. Se omiten el URI del punto de conexión y la ruta de acceso de entidad.

az iot hub message-endpoint create eventhub -n {iothub_name} --en {endpoint_name} -c {connection_string}

Cree un punto de conexión del centro de eventos para una instancia de IoT Hub mediante la identidad asignada por el sistema. Se debe especificar el punto de conexión y la ruta de acceso de entidad.

az iot hub message-endpoint create eventhub -n {iothub_name} --en {endpoint_name} --endpoint-uri {endpoint_uri} --entity-path {entity_path} --identity [system]

Cree un punto de conexión del centro de eventos para una instancia de IoT Hub mediante la identidad asignada por el usuario. Se debe especificar el punto de conexión y la ruta de acceso de entidad.

az iot hub message-endpoint create eventhub -n {iothub_name} --en {endpoint_name} --endpoint-uri {endpoint_uri} --entity-path {entity_path} --identity {user_identity_resource_id}

Parámetros requeridos

--en --endpoint --endpoint-name

Nombre del punto de conexión de enrutamiento.

--hub-name -n

Nombre de IoT Hub.

Parámetros opcionales

--connection-string -c

Conectar cadena de enrutamiento del punto de conexión de enrutamiento.

--endpoint-namespace-name --namespace

Nombre del espacio de nombres para el recurso de punto de conexión.

--endpoint-policy-name --policy

Nombre de la directiva para cadena de conexión recuperación.

--endpoint-resource-group --erg -r

Grupo de recursos del punto de conexión. Si no se proporciona, se usará el grupo de recursos de IoT Hub.

--endpoint-subscription-id -s

Identificador de suscripción del recurso punto de conexión. Si no se proporciona, se usará la suscripción de IoT Hub.

--endpoint-uri

Identificador URI del recurso de punto de conexión.

--entity-path

Ruta de acceso de entidad del recurso de punto de conexión.

--identity

Use una identidad administrada asignada por el sistema o asignada por el usuario para la autenticación de punto de conexión. Use "[system]" para hacer referencia a la identidad asignada por el sistema o a un identificador de recurso para hacer referencia a una identidad asignada por el usuario.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros globales
--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener registros de depuración completos.

az iot hub message-endpoint create servicebus-queue

Vista previa

El grupo de comandos "iot hub message-endpoint" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Agregue un punto de conexión de cola de Service Bus para una instancia de IoT Hub.

az iot hub message-endpoint create servicebus-queue --en
                                                    --hub-name
                                                    [--connection-string]
                                                    [--endpoint-namespace-name]
                                                    [--endpoint-policy-name]
                                                    [--endpoint-resource-group]
                                                    [--endpoint-subscription-id]
                                                    [--endpoint-uri]
                                                    [--entity-path]
                                                    [--identity]
                                                    [--resource-group]

Ejemplos

Cree un punto de conexión de cola de Service Bus basado en claves para una instancia de IoT Hub.

az iot hub message-endpoint create servicebus-queue -n {iothub_name} --en {endpoint_name} --namespace {namespace_name} --entity-path {entity_path} --policy {policy_name}

Cree un punto de conexión de cola de Service Bus para ioT Hub mediante un cadena de conexión. Se omiten el URI del punto de conexión y la ruta de acceso de entidad.

az iot hub message-endpoint create servicebus-queue -n {iothub_name} --en {endpoint_name} -c {connection_string}

Cree un punto de conexión de cola de Service Bus para una instancia de IoT Hub mediante la identidad asignada por el sistema. Se debe especificar el punto de conexión y la ruta de acceso de entidad.

az iot hub message-endpoint create servicebus-queue -n {iothub_name} --en {endpoint_name} --endpoint-uri {endpoint_uri} --entity-path {entity_path} --identity [system]

Cree un punto de conexión de cola de Service Bus para una instancia de IoT Hub mediante la identidad asignada por el usuario. Se debe especificar el punto de conexión y la ruta de acceso de entidad.

az iot hub message-endpoint create servicebus-queue -n {iothub_name} --en {endpoint_name} --endpoint-uri {endpoint_uri} --entity-path {entity_path} --identity {user_identity_resource_id}

Parámetros requeridos

--en --endpoint --endpoint-name

Nombre del punto de conexión de enrutamiento.

--hub-name -n

Nombre de IoT Hub.

Parámetros opcionales

--connection-string -c

Conectar cadena de enrutamiento del punto de conexión de enrutamiento.

--endpoint-namespace-name --namespace

Nombre del espacio de nombres para el recurso de punto de conexión.

--endpoint-policy-name --policy

Nombre de la directiva para cadena de conexión recuperación.

--endpoint-resource-group --erg -r

Grupo de recursos del punto de conexión. Si no se proporciona, se usará el grupo de recursos de IoT Hub.

--endpoint-subscription-id -s

Identificador de suscripción del recurso punto de conexión. Si no se proporciona, se usará la suscripción de IoT Hub.

--endpoint-uri

Identificador URI del recurso de punto de conexión.

--entity-path

Ruta de acceso de entidad del recurso de punto de conexión.

--identity

Use una identidad administrada asignada por el sistema o asignada por el usuario para la autenticación de punto de conexión. Use "[system]" para hacer referencia a la identidad asignada por el sistema o a un identificador de recurso para hacer referencia a una identidad asignada por el usuario.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros globales
--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener registros de depuración completos.

az iot hub message-endpoint create servicebus-topic

Vista previa

El grupo de comandos "iot hub message-endpoint" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Agregue un punto de conexión de tema de Service Bus para una instancia de IoT Hub.

az iot hub message-endpoint create servicebus-topic --en
                                                    --hub-name
                                                    [--connection-string]
                                                    [--endpoint-namespace-name]
                                                    [--endpoint-policy-name]
                                                    [--endpoint-resource-group]
                                                    [--endpoint-subscription-id]
                                                    [--endpoint-uri]
                                                    [--entity-path]
                                                    [--identity]
                                                    [--resource-group]

Ejemplos

Cree un punto de conexión de tema de Service Bus basado en claves para ioT Hub.

az iot hub message-endpoint create servicebus-topic -n {iothub_name} --en {endpoint_name} --namespace {namespace_name} --entity-path {entity_path} --policy {policy_name}

Cree un punto de conexión de tema de Service Bus para ioT Hub mediante un cadena de conexión. Se omiten el URI del punto de conexión y la ruta de acceso de entidad.

az iot hub message-endpoint create servicebus-topic -n {iothub_name} --en {endpoint_name} -c {connection_string}

Cree un punto de conexión de tema de Service Bus para una instancia de IoT Hub mediante la identidad asignada por el sistema. Se debe especificar el punto de conexión y la ruta de acceso de entidad.

az iot hub message-endpoint create servicebus-topic -n {iothub_name} --en {endpoint_name} --endpoint-uri {endpoint_uri} --entity-path {entity_path} --identity [system]

Cree un punto de conexión de tema de Service Bus para una instancia de IoT Hub mediante la identidad asignada por el usuario. Se debe especificar el punto de conexión y la ruta de acceso de entidad.

az iot hub message-endpoint create servicebus-topic -n {iothub_name} --en {endpoint_name} --endpoint-uri {endpoint_uri} --entity-path {entity_path} --identity {user_identity_resource_id}

Parámetros requeridos

--en --endpoint --endpoint-name

Nombre del punto de conexión de enrutamiento.

--hub-name -n

Nombre de IoT Hub.

Parámetros opcionales

--connection-string -c

Conectar cadena de enrutamiento del punto de conexión de enrutamiento.

--endpoint-namespace-name --namespace

Nombre del espacio de nombres para el recurso de punto de conexión.

--endpoint-policy-name --policy

Nombre de la directiva para cadena de conexión recuperación.

--endpoint-resource-group --erg -r

Grupo de recursos del punto de conexión. Si no se proporciona, se usará el grupo de recursos de IoT Hub.

--endpoint-subscription-id -s

Identificador de suscripción del recurso punto de conexión. Si no se proporciona, se usará la suscripción de IoT Hub.

--endpoint-uri

Identificador URI del recurso de punto de conexión.

--entity-path

Ruta de acceso de entidad del recurso de punto de conexión.

--identity

Use una identidad administrada asignada por el sistema o asignada por el usuario para la autenticación de punto de conexión. Use "[system]" para hacer referencia a la identidad asignada por el sistema o a un identificador de recurso para hacer referencia a una identidad asignada por el usuario.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros globales
--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener registros de depuración completos.

az iot hub message-endpoint create storage-container

Vista previa

El grupo de comandos "iot hub message-endpoint" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Agregue un punto de conexión de contenedor de almacenamiento para una instancia de IoT Hub.

az iot hub message-endpoint create storage-container --container
                                                     --en
                                                     --hub-name
                                                     [--batch-frequency]
                                                     [--chunk-size]
                                                     [--connection-string]
                                                     [--encoding {avro, json}]
                                                     [--endpoint-account]
                                                     [--endpoint-resource-group]
                                                     [--endpoint-subscription-id]
                                                     [--endpoint-uri]
                                                     [--ff]
                                                     [--identity]
                                                     [--resource-group]

Ejemplos

Cree un punto de conexión de contenedor de almacenamiento basado en claves para una instancia de IoT Hub.

az iot hub message-endpoint create storage-container -n {iothub_name} --en {endpoint_name} --container {container_name} --endpoint-account {account_name}

Cree un punto de conexión de contenedor de almacenamiento para una instancia de IoT Hub mediante un cadena de conexión. Se omite el URI del punto de conexión.

az iot hub message-endpoint create storage-container -n {iothub_name} --en {endpoint_name} -c {connection_string} --container {container_name}

Cree un punto de conexión de contenedor de almacenamiento para una instancia de IoT Hub mediante la identidad asignada por el sistema con la frecuencia del lote, el tamaño del fragmento y el formato de nombre de archivo especificados. Se debe especificar el punto de conexión.

az iot hub message-endpoint create storage-container -n {iothub_name} --en {endpoint_name} --endpoint-uri {endpoint_uri} --container {container_name} -b {batch_frequency} -w {chunk_size} --ff {file_format} --identity [system]

Cree un punto de conexión de contenedor de almacenamiento para una instancia de IoT Hub mediante la identidad asignada por el usuario con codificación json. Se debe especificar el punto de conexión.

az iot hub message-endpoint create storage-container -n {iothub_name} --en {endpoint_name} --endpoint-uri {endpoint_uri} --container {container_name} --encoding json --identity {user_identity_resource_id}

Parámetros requeridos

--container --container-name

Nombre del contenedor de almacenamiento.

--en --endpoint --endpoint-name

Nombre del punto de conexión de enrutamiento.

--hub-name -n

Nombre de IoT Hub.

Parámetros opcionales

--batch-frequency -b

Frecuencia del lote de solicitud en segundos. Cantidad máxima de tiempo que puede transcurrir antes de que los datos se escriban en un blob, entre 60 y 720 segundos.

valor predeterminado: 300
--chunk-size -w

Tamaño del fragmento de solicitud en megabytes(MB). Tamaño máximo de blobs, entre 10 y 500 MB.

valor predeterminado: 300
--connection-string -c

Conectar cadena de enrutamiento del punto de conexión de enrutamiento.

--encoding

Formato de codificación para el contenedor.

valores aceptados: avro, json
valor predeterminado: avro
--endpoint-account

Nombre de cuenta del recurso de punto de conexión.

--endpoint-resource-group --erg -r

Grupo de recursos del punto de conexión. Si no se proporciona, se usará el grupo de recursos de IoT Hub.

--endpoint-subscription-id -s

Identificador de suscripción del recurso punto de conexión. Si no se proporciona, se usará la suscripción de IoT Hub.

--endpoint-uri

Identificador URI del recurso de punto de conexión.

--ff --file-name-format

Formato de nombre de archivo para el blob. El formato de nombre de archivo debe contener {iothub}, {partition}, {AAAA}, {MM}, {DD}, {HH} y {mm} campos. Todos los parámetros son obligatorios, pero se pueden reordenar con o sin delimitadores.

valor predeterminado: {iothub}/{partition}/{YYYY}/{MM}/{DD}/{HH}/{mm}
--identity

Use una identidad administrada asignada por el sistema o asignada por el usuario para la autenticación de punto de conexión. Use "[system]" para hacer referencia a la identidad asignada por el sistema o a un identificador de recurso para hacer referencia a una identidad asignada por el usuario.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros globales
--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener registros de depuración completos.