Uso de la versión 3 de AWS SDK for Ruby - Amazon Simple Storage Service
La organización de la API de RubyPrueba de ejemplos de script de Ruby

Uso de la versión 3 de AWS SDK for Ruby

AWS SDK for Ruby proporciona una API para las operaciones de buckets y objetos de Amazon S3. Para operaciones de objeto, puede utilizar la API para cargar objetos en una sola operación o cargar objetos grandes en partes (consulte Carga de un objeto con la carga multiparte). Sin embargo, la API para la carga en una sola operación también puede aceptar objetos grandes y administrar en segundo plano la carga por partes, de modo que sea necesario escribir menos líneas de script.

La organización de la API de Ruby

Cuando crea aplicaciones de Amazon S3 con AWS SDK for Ruby, debe instalar la gema del SDK para Ruby. Para obtener más información, consulte SDK de AWS para Ruby, versión 3. Una vez instalado, puede obtener acceso a la API, incluidas las siguientes clases de clave:

  • Aws::S3::Resource: representa la interfaz para Amazon S3 para el SDK de Ruby y brinda métodos para crear y enumerar buckets.

    La clase S3 proporciona el método de instancia #buckets para obtener acceso a los buckets existentes o crear nuevos.

  • Aws::S3::Bucket: representa un bucket de Amazon S3. 

    La clase Bucket proporciona los métodos #object(key) y #objects para obtener acceso a objetos en un bucket, así como métodos para eliminar un bucket y devolver información acerca de este, como la política de bucket.

  • Aws::S3::Object: representa un objeto de Amazon S3 identificado con su clave.

    La clase Object proporciona métodos para obtener y configurar propiedades de un objeto, especificar la clase de almacenamiento para almacenar objetos, y configurar permisos de objetos con listas de control de acceso. La clase Object también tiene métodos para eliminar, cargar y copias objetos. Cuando carga objetos en partes, esta clase brinda opciones para que pueda especificar el orden de las partes cargadas y el tamaño de la parte.

Para obtener más información acerca de la API del SDK de AWS para Ruby, consulte SDK de AWS para Ruby, versión 2.

Prueba de ejemplos de script de Ruby

La forma más sencilla de comenzar con los ejemplos de script de Ruby es instalar la última versión de la gema AWS SDK for Ruby. Para obtener información acerca de la instalación de la versión más reciente de la gema o su actualización, consulte SDK de AWS para Ruby, versión 3. Las siguientes tareas lo guían a través de la creación y las pruebas de los ejemplos de script de Ruby asumiendo que usted ya instaló AWS SDK for Ruby.

1

Para obtener acceso a AWS, debe proporcionar un conjunto de credenciales para su aplicación del SDK para Ruby. Para obtener más información, consulte Configuración del SDK de AWS para Ruby.

2

Cree un nuevo script de SDK para Ruby y añada las siguientes líneas en la parte superior del script. 

#!/usr/bin/env ruby

require 'rubygems'
require 'aws-sdk-s3'

La primera línea es la directiva de intérprete y las dos instrucciones require importan dos gemas requeridas a su script.

3

Copie el código de la sección que lee en su script.

4

 Actualice el código con cualquier dato requerido. Por ejemplo, si carga un archivo, proporcione la ruta del archivo y el nombre del bucket.

5

Ejecute el script. Verifique los cambios en los buckets y los objetos con la AWS Management Console. Para obtener más información acerca de la AWS Management Console, visite https://aws.amazon.com/console/.
Muestras de Ruby

Los siguientes enlaces incluyen ejemplos que lo ayudan a comenzar con la versión 3 de SDK para Ruby: