Rechercher et définir des intervalles de maintenance

MySQL | PostgreSQL | SQL Server

Cette page contient des procédures permettant de rechercher et de définir des intervalles de maintenance pour les instances Cloud SQL. Pour savoir comment et pourquoi Cloud SQL effectue des opérations de maintenance, consultez la page Présentation de la maintenance des instances Cloud SQL.

Si vous avez activé la réception des notifications de maintenance, Cloud SQL vous envoie une notification par e-mail lorsqu'une mise à jour de maintenance est disponible pour votre instance Cloud SQL. Cloud SQL envoie une notification avant le déploiement de la maintenance, puis applique la mise à jour aux groupes d'instances une fois par semaine. Vous pouvez contrôler le délai de notification avant que votre instance ne reçoive la mise à jour de maintenance en sélectionnant le calendrier de maintenance de votre instance.

Vous disposez des options suivantes pour déterminer la planification de votre mise à jour de maintenance :

Si vous sélectionnez Any ou si vous ne configurez pas ce paramètre, la mise à jour de maintenance peut avoir lieu à tout moment, mais généralement au cours de la première semaine du déploiement.
Si vous sélectionnez Week 1 (également appelé preview et canary), la mise à jour de maintenance a lieu 7 à 14 jours après l'envoi de la notification de maintenance.
Si vous sélectionnez Week 2 (également appelé production et stable), la mise à jour de maintenance a lieu 15 à 21 jours après l'envoi de la notification.
Si vous sélectionnez Week 5, la mise à jour de maintenance a lieu 35 à 42 jours après l'envoi de la notification.

Si vous modifiez le paramètre d'intervalle de maintenance alors que la maintenance de l'instance est déjà en cours ou planifiée, ces modifications ne prennent pas effet immédiatement. Ces modifications seront reflétées dans les futurs événements de maintenance.

Avant de commencer

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

Définir un intervalle de maintenance sur une instance

Console

Dans Google Cloud Console, accédez à la page Instances Cloud SQL.

Accéder à la page Instances Cloud SQL
Pour ouvrir la page Présentation d'une instance, cliquez sur son nom.
Dans la section Maintenance, cliquez sur Modifier les préférences de maintenance.
Dans la section Options de configuration, ouvrez Maintenance.
Configurez les options ci-dessous :
- Planification des maintenances Sélectionnez la semaine d'application de la mise à jour de maintenance automatique. Vous avez le choix entre les options suivantes :
  - Toutes : la mise à jour de maintenance peut avoir lieu à tout moment, mais a généralement lieu au cours de la semaine 1.
  - Semaine 1 : la maintenance a lieu 7 à 14 jours après l'envoi de la notification de maintenance.
  - Semaine 2 : la mise à jour de la maintenance a lieu 15 à 21 jours après l'envoi de la notification.
  - Semaine 5 : la mise à jour de maintenance a lieu 35 à 42 jours après l'envoi de la notification.
- Intervalle de maintenance : Sélectionnez le jour de la semaine et l'intervalle de votre choix. Vous avez le choix entre plusieurs options :
  - N'importe quel intervalle : intervalle de maintenance par défaut. La mise à jour de maintenance ne se limite à aucun jour de la semaine ni heure spécifique de la journée.
  - Jour de la semaine : sélectionnez un jour pour votre intervalle de maintenance : samedi, dimanche, lundi, mardi, mercredi, jeudi ou vendredi.
  - Heure de la journée : si vous sélectionnez un jour de la semaine, vous pouvez également choisir une heure de la journée. Sélectionnez un intervalle d'une heure dans votre fuseau horaire local.

gcloud

Pour configurer un intervalle et une planification de maintenance sur une instance Cloud SQL, exécutez la commande suivante :

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

Remplacez les variables suivantes :

INSTANCE_ID : ID de l'instance, qui peut être une instance répliquée avec accès en lecture
DAY : jour de la semaine pendant lequel vous souhaitez que la maintenance soit effectuée. Choisissez MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY ou SUNDAY. Spécifiez le fuseau horaire UTC.
HOUR : heure de la journée, 0 – 23, pour l'intervalle de maintenance. Indiquez le fuseau horaire UTC.
MAINTENANCE_TIMING : semaine de la période de déploiement de la maintenance au cours de laquelle vous souhaitez que la mise à jour de maintenance soit appliquée. Plusieurs options sont disponibles :

preview : correspond à la semaine 1 après l'envoi de la notification de maintenance. La mise à jour de maintenance est planifiée entre 7 et 14 jours après la notification.
production : cela correspond à la semaine 2 après l'envoi de la notification de maintenance. La mise à jour de maintenance est planifiée entre 15 et 21 jours après la notification.
week5 : la mise à jour de maintenance est planifiée 35 à 42 jours après l'envoi de la notification de maintenance.

Pour plus d'informations, consultez la page sur gcloud sql instances patch.

REST v1

Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :

PROJECT_ID : ID ou numéro de projet du projet Google Cloud.
INSTANCE_ID : ID de l'instance, qui ne peut pas être une instance répliquée avec accès en lecture.
HOUR : heure de la journée, 0 – 23, pour l'intervalle de maintenance. Indiquez le fuseau horaire UTC.
DAY : jour de la semaine de la mise à jour de maintenance. Spécifiez MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY ou SUNDAY. Spécifiez le fuseau horaire UTC.
MAINTENANCE_TIMING : semaine de la période de déploiement de la maintenance au cours de laquelle vous souhaitez que la mise à jour de maintenance soit appliquée. Plusieurs options sont disponibles :
- canary : cela correspond à la semaine 1 après l'envoi de la notification de maintenance. La mise à jour de maintenance est planifiée entre 7 et 14 jours après la notification.
- stable : correspond à la semaine 2 après l'envoi de la notification de maintenance. La mise à jour de maintenance est planifiée entre 15 et 21 jours après la notification.
- week5 : la mise à jour de maintenance est planifiée 35 à 42 jours après l'envoi de la notification de maintenance.

Méthode HTTP et URL :

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

Corps JSON de la requête :

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

Pour envoyer votre requête, développez l'une des options suivantes :

curl (Linux, macOS ou Cloud Shell)

Remarque : La commande suivante suppose que vous êtes connecté à la CLI gcloud avec votre compte utilisateur en exécutant la commande gcloud init ou gcloud auth login, ou en utilisant Cloud Shell, qui vous connecte automatiquement à la CLI gcloud. Vous pouvez exécuter la commande gcloud auth list pour vérifier quel est le compte actuellement actif.

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

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)

Remarque : La commande suivante suppose que vous vous êtes connecté à la CLI gcloud avec votre compte utilisateur en exécutant la commande gcloud init ou gcloud auth login. Vous pouvez exécuter la commande gcloud auth list pour vérifier quel est le compte actuellement actif.

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

$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

Vous devriez recevoir une réponse JSON de ce type :

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

Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :

PROJECT_ID : ID ou numéro de projet du projet Google Cloud.
INSTANCE_ID : ID de l'instance, qui ne peut pas être une instance répliquée avec accès en lecture.
HOUR : heure de la journée, 0 – 23, pour l'intervalle de maintenance. Indiquez le fuseau horaire UTC.
DAY : jour de la semaine pendant lequel vous souhaitez que la mise à jour de maintenance ait lieu. Spécifiez MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY ou SUNDAY. Spécifiez le fuseau horaire UTC.
MAINTENANCE_TIMING : semaine de la période de déploiement de la maintenance au cours de laquelle vous souhaitez que la mise à jour de maintenance soit appliquée. Plusieurs options sont disponibles :
- canary : cela correspond à la semaine 1 après l'envoi de la notification de maintenance. La mise à jour de maintenance est planifiée entre 7 et 14 jours après la notification.
- stable : correspond à la semaine 2 après l'envoi de la notification de maintenance. La mise à jour de maintenance est planifiée entre 15 et 21 jours après la notification.
- week5 : la mise à jour de maintenance est planifiée 35 à 42 jours après l'envoi de la notification de maintenance.

Méthode HTTP et URL :

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

Corps JSON de la requête :

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

Pour envoyer votre requête, développez l'une des options suivantes :

curl (Linux, macOS ou Cloud Shell)

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

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)

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

$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

Vous devriez recevoir une réponse JSON de ce type :

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

Activer les notifications de maintenance

Avant d'activer les notifications de maintenance, vous devez définir un intervalle de maintenance sur une instance.

Accédez à la page Communication. Accéder à la page Communication
Sur la ligne Cloud SQL, Intervalle de maintenance, cochez la case d'option E-mail pour la définir sur ACTIVÉ.

