Partager via


az iot hub message-endpoint create

Remarque

Cette référence fait partie de l’extension azure-iot pour Azure CLI (version 2.46.0 ou ultérieure). L’extension installe automatiquement la première fois que vous exécutez une commande az iot hub message-endpoint create . En savoir plus sur les extensions.

Le groupe de commandes « iot hub message-endpoint » est en préversion et en cours de développement. Référence et niveaux de support : https://aka.ms/CLI_refstatus

Ajoutez un point de terminaison à un hub IoT.

Commandes

Nom Description Type État
az iot hub message-endpoint create cosmosdb-container

Ajoutez un point de terminaison de conteneur Cosmos DB pour un hub IoT.

Extension Aperçu
az iot hub message-endpoint create eventhub

Ajoutez un point de terminaison Event Hub pour un hub IoT.

Extension Aperçu
az iot hub message-endpoint create servicebus-queue

Ajoutez un point de terminaison de file d’attente Service Bus pour un hub IoT.

Extension Aperçu
az iot hub message-endpoint create servicebus-topic

Ajoutez un point de terminaison de rubrique Service Bus pour un hub IoT.

Extension Aperçu
az iot hub message-endpoint create storage-container

Ajoutez un point de terminaison de conteneur de stockage pour un hub IoT.

Extension Aperçu

az iot hub message-endpoint create cosmosdb-container

Préversion

Le groupe de commandes « iot hub message-endpoint » est en préversion et en cours de développement. Référence et niveaux de support : https://aka.ms/CLI_refstatus

Ajoutez un point de terminaison de conteneur Cosmos DB pour un hub IoT.

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]

Exemples

Créez un point de terminaison de conteneur Cosmos DB basé sur des clés pour un hub IoT.

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

Créez un point de terminaison de conteneur Cosmos DB pour un hub IoT à l’aide d’un chaîne de connexion.

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

Créez un point de terminaison de conteneur Cosmos DB pour un Hub IoT à l’aide de la clé primaire et de l’URI de point de terminaison spécifiés.

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}

Créez un point de terminaison de conteneur Cosmos DB pour un Hub IoT à l’aide de l’identité affectée par le système et d’un nom de clé de partition. Le modèle de clé de partition sera la valeur par défaut.

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]

Créez un point de terminaison de conteneur Cosmos DB pour un Hub IoT à l’aide de l’identité affectée par l’utilisateur, du nom de clé de partition et du modèle de clé de partition.

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}

Paramètres obligatoires

--container --container-name

Nom du conteneur SQL Cosmos DB dans la base de données Cosmos DB.

--database-name --db

Nom de la base de données cosmos DB dans le compte cosmos DB.

--en --endpoint --endpoint-name

Nom du point de terminaison de routage.

--hub-name -n

Nom d’IoT Hub.

Paramètres facultatifs

--connection-string -c

Chaîne de connexion du point de terminaison de routage.

--endpoint-account

Nom du compte pour la ressource de point de terminaison.

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

Groupe de ressources de la ressource du point de terminaison. S’il n’est pas fourni, le groupe de ressources d’IoT Hub sera utilisé.

--endpoint-subscription-id -s

ID d’abonnement de la ressource de point de terminaison. S’il n’est pas fourni, l’abonnement d’IoT Hub est utilisé.

--endpoint-uri

URI de la ressource de point de terminaison.

--identity

Utilisez une identité managée affectée par le système ou affectée par l’utilisateur pour l’authentification de point de terminaison. Utilisez « [système] » pour faire référence à l’identité affectée par le système ou à un ID de ressource pour faire référence à une identité affectée par l’utilisateur.

--partition-key-name --pkn

Nom de la clé de partition associée à ce conteneur SQL Cosmos DB s’il en existe un.

--partition-key-template --pkt

Modèle de génération d’une valeur de clé de partition synthétique à utiliser avec ce conteneur SQL Cosmos DB. Le modèle doit inclure au moins l’un des espaces réservés suivants : {iothub}, {deviceid}, {DD}, {MM}et {AAAA}. Tous les espaces réservés peuvent être spécifiés au maximum une fois, mais les composants de commande et non-espace réservé sont arbitraires. Si le nom de clé de partition est fourni, le modèle de clé de partition est défini par défaut sur {deviceid}-{AAAA}-{MM}.

--pk --primary-key

Clé primaire du compte Cosmos DB.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

--secondary-key --sk

Clé secondaire du compte Cosmos DB.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
Valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az iot hub message-endpoint create eventhub

Préversion

Le groupe de commandes « iot hub message-endpoint » est en préversion et en cours de développement. Référence et niveaux de support : https://aka.ms/CLI_refstatus

