Habilitar e desabilitar alta disponibilidade

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Console

1. No Google Cloud console, acesse a página Instâncias do Cloud SQL .

   Acesse Instâncias do Cloud SQL

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

   Se as zonas primária e secundária forem especificadas, elas deverão ser zonas diferentes.

7. Clique em Salvar .

   Você retornará à página de instância da instância primária enquanto a instância é 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 obter uma lista completa dos parâmetros disponíveis, consulte a página de referência do gcloud sql instances create .
2. Configurar o usuário root:

   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
}

Aplicar as alterações

Para aplicar sua configuração do Terraform em um Google Cloud projeto, conclua as etapas nas seções a seguir.

Preparar o Cloud Shell

1. Inicie o Cloud Shell .

2. Defina o padrão Google Cloud projeto onde você deseja aplicar suas configurações do Terraform.

   Você só precisa executar este comando uma vez por projeto e pode executá-lo em qualquer diretório.

   export GOOGLE_CLOUD_PROJECT=PROJECT_ID

   Variáveis ​​de ambiente serão substituídas se você definir valores explícitos no arquivo de configuração do Terraform.

Preparar o diretório

Cada arquivo de configuração do Terraform deve ter seu próprio diretório (também chamado de módulo raiz ).

1. No Cloud Shell , crie um diretório e um novo arquivo dentro dele. O nome do arquivo deve ter a extensão .tf — por exemplo, main.tf Neste tutorial, o arquivo será chamado de main.tf

   mkdir DIRECTORY && cd DIRECTORY && touch main.tf

2. Se estiver seguindo um tutorial, você pode copiar o código de exemplo em cada seção ou etapa.

   Copie o código de exemplo no main.tf recém-criado.

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

3. Revise e modifique os parâmetros de amostra para aplicar ao seu ambiente.
4. Salve suas alterações.
5. Inicialize o Terraform. Você só precisa fazer isso uma vez por diretório.

   terraform init

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

   terraform init -upgrade

Aplicar as alterações

1. Revise a configuração e verifique se os recursos que o Terraform irá criar ou atualizar correspondem às suas expectativas:

   terraform plan

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

2. Aplique a configuração do Terraform executando o seguinte comando e digitando yes no prompt:

   terraform apply

   Aguarde até que o Terraform exiba a mensagem "Aplicação concluída!".

3. Abra seu Google Cloud projeto para visualizar os resultados. No Google Cloud console, navegue até seus recursos na interface do usuário para garantir que o Terraform os criou ou atualizou.

Excluir as alterações

Para excluir suas alterações, faça o seguinte:

1. Para desabilitar a proteção contra exclusão, no seu arquivo de configuração do Terraform defina o argumento deletion_protection como false .

   deletion_protection =  "false"

2. Aplique a configuração atualizada do Terraform executando o seguinte comando e digitando yes no prompt:

   terraform apply

3. Remova os recursos aplicados anteriormente com sua configuração do Terraform executando o seguinte comando e digitando yes no prompt:

   terraform destroy

REST v1

Crie a instância regional.

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

   • project-id : O ID do projeto
   • instance-name : O nome da instância
   • database-version : A string de enumeração da versão do banco de dados
   • region A região do 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 da solicitação:

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

   Para enviar sua solicitação, expanda uma destas opções:

   curl (Linux, macOS ou Cloud Shell)

   Salve o corpo da solicitação em um arquivo chamado request.json e execute o seguinte comando:

   curl -X POST \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        -H "Content-Type: application/json; charset=utf-8" \
        -d @request.json \
        "https://sqladmin.googleapis.com/v1/projects/project-id/instances"

   PowerShell (Windows)

   Salve o corpo da solicitação em um arquivo chamado request.json e execute o seguinte comando:

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method POST `
       -Headers $headers `
       -ContentType: "application/json; charset=utf-8" `
       -InFile request.json `
       -Uri "https://sqladmin.googleapis.com/v1/projects/project-id/instances" | Select-Object -Expand Content

   Você deve receber uma resposta JSON semelhante à seguinte:

   Resposta

   {
     "kind": "sql#operation",
     "targetLink": "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-name",
     "status": "PENDING",
     "user": "[email protected]",
     "insertTime": "2020-01-21T22:43:37.981Z",
     "operationType": "CREATE",
     "name": "operation-id",
     "targetId": "instance-name",
     "selfLink": "https://sqladmin.googleapis.com/v1/projects/project-id/operations/operation-id",
     "targetProject": "project-id"
   }
   

