MCP Tools Reference: maintenance.googleapis.com

Alat: list_resource_maintenances

Mencantumkan pemeliharaan resource untuk project dan lokasi tertentu.

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 ListResourceMaintenances 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 ListResourceMaintenancesResponse, yang berisi:

  • resource_maintenances: Daftar pemeliharaan resource yang cocok dengan kriteria permintaan.
  • next_page_token: Token yang dapat dikirim sebagai page_token dalam permintaan berikutnya untuk mengambil halaman hasil berikutnya.

Catatan

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

Contoh berikut menunjukkan cara menggunakan curl untuk memanggil alat MCP list_resource_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": "list_resource_maintenances",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Skema Input

Struktur permintaan untuk metode ListResourceMaintenances.

ListResourceMaintenancesRequest

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

string

Wajib. Induk pemeliharaan resource.
pageSize

integer

Jumlah maksimum pemeliharaan resource yang akan dikirim per halaman.
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.
orderBy

string

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

Skema Output

Struktur respons untuk metode ListResourceMaintenances.

ListResourceMaintenancesResponse

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

object (ResourceMaintenance)

Pemeliharaan resource yang dihasilkan.
nextPageToken

string

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

string

Lokasi yang tidak dapat dijangkau.

ResourceMaintenance

Representasi JSON 
{
  "name": string,
  "resource": {
    object (Resource)
  },
  "maintenance": {
    object (Maintenance)
  },
  "state": enum (State),
  "createTime": string,
  "updateTime": string,
  "maintenanceStartTime": string,
  "maintenanceEndTime": string,
  "maintenanceCancelTime": string,
  "maintenanceScheduledStartTime": string,
  "maintenanceScheduledEndTime": string,
  "userControllable": boolean,
  "controls": [
    {
      object (MaintenanceControl)
    }
  ],
  "labels": {
    string: string,
    ...
  },
  "annotations": {
    string: string,
    ...
  },
  "uid": string,
  "etag": string
}
Kolom
name

string

ID. Nama resource resource_maintenance. Format: "projects/{project}/locations/{location}/resourceMaintenance/{resource-maintenance-id}"
resource

object (Resource)

Hanya output. Spesifikasi resource pemeliharaan resource.
maintenance

object (Maintenance)

Hanya output. Detail pemeliharaan.
state

enum (State)

Hanya output. Status pemeliharaan resource.
createTime

string (Timestamp format)

Hanya output. Waktu pembuatan pemeliharaan resource.

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".
updateTime

string (Timestamp format)

Hanya output. Waktu update pemeliharaan resource.

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. Waktu saat pemeliharaan resource dimulai.

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. Waktu saat pemeliharaan resource telah selesai.

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".
maintenanceCancelTime

string (Timestamp format)

Hanya output. Waktu saat pemeliharaan resource dibatalkan.

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".
maintenanceScheduledStartTime

string (Timestamp format)

Hanya output. Waktu saat pemeliharaan pada resource dijadwalkan untuk dimulai.

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. Waktu saat pemeliharaan pada resource dijadwalkan berakhir.

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 pemeliharaan.
labels

map (key: string, value: string)

Opsional. Label pada resource, yang dapat digunakan untuk kategorisasi, mirip dengan label resource Kubernetes.

Objek yang berisi daftar pasangan "key": value. Contoh: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
annotations

map (key: string, value: string)

Opsional. Anotasi adalah key-value map tidak terstruktur yang disimpan dengan resource yang dapat ditetapkan oleh alat eksternal untuk menyimpan dan mengambil metadata arbitrer. Objek ini tidak dapat dikueri dan harus dipertahankan saat mengubah objek.

Info selengkapnya: https://kubernetes.io/docs/user-guide/annotations

Objek yang berisi daftar pasangan "key": value. Contoh: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
uid

string

Hanya output. ID unik resource. UID bersifat unik dalam waktu dan ruang untuk resource ini dalam cakupan layanan. ID ini biasanya dibuat oleh server saat pembuatan resource berhasil dan tidak boleh diubah. UID digunakan untuk mengidentifikasi resource secara unik dengan penggunaan ulang nama resource. Nilai ini harus berupa UUID4.
etag

string

Hanya output. Nilai buram yang secara unik mengidentifikasi versi atau generasi resource. Header ini dapat digunakan untuk mengonfirmasi bahwa klien dan server menyetujui pengurutan resource yang sedang ditulis.

Resource

Representasi JSON 
{
  "resourceName": string,
  "location": string,
  "type": string
}
Kolom
resourceName

string

Hanya output. Name adalah referensi ke resource konsumen yang terpengaruh oleh pemeliharaan. Nilai yang tersedia dapat ditemukan di sini: https://cloud.google.com/asset-inventory/docs/asset-names
location

string

Hanya output. Lokasi resource. Format: us-central1
type

string

Hanya output. Jenis resource. Nilai yang tersedia dapat ditemukan di sini: https://cloud.google.com/asset-inventory/docs/asset-types#supported_resource_types Perhatikan bahwa tidak semua jenis resource akan melaporkan pemeliharaannya.

Pemeliharaan

Representasi JSON 
{
  "maintenanceName": string,
  "title": string,
  "description": string,
  "category": enum (MaintenanceCategory)
}
Kolom
maintenanceName

string

Maintenance adalah nama resource pemeliharaan yang sesuai dengan skema penamaan standar: "{maintenance-id}"
title

string

Hanya output. Judul pemeliharaan.
description

string

Hanya output. Deskripsi pemeliharaan.
category

enum (MaintenanceCategory)

Hanya output. Kategori pemeliharaan.

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.

LabelsEntry

Representasi JSON 
{
  "key": string,
  "value": string
}
Kolom
key

string
value

string

AnnotationsEntry

Representasi JSON 
{
  "key": string,
  "value": string
}
Kolom
key

string
value

string

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.

Negara Bagian

Status adalah status pemeliharaan resource.

Enum
STATE_UNSPECIFIED Status tidak ditentukan.
SCHEDULED Dijadwalkan untuk periode tertentu. Untuk pemeliharaan yang mengganggu, pemeliharaan harus mematuhi kebijakan pemeliharaan, yaitu masa yang tersedia, pengecualian, dan periode notifikasi.
RUNNING Pemeliharaan sedang berlangsung.
CANCELLED Tidak lagi direncanakan, biasanya saat pemeliharaan lain (misalnya, upgrade ke versi yang lebih baru) sudah terjadi, atau pengguna melewati pemeliharaan.
SUCCEEDED Berhasil diselesaikan.

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: ❌