Method: projects.locations.attachedClusters.list

특정 Google Cloud 프로젝트 및 리전의 모든 AttachedCluster 리소스를 나열합니다.

HTTP 요청

GET https://{endpoint}/v1/{parent=projects/*/locations/*}/attachedClusters

여기서 {endpoint}지원되는 서비스 엔드포인트 중 하나입니다.

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

경로 매개변수

매개변수
parent

string

필수 항목입니다. 이 AttachedCluster 리소스 컬렉션을 소유한 상위 위치입니다.

위치 이름은 projects/<project-id>/locations/<region> 형식으로 지정됩니다.

Google Cloud Platform 리소스 이름에 대한 자세한 내용은 리소스 이름을 참조하세요.

쿼리 매개변수

매개변수
pageSize

integer

반환할 최대 항목 수입니다.

지정하지 않으면 서비스는 기본값인 50을 사용합니다. pageSize 값에 관계없이 응답에는 부분 목록이 포함될 수 있으며 호출자는 응답의 nextPageToken만 사용하여 쿼리할 인스턴스가 더 남아 있는지 확인해야 합니다.

pageToken

string

이전 attachedClusters.list 요청에서 반환된 nextPageToken 값입니다(있는 경우).

요청 본문

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

응답 본문

AttachedClusters.ListAttachedClusters 메서드의 응답 메시지입니다.

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

JSON 표현
{
  "attachedClusters": [
    {
      object (AttachedCluster)
    }
  ],
  "nextPageToken": string
}
필드
attachedClusters[]

object (AttachedCluster)

지정된 Google Cloud Platform 프로젝트 및 리전의 AttachedCluster 리소스 목록입니다.

nextPageToken

string

결과의 다음 페이지를 검색하는 토큰으로, 목록에 결과가 더 이상 없으면 비어 있습니다.

승인 범위

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

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

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

IAM 권한

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

  • gkemulticloud.attachedClusters.list

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