az sql instance-pool

  • Pré-visualizar
  • Referência

Este grupo de comandos está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Gerencie pools de instâncias.

Comandos

Name Description Tipo Estado
az sql instance-pool create

Crie um pool de instâncias.

 Principal Pré-visualizar
az sql instance-pool delete

Exclua um pool de instâncias.

 Principal Pré-visualizar
az sql instance-pool list

Liste os pools de instâncias disponíveis.

 Principal Pré-visualizar
az sql instance-pool show

Obtenha os detalhes de um pool de instâncias.

 Principal Pré-visualizar
az sql instance-pool update

Atualize um pool de instâncias.

 Principal Pré-visualizar
az sql instance-pool wait

Aguarde até que um pool de instâncias atinja o estado desejado.

 Principal Pré-visualizar

az sql instance-pool create

Editar
Pré-visualizar

O grupo de comandos 'sql instance-pool' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Crie um pool de instâncias.

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]

Exemplos

Exemplo para criar um pool de instâncias (incluir --no-wait no final para obter uma experiência assíncrona)

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

Exemplo para criar um pool de instâncias com nome de sub-rede e 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

Parâmetros Obrigatórios

--capacity -c

Capacidade do pool de instâncias em vcores.

--edition --tier -e

O componente de edição do sku. Valor permitido: GeneralPurpose.

--family -f

O componente de geração de computação do sku. Valor permitido: Gen5.

--location -l

Localização. Valores de: az account list-locations. Você pode configurar o local padrão usando az configure --defaults location=<location>.

--name -n

Nome do Pool de Instâncias.

--resource-group -g

o nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--subnet

Nome ou ID da sub-rede que permite o acesso a um Pool de Instâncias. Se o nome da sub-rede for fornecido, --vnet-name deverá ser fornecido.

Parâmetros Opcionais

--license-type

O tipo de licença a ser aplicado para este pool de instâncias.

valores aceites: BasePrice, LicenseIncluded
--maint-config-id -m

Atribua a configuração de manutenção a esta instância gerenciada.

--no-wait

Não espere que a operação de longa duração termine.

valor predefinido: False
--tags

Tags separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar tags existentes.

--vnet-name

O nome da rede virtual.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az sql instance-pool delete

Editar
Pré-visualizar

O grupo de comandos 'sql instance-pool' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Exclua um pool de instâncias.

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

Exemplos

Excluir um pool de instâncias

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

Parâmetros Obrigatórios

--name -n

Nome do Pool de Instâncias.

--resource-group -g

o nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

--no-wait

Não espere que a operação de longa duração termine.

valor predefinido: False
--yes -y

Não solicite confirmação.

valor predefinido: False
Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az sql instance-pool list

Editar
Pré-visualizar

O grupo de comandos 'sql instance-pool' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Liste os pools de instâncias disponíveis.

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

Exemplos

Liste todos os pools de instâncias na assinatura atual.

az sql instance-pool list

Liste todos os pools de instâncias em um grupo de recursos.

az sql instance-pool list -g mygroup

Parâmetros Opcionais

--resource-group -g

o nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az sql instance-pool show

Editar
Pré-visualizar

O grupo de comandos 'sql instance-pool' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Obtenha os detalhes de um pool de instâncias.

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

Exemplos

Obter os detalhes de um pool de instâncias

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

Parâmetros Obrigatórios

--name -n

Nome do Pool de Instâncias.

--resource-group -g

o nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az sql instance-pool update

Editar
Pré-visualizar

O grupo de comandos 'sql instance-pool' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Atualize um pool de instâncias.

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]

Exemplos

Atualizar um pool de instâncias com novas tags (verifique se elas estão separadas por espaço se houver várias tags)

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}

Limpar as tags atribuídas a um pool de instâncias

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

Parâmetros Obrigatórios

--name -n

Nome do Pool de Instâncias.

--resource-group -g

o nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

--add

Adicione um objeto a uma lista de objetos especificando um caminho e pares de valor de chave. Exemplo: --add property.listProperty <key=value, string or JSON string>.

valor predefinido: []
--capacity -c

Capacidade do pool de instâncias em vcores.

--edition --tier -e

O componente de edição do sku. Os valores permitidos incluem: GeneralPurpose, BusinessCritical.

--family -f

O componente de geração de computação do sku. Os valores permitidos incluem: Gen4, Gen5.

--force-string

Ao usar 'set' ou 'add', preserve literais de string em vez de tentar converter para JSON.

valor predefinido: False
--license-type

O tipo de licença a ser aplicado para este pool de instâncias.

valores aceites: BasePrice, LicenseIncluded
--maint-config-id -m

Atribua a configuração de manutenção a esta instância gerenciada.

--no-wait

Não espere que a operação de longa duração termine.

valor predefinido: False
--remove

Remova uma propriedade ou um elemento de uma lista. Exemplo: --remove property.list <indexToRemove> OR --remove propertyToRemove.

valor predefinido: []
--set

Atualize um objeto especificando um caminho de propriedade e um valor a ser definido. Exemplo: --set property1.property2=<value>.

valor predefinido: []
--tags

Tags separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar tags existentes.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az sql instance-pool wait

Editar
Pré-visualizar

O grupo de comandos 'sql instance-pool' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Aguarde até que um pool de instâncias atinja o estado desejado.

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

Exemplos

Aguarde até que um pool de instâncias seja criado.

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

Parâmetros Obrigatórios

--name -n

Nome do Pool de Instâncias.

--resource-group -g

o nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

--created

Aguarde até ser criado com 'provisioningState' em 'Succeeded'.

valor predefinido: False
--custom

Aguarde até que a condição satisfaça uma consulta JMESPath personalizada. Por exemplo, provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Aguarde até ser excluído.

valor predefinido: False
--exists

Aguarde até que o recurso exista.

valor predefinido: False
--interval

Intervalo de sondagem em segundos.

valor predefinido: 30
--timeout

Espera máxima em segundos.

valor predefinido: 3600
--updated

Aguarde até ser atualizado com provisioningState em 'Succeeded'.

valor predefinido: False
Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.