Esta página se ha traducido con Cloud Translation API.

Ver y definir ventanas de mantenimiento

En esta página se describen los procedimientos para buscar y configurar ventanas de mantenimiento de instancias de Cloud SQL. Para obtener más información sobre cómo y por qué Cloud SQL realiza el mantenimiento, consulta Actualizaciones de mantenimiento en instancias de Cloud SQL.

Si has habilitado las notificaciones de mantenimiento, Cloud SQL te enviará una notificación por correo cuando haya una actualización de mantenimiento disponible para tu instancia de Cloud SQL. Cloud SQL envía una notificación antes de la implementación del mantenimiento y, a continuación, aplica la actualización a grupos de instancias según una programación semanal. Puedes controlar con cuánta antelación quieres recibir la notificación antes de que tu instancia reciba la actualización de mantenimiento seleccionando el momento del mantenimiento de tu instancia.

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

Si seleccionas Any o no configuras este ajuste, la actualización de mantenimiento puede producirse en cualquier momento, pero suele realizarse durante la primera semana del lanzamiento.
Si seleccionas Week 1 (también denominado preview y canary), la actualización de mantenimiento se realizará entre 7 y 14 días después de que se envíe la notificación de mantenimiento.
Si seleccionas Week 2 (también conocido como production y stable), la actualización de mantenimiento se realizará entre 15 y 21 días después de que se envíe la notificación.
Si seleccionas Week 5, la actualización de mantenimiento se realizará entre 35 y 42 días después de que se envíe la notificación.

Si cambias la configuración de la ventana de mantenimiento mientras la instancia ya está en mantenimiento o se ha programado para mantenimiento, los cambios no se aplicarán de inmediato. Estos cambios se reflejan en los futuros eventos de mantenimiento.

Antes de empezar

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.

Roles required to select or create a project

Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Install the gcloud CLI.

Si utilizas un proveedor de identidades (IdP) externo, primero debes iniciar sesión en la CLI de gcloud con tu identidad federada.

Para inicializar gcloud CLI, ejecuta el siguiente comando:

gcloud init

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

Roles required to select or create a project

Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Install the gcloud CLI.

Si utilizas un proveedor de identidades (IdP) externo, primero debes iniciar sesión en la CLI de gcloud con tu identidad federada.

Para inicializar gcloud CLI, ejecuta el siguiente comando:

gcloud init

Definir una ventana de mantenimiento en una instancia

Consola

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

Ir a Instancias de Cloud SQL
Para abrir la página Overview (Resumen) 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:
- Hora del mantenimiento. Selecciona la semana en la que quieras aplicar la actualización de mantenimiento automática. Tienes las siguientes opciones:
  - Cualquier momento: la actualización de mantenimiento puede realizarse en cualquier momento, pero normalmente se lleva a cabo en la primera semana.
  - Semana 1: el mantenimiento se realiza entre 7 y 14 días después de que se envíe 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íe la notificación.
  - Semana 5: se produce la actualización de mantenimiento Entre 35 y 42 días después de que se envíe la notificación.
- Ventana de mantenimiento. Selecciona el día de la semana y la franja horaria que prefieras. Entre las opciones se incluyen las siguientes:
  - Cualquier ventana: la ventana de mantenimiento predeterminada. La actualización de mantenimiento no está restringida a ningún día de la semana ni a ninguna hora del día concretos.
  - Día de la semana: selecciona un día para la ventana 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 una ventana de mantenimiento y una hora 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

Sustituye 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 quieres que se realice el mantenimiento. Se establece en MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY o SUNDAY. Especifica la zona horaria UTC.
HOUR: la hora del día, 0 - 23, para la ventana de mantenimiento. Especifica la zona horaria UTC.
MAINTENANCE_TIMING: la semana del periodo de lanzamiento del mantenimiento en la que quieres que se aplique la actualización de mantenimiento. Las opciones son:

preview: Esto significa que será la semana 1 después de que se envíe la notificación de mantenimiento. La actualización de mantenimiento se programará entre 7 y 14 días después de la notificación.
production: Esto significa que será la semana 2 después de que se envíe la notificación de mantenimiento. La actualización de mantenimiento se programará entre 15 y 21 días después de la notificación.
week5: La actualización de mantenimiento se programa entre 35 y 42 días después de que se envíe la notificación de mantenimiento.

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

REST v1

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

