Azure CLI を使用した Azure クラウド管理

[アーティクル]
06/26/2023

異なるリージョンにわたって作業したり、Azure Stack を使用したりする場合、複数のクラウドの使用が必要になることがあります。 Microsoft はお客様が使用可能な、リージョンの法規に従ったクラウドを提供します。この記事では、クラウドに関する情報の取得、現行クラウドの変更、新規クラウドの登録または登録解除の方法について説明します。

使用可能なクラウドを一覧表示する

使用可能なクラウドを az cloud list コマンドで一覧表示することができます。このコマンドにより、現在アクティブなクラウド、その現在のプロファイル、およびリージョンサフィックスとホスト名に関する情報が得られます。

アクティブなクラウドと、すべての使用可能クラウドの一覧を取得するには、次のように入力します。

az cloud list --output table

IsActive    Name               Profile
----------  -----------------  ---------
True        AzureCloud         latest
            AzureChinaCloud    latest
            AzureUSGovernment  latest
            AzureGermanCloud   latest

現在アクティブなクラウドには IsActive 列に True と表示されます。一度にアクティブにできるクラウドは 1 つのみです。 Azure サービスに使用するエンドポイントなど、クラウドに関するより詳細な情報を得るには、cloud show コマンドを使用します。

az cloud show --name AzureChinaCloud --output json

{
  "endpoints": {
    "activeDirectory": "https://login.chinacloudapi.cn",
    "activeDirectoryDataLakeResourceId": null,
    "activeDirectoryGraphResourceId": "https://graph.chinacloudapi.cn/",
    "activeDirectoryResourceId": "https://management.core.chinacloudapi.cn/",
    "batchResourceId": "https://batch.chinacloudapi.cn/",
    "gallery": "https://gallery.chinacloudapi.cn/",
    "management": "https://management.core.chinacloudapi.cn/",
    "resourceManager": "https://management.chinacloudapi.cn",
    "sqlManagement": "https://management.core.chinacloudapi.cn:8443/",
    "vmImageAliasDoc": "https://raw.githubusercontent.com/Azure/azure-rest-api-specs/master/arm-compute/quickstart-templates/aliases.json"
  },
  "isActive": false,
  "name": "AzureChinaCloud",
  "profile": "latest",
  "suffixes": {
    "azureDatalakeAnalyticsCatalogAndJobEndpoint": null,
    "azureDatalakeStoreFileSystemEndpoint": null,
    "keyvaultDns": ".vault.azure.cn",
    "sqlServerHostname": ".database.chinacloudapi.cn",
    "storageEndpoint": "core.chinacloudapi.cn"
  }
}

アクティブなクラウドを切り替える

構成ファイルを使用して既定のクラウドを設定する方法については、「CLI 構成値と環境変数」を参照してください。アクティブなクラウドを切り替えるには、az cloud set コマンドを実行します。このコマンドは、1 つの必須の引数として、クラウドの名前を受け取ります。

az cloud set --name AzureChinaCloud

重要

アクティブ化されたクラウドの認証が期限切れになった場合は、他の CLI タスクを実行する前に、再認証を行う必要があります。新しいクラウドに初めて切り替える場合は、アクティブなサブスクリプションの設定も行う必要があります。認証の手順については、「Azure CLI を使用してサインインする」を参照してください。サブスクリプションの管理については、Azure CLI での Azure サブスクリプションの管理に関するページをご覧ください

新しいクラウドを登録する

Azure Stack 用の独自のエンドポイントがある場合は、新しいクラウドを登録します。 az cloud register コマンドを実行すると、クラウドが作成されます。このコマンドには、名前と一連のサービスエンドポイントが必要です。 Azure Stack で使用するクラウドの登録方法については、Azure Stack での Azure CLI による API バージョンのプロファイルの使用に関するページをご覧ください。

中国、米国政府、またはドイツのリージョンについては、情報を登録する必要はありません。これらのクラウドは Microsoft が管理しているため、既定値で使用可能です。使用可能なエンドポイント設定に関する詳細については、az cloud register のドキュメントを参照してください。

クラウドを登録しても、自動的にそのクラウドに切り替わるわけではありません。 az cloud set コマンドを使用して、新規作成したクラウドを選択してください。

既存のクラウドを更新する

権限がある場合は、既存のクラウドを更新することもできます。クラウドを更新すると、別の Azure サービスプロファイルに切り替わるか、接続エンドポイントが変更されます。クラウドの更新は az cloud update コマンドを使用して実行します。このコマンドでは az cloud register と同じ引数を使用します。

クラウドを登録解除する

作成したクラウドが不要になった場合は、次のように、az cloud unregister コマンドで登録解除することができます。

az cloud unregister --name MyCloud