Ative e desative a alta disponibilidade

Esta página descreve como configurar uma instância para alta disponibilidade.

Pode configurar uma instância para alta disponibilidade quando a cria ou pode ativar a alta disponibilidade numa instância existente.

Para mais informações sobre a elevada disponibilidade, consulte o Resumo da configuração de elevada disponibilidade.

Crie uma nova instância configurada para alta disponibilidade

Quando cria uma instância e a configura para alta disponibilidade, o Cloud SQL cria-a como uma instância regional.

Para criar uma instância configurada para alta disponibilidade:

Consola

  1. Na Google Cloud consola, aceda à página Instâncias do Cloud SQL.

    Aceda a Instâncias do Cloud SQL

  2. Selecione Criar instância.
  3. Selecione o motor da base de dados.
  4. Na secção Escolher região e disponibilidade zonal, selecione Várias zonas (Altamente disponível).
  5. Expanda Especificar zonas.
  6. Selecione as zonas principal e secundária. As seguintes condições aplicam-se quando a zona secundária é usada durante a criação ou a edição da instância:
    • As zonas são predefinidas como Any para a zona principal e Any (different from primary) para a zona secundária.

      • Se forem especificadas as zonas principal e secundária, têm de ser zonas diferentes.

  7. Clique em Guardar.

    Regressa à página da instância principal enquanto a instância secundária é atualizada.

gcloud

  1. Crie a instância regional: 
    gcloud sql instances create REGIONAL_INSTANCE_NAME \
--availability-type=REGIONAL \
--database-version=DATABASE_VERSION \
--cpu=NUMBER_CPUS \
--memory=MEMORY_SIZE
     Para ver uma lista completa dos parâmetros disponíveis, consulte a página de referência gcloud sql instances create.
  2. Configure o utilizador de raiz: 
    gcloud sql users set-password root no-host \
--instance=REGIONAL_INSTANCE_NAME \
--password=PASSWORD

Terraform

Para criar uma instância com alta disponibilidade, use um recurso do Terraform. 

resource "google_sql_database_instance" "postgres_instance_ha" {
  name             = "postgres-instance-ha"
  region           = "us-central1"
  database_version = "POSTGRES_14"
  settings {
    tier              = "db-custom-2-7680"
    availability_type = "REGIONAL"
    backup_configuration {
      enabled                        = true
      point_in_time_recovery_enabled = true
      start_time                     = "20:55"
    }
  }
  # set `deletion_protection` to true, will ensure that one cannot accidentally delete this instance by
  # use of Terraform whereas `deletion_protection_enabled` flag protects this instance at the GCP level.
  deletion_protection = false
}

Aplique as alterações

Para aplicar a configuração do Terraform num Google Cloud projeto, conclua os passos nas secções seguintes.

Prepare o Cloud Shell

  1. Inicie o Cloud Shell.

  2. Defina o Google Cloud projeto predefinido onde quer aplicar as suas configurações do Terraform.

    Só tem de executar este comando uma vez por projeto e pode executá-lo em qualquer diretório.

    export GOOGLE_CLOUD_PROJECT=PROJECT_ID

    As variáveis de ambiente são substituídas se definir valores explícitos no ficheiro de configuração do Terraform.

Prepare o diretório

Cada ficheiro de configuração do Terraform tem de ter o seu próprio diretório (também denominado módulo raiz).

  1. No Cloud Shell, crie um diretório e um novo ficheiro nesse diretório. O nome do ficheiro tem de ter a extensão .tf, por exemplo, main.tf. Neste tutorial, o ficheiro é denominado main.tf. 
    mkdir DIRECTORY && cd DIRECTORY && touch main.tf

  2. Se estiver a seguir um tutorial, pode copiar o código de exemplo em cada secção ou passo.

    Copie o exemplo de código para o ficheiro main.tf criado recentemente.

    Opcionalmente, copie o código do GitHub. Isto é recomendado quando o fragmento do Terraform faz parte de uma solução completa.

  3. Reveja e modifique os parâmetros de exemplo para aplicar ao seu ambiente.
  4. Guarde as alterações.
  5. Inicialize o Terraform. Só tem de fazer isto uma vez por diretório. 
    terraform init

    Opcionalmente, para usar a versão mais recente do fornecedor Google, inclua a opção -upgrade: 

    terraform init -upgrade