PROJECT_ID: el ID o el número del proyecto Google Cloud .
INSTANCE_ID: el ID de la instancia, que no puede ser una instancia de réplica de lectura.
HOUR: la hora del día, 0 - 23, para la ventana de mantenimiento. Especifica la zona horaria UTC.
DAY: el día de la semana en el que se realizará la actualización de mantenimiento. Especifica MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY o SUNDAY. Especifica la zona horaria UTC.
MAINTENANCE_TIMING: la semana del periodo de lanzamiento del mantenimiento en la que quieres que se aplique la actualización de mantenimiento. Entre las opciones disponibles se incluyen las siguientes:
- canary: Esto significa que la semana 1 después de que se envíe la notificación de mantenimiento. La actualización de mantenimiento se programará entre 7 y 14 días después de la notificación.
- stable: Esto significa que será la semana 2 después de que se envíe la notificación de mantenimiento. La actualización de mantenimiento se programará entre 15 y 21 días después de la notificación.
- week5: La actualización de mantenimiento se programa entre 35 y 42 días después de que se envíe 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, despliega una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Nota: En el siguiente comando se presupone que has iniciado sesión en la CLI de gcloud con tu cuenta de usuario ejecutando gcloud init o gcloud auth login , o bien usando Cloud Shell, que inicia sesión automáticamente en la CLI de gcloud . Para comprobar qué cuenta está activa, 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 presupone que has iniciado sesión en la CLI de gcloud con tu cuenta de usuario ejecutando gcloud init o gcloud auth login . Para comprobar qué cuenta está activa, 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 siguiente:

{
  "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 los datos de la solicitud, haz las siguientes sustituciones:

PROJECT_ID: el ID o el número del proyecto Google Cloud .
INSTANCE_ID: el ID de la instancia, que no puede ser una instancia de réplica de lectura.
HOUR: la hora del día, 0 - 23, para la ventana de mantenimiento. Especifica la zona horaria UTC.
DAY: el día de la semana en el que quieres que se produzca la actualización de mantenimiento. Especifica MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY o SUNDAY. Especifica la zona horaria UTC.
MAINTENANCE_TIMING: la semana del periodo de lanzamiento del mantenimiento en la que quieres que se aplique la actualización de mantenimiento. Entre las opciones disponibles se incluyen las siguientes:
- canary: Esto significa que la semana 1 después de que se envíe la notificación de mantenimiento. La actualización de mantenimiento se programará entre 7 y 14 días después de la notificación.
- stable: Esto significa que será la semana 2 después de que se envíe la notificación de mantenimiento. La actualización de mantenimiento se programará entre 15 y 21 días después de la notificación.
- week5: La actualización de mantenimiento se programa entre 35 y 42 días después de que se envíe 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, despliega 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 siguiente:

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

Habilitar las notificaciones de mantenimiento

Antes de habilitar las notificaciones de mantenimiento, debes configurar una ventana de mantenimiento en una instancia.

Ve a la página Comunicación. Ir a Comunicación
En la fila de Cloud SQL, Ventana de mantenimiento, selecciona el botón de radio de Correo para activarlo (ON).

Cada usuario que necesite recibir notificaciones debe habilitarlas por separado.

Buscar notificaciones de mantenimiento en la Google Cloud consola

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

En la página Explorador de registros de la Google Cloud consola. Usa el menú desplegable Nombre de todos los registros para buscar maintenance-events y, a continuación, haz clic en Aplicar. Si se ha programado el mantenimiento de una instancia, el registro muestra el nombre de la instancia y la hora de inicio del mantenimiento programado.
Cuando se programa el mantenimiento de una instancia, la fecha se indica en la columna Mantenimiento de la página Instancias. La columna Mantenimiento suele estar oculta, pero se muestra automáticamente cuando se programa el mantenimiento. También puedes seleccionar Mantenimiento en las Opciones de visualización de columnas () si quieres que la columna Mantenimiento se muestre siempre.
También puedes seleccionar una instancia para ir a la página Detalles de la instancia. Si la instancia tiene programado un mantenimiento, verás un mensaje en el panel Mantenimiento.
Ir a instancias de Cloud SQL

Buscar el mantenimiento programado con la API

gcloud

Para comprobar si hay tareas de mantenimiento programadas, usa el siguiente comando:

gcloud sql instances describe INSTANCE_ID

Sustituye la siguiente variable:

INSTANCE_ID: la instancia en la que se va a comprobar si hay mantenimiento programado.

En la respuesta, busca la sección scheduledMaintenance.

REST v1

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

PROJECT_ID: el ID o el número de proyecto del Google Cloud proyecto que contiene la instancia
INSTANCE_NAME: el nombre de la instancia que estás configurando para la alta disponibilidad

Método HTTP y URL:

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

Para enviar tu solicitud, despliega una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Ejecuta el comando siguiente:

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 comando siguiente:

$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 siguiente:

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

En la respuesta, busca la sección scheduledMaintenance.

REST v1beta4

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

PROJECT_ID: el ID o el número de proyecto del Google Cloud proyecto que contiene la instancia
INSTANCE_NAME: el nombre de la instancia que estás configurando para la alta disponibilidad

Método HTTP y URL:

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

Para enviar tu solicitud, despliega una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Ejecuta el comando siguiente:

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 comando siguiente:

$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 siguiente:

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

En la respuesta, busca la sección scheduledMaintenance.

Reprogramar el mantenimiento planificado

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

Si configura el periodo de mantenimiento de su instancia en la semana 1 o en la semana 2, puede reprogramar el mantenimiento hasta 28 días.

Si programas el mantenimiento de tu instancia para la semana 5, puedes cambiar la fecha hasta 7 días. Debes reprogramar el mantenimiento en este periodo para asegurarte de que la instancia reciba la actualización de mantenimiento antes de que empiece el próximo lanzamiento trimestral.

Consola

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

Ir a Instancias de Cloud SQL
Filtra por el término Mantenimiento para ver todas las instancias cuyo mantenimiento está programado.
En la columna Mantenimiento, haga clic en Reprogramar.
En el cuadro de diálogo Reprogramar, elige si quieres aplicar el mantenimiento inmediatamente, reprogramarlo para que se realice a una hora específica dentro del periodo de aplazamiento permitido, tal como se define en Mantenimiento programado reprogramado, o aplazarlo hasta la próxima ventana 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]

