Partilhar via


az postgres flexible-server replica

Gerencie réplicas de leitura.

Comandos

Name Description Tipo Status
az postgres flexible-server replica create

Crie uma réplica de leitura para um servidor.

Core disponibilidade geral
az postgres flexible-server replica list

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

Core disponibilidade geral
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.

Core disponibilidade geral

az postgres flexible-server replica create

Crie 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 local especificados, se disponíveis.

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

--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 a partir do qual restaurar.

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.

--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 ID de recurso da identidade atribuída ao usuário para criptografia de dados.

--key

O ID de recurso da chave keyvault primária para criptografia de dados.

--location -l

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

--no-wait

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

Propriedade Valor
Default value: False
--performance-tier

Camada de desempenho do servidor.

--private-dns-zone

Este parâmetro só se aplica a um servidor com acesso privado. O nome ou 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 outro grupo de recursos ou assinatura, forneça a ID do recurso. A CLI cria 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_{VM name}. 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 de recurso de uma sub-rede nova ou existente. Se você quiser usar uma sub-rede de outro grupo de recursos ou assinatura, forneça o 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 pode 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.

--tags

Tags separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar 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 outro grupo de recursos ou assinatura, forneça um ID de recurso. O nome deve ter entre 2 e 64 caracteres. O nome deve começar com uma letra ou número, terminar com uma letra, número ou sublinhado, e pode conter apenas letras, números, sublinhados, pontos ou hífenes.

--yes -y

Não solicite confirmação.

Propriedade Valor
Default value: False
--zone -z

Zona de disponibilidade na qual provisionar o recurso.

Parâmetros de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

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

--verbose

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

Propriedade Valor
Default value: False

az postgres flexible-server replica list

Liste 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 Obrigatórios

--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 de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

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

--verbose

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

Propriedade Valor
Default value: False

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

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.

--ids

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo que contenha todas as informações dos argumentos do 'ID de recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--name -n

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

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--promote-mode

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

Propriedade Valor
Default value: standalone
Valores aceites: standalone, switchover
--promote-option

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

Propriedade Valor
Default value: planned
Valores aceites: forced, planned
--resource-group -g

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

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--subscription

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

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--yes -y

Não solicite confirmação.

Propriedade Valor
Default value: False
Parâmetros de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--verbose

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

Propriedade Valor
Default value: False