Ver manutenções de recursos usando a API

É possível usar a API Unified Maintenance para retornar informações sobre a manutenção dos seus recursos.

Neste documento, descrevemos como usar o Cloud Shell para chamar a API Unified Maintenance e retornar a manutenção de recursos.

Para conferir as atividades de manutenção futuras e históricas no Cloud Hub, consulte Ver atividades de manutenção.

Antes de começar

Antes de conferir a manutenção dos seus recursos usando o Unified Maintenance, verifique se o Unified Maintenance é compatível com seus tipos de recursos.

Para conferir as atividades de manutenção dos aplicativos do App Hub (prévia), defina os apps com seus recursos Google Cloud atuais no App Hub ou crie e implante com o App Design Center.

Filtros

É possível filtrar quais atividades de manutenção são retornadas por vários parâmetros:

  • Estado (SUCCEEDED ou STARTED, por exemplo)
  • Nome do recurso
  • Local do recurso
  • Tipo de recurso
  • Nome da manutenção
  • Horário de início da manutenção
  • Horário de término da manutenção

Para mais informações, consulte a documentação da API Unified Maintenance.

Ver manutenções de recursos

Você pode usar a API Unified Maintenance para retornar informações sobre a atividade de manutenção de um projeto Google Cloud . Se você estiver gerenciando aplicativos em um limite no nível da pasta, use o projeto de gerenciamento da pasta.

Para listar todas as atividades de manutenção:

  1. Acesse o Cloud Shell.

    Acesse o Cloud Shell

  2. Execute o comando:

    curl \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type:
application/json" \
https://maintenance.googleapis.com/v1beta/projects/PROJECT_ID/locations/LOCATION/resourceMaintenances

    Substitua:

    • PROJECT_ID: o ID do projeto.
    • LOCATION: região ou zona que contém o projeto. Defina como global, region ou - (para corresponder a todos os locais).

  3. A Unified Maintenance retorna informações sobre as manutenções de recursos do projeto especificado.

Ver manutenções de um recurso

É possível usar a API Unified Maintenance para retornar manutenções de um recurso especificado.

Para filtrar e imprimir manutenções de um recurso específico:

  1. Acesse o Cloud Shell.

    Acesse o Cloud Shell

  2. Execute o comando:

    curl \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type:
application/json" \
https://maintenance.googleapis.com/v1beta/projects/PROJECT_ID/locations/LOCATION/resourceMaintenances?filter=FILTER=%22RESOURCE_NAME%22

    Substitua:

    • PROJECT_ID: o ID do projeto.
    • LOCATION: região ou zona que contém o projeto. Defina como global, region ou - (para corresponder a todos os locais).
    • RESOURCE_NAME: o nome completo do recurso.

A seguir