이 페이지에서는 로컬 파일 시스템에서 Cloud Storage 버킷에 객체를 업로드하는 방법을 보여줍니다. 업로드된 객체는 관련 메타데이터와 저장할 데이터로 구성됩니다. 파일 크기에 따라 최적의 업로드 방법을 선택하는 방법을 포함한 개념 개요는 업로드 및 다운로드를 참조하세요.
메모리에서 업로드에 대한 안내는 메모리에서 객체 업로드를 참조하세요.
필요한 역할
버킷에 객체를 업로드하는 데 필요한 권한을 얻으려면 관리자에게 버킷에 대한 스토리지 객체 사용자(roles/storage.objectUser) IAM 역할을 부여해 달라고 요청하세요. 이 사전 정의된 역할에는 객체를 버킷에 업로드하는 데 필요한 권한이 포함되어 있습니다. 필요한 정확한 권한을 보려면 필수 권한 섹션을 확장하세요.
필수 권한
storage.objects.createstorage.objects.delete- 이 권한은 기존 객체를 덮어쓰는 업로드에만 필요합니다.
storage.objects.get- 이 권한은 Google Cloud CLI를 사용하여 이 페이지의 태스크를 수행하려는 경우에만 필요합니다.
storage.objects.list- 이 권한은 Google Cloud CLI를 사용하여 이 페이지의 태스크를 수행하려는 경우에만 필요합니다. Google Cloud 콘솔을 사용하여 업로드한 객체를 확인하려면 이 권한도 필요합니다.
Google Cloud 콘솔을 사용하여 이 페이지의 작업을 수행하려면 스토리지 객체 사용자(roles/storage.objectUser) 역할에 포함되지 않은 storage.buckets.list 권한도 필요합니다. 이 권한을 얻으려면 관리자에게 프로젝트에 대한 스토리지 관리자(roles/storage.admin) 역할을 부여해 달라고 요청하세요.
다른 사전 정의된 역할이나 커스텀 역할을 사용하여 이러한 권한을 얻을 수도 있습니다.
버킷에 대한 역할 부여에 대한 자세한 내용은 버킷에 IAM 정책 설정 및 관리를 참조하세요.
버킷에 객체 업로드
버킷에 객체를 업로드하려면 다음 단계를 완료하세요.
콘솔
- Google Cloud 콘솔에서 Cloud Storage 버킷 페이지로 이동합니다.
버킷 목록에서 객체를 업로드할 버킷의 이름을 클릭합니다.
버킷의 객체 탭에서 다음 중 하나를 수행합니다.
바탕화면이나 파일 관리자에서 파일을 Google Cloud 콘솔의 기본 창으로 드래그합니다.
업로드 > 파일 업로드를 클릭하고 표시되는 대화상자에서 업로드할 이미지 파일을 선택한 다음 열기를 클릭합니다.
Google Cloud 콘솔에서 실패한 Cloud Storage 작업에 대한 자세한 오류 정보를 가져오는 방법은 문제 해결을 참조하세요.
명령줄
gcloud storage cp 명령어를 사용합니다.
gcloud storage cp OBJECT_LOCATION gs://DESTINATION_BUCKET_NAME
각 항목의 의미는 다음과 같습니다.
OBJECT_LOCATION: 객체의 로컬 경로. 예를 들면Desktop/dog.png입니다.DESTINATION_BUCKET_NAME: 객체를 업로드할 버킷의 이름. 예를 들면my-bucket입니다.
성공하면 응답은 다음 예시와 같습니다.
Completed files 1/1 | 164.3kiB/164.3kiB
클라이언트 라이브러리
C++
자세한 내용은 Cloud Storage C++ API 참조 문서를 확인하세요.
Cloud Storage에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 클라이언트 라이브러리의 인증 설정을 참조하세요.
C#
자세한 내용은 Cloud Storage C# API 참조 문서를 확인하세요.
Cloud Storage에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 클라이언트 라이브러리의 인증 설정을 참조하세요.
Go
자세한 내용은 Cloud Storage Go API 참조 문서를 확인하세요.
Cloud Storage에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 클라이언트 라이브러리의 인증 설정을 참조하세요.
Java
자세한 내용은 Cloud Storage Java API 참조 문서를 확인하세요.
Cloud Storage에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 클라이언트 라이브러리의 인증 설정을 참조하세요.
다음 샘플은 개별 객체를 업로드합니다.
다음 샘플은 객체 여러 개를 동시에 업로드합니다.
다음 샘플에서는 공통 프리픽스가 있는 모든 객체를 동시에 업로드합니다.
Node.js
자세한 내용은 Cloud Storage Node.js API 참조 문서를 확인하세요.
Cloud Storage에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 클라이언트 라이브러리의 인증 설정을 참조하세요.
다음 샘플은 개별 객체를 업로드합니다.
다음 샘플은 객체 여러 개를 동시에 업로드합니다.
다음 샘플에서는 공통 프리픽스가 있는 모든 객체를 동시에 업로드합니다.
PHP
자세한 내용은 Cloud Storage PHP API 참조 문서를 확인하세요.
Cloud Storage에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 클라이언트 라이브러리의 인증 설정을 참조하세요.
Python
자세한 내용은 Cloud Storage Python API 참조 문서를 확인하세요.
Cloud Storage에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 클라이언트 라이브러리의 인증 설정을 참조하세요.
다음 샘플은 개별 객체를 업로드합니다.
다음 샘플은 객체 여러 개를 동시에 업로드합니다.
다음 샘플에서는 공통 프리픽스가 있는 모든 객체를 동시에 업로드합니다.