MCP Tools Reference: maintenance.googleapis.com

Alat: summarize_maintenances

Merangkum pemeliharaan untuk project dan lokasi tertentu dengan memberikan statistik gabungan.

Parameter

  • parent (string, Wajib): Induk pemeliharaan resource, dalam format projects/{project}/locations/{location}.
  • page_size (integer, Opsional): Jumlah maksimum pemeliharaan resource yang akan dikirim per halaman.
  • page_token (string, Opsional): Token halaman, yang diterima dari panggilan SummarizeMaintenances sebelumnya.
  • filter (string, Opsional): Memfilter daftar seperti yang ditentukan di https://google.aip.dev/160.
  • order_by (string, Opsional): Urutkan hasil seperti yang ditentukan dalam https://google.aip.dev/132.

Nilai Hasil

Metode ini menampilkan objek SummarizeMaintenancesResponse, yang berisi:

  • maintenances: Daftar ringkasan pemeliharaan.
  • next_page_token: Token yang dapat dikirim sebagai page_token dalam permintaan berikutnya untuk mengambil halaman hasil berikutnya.

Catatan

  • Gunakan '-' sebagai lokasi untuk ringkasan global di semua wilayah.

Contoh berikut menunjukkan cara menggunakan curl untuk memanggil alat MCP summarize_maintenances.

Permintaan Curl 
                  
curl --location 'https://maintenance.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "summarize_maintenances",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Skema Input

Pesan permintaan untuk metode kustom SummarizeMaintenances.

SummarizeMaintenancesRequest

Representasi JSON 
{
  "parent": string,
  "pageSize": integer,
  "pageToken": string,
  "filter": string,
  "orderBy": string
}
Kolom
parent

string

