객체 나열하기

이 페이지는 Cloud Storage 버킷에 저장된 객체를 이름별 사전순으로 정리하여 나열하는 방법을 설명합니다.

시작하기 전에

객체를 나열하는 데 필요한 권한을 얻으려면 관리자에게 나열할 객체가 포함된 버킷에 대한 스토리지 객체 뷰어(roles/storage.objectViewer) IAM 역할을 부여해달라고 요청하세요. 관리형 폴더 내의 객체를 나열하려면 버킷 대신 보려는 객체가 포함된 관리형 폴더에 roles/storage.objectViewer를 부여하면 됩니다.

Google Cloud 콘솔을 사용하여 이 페이지의 태스크를 수행하려면 관리자에게 스토리지 객체 뷰어(roles/storage.objectViewer) 역할 외에도 뷰어(roles/viewer) 기본 역할을 부여해 달라고 요청하세요.

이러한 역할에는 객체를 나열하는 데 필요한 권한이 포함되어 있습니다. 필요한 정확한 권한을 보려면 필수 권한 섹션을 확장하세요.

필수 권한

  • storage.objects.list
  • storage.buckets.list
    • 이 권한은 Google Cloud 콘솔을 사용하여 이 페이지의 태스크를 수행하려는 경우에만 필요합니다.

다른 사전 정의된 역할이나 커스텀 역할을 사용하여 이러한 권한을 얻을 수도 있습니다.

버킷의 역할 부여에 대한 자세한 내용은 버킷에 IAM 정책 설정 및 관리를 참조하세요.

버킷의 객체 나열

콘솔

  1. Google Cloud 콘솔에서 Cloud Storage 버킷 페이지로 이동합니다.

    버킷으로 이동

  2. 버킷 목록에서 콘텐츠를 볼 버킷의 이름을 클릭합니다.

명령줄

gcloud storage ls 명령어를 사용합니다.

gcloud storage ls gs://BUCKET_NAME

각 항목의 의미는 다음과 같습니다.

  • BUCKET_NAME은 나열하려는 객체가 포함된 버킷의 이름입니다. 예를 들면 my-bucket입니다.

클라이언트 라이브러리

C++

자세한 내용은 Cloud Storage C++ API 참조 문서를 확인하세요.

Cloud Storage에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 클라이언트 라이브러리의 인증 설정을 참조하세요.

다음 샘플은 버킷의 모든 객체를 나열합니다.

namespace gcs = ::google::cloud::storage;
[](gcs::Client client, std::string const& bucket_name) {
  for (auto&& object_metadata : client.ListObjects(bucket_name)) {
    if (!object_metadata) throw std::move(object_metadata).status();

    std::cout << "bucket_name=" << object_metadata->bucket()
              << ", object_name=" << object_metadata->name() << "\n";
  }
}

다음 샘플은 지정된 프리픽스가 있는 객체를 나열합니다.

namespace gcs = ::google::cloud::storage;
[](gcs::Client client, std::string const& bucket_name,
   std::string const& bucket_prefix) {
  for (auto&& object_metadata :
       client.ListObjects(bucket_name, gcs::Prefix(bucket_prefix))) {
    if (!object_metadata) throw std::move(object_metadata).status();

    std::cout << "bucket_name=" << object_metadata->bucket()
              << ", object_name=" << object_metadata->name() << "\n";
  }
}

C#

자세한 내용은 Cloud Storage C# API 참조 문서를 확인하세요.

Cloud Storage에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 클라이언트 라이브러리의 인증 설정을 참조하세요.

다음 샘플은 버킷의 모든 객체를 나열합니다.


using Google.Cloud.Storage.V1;
using System;
using System.Collections.Generic;

public class ListFilesSample
{