Partager via

az dt endpoint create

Note

Cette référence fait partie de l’extension azure-iot pour Azure CLI (version 2.67.0 ou ultérieure). L’extension installe automatiquement la première fois que vous exécutez un point de terminaison az dt endpoint create commande. Apprenez-en davantage sur les extensions.

Ajoutez des points de terminaison de sortie à une instance Digital Twins.

Commandes

Nom Description Type État
az dt endpoint create eventgrid

Ajoute un point de terminaison de rubrique EventGrid à une instance Digital Twins. Nécessite une ressource précréé.

 Extension GA
az dt endpoint create eventhub

Ajoute un point de terminaison EventHub à une instance Digital Twins.

 Extension GA
az dt endpoint create servicebus

Ajoute un point de terminaison de rubrique ServiceBus à une instance Digital Twins.

 Extension GA

az dt endpoint create eventgrid

Ajoute un point de terminaison de rubrique EventGrid à une instance Digital Twins. Nécessite une ressource précréé.

Les points de terminaison de rubrique EventGrid ne prennent pas en charge l’intégration des points de terminaison basés sur l’identité.

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]

Exemples

Ajoute un point de terminaison de rubrique EventGrid à une instance cible.

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

Paramètres obligatoires

--dt-name --dtn -n

Nom de l’instance Digital Twins.

--egt --eventgrid-topic

Nom de la rubrique EventGrid à intégrer.

Propriété Valeur
Groupe de paramètres: Event Grid Topic Arguments
--en --endpoint-name

Nom du point de terminaison.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--deadletter-sas-uri --dsu

URL du conteneur de stockage de lettres mortes avec jeton SAP pour l’authentification basée sur des clés.

Propriété Valeur
Groupe de paramètres: Dead-letter Endpoint Arguments
--deadletter-uri --du

URL du conteneur de stockage de lettres mortes pour l’authentification basée sur l’identité.

Propriété Valeur
Groupe de paramètres: Dead-letter Endpoint Arguments
--egg --eventgrid-resource-group

Nom du groupe de ressources rubrique EventGrid. S’il n’est pas fourni, le groupe de ressources d’instance Digital Twin est utilisé.

Propriété Valeur
Groupe de paramètres: Event Grid Topic Arguments
--egs --eventgrid-subscription

Nom ou ID de l’abonnement où la ressource de point de terminaison existe. Si aucun abonnement n’est fourni, l’abonnement par défaut est utilisé.

Propriété Valeur
Groupe de paramètres: Event Grid Topic Arguments
--no-wait

Ne pas attendre la fin de l’opération de longue durée.

Propriété Valeur
Valeur par défaut: False
--resource-group -g

Groupe de ressources d’instance Digital Twins. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group={name}.

Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

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

Chaîne de requête 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 à l’aide de az account set -s NAME_OR_ID.

--verbose

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

Propriété Valeur
Valeur par défaut: False

az dt endpoint create eventhub

Ajoute un point de terminaison EventHub à une instance Digital Twins.

Nécessite une ressource précréé.

L’instance doit avoir une identité affectée par le système pour prendre en charge l’intégration du point de terminaison basé sur l’identité affectée par le système. L’instance doit avoir l’identité affectée par l’utilisateur associée pour prendre en charge l’intégration du point de terminaison basé sur l’identité affectée par l’utilisateur.

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]

Exemples

Ajoute un point de terminaison EventHub à une instance cible à l’aide de l’authentification basée sur une clé.

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}

Ajoute un point de terminaison EventHub à une instance cible à l’aide de l’identité affectée par le système pour l’authentification.

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}

Ajoute un point de terminaison EventHub à une instance cible à l’aide d’une identité affectée par l’utilisateur pour l’authentification.

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}

Paramètres obligatoires

--dt-name --dtn -n

Nom de l’instance Digital Twins.

--eh --eventhub

Nom d’EventHub à intégrer.

Propriété Valeur
Groupe de paramètres: Event Hub Arguments
--ehn --eventhub-namespace

Identificateur d’espace de noms EventHub.

Propriété Valeur
Groupe de paramètres: Event Hub Arguments
--en --endpoint-name

Nom du point de terminaison.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--auth-type
Déprécié

L’argument 'auth_type' a été déconseillé et sera supprimé dans une version ultérieure. Utilisez plutôt « identity ».

Type d’authentification du point de terminaison.

Propriété Valeur
Valeur par défaut: KeyBased
Valeurs acceptées: IdentityBased, KeyBased
--deadletter-sas-uri --dsu

URL du conteneur de stockage de lettres mortes avec jeton SAP pour l’authentification basée sur des clés.

Propriété Valeur
Groupe de paramètres: Dead-letter Endpoint Arguments
--deadletter-uri --du

URL du conteneur de stockage de lettres mortes pour l’authentification basée sur l’identité.

Propriété Valeur
Groupe de paramètres: Dead-letter Endpoint Arguments
--ehg --eventhub-resource-group

