메뉴
Amazon Simple Storage Service
개발자 안내서 (API Version 2006-03-01)

Ruby용 AWS SDK 사용 - 버전 2

Ruby용 AWS SDK에서는 Amazon S3 버킷 및 객체 작업용 API를 제공합니다. 객체 작업의 경우 단일 작업에서 API를 사용하여 객체를 업로드하거나 대용량 객체를 여러 부분으로 나누어 업로드할 수 있습니다(멀티파트 업로드를 사용하여 객체 업로드하기 참조). 그러나 단일 작업 업로드용 API에서도 마찬가지로 대용량 객체를 수용할 수 있으며, 백그라운드에서 파트의 업로드를 관리함으로써 쓰기 작업이 필요한 스크립트 수를 줄입니다.

Ruby API 구성

Ruby용 AWS SDK를 사용하여 Amazon S3 애플리케이션을 작성할 경우 Ruby용 SDK gem을 설치해야 합니다. 자세한 정보는 Ruby - 버전 2용 AWS SDK를 참조하십시오. 설치 후에는 다음 주요 클래스를 포함한 API에 액세스할 수 있습니다.

  • Aws::S3::Resource - Ruby SDK용 Amazon S3 인터페이스를 표시하고 버킷을 생성 및 열거하는 메서드를 제공합니다.

    S3 클래스는 기존 버킷에 액세스하고 새 버킷을 생성하기 위한 #buckets 인스턴스 메서드를 제공합니다.

  • Aws::S3::Bucket - Amazon S3 버킷을 표시합니다. 

    Bucket 클래스는 버킷의 객체에 액세스하기 위한 #object(key)#objects 메서드 및 버킷을 삭제하기 위한 메서드를 제공하며 버킷 정책과 같은 버킷에 대한 정보를 반환합니다.

  • Aws::S3::Object - 해당 키로 식별된 Amazon S3 객체를 표시합니다.

    Object 클래스는 객체 속성 가져오기 및 설정, 객체 저장을 위한 스토리지 클래스 지정, 액세스 제어 목록을 사용한 객체 권한 설정에 필요한 메서드를 제공합니다. 또한 Object 클래스에는 객체의 삭제, 업로드, 복사를 위한 메서드가 포함되어 있습니다. 객체를 여러 부분으로 업로드할 경우 이 클래스는 업로드된 파트의 순서와 파트 크기를 지정하는 옵션을 제공합니다.

Ruby API용 AWS SDK에 대한 자세한 정보는 Ruby - 버전 2용 AWS SDK를 참조하십시오.

Ruby 스크립트 예제 테스트

Ruby 스크립트 예제를 시작하는 가장 쉬운 방법은 최신 Ruby용 AWS SDK gem을 설치하는 것입니다. 최신 gem으로 설치 및 업데이트에 대한 자세한 정보는 Ruby - 버전 2용 AWS SDK를 참조하십시오. 다음 작업은 Ruby용 AWS SDK를 설치했다는 가정 하에 Ruby 스크립트 예제의 작성 및 테스트 과정을 안내합니다.

Ruby 스크립트 예제의 일반적인 작성 및 테스트 프로세스

1

AWS에 액세스하려면 Ruby용 SDK 애플리케이션에 대한 자격 증명 세트를 제공해야 합니다. 자세한 내용은 Setting up AWS Credentials for Use with the SDK for Ruby 단원을 참조하십시오.

2

새 Ruby용 SDK 스크립트를 만들어 다음 줄을 스크립트 맨 앞에 추가합니다.

Copy
#!/usr/bin/env ruby require 'rubygems' require 'aws-sdk'

첫 번째 줄은 인터프리터 명령이며 두 개의 require 문은 필요한 gem 두 개를 스크립트로 가져옵니다.

3

읽고 있는 섹션에서 코드를 스크립트로 복사합니다.

4

필요한 데이터를 모두 제공하여 코드를 업데이트합니다. 예를 들어 파일을 업로드하는 경우 파일 경로 및 버킷 이름을 제공합니다.

5

스크립트를 실행합니다. AWS Management Console을 사용하여 버킷 및 객체에 대한 변경 사항을 확인합니다. AWS Management Console에 대한 자세한 내용은 https://aws.amazon.com/console/을 참조하십시오.

Ruby 샘플

다음 링크에는 Ruby용 SDK - 버전 2를 시작하는 데 도움이 되는 샘플이 있습니다.