Method: projects.locations.instances.backup

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

HTTP 요청


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

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

경로 매개변수

매개변수
name

string

필수 항목입니다. projects/{projectId}/locations/{locationId}/instances/{instanceId} 형식을 사용하는 인스턴스 리소스 이름입니다. 여기서 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
  • https://www.googleapis.com/auth/memorystore.read-write

IAM 권한

name 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • memorystore.instances.backup

자세한 내용은 IAM 문서를 참조하세요.