Aplique as alterações

  1. Reveja a configuração e verifique se os recursos que o Terraform vai criar ou atualizar correspondem às suas expetativas: 
    terraform plan

    Faça correções à configuração conforme necessário.

  2. Aplique a configuração do Terraform executando o seguinte comando e introduzindo yes no comando: 
    terraform apply

    Aguarde até que o Terraform apresente a mensagem "Apply complete!" (Aplicação concluída!).

  3. Abra o seu Google Cloud projeto para ver os resultados. Na Google Cloud consola, navegue para os seus recursos na IU para se certificar de que o Terraform os criou ou atualizou.

Eliminar as alterações

Para eliminar as alterações, faça o seguinte:

  1. Para desativar a proteção contra eliminação, no ficheiro de configuração do Terraform, defina o argumento deletion_protection como false. 
    deletion_protection =  "false"
  2. Aplique a configuração do Terraform atualizada executando o seguinte comando e introduzindo yes no comando: 
    terraform apply

  1. Remova os recursos aplicados anteriormente com a sua configuração do Terraform executando o seguinte comando e introduzindo yes no comando:

    terraform destroy

REST v1

Para ver a lista completa de parâmetros do pedido, consulte a página instances:insert.

Crie a instância regional.

  1. Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

    • project-id: o ID do projeto
    • instance-name: o nome da instância
    • database-version: a string enum da versão da base de dados
    • region A região da GCP
    • machine-type O tipo de máquina

    Método HTTP e URL: 

    POST https://sqladmin.googleapis.com/v1/projects/project-id/instances

    Corpo JSON do pedido: 

    {
  "name": "instance-name",
  "region": "region",
  "databaseVersion": "database-version",
   "settings": {
     "tier": "machine-type",
     "backupConfiguration": {
         "enabled": true,
         "pointInTimeRecoveryEnabled": true
      },
      "availabilityType": "REGIONAL"
   }
}

    Para enviar o seu pedido, expanda uma destas opções:

    Deve receber uma resposta JSON semelhante à seguinte:

  2. Quando a inicialização da instância terminar, atualize a palavra-passe de raiz na instância:

    Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

    • project-id: o ID do projeto
    • instance-id: o ID da instância
    • password: a nova palavra-passe do utilizador de raiz

    Método HTTP e URL: 

    PATCH https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/users?host=%25&name=postgres'

    Corpo JSON do pedido: 

    {
   "name": "postgres",
   "host": "nohost",
   "password": "password"}

    Para enviar o seu pedido, expanda uma destas opções:

    Deve receber um código de estado de êxito (2xx) e uma resposta vazia.

REST v1beta4

Para ver a lista completa de parâmetros do pedido, consulte a página instances:insert.

Crie a instância regional.

  1. Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

    • project-id: o ID do projeto
    • instance-name: o nome da instância
    • database-version: a string enum da versão da base de dados
    • region A região da GCP
    • machine-type O tipo de máquina

    Método HTTP e URL: 

    POST https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances

    Corpo JSON do pedido: 

    {
  "name": "instance-name",
  "region": "region",
  "databaseVersion": "database-version",
   "settings": {
     "tier": "machine-type",
     "backupConfiguration": {
         "enabled": true,
         "pointInTimeRecoveryEnabled": true
      },
      "availabilityType": "REGIONAL"
   }
}

    Para enviar o seu pedido, expanda uma destas opções:

    Deve receber uma resposta JSON semelhante à seguinte:

  2. Quando a inicialização da instância terminar, atualize a palavra-passe de raiz na instância:

    Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

    • project-id: o ID do projeto
    • instance-id: o ID da instância
    • password: a nova palavra-passe do utilizador de raiz

    Método HTTP e URL: 

    PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/users?host=%25&name=postgres'

    Corpo JSON do pedido: 

    {
   "name": "postgres",
   "host": "nohost",
   "password": "password"}

    Para enviar o seu pedido, expanda uma destas opções:

    Deve receber um código de estado de êxito (2xx) e uma resposta vazia.

Para ver mais detalhes sobre como criar uma instância, consulte o artigo Criar instâncias.

Configure uma instância existente para alta disponibilidade

Pode configurar uma instância do Cloud SQL para alta disponibilidade através da Google Cloud consola, da CLI gcloud ou da API.

Consola