Ajoutez un point de terminaison Event Hub pour un hub IoT.

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]

Exemples

Créez un point de terminaison Event Hub basé sur des clés pour un hub IoT.

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

Créez un point de terminaison Event Hub pour un hub IoT à l’aide d’un chaîne de connexion. L’URI de point de terminaison et le chemin d’accès d’entité sont omis.

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

Créez un point de terminaison Event Hub pour un IoT Hub à l’aide de l’identité affectée par le système. Le point de terminaison et le chemin d’accès d’entité doivent être spécifiés.

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

Créez un point de terminaison Event Hub pour un Hub IoT à l’aide de l’identité affectée par l’utilisateur. Le point de terminaison et le chemin d’accès d’entité doivent être spécifiés.

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}

Paramètres obligatoires

--en --endpoint --endpoint-name

Nom du point de terminaison de routage.

--hub-name -n

Nom d’IoT Hub.

Paramètres facultatifs

--connection-string -c

Chaîne de connexion du point de terminaison de routage.

--endpoint-namespace-name --namespace

Nom de l’espace de noms de la ressource de point de terminaison.

--endpoint-policy-name --policy

Nom de la stratégie pour chaîne de connexion récupération.

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

Groupe de ressources de la ressource du point de terminaison. S’il n’est pas fourni, le groupe de ressources d’IoT Hub sera utilisé.

--endpoint-subscription-id -s

ID d’abonnement de la ressource de point de terminaison. S’il n’est pas fourni, l’abonnement d’IoT Hub est utilisé.

--endpoint-uri

URI de la ressource de point de terminaison.

--entity-path

Chemin d’accès d’entité de la ressource de point de terminaison.

--identity

Utilisez une identité managée affectée par le système ou affectée par l’utilisateur pour l’authentification de point de terminaison. Utilisez « [système] » pour faire référence à l’identité affectée par le système ou à un ID de ressource pour faire référence à une identité affectée par l’utilisateur.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
Valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az iot hub message-endpoint create servicebus-queue

Préversion

Le groupe de commandes « iot hub message-endpoint » est en préversion et en cours de développement. Référence et niveaux de support : https://aka.ms/CLI_refstatus

Ajoutez un point de terminaison de file d’attente Service Bus pour un hub IoT.

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]

Exemples

Créez un point de terminaison de file d’attente Service Bus basé sur des clés pour un hub IoT.

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

Créez un point de terminaison de file d’attente Service Bus pour un hub IoT à l’aide d’un chaîne de connexion. L’URI de point de terminaison et le chemin d’accès d’entité sont omis.

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

Créez un point de terminaison de file d’attente Service Bus pour un Hub IoT à l’aide de l’identité affectée par le système. Le point de terminaison et le chemin d’accès d’entité doivent être spécifiés.

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

Créez un point de terminaison de file d’attente Service Bus pour un Hub IoT à l’aide de l’identité affectée par l’utilisateur. Le point de terminaison et le chemin d’accès d’entité doivent être spécifiés.

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}

Paramètres obligatoires

--en --endpoint --endpoint-name

Nom du point de terminaison de routage.

--hub-name -n

Nom d’IoT Hub.

Paramètres facultatifs

--connection-string -c

Chaîne de connexion du point de terminaison de routage.

--endpoint-namespace-name --namespace

Nom de l’espace de noms de la ressource de point de terminaison.

--endpoint-policy-name --policy

Nom de la stratégie pour chaîne de connexion récupération.

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

Groupe de ressources de la ressource du point de terminaison. S’il n’est pas fourni, le groupe de ressources d’IoT Hub sera utilisé.

--endpoint-subscription-id -s

ID d’abonnement de la ressource de point de terminaison. S’il n’est pas fourni, l’abonnement d’IoT Hub est utilisé.

--endpoint-uri

URI de la ressource de point de terminaison.

--entity-path

Chemin d’accès d’entité de la ressource de point de terminaison.

--identity

Utilisez une identité managée affectée par le système ou affectée par l’utilisateur pour l’authentification de point de terminaison. Utilisez « [système] » pour faire référence à l’identité affectée par le système ou à un ID de ressource pour faire référence à une identité affectée par l’utilisateur.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
Valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az iot hub message-endpoint create servicebus-topic

Préversion

Le groupe de commandes « iot hub message-endpoint » est en préversion et en cours de développement. Référence et niveaux de support : https://aka.ms/CLI_refstatus

Ajoutez un point de terminaison de rubrique Service Bus pour un hub IoT.

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]

Exemples

Créez un point de terminaison de rubrique Service Bus basé sur des clés pour un hub IoT.

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

Créez un point de terminaison de rubrique Service Bus pour un hub IoT à l’aide d’un chaîne de connexion. L’URI de point de terminaison et le chemin d’accès d’entité sont omis.

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

