

La versión AWS SDK para Java 1.x finalizó su soporte el 31 de diciembre de 2025. Le recomendamos que migre a [AWS SDK for Java 2.x](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/home.html) para seguir recibiendo nuevas características, mejoras de disponibilidad y actualizaciones de seguridad.

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Ejemplos de código incluidos con el SDK
<a name="java-dg-samples"></a>

AWS SDK para Java incluye ejemplos de código que muestran muchas de las características del SDK en programas compilables y ejecutables. Puede estudiar o modificar estos ejemplos para implementar sus propias soluciones de AWS utilizando el AWS SDK para Java.

## Cómo obtener los ejemplos
<a name="how-to-get-the-samples"></a>

Los ejemplos de código de AWS SDK para Java se proporcionan en el directorio *samples* del SDK. Si ha descargado e instalado el SDK usando la información de [Configuración del AWS SDK para Java](setup-install.md), ya tiene los ejemplos en su sistema.

También puede consultar los últimos ejemplos en el repositorio de GitHub de AWS SDK para Java en el directorio [src/samples](https://github.com/aws/aws-sdk-java/tree/master/src/samples).

## Compilación y ejecución de los ejemplos mediante la línea de comandos
<a name="samples-cmdline"></a>

Los ejemplos incluyen scripts de compilación [Ant](http://ant.apache.org/) para que pueda compilarlos y ejecutarlos fácilmente desde la línea de comandos. Cada ejemplo contiene también un archivo README en formato HTML que incluye información específica de cada ejemplo.

**nota**  
Si examina el código de ejemplo en GitHub, haga clic en el botón **Raw** de la pantalla de código fuente cuando consulte el archivo README.html del ejemplo. En modo "raw", el HTML se mostrará de acuerdo con los requisitos del navegador.

### Requisitos previos
<a name="prerequisitessamples"></a>

Antes de ejecutar alguno de los ejemplos de AWS SDK para Java, necesitará configurar las credenciales de AWS en el entorno o con la AWS CLI, tal y como se especifica en [Configuración de credenciales y regiones de AWS para desarrollo](setup-credentials.md). Los ejemplos utilizan la cadena predeterminada de proveedores de credenciales siempre que sea posible. Por lo tanto, configurando las credenciales de esta forma, puede evitar el procedimiento arriesgado de insertar las credenciales de AWS en los archivos del directorio de código fuente (en el que puede activarlas sin querer y compartirlas públicamente).

### Ejecución de los ejemplos
<a name="running-the-samples"></a>

1. Vaya al directorio que contiene el código del ejemplo. Por ejemplo, si está en el directorio raíz de la descarga del SDK de AWS y desea ejecutar el ejemplo `AwsConsoleApp`, escriba:

   ```
   cd samples/AwsConsoleApp
   ```

1. Compile y ejecute el ejemplo con Ant. El destino de la compilación predeterminado realiza ambas opciones, por lo que solo puede introducir:

   ```
   ant
   ```

El ejemplo muestra información en la salida estándar:

```
===========================================

Welcome to the {AWS} Java SDK!

===========================================
You have access to 4 Availability Zones.

You have 0 {EC2} instance(s) running.

You have 13 Amazon SimpleDB domain(s) containing a total of 62 items.

You have 23 {S3} bucket(s), containing 44 objects with a total size of 154767691 bytes.
```

## Compilación y ejecución de los ejemplos mediante el IDE de Eclipse
<a name="building-and-running-the-samples-using-the-eclipse-ide"></a>

Si utiliza AWS Toolkit for Eclipse, también puede iniciar un nuevo proyecto en Eclipse basado en AWS SDK para Java o añadir el SDK a un proyecto de Java existente.

### Requisitos previos
<a name="id1samples"></a>

Una vez instalado AWS Toolkit for Eclipse, le recomendamos que configure el conjunto de herramientas con sus credenciales de seguridad. Puede hacer esto en cualquier momento eligiendo **Preferencias** en el menú **Ventana** de Eclipse y eligiendo la sección **Toolkit de AWS**.

### Ejecución de los ejemplos
<a name="id2"></a>

1. Abra Eclipse.

1. Crear un nuevo proyecto Java de AWS En Eclipse, en el menú **File (Archivo)**, elija **New (Nuevo)** y haga clic en **Project (Proyecto)**. Se abre el asistente **New Project (Nuevo proyecto)**.

1. Expanda la categoría **AWS** y, a continuación, elija **Proyecto Java de AWS**.

1. Elija **Siguiente**. Se muestra la página de configuración del proyecto.

1. Introduzca el nombre en el cuadro **Project Name (Nombre del proyecto)**. El grupo de ejemplos de AWS SDK para Java muestra los disponibles en el SDK, descritos anteriormente.

1. Seleccione los ejemplos que desea incluir en su proyecto seleccionando cada casilla de verificación.

1. Introduzca las credenciales de AWS Si ya ha configurado AWS Toolkit for Eclipse con sus credenciales, estas se rellenan automáticamente.

1. Seleccione **Finalizar**. El proyecto se crea y se añade a **Project Explorer (Explorador de proyectos)**.

1. Elija el archivo `.java` del ejemplo que desea ejecutar. Por ejemplo, en el caso del ejemplo de Amazon S3, elija `S3Sample.java`.

1. Elija **Run (Ejecutar)** en el menú **Run (Ejecutar)**.

1. Haga clic con el botón derecho en el proyecto en **Project Explorer (Explorador de proyectos)**, seleccione **Build Path (Ruta de compilación)** y, a continuación, seleccione **Add Libraries (Añadir bibliotecas)**.

1. Elija **SDK de Java AWS**, seleccione **Siguiente** y, a continuación, siga las instrucciones que aparecen en pantalla.