Method: projects.locations.instances.backup

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

HTTP 요청

POST https://memorystore.googleapis.com/v1beta/{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]_[Shortened Instance UID] 가 사용됩니다.

응답 본문

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

승인 범위

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

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

IAM 권한

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

  • memorystore.instances.backup

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