az iot ops schema registry
Note
Эта ссылка является частью расширения azure-iot-ops для Azure CLI (версия 2.70.0 или более поздней). Расширение будет автоматически устанавливаться при первом запуске команды az iot ops schema registry . Подробнее о расширениях.
Управление реестром схем.
Реестр схем — это централизованный репозиторий для управления схемами. Реестр схем позволяет создавать и извлекать схемы как в пограничном, так и в облаке. Она обеспечивает согласованность и совместимость между системами путем предоставления единого источника истины для определений схем.
Команды
| Имя | Описание | Тип | Состояние |
|---|---|---|---|
| az iot ops schema registry create |
Создайте реестр схем. |
Extension | GA |
| az iot ops schema registry delete |
Удаление реестра целевой схемы. |
Extension | GA |
| az iot ops schema registry list |
Вывод списка реестров схем в группе ресурсов или подписке. |
Extension | GA |
| az iot ops schema registry show |
Отображение сведений о реестре схем. |
Extension | GA |
az iot ops schema registry create
Создайте реестр схем.
Эта операция создаст реестр схем с включенным системным управляемым удостоверением.
Затем он назначит системное удостоверение встроенной роли "Участник данных BLOB-объектов хранилища" для области контейнера учетной записи хранения по умолчанию. При необходимости можно предоставить пользовательскую роль с помощью идентификатора --custom-role-id, который будет использоваться.
Если указанный контейнер учетной записи хранения не существует, он будет создан с параметрами по умолчанию.
Эта операция также зарегистрирует Майкрософт. Поставщик ресурсов DeviceRegistry, если он не зарегистрирован.
az iot ops schema registry create --name
--registry-namespace --rn
--resource-group
--sa-resource-id
[--acquire-policy-token]
[--change-reference]
[--custom-role-id]
[--desc]
[--display-name]
[--location]
[--sa-container]
[--skip-ra {false, true}]
[--tags]
Примеры
Создайте реестр схем с именем myregistry с минимальными входными данными.
az iot ops schema registry create -n myregistry -g myresourcegroup --registry-namespace myschemas --sa-resource-id $STORAGE_ACCOUNT_RESOURCE_ID
Создайте реестр схем с именем myregistry в регионе westus2 с дополнительной настройкой.
az iot ops schema registry create -n myregistry -g myresourcegroup --registry-namespace myschemas --sa-resource-id $STORAGE_ACCOUNT_RESOURCE_ID --sa-container myschemacontainer -l westus2 --desc 'Contoso factory X1 schemas' --display-name 'Contoso X1' --tags env=prod
Обязательные параметры
Имя реестра схем.
Пространство имен реестра схем. Уникально идентифицирует реестр схем в клиенте.
Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.
Идентификатор ресурса учетной записи хранения для использования с реестром схем.
Необязательные параметры
Следующие параметры являются необязательными, но в зависимости от контекста один или несколько могут потребоваться для успешного выполнения команды.
Автоматическое получение маркера Политика Azure для этой операции ресурса.
| Свойство | Значение |
|---|---|
| Группа параметров: | Global Policy Arguments |
Связанный идентификатор ссылки на изменение для этой операции ресурса.
| Свойство | Значение |
|---|---|
| Группа параметров: | Global Policy Arguments |
Полный идентификатор определения роли в следующем формате: /subscriptions/{subscriptionId}/providers/Майкрософт. Authorization/roleDefinitions/{roleId}.
| Свойство | Значение |
|---|---|
| Группа параметров: | Role Assignment Arguments |
Описание реестра схем.
Отображаемое имя реестра схем.
Регион для создания реестра схем. Если расположение группы ресурсов не указано, будет использоваться.
Имя контейнера учетной записи хранения, в котором будут храниться схемы.
| Свойство | Значение |
|---|---|
| Default value: | schemas |
При использовании шага назначения ролей операция будет пропущена.
| Свойство | Значение |
|---|---|
| Группа параметров: | Role Assignment Arguments |
| Допустимые значения: | false, true |
Теги, разделенные пробелами: key[=value] [key[=value] ...]. Используйте "" для очистки существующих тегов.
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
| Свойство | Значение |
|---|---|
| Default value: | False |
Показать это сообщение справки и выйти.
Отображать только ошибки, не показывая предупреждения.
| Свойство | Значение |
|---|---|
| Default value: | False |
Формат вывода.
| Свойство | Значение |
|---|---|
| Default value: | json |
| Допустимые значения: | json, jsonc, none, table, tsv, yaml, yamlc |
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.
Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.
| Свойство | Значение |
|---|---|
| Default value: | False |
az iot ops schema registry delete
Удаление реестра целевой схемы.
az iot ops schema registry delete --name
[--acquire-policy-token]
[--change-reference]
[--resource-group]
[--yes {false, true}]
Примеры
Удалите реестр схем myregistry.
az iot ops schema registry delete -n myregistry -g myresourcegroup
Обязательные параметры
Имя реестра схем.
Необязательные параметры
Следующие параметры являются необязательными, но в зависимости от контекста один или несколько могут потребоваться для успешного выполнения команды.
Автоматическое получение маркера Политика Azure для этой операции ресурса.
| Свойство | Значение |
|---|---|
| Группа параметров: | Global Policy Arguments |
Связанный идентификатор ссылки на изменение для этой операции ресурса.
| Свойство | Значение |
|---|---|
| Группа параметров: | Global Policy Arguments |
Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.
Подтвердите [y]es без запроса. Полезно для сценариев CI и автоматизации.
| Свойство | Значение |
|---|---|
| Допустимые значения: | false, true |
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
| Свойство | Значение |
|---|---|
| Default value: | False |
Показать это сообщение справки и выйти.
Отображать только ошибки, не показывая предупреждения.
| Свойство | Значение |
|---|---|
| Default value: | False |
Формат вывода.
| Свойство | Значение |
|---|---|
| Default value: | json |
| Допустимые значения: | json, jsonc, none, table, tsv, yaml, yamlc |
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.
Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.
| Свойство | Значение |
|---|---|
| Default value: | False |
az iot ops schema registry list
Вывод списка реестров схем в группе ресурсов или подписке.
az iot ops schema registry list [--resource-group]
Примеры
Перечисление регистров схемы в группе ресурсов myresourcegroup.
az iot ops schema registry list -g myresourcegroup
Вывод списка регистров схемы в фильтрации подписки по умолчанию для определенного тега.
az iot ops schema registry list --query "[?tags.env == 'prod']"
Необязательные параметры
Следующие параметры являются необязательными, но в зависимости от контекста один или несколько могут потребоваться для успешного выполнения команды.
Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
| Свойство | Значение |
|---|---|
| Default value: | False |
Показать это сообщение справки и выйти.
Отображать только ошибки, не показывая предупреждения.
| Свойство | Значение |
|---|---|
| Default value: | False |
Формат вывода.
| Свойство | Значение |
|---|---|
| Default value: | json |
| Допустимые значения: | json, jsonc, none, table, tsv, yaml, yamlc |
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.
Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.
| Свойство | Значение |
|---|---|
| Default value: | False |
az iot ops schema registry show
Отображение сведений о реестре схем.
az iot ops schema registry show --name
--resource-group
Примеры
Отображение сведений о реестре целевых схем myregistry.
az iot ops schema registry show --name myregistry -g myresourcegroup
Обязательные параметры
Имя реестра схем.
Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
| Свойство | Значение |
|---|---|
| Default value: | False |
Показать это сообщение справки и выйти.
Отображать только ошибки, не показывая предупреждения.
| Свойство | Значение |
|---|---|
| Default value: | False |
Формат вывода.
| Свойство | Значение |
|---|---|
| Default value: | json |
| Допустимые значения: | json, jsonc, none, table, tsv, yaml, yamlc |
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.
Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.
| Свойство | Значение |
|---|---|
| Default value: | False |