Azure IoT Operations インスタンスのライフサイクルを管理する

2025-08-07

Azure CLI と Azure portal を使用して、Azure IoT Operations インスタンスを管理、アンインストール、または更新します。

前提条件

クラスターにデプロイされた Azure IoT Operations インスタンス。詳細については、「Deploy Azure IoT Operations」をご覧ください。
開発マシンにインストールされた Azure CLI。このシナリオには、Azure CLI バージョン 2.53.0 以降が必要です。 az --version を使用してバージョンを確認し、必要に応じて az upgrade を使用して更新します。詳細については、Azure CLIのインストール方法に関するページを参照してください。
Azure CLI 用の Azure IoT Operations 拡張機能。次のコマンドを使用して、拡張機能を追加するか、それを最新バージョンに更新します。
```
az extension add --upgrade --name azure-iot-ops
```

管理する

デプロイ後、Azure CLI と Azure portal を使用して、Azure IoT Operations インスタンスを表示および管理できます。

Azure portal で、Azure IoT Operations を検索して選択します。
フィルターを使用して、サブスクリプション、リソースグループなどに基づいて Azure IoT Operations インスタンスを表示します。

サブスクリプションまたはリソースグループ内のすべての Azure IoT Operations インスタンスを表示するには、az iot ops list コマンドを使用します。

基本コマンドは該当するサブスクリプションのすべてのインスタンスを返します。

az iot ops list

リソースグループで結果をフィルター処理するには、--resource-group パラメーターを追加します。

az iot ops list --resource-group <RESOURCE_GROUP>

インスタンスを表示する

Azure Portal
Azure CLI

Azure portal で Azure IoT Operations インスタンスを表示できます。

Azure portal で、Azure IoT Operations インスタンスを含むリソースグループに移動するか、Azure IoT Operations を検索して選択します。
Azure IoT Operations インスタンスの名前を選択します。
インスタンスの [概要 ] ページで、インスタンスのプロパティを確認できます。たとえば、 プレビューコネクタの状態を確認できます。この状態は、有効または無効にすることができます。プレビューコネクタの状態を変更するには、[ 編集] をクリックします。

この操作により、 ONVIF プレビューコネクタを有効または無効にできる構成パネルが開きます。
[ リソースの概要 ] タブには、クラスターにデプロイされたリソースが表示されます。

インスタンスのプロパティを表示するには az iot ops show コマンドを使用します。

az iot ops show --name <INSTANCE_NAME> --resource-group <RESOURCE_GROUP>

また、az iot ops show コマンドを使用して、Azure IoT Operations デプロイのリソースを Azure CLI で表示することもできます。 --tree フラグを追加して、指定した Azure IoT Operations インスタンスを含むデプロイのツリービューを表示します。

az iot ops show --name <INSTANCE_NAME> --resource-group <RESOURCE_GROUP> --tree

デプロイのツリービューは次の例のようになります。

MyCluster
├── extensions
│   ├── akvsecretsprovider
│   ├── azure-iot-operations-ltwgs
│   └── azure-iot-operations-platform-ltwgs
└── customLocations
    └── MyCluster-cl
        ├── resourceSyncRules
        └── resources
            ├── MyCluster-ops-init-instance
            └── MyCluster-observability

クラスター上で az iot ops check を実行して、個々の Azure IoT Operations コンポーネントの正常性と構成を評価できます。既定では、コマンドで MQ をチェックしますが、パラメーターを使用して--ops-serviceできます。

Azure Device Registry の表示

Azure portal では、Azure Device Registry を表示できます。これは、Azure IoT Operations インスタンスに接続されているすべてのデバイスと資産のコレクションです。

Azure Device Registry では、 名前空間 (プレビュー) を 使用して資産とデバイスを整理します。各 Azure IoT Operations インスタンスは、その資産とデバイスに 1 つの名前空間を使用します。複数のインスタンスで 1 つの名前空間を共有できます。

Azure Portal で Azure Device Registry の項目を表示するには:

Azure portal で、Azure Device Registry を検索して選択します。 [ 概要] ページには、サブスクリプション内の資産、スキーマレジストリ、名前空間の数がまとめられます。
[資産] ページを使用して、Azure Device Registry の資産を表示します。既定では、[ 資産] ページには、サブスクリプション内のすべての名前空間の資産が表示されます。フィルターを使用して、特定の名前空間やリソースグループ内の資産など、資産のサブセットを表示します。

