Compartilhar via

az postgres flexible-server replica

  • Referência

Gerencie réplicas de leitura.

Comandos

Nome Description Tipo Status
az postgres flexible-server replica create

Criar uma réplica de leitura para um servidor.

 Núcleo GA
az postgres flexible-server replica list

Listar todas as réplicas de leitura para um determinado servidor.

 Núcleo GA
az postgres flexible-server replica promote

Pare a replicação de uma réplica de leitura e promova-a para um servidor independente ou como um servidor primário.

 Núcleo GA
az postgres flexible-server replica stop-replication

Parar a replicação em uma réplica de leitura e torna-lá um servidor de leitura/gravação.

 Núcleo Preterido

az postgres flexible-server replica create

Criar uma réplica de leitura para um servidor.

az postgres flexible-server replica create --replica-name
                                           --resource-group
                                           --source-server
                                           [--address-prefixes]
                                           [--identity]
                                           [--key]
                                           [--location]
                                           [--no-wait]
                                           [--performance-tier]
                                           [--private-dns-zone]
                                           [--sku-name]
                                           [--storage-size]
                                           [--subnet]
                                           [--subnet-prefixes]
                                           [--tags]
                                           [--tier]
                                           [--vnet]
                                           [--yes]
                                           [--zone]

Exemplos

Crie uma réplica de leitura 'testreplicaserver' para 'testserver' com acesso público ou privado na zona e no local especificados, se disponível.

az postgres flexible-server replica create --replica-name testreplicaserver -g testGroup --source-server testserver --zone 3 --location testLocation

Crie uma réplica de leitura 'testreplicaserver' com nova sub-rede para 'testserver' com acesso privado.

az postgres flexible-server replica create --replica-name testreplicaserver -g testGroup \
  --source-server testserver --zone 3 --location testLocation \
  --vnet newVnet --subnet newSubnet \
  --address-prefixes 172.0.0.0/16 --subnet-prefixes 172.0.0.0/24 \
  --private-dns-zone testDNS.postgres.database.azure.com \
  --tags "key=value"

Crie uma réplica de leitura 'testreplicaserver' para 'testserver' com acesso público ou privado no local especificado, se disponível. Como a zona não é passada, ela selecionará automaticamente a zona no local da réplica que é diferente do servidor de origem, se disponível, caso contrário, selecionará a zona igual ao servidor de origem no local da réplica, se disponível, caso contrário, definirá a zona como Nenhuma, ou seja, sem preferência

az postgres flexible-server replica create --replica-name testreplicaserver -g testGroup --source-server testserver --location testLocation

Crie uma réplica de leitura 'testreplicaserver' para 'testserver' com --storage-size e --sku personalizados.

az postgres flexible-server replica create --replica-name testreplicaserver -g testGroup --source-server testserver --sku-name Standard_D4ds_v5 --storage-size 256

Crie uma réplica de leitura 'testreplicaserver' para 'testserver', em que 'testreplicaserver' está em um grupo de recursos diferente 'newTestGroup'. Aqui, --resource-group é para o grupo de recursos da réplica de leitura e --source-server deve ser passado como ID do recurso.

az postgres flexible-server replica create --replica-name testreplicaserver -g newTestGroup         --source-server /subscriptions/{sourceSubscriptionId}/resourceGroups/{sourceResourceGroup}/providers/Microsoft.DBforPostgreSQL/flexibleServers/{sourceServerName} --location testLocation

Parâmetros Exigidos

--replica-name

O nome do servidor para o qual restaurar.

--resource-group -g

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

--source-server

O nome ou a ID do recurso do servidor de origem do qual restaurar.

Parâmetros Opcionais

--address-prefixes

O prefixo de endereço IP a ser usado ao criar uma nova rede virtual no formato CIDR. O valor padrão é 10.0.0.0/16.

--identity

O nome ou a ID do recurso da identidade atribuída pelo usuário para criptografia de dados.

--key

A ID do recurso da chave de chave primária para criptografia de dados.

--location -l

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

--no-wait

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

Valor padrão: False
--performance-tier

Camada de desempenho do servidor.

--private-dns-zone

Esse parâmetro só se aplica a um servidor com acesso privado. O nome ou a ID da zona DNS privada nova ou existente. Você pode usar a zona DNS privada do mesmo grupo de recursos, grupo de recursos diferente ou assinatura diferente. Se você quiser usar uma zona de um grupo de recursos ou assinatura diferente, forneça a ID do recurso. A CLI criará uma nova zona DNS privada dentro do mesmo grupo de recursos que a rede virtual, se não for fornecida pelos usuários.

--sku-name