Para configurar uma instância para alta disponibilidade:

  1. Na Google Cloud consola, aceda à página Instâncias do Cloud SQL.

    Aceda a Instâncias do Cloud SQL

  2. Para abrir a página Vista geral de uma instância, clique no nome da instância.
  3. Clique em Edit.
  4. Na secção Opção de configuração de cópias de segurança automáticas e alta disponibilidade, selecione Alta disponibilidade (regional). Também recomendamos que ative a opção Automatizar cópias de segurança.
  5. Clique em Guardar.

gcloud

Para configurar uma instância como uma instância regional de alta disponibilidade, use o comando gcloud sql instances patch:

gcloud sql instances patch INSTANCE_NAME \
--availability-type REGIONAL

Substitua INSTANCE_NAME pelo nome da instância do Cloud SQL que está a configurar para alta disponibilidade.

REST v1

Para configurar uma instância como uma instância regional de alta disponibilidade:

  1. Verifique a instância para ver se as cópias de segurança automáticas e a recuperação num ponto específico no tempo estão ativadas. Estes são necessários para instâncias de alta disponibilidade.

    Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

    • PROJECT_ID: o ID ou o número do projeto do Google Cloud projeto que contém a instância
    • INSTANCE_NAME: o nome da instância que está a configurar para alta disponibilidade

    Método HTTP e URL: 

    GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME

    Para enviar o seu pedido, expanda uma destas opções:

    Deve receber uma resposta JSON semelhante à seguinte:

    {
  "kind": "sql#instance",
  "state": "RUNNABLE",
  "databaseVersion": "POSTGRES_13"
}

    O resultado contém uma secção semelhante à seguinte:

      "backupConfiguration": {
    "kind": "sql#backupConfiguration",
    "startTime": "12:00",
    "enabled": true,
    "pointInTimeRecoveryEnabled": true
    }

  2. Se enabled ou pointInTimeRecoveryEnabled for false, use o método instances:patch para ativar ambos. Para ativar as cópias de segurança, defina enabled como true e startTime para um valor que seja o início da janela de cópia de segurança. Para ativar o registo binário, defina pointInTimeRecoveryEnabled como true.

    Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

    • PROJECT_ID: o ID ou o número do projeto do Google Cloud projeto que contém a instância
    • INSTANCE_NAME: o nome da instância principal ou de réplica de leitura que está a configurar para alta disponibilidade
    • START_TIME: a hora (em horas e minutos)

    Método HTTP e URL: 

    PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME

    Corpo JSON do pedido: 

    {
  "settings":
  {
    "backupConfiguration":
    {
      "startTime": "START_TIME",
      "enabled": true,
      "pointInTimeRecoveryEnabled": true
    }
  }
}

    Para enviar o seu pedido, expanda uma destas opções:

    Deve receber uma resposta JSON semelhante à seguinte:

  3. Configure a instância para ser uma instância regional de alta disponibilidade:

    Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

    • PROJECT_ID: o ID ou o número do projeto do Google Cloud projeto que contém a instância
    • INSTANCE_NAME: o nome da instância que está a configurar para alta disponibilidade

    Método HTTP e URL: 

    PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME

    Corpo JSON do pedido: 

    {
  "settings": {"availabilityType": "REGIONAL" }
}

    Para enviar o seu pedido, expanda uma destas opções:

    Deve receber um código de estado de êxito (2xx) e uma resposta vazia.

REST v1beta4