Sustituye las siguientes variables:

INSTANCE_ID: la instancia que se va a reprogramar.
RESCHEDULE_TYPE: Use uno de los siguientes valores: IMMEDIATE, NEXT_AVAILABLE_WINDOW o SPECIFIC_TIME.
Si eliges NEXT_AVAILABLE_WINDOW, el mantenimiento se reprograma para la siguiente ventana de mantenimiento disponible después de la hora programada actual.
RESCHEDULE_TIME: Si especifica SPECIFIC_TIME para RESCHEDULE_TYPE, también debe definir la marca --schedule-time para especificar el nuevo día y hora en los que se realizará el mantenimiento. 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 quieres reprogramar el mantenimiento hasta 28 días, comprueba 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 los datos de la solicitud, haz las siguientes sustituciones:

PROJECT_ID: el ID del proyecto
INSTANCE_ID: el ID de instancia.
RESCHEDULE_TYPE: Use uno de los siguientes valores: IMMEDIATE, NEXT_AVAILABLE_WINDOW o SPECIFIC_TIME.
Si eliges NEXT_AVAILABLE_WINDOW, el mantenimiento se reprogramará para la siguiente ventana 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, despliega 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 siguiente:

{
  "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 los datos de la solicitud, haz las siguientes sustituciones:

PROJECT_ID: el ID del proyecto
INSTANCE_ID: el ID de instancia.
RESCHEDULE_TYPE: Use uno de los siguientes valores: IMMEDIATE, NEXT_AVAILABLE_WINDOW o SPECIFIC_TIME.
Si eliges NEXT_AVAILABLE_WINDOW, el mantenimiento se reprogramará para la siguiente ventana 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, despliega 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 siguiente:

{
  "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 cómo se construye la solicitud de la API REST subyacente para esta tarea, consulta el Explorador de APIs en la página instances:post.

Configurar un periodo de mantenimiento denegado

Puede configurar un máximo de un periodo de mantenimiento denegado en una instancia de Cloud SQL en cualquier momento. El periodo de mantenimiento rechazado tiene prioridad sobre cualquier ventana de mantenimiento programada. Si hay un conflicto entre el periodo de una ventana de mantenimiento y el periodo de rechazo del mantenimiento, este último prevalecerá sobre la ventana de mantenimiento.

Puedes eliminar manualmente un periodo de mantenimiento denegado, tanto si ya ha tenido lugar como si no.

Para configurar un periodo de mantenimiento denegado, define su fecha de inicio, su fecha de finalización y la hora del día en que empieza y termina el intervalo. El periodo de mantenimiento rechazado puede durar entre 1 y 90 días.

En el caso de las fechas de inicio y de finalización, hay dos formatos:

yyyy-mm-dd: indica una fecha concreta.
mm-dd: indica una fecha que se repite cada año.

Las fechas de inicio y finalización están en UTC. Para definir la zona horaria, usa el campo de hora para ajustar la hora de inicio. Por ejemplo, si la fecha de inicio es el 10 de octubre del 2020 y la hora es las 07:00:00, se indica la hora de inicio 2020-10-10 07:00:00 UTC (2020-10-10 00:00:00 PST).

En el caso de la hora, el formato es HH:mm:SS.

Las horas deben estar entre 0 y 23 (ambos incluidos).
Los minutos y los segundos deben estar entre 0 y 59 (ambos inclusive).

Consola

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

Ir a Instancias de Cloud SQL
Para abrir la página Overview (Resumen) de una instancia, haz clic en su nombre.
En la sección Mantenimiento, haz clic en Editar preferencias de mantenimiento.
En la sección Deny maintenance period (Denegar periodo de mantenimiento), define 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 periodo de mantenimiento denegado 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

Sustituye las siguientes variables:

INSTANCE_ID: ID de instancia de Cloud SQL
START_DATE: fecha en la que empieza el intervalo. Por ejemplo, 2021-11-29
END_DATE: fecha en la que finaliza el intervalo. Por ejemplo, 2021-12-02
TIME: hora del día en la que empieza y termina el intervalo. Por ejemplo: 00:00:00

REST v1

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

project-id: el ID del proyecto
instance-id: el ID de instancia.
start-date: la fecha de inicio (aaaa-mm-dd) o (mm-dd) de la recurrencia anual.
end-date: fecha de finalización (aaaa-mm-dd) o (mm-dd) de la recurrencia anual.
time: la hora de inicio y de 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, despliega 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 siguiente:

{
  "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 los datos de la solicitud, haz las siguientes sustituciones:

project-id: el ID del proyecto
instance-id: el ID de instancia.
start-date: la fecha de inicio (aaaa-mm-dd) o (mm-dd) de la recurrencia anual.
end-date: fecha de finalización (aaaa-mm-dd) o (mm-dd) de la recurrencia anual.
time: la hora de inicio y de 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, despliega 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 siguiente:

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

Eliminar un periodo de mantenimiento denegado

Consola

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

Ir a Instancias de Cloud SQL
Para abrir la página Overview (Resumen) de una instancia, haz clic en su nombre.
En la sección Mantenimiento, haz clic en Editar preferencias de mantenimiento.
En la sección Denegar periodo de mantenimiento, haz clic en Borrar.
Haz clic en Guardar.

gcloud

Para quitar un periodo de mantenimiento denegado de una instancia de Cloud SQL, ejecuta el siguiente comando:

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

Sustituye las siguientes variables:

INSTANCE_ID: ID de instancia de Cloud SQL

REST v1

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

project-id: el ID del proyecto
instance-id: el ID de 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, despliega 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 siguiente:

{
  "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 los datos de la solicitud, haz las siguientes sustituciones:

project-id: el ID del proyecto
instance-id: el ID de 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, despliega 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 siguiente:

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

Rechazar notificaciones de periodo de mantenimiento

Las notificaciones de la ventana de mantenimiento no se envían cuando el tiempo de mantenimiento planificado se incluye en el periodo de rechazo del mantenimiento y está prohibido por los ajustes de dicho periodo.

Si cambias la configuración del periodo de rechazo del mantenimiento para evitar que se realice a una hora programada anteriormente, la instancia de Cloud SQL omitirá el mantenimiento y enviará una notificación sobre la cancelación. Cloud SQL envía esta notificación de cancelación cada vez que se programa una actualización de la instancia.

Las notificaciones de mantenimiento planificado se envían durante el periodo de denegación de mantenimiento, siempre que dicho mantenimiento esté programado para realizarse fuera de ese periodo.

Ver y definir ventanas de mantenimiento Organízate con las colecciones Guarda y clasifica el contenido según tus preferencias.

Antes de empezar

Definir una ventana 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)

Habilitar las notificaciones de mantenimiento

Buscar notificaciones de mantenimiento en la Google Cloud consola

Buscar el mantenimiento programado con la API

gcloud

REST v1

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

REST v1beta4

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

Reprogramar 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)

Configurar un periodo de mantenimiento denegado

Consola

gcloud

REST v1

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

REST v1beta4

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

Eliminar un periodo de mantenimiento denegado

Consola

gcloud

REST v1

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

REST v1beta4

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

Rechazar notificaciones de periodo de mantenimiento

Siguientes pasos

Ver y definir ventanas de mantenimiento