SDK de AWS para Ruby
Developer Guide
SDK de AWS para Ruby: Developer Guide
Copyright © Amazon Web Services, Inc. and/or its affiliates. All rights reserved.
SDK de AWS para Ruby Developer Guide
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.
SDK de AWS para Ruby Developer Guide
Table of Contents
AWSGuía para desarrolladores de SDK for Ruby ................................................................................... 1
Mediante laAWSSDK for Ruby conAWS Cloud9 .............................................................................. 1 Acerca de esta guía ................................................................................................................... 1 Documentación y recursos adicionales .......................................................................................... 2
Implementación enAWSCloud ............................................................................................... 2
Mantenimiento y soporte para las versiones principales del SDK ........................................................ 2
Introducción ....................................................................................................................................... 3
Guía de inicio rápido ................................................................................................................... 3
Escribir el código ................................................................................................................ 3 Ejecutar el código ............................................................................................................... 3 Nota para usuarios de Windows ........................................................................................... 3
Instalación del SDK de ................................................................................................................ 4
Prerequisites ...................................................................................................................... 4 Instalación del SDK de ........................................................................................................ 4
Tutorial Hello World .................................................................................................................... 4
Mediante laAWSSDK for Ruby en su programa ....................................................................... 5 Creación de un recurso de Amazon S3 ................................................................................. 5 Creación de un bucket ........................................................................................................ 5 Añadir un archivo al bucket .................................................................................................. 5 Mostrar el contenido de un bucket ........................................................................................ 5 Programa completo ............................................................................................................. 5 Ejecución del programa ....................................................................................................... 7 Pasos siguientes ................................................................................................................ 7
Configuración del SDK ........................................................................................................................ 8
Obtener suAWSclaves de acceso ................................................................................................. 8
Para obtener su ID de clave de acceso y la clave de acceso secreta .......................................... 8
Configuración de las credenciales de AWS .................................................................................... 9
Configuración de las credenciales compartidas ....................................................................... 9 Configuración de las credenciales mediante variables de entorno ............................................... 9 Configuración de las credenciales medianteAws.config........................................................ 10 Cambio de la ubicación de las credenciales .......................................................................... 10 Configuración de las credenciales en un objeto del cliente ...................................................... 10 Configuración de las credenciales mediante IAM ................................................................... 10
Creación de un token de acceso de AWS STS ............................................................................. 11 Configuración de una región ....................................................................................................... 11
Configuración de la región mediante variables de entorno ....................................................... 11 Configuración de la región medianteAws.config.................................................................. 11 Configuración de la región en un objeto de recurso ................................................................ 12
Configuración de un punto de enlace no estándar ......................................................................... 12 SDK Metrics ............................................................................................................................. 12
Autorizar las métricas del SDK ........................................................................................... 12 Configuración de SDK Metrics ............................................................................................ 14 Definiciones de métricas del SDK ....................................................................................... 17
UsoAWS Cloud9con SDK .................................................................................................................. 19
Paso 1: Configure elAWSCuenta para utilizarAWS Cloud9 .............................................................. 19 Paso 2: Configure elAWS Cloud9Entorno de desarrollo .................................................................. 19 Paso 3: Configurar laAWSSDK de para Ruby ................................................................................ 20 Paso 4: Descarga del código de ejemplo ...................................................................................... 20 Paso 5: Ejecutar código de ejemplo ............................................................................................. 20
Uso del SDK .................................................................................................................................... 21
Mediante laAWSHerramienta SDK for Ruby ................................................................................. 21 Uso del SDK con Ruby on Rails ................................................................................................ 21 Migración de la versión 1 o 2 a la versión 3 deAWSSDK de para Ruby ............................................ 22
Uso en paralelo ................................................................................................................ 22
iii
SDK de AWS para Ruby Developer Guide
Diferencias generales ........................................................................................................ 22 Diferencias del cliente ....................................................................................................... 23 Diferencias en los recursos ................................................................................................ 23
Consejo de depuración: Obtener información del rastro de red de un cliente ...................................... 24 Stub: respuestas y errores de cliente .......................................................................................... 25
Stub: respuestas de cliente ................................................................................................ 25 Stub: errores de cliente ..................................................................................................... 26
Paginación de los datos de respuesta ........................................................................................ 26
Las respuestas paginadas se pueden enumerar .................................................................... 26 Administrar respuestas paginadas manualmente .................................................................... 27 Clases de datos paginados ................................................................................................ 27
Uso de esperadores ................................................................................................................. 27
Llamada a un esperador .................................................................................................... 27 Errores de espera ............................................................................................................. 28 Configuración de un esperador ........................................................................................... 28 Ampliación de un esperador ............................................................................................... 28
Especificación de la duración del tiempo de espera de un cliente .................................................... 29
Ejemplos de código ........................................................................................................................... 30
AWS CloudTrail Ejemplos .......................................................................................................... 30
Listado de registros de seguimiento de CloudTrail ................................................................ 31 Creación de un CloudTrail de ............................................................................................ 31 Listado de eventos de seguimiento de CloudTrail ................................................................. 33 Eliminación de un registro de seguimiento de CloudTrail il ...................................................... 34
Ejemplos de Amazon CloudWatch ............................................................................................... 35
Obtener información acerca de las alarmas de Amazon CloudWatch ........................................ 35 Creación de una alarma de Amazon CloudWatch ................................................................. 37 Habilitación y deshabilitación de acciones de alarma de Amazon CloudWatch ........................... 39 Obtener información acerca de métricas personalizadas para Amazon CloudWatch .................... 42 Envío de eventos a Amazon CloudWatch Events .................................................................. 44
AWS CodeBuild Ejemplos .......................................................................................................... 57
Obtener información acerca de todos los proyectos AWS CodeBuild ........................................ 58 Compilación de un proyecto de AWS CodeBuild ................................................................... 58 Lista de compilaciones de proyectos de AWS CodeBuild ....................................................... 59
Ejemplos de Amazon DynamoDB ................................................................................................ 59
Obtener información acerca de todas las tablas de Amazon DynamoDB ................................... 60 Creación de una tabla de Amazon DynamoDB ..................................................................... 61 Añadir un elemento a una tabla de Amazon DynamoDB ........................................................ 63 Carga de elementos desde un archivo JSON en una tabla de Amazon DynamoDB ..................... 64 Lectura de un elemento en una tabla de Amazon DynamoDB ................................................. 66 Actualización de un elemento de tabla de Amazon DynamoDB ............................................... 67 Eliminación de un elemento de tabla de Amazon DynamoDB .................................................. 69 Eliminación de una tabla de Amazon DynamoDB ................................................................. 70
Ejemplos de Amazon EC2 ......................................................................................................... 71
Creación de una VPC de Amazon EC2 ............................................................................... 71 Creación de una Internet Gateway y su asociación a una VPC en Amazon EC2 ......................... 73 Creación de una subred pública para Amazon EC2 .............................................................. 74 Creación de una tabla de ruteo Amazon EC2 y su asociación a una subred .............................. 76 Uso de direcciones IP elásticas en Amazon EC2 .................................................................. 78 Creación de un grupo de seguridad de Amazon EC2 ............................................................ 82 Uso de grupos de seguridad de Amazon EC2 ...................................................................... 84 Uso de pares de claves en Amazon EC2 ............................................................................ 89 Obtener información acerca de todas las instancias Amazon EC2 ........................................... 92 Obtener información acerca de todas las instancias Amazon EC2 con un valor de etiqueta específico ........................................................................................................................ 92 Obtener información acerca de una instancia específica de Amazon EC2 ................................. 94 Creación de una instancia de Amazon EC2 ......................................................................... 95 Detención de una instancia de Amazon EC2 ....................................................................... 97
iv
SDK de AWS para Ruby Developer Guide
Inicio de una instancia de Amazon EC2 .............................................................................. 98 Reinicio de una instancia de Amazon EC2 ......................................................................... 100 Administración de instancias Amazon EC2 ......................................................................... 101 Terminación de una instancia de Amazon EC2 ................................................................... 104 Obtener información acerca de las regiones y las zonas de disponibilidad de Amazon EC2 ......... 105
AWS Elastic Beanstalk Ejemplos ............................................................................................... 107
Obtener información acerca de todas las aplicaciones de AWS Elastic Beanstalk ...................... 108 Obtener información acerca de una aplicación específica en AWS Elastic Beanstalk .................. 108 Actualización de una aplicación Ruby on Rails para AWS Elastic Beanstalk ............................. 109
AWS Identity and Access ManagementEjemplos de (IAM) ............................................................. 110
Obtener información sobre usuarios de IAM ....................................................................... 111 Lista de usuarios de IAM que son administradores .............................................................. 112 Adición de un nuevo usuario de IAM ................................................................................ 115 Creación de claves de acceso de usuario para un usuario de IAM ......................................... 116 Agregar una política administrada a un usuario de IAM ........................................................ 117 Creación de un rol de IAM .............................................................................................. 118 Administración de usuarios de IAM ................................................................................... 119 Trabajar con políticas de IAM .......................................................................................... 122 Administración de las claves de acceso de IAM .................................................................. 125 Uso de certificados de servidor de IAM ............................................................................. 129 Administración de alias de cuenta de IAM ......................................................................... 132
AWS KMS Ejemplos ................................................................................................................ 134
Crear una CMK en AWS KMS ......................................................................................... 134 Cifrado de datos en AWS KMS ........................................................................................ 135 Descifrado de un blob de datos en AWS KMS .................................................................... 136 Volver a cifrar un blob de datos en AWS KMS ................................................................... 136
AWS Lambda Ejemplos ........................................................................................................... 137
Visualización de información acerca de todas las funciones de Lambda ................................... 137 Creación de una función Lambda ...................................................................................... 138 Ejecución de una función de Lambda ................................................................................. 139 Configuración de una función de Lambda para recibir notificaciones ........................................ 140
Ejemplos de Amazon Polly ....................................................................................................... 141
Obtención de una lista de voces ....................................................................................... 141 Obtención de una lista de lexicones ................................................................................... 142 Sintetizar el habla ........................................................................................................... 143
Ejemplos de Amazon RDS ....................................................................................................... 144
Obtener información acerca de todas las instancias de Amazon RDS ..................................... 145 Obtener información acerca de todas las instantáneas de Amazon RDS ................................. 145 Obtener información acerca de todos los clústeres de Amazon RDS y sus instantáneas ............. 146 Obtener información acerca de todos los grupos de seguridad de Amazon RDS ....................... 146 Obtener información acerca de todos los grupos de subredes de Amazon RDS ........................ 147 Obtener información acerca de todos los grupos de parámetros de Amazon RDS ..................... 147 Creación de una instantánea de una instancia de Amazon RDS ............................................ 148 Creación de una instantánea de un clúster de Amazon RDS ................................................. 149
Ejemplos de Amazon S3 .......................................................................................................... 149
Obtener información acerca de todos los buckets de Amazon S3 ........................................... 150 Obtener información acerca de todos los buckets de Amazon S3 de una región ....................... 151 Creación y uso de un bucket de Amazon S3 ...................................................................... 152 Determinación de si existe un bucket de Amazon S3 ........................................................... 156 Obtener información acerca de objetos de buckets de Amazon S3 ......................................... 157 Cargue un objeto a un bucket de Amazon S3. .................................................................... 158 Carga de un objeto con metadatos en un bucket de Amazon S3 ........................................... 159 Descarga de un objeto de un bucket de Amazon S3 en un archivo ........................................ 160 Cambio de las propiedades de un objeto de bucket de Amazon S3 ........................................ 161 Cifrado de elementos de bucket de Amazon S3 .................................................................. 163 Activación de una notificación cuando se adjunta un elemento a un bucket de Amazon S3 .......... 176