Buscar y configurar períodos de mantenimiento

MySQL | PostgreSQL | SQL Server

En esta página, se muestran procedimientos a fin de encontrar y configurar períodos de mantenimiento para instancias de Cloud SQL. Para obtener más información sobre cómo y por qué Cloud SQL realiza el mantenimiento, consulta la descripción general del mantenimiento en instancias de Cloud SQL.

Si habilitaste la recepción de notificaciones de mantenimiento, Cloud SQL te envía una notificación por correo electrónico cuando hay una actualización de mantenimiento disponible para tu instancia de Cloud SQL. Cloud SQL envía una notificación antes del lanzamiento de mantenimiento y, luego, aplica la actualización a grupos de instancias con una programación semanal. Puedes controlar cuánta notificación previa recibes antes de que la instancia reciba la actualización de mantenimiento si seleccionas el tiempo de mantenimiento de la instancia.

Tienes las siguientes opciones para programar el horario de la actualización de mantenimiento:

Si seleccionas Any o no estableces esta configuración, la actualización de mantenimiento puede ocurrir en cualquier momento, pero, por lo general, se realiza durante la primera semana del lanzamiento.
Si seleccionas Week 1 (también conocida como preview y canary), la actualización de mantenimiento se realiza entre 7 y 14 días después de que se envía la notificación de mantenimiento.
Si seleccionas Week 2 (también conocida como production y stable), la actualización de mantenimiento se realiza entre 15 y 21 días después de que se envía la notificación.
Si seleccionas Week 5, la actualización de mantenimiento se realiza entre 35 y 42 días después de que se envía la notificación.

Si realizas cambios en la configuración del período de mantenimiento mientras la instancia ya está en mantenimiento o está programada para mantenimiento, los cambios no se aplicarán de inmediato. Estos cambios se reflejan en los eventos de mantenimiento futuros.

Antes de comenzar

Accede a tu cuenta de Google Cloud. Si eres nuevo en Google Cloud, crea una cuenta para evaluar el rendimiento de nuestros productos en situaciones reales. Los clientes nuevos también obtienen $300 en créditos gratuitos para ejecutar, probar y, además, implementar cargas de trabajo.

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

Go to project selector

Asegúrate de que la facturación esté habilitada para tu proyecto de Google Cloud.

Instala Google Cloud CLI.

Para inicializar la CLI de gcloud, ejecuta el siguiente comando:

gcloud init

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

Go to project selector

Asegúrate de que la facturación esté habilitada para tu proyecto de Google Cloud.

Instala Google Cloud CLI.

Para inicializar la CLI de gcloud, ejecuta el siguiente comando:

gcloud init

Configura un período de mantenimiento en una instancia

Consola

En la consola de Google Cloud, ve a la página Instancias de Cloud SQL.

Ir a Instancias de Cloud SQL
Para abrir la página de Descripción general de una instancia, haz clic en su nombre.
En la sección Mantenimiento, haz clic en Editar preferencias de mantenimiento.
En la sección Opciones de configuración, abre Mantenimiento.
Configura las siguientes opciones:
- Horario de mantenimiento. Selecciona la semana para aplicar la actualización de mantenimiento automática. Tienes las siguientes opciones:
  - Cualquiera: La actualización de mantenimiento puede realizarse en cualquier momento, pero suele ocurrir dentro de la Semana 1.
  - Semana 1: El mantenimiento se realiza entre 7 y 14 días después de que se envía la notificación de mantenimiento.
  - Semana 2: La actualización de mantenimiento se realiza entre 15 y 21 días después de que se envía la notificación.
  - Semana 5: La actualización de mantenimiento se realiza entre 35 y 42 días después de que se envía la notificación.
- Período de mantenimiento. Selecciona un día de la semana y un período que prefieras. Las opciones incluyen las siguientes:
  - Cualquier período: Es el período de mantenimiento predeterminado. La actualización de mantenimiento no está restringida a ningún día de la semana o a una hora del día específicos.
  - Día de la semana: Selecciona un día para el período de mantenimiento sábado. Domingo, lunes, martes, miércoles, jueves o viernes.
  - Hora del día: si seleccionas un día de la semana, también puedes elegir una hora del día. Selecciona un intervalo de una hora en tu zona horaria local.

gcloud