Nom du groupe de ressources EventHub. S’il n’est pas fourni, le groupe de ressources d’instance Digital Twin est utilisé.

Propriété Valeur
Groupe de paramètres: Event Hub Arguments
--ehp --eventhub-policy

Stratégie EventHub à utiliser pour la configuration du point de terminaison. Obligatoire lorsque --auth-type est KeyBased.

Propriété Valeur
Groupe de paramètres: Event Hub Arguments
--ehs --eventhub-subscription

Nom ou ID de l’abonnement où la ressource de point de terminaison existe. Si aucun abonnement n’est fourni, l’abonnement par défaut est utilisé.

Propriété Valeur
Groupe de paramètres: Event Hub Arguments
--mi-system-assigned --system

Utilisez l’identité managée affectée par le système pour l’authentification de point de terminaison.

Propriété Valeur
Valeurs acceptées: false, true
--mi-user-assigned --user

Utilisez une identité managée affectée par l’utilisateur pour l’authentification de point de terminaison. Accepte l’ID de ressource d’identité.

--no-wait

Ne pas attendre la fin de l’opération de longue durée.

Propriété Valeur
Valeur par défaut: False
--resource-group -g

Groupe de ressources d’instance Digital Twins. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group={name}.

Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

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

Chaîne de requête 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 à l’aide de az account set -s NAME_OR_ID.

--verbose

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

Propriété Valeur
Valeur par défaut: False

az dt endpoint create servicebus

Ajoute un point de terminaison de rubrique ServiceBus à une instance Digital Twins.

Nécessite une ressource précréé.

L’instance doit avoir une identité affectée par le système pour prendre en charge l’intégration du point de terminaison basé sur l’identité affectée par le système. L’instance doit avoir l’identité affectée par l’utilisateur associée pour prendre en charge l’intégration du point de terminaison basé sur l’identité affectée par l’utilisateur.

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]

Exemples

Ajoute un point de terminaison de rubrique ServiceBus à une instance cible à l’aide de l’authentification basée sur une clé.

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}

Ajoute un point de terminaison de rubrique ServiceBus à une instance cible à l’aide de l’identité affectée par le système pour l’authentification.

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}

Ajoute un point de terminaison de rubrique ServiceBus à une instance cible à l’aide d’une identité affectée par l’utilisateur pour l’authentification.

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}

Paramètres obligatoires

--dt-name --dtn -n

Nom de l’instance Digital Twins.

--en --endpoint-name

Nom du point de terminaison.

--sbn --servicebus-namespace

Identificateur de l’espace de noms ServiceBus.

Propriété Valeur
Groupe de paramètres: Service Bus Topic Arguments
--sbt --servicebus-topic

Nom de la rubrique ServiceBus à intégrer.

Propriété Valeur
Groupe de paramètres: Service Bus Topic Arguments

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--auth-type
Déprécié

L’argument 'auth_type' a été déconseillé et sera supprimé dans une version ultérieure. Utilisez plutôt « identity ».

Type d’authentification du point de terminaison.

Propriété Valeur
Valeur par défaut: KeyBased
Valeurs acceptées: IdentityBased, KeyBased
--deadletter-sas-uri --dsu

URL du conteneur de stockage de lettres mortes avec jeton SAP pour l’authentification basée sur des clés.

Propriété Valeur
Groupe de paramètres: Dead-letter Endpoint Arguments
--deadletter-uri --du

URL du conteneur de stockage de lettres mortes pour l’authentification basée sur l’identité.

Propriété Valeur
Groupe de paramètres: Dead-letter Endpoint Arguments
--mi-system-assigned --system

Utilisez l’identité managée affectée par le système pour l’authentification de point de terminaison.

Propriété Valeur
Valeurs acceptées: false, true
--mi-user-assigned --user

Utilisez une identité managée affectée par l’utilisateur pour l’authentification de point de terminaison. Accepte l’ID de ressource d’identité.

--no-wait

Ne pas attendre la fin de l’opération de longue durée.

Propriété Valeur
Valeur par défaut: False
--resource-group -g

Groupe de ressources d’instance Digital Twins. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group={name}.

--sbg --servicebus-resource-group

Nom du groupe de ressources ServiceBus. S’il n’est pas fourni, le groupe de ressources d’instance Digital Twin est utilisé.

Propriété Valeur
Groupe de paramètres: Service Bus Topic Arguments
--sbp --servicebus-policy

Stratégie de rubrique ServiceBus à utiliser pour la configuration du point de terminaison. Obligatoire lorsque --auth-type est KeyBased.

Propriété Valeur
Groupe de paramètres: Service Bus Topic Arguments
--sbs --servicebus-subscription

Nom ou ID de l’abonnement où la ressource de point de terminaison existe. Si aucun abonnement n’est fourni, l’abonnement par défaut est utilisé.

Propriété Valeur
Groupe de paramètres: Service Bus Topic Arguments
Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

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

Chaîne de requête 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 à l’aide de az account set -s NAME_OR_ID.

--verbose

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

Propriété Valeur
Valeur par défaut: False