이 페이지에서는 여러 다른 Cloud Storage 도구 및 라이브러리가 결과를 페이지로 나누는 방법을 설명합니다. 많은 수의 객체 또는 버킷을 나열할 때 페이지로 나누기가 필요합니다.
콘솔
Google Cloud 콘솔은 버킷 및 버킷 세부정보 페이지에서 버킷 및 객체 목록을 자동으로 페이지로 나눕니다.
명령줄
Google Cloud CLI는 버킷 및 객체 목록을 자동으로 페이지로 나눕니다.
클라이언트 라이브러리
C++
클라이언트 라이브러리는 기본적으로 페이지로 나누기를 수행합니다. 페이지로 나누기를 지원하는 함수를 호출하면 응답에 iterator가 반환됩니다. 이 iterator가 사용되는 방식에 대한 자세한 내용은 ListObjects()
의 C++ 참조 문서를 참조하세요.
C#
클라이언트 라이브러리는 기본적으로 페이지로 나누기를 수행합니다. 페이지로 나누기를 지원하는 함수를 호출하면 응답에 iterator가 반환됩니다. 이 iterator가 사용되는 방식에 대한 자세한 내용은 ListObjects()
의 C# 참조 문서를 참조하세요.
Go
클라이언트 라이브러리는 기본적으로 페이지로 나누기를 수행합니다. 페이지로 나누기를 지원하는 함수를 호출하면 응답에 iterator가 반환됩니다. 이 iterator가 사용되는 방식에 대한 자세한 내용은 Bucket.Objects
의 Go 참조 문서를 참조하세요.
자바
클라이언트 라이브러리는 기본적으로 페이지로 나누기를 수행합니다. 페이지로 나누기를 지원하는 함수를 호출하면 응답에 iterator가 반환됩니다. 이 iterator가 사용되는 방식에 대한 자세한 내용은 Storage.Objects.list
의 자바 참조 문서를 참조하세요.
Node.js
클라이언트 라이브러리는 기본적으로 페이지로 나누기를 수행합니다. 페이지로 나누기를 지원하는 함수를 호출하면 응답에 iterator가 반환됩니다. 이 iterator가 사용되는 방식에 대한 자세한 내용은 getFiles()
의 Node.js 참조 문서를 참조하세요.
PHP
클라이언트 라이브러리는 기본적으로 페이지로 나누기를 수행합니다. 페이지로 나누기를 지원하는 함수를 호출하면 응답에 iterator가 반환됩니다. 이 iterator가 사용되는 방식에 대한 자세한 내용은 Objects
의 PHP 참조 문서를 참조하세요.
Python
클라이언트 라이브러리는 기본적으로 페이지로 나누기를 수행합니다. 페이지로 나누기를 지원하는 함수를 호출하면 응답에 iterator가 반환됩니다. 이 iterator가 사용되는 방식에 대한 자세한 내용은 의 Python 참조 문서를 참조하세요.
Ruby
클라이언트 라이브러리는 기본적으로 페이지로 나누기를 수행합니다. 페이지로 나누기를 지원하는 함수를 호출하면 응답에 iterator가 반환됩니다. 이 iterator가 사용되는 방식에 대한 자세한 내용은 Google::Cloud::Storage::File::List
의 Ruby 참조 문서를 참조하세요.
REST API
JSON API
페이지 나누기를 지원하는 함수를 호출할 때 목록이 불완전한 경우 연속 토큰 nextPageToken
이 응답에 반환됩니다. nextPageToken
은 마지막으로 반환된 결과를 나타냅니다. 후속 요청의 pageToken
매개변수에 nextPageToken
값을 전달하면 마지막 결과 이후에 시작하여 결과의 다음 페이지를 반환합니다.
응답 예시
{ "kind": "storage#objects", "nextPageToken": "CgtzaGliYS0yLmpwZw==", "items": [ objects Resource … ] }
objects Resource
에 대한 자세한 내용은 객체 참조 문서를 참조하세요.
요청 예시
GET https://storage.googleapis.com/storage/v1/b/BUCKET_NAME&pageToken=NEXT_PAGE_TOKEN HTTP/1.1 Authorization: Bearer ACCESS_TOKEN Accept: application/json
각 항목의 의미는 다음과 같습니다.
- NEXT_PAGE_TOKEN은 이전 응답의
nextPageToken
값입니다. - BUCKET_NAME은 스토리지 버킷의 이름입니다.
- ACCESS_TOKEN은 OAuth 2.0 Playground에서 수신되는 액세스 토큰입니다.
결과를 페이지로 나누기에 대한 자세한 내용은 Objects: list
또는 Buckets: list
의 JSON 참조 문서를 참조하세요.
XML API
페이지 나누기를 지원하는 함수를 호출할 때 목록이 불완전한 경우 응답 토큰 NextContinuationToken
이 응답에 반환됩니다. NextContinuationToken
은 마지막으로 반환된 결과를 나타냅니다. 후속 요청의 continuation-token
매개변수에 NextContinuationToken
값을 전달하면 마지막 결과 이후에 시작하여 결과의 다음 페이지를 반환합니다.
응답 예시
HTTP/1.1 200 OK X-goog-metageneration: 5 Content-location: https://example-bucket.storage.googleapis.com?max-keys=2&list-type=2 Expires: Wed, 02 Mar 2022 15:58:11 GMT Content-length: 781 X-guploader-uploadid: ADPycdvFss2qs9wyMrrM2fIIZzTFFnZZM9i9k8TMbHipsxz8PqUjS5Xh_4tLsvb3_YYHTT0HmSYVv1Gtr816HQFnk28HMglyWA Cache-control: private, max-age=0 Date: Wed, 02 Mar 2022 15:58:11 GMT Content-type: application/xml; charset=UTF-8 <?xml version='1.0' encoding='UTF-8'?> <ListBucketResult xmlns='http://doc.s3.amazonaws.com/2006-03-01'> <Name>example_bucket</Name> <NextContinuationToken>CgtzaGliYS0yLmpwZw==</NextContinuationToken> <KeyCount>2</KeyCount> <MaxKeys>2</MaxKeys> <IsTruncated>true</IsTruncated> <Contents> ... </Contents> ... </ListBucketResult>
NextContinuationToken
을 반환하려면 list-type
을 2
로 설정해야 합니다.
요청 예시
GET /?continuation-token=NEXT_CONTINUATION_TOKEN&prefix=t&marker=test&list-type=2 HTTP/1.1 \ Host: BUCKET_NAME.storage.googleapis.com Date: Wed, 02 Mar 2022 16:00:00 GMT Content-Length: 0 Authorization: AUTHENTICATION_STRING
각 항목의 의미는 다음과 같습니다.
- NEXT_CONTINUATION_TOKEN은 이전 응답에서 수신한
NextContinuationToken
값입니다. - BUCKET_NAME은 스토리지 버킷의 이름입니다.
- AUTHENTICATION_STRING은 OAuth 2.0 Playground에서 수신되는 액세스 토큰입니다.
버킷 결과를 페이지로 나누기에 대한 자세한 안내는 List Objects
의 XML 참조 문서를 참조하세요.