Localizar e definir janelas de manutenção

MySQL | PostgreSQL | SQL Server

Esta página contém procedimentos para localizar e definir janelas de manutenção para instâncias do Cloud SQL. Para saber mais sobre como e por que o Cloud SQL realiza a manutenção, consulte a Visão geral da manutenção de instâncias do Cloud SQL.

Se você tiver ativado as notificações de manutenção, o Cloud SQL vai enviar uma notificação por e-mail quando uma atualização de manutenção estiver disponível para a instância do Cloud SQL. O Cloud SQL envia uma notificação antes do lançamento da manutenção e depois aplica a atualização a grupos de instâncias em uma programação semanal. É possível controlar o aviso com antecedência antes que a instância receba a atualização de manutenção selecionando o tempo de manutenção para a instância.

Você tem as seguintes opções para programar o tempo da atualização da manutenção:

Se você selecionar Any ou não fizer a configuração, a atualização de manutenção poderá acontecer a qualquer momento, mas geralmente ela ocorrerá na primeira semana do lançamento.
Ao selecionar Week 1 (também conhecido como preview e canary), a atualização de manutenção vai ocorrer de 7 a 14 dias após o envio da notificação de manutenção.
Ao selecionar Week 2 (também conhecido como production e stable), a atualização de manutenção vai acontecer de 15 a 21 dias após o envio da notificação.
Se selecionar Week 5, a atualização de manutenção vai ocorrer de 35 a 42 dias após o envio da notificação.

Se você fizer alterações na configuração da janela de manutenção enquanto a instância estiver em manutenção ou programada para manutenção, as alterações não entrarão em vigor imediatamente. Essas alterações são refletidas nos eventos de manutenção futuros.

Antes de começar

Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Go to project selector

Make sure that billing is enabled for your Google Cloud project.

Install the Google Cloud CLI.

To initialize the gcloud CLI, run the following command:

gcloud init

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Go to project selector

Make sure that billing is enabled for your Google Cloud project.

Install the Google Cloud CLI.

To initialize the gcloud CLI, run the following command:

gcloud init

Definir uma janela de manutenção em uma instância

Console

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

Acesse Instâncias do Cloud SQL
Para abrir a página Visão geral de uma instância, clique no nome da instância.
Na seção Manutenção, clique em Editar preferências de manutenção.
Na seção Opções de configuração, abra Manutenção.
Configure as seguintes opções:
- Dia/hora da manutenção. Selecione a semana para aplicar a atualização automática de manutenção. Siga uma destas instruções:
  - Qualquer momento: a atualização de manutenção pode acontecer a qualquer momento, mas normalmente acontece dentro da semana 1.
  - Semana 1: a manutenção ocorre de 7 a 14 dias após o envio da notificação de manutenção.
  - Semana 2: a atualização de manutenção ocorre de 15 a 21 dias após o envio da notificação.
  - Semana 5: a atualização de manutenção ocorre de 35 a 42 dias após o envio da notificação.
- Janela de manutenção. Selecione um dia da semana e um horário. As opções incluem:
  - Qualquer janela: a janela de manutenção padrão. A atualização de manutenção não é restrita a um dia específico da semana ou horário do dia.
  - Dia da semana: selecione um dia para a janela de manutenção: sábado, domingo, segunda-feira, terça-feira, quarta-feira, quinta-feira ou sexta-feira.
  - Horário: se você selecionar um dia da semana, também poderá escolher um horário. Selecione um intervalo de uma hora no fuso horário local.

gcloud

Para configurar uma janela de manutenção e o horário de manutenção em uma instância do Cloud SQL, execute o seguinte comando:

gcloud sql instances patch INSTANCE_ID \
  --maintenance-window-day=DAY \
  --maintenance-window-hour=HOUR \
  --maintenance-release-channel=MAINTENANCE_TIMING

Substitua as seguintes variáveis:

