MCP Tools Reference: redis.googleapis.com

도구: list_backup_collections

모든 Memorystore for Redis 클러스터 백업 컬렉션을 나열합니다.

다음 샘플에서는 curl을 사용하여 list_backup_collections MCP 도구를 호출하는 방법을 보여줍니다.

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

입력 스키마

ListBackupCollections 요청입니다.

ListBackupCollectionsRequest

JSON 표현 
{
  "parent": string,
  "pageSize": integer,
  "pageToken": string
}
필드
parent

string

필수 항목입니다. 형식 projects/{project_id}/locations/{location_id}를 사용하는 backupCollection 위치의 리소스 이름입니다. 여기서 location_id는 Google Cloud 리전을 나타냅니다.
pageSize

integer

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

지정하지 않으면 서비스는 기본값인 1, 000을 사용합니다. page_size 값에 관계없이 응답에는 부분 목록이 포함될 수 있으며 호출자는 응답의 next_page_token만 사용하여 쿼리할 클러스터가 더 남아 있는지 확인해야 합니다.
pageToken

string

선택사항입니다. 이전 [ListBackupCollections] 요청에서 반환된 next_page_token 값입니다(있는 경우).

출력 스키마

ListBackupCollections에 대한 응답입니다.

ListBackupCollectionsResponse

JSON 표현 
{
  "backupCollections": [
    {
      object (BackupCollection)
    }
  ],
  "nextPageToken": string,
  "unreachable": [
    string
  ]
}
필드
backupCollections[]

object (BackupCollection)

프로젝트의 backupCollections 목록입니다.

요청의 상위 필드에 있는 location_id가 '-'이면 프로젝트에 사용 가능한 모든 리전이 쿼리되고 결과가 집계됩니다. 이러한 집계된 쿼리에서 위치를 사용할 수 없는 경우 자리표시자 backupCollection 항목이 응답에 포함되며 name 필드는 projects/{project_id}/locations/{location_id}/backupCollections/- 형식의 값으로 설정되고 status 필드는 ERROR로, status_message 필드는 'ListBackupCollections에 사용할 수 없는 위치'로 설정됩니다.
nextPageToken

string

결과의 다음 페이지를 검색하는 토큰이거나 목록에 더 이상 결과가 없으면 비어 있습니다.
unreachable[]

string

도달할 수 없는 위치입니다.

BackupCollection

JSON 표현 
{
  "name": string,
  "clusterUid": string,
  "cluster": string,
  "kmsKey": string,
  "uid": string,
  "createTime": string,
  "totalBackupSizeBytes": string,
  "totalBackupCount": string,
  "lastBackupTime": string
}
필드
name

string

식별자. 백업 컬렉션의 전체 리소스 경로입니다.
clusterUid

string

출력 전용입니다. 백업 컬렉션의 클러스터 uid입니다.
cluster

string

출력 전용입니다. 백업 컬렉션이 속한 클러스터의 전체 리소스 경로입니다. 예: projects/{project}/locations/{location}/clusters/{cluster}
kmsKey

string

출력 전용입니다. 이 백업 컬렉션에서 백업을 암호화하는 데 사용되는 KMS 키입니다.
uid

string

출력 전용입니다. 시스템에서 할당한 백업 컬렉션의 고유 식별자입니다.
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"입니다.
totalBackupSizeBytes

string (int64 format)

출력 전용입니다. 백업 컬렉션에 있는 모든 백업의 총 크기입니다.
totalBackupCount

string (int64 format)

출력 전용입니다. 백업 컬렉션에 있는 총 백업 수입니다.
lastBackupTime

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"입니다.

타임스탬프

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 사이여야 합니다.

도구 주석

파괴적 힌트: ❌ | 멱등성 힌트: ✅ | 읽기 전용 힌트: ✅ | 오픈 월드 힌트: ❌