MCP Tools Reference: memorystore.googleapis.com

ツール: list_backups

すべての Memorystore for Valkey バックアップを一覧表示します。

次のサンプルは、curl を使用して list_backups MCP ツールを呼び出す方法を示しています。

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
}'

入力スキーマ

ListBackups のリクエスト。

ListBackupsRequest

JSON 表現 
{
  "parent": string,
  "pageSize": integer,
  "pageToken": string
}
フィールド
parent

string

必須。backupCollection のリソース名（形式: projects/{project_id}/locations/{location_id}/backupCollections/{backup_collection_id}）。
pageSize

integer

省略可。返す最大アイテム数。

指定しない場合は、デフォルト値の 1000 が使用されます。page_size 値に関係なく、レスポンスには部分的なリストが含まれる場合があり、クエリ対象のクラスタが他にも存在するかどうかを見極めるため、呼び出し元はレスポンスの next_page_token のみを信頼します。
pageToken

string

省略可。前の ListBackupCollections リクエストから返された next_page_token 値（存在する場合）。

出力スキーマ

ListBackups に対するレスポンス。

ListBackupsResponse

JSON 表現 
{
  "backups": [
    {
      object (Backup)
    }
  ],
  "nextPageToken": string,
  "unreachable": [
    string
  ]
}
フィールド
backups[]

object (Backup)

プロジェクト内のバックアップのリスト。
nextPageToken

string

結果の次のページを取得するためのトークン。リストにそれ以上の結果がない場合は空です。
unreachable[]

string

アクセスできなかったバックアップ。

バックアップ

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
}
フィールド
name

string

ID。バックアップの完全なリソースパス。名前の最後の部分は、次の形式のバックアップ ID です: [YYYYMMDDHHMMSS]_[短縮されたインスタンス UID] またはバックアップ インスタンスでユーザーが指定した ID。例: 20240515123000_1234
createTime

string (Timestamp format)

出力専用。バックアップが作成された時刻。

RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"、"2014-10-02T15:01:23+05:30"。
instance

string

出力専用。このバックアップのインスタンス リソースパス。
instanceUid

string

出力専用。このバックアップのインスタンス UID。
totalSizeBytes

string (int64 format)

出力専用。バックアップの合計サイズ（バイト単位）。
expireTime

string (Timestamp format)

出力専用。バックアップの有効期限が切れる日時。

RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"、"2014-10-02T15:01:23+05:30"。
engineVersion

string

出力のみ。valkey-7.5/valkey-8.0 など。
backupFiles[]

object (BackupFile)

出力専用。バックアップのバックアップ ファイルのリスト。
nodeType

enum (NodeType)

出力専用。インスタンスのノードタイプ。
replicaCount

integer

出力専用。インスタンスのレプリカ数。
shardCount

integer

出力専用。インスタンスのシャード数。
backupType

enum (BackupType)

出力専用。バックアップのタイプ。
state

enum (State)

出力専用。バックアップの状態。
encryptionInfo

object (EncryptionInfo)

出力専用。バックアップの暗号化情報。
uid

string

出力専用。システムによって割り当てられたバックアップの固有識別子。

タイムスタンプ

JSON 表現 
{
  "seconds": string,
  "nanos": integer
}
フィールド
seconds

string (int64 format)

UNIX エポック 1970-01-01T00:00:00Z からの UTC 時刻の秒数を表します。-62135596800～253402300799 の範囲（両端を含む）にする必要があります（これは 0001-01-01T00:00:00Z～9999-12-31T23:59:59Z に対応します）。
nanos

integer

ナノ秒分解能による、秒の負ではない小数以下部分。このフィールドは、秒の代替ではなく、期間のナノ秒部分です。小数以下を含む負の秒の値は、時間を前方にカウントする負ではない nanos 値を持つ必要があります。0～999,999,999 にする必要があります（両端を含む）。

BackupFile

JSON 表現 
{
  "fileName": string,
  "sizeBytes": string,
  "createTime": string
}
フィールド
fileName

string

出力のみ。例: .rdb
sizeBytes

string (int64 format)

出力専用。バックアップ ファイルのサイズ（バイト単位）。
createTime

string (Timestamp format)

出力専用。バックアップ ファイルが作成された日時。

RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"、"2014-10-02T15:01:23+05:30"。

EncryptionInfo

JSON 表現 
{
  "encryptionType": enum (Type),
  "kmsKeyVersions": [
    string
  ],
  "kmsKeyPrimaryState": enum (KmsKeyState),
  "lastUpdateTime": string
}
フィールド
encryptionType

enum (Type)

出力専用。暗号化のタイプ。
kmsKeyVersions[]

string

出力専用。保存データの保護に使用されている KMS 鍵バージョン。
kmsKeyPrimaryState

enum (KmsKeyState)

出力専用。システムによって認識された KMS 鍵のメイン バージョンの状態。このフィールドはバックアップでは入力されません。
lastUpdateTime

string (Timestamp format)

出力専用。暗号化情報が最後に更新された時刻。

RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"、"2014-10-02T15:01:23+05:30"。

ツールのアノテーション

破壊的ヒント: ❌ | べき等ヒント: ✅ | 読み取り専用ヒント: ✅ | オープン ワールド ヒント: ❌