INSTANCE_ID: o ID da instância, que pode ser uma instância de réplica de leitura
DAY: o dia da semana em que você quer que a manutenção ocorra. Defina como MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY ou SUNDAY. Especifique no fuso horário UTC.
HOUR: a hora do dia, 0 a 23, para a janela de manutenção. Especifique no fuso horário UTC.
MAINTENANCE_TIMING: a semana do período de lançamento da manutenção em que você quer que a atualização de manutenção seja aplicada. As opções incluem:

preview: isso significa a semana 1 após o envio da notificação de manutenção. A atualização de manutenção é programada de 7 a 14 dias após a notificação.
production: isso significa a Semana 2 após o envio da notificação de manutenção. A atualização de manutenção é programada de 15 a 21 dias após a notificação.
week5: a atualização de manutenção é programada de 35 a 42 dias após o envio da notificação de manutenção.

Para informações de referência, consulte gcloud sql instances patch.

REST v1

Antes de usar os dados da solicitação, faça as seguintes substituições:

PROJECT_ID: o ID ou número do projeto do Google Cloud.
INSTANCE_ID: o ID da instância, que não pode ser uma instância de réplica de leitura.
HOUR: a hora do dia, 0 a 23, para a janela de manutenção. Especifique no fuso horário UTC.
DAY: o dia da semana em que a atualização de manutenção vai ocorrer. Especifique MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY ou SUNDAY. Especifique no fuso horário UTC.
MAINTENANCE_TIMING: a semana do período de lançamento da manutenção em que você quer que a atualização de manutenção seja aplicada. As opções são:
- canary: isso significa semana 1 após o envio da notificação de manutenção. A atualização de manutenção é programada de 7 a 14 dias após a notificação.
- stable: isso significa a Semana 2 após o envio da notificação de manutenção. A atualização de manutenção está programada para acontecer de 15 a 21 dias após a notificação.
- week5: a atualização de manutenção é programada de 35 a 42 dias após o envio da notificação de manutenção.

Método HTTP e URL:

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

Corpo JSON da solicitação:

{
  "settings": {
    "maintenanceWindow": {
        "hour": "HOUR",
        "day": "DAY",
        "updateTrack": "MAINTENANCE_TIMING"
    }
  }
}

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

curl (Linux, macOS ou Cloud Shell)

Observação: o comando a seguir pressupõe que você fez login na CLI gcloud com sua conta de usuário executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que faz login automaticamente na CLI gcloud. . É possível verificar a conta ativa atual executando gcloud auth list.

Salve o corpo da solicitação em um arquivo com o nome request.json e execute o comando a seguir:

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"

PowerShell (Windows)

Observação: o comando a seguir pressupõe que você fez login na CLI gcloud com sua conta de usuário executando gcloud init ou gcloud auth login . É possível verificar a conta ativa atual executando gcloud auth list.

Salve o corpo da solicitação em um arquivo com o nome request.json e execute o comando a seguir:

$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" | Select-Object -Expand Content

Você receberá uma resposta JSON semelhante a esta:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2024-04-01T21:30:35.667Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

REST v1beta4

Antes de usar os dados da solicitação, faça as seguintes substituições:

PROJECT_ID: o ID ou número do projeto do Google Cloud.
INSTANCE_ID: o ID da instância, que não pode ser uma instância de réplica de leitura.
HOUR: a hora do dia, 0 a 23, para a janela de manutenção. Especifique no fuso horário UTC.
DAY: o dia da semana em que você quer que a atualização de manutenção ocorra. Especifique MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY ou SUNDAY. Especifique no fuso horário UTC.
MAINTENANCE_TIMING: a semana do período de lançamento da manutenção em que você quer que a atualização de manutenção seja aplicada. As opções são:
- canary: isso significa semana 1 após o envio da notificação de manutenção. A atualização de manutenção é programada de 7 a 14 dias após a notificação.
- stable: isso significa a Semana 2 após o envio da notificação de manutenção. A atualização de manutenção está programada para acontecer de 15 a 21 dias após a notificação.
- week5: a atualização de manutenção é programada de 35 a 42 dias após o envio da notificação de manutenção.

