Azure CLI は、コマンドラインやスクリプトで Azure リソースを作成および管理するために使用します。 このクイックスタートでは、Azure CLI を使用して IoT ハブと IoT Hub Device Provisioning Service インスタンスを作成し、2 つのサービスをリンクする方法について詳しく説明します。
Azure アカウントをお持ちでない場合は、開始する前に無料アカウントを作成してください。
Von Bedeutung
このクイック スタートで作成した IoT ハブとプロビジョニング サービスの両方が、DNS エンドポイントとして公開されます。 これらのリソースに使用される名前を変更する場合は、必ず機密情報を避けてください。
[前提条件]
Azure Cloud Shell で Bash 環境を使用します。 詳細については、「Azure Cloud Shell の概要」を参照してください。
CLI 参照コマンドをローカルで実行する場合は、Azure CLI を インストール します。 Windows または macOS で実行している場合は、Docker コンテナーで Azure CLI を実行することを検討してください。 詳細については、「Docker コンテナーで Azure CLI を実行する方法」を参照してください。
ローカル インストールを使用する場合は、az login コマンドを使用して Azure CLI にサインインします。 認証プロセスを完了するには、ターミナルに表示される手順に従います。 その他のサインイン オプションについては、「 Azure CLI を使用した Azure への認証」を参照してください。
メッセージが表示されたら、最初に使用するときに Azure CLI 拡張機能をインストールします。 拡張機能の詳細については、「Azure CLI で拡張機能を使用および管理する」を参照してください。
az version を実行し、インストールされているバージョンおよび依存ライブラリを検索します。 最新バージョンにアップグレードするには、az upgrade を実行します。
リソース グループを作成する
az group create コマンドを使用して、リソース グループを作成します。 Azure リソース グループとは、Azure リソースのデプロイと管理に使用する論理コンテナーです。
次の例では、westus の場所に my-sample-resource-group という名前のリソース グループを作成します。
az group create --name my-sample-resource-group --___location westus
ヒント
この例では、米国西部の場所にリソース グループを作成します。 コマンド az account list-locations -o tableを実行すると、使用可能な場所の一覧を表示できます。
IoT ハブを作成する
az iot hub create コマンドを使用して IoT ハブを作成します。
次の例では、westus の場所に my-sample-hub という名前の IoT ハブを作成します。 IoT ハブ名は Azure でグローバルに一意である必要があるため、例の名前に一意のプレフィックスまたはサフィックスを追加するか、新しい名前を完全に選択します。 名前が IoT ハブの適切な名前付け規則に従っていることを確認します。長さは 3 ~ 50 文字で、大文字または小文字の英数字またはハイフン ('-') のみを含めることができます。
az iot hub create --name my-sample-hub --resource-group my-sample-resource-group --___location westus
Device Provisioning Service インスタンスを作成する
az iot dps create コマンドを使用して Device Provisioning Service インスタンスを作成します。
次の例では、westus の場所に my-sample-dps という名前の Device Provisioning Service インスタンスを作成します。 また、独自のインスタンスにグローバルに一意の名前を選択する必要もあります。 IoT Hub Device Provisioning Service の適切な名前付け規則に従っていることを確認します。長さは 3 ~ 64 文字で、大文字または小文字の英数字またはハイフン ('-') のみを含めることができます。
az iot dps create --name my-sample-dps --resource-group my-sample-resource-group --___location westus
ヒント
この例では、プロビジョニング サービスを米国西部の場所に作成します。 使用可能な場所の一覧を表示するには、 az provider show --namespace Microsoft.Devices --query "resourceTypes[?resourceType=='ProvisioningServices'].locations | [0]" --out table コマンドを実行するか、 Azure の [状態] ページに移動して "Device Provisioning Service" を検索します。 コマンドでは、場所は 1 単語または複数単語の形式で指定できます。たとえば、westus、West US、WEST US などです。この値で、大文字と小文字は区別されません。 複数単語形式を使用して場所を指定する場合は、値を引用符で囲みます。たとえば、 --___location "West US"。
回復性と信頼性を確保するために、Availability Zones をサポートするリージョンのいずれかにデプロイすることをお勧めします。
IoT ハブの接続文字列を取得する
IoT ハブを Device Provisioning Service にリンクするには、IoT ハブの接続文字列が必要です。 az iot hub connection-string show コマンドを使用して接続文字列を取得し、その出力を使用して、2 つのリソースをリンクするときに後で使用する変数を設定します。
次の例では、 hubConnectionString 変数をハブの iothubowner ポリシーの主キーの接続文字列の値に設定します ( --policy-name パラメーターを使用して別のポリシーを指定できます)。
my-sample-hub を、前に選択した一意の IoT ハブ名と交換します。 このコマンドでは、Azure CLI のクエリ と 出力 オプションを使用して、コマンド出力から接続文字列を抽出します。
hubConnectionString=$(az iot hub connection-string show --name my-sample-hub --key primary --query connectionString -o tsv)
echo コマンドを使用して、接続文字列を表示できます。
echo $hubConnectionString
注
これら 2 つのコマンドは、Bash で実行されているホストに対して有効です。
ローカルの Windows/CMD シェルまたは PowerShell ホストを使用している場合は、その環境に適した構文を使用するようにコマンドを変更します。
Azure Cloud Shell を使用している場合は、シェル ウィンドウの左側にある環境ドロップダウンに Bash が表示されていることを確認します。
IoT ハブとプロビジョニング サービスをリンクする
IoT ハブとプロビジョニング サービスを az iot dps linked-hub create コマンドにリンクします。
次の例では、westus の場所に my-sample-hub という名前の IoT ハブと、my-sample-dps という名前の Device Provisioning Service をリンクします。 これらの名前を、以前に選択した一意の IoT ハブと Device Provisioning Service の名前に交換してください。 このコマンドは、前の手順で hubConnectionString 変数に格納された IoT ハブの接続文字列を使用します。
az iot dps linked-hub create --dps-name my-sample-dps --resource-group my-sample-resource-group --connection-string $hubConnectionString --___location westus
コマンドが完了するまでに数分かかる場合があります。
プロビジョニング サービスを確認する
az iot dps show コマンドを使用して、プロビジョニング サービスの詳細を取得します。
次の例では、 my-sample-dps という名前のプロビジョニング サービスの詳細を取得します。 この名前を、独自の Device Provisioning Service 名に交換します。
az iot dps show --name my-sample-dps
リンクされた IoT ハブが properties.iotHubs コレクションに表示されます。
リソースをクリーンアップする
このコレクションの他のクイックスタートは、このクイックスタートに基づいています。 引き続きクイックスタートまたはチュートリアルの作業を行う場合は、このクイックスタートで作成したリソースをクリーンアップしないでください。 続行する予定がない場合は、次のコマンドを使用して、プロビジョニング サービス、IoT ハブ、またはリソース グループ、およびそのすべてのリソースを削除できます。 次のコマンドに含まれるリソースの名前を、独自のリソースの名前に置き換えます。
プロビジョニング サービスを削除するには、 az iot dps delete コマンドを 実行します。
az iot dps delete --name my-sample-dps --resource-group my-sample-resource-group
IoT ハブを削除するには、 az iot hub delete コマンドを実行します。
az iot hub delete --name my-sample-hub --resource-group my-sample-resource-group
リソース グループとそのすべてのリソースを削除するには、 az group delete コマンドを実行します。
az group delete --name my-sample-resource-group
次のステップ
このクイックスタートでは、IoT ハブと Device Provisioning Service インスタンスをデプロイし、この 2 つのリソースをリンクしました。 この設定を使用してデバイスをプロビジョニングする方法については、デバイスの作成に関するクイックスタートに進んでください。