az dt endpoint create

Note

Эта ссылка является частью расширения Azure-iot для Azure CLI (версия 2.67.0 или более поздней). Расширение автоматически установит первый запуск команды az dt endpoint create. Подробнее о расширениях.

Добавьте конечные точки исходящего трафика в экземпляр Digital Twins.

Команды

Имя Описание Тип Состояние
az dt endpoint create eventgrid

Добавляет конечную точку раздела EventGrid в экземпляр Digital Twins. Требуется предварительно созданный ресурс.

 Extension GA
az dt endpoint create eventhub

Добавляет конечную точку EventHub в экземпляр Digital Twins.

 Extension GA
az dt endpoint create servicebus

Добавляет конечную точку раздела ServiceBus в экземпляр Digital Twins.

 Extension GA

az dt endpoint create eventgrid

Добавляет конечную точку раздела EventGrid в экземпляр Digital Twins. Требуется предварительно созданный ресурс.

Конечные точки раздела EventGrid не поддерживают интеграцию конечных точек на основе удостоверений.

az dt endpoint create eventgrid --dt-name --dtn
                                --egt --eventgrid-topic
                                --en --endpoint-name
                                [--acquire-policy-token]
                                [--change-reference]
                                [--deadletter-sas-uri --dsu]
                                [--deadletter-uri --du]
                                [--egg --eventgrid-resource-group]
                                [--egs --eventgrid-subscription]
                                [--no-wait]
                                [--resource-group]

Примеры

Добавляет конечную точку раздела EventGrid в целевой экземпляр.

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

Обязательные параметры

--dt-name --dtn -n

Имя экземпляра Digital Twins.

--egt --eventgrid-topic

Имя раздела EventGrid для интеграции.

Свойство Значение
Группа параметров: Event Grid Topic Arguments
--en --endpoint-name

Имя конечной точки.

Необязательные параметры

Следующие параметры являются необязательными, но в зависимости от контекста один или несколько могут потребоваться для успешного выполнения команды.

--acquire-policy-token

Автоматическое получение маркера Azure Policy для этой операции ресурса.

Свойство Значение
Группа параметров: Global Policy Arguments
--change-reference

Связанный идентификатор ссылки на изменение для этой операции ресурса.

Свойство Значение
Группа параметров: Global Policy Arguments
--deadletter-sas-uri --dsu

URL-адрес контейнера хранилища недоставленных букв с маркером SAS для проверки подлинности на основе ключа.

Свойство Значение
Группа параметров: Dead-letter Endpoint Arguments
--deadletter-uri --du

URL-адрес контейнера хранилища недоставленных букв для проверки подлинности на основе удостоверений.

Свойство Значение
Группа параметров: Dead-letter Endpoint Arguments
--egg --eventgrid-resource-group

Имя группы ресурсов раздела EventGrid. Если это не указано, будет использоваться группа ресурсов экземпляра Digital Twin.

Свойство Значение
Группа параметров: Event Grid Topic Arguments
--egs --eventgrid-subscription

Имя или идентификатор подписки, в которой существует ресурс конечной точки. Если подписка не указана, используется подписка по умолчанию.

Свойство Значение
Группа параметров: Event Grid Topic Arguments
--no-wait

Не ожидать завершения длительной операции.

Свойство Значение
Значение по умолчанию: False
--resource-group -g

Группа ресурсов экземпляра Digital Twins. Группу по умолчанию можно настроить с помощью az configure --defaults group={name}.

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство Значение
Значение по умолчанию: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство Значение
Значение по умолчанию: False
--output -o

Формат вывода.

Свойство Значение
Значение по умолчанию: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство Значение
Значение по умолчанию: False

az dt endpoint create eventhub

Добавляет конечную точку EventHub в экземпляр Digital Twins.

Требуется предварительно созданный ресурс.

Экземпляр должен иметь удостоверение, назначаемое системой, для поддержки интеграции конечных точек на основе системных удостоверений. Экземпляр должен иметь удостоверение, назначаемое пользователем, для поддержки интеграции конечных точек на основе удостоверений на основе пользователей.