Para configurar un período de mantenimiento y los tiempos de mantenimiento en una instancia de Cloud SQL, ejecuta el siguiente comando:

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

Reemplaza las siguientes variables:

INSTANCE_ID: el ID de la instancia, que puede ser una instancia de réplica de lectura.
DAY: El día de la semana en el que deseas que se realice el mantenimiento. Establece como MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY o SUNDAY. Especifica en la zona horaria UTC.
HOUR: Es la hora del día, de 0 a 23 para el período de mantenimiento. Especifica en la zona horaria UTC.
MAINTENANCE_TIMING: la semana del período de lanzamiento de mantenimiento que deseas. la actualización de mantenimiento que se aplicará. Se incluyen las siguientes opciones:

preview: Esto se traduce como la semana 1 después de que se envía la notificación de mantenimiento. La actualización de mantenimiento está programada entre 7 y 14 días después de la notificación.
production: Esto se traduce como la semana 2 después de que se envía la notificación de mantenimiento. La actualización de mantenimiento está programada entre 15 y 21 días después de la notificación.
week5: La actualización de mantenimiento está programada entre 35 y 42 días después de que se envía la notificación de mantenimiento.

Para obtener información de referencia, consulta gcloud sql instances patch.

REST v1

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

PROJECT_ID: Es el ID o el número del proyecto de Google Cloud.
INSTANCE_ID: Es el ID de la instancia, que no puede ser una instancia de réplica de lectura.
HOUR: Es la hora del día, de 0 a 23 para el período de mantenimiento. Especifica en la zona horaria UTC.
DAY: Es el día de la semana en que se realizará la actualización de mantenimiento. Especifica MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY o SUNDAY. Especifica en la zona horaria UTC.
MAINTENANCE_TIMING: la semana del período de lanzamiento de mantenimiento que deseas. la actualización de mantenimiento que se aplicará. Se incluyen las siguientes opciones:
- canary: Esto se traduce como la semana 1 después de que se envía la notificación de mantenimiento. La actualización de mantenimiento está programada entre 7 y 14 días después de la notificación.
- stable: Esto se traduce como la semana 2 después de que se envía la notificación de mantenimiento. La actualización de mantenimiento está programada entre 15 y 21 días después de la notificación.
- week5: La actualización de mantenimiento está programada entre 35 y 42 días después de que se envía la notificación de mantenimiento.

Método HTTP y URL:

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

Cuerpo JSON de la solicitud:

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

Para enviar tu solicitud, expande una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Nota: Con el siguiente comando, se supone que accediste a la CLI de gcloud con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login, o a través del uso de Cloud Shell, que accede de forma automática a la CLI de gcloud. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente 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
"

PowerShell (Windows)

Nota: El siguiente comando supone que accediste a la CLI de gcloud con tu cuenta de usuario mediante la ejecución de gcloud init o gcloud auth login. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente 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
" | Select-Object -Expand Content

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

