MCP Tools Reference: memorystore.googleapis.com

Alat: list_backups

Mencantumkan semua cadangan Memorystore for Valkey.

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

Permintaan Curl 
                  
curl --location 'https://memorystore.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,
  "instance": string,
  "instanceUid": 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 Instance UID] ATAU ditentukan pelanggan saat mencadangkan instance. 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".
instance

string

Hanya output. Jalur resource instance dari cadangan ini.
instanceUid

string

Hanya output. UID instance 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. valkey-7.5/valkey-8.0, dll.
backupFiles[]

object (BackupFile)

Hanya output. Daftar file cadangan dari cadangan.
nodeType

enum (NodeType)

Hanya output. Jenis node instance.
replicaCount

integer

Hanya output. Jumlah replika untuk instance.
shardCount

integer

Hanya output. Jumlah shard untuk instance.
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: ❌