Método HTTP e URL:

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

Corpo JSON da solicitação:

{
  "settings": {
    "maintenanceWindow": {
        "hour": "HOUR",
        "day": "DAY",
        "updateTrack": "MAINTENANCE_TIMING"
    }
  }
}

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

curl (Linux, macOS ou Cloud Shell)

Salve o corpo da solicitação em um arquivo com o nome request.json e execute o comando a seguir:

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"

PowerShell (Windows)

Salve o corpo da solicitação em um arquivo com o nome request.json e execute o comando a seguir:

$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" | Select-Object -Expand Content

Você receberá uma resposta JSON semelhante a esta:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2024-04-01T21:30:35.667Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

Ativar as notificações de manutenção

Antes de ativar as notificações de manutenção, é necessário definir uma janela de manutenção em uma instância.

Acesse a página Comunicação. Acessar a página Comunicação
Na linha do Cloud SQL, em Janela de manutenção, selecione o botão de opção em E-mail para ATIVAR as notificações.

Cada usuário que precisa receber notificações precisa aceitar separadamente.

Encontrar notificações de manutenção no Console do Google Cloud

É possível visualizar notificações de manutenção em alguns lugares no Console do Google Cloud:

No painel ATIVIDADE, procure instâncias marcadas com Manutenção SQL.
Acessar Atividade
Quando uma instância é programada para manutenção, a data em que isso ocorrerá é listada na coluna Manutenção da página Instâncias. A coluna Manutenção normalmente fica oculta, mas é exibida automaticamente quando a manutenção é programada. Também é possível selecionar Manutenção em Opções de exibição da coluna () se você quiser que a coluna Manutenção sempre apareça.
Como alternativa, é possível selecionar uma instância para acessar a página Detalhes da instância. Se a instância estiver programada para manutenção, você verá uma mensagem no painel Manutenção.
Acessar a página Instâncias do Cloud SQL

Encontrar a manutenção programada usando a API

gcloud

Para verificar a próxima manutenção programada, use o seguinte comando:

gcloud sql instances describe INSTANCE_ID

Substitua a seguinte variável:

INSTANCE_ID: a instância a ser verificada para a manutenção programada.

Na resposta, procure a seção scheduledMaintenance.

REST v1

Antes de usar os dados da solicitação, faça as seguintes substituições:

PROJECT_ID: o ID ou número do projeto do Google Cloud 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 a 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ê receberá uma resposta JSON semelhante a esta:

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

Na resposta, procure a seção scheduledMaintenance.

REST v1beta4

Antes de usar os dados da solicitação, faça as seguintes substituições:

PROJECT_ID: o ID ou número do projeto do Google Cloud 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 a 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ê receberá uma resposta JSON semelhante a esta:

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

Na resposta, procure a seção scheduledMaintenance.

Reprogramar manutenção planejada

É possível reprogramar a manutenção usando o console do Google Cloud, a gcloud CLI ou a API Cloud SQL Admin.

Se você definir o período de manutenção da instância para a Semana 1 ou 2, será possível reprogramar a manutenção por até 28 dias.

Se você definir o período de manutenção da instância para a Semana 5, será possível reprogramar a manutenção em até sete dias. É necessário reprogramar a manutenção nesse período para garantir que a instância receba a atualização antes do próximo lançamento trimestral.

Console

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

Acesse Instâncias do Cloud SQL
Filtre pelo termo Manutenção para listar todas as instâncias programadas para manutenção.
Na coluna Manutenção, clique em Reprogramar.
Na caixa de diálogo Reprogramar, escolha entre aplicar a manutenção imediatamente, reprogramá-la para que ocorra em um momento específico no período de diferimento permitido, conforme definido em manutenção programada reprogramada ou adiar para a próxima janela de manutenção disponível.

gcloud

Para reagendar a manutenção em uma instância do Cloud SQL, execute o seguinte comando:

gcloud sql reschedule-maintenance INSTANCE_ID \
  --reschedule-type=RESCHEDULE_TYPE \
  [--schedule-time=RESCHEDULE_TIME]

