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

필수 항목입니다. projects/{project_id}/locations/{location_id}/backupCollections/{backup_collection_id} 형식을 사용하는 backupCollection의 리소스 이름입니다.
pageSize

integer

선택사항입니다. 반환할 최대 항목 수입니다.

지정하지 않으면 서비스는 기본값인 1,000을 사용합니다. 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입니다. [YYYYMMDDHHMMSS]_[단축된 인스턴스 UID] 또는 백업 인스턴스 중에 고객이 지정한 ID 예: 20240515123000_1234
createTime

string (Timestamp format)

출력 전용입니다. 백업이 생성된 시간입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. '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)

출력 전용입니다. 백업이 만료되는 시간입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. '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 epoch 1970-01-01T00:00:00Z 이후 UTC 시간의 초 단위로 표현합니다. -62135596800~253402300799 (0001-01-01T00:00:00Z~9999-12-31T23:59:59Z) 사이여야 합니다.
nanos

integer

나노초 단위의 음수가 아닌 초수입니다. 이 필드는 기간의 나노초 부분이며 초의 대안이 아닙니다. 음수의 초수 값에는 시간에 반영되는 음수가 아닌 나노초 값이 있어야 합니다. 0~999,999,999(포함) 사이여야 합니다.

BackupFile

JSON 표현 
{
  "fileName": string,
  "sizeBytes": string,
  "createTime": string
}
필드
fileName

string

출력 전용입니다. 예: .rdb
sizeBytes

string (int64 format)

출력 전용입니다. 백업 파일의 크기(바이트)입니다.
createTime

string (Timestamp format)

출력 전용입니다. 백업 파일이 생성된 시간입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. '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)

출력 전용입니다. 암호화 정보가 업데이트된 가장 최근 시간입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.

도구 주석

파괴적 힌트: ❌ | 동일한 힌트: ✅ | 읽기 전용 힌트: ✅ | 오픈 월드 힌트: ❌