2. Quando a instância terminar de inicializar, atualize a senha root na instância:

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

   • project-id : O ID do projeto
   • instance-id : O ID da instância
   • password : A nova senha do usuário root

   Método HTTP e URL:

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

   Corpo JSON da solicitação:

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

   Para enviar sua solicitação, expanda uma destas opções:

   curl (Linux, macOS ou Cloud Shell)

   Salve o corpo da solicitação em um arquivo chamado request.json e execute o seguinte comando:

   curl -X PATCH \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        -H "Content-Type: application/json; charset=utf-8" \
        -d @request.json \
        "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/users?host=%25&name=postgres'"

   PowerShell (Windows)

   Salve o corpo da solicitação em um arquivo chamado request.json e execute o seguinte comando:

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method PATCH `
       -Headers $headers `
       -ContentType: "application/json; charset=utf-8" `
       -InFile request.json `
       -Uri "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/users?host=%25&name=postgres'" | Select-Object -Expand Content

   Você deve receber um código de status bem-sucedido (2xx) e uma resposta vazia.

REST v1beta4

Crie a instância regional.

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

   • project-id : O ID do projeto
   • instance-name : O nome da instância
   • database-version : A string de enumeração da versão do banco de dados
   • region A região do 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 da solicitação:

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

   Para enviar sua solicitação, expanda uma destas opções:

   curl (Linux, macOS ou Cloud Shell)

   Salve o corpo da solicitação em um arquivo chamado request.json e execute o seguinte comando:

   curl -X POST \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        -H "Content-Type: application/json; charset=utf-8" \
        -d @request.json \
        "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances"

   PowerShell (Windows)

   Salve o corpo da solicitação em um arquivo chamado request.json e execute o seguinte comando:

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method POST `
       -Headers $headers `
       -ContentType: "application/json; charset=utf-8" `
       -InFile request.json `
       -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances" | Select-Object -Expand Content

   Você deve receber uma resposta JSON semelhante à seguinte:

   Resposta

   {
     "kind": "sql#operation",
     "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-name",
     "status": "PENDING",
     "user": "[email protected]",
     "insertTime": "2020-01-21T22:43:37.981Z",
     "operationType": "CREATE",
     "name": "operation-id",
     "targetId": "instance-name",
     "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/operations/operation-id",
     "targetProject": "project-id"
   }
   

2. Quando a instância terminar de inicializar, atualize a senha root na instância:

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

   • project-id : O ID do projeto
   • instance-id : O ID da instância
   • password : A nova senha do usuário root

   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 da solicitação:

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

   Para enviar sua solicitação, expanda uma destas opções:

   curl (Linux, macOS ou Cloud Shell)

   Salve o corpo da solicitação em um arquivo chamado request.json e execute o seguinte comando:

   curl -X PATCH \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        -H "Content-Type: application/json; charset=utf-8" \
        -d @request.json \
        "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/users?host=%25&name=postgres'"

   PowerShell (Windows)

   Salve o corpo da solicitação em um arquivo chamado request.json e execute o seguinte comando:

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method PATCH `
       -Headers $headers `
       -ContentType: "application/json; charset=utf-8" `
       -InFile request.json `
       -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/users?host=%25&name=postgres'" | Select-Object -Expand Content

   Você deve receber um código de status bem-sucedido (2xx) e uma resposta vazia.

Console

Para configurar uma instância para alta disponibilidade:

1. No Google Cloud console, acesse a página Instâncias do Cloud SQL .

   Acesse Instâncias do Cloud SQL