$Azure portal の [Azure Device Registry assets]$Azure Device Registry 資産$ ページのスクリーンショット。$
[ スキーマレジストリ ] ページを使用して、Azure Device Registry のスキーマレジストリを表示します。既定では、[ スキーマレジストリ ] ページには、サブスクリプション内のすべての名前空間のスキーマレジストリが表示されます。フィルターを使用して、特定の名前空間またはリソースグループ内のスキーマレジストリなどのスキーマレジストリのサブセットを表示します。
[名前空間] ページを使用して、Azure Device Registry の名前空間を表示します。既定では、[ 名前空間] ページにはサブスクリプション内の名前空間が表示されます。フィルターを使用して、特定のリソースグループ内の名前空間などの名前空間のサブセットを表示します。このページでは、新しい名前空間を作成したり、既存の名前空間の詳細を表示したりできます。

Azure IoT Operations インスタンスを含むリソースグループ内の既存の名前空間の詳細を表示することもできます。たとえば、次のスクリーンショットは、aio-131235032 Azure IoT Operations インスタンスに関連付けられている adr-namespace リソースを示しています。

前のスクリーンショットでは、Azure Device Registry の他のリソース ( IoT スキーマレジストリ、 IoT 名前空間資産、 デバイス など) も、Azure IoT Operations インスタンスを含むリソースグループのコンテキストで示されています。

コネクタテンプレートを構成する

Azure portal では、Azure IoT Operations インスタンス のコネクタテンプレート を構成できます。コネクタテンプレートは、クラスターにデプロイされる OPC UA 用コネクタなどのコネクタの構成を定義します。コネクタテンプレートを作成すると、OT ユーザーは操作エクスペリエンス Web UI でコネクタの種類を使用するデバイスを作成できます。

コネクタテンプレートの詳細については、「 ONVIF 用のコネクタをデプロイする」を参照してください。

インスタンスの複製 (プレビュー)

注

複製機能はプレビュー段階であり、開発中です。

Azure Portal
Azure CLI

現時点では、Azure portal では Azure IoT Operations インスタンスの複製はサポートされていません。 Azure CLI を使用してインスタンスを複製できます。

az iot ops clone コマンドを使用して、既存のインスタンスに基づいて新しい Azure IoT Operations インスタンスを作成します。複製の出力を、レプリケーションと呼ばれる別の接続されたクラスターに適用できます。後で使用するために複製をローカルディレクトリに保存し、クラスターに適用する前にいくつかの構成変更を実行することもできます。

詳細については、複製コマンド Wiki ページを参照してください。

インスタンスを別のクラスターに複製するには、次のコマンドを実行します。

az iot ops clone --name <INSTANCE_NAME> --resource-group <RESOURCE_GROUP> --to-cluster-id <CLUSTER_ID>

別のクラスターへのレプリケーションをカスタマイズするには、 --param を使用し、 key=value形式で変更するパラメーターを指定します。たとえば、複製されたインスタンスの場所を変更するには、次を実行します。

az iot ops clone --name <INSTANCE_NAME> --resource-group <RESOURCE_GROUP> --to-cluster-id <CLUSTER_ID> --param location=eastus

インスタンスをローカルディレクトリに複製するには、次のコマンドを実行します。

az iot ops clone --name <INSTANCE_NAME> --resource-group <RESOURCE_GROUP> --to-dir <DIRECTORY>

ヒント

現在のディレクトリにインスタンスを複製するには、 --to-dir .

インスタンスをクラスターに複製し、資産関連のサブデプロイを分割して順次適用するには、次のコマンドを実行します。

az iot ops clone --name <INSTANCE_NAME> --resource-group <RESOURCE_GROUP> --to-cluster-id <CLUSTER_ID> --mode linked

インスタンスと構成を更新する

Azure Portal
Azure CLI

Azure portal で、Azure IoT Operations インスタンスを含むリソースグループに移動するか、Azure IoT Operations を検索して選択します。
Azure IoT Operations インスタンスの名前を選択します。
インスタンスの [概要] ページで、[タグの追加] または [編集] を選択して、インスタンスのタグを変更します。

az iot ops update コマンドを使用して、Azure IoT Operations インスタンスの機能を編集します。

インスタンスのタグと説明パラメーターを更新するには、次を実行します。

az iot ops update --name <INSTANCE_NAME> --resource-group <RESOURCE_GROUP> --desc "<INSTANCE_DESCRIPTION>" --tags <TAG_NAME>=<TAG-VALUE> <TAG_NAME>=<TAG-VALUE>

インスタンスのすべてのタグを削除するには、tags パラメーターを null 値に設定します。次に例を示します。

az iot ops update --name <INSTANCE_NAME> --resource-group --tags ""

