<p>SDK de AWS para Ruby </p><p>Developer Guide </p><p>SDK de AWS para Ruby: Developer Guide </p><p>Copyright © Amazon Web Services, Inc. and/or its affiliates. All rights reserved. </p><p>SDK de AWS para Ruby Developer Guide </p><p>Las marcas comerciales y la imagen comercial de Amazon no se pueden utilizar en relación con ningún producto o servicio que no sea de Amazon de ninguna manera que pueda causar confusión entre los clientes y que menosprecie o desacredite a Amazon. Todas las demás marcas comerciales que no son propiedad de Amazon son propiedad de sus respectivos propietarios, que pueden o no estar afiliados, conectados o patrocinados por Amazon. </p><p>SDK de AWS para Ruby Developer Guide </p><p>Table of Contents </p><p><a href="#7_0">AWSGuía para desarrolladores de SDK for Ruby </a>................................................................................... <a href="#7_0">1 </a><br><a href="#7_1">Mediante laAWSSDK for Ruby conAWS Cloud9 </a>.............................................................................. <a href="#7_1">1 </a><a href="#7_2">Acerca de esta guía </a>................................................................................................................... <a href="#7_2">1 </a><a href="#8_0">Documentación y recursos adicionales </a>.......................................................................................... <a href="#8_0">2 </a><br><a href="#8_1">Implementación enAWSCloud </a>............................................................................................... <a href="#8_1">2 </a><br><a href="#8_2">Mantenimiento y soporte para las versiones principales del SDK </a>........................................................ <a href="#8_2">2 </a><br><a href="#9_0">Introducción </a>....................................................................................................................................... <a href="#9_0">3 </a><br><a href="#9_1">Guía de inicio rápido </a>................................................................................................................... <a href="#9_1">3 </a><br><a href="#9_2">Escribir el código </a>................................................................................................................ <a href="#9_2">3 </a><a href="#9_3">Ejecutar el código </a>............................................................................................................... <a href="#9_3">3 </a><a href="#9_4">Nota para usuarios de Windows </a>........................................................................................... <a href="#9_4">3 </a><br><a href="#10_0">Instalación del SDK de </a>................................................................................................................ <a href="#10_0">4 </a><br><a href="#10_1">Prerequisites </a>...................................................................................................................... <a href="#10_1">4 </a><a href="#10_2">Instalación del SDK de </a>........................................................................................................ <a href="#10_2">4 </a><br><a href="#10_3">Tutorial Hello World </a>.................................................................................................................... <a href="#10_3">4 </a><br><a href="#11_0">Mediante laAWSSDK for Ruby en su programa </a>....................................................................... <a href="#11_0">5 </a><a href="#11_1">Creación de un recurso de Amazon S3 </a>................................................................................. <a href="#11_1">5 </a><a href="#11_2">Creación de un bucket </a>........................................................................................................ <a href="#11_2">5 </a><a href="#11_3">Añadir un archivo al bucket </a>.................................................................................................. <a href="#11_3">5 </a><a href="#11_4">Mostrar el contenido de un bucket </a>........................................................................................ <a href="#11_4">5 </a><a href="#11_5">Programa completo </a>............................................................................................................. <a href="#11_5">5 </a><a href="#13_0">Ejecución del programa </a>....................................................................................................... <a href="#13_0">7 </a><a href="#13_1">Pasos siguientes </a>................................................................................................................ <a href="#13_1">7 </a><br><a href="#14_0">Configuración del SDK </a>........................................................................................................................ <a href="#14_0">8 </a><br><a href="#14_1">Obtener suAWSclaves de acceso </a>................................................................................................. <a href="#14_1">8 </a><br><a href="#14_2">Para obtener su ID de clave de acceso y la clave de acceso secreta </a>.......................................... <a href="#14_2">8 </a><br><a href="#15_0">Configuración de las credenciales de AWS </a>.................................................................................... <a href="#15_0">9 </a><br><a href="#15_1">Configuración de las credenciales compartidas </a>....................................................................... <a href="#15_1">9 </a><a href="#15_2">Configuración de las credenciales mediante variables de entorno </a>............................................... <a href="#15_2">9 </a><a href="#16_0">Configuración de las credenciales mediante</a><a href="#16_0">Aws.confi</a><a href="#16_0">g</a>........................................................ <a href="#16_0">10 </a><a href="#16_1">Cambio de la ubicación de las credenciales </a>.......................................................................... <a href="#16_1">10 </a><a href="#16_2">Configuración de las credenciales en un objeto del cliente </a>...................................................... <a href="#16_2">10 </a><a href="#16_3">Configuración de las credenciales mediante IAM </a>................................................................... <a href="#16_3">10 </a><br><a href="#17_0">Creación de un token de acceso de AWS STS </a>............................................................................. <a href="#17_0">11 </a><a href="#17_1">Configuración de una región </a>....................................................................................................... <a href="#17_1">11 </a><br><a href="#17_2">Configuración de la región mediante variables de entorno </a>....................................................... <a href="#17_2">11 </a><a href="#17_3">Configuración de la región mediante</a><a href="#17_3">Aws.confi</a><a href="#17_3">g</a>.................................................................. <a href="#17_3">11 </a><a href="#18_0">Configuración de la región en un objeto de recurso </a>................................................................ <a href="#18_0">12 </a><br><a href="#18_1">Configuración de un punto de enlace no estándar </a>......................................................................... <a href="#18_1">12 </a><a href="#18_2">SDK Metrics </a>............................................................................................................................. <a href="#18_2">12 </a><br><a href="#18_3">Autorizar las métricas del SDK </a>........................................................................................... <a href="#18_3">12 </a><a href="#20_0">Configuración de SDK Metrics </a>............................................................................................ <a href="#20_0">14 </a><a href="#23_0">Definiciones de métricas del SDK </a>....................................................................................... <a href="#23_0">17 </a><br><a href="#25_0">UsoAWS Cloud9con SDK </a>.................................................................................................................. <a href="#25_0">19 </a><br><a href="#25_1">Paso 1: Configure elAWSCuenta para utilizarAWS Cloud9 </a>.............................................................. <a href="#25_1">19 </a><a href="#25_2">Paso 2: Configure elAWS Cloud9Entorno de desarrollo </a>.................................................................. <a href="#25_2">19 </a><a href="#26_0">Paso 3: Configurar laAWSSDK de para Ruby </a>................................................................................ <a href="#26_0">20 </a><a href="#26_1">Paso 4: Descarga del código de ejemplo </a>...................................................................................... <a href="#26_1">20 </a><a href="#26_2">Paso 5: Ejecutar código de ejemplo </a>............................................................................................. <a href="#26_2">20 </a><br><a href="#27_0">Uso del SDK </a>.................................................................................................................................... <a href="#27_0">21 </a><br><a href="#27_1">Mediante laAWSHerramienta SDK for Ruby </a>................................................................................. <a href="#27_1">21 </a><a href="#27_2">Uso del SDK con Ruby on Rails </a>................................................................................................ <a href="#27_2">21 </a><a href="#28_0">Migración de la versión 1 o 2 a la versión 3 deAWSSDK de para Ruby </a>............................................ <a href="#28_0">22 </a><br><a href="#28_1">Uso en paralelo </a>................................................................................................................ <a href="#28_1">22 </a></p><p>iii <br>SDK de AWS para Ruby Developer Guide </p><p><a href="#28_2">Diferencias generales </a>........................................................................................................ <a href="#28_2">22 </a><a href="#29_0">Diferencias del cliente </a>....................................................................................................... <a href="#29_0">23 </a><a href="#29_1">Diferencias en los recursos </a>................................................................................................ <a href="#29_1">23 </a><br><a href="#30_0">Consejo de depuración: Obtener información del rastro de red de un cliente </a>...................................... <a href="#30_0">24 </a><a href="#0_0">Stub: respuestas y errores de cliente </a>.......................................................................................... <a href="#0_0">25 </a><br><a href="#0_1">Stub: respuestas de cliente </a>................................................................................................ <a href="#0_1">25 </a><a href="#0_2">Stub: errores de cliente </a>..................................................................................................... <a href="#0_2">26 </a><br><a href="#0_3">Paginación de los datos de respuesta </a>........................................................................................ <a href="#0_3">26 </a><br><a href="#0_4">Las respuestas paginadas se pueden enumerar </a>.................................................................... <a href="#0_4">26 </a><a href="#0_5">Administrar respuestas paginadas manualmente </a>.................................................................... <a href="#0_5">27 </a><a href="#0_6">Clases de datos paginados </a>................................................................................................ <a href="#0_6">27 </a><br><a href="#0_7">Uso de esperadores </a>................................................................................................................. <a href="#0_7">27 </a><br><a href="#0_8">Llamada a un esperador </a>.................................................................................................... <a href="#0_8">27 </a><a href="#0_9">Errores de espera </a>............................................................................................................. <a href="#0_9">28 </a><a href="#0_10">Configuración de un esperador </a>........................................................................................... <a href="#0_10">28 </a><a href="#0_11">Ampliación de un esperador </a>............................................................................................... <a href="#0_11">28 </a><br><a href="#0_12">Especificación de la duración del tiempo de espera de un cliente </a>.................................................... <a href="#0_12">29 </a><br><a href="#0_5">Ejemplos de código </a>........................................................................................................................... <a href="#0_5">30 </a><br><a href="#0_13">AWS CloudTrail Ejemplos </a>.......................................................................................................... <a href="#0_13">30 </a><br><a href="#0_14">Listado de registros de seguimiento de CloudTrail </a>................................................................ <a href="#0_14">31 </a><a href="#0_15">Creación de un CloudTrail de </a>............................................................................................ <a href="#0_15">31 </a><a href="#0_16">Listado de eventos de seguimiento de CloudTrail </a>................................................................. <a href="#0_16">33 </a><a href="#0_17">Eliminación de un registro de seguimiento de CloudTrail il </a>...................................................... <a href="#0_17">34 </a><br><a href="#0_18">Ejemplos de Amazon CloudWatch </a>............................................................................................... <a href="#0_18">35 </a><br><a href="#0_19">Obtener información acerca de las alarmas de Amazon CloudWatch </a>........................................ <a href="#0_19">35 </a><a href="#0_20">Creación de una alarma de Amazon CloudWatch </a>................................................................. <a href="#0_20">37 </a><a href="#0_21">Habilitación y deshabilitación de acciones de alarma de Amazon CloudWatch </a>........................... <a href="#0_21">39 </a><a href="#0_22">Obtener información acerca de métricas personalizadas para Amazon CloudWatch </a>.................... <a href="#0_22">42 </a><a href="#0_23">Envío de eventos a Amazon CloudWatch Events </a>.................................................................. <a href="#0_23">44 </a><br><a href="#0_24">AWS CodeBuild Ejemplos </a>.......................................................................................................... <a href="#0_24">57 </a><br><a href="#0_25">Obtener información acerca de todos los proyectos AWS CodeBuild </a>........................................ <a href="#0_25">58 </a><a href="#0_26">Compilación de un proyecto de AWS CodeBuild </a>................................................................... <a href="#0_26">58 </a><a href="#0_27">Lista de compilaciones de proyectos de AWS CodeBuild </a>....................................................... <a href="#0_27">59 </a><br><a href="#0_28">Ejemplos de Amazon DynamoDB </a>................................................................................................ <a href="#0_28">59 </a><br><a href="#0_29">Obtener información acerca de todas las tablas de Amazon DynamoDB </a>................................... <a href="#0_29">60 </a><a href="#0_30">Creación de una tabla de Amazon DynamoDB </a>..................................................................... <a href="#0_30">61 </a><a href="#0_31">Añadir un elemento a una tabla de Amazon DynamoDB </a>........................................................ <a href="#0_31">63 </a><a href="#0_32">Carga de elementos desde un archivo JSON en una tabla de Amazon DynamoDB </a>..................... <a href="#0_32">64 </a><a href="#0_33">Lectura de un elemento en una tabla de Amazon DynamoDB </a>................................................. <a href="#0_33">66 </a><a href="#0_34">Actualización de un elemento de tabla de Amazon DynamoDB </a>............................................... <a href="#0_34">67 </a><a href="#0_35">Eliminación de un elemento de tabla de Amazon DynamoDB </a>.................................................. <a href="#0_35">69 </a><a href="#0_36">Eliminación de una tabla de Amazon DynamoDB </a>................................................................. <a href="#0_36">70 </a><br><a href="#0_5">Ejemplos de Amazon EC2 </a>......................................................................................................... <a href="#0_5">71 </a><br><a href="#0_37">Creación de una VPC de Amazon EC2 </a>............................................................................... <a href="#0_37">71 </a><a href="#0_38">Creación de una Internet Gateway y su asociación a una VPC en Amazon EC2 </a>......................... <a href="#0_38">73 </a><a href="#0_39">Creación de una subred pública para Amazon EC2 </a>.............................................................. <a href="#0_39">74 </a><a href="#0_40">Creación de una tabla de ruteo Amazon EC2 y su asociación a una subred </a>.............................. <a href="#0_40">76 </a><a href="#0_41">Uso de direcciones IP elásticas en Amazon EC2 </a>.................................................................. <a href="#0_41">78 </a><a href="#0_20">Creación de un grupo de seguridad de Amazon EC2 </a>............................................................ <a href="#0_20">82 </a><a href="#0_42">Uso de grupos de seguridad de Amazon EC2 </a>...................................................................... <a href="#0_42">84 </a><a href="#0_39">Uso de pares de claves en Amazon EC2 </a>............................................................................ <a href="#0_39">89 </a><a href="#0_43">Obtener información acerca de todas las instancias Amazon EC2 </a>........................................... <a href="#0_43">92 </a><a href="#0_44">Obtener información acerca de todas las instancias Amazon EC2 con un valor de etiqueta </a><a href="#0_44">específico </a>........................................................................................................................ <a href="#0_44">92 </a><a href="#0_38">Obtener información acerca de una instancia específica de Amazon EC2 </a>................................. <a href="#0_38">94 </a><a href="#0_45">Creación de una instancia de Amazon EC2 </a>......................................................................... <a href="#0_45">95 </a><a href="#0_46">Detención de una instancia de Amazon EC2 </a>....................................................................... <a href="#0_46">97 </a></p><p>iv <br>SDK de AWS para Ruby Developer Guide </p><p><a href="#0_47">Inicio de una instancia de Amazon EC2 </a>.............................................................................. <a href="#0_47">98 </a><a href="#0_48">Reinicio de una instancia de Amazon EC2 </a>......................................................................... <a href="#0_48">100 </a><a href="#0_49">Administración de instancias Amazon EC2 </a>......................................................................... <a href="#0_49">101 </a><a href="#0_50">Terminación de una instancia de Amazon EC2 </a>................................................................... <a href="#0_50">104 </a><a href="#0_51">Obtener información acerca de las regiones y las zonas de disponibilidad de Amazon EC2 </a>......... <a href="#0_51">105 </a><br><a href="#0_52">AWS Elastic Beanstalk Ejemplos </a>............................................................................................... <a href="#0_52">107 </a><br><a href="#0_53">Obtener información acerca de todas las aplicaciones de AWS Elastic Beanstalk </a>...................... <a href="#0_53">108 </a><a href="#0_54">Obtener información acerca de una aplicación específica en AWS Elastic Beanstalk </a>.................. <a href="#0_54">108 </a><a href="#0_55">Actualización de una aplicación Ruby on Rails para AWS Elastic Beanstalk </a>............................. <a href="#0_55">109 </a><br><a href="#0_56">AWS Identity and Access ManagementEjemplos de (IAM) </a>............................................................. <a href="#0_56">110 </a><br><a href="#0_57">Obtener información sobre usuarios de IAM </a>....................................................................... <a href="#0_57">111 </a><a href="#0_40">Lista de usuarios de IAM que son administradores </a>.............................................................. <a href="#0_40">112 </a><a href="#0_58">Adición de un nuevo usuario de IAM </a>................................................................................ <a href="#0_58">115 </a><a href="#0_59">Creación de claves de acceso de usuario para un usuario de IAM </a>......................................... <a href="#0_59">116 </a><a href="#0_60">Agregar una política administrada a un usuario de IAM </a>........................................................ <a href="#0_60">117 </a><a href="#0_61">Creación de un rol de IAM </a>.............................................................................................. <a href="#0_61">118 </a><a href="#0_62">Administración de usuarios de IAM </a>................................................................................... <a href="#0_62">119 </a><a href="#0_39">Trabajar con políticas de IAM </a>.......................................................................................... <a href="#0_39">122 </a><a href="#0_63">Administración de las claves de acceso de IAM </a>.................................................................. <a href="#0_63">125 </a><a href="#0_64">Uso de certificados de servidor de IAM </a>............................................................................. <a href="#0_64">129 </a><a href="#0_21">Administración de alias de cuenta de IAM </a>......................................................................... <a href="#0_21">132 </a><br><a href="#0_42">AWS KMS Ejemplos </a>................................................................................................................ <a href="#0_42">134 </a><br><a href="#0_65">Crear una CMK en AWS KMS </a>......................................................................................... <a href="#0_65">134 </a><a href="#0_66">Cifrado de datos en AWS KMS </a>........................................................................................ <a href="#0_66">135 </a><a href="#0_67">Descifrado de un blob de datos en AWS KMS </a>.................................................................... <a href="#0_67">136 </a><a href="#0_68">Volver a cifrar un blob de datos en AWS KMS </a>................................................................... <a href="#0_68">136 </a><br><a href="#0_69">AWS Lambda Ejemplos </a>........................................................................................................... <a href="#0_69">137 </a><br><a href="#0_70">Visualización de información acerca de todas las funciones de Lambda </a>................................... <a href="#0_70">137 </a><a href="#0_71">Creación de una función Lambda </a>...................................................................................... <a href="#0_71">138 </a><a href="#0_72">Ejecución de una función de Lambda </a>................................................................................. <a href="#0_72">139 </a><a href="#0_73">Configuración de una función de Lambda para recibir notificaciones </a>........................................ <a href="#0_73">140 </a><br><a href="#0_74">Ejemplos de Amazon Polly </a>....................................................................................................... <a href="#0_74">141 </a><br><a href="#0_75">Obtención de una lista de voces </a>....................................................................................... <a href="#0_75">141 </a><a href="#0_76">Obtención de una lista de lexicones </a>................................................................................... <a href="#0_76">142 </a><a href="#0_77">Sintetizar el habla </a>........................................................................................................... <a href="#0_77">143 </a><br><a href="#0_78">Ejemplos de Amazon RDS </a>....................................................................................................... <a href="#0_78">144 </a><br><a href="#0_79">Obtener información acerca de todas las instancias de Amazon RDS </a>..................................... <a href="#0_79">145 </a><a href="#0_80">Obtener información acerca de todas las instantáneas de Amazon RDS </a>................................. <a href="#0_80">145 </a><a href="#0_81">Obtener información acerca de todos los clústeres de Amazon RDS y sus instantáneas </a>............. <a href="#0_81">146 </a><a href="#0_82">Obtener información acerca de todos los grupos de seguridad de Amazon RDS </a>....................... <a href="#0_82">146 </a><a href="#0_42">Obtener información acerca de todos los grupos de subredes de Amazon RDS </a>........................ <a href="#0_42">147 </a><a href="#0_44">Obtener información acerca de todos los grupos de parámetros de Amazon RDS </a>..................... <a href="#0_44">147 </a><a href="#0_83">Creación de una instantánea de una instancia de Amazon RDS </a>............................................ <a href="#0_83">148 </a><a href="#0_5">Creación de una instantánea de un clúster de Amazon RDS </a>................................................. <a href="#0_5">149 </a><br><a href="#0_84">Ejemplos de Amazon S3 </a>.......................................................................................................... <a href="#0_84">149 </a><br><a href="#0_85">Obtener información acerca de todos los buckets de Amazon S3 </a>........................................... <a href="#0_85">150 </a><a href="#0_81">Obtener información acerca de todos los buckets de Amazon S3 de una región </a>....................... <a href="#0_81">151 </a><a href="#0_43">Creación y uso de un bucket de Amazon S3 </a>...................................................................... <a href="#0_43">152 </a><a href="#0_72">Determinación de si existe un bucket de Amazon S3 </a>........................................................... <a href="#0_72">156 </a><a href="#0_46">Obtener información acerca de objetos de buckets de Amazon S3 </a>......................................... <a href="#0_46">157 </a><a href="#0_86">Cargue un objeto a un bucket de Amazon S3. </a>.................................................................... <a href="#0_86">158 </a><a href="#0_46">Carga de un objeto con metadatos en un bucket de Amazon S3 </a>........................................... <a href="#0_46">159 </a><a href="#0_87">Descarga de un objeto de un bucket de Amazon S3 en un archivo </a>........................................ <a href="#0_87">160 </a><a href="#0_41">Cambio de las propiedades de un objeto de bucket de Amazon S3 </a>........................................ <a href="#0_41">161 </a><a href="#0_38">Cifrado de elementos de bucket de Amazon S3 </a>.................................................................. <a href="#0_38">163 </a><a href="#0_48">Activación de una notificación cuando se adjunta un elemento a un bucket de Amazon S3 </a>.......... <a href="#0_48">176 </a></p>