2. Para abrir a página Visão geral de uma instância, clique no nome da instância.
3. Clique em Editar .
4. Na seção "Backups automáticos e configuração de alta disponibilidade" , selecione "Alta disponibilidade (regional)" . Também é recomendável habilitar "Backups automáticos" .
5. Clique em Salvar .

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 você está configurando para alta disponibilidade.

REST v1

Para configurar uma instância para ser uma instância regional de alta disponibilidade:

1. Verifique a instância para ver se os backups automáticos e a recuperação pontual estão habilitados. Eles são necessários para instâncias de alta disponibilidade.

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

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

   Método HTTP e URL:

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

   Para enviar sua solicitação, expanda uma destas opções:

   curl (Linux, macOS ou Cloud Shell)

   Execute o seguinte comando:

   curl -X GET \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME"

   PowerShell (Windows)

   Execute o seguinte comando:

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method GET `
       -Headers $headers `
       -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

   Você deve receber uma resposta JSON semelhante à seguinte:

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

   A saída contém uma seção semelhante à seguinte:

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

2. Se enabled ou pointInTimeRecoveryEnabled forem false , use o método instances:patch para habilitá-los. Para habilitar backups, defina enabled como true e startTime como um valor que seja o início da janela de backup. Para habilitar o registro binário, defina pointInTimeRecoveryEnabled como true .

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

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

   Método HTTP e URL:

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

   Corpo JSON da solicitação:

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

   Para enviar sua solicitação, expanda uma destas opções:

   curl (Linux, macOS ou Cloud Shell)

   Salve o corpo da solicitação em um arquivo chamado request.json e execute o seguinte comando:

   curl -X PATCH \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        -H "Content-Type: application/json; charset=utf-8" \
        -d @request.json \
        "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME"

   PowerShell (Windows)

   Salve o corpo da solicitação em um arquivo chamado request.json e execute o seguinte comando:

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method PATCH `
       -Headers $headers `
       -ContentType: "application/json; charset=utf-8" `
       -InFile request.json `
       -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

   Você deve receber uma resposta JSON semelhante à seguinte:

   Resposta

   {
     "kind": "sql#operation",
     "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME",
     "status": "PENDING",
     "user": "[email protected]",
     "insertTime": "2020-01-21T22:43:37.981Z",
     "operationType": "UPDATE",
     "name": "OPERATION_ID",
     "targetId": "INSTANCE_NAME",
     "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
     "targetProject": "PROJECT_ID"
   }
   

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

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

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

   Método HTTP e URL:

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

   Corpo JSON da solicitação:

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

   Para enviar sua solicitação, expanda uma destas opções:

   curl (Linux, macOS ou Cloud Shell)

   Salve o corpo da solicitação em um arquivo chamado request.json e execute o seguinte comando:

   curl -X PATCH \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        -H "Content-Type: application/json; charset=utf-8" \
        -d @request.json \
        "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME"

   PowerShell (Windows)

   Salve o corpo da solicitação em um arquivo chamado request.json e execute o seguinte comando:

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method PATCH `
       -Headers $headers `
       -ContentType: "application/json; charset=utf-8" `
       -InFile request.json `
       -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

   Você deve receber um código de status bem-sucedido (2xx) e uma resposta vazia.

REST v1beta4

Para configurar uma instância para ser uma instância regional de alta disponibilidade:

1. Verifique a instância para ver se os backups automáticos e a recuperação pontual estão habilitados. Eles são necessários para instâncias de alta disponibilidade.

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

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

   Método HTTP e URL:

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

   Para enviar sua solicitação, expanda uma destas opções:

   curl (Linux, macOS ou Cloud Shell)

   Execute o seguinte comando:

   curl -X GET \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME"

   PowerShell (Windows)

   Execute o seguinte comando:

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method GET `
       -Headers $headers `
       -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

   Você deve receber uma resposta JSON semelhante à seguinte:

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

   A saída contém uma seção semelhante à seguinte:

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