Substitua as seguintes variáveis:

INSTANCE_ID: a instância a ser reprogramada.
RESCHEDULE_TYPE: use IMMEDIATE, NEXT_AVAILABLE_WINDOW ou SPECIFIC_TIME.
Se você escolher NEXT_AVAILABLE_WINDOW, a manutenção será reprogramada para a próxima janela de manutenção disponível após o horário programado atual.
RESCHEDULE_TIME: se você especificar SPECIFIC_TIME para RESCHEDULE_TYPE, também precisará definir a flag --schedule-time para especificar o novo dia e hora da manutenção. Usa o formato ISO 8601. Por exemplo, 2020-01-16T16:56:00.000Z

Para informações de referência, consulte gcloud sql reschedule-maintenance.

Se você quiser reprogramar a manutenção por até 28 dias, verifique o número da versão de gcloud. Se o número da versão for anterior a 390.0.0_RC00, reinstale o gcloud.

REST v1

Antes de usar os dados da solicitação, faça as seguintes substituições:

PROJECT_ID: o ID do projeto
INSTANCE_ID: o ID da instância
RESCHEDULE_TYPE: use uma destas opções, IMMEDIATE, NEXT_AVAILABLE_WINDOW ou SPECIFIC_TIME.
Ao escolher NEXT_AVAILABLE_WINDOW, a manutenção será reprogramada para a próxima janela de manutenção disponível.

Método HTTP e URL:

POST https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID/rescheduleMaintenance

Corpo JSON da solicitação:

{
  "reschedule": {
    "reschedule_type": "RESCHEDULE_TYPE"
  }
}

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

curl (Linux, macOS ou Cloud Shell)

Salve o corpo da solicitação em um arquivo com o nome request.json e execute o comando a seguir:

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_ID/rescheduleMaintenance"

PowerShell (Windows)

Salve o corpo da solicitação em um arquivo com o nome request.json e execute o comando a seguir:

$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_ID/rescheduleMaintenance" | Select-Object -Expand Content

Você receberá uma resposta JSON semelhante a esta:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "startTime": "08:00",
  "endTime": "08:01",
  "operationType": RESCHEDULE_MAINTENANCE,
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

REST v1beta4

Antes de usar os dados da solicitação, faça as seguintes substituições:

PROJECT_ID: o ID do projeto
INSTANCE_ID: o ID da instância
RESCHEDULE_TYPE: use uma destas opções, IMMEDIATE, NEXT_AVAILABLE_WINDOW ou SPECIFIC_TIME.
Ao escolher NEXT_AVAILABLE_WINDOW, a manutenção será reprogramada para a próxima janela de manutenção disponível.

Método HTTP e URL:

POST https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID/rescheduleMaintenance

Corpo JSON da solicitação:

{
  "reschedule": {
    "reschedule_type": "RESCHEDULE_TYPE"
  }
}

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

curl (Linux, macOS ou Cloud Shell)

Salve o corpo da solicitação em um arquivo com o nome request.json e execute o comando a seguir:

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_ID/rescheduleMaintenance"

PowerShell (Windows)

Salve o corpo da solicitação em um arquivo com o nome request.json e execute o comando a seguir:

$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_ID/rescheduleMaintenance" | Select-Object -Expand Content

Você receberá uma resposta JSON semelhante a esta:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "startTime": "08:00",
  "endTime": "08:01",
  "operationType": RESCHEDULE_MAINTENANCE,
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

Para ver como a solicitação da API REST subjacente é criada nesta tarefa, consulte o APIs Explorer na página instances:post.

Configurar um período de manutenção de negação

É possível configurar, no máximo, um período de manutenção de negação em uma instância do Cloud SQL, a qualquer momento. O período de manutenção de negação tem precedência sobre qualquer janela de manutenção programada. Se houver conflito entre o momento de uma janela de manutenção e o período de manutenção de negação, o período modificará a janela.