az dt endpoint create eventhub --dt-name --dtn
                               --eh --eventhub
                               --ehn --eventhub-namespace
                               --en --endpoint-name
                               [--acquire-policy-token]
                               [--auth-type {IdentityBased, KeyBased}]
                               [--change-reference]
                               [--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]

Примеры

Добавляет конечную точку EventHub в целевой экземпляр с помощью проверки подлинности на основе ключа.

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}

Добавляет конечную точку EventHub в целевой экземпляр с помощью назначаемого системой удостоверения для проверки подлинности.

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}

Добавляет конечную точку EventHub в целевой экземпляр, используя назначаемое пользователем удостоверение для проверки подлинности.

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}

Обязательные параметры

--dt-name --dtn -n

Имя экземпляра Digital Twins.

--eh --eventhub

Имя EventHub для интеграции с.

Свойство Значение
Группа параметров: Event Hub Arguments
--ehn --eventhub-namespace

Идентификатор пространства имен EventHub.

Свойство Значение
Группа параметров: Event Hub Arguments
--en --endpoint-name

Имя конечной точки.

Необязательные параметры

Следующие параметры являются необязательными, но в зависимости от контекста один или несколько могут потребоваться для успешного выполнения команды.

--acquire-policy-token

Автоматическое получение маркера Azure Policy для этой операции ресурса.

Свойство Значение
Группа параметров: Global Policy Arguments
--auth-type
Не рекомендуется

Аргумент "auth_type" устарел и будет удален в будущем выпуске. Вместо этого используйте идентификатор.

Тип проверки подлинности конечной точки.

Свойство Значение
Значение по умолчанию: KeyBased
Допустимые значения: IdentityBased, KeyBased
--change-reference

Связанный идентификатор ссылки на изменение для этой операции ресурса.

Свойство Значение
Группа параметров: Global Policy Arguments
--deadletter-sas-uri --dsu

URL-адрес контейнера хранилища недоставленных букв с маркером SAS для проверки подлинности на основе ключа.

Свойство Значение
Группа параметров: Dead-letter Endpoint Arguments
--deadletter-uri --du

URL-адрес контейнера хранилища недоставленных букв для проверки подлинности на основе удостоверений.

Свойство Значение
Группа параметров: Dead-letter Endpoint Arguments
--ehg --eventhub-resource-group

Имя группы ресурсов EventHub. Если это не указано, будет использоваться группа ресурсов экземпляра Digital Twin.

Свойство Значение
Группа параметров: Event Hub Arguments
--ehp --eventhub-policy

Политика EventHub, используемая для настройки конечной точки. Требуется, когда —-auth-type имеет значение KeyBased.

Свойство Значение
Группа параметров: Event Hub Arguments
--ehs --eventhub-subscription

Имя или идентификатор подписки, в которой существует ресурс конечной точки. Если подписка не указана, используется подписка по умолчанию.

Свойство Значение
Группа параметров: Event Hub Arguments
--mi-system-assigned --system

Используйте управляемое удостоверение, назначаемое системой, для проверки подлинности конечной точки.

Свойство Значение
Допустимые значения: false, true
--mi-user-assigned --user

Используйте управляемое удостоверение, назначаемое пользователем, для проверки подлинности конечной точки. Принимает идентификатор ресурса удостоверения.

--no-wait

Не ожидать завершения длительной операции.

Свойство Значение
Значение по умолчанию: False
--resource-group -g

Группа ресурсов экземпляра Digital Twins. Группу по умолчанию можно настроить с помощью az configure --defaults group={name}.

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство Значение
Значение по умолчанию: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство Значение
Значение по умолчанию: False
--output -o

Формат вывода.

Свойство Значение
Значение по умолчанию: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство Значение
Значение по умолчанию: False

az dt endpoint create servicebus

Добавляет конечную точку раздела ServiceBus в экземпляр Digital Twins.

Требуется предварительно созданный ресурс.

