Share via

az sql instance-pool

  • Vorschau
  • Referenz

Diese Befehlsgruppe befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Verwalten von Instanzpools.

Befehle

Name Beschreibung Typ Status
az sql instance-pool create

Erstellen eines Instanzenpools.

 Core Vorschau
az sql instance-pool delete

Löschen eines Instanzenpools.

 Core Vorschau
az sql instance-pool list

Auflisten der verfügbaren Instanzpools.

 Core Vorschau
az sql instance-pool show

Rufen Sie die Details für einen Instanzpool ab.

 Core Vorschau
az sql instance-pool update

Aktualisieren eines Instanzpools.

 Core Vorschau
az sql instance-pool wait

Warten Sie, bis ein Instanzpool einen gewünschten Zustand erreicht.

 Core Vorschau

az sql instance-pool create

Bearbeiten
Vorschau

Die Befehlsgruppe "sql instance-pool" befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Erstellen eines Instanzenpools.

az sql instance-pool create --capacity
                            --edition
                            --family
                            --location
                            --name
                            --resource-group
                            --subnet
                            [--license-type {BasePrice, LicenseIncluded}]
                            [--maint-config-id]
                            [--no-wait]
                            [--tags]
                            [--vnet-name]

Beispiele

Beispiel zum Erstellen eines Instanzpools (schließen Sie "--no-wait" am Ende ein, um eine asynchrone Benutzeroberfläche zu erhalten)

az sql instance-pool create -g resource_group_name -n instance_pool_name -l location --subnet /subscriptions/{SubID}/resourceGroups/{ResourceGroup}/providers/Microsoft.Network/virtualNetworks/{VNETName}/subnets/{SubnetName} --license-type LicenseIncluded --capacity 8 -e GeneralPurpose -f Gen5 -m SQL_{Region}_{MaintenanceConfigName} --no-wait

Beispiel zum Erstellen eines Instanzpools mit Subnetzname und vnet-Name

az sql instance-pool create --license-type LicenseIncluded -l northcentralus -n myinstancepool -c 8 -e GeneralPurpose -f Gen5 -g billingPools --subnet mysubnetname --vnet-name myvnetname

Erforderliche Parameter

--capacity -c

Kapazität des Instanzpools in vcores.

--edition --tier -e

Die Edition-Komponente der SKU. Zulässiger Wert: GeneralPurpose.

--family -f

Die Komponente für die Berechnungsgenerierung der SKU. Zulässiger Wert: Gen5.

--location -l

Standort. Werte aus: az account list-locations. Sie können den standardmäßig verwendeten Standort mit az configure --defaults location=<location> konfigurieren.

--name -n

Instanzpoolname.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

--subnet

Name oder ID des Subnetzes, das den Zugriff auf einen Instanzpool ermöglicht. Wenn subnetzname angegeben wird, muss --vnet-name angegeben werden.

Optionale Parameter

--license-type

Der Lizenztyp, der für diesen Instanzpool angewendet werden soll.

Zulässige Werte: BasePrice, LicenseIncluded
--maint-config-id -m

Weisen Sie dieser verwalteten Instanz Standard Zuteilungskonfiguration zu.

--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

Standardwert: False
--tags

Durch Leerzeichen getrennte Tags: key[=value] [key[=value] ...]. Verwenden Sie "", um vorhandene Tags zu löschen.

--vnet-name

Der Name des virtuellen Netzwerks.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az sql instance-pool delete

Bearbeiten
Vorschau

Die Befehlsgruppe "sql instance-pool" befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Löschen eines Instanzenpools.

az sql instance-pool delete --name
                            --resource-group
                            [--no-wait]
                            [--yes]

Beispiele

Löschen eines Instanzpools

az sql instance-pool delete -g mygroup -n myinstancepool --yes

Erforderliche Parameter

--name -n

Instanzpoolname.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

Optionale Parameter

--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

Standardwert: False
--yes -y

Nicht zur Bestätigung auffordern

Standardwert: False
Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az sql instance-pool list

Bearbeiten
Vorschau

Die Befehlsgruppe "sql instance-pool" befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Auflisten der verfügbaren Instanzpools.

az sql instance-pool list [--resource-group]

Beispiele

Listet alle Instanzpools im aktuellen Abonnement auf.

az sql instance-pool list

Listet alle Instanzenpools in einer Ressourcengruppe auf.

az sql instance-pool list -g mygroup

Optionale Parameter

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az sql instance-pool show

Bearbeiten
Vorschau

