MCP Tools Reference: maintenance.googleapis.com

Alat: get_resource_maintenance

Mengambil detail tentang pemeliharaan resource tertentu.

Parameter

  • name (string, Wajib): Nama resource dari resource dalam layanan, dalam format projects/{project}/locations/{location}/resourceMaintenances/{resource_maintenance_id}.

Nilai Hasil

Objek resource ResourceMaintenance jika ditemukan.

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

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": "get_resource_maintenance",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Skema Input

Struktur permintaan untuk metode GetResourceMaintenance.

GetResourceMaintenanceRequest

Representasi JSON 
{
  "name": string
}
Kolom
name

string

Wajib. Nama resource dalam layanan.

Skema Output

ResourceMaintenance adalah resource yang merepresentasikan operasi pemeliharaan pada resource.

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