Method: projects.locations.clusters.backup

Redis 클러스터를 백업합니다. 백업을 처음 만드는 경우 백엔드에 백업 컬렉션이 생성되며 이 백업은 이 컬렉션에 속합니다. 컬렉션과 백업 모두 리소스 이름이 있습니다. 백업은 각 샤드에 대해 실행됩니다. 실행을 수행할 복제본 (HA가 아닌 경우 기본 복제본)이 선택됩니다. 진행 중인 백업 또는 업데이트 작업이 있으면 백업 호출이 거부됩니다. 미리보기 중에 클러스터의 내부 소프트웨어 버전이 너무 오래된 경우 실제 백업 전에 중요 업데이트가 실행됩니다. 내부 소프트웨어 버전이 백업 기능에 필요한 최소 버전으로 업데이트되면 후속 백업에는 중요 업데이트가 필요하지 않습니다. 미리보기 후에는 백업에 필요한 중요 업데이트가 없습니다.

HTTP 요청

POST https://redis.googleapis.com/v1/{name=projects/*/locations/*/clusters/*}:backup

URL은 gRPC 트랜스코딩 문법을 사용합니다.

경로 매개변수

매개변수
name

string

필수 입력란입니다. projects/{projectId}/locations/{locationId}/clusters/{clusterId} 형식을 사용하는 Redis 클러스터 리소스 이름입니다. 여기서 locationId는 Google Cloud 리전을 나타냅니다.

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현
{
  "ttl": string,
  "backupId": string
}
필드
ttl

string (Duration format)

선택사항입니다. 백업이 만료되는 TTL입니다. 값 범위는 1일~100년입니다. 지정하지 않으면 기본값은 100년입니다.

소수점 아래가 최대 9자리까지이고 's'로 끝나는 초 단위 기간입니다. 예를 들면 "3.5s"입니다.

backupId

string

선택사항입니다. 생성할 백업의 ID입니다. 지정하지 않으면 기본값 ([YYYYMMDDHHMMSS]_[단축된 클러스터 UID])이 사용됩니다.

응답 본문

성공한 경우 응답 본문에 Operation의 인스턴스가 포함됩니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 Authentication Overview를 참조하세요.