Partager via

az sql instance-pool

  • Préversion
  • Référence

Ce groupe de commandes est en préversion et en cours de développement. Référence et niveaux de support : https://aka.ms/CLI_refstatus

Gérer les pools d’instances.

Commandes

Nom Description Type Statut
az sql instance-pool create

Créez un pool d’instances.

 Core Aperçu
az sql instance-pool delete

Supprimez un pool d’instances.

 Core Aperçu
az sql instance-pool list

Répertorier les pools d’instances disponibles.

 Core Aperçu
az sql instance-pool show

Obtenez les détails d’un pool d’instances.

 Core Aperçu
az sql instance-pool update

Mettez à jour un pool d’instances.

 Core Aperçu
az sql instance-pool wait

Attendez qu’un pool d’instances atteigne un état souhaité.

 Core Aperçu

az sql instance-pool create

Modifier
Préversion

Le groupe de commandes « sql instance-pool » est en préversion et en cours de développement. Référence et niveaux de support : https://aka.ms/CLI_refstatus

Créez un pool d’instances.

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]

Exemples

Exemple de création d’un pool d’instances (inclure --no-wait à la fin pour obtenir une expérience asynchrone)

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

Exemple de création d’un pool d’instances avec un nom de sous-réseau et un nom de réseau virtuel

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

Paramètres obligatoires

--capacity -c

Capacité du pool d’instances dans les vcores.

--edition --tier -e

Composant d’édition de la référence SKU. Valeur autorisée : GeneralPurpose.

--family -f

Composant de génération de calcul de la référence SKU. Valeur autorisée : Gen5.

--location -l

Emplacement. Valeurs provenant de : az account list-locations. Vous pouvez configurer le lieu par défaut en utilisant az configure --defaults location=<location>.

--name -n

Nom du pool d’instances.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

--subnet

Nom ou ID du sous-réseau qui autorise l’accès à un pool d’instances. Si le nom du sous-réseau est fourni, --vnet-name doit être fourni.

Paramètres facultatifs

--license-type

Type de licence à appliquer pour ce pool d’instances.

valeurs acceptées: BasePrice, LicenseIncluded
--maint-config-id -m

Affectez la configuration de maintenance à cette instance managée.

--no-wait

Ne pas attendre la fin de l’opération de longue durée.

valeur par défaut: False
--tags

Balises séparées par l’espace : key[=value] [key[=value] ...]. Utilisez « » pour effacer les balises existantes.

--vnet-name

Nom du réseau virtuel.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az sql instance-pool delete

Modifier
Préversion

Le groupe de commandes « sql instance-pool » est en préversion et en cours de développement. Référence et niveaux de support : https://aka.ms/CLI_refstatus

Supprimez un pool d’instances.

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

Exemples

Supprimer un pool d’instances

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

Paramètres obligatoires

--name -n

Nom du pool d’instances.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

Paramètres facultatifs

--no-wait

Ne pas attendre la fin de l’opération de longue durée.

valeur par défaut: False
--yes -y

Ne pas demander de confirmation.

valeur par défaut: False
Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az sql instance-pool list

Modifier
Préversion

Le groupe de commandes « sql instance-pool » est en préversion et en cours de développement. Référence et niveaux de support : https://aka.ms/CLI_refstatus

Répertorier les pools d’instances disponibles.

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

Exemples

Répertoriez tous les pools d’instances dans l’abonnement actuel.

az sql instance-pool list

Répertoriez tous les pools d’instances dans un groupe de ressources.

az sql instance-pool list -g mygroup

Paramètres facultatifs

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az sql instance-pool show

Modifier
Préversion

Le groupe de commandes « sql instance-pool » est en préversion et en cours de développement. Référence et niveaux de support : https://aka.ms/CLI_refstatus

Obtenez les détails d’un pool d’instances.

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

Exemples

Obtenir les détails d’un pool d’instances

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

Paramètres obligatoires

--name -n

Nom du pool d’instances.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az sql instance-pool update

Modifier
Préversion

Le groupe de commandes « sql instance-pool » est en préversion et en cours de développement. Référence et niveaux de support : https://aka.ms/CLI_refstatus

Mettez à jour un pool d’instances.

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]

Exemples

Mettez à jour un pool d’instances avec de nouvelles balises (vérifiez qu’elles sont séparées s’il existe plusieurs balises)

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}

Effacer les balises affectées à un pool d’instances

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

Paramètres obligatoires

--name -n

Nom du pool d’instances.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

Paramètres facultatifs

--add

Ajoutez un objet à une liste d’objets en spécifiant un chemin d’accès et des paires clé-valeur. Exemple : --add property.listProperty <key=value, string or JSON string>.

valeur par défaut: []
--capacity -c

Capacité du pool d’instances dans les vcores.

--edition --tier -e

Composant d’édition de la référence SKU. Les valeurs autorisées sont les suivantes : GeneralPurpose, BusinessCritical.

--family -f

Composant de génération de calcul de la référence SKU. Les valeurs autorisées sont les suivantes : Gen4, Gen5.

--force-string

Lorsque vous utilisez « set » ou « add », conservez les littéraux de chaîne au lieu de tenter de convertir en JSON.

valeur par défaut: False
--license-type

Type de licence à appliquer pour ce pool d’instances.

valeurs acceptées: BasePrice, LicenseIncluded
--maint-config-id -m

Affectez la configuration de maintenance à cette instance managée.

--no-wait

Ne pas attendre la fin de l’opération de longue durée.

valeur par défaut: False
--remove

Supprimez une propriété ou un élément d’une liste. Exemple : --remove property.list <indexToRemove> OR --remove propertyToRemove.

valeur par défaut: []
--set

Mettez à jour un objet en spécifiant un chemin d’accès et une valeur de propriété à définir. Exemple : --set property1.property2=<value>.

valeur par défaut: []
--tags

Balises séparées par l’espace : key[=value] [key[=value] ...]. Utilisez « » pour effacer les balises existantes.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az sql instance-pool wait

Modifier
Préversion

Le groupe de commandes « sql instance-pool » est en préversion et en cours de développement. Référence et niveaux de support : https://aka.ms/CLI_refstatus

Attendez qu’un pool d’instances atteigne un état souhaité.

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

Exemples

Attendez la création d’un pool d’instances.

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

Paramètres obligatoires

--name -n

Nom du pool d’instances.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

Paramètres facultatifs

--created

Attendez la création avec « provisioningState » sur « Succeeded ».

valeur par défaut: False
--custom

Attendez que la condition réponde à une requête JMESPath personnalisée. Par exemple, provisioningState !='InProgress', instanceView.statuses[ ?code=='PowerState/running'].

--deleted

Attendez la suppression.

valeur par défaut: False
--exists

Attendez que la ressource existe.

valeur par défaut: False
--interval

Intervalle d’interrogation en secondes.

valeur par défaut: 30
--timeout

Délai maximal d’attente en secondes.

valeur par défaut: 3600
--updated

Attendez la mise à jour avec provisioningState sur « Réussi ».

valeur par défaut: False
Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.