Compartilhar via

az sql instance-pool

  • Versão Prévia
  • Referência

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

Gerenciar pools de instâncias.

Comandos

Nome Description Tipo Status
az sql instance-pool create

Criar um pool de instâncias.

 Núcleo Visualizar
az sql instance-pool delete

Excluir um pool de instâncias.

 Núcleo Visualizar
az sql instance-pool list

Listar pools de instâncias disponíveis.

 Núcleo Visualizar
az sql instance-pool show

Obtenha os detalhes de um pool de instâncias.

 Núcleo Visualizar
az sql instance-pool update

Atualizar um pool de instâncias.

 Núcleo Visualizar
az sql instance-pool wait

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

 Núcleo Visualizar

az sql instance-pool create

Editar
Versão Prévia

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

Criar 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 (inclua --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 Exigidos

--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

Local. 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

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 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 esse pool de instâncias.

Valores aceitos: BasePrice, LicenseIncluded
--maint-config-id -m

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

--no-wait

Não aguarde a conclusão da operação de execução longa.

Valor padrão: False
--tags

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

--vnet-name

O nome da rede virtual.

Parâmetros Globais
--debug

Aumente o detalhamento 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 aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

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

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az sql instance-pool delete

Editar
Versão Prévia

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

Excluir um pool de instâncias.

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

Exemplos

Excluir um pool de instância

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

Parâmetros Exigidos

--name -n

Nome do pool de instâncias.

--resource-group -g

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 aguarde a conclusão da operação de execução longa.

Valor padrão: False
--yes -y

Não solicite confirmação.

Valor padrão: False
Parâmetros Globais
--debug

Aumente o detalhamento 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 aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

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

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az sql instance-pool list

Editar
Versão Prévia

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

Listar pools de instâncias disponíveis.

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

Exemplos

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

az sql instance-pool list

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

az sql instance-pool list -g mygroup

Parâmetros Opcionais

--resource-group -g

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

Parâmetros Globais
--debug

Aumente o detalhamento 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 aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

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

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az sql instance-pool show

Editar
Versão Prévia

O grupo de comandos 'sql instance-pool' está em pré-visualização e em desenvolvimento. Níveis de referência e suporte: 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 Exigidos

--name -n

Nome do pool de instâncias.

--resource-group -g

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

Parâmetros Globais
--debug

Aumente o detalhamento 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 aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

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

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az sql instance-pool update

Editar
Versão Prévia

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

Atualizar 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 marcas atribuídas a um pool de instâncias

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

Parâmetros Exigidos

--name -n

Nome do pool de instâncias.

--resource-group -g

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 valores de chave. Exemplo: --add property.listProperty <key=value, string or JSON string>.

Valor padrão: []
--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 cadeia de caracteres em vez de tentar converter para JSON.

Valor padrão: False
--license-type

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

Valores aceitos: BasePrice, LicenseIncluded
--maint-config-id -m

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

--no-wait

Não aguarde a conclusão da operação de execução longa.

Valor padrão: False
--remove

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

Valor padrão: []
--set

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

Valor padrão: []
--tags

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

Parâmetros Globais
--debug

Aumente o detalhamento 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 aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

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

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az sql instance-pool wait

Editar
Versão Prévia

O grupo de comandos 'sql instance-pool' está em pré-visualização e em desenvolvimento. Níveis de referência e suporte: 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 Exigidos

--name -n

Nome do pool de instâncias.

--resource-group -g

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

Parâmetros Opcionais

--created

Aguarde até criar com 'provisioningState' em 'Succeeded'.

Valor padrão: 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 padrão: False
--exists

Aguarde até que o recurso exista.

Valor padrão: False
--interval

Intervalo de sondagem em segundos.

Valor padrão: 30
--timeout

Espera máxima em segundos.

Valor padrão: 3600
--updated

Aguarde até que seja atualizado com provisioningState em 'Succeeded'.

Valor padrão: False
Parâmetros Globais
--debug

Aumente o detalhamento 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 aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

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

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.