2. Se enabled ou pointInTimeRecoveryEnabled forem false , use o método instances:patch para habilitá-los. Para habilitar backups, defina enabled como true e startTime como um valor que seja o início da janela de backup. Para habilitar o registro binário, defina pointInTimeRecoveryEnabled como true .

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

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

   Método HTTP e URL:

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

   Corpo JSON da solicitação:

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

   Para enviar sua solicitação, expanda uma destas opções:

   curl (Linux, macOS ou Cloud Shell)

   Salve o corpo da solicitação em um arquivo chamado request.json e execute o seguinte comando:

   curl -X PATCH \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        -H "Content-Type: application/json; charset=utf-8" \
        -d @request.json \
        "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME"

   PowerShell (Windows)

   Salve o corpo da solicitação em um arquivo chamado request.json e execute o seguinte comando:

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method PATCH `
       -Headers $headers `
       -ContentType: "application/json; charset=utf-8" `
       -InFile request.json `
       -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

   Você deve receber uma resposta JSON semelhante à seguinte:

   Resposta

   {
     "kind": "sql#operation",
     "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME",
     "status": "PENDING",
     "user": "[email protected]",
     "insertTime": "2020-01-21T22:43:37.981Z",
     "operationType": "UPDATE",
     "name": "OPERATION_ID",
     "targetId": "INSTANCE_NAME",
     "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
     "targetProject": "PROJECT_ID"
   }
   

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

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

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

   Método HTTP e URL:

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

   Corpo JSON da solicitação:

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

   Para enviar sua solicitação, expanda uma destas opções:

   curl (Linux, macOS ou Cloud Shell)

   Salve o corpo da solicitação em um arquivo chamado request.json e execute o seguinte comando:

   curl -X PATCH \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        -H "Content-Type: application/json; charset=utf-8" \
        -d @request.json \
        "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME"

   PowerShell (Windows)

   Salve o corpo da solicitação em um arquivo chamado request.json e execute o seguinte comando:

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method PATCH `
       -Headers $headers `
       -ContentType: "application/json; charset=utf-8" `
       -InFile request.json `
       -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

   Você deve receber um código de status bem-sucedido (2xx) e uma resposta vazia.

Console

1. No Google Cloud console, acesse a página Instâncias do Cloud SQL .

   Acesse Instâncias do Cloud SQL

2. Para abrir a página Visão geral de uma instância, clique no nome da instância.
3. Clique em Failover .
4. Na caixa de diálogo Acionar manualmente um failover , insira o ID da sua instância no campo de texto e clique em Acionar failover .

gcloud

Iniciar o failover:

gcloud sql instances failover PRIMARY_INSTANCE_NAME

REST v1

1. Descreva a instância primária para obter o valor do campo settingsVersion .

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

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

   Método HTTP e URL:

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

   Para enviar sua solicitação, expanda uma destas opções:

   curl (Linux, macOS ou Cloud Shell)

   Execute o seguinte comando:

   curl -X GET \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME"

   PowerShell (Windows)

   Execute o seguinte comando:

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method GET `
       -Headers $headers `
       -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

   Você deve receber uma resposta JSON semelhante à seguinte:

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

2. Iniciar o failover:

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

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

   Método HTTP e URL:

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

   Corpo JSON da solicitação:

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

   Para enviar sua solicitação, expanda uma destas opções:

   curl (Linux, macOS ou Cloud Shell)

   Salve o corpo da solicitação em um arquivo chamado request.json e execute o seguinte comando:

   curl -X POST \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        -H "Content-Type: application/json; charset=utf-8" \
        -d @request.json \
        "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-name/failover"

   PowerShell (Windows)

   Salve o corpo da solicitação em um arquivo chamado request.json e execute o seguinte comando:

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method POST `
       -Headers $headers `
       -ContentType: "application/json; charset=utf-8" `
       -InFile request.json `
       -Uri "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-name/failover" | Select-Object -Expand Content

   Você deve receber uma resposta JSON semelhante à seguinte:

   Resposta

   {
     "kind": "sql#operation",
     "targetLink": "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-name",
     "status": "PENDING",
     "user": "[email protected]",
     "insertTime": "2020-01-21T22:43:37.981Z",
     "operationType": "CREATE",
     "name": "operation-id",
     "targetId": "instance-name",
     "selfLink": "https://sqladmin.googleapis.com/v1/projects/project-id/operations/operation-id",
     "targetProject": "project-id"
   }
   