Экземпляр должен иметь удостоверение, назначаемое системой, для поддержки интеграции конечных точек на основе системных удостоверений. Экземпляр должен иметь удостоверение, назначаемое пользователем, для поддержки интеграции конечных точек на основе удостоверений на основе пользователей.

az dt endpoint create servicebus --dt-name --dtn
                                 --en --endpoint-name
                                 --sbn --servicebus-namespace
                                 --sbt --servicebus-topic
                                 [--acquire-policy-token]
                                 [--auth-type {IdentityBased, KeyBased}]
                                 [--change-reference]
                                 [--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]

Примеры

Добавляет конечную точку раздела ServiceBus в целевой экземпляр с помощью проверки подлинности на основе ключей.

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}

Добавляет конечную точку раздела ServiceBus в целевой экземпляр с помощью назначаемого системой удостоверения для проверки подлинности.

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}

Добавляет конечную точку раздела ServiceBus в целевой экземпляр с помощью удостоверения, назначаемого пользователем для проверки подлинности.

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}

Обязательные параметры

--dt-name --dtn -n

Имя экземпляра Digital Twins.

--en --endpoint-name

Имя конечной точки.

--sbn --servicebus-namespace

Идентификатор пространства имен ServiceBus.

Свойство Значение
Группа параметров: Service Bus Topic Arguments
--sbt --servicebus-topic

Имя раздела ServiceBus для интеграции.

Свойство Значение
Группа параметров: Service Bus Topic Arguments

Необязательные параметры

Следующие параметры являются необязательными, но в зависимости от контекста один или несколько могут потребоваться для успешного выполнения команды.

--acquire-policy-token

Автоматическое получение маркера Azure Policy для этой операции ресурса.

Свойство Значение
Группа параметров: Global Policy Arguments
--auth-type
Не рекомендуется

Аргумент "auth_type" устарел и будет удален в будущем выпуске. Вместо этого используйте идентификатор.

Тип проверки подлинности конечной точки.

Свойство Значение
Значение по умолчанию: KeyBased
Допустимые значения: IdentityBased, KeyBased
--change-reference

Связанный идентификатор ссылки на изменение для этой операции ресурса.

Свойство Значение
Группа параметров: Global Policy Arguments
--deadletter-sas-uri --dsu

URL-адрес контейнера хранилища недоставленных букв с маркером SAS для проверки подлинности на основе ключа.

Свойство Значение
Группа параметров: Dead-letter Endpoint Arguments
--deadletter-uri --du

URL-адрес контейнера хранилища недоставленных букв для проверки подлинности на основе удостоверений.

Свойство Значение
Группа параметров: Dead-letter Endpoint Arguments
--mi-system-assigned --system

Используйте управляемое удостоверение, назначаемое системой, для проверки подлинности конечной точки.

Свойство Значение
Допустимые значения: false, true
--mi-user-assigned --user

Используйте управляемое удостоверение, назначаемое пользователем, для проверки подлинности конечной точки. Принимает идентификатор ресурса удостоверения.

--no-wait

Не ожидать завершения длительной операции.

Свойство Значение
Значение по умолчанию: False
--resource-group -g

Группа ресурсов экземпляра Digital Twins. Группу по умолчанию можно настроить с помощью az configure --defaults group={name}.

--sbg --servicebus-resource-group

Имя группы ресурсов ServiceBus. Если это не указано, будет использоваться группа ресурсов экземпляра Digital Twin.

Свойство Значение
Группа параметров: Service Bus Topic Arguments
--sbp --servicebus-policy

Политика раздела ServiceBus, используемая для настройки конечной точки. Требуется, когда —-auth-type имеет значение KeyBased.

Свойство Значение
Группа параметров: Service Bus Topic Arguments
--sbs --servicebus-subscription

Имя или идентификатор подписки, в которой существует ресурс конечной точки. Если подписка не указана, используется подписка по умолчанию.

Свойство Значение
Группа параметров: Service Bus Topic Arguments
Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство Значение
Значение по умолчанию: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство Значение
Значение по умолчанию: False
--output -o

Формат вывода.

Свойство Значение
Значение по умолчанию: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство Значение
Значение по умолчанию: False