プレビューコネクタの構成を有効にするには、次のコマンドを実行します。

az iot ops update --name <INSTANCE_NAME> --resource-group <RESOURCE_GROUP> --feature connectors.settings.preview=Enabled

プレビューコネクタの構成を無効にするには、次のコマンドを実行します。

az iot ops update --name <INSTANCE_NAME> --resource-group <RESOURCE_GROUP> --feature connectors.settings.preview=Disabled

コンポーネントを管理する

各 Azure IoT Operations インスタンスには、MQTT ブローカー、OPC UA 用コネクタ、データフローなど、いくつかのコンポーネントが含まれています。これらのコンポーネントの管理について詳しくは、それぞれの記事を参照してください。たとえば、MQTT ブローカーの管理については、最初に Broker の概要に関する記事をご覧ください。

Kubernetes 配置マニフェストを使用してコンポーネントを管理する (プレビュー)

一般に、Azure IoT Operations により Azure Arc プラットフォームを使って提供されるハイブリッドクラウドエクスペリエンスでは、Azure Resource Manager (ARM) と、Azure portal、Bicep、Azure CLI などのフロントエンドツールを使って、構成を管理できます。

ただし、YAML Kubernetes の配置マニフェストを使って、Azure IoT Operations のコンポーネントを管理することもできます。つまり、kubectl などのツールを使って、Azure IoT Operations の一部のコンポーネントを管理できます。この機能はプレビュー段階であり、いくつかの制限があります。

Kubernetes 配置マニフェストの使用は、一部のコンポーネントでのみサポートされます。 MQTT ブローカーやデータフローがそのようなコンポーネントです。 OPC UA 用コネクタや Akri サービスのような他のコンポーネントでは、この機能はサポートされていません。
az iot ops rsync enableを使用して Azure IoT Operations でリソース同期を有効にしない限り、Kubernetes デプロイマニフェストを使用してリソースに加えられた変更は Azure に同期されません。リソースの同期について詳しくは、「リソースの同期」をご覧ください。
リソースの同期が有効になっている場合でも、Kubernetes 配置マニフェストを使って作成された新しいリソースは Azure に同期されません。既存のリソースへの変更のみが同期されます。

アンインストール

Azure IoT Operations CLI と Azure portal には、Azure IoT Operations をアンインストールするためのさまざまなオプションが用意されています。

重要

クラスターとリソースグループをクリーンアップする場合は、まず、次のセクションの Azure IoT Operations CLI コマンドを使用して、クラスターから Azure IoT Operations を削除することをお勧めします。その後、リソースグループを削除できます。リソースグループを直接削除すると、クラスター上の孤立したリソースが残ります。

Azure Portal
Azure CLI

Azure portal で、Azure IoT Operations インスタンスを含むリソースグループに移動するか、Azure IoT Operations を検索して選択します。
Azure IoT Operations インスタンスの名前を選択します。
インスタンスの [概要] ページ上で、[削除] を選択します。
この操作の一部として削除されるリソースと削除されないリソースの一覧を確認し、インスタンスの名前を入力して [削除] を選択して確定します。

注

Azure Portal で Azure IoT Operations インスタンスを削除しても、Azure IoT Operations のデプロイ時に作成された依存関係は削除されません。これらの依存関係を削除するには、Azure CLI の手順で説明されている az iot ops delete --name <INSTANCE_NAME> --resource-group <RESOURCE_GROUP> --include-deps コマンドを使用します。

az iot ops delete コマンドを使用して、クラスターから Azure IoT Operations デプロイ全体を削除します。 delete コマンドでは、クラスター上の Azure IoT Operations 関連リソースが評価され、削除するリソースのツリービューが示されます。このコマンドの実行時にはクラスターがオンライン状態である必要があります。

delete コマンドを使用すると、同じクラスターへの Azure IoT Operations の再デプロイが効率化されます。 create コマンドが元に戻されるため、create を再実行しなくても、delete、create、もう一度 init のように実行できます。

delete コマンドでは以下が削除されます。

Azure IoT Operations インスタンス
Arc 拡張機能
カスタムロケーション
リソース同期ルール
資産、MQTT ブローカー、データフローなど、Azure IoT Operations ソリューションで構成できるリソース。

az iot ops delete --name <INSTANCE_NAME> --resource-group <RESOURCE_GROUP>

インスタンスを削除し、Azure IoT Operations の依存関係 (init の出力) も削除するには、フラグ --include-deps を追加します。

az iot ops delete --name <INSTANCE_NAME> --resource-group <RESOURCE_GROUP> --include-deps