O nome do SKU de computação. Segue a convenção Standard_{nome da VM}. Exemplos: Standard_B1ms.

--storage-size

A capacidade de armazenamento do servidor. O mínimo é de 32 GiB e o máximo é de 16 TiB.

--subnet

Nome ou ID do recurso de uma sub-rede nova ou existente. Se você quiser usar uma sub-rede de um grupo de recursos ou assinatura diferente, forneça a ID do recurso em vez do nome. Observe que a sub-rede será delegada a flexibleServers. Após a delegação, essa sub-rede não poderá ser usada para nenhum outro tipo de recursos do Azure.

--subnet-prefixes

O prefixo do endereço IP da sub-rede a ser usado ao criar uma nova sub-rede no formato CIDR. O valor padrão é 10.0.0.0/24.

--tags

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

--tier

Camada de computação do servidor. Valores aceitos: Burstable, GeneralPurpose, MemoryOptimized.

--vnet

Nome ou ID de uma rede virtual nova ou existente. Se você quiser usar uma vnet de um grupo de recursos ou assinatura diferente, forneça uma ID de recurso. O nome deve ter entre 2 e 64 caracteres. O nome deve começar com uma letra ou um número, terminar com uma letra, um número ou sublinhado e deve conter apenas letras, números, sublinhados, pontos ou hifens.

--yes -y

Não solicite confirmação.

Valor padrão: False
--zone -z

Zona de disponibilidade na qual o recurso será provisionado.

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 postgres flexible-server replica list

Listar todas as réplicas de leitura para um determinado servidor.

az postgres flexible-server replica list --name
                                         --resource-group

Exemplos

Liste todas as réplicas de leitura para o servidor mestre 'testserver'.

az postgres flexible-server replica list -g testGroup -n testserver

Parâmetros Exigidos

--name -n

Nome do servidor de origem.

--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 postgres flexible-server replica promote

Pare a replicação de uma réplica de leitura e promova-a para um servidor independente ou como um servidor primário.

az postgres flexible-server replica promote [--ids]
                                            [--name]
                                            [--promote-mode {standalone, switchover}]
                                            [--promote-option {forced, planned}]
                                            [--resource-group]
                                            [--subscription]
                                            [--yes]

Exemplos

Pare a replicação para 'testreplicaserver' e promova-o como um servidor de leitura/gravação autônomo.

az postgres flexible-server replica promote -g testGroup -n testreplicaserver

Pare a replicação para 'testreplicaserver' e promova-o como um servidor de leitura/gravação autônomo com sincronização forçada de dados.

az postgres flexible-server replica promote -g testGroup -n testreplicaserver --promote-mode standalone --promote-option forced

Pare a replicação para 'testreplicaserver' e promova-o para o servidor primário com sincronização de dados planejada. A réplica que você está promovendo deve ter o endpoint virtual do leitor atribuído, ou você receberá um erro na promoção.

az postgres flexible-server replica promote -g testGroup -n testreplicaserver --promote-mode switchover --promote-option planned

Parâmetros Opcionais

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de "ID do recurso". Você deve fornecer --ids ou outros argumentos de "ID do recurso".

--name -n

O nome do servidor. O nome pode conter apenas letras minúsculas, números e o caractere de hífen (-). Mínimo de 3 caracteres e máximo de 63 caracteres.

--promote-mode

Se a réplica de leitura deve ser promovida a um servidor independente ou promovê-la como um servidor primário.

Valores aceitos: standalone, switchover
Valor padrão: standalone
--promote-option

Se deseja sincronizar dados antes de promover a réplica de leitura ou promover o mais rápido possível.

Valores aceitos: forced, planned
Valor padrão: planned
--resource-group -g

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

--subscription

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

--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 postgres flexible-server replica stop-replication

Preterido

Esse comando foi descontinuado e será removido em uma versão futura. Em vez disso, use 'postgres flexible-server replica promote'.

Parar a replicação em uma réplica de leitura e torna-lá um servidor de leitura/gravação.

az postgres flexible-server replica stop-replication [--ids]
                                                     [--name]
                                                     [--resource-group]
                                                     [--subscription]
                                                     [--yes]

Exemplos

Pare a replicação para 'testreplicaserver' e torne-o um servidor de leitura/gravação.

az postgres flexible-server replica stop-replication -g testGroup -n testreplicaserver

Parâmetros Opcionais

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de "ID do recurso". Você deve fornecer --ids ou outros argumentos de "ID do recurso".

--name -n

O nome do servidor. O nome pode conter apenas letras minúsculas, números e o caractere de hífen (-). Mínimo de 3 caracteres e máximo de 63 caracteres.

--resource-group -g

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

--subscription

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

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