Para configurar uma instância como uma instância regional de alta disponibilidade:

  1. Verifique a instância para ver se as cópias de segurança automáticas e a recuperação num ponto específico no tempo estão ativadas. Estes são necessários para instâncias de alta disponibilidade.

    Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

    • PROJECT_ID: o ID ou o número do projeto do Google Cloud projeto que contém a instância
    • INSTANCE_NAME: o nome da instância que está a configurar para alta disponibilidade

    Método HTTP e URL: 

    GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME

    Para enviar o seu pedido, expanda uma destas opções:

    Deve receber uma resposta JSON semelhante à seguinte:

    {
  "kind": "sql#instance",
  "state": "RUNNABLE",
  "databaseVersion": "POSTGRES_13",
}

    O resultado contém uma secção semelhante à seguinte:

      "backupConfiguration": {
    "kind": "sql#backupConfiguration",
    "startTime": "12:00",
    "enabled": true,
    "pointInTimeRecoveryEnabled": true
    }

  2. Se enabled ou pointInTimeRecoveryEnabled for false, use o método instances:patch para ativar ambos. Para ativar as cópias de segurança, defina enabled como true e startTime para um valor que seja o início da janela de cópia de segurança. Para ativar o registo binário, defina pointInTimeRecoveryEnabled como true.

    Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

    • PROJECT_ID: o ID ou o número do projeto do Google Cloud projeto que contém a instância
    • INSTANCE_NAME: o nome da instância principal ou de réplica de leitura que está a configurar para alta disponibilidade
    • START_TIME: a hora (em horas e minutos)

    Método HTTP e URL: 

    PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME

    Corpo JSON do pedido: 

    {
  "settings":
  {
    "backupConfiguration":
    {
      "startTime": "START_TIME",
      "enabled": true,
      "pointInTimeRecoveryEnabled": true
    }
  }
}

    Para enviar o seu pedido, expanda uma destas opções:

    Deve receber uma resposta JSON semelhante à seguinte:

  3. Configure a instância para ser uma instância regional de alta disponibilidade:

    Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

    • PROJECT_ID: o ID ou o número do projeto do Google Cloud projeto que contém a instância
    • INSTANCE_NAME: o nome da instância que está a configurar para alta disponibilidade

    Método HTTP e URL: 

    PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME

    Corpo JSON do pedido: 

    {
  "settings": {"availabilityType": "REGIONAL" }
}

    Para enviar o seu pedido, expanda uma destas opções:

    Deve receber um código de estado de êxito (2xx) e uma resposta vazia.

Inicie a comutação por falha

Os testes de comutação por falha são opcionais, mas recomendados para que possa ver como a sua aplicação responde em caso de comutação por falha.

Para saber mais sobre as comutações por falha, consulte a Vista geral da comutação por falha.

Consola

  1. Na Google Cloud consola, aceda à página Instâncias do Cloud SQL.

    Aceda a Instâncias do Cloud SQL

  2. Para abrir a página Vista geral de uma instância, clique no nome da instância.
  3. Clique em Failover.
  4. Na caixa de diálogo Acionar manualmente uma comutação por falha, introduza o ID da sua instância no campo de texto e, de seguida, clique em Acionar comutação por falha.

gcloud

Inicie a comutação por falha:

gcloud sql instances failover PRIMARY_INSTANCE_NAME

REST v1

  1. Descreva a instância principal para obter o valor do campo settingsVersion.

    Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

    • PROJECT_ID: o ID ou o número do projeto do Google Cloud projeto que contém a instância
    • INSTANCE_NAME: o nome da instância que está a configurar para alta disponibilidade

    Método HTTP e URL: 

    GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME

    Para enviar o seu pedido, expanda uma destas opções:

    Deve receber uma resposta JSON semelhante à seguinte:

    {
  "kind": "sql#instance",
  "state": "RUNNABLE",
  "databaseVersion": "POSTGRES_13"
}
  2. Inicie a comutação por falha:

    Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

    • project-id: o ID do projeto
    • instance-name: o nome da instância
    • settings-version: settingsVersion de instanceInfo

    Método HTTP e URL: 

    POST https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-name/failover

    Corpo JSON do pedido: 

    {
  "failoverContext":
     {
        "settingsVersion":"settings-version"
     }
}

    Para enviar o seu pedido, expanda uma destas opções:

    Deve receber uma resposta JSON semelhante à seguinte:

REST v1beta4

  1. Descreva a instância principal para obter o valor do campo settingsVersion.

    Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

    • PROJECT_ID: o ID ou o número do projeto do Google Cloud projeto que contém a instância
    • INSTANCE_NAME: o nome da instância que está a configurar para alta disponibilidade

    Método HTTP e URL: 

    GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME

    Para enviar o seu pedido, expanda uma destas opções:

    Deve receber uma resposta JSON semelhante à seguinte:

    {
  "kind": "sql#instance",
  "state": "RUNNABLE",
  "databaseVersion": "POSTGRES_13"
}
  2. Inicie a comutação por falha:

    Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

    • project-id: o ID do projeto
    • instance-name: o nome da instância
    • settings-version: settingsVersion de instanceInfo

    Método HTTP e URL: 

    POST https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-name/failover

    Corpo JSON do pedido: 

    {
  "failoverContext":
     {
        "settingsVersion":"settings-version"
     }
}

    Para enviar o seu pedido, expanda uma destas opções:

    Deve receber uma resposta JSON semelhante à seguinte:

A instância muda para o modo de tolerância a falhas e não está disponível para publicar dados durante alguns minutos.

Valide a configuração de alta disponibilidade de uma instância