{
  "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 cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

PROJECT_ID: Es el ID o el número del proyecto de Google Cloud.
INSTANCE_ID: Es el ID de la instancia, que no puede ser una instancia de réplica de lectura.
HOUR: Es la hora del día, de 0 a 23 para el período de mantenimiento. Especifica en la zona horaria UTC.
DAY: El día de la semana en el que deseas que se realice la actualización de mantenimiento. Especifica MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY o SUNDAY. Especifica en la zona horaria UTC.
MAINTENANCE_TIMING: la semana del período de lanzamiento de mantenimiento que deseas. la actualización de mantenimiento que se aplicará. Se incluyen las siguientes opciones:
- canary: Esto se traduce como la semana 1 después de que se envía la notificación de mantenimiento. La actualización de mantenimiento está programada entre 7 y 14 días después de la notificación.
- stable: Esto se traduce como la semana 2 después de que se envía la notificación de mantenimiento. La actualización de mantenimiento está programada entre 15 y 21 días después de la notificación.
- week5: La actualización de mantenimiento está programada entre 35 y 42 días después de que se envía la notificación de mantenimiento.

Método HTTP y URL:

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

Cuerpo JSON de la solicitud:

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

Para enviar tu solicitud, expande una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente 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
"

PowerShell (Windows)

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente 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
" | Select-Object -Expand Content

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

{
  "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"
}

Habilita las notificaciones de mantenimiento

Antes de habilitar la opción para recibir notificaciones de mantenimiento, debes configurar un período de mantenimiento en una instancia

Ve a la página Comunicación. Ir a Comunicación
En la fila de Cloud SQL, Período de mantenimiento, selecciona el botón de selección en Correo electrónico para activarlo.

Cada usuario que deba recibir notificaciones debe habilitar la opción por separado.

Busca notificaciones de mantenimiento en la consola de Google Cloud

Puedes ver las notificaciones de mantenimiento en algunos lugares de la consola de Google Cloud:

En el panel ACTIVIDAD, busca las instancias marcadas con Mantenimiento de SQL.
Ir a la Actividad
Cuando una instancia está programada para mantenimiento, la fecha de mantenimiento aparece en la página Instancias en la columna Mantenimiento. La columna Mantenimiento suele estar oculta, pero se muestra de forma automática cuando se programa el mantenimiento. También puedes seleccionar Mantenimiento en las Opciones de visualización de columnas () si deseas que la columna Mantenimiento aparezca siempre.
Como alternativa, puedes seleccionar una instancia para ir a la página Detalles de la instancia. Si la instancia está programada para mantenimiento, verás un mensaje en el panel Mantenimiento.
Ir a Instancias de Cloud SQL

Busca el mantenimiento programado mediante la API

gcloud

Para verificar el próximo mantenimiento programado, usa el siguiente comando:

gcloud sql instances describe INSTANCE_ID

Reemplaza la siguiente variable:

INSTANCE_ID: La instancia en la que se debe verificar el mantenimiento programado.

En la respuesta, busca la sección scheduledMaintenance:

REST v1

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

PROJECT_ID: el ID o el número del proyecto de Google Cloud que contiene la instancia
INSTANCE_NAME: el nombre de la instancia que configuras para obtener alta disponibilidad

Método HTTP y URL:

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

Para enviar tu solicitud, expande una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Ejecuta el siguiente 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)

Ejecuta el siguiente 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

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

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

En la respuesta, busca la sección scheduledMaintenance:

REST v1beta4

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

PROJECT_ID: el ID o el número del proyecto de Google Cloud que contiene la instancia
INSTANCE_NAME: el nombre de la instancia que configuras para obtener alta disponibilidad

Método HTTP y URL:

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

Para enviar tu solicitud, expande una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Ejecuta el siguiente 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)

Ejecuta el siguiente 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

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

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

En la respuesta, busca la sección scheduledMaintenance:

Reprograma el mantenimiento planificado

Puedes reprogramar el mantenimiento con la consola de Google Cloud, la gcloud CLI o la API de Cloud SQL Admin.

Si configuras los horarios de mantenimiento de la instancia en la semana 1 o la semana 2, puedes reprogramar el mantenimiento hasta por 28 días.

Si configuras los horarios de mantenimiento de tu instancia en la semana 5, puedes reprogramar el mantenimiento hasta por 7 días. Debes reprogramar el mantenimiento dentro de este período para asegurarte de que la instancia reciba la actualización de mantenimiento antes de que comience el siguiente lanzamiento de mantenimiento trimestral.

Consola

En la consola de Google Cloud, ve a la página Instancias de Cloud SQL.

Ir a Instancias de Cloud SQL
Filtra el término Mantenimiento a fin de enumerar todas las instancias programadas para mantenimiento.
En la columna Mantenimiento, haz clic en Reprogramar.
En el cuadro de diálogo Reprogramar, selecciona si deseas aplicar el mantenimiento de inmediato, reprogramarlo para que se realice en un momento específico dentro del período de aplazamiento permitido, como se define en mantenimiento planificado reprogramado. aplazar al siguiente período de mantenimiento disponible.

gcloud

Para reprogramar el mantenimiento de una instancia de Cloud SQL, ejecuta el siguiente comando:

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

Reemplaza las siguientes variables:

INSTANCE_ID: Es la instancia que se reprogramará.
RESCHEDULE_TYPE: Usa una de las siguientes opciones: IMMEDIATE, NEXT_AVAILABLE_WINDOW o SPECIFIC_TIME.
Si eliges NEXT_AVAILABLE_WINDOW, el mantenimiento se reprograma al siguiente período de mantenimiento disponible después de la hora programada actual.
RESCHEDULE_TIME: If you specify SPECIFIC_TIME for RESCHEDULE_TYPE, then you also need to set the --schedule-time flag to specify the new day and time for maintenance to ocurrir. Usa el formato ISO 8601. Por ejemplo, 2020-01-16T16:56:00.000Z.

