Поделиться через


az iot ops schema registry

Note

Эта ссылка является частью расширения azure-iot-ops для Azure CLI (версия 2.67.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, который будет использоваться.

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

Эта операция также зарегистрирует поставщика ресурсов Microsoft.DeviceRegistry, если он не зарегистрирован.

az iot ops schema registry create --name
                                  --registry-namespace --rn
                                  --resource-group
                                  --sa-resource-id
                                  [--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

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

--name -n

Имя реестра схем.

--registry-namespace --rn

Пространство имен реестра схем. Уникально идентифицирует реестр схем в клиенте.

--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

--sa-resource-id

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

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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--custom-role-id

Полный идентификатор определения роли в следующем формате: /subscriptions/{subscriptionId}/providers/Microsoft.Authorization/roleDefinitions/{roleId}.

Свойство Значение
Parameter group: Role Assignment Arguments
--desc

Описание реестра схем.

--display-name

Отображаемое имя реестра схем.

--location -l

Регион для создания реестра схем. Если расположение группы ресурсов не указано, будет использоваться.

--sa-container

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

Свойство Значение
Default value: schemas
--skip-ra

При использовании шага назначения ролей операция будет пропущена.

Свойство Значение
Parameter group: Role Assignment Arguments
Допустимые значения: false, true
--tags

Теги, разделенные пробелами: key[=value] [key[=value] ...]. Используйте "" для очистки существующих тегов.

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

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

Свойство Значение
Default value: False
--help -h

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

--only-show-errors

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

Свойство Значение
Default value: False
--output -o

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

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

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

--subscription

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

--verbose

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

Свойство Значение
Default value: False

az iot ops schema registry delete

Удаление реестра целевой схемы.

az iot ops schema registry delete --name
                                  [--resource-group]
                                  [--yes {false, true}]

Примеры

Удалите реестр схем myregistry.

az iot ops schema registry delete -n myregistry -g myresourcegroup

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

--name -n

Имя реестра схем.

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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

--yes -y

Подтвердите [y]es без запроса. Полезно для сценариев CI и автоматизации.

Свойство Значение
Допустимые значения: false, true
Глобальные параметры
--debug

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

Свойство Значение
Default value: False
--help -h

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

--only-show-errors

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

Свойство Значение
Default value: False
--output -o

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

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

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

--subscription

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

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --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']"

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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

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

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

Свойство Значение
Default value: False
--help -h

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

--only-show-errors

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

Свойство Значение
Default value: False
--output -o

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

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

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

--subscription

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

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --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

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

--name -n

Имя реестра схем.

--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

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

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

Свойство Значение
Default value: False
--help -h

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

--only-show-errors

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

Свойство Значение
Default value: False
--output -o

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

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

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

--subscription

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

--verbose

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

Свойство Значение
Default value: False