Chaque utilisateur devant recevoir des notifications doit activer lui-même l'option.

Rechercher des notifications de maintenance dans Google Cloud Console

Vous pouvez consulter les notifications de maintenance à plusieurs endroits dans Google Cloud Console :

Dans le tableau de bord ACTIVITÉ, recherchez les instances marquées avec Maintenance SQL.
Accéder au tableau de bord Activité
Lorsqu'une opération de maintenance est programmée pour une instance, la date de maintenance est indiquée sur la page Instances, dans la colonne Maintenance. La colonne Maintenance est généralement masquée, mais elle s'affiche automatiquement lorsqu'une opération de maintenance est programmée. Vous pouvez également sélectionner Maintenance dans le menu Options d'affichage des colonnes si vous souhaitez que la colonne Maintenance soit toujours affichée.
Vous pouvez également sélectionner une instance pour accéder à la page Détails de l'instance. Si une opération de maintenance est programmée pour cette instance, un message s'affiche dans le volet Maintenance.
Accéder à la page Instances Cloud SQL

Rechercher une maintenance planifiée à l'aide de l'API

gcloud

Pour vérifier la maintenance planifiée à venir, utilisez la commande suivante :

gcloud sql instances describe INSTANCE_ID

Remplacez la variable suivante :

INSTANCE_ID : instance pour laquelle vérifier la maintenance planifiée.

Dans la réponse, recherchez la section scheduledMaintenance.

REST v1

Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :

PROJECT_ID : ID ou numéro de projet du projet Google Cloud contenant l'instance.
INSTANCE_NAME : nom de l'instance que vous configurez pour la haute disponibilité.

Méthode HTTP et URL :

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

Pour envoyer votre requête, développez l'une des options suivantes :

curl (Linux, macOS ou Cloud Shell)

Exécutez la commande suivante :

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

PowerShell (Windows)

Exécutez la commande suivante :

$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

Vous devriez recevoir une réponse JSON de ce type :

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

Dans la réponse, recherchez la section scheduledMaintenance.

REST v1beta4

Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :

PROJECT_ID : ID ou numéro de projet du projet Google Cloud contenant l'instance.
INSTANCE_NAME : nom de l'instance que vous configurez pour la haute disponibilité.

Méthode HTTP et URL :

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

Pour envoyer votre requête, développez l'une des options suivantes :

curl (Linux, macOS ou Cloud Shell)

Exécutez la commande suivante :

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)

Exécutez la commande suivante :

$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

Vous devriez recevoir une réponse JSON de ce type :

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

Dans la réponse, recherchez la section scheduledMaintenance.

Reprogrammer une maintenance planifiée

Vous pouvez reprogrammer la maintenance à l'aide de la console Google Cloud, de gcloud CLI ou de l'API Cloud SQL Admin.

Si vous définissez la planification de maintenance de votre instance sur la semaine 1 ou la semaine 2, vous pouvez replanifier la maintenance jusqu'à 28 jours.

Si vous définissez la période de maintenance de votre instance sur la semaine 5, vous pouvez reprogrammer la maintenance jusqu'à sept jours. Vous devez reprogrammer la maintenance dans ce délai pour vous assurer que l'instance reçoit la mise à jour de maintenance avant le début du prochain déploiement trimestriel de maintenance.

Console

Dans Google Cloud Console, accédez à la page Instances Cloud SQL.

Accéder à la page Instances Cloud SQL
Filtrez sur le terme Maintenance pour répertorier toutes les instances pour lesquelles une maintenance est programmée.
Dans la colonne Maintenance, cliquez sur Reprogrammer.
Dans la boîte de dialogue Reprogrammer, indiquez si vous souhaitez appliquer la maintenance immédiatement, ou la reprogrammer à un moment spécifique pendant la période de report autorisée, telle que définie dans la section Maintenance planifiée replanifiée ou encore la reporter au prochain intervalle de maintenance disponible.

gcloud

Pour reprogrammer la maintenance sur une instance Cloud SQL, exécutez la commande suivante :

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

Remplacez les variables suivantes :