Para obtener información de referencia, consulta gcloud sql reschedule-maintenance.

Si deseas reprogramar el mantenimiento por hasta 28 días, verifica el número de versión de gcloud. Si el número de versión es inferior a 390.0.0_RC00, vuelve a instalar gcloud.

REST v1

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

PROJECT_ID: el ID del proyecto
INSTANCE_ID: El ID de la instancia
RESCHEDULE_TYPE: Usa una de las siguientes opciones: IMMEDIATE, NEXT_AVAILABLE_WINDOW o SPECIFIC_TIME.
Si eliges NEXT_AVAILABLE_WINDOW, el mantenimiento se reprograma al siguiente período de mantenimiento disponible.

Método HTTP y URL:

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

Cuerpo JSON de la solicitud:

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

Para enviar tu solicitud, expande una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente 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_ID/rescheduleMaintenance
"

PowerShell (Windows)

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente 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_ID/rescheduleMaintenance
" | Select-Object -Expand Content

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

{
  "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 cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

PROJECT_ID: el ID del proyecto
INSTANCE_ID: El ID de la instancia
RESCHEDULE_TYPE: Usa una de las siguientes opciones: IMMEDIATE, NEXT_AVAILABLE_WINDOW o SPECIFIC_TIME.
Si eliges NEXT_AVAILABLE_WINDOW, el mantenimiento se reprograma al siguiente período de mantenimiento disponible.

Método HTTP y URL:

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

Cuerpo JSON de la solicitud:

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

Para enviar tu solicitud, expande una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente 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_ID/rescheduleMaintenance
"

PowerShell (Windows)

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente 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_ID/rescheduleMaintenance
" | Select-Object -Expand Content

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

{
  "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"
}

Si quieres ver cómo se crea la solicitud a la API de REST subyacente para esta tarea, consulta el Explorador de API en la página de instances:post.

Configura un rechazo del período de mantenimiento

Puedes configurar un máximo de un rechazo del período de mantenimiento en una instancia de Cloud SQL en cualquier momento. El período de rechazo del mantenimiento tiene prioridad sobre los períodos de mantenimiento programados. Si hay un conflicto entre el momento de un período de mantenimiento y el período de mantenimiento rechazado, el período de rechazo anula el de mantenimiento.

Puedes quitar de forma manual un rechazo del período de mantenimiento, ya sea que se haya llevado a cabo o no.

Para configurar un rechazo del período de mantenimiento, configura la fecha de inicio, la fecha de finalización y la hora del día en que comienza y termina el intervalo. Un rechazo del período de mantenimiento puede extenderse de uno a 90 días.

Existen dos formatos para la fecha de inicio y de finalización:

yyyy-mm-dd: Indica una fecha específica.
mm-dd: Indica una fecha recurrente cada año

La fecha de inicio y de finalización tienen el formato UTC. A fin de configurar la zona horaria, usa el campo de hora para ajustar la hora de inicio. Por ejemplo, la fecha de inicio = 2020-10-10 y la hora = 07:00:00 indican que la hora de inicio es 2020-10-10 07:00:00 UTC (2020-10-10 00:00:00 PST).

Para la hora, el formato es: HH:mm:SS.

Los valores de las horas deben estar entre 0 y 23 (inclusive).
Los minutos y los segundos deben estar entre 0 y 59 (inclusive).

Consola

En la consola de Google Cloud, ve a la página Instancias de Cloud SQL.

Ir a Instancias de Cloud SQL
Para abrir la página de Descripción general de una instancia, haz clic en su nombre.
En la sección Mantenimiento, haz clic en Editar preferencias de mantenimiento.
En la sección Período de rechazo del mantenimiento, configura las fechas de inicio y finalización.
En la sección Opciones avanzadas, puedes seleccionar Repetir cada año.
Haz clic en Guardar.

gcloud

Para configurar un rechazo del período de mantenimiento en una instancia de Cloud SQL, ejecuta el siguiente 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

Reemplaza las siguientes variables:

INSTANCE_ID: ID de la instancia de Cloud SQL
START_DATE: Es la fecha en la que comienza el intervalo. Por ejemplo: 29-11-2021.
END_DATE: Es la fecha en la que finaliza el intervalo. Por ejemplo: 02-12-2021.
TIME: Es la hora del día para el inicio y la finalización del intervalo. Por ejemplo, 00:00:00.

REST v1

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

project-id: el ID del proyecto
instance-id: Es el ID de la instancia.
start-date: Es la fecha de inicio (dd-mm-aaaa), o (dd-mm) para la recurrencia anual.
end-date: Es la fecha de finalización (dd-mm-aaaa), o (dd-mm) para la recurrencia anual.
time: Es la hora de inicio y finalización (HH:mm:SS).

Método HTTP y URL:

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

Cuerpo JSON de la solicitud:

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

Para enviar tu solicitud, expande una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente 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-id"

PowerShell (Windows)

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente 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-id" | Select-Object -Expand Content

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

{
  "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 cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

project-id: el ID del proyecto
instance-id: Es el ID de la instancia.
start-date: Es la fecha de inicio (dd-mm-aaaa), o (dd-mm) para la recurrencia anual.
end-date: Es la fecha de finalización (dd-mm-aaaa), o (dd-mm) para la recurrencia anual.
time: Es la hora de inicio y finalización (HH:mm:SS).

Método HTTP y URL:

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

Cuerpo JSON de la solicitud:

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

Para enviar tu solicitud, expande una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente 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-id"

PowerShell (Windows)

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente 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-id" | Select-Object -Expand Content

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

{
  "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"
}

Quita un rechazo del período de mantenimiento

Consola

En la consola de Google Cloud, ve a la página Instancias de Cloud SQL.

Ir a Instancias de Cloud SQL
Para abrir la página de Descripción general de una instancia, haz clic en su nombre.
En la sección Mantenimiento, haz clic en Editar preferencias de mantenimiento.
En la sección Rechazar período de mantenimiento, haz clic en Borrar.
Haz clic en Guardar.

gcloud

Para quitar un rechazo del período de mantenimiento de una instancia de Cloud SQL, ejecuta el siguiente comando:

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

Reemplaza las siguientes variables:

INSTANCE_ID: ID de la instancia de Cloud SQL

REST v1

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

project-id: el ID del proyecto
instance-id: El ID de la instancia

Método HTTP y URL:

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

Cuerpo JSON de la solicitud:

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

Para enviar tu solicitud, expande una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente 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-id"

PowerShell (Windows)

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente 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-id" | Select-Object -Expand Content

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

{
  "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 cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

project-id: el ID del proyecto
instance-id: El ID de la instancia

Método HTTP y URL:

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

Cuerpo JSON de la solicitud:

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

Para enviar tu solicitud, expande una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente 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-id"

PowerShell (Windows)

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente 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-id" | Select-Object -Expand Content

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

{
  "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"
}

Notificaciones del rechazo del período de mantenimiento

Las notificaciones del período de mantenimiento no se envían cuando el tiempo de mantenimiento planificado se encuentra dentro del rechazo del período de mantenimiento y están prohibidas por la configuración del rechazo del período de mantenimiento.

Si cambias la configuración del período de rechazo del mantenimiento para evitar el mantenimiento en un momento programado con anterioridad, la instancia de Cloud SQL omite el mantenimiento y envía una notificación sobre la cancelación del mantenimiento. Cloud SQL envía este aviso de cancelación cada vez que la instancia tiene programada una actualización.

Las notificaciones de mantenimiento planificado se envían durante el rechazo del período de mantenimiento, siempre que ese mantenimiento esté programado fuera de ese período.

Buscar y configurar períodos de mantenimiento

Antes de comenzar

Configura un período de mantenimiento en una instancia

Consola

gcloud

REST v1

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

REST v1beta4

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

Habilita las notificaciones de mantenimiento

Busca notificaciones de mantenimiento en la consola de Google Cloud

Busca el mantenimiento programado mediante la API

gcloud

REST v1

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

REST v1beta4

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

Reprograma el mantenimiento planificado

Consola

gcloud

REST v1

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

REST v1beta4

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

Configura un rechazo del período de mantenimiento

Consola

gcloud

REST v1

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

REST v1beta4

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

Quita un rechazo del período de mantenimiento

Consola

gcloud

REST v1

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

REST v1beta4

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

Notificaciones del rechazo del período de mantenimiento

¿Qué sigue?