Faça a gestão dos períodos de manutenção da instância do Apigee

Esta página aplica-se ao Apigee e ao Apigee Hybrid.

Veja a documentação do Apigee Edge.

Esta secção tem procedimentos para encontrar e definir janelas de manutenção para recursos do Apigee. Para saber como e por que motivo o Apigee realiza a manutenção, consulte a Vista geral da manutenção.

Defina um período preferencial para manutenção

Se fizer alterações à definição do período de manutenção enquanto o recurso já estiver em manutenção ou agendado para manutenção, as alterações não entram em vigor imediatamente. Estas alterações refletem-se nos eventos de manutenção futuros.

Se tiver ativado as notificações de manutenção, o Apigee envia-lhe notificações depois de um recurso ter sido agendado para manutenção, com a data e a hora exatas em que a manutenção está agendada. O Apigee envia estas notificações com base na ordem das definições de atualização do período de manutenção dos recursos, da seguinte forma:

  • Se a ordem da definição de atualização estiver definida como Semana 1, o Apigee envia notificações de manutenção com, pelo menos, uma semana de antecedência.
  • Se a ordem da definição de atualização estiver definida como Semana 2, o Apigee envia notificações de manutenção com, pelo menos, duas semanas de antecedência.

Só pode especificar uma janela de manutenção por instância do Apigee. As solicitações com mais do que um período de manutenção são rejeitadas.

Se quiser definir períodos de manutenção para várias instâncias na mesma organização, deve garantir que existem, pelo menos, 12 horas entre os períodos de manutenção para evitar operações de manutenção sobrepostas.

Quando atualiza o período de manutenção, o período anterior é substituído.

AUTH="Authorization: Bearer $(gcloud auth print-access-token)"
curl -X PATCH \
  -H "$AUTH" \
  -H "Content-Type: application/json" \
  -d '{
    "maintenanceUpdatePolicy": {
      "maintenanceWindows": [
        {
          "day": "SUNDAY",
          "startTime": {
            "hours": 23
          }
        }
      ],
      "maintenanceChannel": "WEEK1"
    }
  }' \
  "https://apigee.googleapis.com/v1/organizations/ORGANIZATION_ID/instances/INSTANCE_ID?updateMask=maintenanceUpdatePolicy.maintenanceWindows,maintenanceUpdatePolicy.maintenanceChannel"

Onde:

  • A manutenção startTime está configurada em UTC.
  • ORGANIZATION_ID é o ID da sua organização Apigee.
  • INSTANCE_ID é o ID da sua instância do Apigee.

Encontre definições de manutenção e programações de manutenção existentes

Pode obter as suas definições de manutenção atuais e ver qualquer manutenção futura verificando os campos maintenanceUpdatePolicy e scheduledMaintenance, conforme mostrado no exemplo da API seguinte:

AUTH="Authorization: Bearer $(gcloud auth print-access-token)"
curl -H "$AUTH" \
  "https://apigee.googleapis.com/v1/organizations/ORGANIZATION_ID/instances/INSTANCE_ID"

Onde:

  • ORGANIZATION_ID é o ID da sua organização Apigee.
  • INSTANCE_ID é o ID da sua instância do Apigee.

Exemplo de resultado

{
  ...
  "scheduledMaintenance": {
    "startTime": "2025-01-28T23:00:00Z"
  },
  "maintenanceUpdatePolicy": {
    "maintenanceWindows": [
      {
        "day": "SUNDAY",
        "startTime": {
          "hours": 23
        }
      }
    ]
  }
}

Limpe as definições de manutenção

Se já não precisar das definições de manutenção, pode limpá-las seguindo as instruções abaixo.

AUTH="Authorization: Bearer $(gcloud auth print-access-token)"
curl -X PATCH \
  -H "$AUTH" \
  -H "Content-Type: application/json" \
  -d '{
    "maintenanceUpdatePolicy": null
  }' \
  "https://apigee.googleapis.com/v1/organizations/ORGANIZATION_ID/instances/INSTANCE_ID?updateMask=maintenanceUpdatePolicy"

Onde:

  • ORGANIZATION_ID é o ID da sua organização Apigee.
  • INSTANCE_ID é o ID da sua instância do Apigee.

Aceite as notificações de manutenção

Antes de ativar as notificações de manutenção, tem de definir um período preferencial para manutenção num recurso.

  1. Na Google Cloud consola, aceda à página Preferências do utilizador > Comunicação.

    Aceder a Comunicações

  2. Na linha de Apigee, janela de manutenção, selecione o botão de opção em Email para o ativar �

Cada utilizador que precise de receber notificações tem de ativar esta opção separadamente seguindo as instruções acima.