스토리지 객체 업로드 및 다운로드

이 페이지에서는 Google Distributed Cloud (GDC) 에어 갭 어플라이언스 스토리지 버킷에 객체를 업로드하고 다운로드하는 방법을 설명합니다.

시작하기 전에

프로젝트 네임스페이스는 관리 API 서버에서 버킷 리소스를 관리합니다. 버킷 및 객체를 사용하려면 프로젝트가 있어야 합니다.

다음 작업을 수행하려면 적절한 버킷 권한도 있어야 합니다. 버킷 액세스 권한 부여를 참고하세요.

객체 이름 지정 가이드라인

다음 가이드라인에 따라 객체 이름을 지정하세요.

  • 객체 이름을 지정할 때는 UTF-8 문자를 사용하세요.
  • 개인 식별 정보 (PII)를 포함하지 마세요.

스토리지 버킷에 객체 업로드

객체를 업로드하려면 다음 명령어를 실행합니다.

gdcloud storage cp LOCAL_PATH s3://REMOTE_PATH
gdcloud storage cp s3://REMOTE_SOURCE_PATH s3://REMOTE_MOVE_DESTINATION_PATH
gdcloud storage mv s3://REMOTE_SOURCE_PATH s3://REMOTE_MOVE_DESTINATION_PATH

다음 명령어는 로컬 디렉터리의 모든 텍스트 파일을 버킷에 업로드합니다.

gdcloud storage cp *.txt s3://BUCKET

다음 명령어는 로컬 디렉터리에서 버킷으로 여러 파일을 업로드합니다.

gdcloud storage cp abc1.txt abc2.txt s3://BUCKET

폴더를 버킷에 업로드하려면 --recursive 옵션을 사용하여 전체 디렉터리 트리를 복사합니다. 다음 명령어는 디렉터리 트리 dir을 업로드합니다.

gdcloud storage cp dir s3://BUCKET --recursive

대형 객체의 경우 멀티파트 업로드를 실행하거나 업로드할 파일이 15MB보다 큰 경우 멀티파트 업로드를 자동으로 사용합니다. 이 경우 파일이 여러 부분으로 분할되며 각 부분의 크기는 15MB입니다. 마지막 부분은 더 작습니다. 각 파트는 별도로 업로드되며 전송이 완료되면 대상에서 재구성됩니다.

한 부분의 업로드가 실패하면 이미 업로드된 다른 부분에 영향을 주지 않고 업로드를 다시 시작할 수 있습니다.

멀티파트 업로드와 관련된 두 가지 옵션이 있습니다.

  • --disable-multipart: 모든 파일의 멀티파트 업로드를 사용 중지합니다.
  • --multipart-chunk-size-mb=SIZE: 멀티파트 업로드의 각 청크 크기를 설정합니다.

SIZE보다 큰 파일은 자동으로 멀티 스레드 멀티파트로 업로드됩니다. 작은 파일은 기존 방식으로 업로드됩니다. SIZE은 메가바이트 단위입니다. 기본 청크 크기는 15MB입니다. 허용되는 최소 청크 크기는 5MB이고 최대 청크 크기는 5GB입니다.

스토리지 버킷에서 객체 다운로드

버킷에서 객체를 가져오려면 다음을 실행하세요.

gdcloud storage cp s3://BUCKET/OBJECT LOCAL_FILE_TO_SAVE

버킷의 모든 텍스트 파일을 현재 디렉터리에 다운로드하려면 다음을 실행합니다.

gdcloud storage cp s3://BUCKET/*.txt .

버킷에서 현재 디렉터리로 텍스트 파일 abc.txt를 다운로드하려면 다음 명령어를 실행합니다.

gdcloud storage cp s3://BUCKET/abc.txt .

이전 버전의 파일을 다운로드하려면 먼저 파일의 모든 버전을 나열합니다.

gdcloud storage ls s3://BUCKET/abc.txt --all-versions

출력 예시:

s3://my-bucket/abc.txt#OEQxNTk4MUEtMzEzRS0xMUVFLTk2N0UtQkM4MjAwQkJENjND
s3://my-bucket/abc.txt#ODgzNEYzQ0MtMzEzRS0xMUVFLTk2NEItMjI1MTAwQkJENjND
s3://my-bucket/abc.txt#ODNCNDEzNzgtMzEzRS0xMUVFLTlDOUMtQzRDOTAwQjg3RTg3

그런 다음 버킷에서 현재 디렉터리로 텍스트 파일 abc.txt의 특정 버전을 다운로드합니다.

gdcloud storage cp s3://BUCKET/abc.txt#OEQxNTk4MUEtMzEzRS0xMUVFLTk2N0UtQkM4MjAwQkJENjND .