REST v1beta4

1. Descreva a instância primária para obter o valor do campo settingsVersion .

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

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

   Método HTTP e URL:

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

   Para enviar sua solicitação, expanda uma destas opções:

   curl (Linux, macOS ou Cloud Shell)

   Execute o seguinte comando:

   curl -X GET \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME"

   PowerShell (Windows)

   Execute o seguinte comando:

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method GET `
       -Headers $headers `
       -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

   Você deve receber uma resposta JSON semelhante à seguinte:

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

2. Iniciar o failover:

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

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

   Método HTTP e URL:

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

   Corpo JSON da solicitação:

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

   Para enviar sua solicitação, expanda uma destas opções:

   curl (Linux, macOS ou Cloud Shell)

   Salve o corpo da solicitação em um arquivo chamado request.json e execute o seguinte comando:

   curl -X POST \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        -H "Content-Type: application/json; charset=utf-8" \
        -d @request.json \
        "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-name/failover"

   PowerShell (Windows)

   Salve o corpo da solicitação em um arquivo chamado request.json e execute o seguinte comando:

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method POST `
       -Headers $headers `
       -ContentType: "application/json; charset=utf-8" `
       -InFile request.json `
       -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-name/failover" | Select-Object -Expand Content

   Você deve receber uma resposta JSON semelhante à seguinte:

   Resposta

   {
     "kind": "sql#operation",
     "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-name",
     "status": "PENDING",
     "user": "[email protected]",
     "insertTime": "2020-01-21T22:43:37.981Z",
     "operationType": "CREATE",
     "name": "operation-id",
     "targetId": "instance-name",
     "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/operations/operation-id",
     "targetProject": "project-id"
   }
   

Console

1. No Google Cloud console, acesse a página Instâncias do Cloud SQL .

   Acesse Instâncias do Cloud SQL

2. Para abrir a página Visão geral de uma instância, clique no nome da instância.
3. Confirme se as seguintes configurações de alta disponibilidade são exibidas na seção Configuração :
• Altamente disponível (regional)
• Localizado em mostra a zona primária atual da instância.

gcloud

gcloud sql instances describe INSTANCE_NAME

A saída indica availabilityType é REGIONAL . Os campos gceZone e secondaryGceZone mostram as zonas primária e secundária atuais da instância.

REST v1

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

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

Método HTTP e URL:

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

Para enviar sua solicitação, expanda uma destas opções:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

Você deve receber uma resposta JSON semelhante à seguinte:

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

A saída indica availabilityType é REGIONAL . Os campos gceZone e secondaryGceZone mostram as zonas primária e secundária atuais da instância.

REST v1beta4

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

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

Método HTTP e URL:

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

Para enviar sua solicitação, expanda uma destas opções:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

Você deve receber uma resposta JSON semelhante à seguinte:

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

A saída indica availabilityType é REGIONAL . Os campos gceZone e secondaryGceZone mostram as zonas primária e secundária atuais da instância.

Console

1. No Google Cloud console, acesse a página Instâncias do Cloud SQL .

   Acesse Instâncias do Cloud SQL

2. Para abrir a página Visão geral de uma instância, clique no nome da instância.
3. Clique em Editar .
4. Na seção Escolher região e disponibilidade zonal , expanda Especificar zonas e selecione novas zonas. As zonas padrão são Any para a zona primária e Any (different from primary) para a zona secundária. As seguintes restrições se aplicam:
   • Você pode especificar somente a zona primária ou ambas.
   • Se as zonas primária e secundária forem especificadas, elas deverão ser zonas diferentes.