Wajib. Induk pemeliharaan resource. misalnya, projects/123/locations/*
pageSize

integer

Jumlah maksimum pemeliharaan resource yang akan dikirim per halaman. Ukuran halaman default adalah 20 dan maksimum adalah 1.000.
pageToken

string

Token halaman: Jika next_page_token dari respons sebelumnya diberikan, permintaan ini akan mengirimkan halaman berikutnya.
filter

string

Filter daftar seperti yang ditentukan dalam https://google.aip.dev/160. Kolom yang didukung mencakup: - maintenance.maintenanceName Contoh: - maintenance.maintenanceName="eb3b709c-9ca1-5472-9fb6-800a3849eda1"
orderBy

string

Urutkan hasil seperti yang ditentukan di https://google.aip.dev/132.

Skema Output

Pesan permintaan untuk metode kustom SummarizeMaintenances.

SummarizeMaintenancesResponse

Representasi JSON 
{
  "maintenances": [
    {
      object (MaintenanceSummary)
    }
  ],
  "nextPageToken": string,
  "unreachable": [
    string
  ]
}
Kolom
maintenances[]

object (MaintenanceSummary)

Ringkasan yang dihasilkan.
nextPageToken

string

Jika ada, token halaman berikutnya dapat diberikan ke panggilan SummarizeMaintenances berikutnya untuk mencantumkan halaman berikutnya. Jika kosong, tidak ada lagi halaman.
unreachable[]

string

Daftar yang tidak diurutkan. Lokasi yang tidak dapat dijangkau.

MaintenanceSummary

Representasi JSON 
{
  "maintenanceName": string,
  "title": string,
  "description": string,
  "category": enum (MaintenanceCategory),
  "maintenanceScheduledStartTime": string,
  "maintenanceScheduledEndTime": string,
  "maintenanceStartTime": string,
  "maintenanceEndTime": string,
  "userControllable": boolean,
  "controls": [
    {
      object (MaintenanceControl)
    }
  ],
  "stats": [
    {
      object (Stats)
    }
  ]
}
Kolom
maintenanceName

string

Hanya output. Nama pemeliharaan.
title

string

Hanya output. Judul pemeliharaan.
description

string

Hanya output. Deskripsi pemeliharaan.
category

enum (MaintenanceCategory)

Hanya output. Kategori peristiwa pemeliharaan.
maintenanceScheduledStartTime

string (Timestamp format)

Hanya output. Waktu mulai pemeliharaan yang dijadwalkan. Pemeliharaan akan dimulai pada maintenanceScheduledStartTime atau lebih lambat, dengan upaya terbaik untuk menyelesaikannya sebelum maintenanceScheduledEndTime.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
maintenanceScheduledEndTime

string (Timestamp format)

Hanya output. Perkiraan (upaya terbaik, tidak dijamin) waktu berakhir pemeliharaan terjadwal.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
maintenanceStartTime

string (Timestamp format)

Hanya output. Tanggal sebenarnya saat pemeliharaan dimulai. Kolom hanya ada setelah status berubah menjadi RUNNING.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
maintenanceEndTime

string (Timestamp format)

Hanya output. Tanggal sebenarnya saat pemeliharaan berhasil diselesaikan. Kolom hanya ada setelah status berubah menjadi SUCCEEDED.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
userControllable

boolean

Hanya output. Menunjukkan apakah pengguna memiliki kontrol atas pemeliharaan tersebut, baik secara proaktif sebelum pemeliharaan dijadwalkan dengan kebijakan pemeliharaan atau dengan kontrol reaktif setelah dijadwalkan (lihat kolom kontrol).
controls[]

object (MaintenanceControl)

Hanya output. Kontrol tersedia untuk Pemeliharaan tersebut (mungkin tidak tersedia untuk setiap resource yang menerapkan pemeliharaan).
stats[]

object (Stats)

Hanya output. Stats adalah kolom ResourceMaintenance yang digunakan untuk mengagregasikan statistik.

Stempel waktu

Representasi JSON 
{
  "seconds": string,
  "nanos": integer
}
Kolom
seconds

string (int64 format)

Mewakili detik waktu UTC sejak epoch Unix 1970-01-01T00:00:00Z. Harus antara -62135596800 dan 253402300799 inklusif (yang sesuai dengan 0001-01-01T00:00:00Z hingga 9999-12-31T23:59:59Z).
nanos

integer

Pecahan detik non-negatif pada resolusi nanodetik. Kolom ini adalah bagian nanodetik dari durasi, bukan alternatif untuk detik. Nilai detik negatif dengan pecahan harus tetap memiliki nilai nanos non-negatif yang dihitung maju dalam waktu. Harus antara 0 dan 999.999.999 inklusif.

MaintenanceControl

Representasi JSON 
{
  "control": enum (Control),
  "isCustom": boolean,
  "documentation": string
}
Kolom
control

enum (Control)

Kontrol pemeliharaan resource.
isCustom

boolean

Menunjukkan apakah kontrol hanya tersedia di Service Producer API (bukan melalui Pemeliharaan Terpadu).
documentation

string

Link ke dokumentasi Produsen Layanan tentang kontrol pemeliharaan. Disediakan hanya jika isCustom adalah true.

Statistik

Representasi JSON 
{
  "groupBy": string,
  "aggregates": [
    {
      object (Aggregate)
    }
  ]
}
Kolom
groupBy

string

groupBy menentukan jenis agregat. Misalnya, group_by bisa berupa "state"
aggregates[]

object (Aggregate)

Aggregates adalah daftar pasangan <grup, jumlah>. Misalnya, jika group_by adalah "state", kemungkinan tuple dalam daftar agregat adalah "DIJADWALKAN" : 11,

Agregat

Representasi JSON 
{
  "group": string,
  "count": string
}
Kolom
group

string

Menentukan nilai spesifik group_by yang diwakili oleh jumlah. Misalnya, jika group_by adalah "state", grup yang sesuai bisa berupa "SCHEDULED".
count

string (int64 format)

Jumlah grup.

MaintenanceCategory

Kategori pemeliharaan.

Enum
MAINTENANCE_CATEGORY_UNSPECIFIED Kategori tidak ditentukan.
INFRASTRUCTURE Peristiwa pemeliharaan infrastruktur adalah waktu saat Google Cloud melakukan pemeliharaan rutin pada peralatan jaringan, misalnya Google Cloud Interconnect. Peristiwa ini biasanya dijadwalkan sebelumnya dan kami memberikan notifikasi, jika memungkinkan, sehingga pengguna dapat merencanakan peristiwa pemeliharaan infrastruktur dan mencegah periode nonaktif. Peristiwa pemeliharaan infrastruktur tidak memiliki interval yang ditetapkan antar-kejadian, tetapi umumnya terjadi beberapa kali dalam setahun.
SERVICE_UPDATE Update yang dapat mencakup perbaikan bug, perubahan, atau fitur baru yang kompatibel dengan versi sebelumnya (termasuk patch). Beberapa SP memungkinkan pengguna mengontrol penjadwalan peristiwa pemeliharaan ini menggunakan masa pemeliharaan dan/atau fitur penolakan pemeliharaan.

Kontrol

Menetapkan jenis kontrol yang didukung. comment (seperti dalam log).

Enum
CONTROL_UNSPECIFIED Kontrol tidak ditentukan.
APPLY Terapkan kontrol.
MANAGE_POLICY Mengelola kontrol kebijakan.
RESCHEDULE Kontrol penjadwalan ulang.

Anotasi Alat

Petunjuk Destruktif: ❌ | Petunjuk Idempoten: ✅ | Petunjuk Hanya Baca: ✅ | Petunjuk Dunia Terbuka: ❌