Compartilhar via


az postgres flexible-server replica

Gerenciar 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]
                                           [--tier]
                                           [--vnet]
                                           [--yes]
                                           [--zone]

Exemplos

Crie uma réplica de leitura 'testReplicaServer' para 'testserver' com acesso público ou privado na zona e 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

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 pegará automaticamente a zona no local da réplica que é diferente do servidor de origem, se disponível, caso contrário, pegará 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

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

--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-a para o servidor primário com sincronização de dados planejada. A réplica que você está promovendo deve ter o ponto de extremidade 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 um ID de recurso completo contendo todas as informações dos argumentos 'Resource Id'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

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

Seja para promover a réplica de leitura para um servidor independente ou para promitá-la como um servidor primário.

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

Seja para 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 preterido 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 um ID de recurso completo contendo todas as informações dos argumentos 'Resource Id'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

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