INSTANCE_ID : instance à replanifier.
RESCHEDULE_TYPE : utilisez l'une des valeurs suivantes : IMMEDIATE, NEXT_AVAILABLE_WINDOW ou SPECIFIC_TIME.
Si vous choisissez NEXT_AVAILABLE_WINDOW, la maintenance est reprogrammée au prochain intervalle de maintenance disponible après l'heure programmée actuelle.
RESCHEDULE_TIME : si vous spécifiez SPECIFIC_TIME pour RESCHEDULE_TYPE, vous devez également définir l'option --schedule-time pour spécifier le jour et l'heure de l'exécution de la maintenance. Utilisez le format ISO 8601, par exemple 2020-01-16T16:56:00.000Z.

Pour plus d'informations, consultez la page sur gcloud sql reschedule-maintenance.

Si vous souhaitez reprogrammer la maintenance jusqu'à 28 jours au maximum, vérifiez le numéro de version de gcloud. Si le numéro de version est inférieur à 390.0.0_RC00, réinstallez gcloud.

REST v1

Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :

PROJECT_ID : ID du projet
INSTANCE_ID : ID de l'instance
RESCHEDULE_TYPE : utilisez l'une des valeurs suivantes : IMMEDIATE, NEXT_AVAILABLE_WINDOW ou SPECIFIC_TIME.
Si vous choisissez NEXT_AVAILABLE_WINDOW, la maintenance est reprogrammée au prochain intervalle de maintenance disponible.

Méthode HTTP et URL :

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

Corps JSON de la requête :

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

Pour envoyer votre requête, développez l'une des options suivantes :

curl (Linux, macOS ou Cloud Shell)

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

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)

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

$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

Vous devriez recevoir une réponse JSON de ce type :

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

Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :

PROJECT_ID : ID du projet
INSTANCE_ID : ID de l'instance
RESCHEDULE_TYPE : utilisez l'une des valeurs suivantes : IMMEDIATE, NEXT_AVAILABLE_WINDOW ou SPECIFIC_TIME.
Si vous choisissez NEXT_AVAILABLE_WINDOW, la maintenance est reprogrammée au prochain intervalle de maintenance disponible.

Méthode HTTP et URL :

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

Corps JSON de la requête :

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

Pour envoyer votre requête, développez l'une des options suivantes :

curl (Linux, macOS ou Cloud Shell)

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

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)

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

$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

Vous devriez recevoir une réponse JSON de ce type :

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

Pour découvrir comment est formée la requête sous-jacente de l'API REST pour cette tâche, consultez la page sur la méthode instances:post dans APIs Explorer.

Configurer une période de refus de maintenance

Vous pouvez configurer à tout moment jusqu'à une période de refus de maintenance sur une instance Cloud SQL. La période de refus de maintenance prévaut sur tout intervalle de maintenance programmé. En cas de conflit entre le moment où un intervalle de maintenance et une période de refus de maintenance doivent avoir lieu, la période de refus de maintenance remplace l'intervalle de maintenance.

Vous pouvez supprimer manuellement une période de refus de maintenance, qu'elle ait eu lieu ou non.

Pour configurer une période de refus de maintenance, définissez sa date de début, sa date de fin, ainsi que l'heure de début et de fin de l'intervalle. Une période de refus de maintenance peut durer de un à 90 jours.

Deux formats peuvent être utilisés pour les dates de début et de fin :

yyyy-mm-dd : indique une date spécifique.
mm-dd : indique une date récurrente tous les ans.

Les dates de début et de fin sont au format UTC. Pour définir le fuseau horaire, ajustez l'heure de début à l'aide du champ d'heure. Par exemple, la date de début = 2020-10-10 et l'heure = 07:00:00 indique l'heure de début 2020-10-10 07:00:00 UTC (2020-10-10 00:00:00 PST)

Pour l'heure, le format est le suivant : HH:mm:SS.

Les heures sont comprises entre 0 et 23 (inclus).
Les minutes et les secondes sont comprises entre 0 et 59 (inclus).

Console

Dans Google Cloud Console, accédez à la page Instances Cloud SQL.

Accéder à la page Instances Cloud SQL
Pour ouvrir la page Présentation d'une instance, cliquez sur son nom.
Dans la section Maintenance, cliquez sur Modifier les préférences de maintenance.
Dans la section Période de refus de maintenance, définissez les dates de début et de fin.
Dans la section Options avancées, vous pouvez éventuellement sélectionner Répéter tous les ans.
Cliquez sur Enregistrer.

gcloud

Pour configurer une période de refus de maintenance sur une instance Cloud SQL, exécutez la commande suivante :

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

Remplacez les variables suivantes :

