Method: projects.locations.memberships.list

특정 프로젝트 및 위치의 멤버십을 나열합니다.

HTTP 요청

GET https://gkehub.googleapis.com/v1beta1/{parent=projects/*/locations/*}/memberships

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

경로 매개변수

매개변수
parent

string

필수. 멤버십이 나열되는 상위 요소(프로젝트 및 위치)입니다. projects/*/locations/* 형식으로 지정됩니다. projects/*/locations/-는 모든 리전의 멤버십을 나열합니다.

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

  • gkehub.memberships.list

쿼리 매개변수

매개변수
pageSize

integer

선택사항입니다. 리소스의 '페이지'를 요청할 때 pageSize는 반환할 리소스 수를 지정합니다. 지정하지 않거나 0으로 설정된 경우 모든 리소스가 반환됩니다.

pageToken

string

선택사항입니다. 리소스를 계속 나열할 위치에서 목록의 위치를 지정하는 memberships.list에 대한 이전 호출로 반환된 토큰입니다.

filter

string

선택사항입니다. https://google.aip.dev/160에 설명된 구문을 따라 필터 표현식과 일치하는 멤버십을 나열합니다.

예:

  • foo-proj 프로젝트 및 global 위치의 이름이 bar인 멤버십:
  name = "projects/foo-proj/locations/global/membership/bar"
  • foo라는 라벨이 있는 멤버십:
  labels.foo:*
  • 값이 barfoo라는 라벨이 있는 멤버십:
  labels.foo = bar
  • CREATING 상태인 멤버십:
  state = CREATING
orderBy

string

선택사항입니다. 출력을 비교하고 정렬하는 데 사용할 하나 이상의 필드입니다. https://google.aip.dev/132#ordering을 참조하세요.

요청 본문

요청 본문은 비어 있어야 합니다.

응답 본문

GkeHubMembershipService.ListMemberships 메서드에 대한 응답 메시지입니다.

성공한 경우 응답 본문은 다음과 같은 구조의 데이터를 포함합니다.

JSON 표현
{
  "resources": [
    {
      object (Membership)
    }
  ],
  "nextPageToken": string,
  "unreachable": [
    string
  ]
}
필드
resources[]

object (Membership)

일치하는 멤버십 목록입니다.

nextPageToken

string

memberships.list 메서드에서 리소스의 다음 페이지를 요청하기 위한 토큰입니다. 빈 문자열 값은 반환할 리소스가 없음을 의미합니다.

unreachable[]

string

이 목록을 가져오는 동안 도달할 수 없는 위치 목록입니다.

승인 범위

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

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

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