Die Befehlsgruppe "sql instance-pool" befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Rufen Sie die Details für einen Instanzpool ab.

az sql instance-pool show --name
                          --resource-group

Beispiele

Abrufen der Details für einen Instanzpool

az sql instance-pool show -g mygroup -n myinstancepool

Erforderliche Parameter

--name -n

Instanzpoolname.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az sql instance-pool update

Bearbeiten
Vorschau

Die Befehlsgruppe "sql instance-pool" befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Aktualisieren eines Instanzpools.

az sql instance-pool update --name
                            --resource-group
                            [--add]
                            [--capacity]
                            [--edition]
                            [--family]
                            [--force-string]
                            [--license-type {BasePrice, LicenseIncluded}]
                            [--maint-config-id]
                            [--no-wait]
                            [--remove]
                            [--set]
                            [--tags]

Beispiele

Aktualisieren eines Instanzpools mit neuen Tags (stellen Sie sicher, dass sie leer sind, wenn mehrere Tags vorhanden sind)

az sql instance-pool update -n myinstancepool -g mygroup --tags mykey1=myvalue1 mykey2=myvalue2 --license-type LicenseIncluded --capacity 8 -e GeneralPurpose -f Gen5 -m SQL_{Region}_{MaintenanceConfigName}

Löschen der tags, die einem Instanzpool zugewiesen sind

az sql instance-pool update -n myinstancepool -g mygroup --tags ""

Erforderliche Parameter

--name -n

Instanzpoolname.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

Optionale Parameter

--add

Fügen Sie einer Liste von Objekten ein Objekt hinzu, indem Sie ein Pfad- und Schlüsselwertpaar angeben. Beispiel: --add property.listProperty <key=value, string or JSON string>.

Standardwert: []
--capacity -c

Kapazität des Instanzpools in vcores.

--edition --tier -e

Die Edition-Komponente der SKU. Zulässige Werte sind: GeneralPurpose, BusinessCritical.

--family -f

Die Komponente für die Berechnungsgenerierung der SKU. Zulässige Werte sind: Gen4, Gen5.

--force-string

Wenn Sie "set" oder "add" verwenden, behalten Sie Zeichenfolgenliterale bei, anstatt zu versuchen, in JSON zu konvertieren.

Standardwert: False
--license-type

Der Lizenztyp, der für diesen Instanzpool angewendet werden soll.

Zulässige Werte: BasePrice, LicenseIncluded
--maint-config-id -m

Weisen Sie dieser verwalteten Instanz Standard Zuteilungskonfiguration zu.

--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

Standardwert: False
--remove

Entfernen sie eine Eigenschaft oder ein Element aus einer Liste. Beispiel: --remove property.list <indexToRemove> ODER --remove propertyToRemove.

Standardwert: []
--set

Aktualisieren Sie ein Objekt, indem Sie einen festzulegenden Eigenschaftspfad und -wert angeben. Beispiel: --set property1.property2=<value>.

Standardwert: []
--tags

Durch Leerzeichen getrennte Tags: key[=value] [key[=value] ...]. Verwenden Sie "", um vorhandene Tags zu löschen.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az sql instance-pool wait

Bearbeiten
Vorschau

Die Befehlsgruppe "sql instance-pool" befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Warten Sie, bis ein Instanzpool einen gewünschten Zustand erreicht.

az sql instance-pool wait --name
                          --resource-group
                          [--created]
                          [--custom]
                          [--deleted]
                          [--exists]
                          [--interval]
                          [--timeout]
                          [--updated]

Beispiele

Warten Sie, bis ein Instanzpool erstellt wird.

az sql instance-pool wait -n myinstancepool -g mygroup --created

Erforderliche Parameter

--name -n

Instanzpoolname.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

Optionale Parameter

--created

Warten Sie, bis sie mit 'provisioningState' unter 'Succeeded' erstellt wurde.

Standardwert: False
--custom

Warten Sie, bis die Bedingung eine benutzerdefinierte JMESPath-Abfrage erfüllt. Beispiel: provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Warten Sie, bis sie gelöscht wurde.

Standardwert: False
--exists

Warten Sie, bis die Ressource vorhanden ist.

Standardwert: False
--interval

Abrufintervall in Sekunden.

Standardwert: 30
--timeout

Maximale Wartezeit in Sekunden.

Standardwert: 3600
--updated

Warten Sie, bis sie mit provisioningState unter 'Succeeded' aktualisiert wurde.

Standardwert: False
Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.