MCP Tools Reference: redis.googleapis.com

Alat: list_backups

Mencantumkan semua cadangan Memorystore for Redis Cluster.

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

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

Skema Input

Permintaan untuk ListBackups.

ListBackupsRequest

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

string

Wajib. Nama resource backupCollection menggunakan formulir: projects/{project_id}/locations/{location_id}/backupCollections/{backup_collection_id}
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 ListBackups.

ListBackupsResponse

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

object (Backup)

Daftar cadangan dalam project.
nextPageToken

string

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

string

Cadangan yang tidak dapat dijangkau.

Cadangan

Representasi JSON 
{
  "name": string,
  "createTime": string,
  "cluster": string,
  "clusterUid": string,
  "totalSizeBytes": string,
  "expireTime": string,
  "engineVersion": string,
  "backupFiles": [
    {
      object (BackupFile)
    }
  ],
  "nodeType": enum (NodeType),
  "replicaCount": integer,
  "shardCount": integer,
  "backupType": enum (BackupType),
  "state": enum (State),
  "encryptionInfo": {
    object (EncryptionInfo)
  },
  "uid": string
}
Kolom
name

string

ID. Jalur resource lengkap cadangan. Bagian terakhir dari nama adalah ID cadangan dengan format berikut: [YYYYMMDDHHMMSS]_[Shorted Cluster UID] ATAU ditentukan pelanggan saat mencadangkan cluster. Contoh: 20240515123000_1234
createTime

string (Timestamp format)

Hanya output. Waktu saat 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".
cluster

string

Hanya output. Jalur resource cluster dari cadangan ini.
clusterUid

string

Hanya output. UID cluster cadangan ini.
totalSizeBytes

string (int64 format)

Hanya output. Total ukuran cadangan dalam byte.
expireTime

string (Timestamp format)

Hanya output. Waktu saat cadangan akan berakhir masa berlakunya.

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

string

Hanya output. redis-7.2, valkey-7.5
backupFiles[]

object (BackupFile)

Hanya output. Daftar file cadangan dari cadangan.
nodeType

enum (NodeType)

Hanya output. Jenis node cluster.
replicaCount

integer

Hanya output. Jumlah replika untuk cluster.
shardCount

integer

Hanya output. Jumlah shard untuk cluster.
backupType

enum (BackupType)

Hanya output. Jenis cadangan.
state

enum (State)

Hanya output. Status pencadangan.
encryptionInfo

object (EncryptionInfo)

Hanya output. Informasi enkripsi cadangan.
uid

string

Hanya output. ID unik cadangan yang ditetapkan sistem.

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.

BackupFile

Representasi JSON 
{
  "fileName": string,
  "sizeBytes": string,
  "createTime": string
}
Kolom
fileName

string

Hanya output. misalnya: .rdb
sizeBytes

string (int64 format)

Hanya output. Ukuran file cadangan dalam byte.
createTime

string (Timestamp format)

Hanya output. Waktu saat file 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".

EncryptionInfo

Representasi JSON 
{
  "encryptionType": enum (Type),
  "kmsKeyVersions": [
    string
  ],
  "kmsKeyPrimaryState": enum (KmsKeyState),
  "lastUpdateTime": string
}
Kolom
encryptionType

enum (Type)

Hanya output. Jenis enkripsi.
kmsKeyVersions[]

string

Hanya output. Versi kunci KMS yang digunakan untuk melindungi data dalam penyimpanan.
kmsKeyPrimaryState

enum (KmsKeyState)

Hanya output. Status versi utama kunci KMS yang dirasakan oleh sistem. Kolom ini tidak diisi dalam cadangan.
lastUpdateTime

string (Timestamp format)

Hanya output. Waktu terakhir kali info enkripsi diperbarui.

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

Anotasi Alat

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