결과를 페이지로 나누기

이 페이지에서는 여러 다른 Cloud Storage 도구 및 라이브러리가 결과를 페이지로 나누는 방법을 설명합니다. 많은 수의 객체 또는 버킷을 나열할 때 페이지로 나누기가 필요합니다.

콘솔

Google Cloud 콘솔은 버킷 및 버킷 세부정보 페이지에서 버킷 및 객체 목록을 자동으로 페이지로 나눕니다.


버킷 페이지 열기

명령줄

Google Cloud CLI는 버킷 및 객체 목록을 자동으로 페이지로 나눕니다.

클라이언트 라이브러리

C++

클라이언트 라이브러리는 기본적으로 페이지로 나누기를 수행합니다. 페이지로 나누기를 지원하는 함수를 호출하면 응답에 iterator가 반환됩니다. 이 iterator가 사용되는 방식에 대한 자세한 내용은 ListObjects()의 C++ 참조 문서를 참조하세요.

C#

클라이언트 라이브러리는 기본적으로 페이지로 나누기를 수행합니다. 페이지로 나누기를 지원하는 함수를 호출하면 응답에 iterator가 반환됩니다. 이 iterator가 사용되는 방식에 대한 자세한 내용은 ListObjects()의 C# 참조 문서를 참조하세요.

Go

클라이언트 라이브러리는 기본적으로 페이지로 나누기를 수행합니다. 페이지로 나누기를 지원하는 함수를 호출하면 응답에 iterator가 반환됩니다. 이 iterator가 사용되는 방식에 대한 자세한 내용은 Bucket.Objects의 Go 참조 문서를 참조하세요.

자바

클라이언트 라이브러리는 기본적으로 페이지로 나누기를 수행합니다. 페이지로 나누기를 지원하는 함수를 호출하면 응답에 페이지 토큰이 반환됩니다. 사용 방법의 예는 Java 참조 문서를 참고하세요.

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 값을 전달하면 마지막 결과 이후에 시작하여 결과의 다음 페이지를 반환합니다.

예를 들어 my-bucket라는 버킷의 객체를 나열하는 요청의 응답에 nextPageToken가 포함되어 있다고 가정해 보겠습니다.

{
  "kind": "storage#objects",
  "nextPageToken": "CgtzaGliYS0yLmpwZw==",
  "items": [
    {
      OBJECT_1_METADATA
    },
    {
      OBJECT_2_METADATA
    },
    …
  ]
}

my-bucket에서 객체를 계속 나열하는 데 사용할 HTTP 요청은 다음과 같습니다.

GET https://storage.googleapis.com/storage/v1/b/my-bucket/o?pageToken=CgtzaGliYS0yLmpwZw==

결과를 페이지로 나누기에 대한 자세한 내용은 Objects: list 또는 Buckets: list의 JSON 참조 문서를 참조하세요.

XML API

페이지 나누기를 지원하는 함수를 호출할 때 목록이 불완전한 경우 응답 토큰 NextContinuationToken이 응답에 반환됩니다. NextContinuationToken은 마지막으로 반환된 결과를 나타냅니다. 후속 요청의 continuation-token 매개변수에 NextContinuationToken 값을 전달하면 마지막 결과 이후에 시작하여 결과의 다음 페이지를 반환합니다.

예를 들어 my-bucket라는 버킷의 객체를 나열하는 요청의 응답에 NextContinuationToken가 포함되어 있다고 가정해 보겠습니다.

<?xml version='1.0' encoding='UTF-8'?>
<ListBucketResult xmlns='http://doc.s3.amazonaws.com/2006-03-01'>
  <Name>my-bucket</Name>
  <NextContinuationToken>CgtzaGliYS0yLmpwZw==</NextContinuationToken>
  <KeyCount>2</KeyCount>
  <MaxKeys>2</MaxKeys>
  <IsTruncated>true</IsTruncated>
  <Contents>
    ...
  </Contents>
  ...
</ListBucketResult>

객체를 나열할 때 NextContinuationToken을 반환하려면 list-type을 2로 설정해야 합니다.

my-bucket에서 객체를 계속 나열하는 데 사용할 HTTP 요청에는 다음이 포함됩니다.

GET /?continuation-token=CgtzaGliYS0yLmpwZw==&list-type=2 HTTP/1.1
  Host: my-bucket.storage.googleapis.com

버킷 결과를 페이지로 나누기에 대한 자세한 안내는 List Objects의 XML 참조 문서를 참조하세요.

다음 단계