MCP Tools Reference: redis.googleapis.com

Alat: list_backup_collections

Mencantumkan semua koleksi cadangan Memorystore for Redis Cluster.

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

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

Skema Input

Permintaan untuk ListBackupCollections.

ListBackupCollectionsRequest

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

string

Wajib. Nama resource lokasi backupCollection menggunakan formulir: projects/{project_id}/locations/{location_id} dengan location_id mengacu pada region Google Cloud.

pageSize

integer

Opsional. Jumlah maksimum item untuk ditampilkan.

Jika tidak ditentukan, nilai default 1000 akan digunakan oleh layanan. Terlepas dari nilai page_size, respons dapat menyertakan daftar parsial dan pemanggil hanya boleh mengandalkan next_page_token respons untuk menentukan apakah ada lebih banyak cluster yang tersisa untuk dikueri.

pageToken

string

Opsional. Nilai next_page_token yang ditampilkan dari permintaan [ListBackupCollections] sebelumnya, jika ada.

Skema Output

Respons untuk ListBackupCollections.

ListBackupCollectionsResponse

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

object (BackupCollection)

Daftar backupCollections dalam project.

Jika location_id di kolom induk permintaan adalah "-", semua region yang tersedia untuk project akan dikueri, dan hasilnya digabungkan. Jika dalam kueri gabungan seperti itu lokasi tidak tersedia, entri backupCollection placeholder akan disertakan dalam respons dengan kolom name yang ditetapkan ke nilai formulir projects/{project_id}/locations/{location_id}/backupCollections/- dan kolom status yang ditetapkan ke ERROR serta kolom status_message yang ditetapkan ke "location not available for ListBackupCollections".

nextPageToken

string

Token untuk mengambil halaman hasil berikutnya, atau kosong jika tidak ada lagi hasil dalam daftar.

unreachable[]

string

Lokasi yang tidak dapat dijangkau.

BackupCollection

Representasi JSON
{
  "name": string,
  "clusterUid": string,
  "cluster": string,
  "kmsKey": string,
  "uid": string,
  "createTime": string,
  "totalBackupSizeBytes": string,
  "totalBackupCount": string,
  "lastBackupTime": string
}
Kolom
name

string

ID. Jalur resource lengkap dari koleksi cadangan.

clusterUid

string

Hanya output. UID cluster dari koleksi cadangan.

cluster

string

Hanya output. Jalur resource lengkap cluster tempat koleksi cadangan berada. Contoh: projects/{project}/locations/{location}/clusters/{cluster}

kmsKey

string

Hanya output. Kunci KMS yang digunakan untuk mengenkripsi cadangan dalam kumpulan cadangan ini.

uid

string

Hanya output. ID unik yang ditetapkan sistem untuk koleksi cadangan.

createTime

string (Timestamp format)

Hanya output. Waktu saat koleksi cadangan dibuat.

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

totalBackupSizeBytes

string (int64 format)

Hanya output. Ukuran total semua cadangan dalam koleksi cadangan.

totalBackupCount

string (int64 format)

Hanya output. Jumlah total cadangan dalam koleksi cadangan.

lastBackupTime

string (Timestamp format)

Hanya output. Terakhir kali cadangan dibuat dalam koleksi cadangan.

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

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.

Anotasi Alat

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