Method: projects.locations.instances.list

특정 프로젝트 및 위치의 인스턴스를 나열합니다.

HTTP 요청

GET https://memorystore.googleapis.com/v1alpha/{parent=projects/*/locations/*}/instances

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

경로 매개변수

매개변수
parent

string

(필수 항목) 인스턴스를 나열할 상위 요소입니다. 형식: projects/{project}/locations/{location}

쿼리 매개변수

매개변수
pageSize

integer

(선택사항) 요청한 페이지 크기입니다. 서버에서 요청한 것보다 적은 항목을 반환할 수 있습니다. 지정하지 않으면 서버에서 적절한 기본값을 선택합니다.
pageToken

string

(선택사항) 서버에서 반환할 결과 페이지를 식별하는 토큰입니다.
filter

string

(선택사항) 결과 필터링 표현식입니다.
orderBy

string

(선택사항) 정의된 순서대로 결과를 정렬합니다. 지원되는 값은 'name', 'createTime'입니다.

요청 본문

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

응답 본문

[instances.list][]의 응답 메시지입니다. 지정된 위치의 인스턴스 목록입니다.

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

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

object (Instance)

요청된 {location}이 '-'인 경우 응답에 모든 위치의 인스턴스 목록이 포함됩니다. 연결할 수 없는 위치의 인스턴스는 생략됩니다.
nextPageToken

string

다음 페이지를 검색하기 위해 pageToken으로 전송할 수 있는 토큰입니다. 이 필드를 생략하면 후속 페이지가 표시되지 않습니다.
unreachable[]

string

도달할 수 없는 위치입니다.

승인 범위

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

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

IAM 권한

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

  • memorystore.instances.list

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