Para verificar se uma instância tem alta disponibilidade e ver as zonas em que está a ser executada:

Consola

  1. Na Google Cloud consola, aceda à página Instâncias do Cloud SQL.

    Aceda a Instâncias do Cloud SQL

  2. Para abrir a página Vista geral de uma instância, clique no nome da instância.
  3. Confirme que as seguintes definições de alta disponibilidade são apresentadas na secção Configuração:
    • Altamente disponível (regional)
    • Localizado em mostra a zona principal atual da instância.

gcloud

gcloud sql instances describe INSTANCE_NAME

O resultado indica que availabilityType é REGIONAL. Os campos gceZone e secondaryGceZone mostram as zonas primárias e secundárias atuais da instância.

REST v1

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

  • PROJECT_ID: o ID ou o número do projeto do Google Cloud projeto que contém a instância
  • INSTANCE_NAME: o nome da instância que está a configurar para alta disponibilidade

Método HTTP e URL: 

GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME

Para enviar o seu pedido, expanda uma destas opções:

Deve receber uma resposta JSON semelhante à seguinte:

{
  "kind": "sql#instance",
  "state": "RUNNABLE",
  "databaseVersion": "POSTGRES_13"
}

O resultado indica que availabilityType é REGIONAL. Os campos gceZone e secondaryGceZone mostram as zonas primárias e secundárias atuais da instância.

REST v1beta4

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

  • PROJECT_ID: o ID ou o número do projeto do Google Cloud projeto que contém a instância
  • INSTANCE_NAME: o nome da instância que está a configurar para alta disponibilidade

Método HTTP e URL: 

GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME

Para enviar o seu pedido, expanda uma destas opções:

Deve receber uma resposta JSON semelhante à seguinte:

{
  "kind": "sql#instance",
  "state": "RUNNABLE",
  "databaseVersion": "POSTGRES_13",
}

O resultado indica que availabilityType é REGIONAL. Os campos gceZone e secondaryGceZone mostram as zonas primárias e secundárias atuais da instância.

Altere as zonas de uma instância de alta disponibilidade

A alteração de uma ou ambas as zonas de uma instância de alta disponibilidade existente provoca alguns minutos de inatividade enquanto a instância é reconfigurada. Para ver as zonas primárias e secundárias atuais em que a instância de alta disponibilidade está a ser executada, consulte o artigo Valide a configuração de alta disponibilidade de uma instância.

Para alterar as zonas de uma instância de alta disponibilidade:

Consola

  1. Na Google Cloud consola, aceda à página Instâncias do Cloud SQL.

    Aceda a Instâncias do Cloud SQL

  2. Para abrir a página Vista geral de uma instância, clique no nome da instância.
  3. Clique em Edit.
  4. Na secção Escolha a região e a disponibilidade por zonas, expanda Especificar zonas e selecione novas zonas. As zonas são predefinidas como Any para a zona principal e Any (different from primary) para a zona secundária. Aplicam-se as seguintes restrições:
    • Pode especificar apenas a zona principal ou as zonas principal e secundária.
    • Se as zonas principal e secundária forem especificadas, têm de ser zonas diferentes.
  5. Clique em Guardar.

    Regressa à página da instância principal enquanto a instância secundária é atualizada.

gcloud

Altere a zona na qual a instância está a ser executada:

gcloud sql instances patch INSTANCE_NAME \
  --zone=PRIMARY_ZONE --secondary-zone=SECONDARY_ZONE

O parâmetro --secondary-zone é opcional. Se o omitir, o Cloud SQL seleciona uma zona disponível diferente da zona principal.

Aplicam-se as seguintes restrições:

  • As zonas têm de ser zonas válidas pertencentes à mesma região que a instância do Cloud SQL.
  • Se a zona secundária for especificada, tem de ser diferente da zona principal.

REST v1

  1. Altere as zonas da instância regional:

    Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

    • PROJECT_ID: o ID do projeto
    • INSTANCE_NAME: o nome da instância
    • PRIMARY_ZONE: a zona principal
    • SECONDARY_ZONE: a zona secundária

    Método HTTP e URL: 

    PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME

    Corpo JSON do pedido: 

    {
"settings": {"locationPreference": {"zone": "PRIMARY_ZONE", "secondaryZone": "SECONDARY_ZONE"}}
}

    Para enviar o seu pedido, expanda uma destas opções:

    Deve receber um código de estado de êxito (2xx) e uma resposta vazia.

    O parâmetro secondaryZone é opcional. Se o omitir, o Cloud SQL seleciona uma zona disponível diferente da zona principal.

    Aplicam-se as seguintes restrições:

    • As zonas têm de ser zonas válidas.
    • Todas as zonas que escolher têm de pertencer à mesma região que a instância do Cloud SQL.

