Method: iceberg.v1.restcatalog.v1.projects.catalogs.namespaces.list

카탈로그의 Iceberg 네임스페이스를 나열합니다. 네임스페이스는 한 단계의 중첩만 지원됩니다.

HTTP 요청


GET https://biglake.googleapis.com/iceberg/v1/restcatalog/v1/{apiParent=projects/*/catalogs/*}/namespaces

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

경로 매개변수

매개변수
apiParent

string

필수 항목입니다. 리소스 경로의 상위입니다.

쿼리 파라미터

파라미터
pageToken

string

(선택사항) 결과의 다음 페이지를 가져오려면 이전 응답에서 반환된 pageToken을 지정하세요.

pageSize

integer

(선택사항) 페이지로 나누기를 지원하는 서버의 경우 클라이언트가 수신할 결과 수의 상한을 나타냅니다. 페이지로 나누기를 지원하지 않는 서버의 경우 클라이언트가 표시된 pageSize보다 큰 결과를 수신할 수 있습니다. 설정하지 않으면 기본값은 100입니다.

parent

string

(선택사항) 네임스페이스를 나열할 선택적 네임스페이스입니다. 제공되지 않거나 비어 있으면 모든 최상위 네임스페이스가 나열되어야 합니다. 상위 요소가 멀티파트 네임스페이스인 경우 파트는 단위 구분자 (0x1F) 바이트로 구분해야 합니다. 실제 부모가 아니므로 ST_NOT_REQUIRED입니다.

요청 본문

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

응답 본문

namespaces.list API의 응답 메시지입니다.

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

JSON 표현
{
  "namespaces": [
    array
  ],
  "next-page-token": string,
  "unreachable": [
    string
  ]
}
필드
namespaces[]

array (ListValue format)

네임스페이스 목록입니다.

next-page-token

string

페이지로 나누기를 위한 다음 페이지 토큰입니다.

unreachable[]

string

출력 전용입니다. 도달할 수 없어 건너뛴 위치 목록입니다. 비어 있지 않으면 결과 집합이 불완전할 수 있습니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

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

자세한 내용은 Authentication Overview를 참조하세요.