5. Clique em Salvar .

   Você retornará à página de instância da instância primária enquanto a instância é atualizada.

gcloud

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

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

O parâmetro --secondary-zone é opcional. Se você omiti-lo, o Cloud SQL selecionará uma zona disponível diferente da zona primária.

As seguintes restrições se aplicam:

• As zonas devem ser zonas válidas pertencentes à mesma região que a instância do Cloud SQL.
• Se a zona secundária for especificada, ela deverá ser diferente da zona primária.

REST v1

1. Alterar as zonas da instância regional:

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

   • PROJECT_ID : O ID do projeto
   • INSTANCE_NAME : O nome da instância
   • PRIMARY_ZONE : A zona primária
   • 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 da solicitação:

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

   Para enviar sua solicitação, expanda uma destas opções:

   curl (Linux, macOS ou Cloud Shell)

   Salve o corpo da solicitação em um arquivo chamado request.json e execute o seguinte comando:

   curl -X PATCH \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        -H "Content-Type: application/json; charset=utf-8" \
        -d @request.json \
        "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME"

   PowerShell (Windows)

   Salve o corpo da solicitação em um arquivo chamado request.json e execute o seguinte comando:

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method PATCH `
       -Headers $headers `
       -ContentType: "application/json; charset=utf-8" `
       -InFile request.json `
       -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

   Você deve receber um código de status bem-sucedido (2xx) e uma resposta vazia.

   O parâmetro secondaryZone é opcional. Se você omiti-lo, o Cloud SQL selecionará uma zona disponível diferente da zona primária.

   As seguintes restrições se aplicam:

   • As zonas devem ser zonas válidas.
   • Todas as zonas escolhidas devem pertencer à mesma região da instância do Cloud SQL.

REST v1beta4

1. Alterar as zonas da instância regional:

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

   • PROJECT_ID : O ID do projeto
   • INSTANCE_NAME : O nome da instância
   • PRIMARY_ZONE : A zona primária
   • 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 da solicitação:

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

   Para enviar sua solicitação, expanda uma destas opções:

   curl (Linux, macOS ou Cloud Shell)

   Salve o corpo da solicitação em um arquivo chamado request.json e execute o seguinte comando:

   curl -X PATCH \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        -H "Content-Type: application/json; charset=utf-8" \
        -d @request.json \
        "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME"

   PowerShell (Windows)

   Salve o corpo da solicitação em um arquivo chamado request.json e execute o seguinte comando:

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method PATCH `
       -Headers $headers `
       -ContentType: "application/json; charset=utf-8" `
       -InFile request.json `
       -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

   Você deve receber um código de status bem-sucedido (2xx) e uma resposta vazia.

   O parâmetro secondaryZone é opcional. Se você omiti-lo, o Cloud SQL selecionará uma zona disponível diferente da zona primária.

   As seguintes restrições se aplicam:

   • As zonas devem ser zonas válidas.
   • Todas as zonas escolhidas devem pertencer à mesma região da instância do Cloud SQL.

Console

Para desativar a alta disponibilidade de uma instância:

1. No Google Cloud console, acesse a página Instâncias do Cloud SQL .

   Acesse Instâncias do Cloud SQL

2. Para abrir a página Visão geral de uma instância, clique no nome da instância.
3. Clique em Editar .
4. Abra Backups automáticos .
5. Na seção Disponibilidade , clique em Zona única .
6. Clique em Salvar . Esta edição requer que você reinicie a instância.
7. Quando a caixa de diálogo aparecer, clique em Salvar 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 você está desativando 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 da instância.

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

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

Método HTTP e URL:

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

Corpo JSON da solicitação:

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

Para enviar sua solicitação, expanda uma destas opções:

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

Você deve receber um código de status bem-sucedido (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 da instância.

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

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

Método HTTP e URL:

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

Corpo JSON da solicitação:

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

Para enviar sua solicitação, expanda uma destas opções:

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

Você deve receber um código de status bem-sucedido (2xx) e uma resposta vazia.