Method: projects.locations.memberships.create

새 멤버십을 만듭니다.

현재 Google Cloud의 GKE 클러스터에만 지원됩니다.. 다른 클러스터를 등록하려면 https://cloud.google.com/kubernetes-engine/enterprise/multicluster-management/connect/registering-a-cluster의 안내를 따르세요.

HTTP 요청

POST https://gkehub.googleapis.com/v1alpha/{parent=projects/*/locations/*}/memberships

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

경로 매개변수

매개변수
parent

string

필수 항목입니다. 멤버십이 생성될 상위 요소(프로젝트 및 위치)입니다. projects/*/locations/* 형식으로 지정됩니다.

승인을 처리하려면 지정된 리소스 parent에 대해 다음과 같은 IAM 권한이 필요합니다.

  • gkehub.memberships.create

쿼리 매개변수

매개변수
membershipId

string

필수 항목입니다. 클라이언트가 선택한 멤버십 ID입니다. membershipId는 유효한 RFC 1123 준수 DNS 라벨이어야 합니다.

  1. 최대 63자(영문 기준)
  2. 소문자 영숫자 문자 또는 -로 구성되어야 합니다.
  3. 영숫자 문자로 시작하고 끝나야 합니다.

[a-z0-9]([-a-z0-9]*[a-z0-9])? 정규식으로 표현될 수 있으며, 최대 63자를 포함합니다.

requestId

string

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

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

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

요청 본문

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

응답 본문

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

승인 범위

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

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

자세한 내용은 인증 개요를 참조하세요.