Créez un point de terminaison de rubrique Service Bus pour un Hub IoT à l’aide de l’identité affectée par le système. Le point de terminaison et le chemin d’accès d’entité doivent être spécifiés.

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

Créez un point de terminaison de rubrique Service Bus pour un Hub IoT à l’aide de l’identité affectée par l’utilisateur. Le point de terminaison et le chemin d’accès d’entité doivent être spécifiés.

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}

Paramètres obligatoires

--en --endpoint --endpoint-name

Nom du point de terminaison de routage.

--hub-name -n

Nom d’IoT Hub.

Paramètres facultatifs

--connection-string -c

Chaîne de connexion du point de terminaison de routage.

--endpoint-namespace-name --namespace

Nom de l’espace de noms de la ressource de point de terminaison.

--endpoint-policy-name --policy

Nom de la stratégie pour chaîne de connexion récupération.

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

Groupe de ressources de la ressource du point de terminaison. S’il n’est pas fourni, le groupe de ressources d’IoT Hub sera utilisé.

--endpoint-subscription-id -s

ID d’abonnement de la ressource de point de terminaison. S’il n’est pas fourni, l’abonnement d’IoT Hub est utilisé.

--endpoint-uri

URI de la ressource de point de terminaison.

--entity-path

Chemin d’accès d’entité de la ressource de point de terminaison.

--identity

Utilisez une identité managée affectée par le système ou affectée par l’utilisateur pour l’authentification de point de terminaison. Utilisez « [système] » pour faire référence à l’identité affectée par le système ou à un ID de ressource pour faire référence à une identité affectée par l’utilisateur.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
Valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az iot hub message-endpoint create storage-container

Préversion

Le groupe de commandes « iot hub message-endpoint » est en préversion et en cours de développement. Référence et niveaux de support : https://aka.ms/CLI_refstatus

Ajoutez un point de terminaison de conteneur de stockage pour un hub IoT.

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]

Exemples

Créez un point de terminaison de conteneur de stockage basé sur des clés pour un hub IoT.

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

Créez un point de terminaison de conteneur de stockage pour un hub IoT à l’aide d’un chaîne de connexion. L’URI du point de terminaison est omis.

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

Créez un point de terminaison de conteneur de stockage pour un IoT Hub à l’aide de l’identité affectée par le système avec la fréquence de lot, la taille de bloc et le format de nom de fichier donnés. Le point de terminaison doit être spécifié.

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]

Créez un point de terminaison de conteneur de stockage pour un Hub IoT à l’aide de l’identité affectée par l’utilisateur avec encodage json. Le point de terminaison doit être spécifié.

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}

Paramètres obligatoires

--container --container-name

Nom du conteneur de stockage.

--en --endpoint --endpoint-name

Nom du point de terminaison de routage.

--hub-name -n

Nom d’IoT Hub.

Paramètres facultatifs

--batch-frequency -b

Demander une fréquence de traitement par lots en secondes. Durée maximale qui peut s’écouler avant l’écriture des données dans un objet blob, entre 60 et 720 secondes.

Valeur par défaut: 300
--chunk-size -w

Taille de bloc de requête en mégaoctets(Mo). Taille maximale des objets blob, comprise entre 10 et 500 Mo.

Valeur par défaut: 300
--connection-string -c

Chaîne de connexion du point de terminaison de routage.

--encoding

Format d’encodage pour le conteneur.

Valeurs acceptées: avro, json
Valeur par défaut: avro
--endpoint-account

Nom du compte pour la ressource de point de terminaison.

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

Groupe de ressources de la ressource du point de terminaison. S’il n’est pas fourni, le groupe de ressources d’IoT Hub sera utilisé.

--endpoint-subscription-id -s

ID d’abonnement de la ressource de point de terminaison. S’il n’est pas fourni, l’abonnement d’IoT Hub est utilisé.

--endpoint-uri

URI de la ressource de point de terminaison.

--ff --file-name-format

Format de nom de fichier pour l’objet blob. Le format de nom de fichier doit contenir {iothub}, {partition}, {AAAA}, {MM}, {DD}, {HH} et {mm}. Tous les paramètres sont obligatoires, mais peuvent être réorganisé avec ou sans délimiteurs.

Valeur par défaut: {iothub}/{partition}/{YYYY}/{MM}/{DD}/{HH}/{mm}
--identity

Utilisez une identité managée affectée par le système ou affectée par l’utilisateur pour l’authentification de point de terminaison. Utilisez « [système] » pour faire référence à l’identité affectée par le système ou à un ID de ressource pour faire référence à une identité affectée par l’utilisateur.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
Valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.