INSTANCE_ID : ID de l'instance Cloud SQL
START_DATE : date de début de l'intervalle. Par exemple, 2021-11-29.
END_DATE : date de fin de l'intervalle. Par exemple, 2021-12-02.
TIME : heure de début et de fin de l'intervalle. Par exemple, 00:00:00.

REST v1

Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :

project-id : ID du projet
instance-id : ID de l'instance
start-date : date de début (aaaa-mm-jj) ou (mm-jj) pour une récurrence annuelle.
end-date : date de fin (aaaa-mm-jj) ou (mm-jj) pour une récurrence annuelle.
time : heures de début et de fin (HH:mm:SS)

Méthode HTTP et URL :

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

Corps JSON de la requête :

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

Pour envoyer votre requête, développez l'une des options suivantes :

curl (Linux, macOS ou Cloud Shell)

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

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)

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

$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

Vous devriez recevoir une réponse JSON de ce type :

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

Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :

project-id : ID du projet
instance-id : ID de l'instance
start-date : date de début (aaaa-mm-jj) ou (mm-jj) pour une récurrence annuelle.
end-date : date de fin (aaaa-mm-jj) ou (mm-jj) pour une récurrence annuelle.
time : heures de début et de fin (HH:mm:SS)

Méthode HTTP et URL :

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

Corps JSON de la requête :

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

Pour envoyer votre requête, développez l'une des options suivantes :

curl (Linux, macOS ou Cloud Shell)

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

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)

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

$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

Vous devriez recevoir une réponse JSON de ce type :

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

Supprimer une période de refus de maintenance

Console

Dans Google Cloud Console, accédez à la page Instances Cloud SQL.

Accéder à la page Instances Cloud SQL
Pour ouvrir la page Présentation d'une instance, cliquez sur son nom.
Dans la section Maintenance, cliquez sur Modifier les préférences de maintenance.
Dans la section Refuser la période de maintenance, cliquez sur Effacer.
Cliquez sur Enregistrer.

gcloud

Pour supprimer une période de refus de maintenance d'une instance Cloud SQL, exécutez la commande suivante :

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

Remplacez les variables suivantes :

INSTANCE_ID : ID de l'instance Cloud SQL

REST v1

Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :

project-id : ID du projet
instance-id : ID de l'instance.

Méthode HTTP et URL :

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

Corps JSON de la requête :

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

Pour envoyer votre requête, développez l'une des options suivantes :

curl (Linux, macOS ou Cloud Shell)

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

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)

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

$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

Vous devriez recevoir une réponse JSON de ce type :

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

Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :

project-id : ID du projet
instance-id : ID de l'instance.

Méthode HTTP et URL :

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

Corps JSON de la requête :

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

Pour envoyer votre requête, développez l'une des options suivantes :

curl (Linux, macOS ou Cloud Shell)

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

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)

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

$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

Vous devriez recevoir une réponse JSON de ce type :

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

Notifications liées à un refus de la période de maintenance

Les notifications d'intervalle de maintenance ne sont pas envoyées lorsque l'heure de maintenance planifiée se situe pendant la période de refus de maintenance. Dans ce cas, les notifications sont interdites par les paramètres de la période de refus de maintenance.

Si vous modifiez les paramètres de la période de refus de maintenance pour empêcher la maintenance à une heure précédemment planifiée, l'instance Cloud SQL ignore la maintenance et envoie une notification concernant l'annulation de la maintenance. Cloud SQL envoie cette notification d'annulation chaque fois qu'une mise à jour de l'instance est programmée.

Les notifications de maintenance planifiée sont envoyées pendant la période de refus de maintenance, à condition que la maintenance ait été programmée en dehors de cette période.

Rechercher et définir des intervalles de maintenance

Avant de commencer

Définir un intervalle de maintenance sur une instance

Console

gcloud

REST v1

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

REST v1beta4

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

Activer les notifications de maintenance

Rechercher des notifications de maintenance dans Google Cloud Console

Rechercher une maintenance planifiée à l'aide de l'API

gcloud

REST v1

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

REST v1beta4

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

Reprogrammer une maintenance planifiée

Console

gcloud

REST v1

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

REST v1beta4

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

Configurer une période de refus de maintenance

Console

gcloud

REST v1

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

REST v1beta4

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

Supprimer une période de refus de maintenance

Console

gcloud

REST v1

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

REST v1beta4

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

Notifications liées à un refus de la période de maintenance

Étapes suivantes