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 a Manutenção unificada, verifique se ela é compatível com seus tipos de recursos.

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 .

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