az sql instance-pool
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 | Status |
|---|---|---|---|
| az sql instance-pool create |
Crie um pool de instâncias. |
Core | Preview |
| az sql instance-pool delete |
Exclua um pool de instâncias. |
Core | Preview |
| az sql instance-pool list |
Liste os pools de instâncias disponíveis. |
Core | Preview |
| az sql instance-pool show |
Obtenha os detalhes de um pool de instâncias. |
Core | Preview |
| az sql instance-pool update |
Atualize um pool de instâncias. |
Core | Preview |
| az sql instance-pool wait |
Aguarde até que um pool de instâncias atinja o estado desejado. |
Core | Preview |
az sql instance-pool create
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 --tier
--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
Capacidade do pool de instâncias em vcores.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Performance Level (components) Arguments |
O componente de edição do sku. Valor permitido: GeneralPurpose.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Performance Level (components) Arguments |
O componente de geração de computação do sku. Valor permitido: Gen5.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Performance Level (components) Arguments |
Location. Valores de: az account list-locations. Você pode configurar o local padrão usando az configure --defaults location=<location>.
Nome do Pool de Instâncias.
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.
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
Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.
O tipo de licença a ser aplicado para este pool de instâncias.
| Propriedade | Valor |
|---|---|
| Valores aceites: | BasePrice, LicenseIncluded |
Atribua a configuração de manutenção a esta instância gerenciada.
Não espere que a operação de longa duração termine.
| Propriedade | Valor |
|---|---|
| Default value: | False |
Tags separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar tags existentes.
O nome da rede virtual.
Parâmetros de Globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Default value: | False |
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Default value: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Default value: | json |
| Valores aceites: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Default value: | False |
az sql instance-pool delete
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
Nome do Pool de Instâncias.
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.
Parâmetros Opcionais
Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.
Não espere que a operação de longa duração termine.
| Propriedade | Valor |
|---|---|
| Default value: | False |
Não solicite confirmação.
| Propriedade | Valor |
|---|---|
| Default value: | False |
Parâmetros de Globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Default value: | False |
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Default value: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Default value: | json |
| Valores aceites: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Default value: | False |
az sql instance-pool list
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
Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.
Parâmetros de Globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Default value: | False |
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Default value: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Default value: | json |
| Valores aceites: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Default value: | False |
az sql instance-pool show
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
Nome do Pool de Instâncias.
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.
Parâmetros de Globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Default value: | False |
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Default value: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Default value: | json |
| Valores aceites: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Default value: | False |
az sql instance-pool update
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 --tier]
[--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
Nome do Pool de Instâncias.
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.
Parâmetros Opcionais
Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.
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>.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Generic Update Arguments |
| Default value: | [] |
Capacidade do pool de instâncias em vcores.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Performance Level (components) Arguments |
O componente de edição do sku. Os valores permitidos incluem: GeneralPurpose, BusinessCritical.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Performance Level (components) Arguments |
O componente de geração de computação do sku. Os valores permitidos incluem: Gen4, Gen5.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Performance Level (components) Arguments |
Ao usar 'set' ou 'add', preserve literais de string em vez de tentar converter para JSON.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Generic Update Arguments |
| Default value: | False |
O tipo de licença a ser aplicado para este pool de instâncias.
| Propriedade | Valor |
|---|---|
| Valores aceites: | BasePrice, LicenseIncluded |
Atribua a configuração de manutenção a esta instância gerenciada.
Não espere que a operação de longa duração termine.
| Propriedade | Valor |
|---|---|
| Default value: | False |
Remova uma propriedade ou um elemento de uma lista. Exemplo: --remove property.list <indexToRemove> OU --remove propertyToRemove.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Generic Update Arguments |
| Default value: | [] |
Atualize um objeto especificando um caminho de propriedade e um valor a ser definido. Exemplo: --set property1.property2=<value>.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Generic Update Arguments |
| Default value: | [] |
Tags separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar tags existentes.
Parâmetros de Globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Default value: | False |
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Default value: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Default value: | json |
| Valores aceites: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Default value: | False |
az sql instance-pool wait
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
Nome do Pool de Instâncias.
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.
Parâmetros Opcionais
Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.
Aguarde até ser criado com 'provisioningState' em 'Succeeded'.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Wait Condition Arguments |
| Default value: | False |
Aguarde até que a condição satisfaça uma consulta JMESPath personalizada. Por exemplo, provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Wait Condition Arguments |
Aguarde até ser excluído.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Wait Condition Arguments |
| Default value: | False |
Aguarde até que o recurso exista.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Wait Condition Arguments |
| Default value: | False |
Intervalo de sondagem em segundos.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Wait Condition Arguments |
| Default value: | 30 |
Espera máxima em segundos.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Wait Condition Arguments |
| Default value: | 3600 |
Aguarde até ser atualizado com provisioningState em 'Succeeded'.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Wait Condition Arguments |
| Default value: | False |
Parâmetros de Globais
Aumente a verbosidade do log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Default value: | False |
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Default value: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Default value: | json |
| Valores aceites: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Default value: | False |