Method: projects.locations.instances.create

특정 프로젝트 및 위치에 새 인스턴스를 만듭니다.

HTTP 요청

POST https://memorystore.googleapis.com/v1beta/{parent=projects/*/locations/*}/instances

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

경로 매개변수

매개변수
parent

string

필수 항목입니다. 이 인스턴스가 생성될 상위 리소스입니다. 형식: projects/{project}/locations/{location}

쿼리 매개변수

매개변수
instanceId

string

필수 항목입니다. 인스턴스에 사용할 ID이며, 인스턴스의 리소스 이름에서 마지막 구성 요소가 됩니다.

이 값에는 다음과 같은 제한사항이 적용됩니다.

  • 길이는 4~63자(영문 기준)여야 합니다.
  • 문자 또는 숫자로 시작해야 합니다.
  • 소문자, 숫자, 하이픈만 포함해야 합니다.
  • 하이픈으로 끝나면 안 됩니다.
  • 위치 내에서 고유해야 합니다.
requestId

string

선택사항입니다. 요청을 식별하는 선택적 요청 ID입니다. 요청을 다시 시도해야 하는 경우 서버가 이미 완료되었을 때 요청을 무시하도록 고유한 요청 ID를 지정합니다. 서버는 첫 번째 요청 후 최소 60분 동안 이를 보장합니다.

예를 들어 최초 요청을 수행하고 요청이 타임아웃되는 경우를 생각해 보세요. 동일한 요청 ID로 다시 요청을 수행하면 서버는 동일한 요청 ID를 가진 원래 작업이 수신되었는지 확인할 수 있으며 그럴 경우 두 번째 요청을 무시합니다. 이렇게 해서 클라이언트가 실수로 중복된 약정을 생성하지 않도록 방지합니다.

요청 ID는 유효한 UUID여야 하며, 0 UUID는 지원되지 않습니다(00000000-0000-0000-0000-000000000000).

요청 본문

요청 본문에 Instance의 인스턴스가 포함됩니다.

응답 본문

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

승인 범위

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

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

IAM 권한

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

  • memorystore.instances.create

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