Azure-Cloudverwaltung mit der Azure CLI

Wenn Sie in verschiedenen Regionen arbeiten oder Azure Stack verwenden, müssen Sie möglicherweise mehrere Clouds verwenden. Microsoft stellt Clouds bereit, die den regionalen Gesetzen entsprechen, die für Ihre Verwendung zur Verfügung stehen. In diesem Artikel erfahren Sie, wie Sie Informationen zu Clouds abrufen, wie Sie die aktuelle Cloud ändern und wie Sie neue Clouds registrieren bzw. ihre Registrierung aufheben.

Auflisten verfügbarer Cloud-Dienste

Die verfügbaren Clouds können mit dem Befehl az cloud list aufgelistet werden. Dieser Befehl zeigt die derzeit aktive Cloud, das aktuelle Profil und Informationen zu regionalen Suffixen und Hostnamen an.

Gehen Sie wie folgt vor, um die aktive Cloud und eine Liste mit allen verfügbaren Clouds abzurufen:

az cloud list --output table

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

Für die derzeit aktive Cloud ist in der Spalte True der Wert IsActive angegeben. Es kann immer nur eine Cloud aktiv sein. Ausführlichere Informationen zu einer Cloud (einschließlich der Endpunkte, die sie für Azure-Dienste verwendet) erhalten Sie mit dem Befehl 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"
  }
}

Wechseln der aktiven Cloud

Informationen zum Festlegen der Standardcloud mithilfe einer Konfigurationsdatei finden Sie unter CLI-Konfigurationswerte und Umgebungsvariablen. Führen Sie zum Wechseln der Cloud den Befehl az cloud set aus. Dieser Befehl erfordert ein Argument: den Namen der Cloud.

az cloud set --name AzureChinaCloud

Registrieren einer neuen Cloud

Registrieren Sie eine neue Cloud, wenn Sie über eigene Endpunkte für Azure Stack verfügen. Das Erstellen einer Cloud erfolgt mit dem Befehl "az cloud register" . Dieser Befehl erfordert einen Namen und eine Reihe von Dienstendpunkten. Informationen zum Registrieren einer Cloud für die Verwendung mit Azure Stack finden Sie unter Verwenden von API-Versionsprofilen mit der Azure CLI in Azure Stack.

Für China, US Government oder deutsche Regionen müssen Sie keine Informationen registrieren. Microsoft verwaltet diese Clouds, und sie sind standardmäßig verfügbar. Weitere Informationen zu den verfügbaren Endpunkteinstellungen finden Sie in der Dokumentation für az cloud register.

Durch Registrieren einer Cloud wird nicht automatisch zu dieser Cloud gewechselt. Wählen Sie die neu erstellte Cloud mithilfe des Befehls az cloud set aus.

Aktualisieren einer vorhandenen Cloud

Sie können auch eine vorhandene Cloud aktualisieren, sofern Sie über die erforderlichen Berechtigungen verfügen. Bei der Aktualisierung einer Cloud wird zu einem anderen Azure-Dienstprofil gewechselt, oder die Verbindungsendpunkte werden geändert. Aktualisieren Sie eine Cloud mit dem Befehl az cloud update. Dieser akzeptiert die gleichen Argumente wie az cloud register.

Aufheben der Registrierung einer Cloud

Wenn Sie eine erstellte Cloud nicht mehr benötigen, kann ihre Registrierung mit dem Befehl az cloud unregister aufgehoben werden:

az cloud unregister --name MyCloud