É possível remover manualmente um período de manutenção de negação, independentemente de ele ter ocorrido ou não.

Para configurar um período de manutenção de negação, defina a data de início, a data de término e a hora em que o intervalo começa e termina. Um período de manutenção de negação pode variar de 1 a 90 dias.

Há dois formatos para a data de início e de término:

yyyy-mm-dd: indica uma data específica.
mm-dd: indica uma data recorrente todo ano.

As datas de início e de término são no formato UTC. Para definir o fuso horário, use o campo de hora e ajuste o horário de início. Por exemplo, a data de início = 2020-10-10 e a hora = 07:00:00 indicam o horário de início 2020-10-10 07:00:00 UTC (2020-10-10 00:00:00 (PST)

Para a hora, o formato é: HH:mm:SS.

As horas estão entre 0 e 23 (inclusive).
Os minutos e os segundos vão de 0 e 59 (incluindo esses dois valores).

Console

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

Acesse Instâncias do Cloud SQL
Para abrir a página Visão geral de uma instância, clique no nome da instância.
Na seção Manutenção, clique em Editar preferências de manutenção.
Na seção Período de manutenção de negação, defina as datas de início e término.
Na seção Opções avançadas, selecione opcionalmente Repetir a cada ano.
Clique em Salvar.

gcloud

Para configurar um período de negação de manutenção em uma instância do Cloud SQL, execute o seguinte comando:

gcloud sql instances patch INSTANCE_ID\
   --deny-maintenance-period-start-date=START_DATE \
   --deny-maintenance-period-end-date=END_DATE \
   --deny-maintenance-period-time=TIME

Substitua as seguintes variáveis:

INSTANCE_ID: ID da instância do Cloud SQL
START_DATE: data em que o intervalo começa. Por exemplo, 2021-11-29.
END_DATE: data em que o intervalo termina. Por exemplo, 2021-12-02.
TIME: hora do início e do término do intervalo. Por exemplo, 00:00:00.

REST v1

Antes de usar os dados da solicitação, faça as seguintes substituições:

project-id: o ID do projeto
instance-id: o ID da instância
start-date: a data de início (dd-mm-aaaa) ou (dd-mm) para recorrência anual
end-date: a data de término (dd-mm-aaaa) ou (dd-mm) para recorrência anual
time: hora de início e término (HH:mm:SS)

Método HTTP e URL:

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

Corpo JSON da solicitação:

{
  "settings":
  {
    "denyMaintenancePeriods": [{
      "start_date": "start-date",
      "end_date": "end-date"
      "time": "time"
    }]
  }
}

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

curl (Linux, macOS ou Cloud Shell)

Salve o corpo da solicitação em um arquivo com o nome request.json e execute o comando a seguir:

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

PowerShell (Windows)

Salve o corpo da solicitação em um arquivo com o nome request.json e execute o comando a seguir:

$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-id" | Select-Object -Expand Content

Você receberá uma resposta JSON semelhante a esta:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "startTime": "08:00",
  "endTime": "08:01",
  "operationType": MAINTENANCE_DENY_PERIOD,
  "name": "operation-id",
  "targetId": "instance-id",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}

REST v1beta4

Antes de usar os dados da solicitação, faça as seguintes substituições:

project-id: o ID do projeto
instance-id: o ID da instância
start-date: a data de início (dd-mm-aaaa) ou (dd-mm) para recorrência anual
end-date: a data de término (dd-mm-aaaa) ou (dd-mm) para recorrência anual
time: hora de início e término (HH:mm:SS)

Método HTTP e URL:

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

Corpo JSON da solicitação:

{
  "settings":
  {
    "denyMaintenancePeriods": [{
      "start_date": "start-date",
      "end_date": "end-date"
      "time": "time"
    }]
  }
}

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

curl (Linux, macOS ou Cloud Shell)

Salve o corpo da solicitação em um arquivo com o nome request.json e execute o comando a seguir:

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

PowerShell (Windows)

Salve o corpo da solicitação em um arquivo com o nome request.json e execute o comando a seguir:

$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-id" | Select-Object -Expand Content

Você receberá uma resposta JSON semelhante a esta:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "startTime": "08:00",
  "endTime": "08:01",
  "operationType": MAINTENANCE_DENY_PERIOD,
  "name": "operation-id",
  "targetId": "instance-id",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}

Remover um período de manutenção de negação

Console

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

Acesse Instâncias do Cloud SQL
Para abrir a página Visão geral de uma instância, clique no nome da instância.
Na seção Manutenção, clique em Editar preferências de manutenção.
Na seção Período de negação de manutenção, clique em Limpar.
Clique em Salvar.

gcloud

Para remover um período de bloqueio de manutenção de uma instância do Cloud SQL, execute o seguinte comando:

gcloud sql instances patch INSTANCE_ID \
--remove-deny-maintenance-period

Substitua as seguintes variáveis:

INSTANCE_ID: ID da instância do Cloud SQL

REST v1

Antes de usar os dados da solicitação, faça as seguintes substituições:

project-id: o ID do projeto
instance-id: o ID da instância

Método HTTP e URL:

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

Corpo JSON da solicitação:

{
  "settings":
  {
    "denyMaintenancePeriods": []
  }
}

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

curl (Linux, macOS ou Cloud Shell)

Salve o corpo da solicitação em um arquivo com o nome request.json e execute o comando a seguir:

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

PowerShell (Windows)

Salve o corpo da solicitação em um arquivo com o nome request.json e execute o comando a seguir:

$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-id" | Select-Object -Expand Content

Você receberá uma resposta JSON semelhante a esta:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "startTime": "08:00",
  "endTime": "08:01",
  "operationType": MAINTENANCE_DENY_PERIOD,
  "name": "operation-id",
  "targetId": "instance-id",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}

REST v1beta4

Antes de usar os dados da solicitação, faça as seguintes substituições:

project-id: o ID do projeto
instance-id: o ID da instância

Método HTTP e URL:

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

Corpo JSON da solicitação:

{
  "settings":
  {
    "denyMaintenancePeriods": []
  }
}

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

curl (Linux, macOS ou Cloud Shell)

Salve o corpo da solicitação em um arquivo com o nome request.json e execute o comando a seguir:

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

PowerShell (Windows)

Salve o corpo da solicitação em um arquivo com o nome request.json e execute o comando a seguir:

$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-id" | Select-Object -Expand Content

Você receberá uma resposta JSON semelhante a esta:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "startTime": "08:00",
  "endTime": "08:01",
  "operationType": MAINTENANCE_DENY_PERIOD,
  "name": "operation-id",
  "targetId": "instance-id",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}

Notificações do período de manutenção de negação

As notificações da janela de manutenção não são enviadas quando o horário de manutenção planejada está dentro do período de bloqueio de manutenção e são proibidas pelas configurações desse período.

Se você alterar as configurações do período de bloqueio de manutenção para impedir a manutenção em um horário programado anteriormente, a instância do Cloud SQL ignorará a manutenção e enviará uma notificação sobre o cancelamento. O Cloud SQL envia esse aviso de cancelamento sempre que a instância é programada para uma atualização.

As notificações de manutenção planejada são enviadas durante o período de manutenção de negação, desde que ela esteja programada para ocorrer fora desse período.

Localizar e definir janelas de manutenção

Antes de começar

Definir uma janela de manutenção em uma instância

Console

gcloud

REST v1

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

REST v1beta4

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

Ativar as notificações de manutenção

Encontrar notificações de manutenção no Console do Google Cloud

Encontrar a manutenção programada usando a API

gcloud

REST v1

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

REST v1beta4

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

Reprogramar manutenção planejada

Console

gcloud

REST v1

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

REST v1beta4

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

Configurar um período de manutenção de negação

Console

gcloud

REST v1

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

REST v1beta4

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

Remover um período de manutenção de negação

Console

gcloud

REST v1

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

REST v1beta4

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

Notificações do período de manutenção de negação

A seguir