Object Storage CLI
  • PDF

Object Storage CLI

  • PDF

Classic/VPC 환경에서 이용 가능합니다 .

Amazon S3 CLI와 호환되는 Object Storage CLI의 초기 설정 방법부터 간단한 사용 방법 등을 확인합니다.

초기 설정

Object Storage CLI를 사용하기 위한 설치와 인증 방법을 설명합니다.

설치

설치 명령어는 다음과 같습니다.

pip install awscli==1.15.85
참고

인증

인증 정보를 설정하는 방법은 다음과 같습니다.

~$ aws configure
AWS Access Key ID [****************leLy]: ACCESS_KEY_ID
AWS Secret Access Key [None]: SECRET_KEY
Default region name [None]: [Enter]
Default output format [None]: [Enter]

주의 사항

Role을 부여받은 서버에서 사용 시 주의해야 할 내용을 설명합니다. Role을 부여 받은 서버는 별도의 configure 없이 Object Storage 명령을 사용할 수 있습니다.
Role을 부여 받은 서버에서 사용 시 Metadata API 중 인증키 조회 API를 사용합니다. 단, 이 과정에서 timeout이 발생할 수 있기 때문에 필요한 경우 다음 명령을 통해 Metadata API timeout을 늘려 사용할 수 있습니다.

export AWS_METADATA_SERVICE_TIMEOUT=10

CLI 이용 시 --endpoint-url 옵션은 필수값입니다. 리전별 호출 도메인은 Object Storage API 가이드를 참고해 주십시오.

명령어 도움말

Object Storage CLI의 원활한 사용을 위해 도움말을 확인하려면 다음 명령어를 실행해 주십시오.

aws help
aws <command> help
aws <command> <subcommand> help

명령어

Object Storage CLI를 설명합니다.

버킷 목록 조회

버킷 목록을 조회하는 명령어는 다음과 같습니다.

  • high-level
    aws --endpoint-url=https://kr.object.gov-ncloudstorage.com s3 ls
    
  • API-level
    aws --endpoint-url=https://kr.object.gov-ncloudstorage.com s3api list-buckets
    

오브젝트 목록 조회

오브젝트 목록을 조회하는 명령어는 다음과 같습니다.

  • high-level
    aws --endpoint-url=https://kr.object.gov-ncloudstorage.com s3 ls s3://<bucket_name>
    
  • API-level
    aws --endpoint-url=https://kr.object.gov-ncloudstorage.com s3api list-objects --bucket <bucket_name>
    

오브젝트 업로드

오브젝트를 업로드하는 명령어는 다음과 같습니다.

  • high-level
    aws --endpoint-url=https://kr.object.gov-ncloudstorage.com s3 cp <local_file_path> s3://<bucket_name>[/<object_name>]
    
  • API-level
    aws --endpoint-url=https://kr.object.gov-ncloudstorage.com s3api put-object --bucket <bucket_name> --key <object_name> --body <local_file_path>
    

오브젝트 삭제

오브젝트를 삭제하는 명령어는 다음과 같습니다.

  • high-level
    aws --endpoint-url=https://kr.object.gov-ncloudstorage.com s3 rm s3://<bucket_name>/<object_name>
    
  • API-level
    aws --endpoint-url=https://kr.object.gov-ncloudstorage.com s3api delete-object --bucket <bucket_name> --key <object_name>
    

버킷 삭제

버킷을 삭제하는 명령어는 다음과 같습니다.

  • high-level
    aws --endpoint-url=https://kr.object.gov-ncloudstorage.com s3 rb s3://<bucket_name>
    
    force 옵션을 추가하면 비어있지 않은 버킷을 삭제할 수 있습니다. 버킷에 속해있는 오브젝트를 모두 삭제한 후 버킷을 삭제합니다.
    aws --endpoint-url=https://kr.object.gov-ncloudstorage.com s3 rb s3://<bucket_name> --force
    
  • API-level
    aws --endpoint-url=https://kr.object.gov-ncloudstorage.com s3api delete-bucket --bucket <bucket_name>
    
    참고

    API-level의 경우 비어있지 않은 버킷을 삭제할 수 없습니다.

동기화

동기화 기능은 high-level 명령으로만 수행할 수 있습니다. --delete 옵션을 사용하면 source에 없는 파일은 destination에서 삭제합니다. 동기화 명령어는 다음과 같습니다.

  • high-level
    • Object Storage의 버킷(폴더)의 모든 파일을 로컬에 동기화
      aws --endpoint-url=https://kr.object.gov-ncloudstorage.com s3 sync s3://<bucket_name>[/<object_name>] <local_directory_name>
      
    • 로컬 디렉토리의 모든 파일을 Object Storage의 버킷(폴더)에 동기화
      aws --endpoint-url=https://kr.object.gov-ncloudstorage.com s3 sync <local_directory_name> s3://<bucket_name>[/<object_name>]
      
    • Object Storage의 버킷(폴더)의 모든 파일을 다른 버킷(폴더)에 동기화
      aws --endpoint-url=https://kr.object.gov-ncloudstorage.com s3 sync s3://<source_bucket_name>[/<destination_object_name>] s3://<destination_bucket_name>[/<destination_object_name>]
      

접근 제어 목록(ACL)

Object Storage 버킷(폴더)의 파일에 대한 접근 제어 목록(ACL)권한을 설정할 수 있습니다. 접근 제어 목록 기능은 API-level 명령으로만 수행할 수 있습니다. 명령어는 다음과 같습니다.

  • API-level
    • Object Storage 버킷의 파일을 [공개]로 설정
      aws --endpoint-url=https://kr.object.gov-ncloudstorage.com s3api put-object-acl --bucket <bucket_name> --key <object_name> --acl public-read
      
    • Object Storage 버킷의 파일을 [공개 안함]으로 설정
      aws --endpoint-url=https://kr.object.gov-ncloudstorage.com s3api put-object-acl --bucket <bucket_name> --key <object_name> --acl private
      

디버깅

디버깅 관련 명령어는 다음과 같습니다.

  • --debug* 옵션을 사용하여 자세한 로그 확인
    aws --endpoint-url=https://kr.object.gov-ncloudstorage.com s3 cp <local_file_path> s3://<bucket_name>[/<object_name>] --debug
    
  • 로그 파일로 저장
    aws --endpoint-url=https://kr.object.gov-ncloudstorage.com s3 cp <local_file_path> s3://<bucket_name>[/<object_name>] --debug 2> debug.log
    

이 문서가 도움이 되었습니까?

Changing your password will log you out immediately. Use the new password to log back in.
First name must have atleast 2 characters. Numbers and special characters are not allowed.
Last name must have atleast 1 characters. Numbers and special characters are not allowed.
Enter a valid email
Enter a valid password
Your profile has been successfully updated.