REST v1beta4

  1. Altere as zonas da instância regional:

    Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

    • PROJECT_ID: o ID do projeto
    • INSTANCE_NAME: o nome da instância
    • PRIMARY_ZONE: a zona principal
    • SECONDARY_ZONE: a zona secundária

    Método HTTP e URL: 

    PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME

    Corpo JSON do pedido: 

    {
"settings": {"locationPreference": {"zone": "PRIMARY_ZONE", "secondaryZone": "SECONDARY_ZONE"}}
}

    Para enviar o seu pedido, expanda uma destas opções:

    Deve receber um código de estado de êxito (2xx) e uma resposta vazia.

    O parâmetro secondaryZone é opcional. Se o omitir, o Cloud SQL seleciona uma zona disponível diferente da zona principal.

    Aplicam-se as seguintes restrições:

    • As zonas têm de ser zonas válidas.
    • Todas as zonas que escolher têm de pertencer à mesma região que a instância do Cloud SQL.

Desative a alta disponibilidade para uma instância

Pode desativar a alta disponibilidade para uma instância do Cloud SQL através da Google Cloud consola, da CLI gcloud ou da API.

Se desativar a alta disponibilidade para uma instância, no caso de uma indisponibilidade zonal, tem de recuperar a instância manualmente. Para mais informações, consulte o artigo Opções de recuperação para instâncias autónomas.

Consola

Para desativar a alta disponibilidade de uma instância:

  1. Na Google Cloud consola, aceda à página Instâncias do Cloud SQL.

    Aceda a Instâncias do Cloud SQL

  2. Para abrir a página Vista geral de uma instância, clique no nome da instância.
  3. Clique em Edit.
  4. Abra as cópias de segurança automáticas.
  5. Na secção Disponibilidade, clique em Zona única.
  6. Clique em Guardar. Esta edição requer que reinicie a instância.
  7. Quando a caixa de diálogo for apresentada, clique em Guardar e reiniciar.

gcloud

Para desativar a alta disponibilidade de uma instância, use o comando gcloud sql instances patch:

gcloud sql instances patch INSTANCE_NAME \
--availability-type ZONAL

Substitua INSTANCE_NAME pelo nome da instância do Cloud SQL para a qual está a desativar a alta disponibilidade.

REST v1

Para alterar o tipo de disponibilidade da instância para ZONAL, use o método instances:patch. Este método desativa a alta disponibilidade para a instância.

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

  • PROJECT_ID: o ID ou o número do projeto do Google Cloud projeto que contém a instância
  • INSTANCE_NAME: o nome da instância para a qual está a desativar a alta disponibilidade

Método HTTP e URL: 

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME

Corpo JSON do pedido: 

{
  "settings": {"availabilityType": "ZONAL" }
}

Para enviar o seu pedido, expanda uma destas opções:

Deve receber um código de estado de êxito (2xx) e uma resposta vazia.

REST v1beta4

Para alterar o tipo de disponibilidade da instância para ZONAL, use o método instances:patch. Este método desativa a alta disponibilidade para a instância.

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

  • PROJECT_ID: o ID ou o número do projeto do Google Cloud projeto que contém a instância
  • INSTANCE_NAME: o nome da instância para a qual está a desativar a alta disponibilidade

Método HTTP e URL: 

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME

Corpo JSON do pedido: 

{
  "settings": {"availabilityType": "ZONAL" }
}

Para enviar o seu pedido, expanda uma destas opções:

Deve receber um código de estado de êxito (2xx) e uma resposta vazia.

Resolver problemas

Problema Resolução de problemas
Não consegue encontrar as métricas para uma comutação por falha manual. Apenas as comutações por falha automáticas são incluídas nas métricas.
Os recursos da instância do Cloud SQL (CPU e RAM) estão perto de 100% de utilização, o que faz com que a instância de alta disponibilidade fique inativa. O tamanho da máquina da instância é demasiado pequeno para a carga.

Edite a instância para atualizar para um tamanho de máquina maior e ter mais CPUs e memória.

O que se segue?