¡Se AWS SDK para .NET ha publicado la versión 4 (V4) del\$1
Para obtener información sobre los cambios más importantes y la migración de sus aplicaciones, consulte el [tema sobre migración](https://docs.aws.amazon.com/sdk-for-net/v4/developer-guide/net-dg-v4.html).
[https://docs.aws.amazon.com/sdk-for-net/v4/developer-guide/net-dg-v4.html](https://docs.aws.amazon.com/sdk-for-net/v4/developer-guide/net-dg-v4.html)
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.
# Creación de una aplicación sencilla mediante el AWS SDK para .NET
Esta sección proporciona tutoriales básicos para los desarrolladores que no están familiarizados con AWS SDK para .NET.
**nota**
Antes de usar estos tutoriales, primero debe haber [instalado su cadena de herramientas](net-dg-dev-env.md) y haber [configurado la autenticación de SDK](creds-idc.md).
Para obtener información sobre el desarrollo de software para AWS servicios específicos junto con ejemplos de código, consulte[ AWS Servicios de llamadas](working-with-aws-services.md). Para ver otros ejemplos de código, consulte [SDK para .NET ejemplos de código (v4)](csharp_code_examples.md).
**Topics**
+ [Aplicación multiplataforma sencilla](quick-start-s3-1-cross.md)
+ [Aplicación sencilla basada en Windows](quick-start-s3-1-winvs.md)
+ [Pasos a seguir a continuación](quick-start-next-steps.md)
# Aplicación multiplataforma sencilla que utiliza el AWS SDK para .NET
En este tutorial se utilizan .NET Core AWS SDK para .NET y .NET Core para el desarrollo multiplataforma. En el tutorial se muestra cómo utilizar SDK para enumerar los [buckets de Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/) que posee y, opcionalmente, crear un bucket.
Llevará a cabo este tutorial utilizando herramientas multiplataforma como la interfaz de la línea de comandos (CLI) .NET. Para ver otras formas de configurar el entorno de desarrollo, consulte [Instalación y configuración de la cadena de herramientas para AWS SDK para .NET](net-dg-dev-env.md).
**Necesario para el desarrollo multiplataforma de .NET en Windows, Linux o macOS:**
+ Microsoft [.NET Core SDK](https://learn.microsoft.com/en-us/dotnet/fundamentals/), versión 2.1, 3.1 o posterior, que incluye la interfaz de línea de comandos (CLI) de .NET (**`dotnet`**) y el tiempo de ejecución de .NET Core.
+ Un editor de código o entorno de desarrollo integrado (IDE) adecuado para el sistema operativo y los requisitos. Normalmente, es uno que proporciona cierto soporte para .NET Core.
Algunos ejemplos son [Microsoft Visual Studio Code (VS Code)](https://code.visualstudio.com/), [JetBrains Rider](https://www.jetbrains.com/rider/) y [Microsoft Visual Studio](https://visualstudio.microsoft.com/vs/).
**nota**
Antes de usar estos tutoriales, primero debe haber [instalado su cadena de herramientas](net-dg-dev-env.md) y haber [configurado la autenticación de SDK](creds-idc.md).
## Pasos
+ [Creación del proyecto](#s3-1-cross-create-project)
+ [Crear el código](#s3-1-cross-code)
+ [Ejecución de la aplicación](#s3-1-cross-run)
+ [Limpieza](#s3-1-cross-clean-up)
## Creación del proyecto
1. Abra un símbolo del sistema o un terminal. Busque o cree una carpeta del sistema operativo en la que pueda crear un proyecto .NET.
1. En esa carpeta, ejecute el siguiente comando para crear el proyecto .NET.
```
dotnet new console --name S3CreateAndList
```
1. Vaya a la carpeta `S3CreateAndList` recién creada y ejecute los siguientes comandos:
```
dotnet add package AWSSDK.S3
dotnet add package AWSSDK.SecurityToken
dotnet add package AWSSDK.SSO
dotnet add package AWSSDK.SSOOIDC
```
Los comandos anteriores instalan los NuGet paquetes desde el [administrador de NuGet paquetes](https://www.nuget.org/profiles/awsdotnet). Como sabemos exactamente qué NuGet paquetes necesitamos para este tutorial, podemos realizar este paso ahora. También es común que los paquetes requeridos se conozcan durante el desarrollo. Cuando esto sucede, se puede ejecutar un comando similar en ese momento.
## Crear el código
1. En la carpeta `S3CreateAndList`, busque y abra `Program.cs` en su editor de código.
1. Reemplace el contenido con el siguiente código y guarde el archivo.
```
using System;
using System.Threading.Tasks;
// NuGet packages: AWSSDK.S3, AWSSDK.SecurityToken, AWSSDK.SSO, AWSSDK.SSOOIDC
using Amazon.Runtime;
using Amazon.Runtime.CredentialManagement;
using Amazon.S3;
using Amazon.S3.Model;
using Amazon.SecurityToken;
using Amazon.SecurityToken.Model;
namespace S3CreateAndList
{
class Program
{
// This code is part of the quick tour in the developer guide.
// See https://docs.aws.amazon.com/sdk-for-net/v3/developer-guide/quick-start.html
// for complete steps.
// Requirements:
// - An SSO profile in the SSO user's shared config file with sufficient privileges for
// STS and S3 buckets.
// - An active SSO Token.
// If an active SSO token isn't available, the SSO user should do the following:
// In a terminal, the SSO user must call "aws sso login".
// Class members.
static async Task Main(string[] args)
{
// Get SSO credentials from the information in the shared config file.
// For this tutorial, the information is in the [default] profile.
var ssoCreds = LoadSsoCredentials("default");
// Display the caller's identity.
var ssoProfileClient = new AmazonSecurityTokenServiceClient(ssoCreds);
Console.WriteLine($"\nSSO Profile:\n {await ssoProfileClient.GetCallerIdentityArn()}");
// Create the S3 client is by using the SSO credentials obtained earlier.
var s3Client = new AmazonS3Client(ssoCreds);
// Parse the command line arguments for the bucket name.
if (GetBucketName(args, out String bucketName))
{
// If a bucket name was supplied, create the bucket.
// Call the API method directly
try
{
Console.WriteLine($"\nCreating bucket {bucketName}...");
var createResponse = await s3Client.PutBucketAsync(bucketName);
Console.WriteLine($"Result: {createResponse.HttpStatusCode.ToString()}");
}
catch (Exception e)
{
Console.WriteLine("Caught exception when creating a bucket:");
Console.WriteLine(e.Message);
}
}
// Display a list of the account's S3 buckets.
Console.WriteLine("\nGetting a list of your buckets...");
var listResponse = await s3Client.ListBucketsAsync();
Console.WriteLine($"Number of buckets: {listResponse.Buckets.Count}");
foreach (S3Bucket b in listResponse.Buckets)
{
Console.WriteLine(b.BucketName);
}
Console.WriteLine();
}
//
// Method to parse the command line.
private static Boolean GetBucketName(string[] args, out String bucketName)
{
Boolean retval = false;
bucketName = String.Empty;
if (args.Length == 0)
{
Console.WriteLine("\nNo arguments specified. Will simply list your Amazon S3 buckets." +
"\nIf you wish to create a bucket, supply a valid, globally unique bucket name.");
bucketName = String.Empty;
retval = false;
}
else if (args.Length == 1)
{
bucketName = args[0];
retval = true;
}
else
{
Console.WriteLine("\nToo many arguments specified." +
"\n\ndotnet_tutorials - A utility to list your Amazon S3 buckets and optionally create a new one." +
"\n\nUsage: S3CreateAndList [bucket_name]" +
"\n - bucket_name: A valid, globally unique bucket name." +
"\n - If bucket_name isn't supplied, this utility simply lists your buckets.");
Environment.Exit(1);
}
return retval;
}
//
// Method to get SSO credentials from the information in the shared config file.
static AWSCredentials LoadSsoCredentials(string profile)
{
var chain = new CredentialProfileStoreChain();
if (!chain.TryGetAWSCredentials(profile, out var credentials))
throw new Exception($"Failed to find the {profile} profile");
return credentials;
}
}
// Class to read the caller's identity.
public static class Extensions
{
public static async Task GetCallerIdentityArn(this IAmazonSecurityTokenService stsClient)
{
var response = await stsClient.GetCallerIdentityAsync(new GetCallerIdentityRequest());
return response.Arn;
}
}
}
```
## Ejecución de la aplicación
1. Ejecute el siguiente comando.
```
dotnet run
```
1. Examine la salida para ver el número de buckets de Amazon S3 que posee, si los hay, y sus nombres.
1. Elija un nombre para un nuevo bucket de Amazon S3. Usa «dotnet-quicktour-s3-1-cross-» como base y añádele algo único, como un GUID o tu nombre. Asegúrese de seguir las reglas de nomenclatura de bucket, como se describe en [Reglas de nomenclatura de buckets](https://docs.aws.amazon.com/AmazonS3/latest/userguide/BucketRestrictions.html#bucketnamingrules) en la [Guía del usuario de Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/).
1. Ejecute el siguiente comando y *amzn-s3-demo-bucket* sustitúyalo por el nombre del depósito que haya elegido.
```
dotnet run amzn-s3-demo-bucket
```
1. Examine la salida para ver el nuevo bucket que se creó.
## Limpieza
Mientras realizaba este tutorial, ha creado algunos recursos que puede decidir limpiar en este momento.
+ Si no quiere conservar el bucket que la aplicación creó en un paso anterior, elimínelo mediante la consola de Amazon S3 en [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).
+ Si no quiere conservar el proyecto de .NET, elimine la carpeta `S3CreateAndList` del entorno de desarrollo.
## Pasos siguientes
Vuelva al [menú de recorrido rápido](quick-start.md) o vaya directamente al [final de este recorrido rápido](quick-start-next-steps.md).
# Aplicación sencilla basada en Windows que utiliza AWS SDK para .NET
En este tutorial se utiliza AWS SDK para .NET en Windows con Visual Studio y.NET Core. En el tutorial se muestra cómo utilizar SDK para enumerar los [buckets de Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/) que posee y, opcionalmente, crear un bucket.
Llevará a cabo este tutorial en Windows mediante Visual Studio y .NET Core. Para ver otras formas de configurar el entorno de desarrollo, consulte [Instalación y configuración de la cadena de herramientas para AWS SDK para .NET](net-dg-dev-env.md).
**Necesario para el desarrollo en Windows con Visual Studio y .NET Core:**
+ [Microsoft Visual Studio](https://visualstudio.microsoft.com/vs/)
+ Microsoft .NET Core 2.1, 3.1 o posterior
Esto normalmente se incluye de forma predeterminada al instalar una versión reciente de Visual Studio.
**nota**
Antes de usar estos tutoriales, primero debe haber [instalado su cadena de herramientas](net-dg-dev-env.md) y haber [configurado la autenticación de SDK](creds-idc.md).
## Pasos
+ [Creación del proyecto](#s3-1-winvs-create-project)
+ [Crear el código](#s3-1-winvs-code)
+ [Ejecución de la aplicación](#s3-1-winvs-run)
+ [Limpieza](#s3-1-winvs-clean-up)
## Creación del proyecto
1. Abra Visual Studio y cree un nuevo proyecto que utilice la versión C\$1 de la plantilla de la **aplicación de consola**; es decir, con la descripción: «... para crear una aplicación de línea de comandos que pueda ejecutarse en .NET...». Asigne un nombre al proyecto `S3CreateAndList`.
**nota**
No elija la versión .NET Framework de la plantilla de la aplicación de consola o, si la elige, asegúrese de utilizar .NET Framework 4.7.2 o una versión posterior.
1. Con el proyecto recién creado cargado, elija **Tools**, **NuGetPackage Manager** y **Manage NuGet Packages for Solution**.
1. Busque los siguientes NuGet paquetes e instálelos en el proyecto: `AWSSDK.S3``AWSSDK.SecurityToken`,`AWSSDK.SSO`, y `AWSSDK.SSOOIDC`
Este proceso instala los NuGet paquetes desde el [administrador de NuGet paquetes](https://www.nuget.org/profiles/awsdotnet). Como sabemos exactamente qué NuGet paquetes necesitamos para este tutorial, podemos realizar este paso ahora. También es común que los paquetes requeridos se conozcan durante el desarrollo. Cuando esto suceda, siga un proceso similar para instalarlos en ese momento.
1. Si tiene la intención de ejecutar la aplicación desde el símbolo del sistema, abra un símbolo del sistema ahora y vaya a la carpeta que contendrá la salida de compilación. Suele ser algo así como `S3CreateAndList\S3CreateAndList\bin\Debug\net6.0`, pero dependerá del entorno.
## Crear el código
1. En el proyecto `S3CreateAndList`, busque y abra `Program.cs` en el IDE.
1. Reemplace el contenido con el siguiente código y guarde el archivo.
```
using System;
using System.Threading.Tasks;
// NuGet packages: AWSSDK.S3, AWSSDK.SecurityToken, AWSSDK.SSO, AWSSDK.SSOOIDC
using Amazon.Runtime;
using Amazon.Runtime.CredentialManagement;
using Amazon.S3;
using Amazon.S3.Model;
using Amazon.SecurityToken;
using Amazon.SecurityToken.Model;
namespace S3CreateAndList
{
class Program
{
// This code is part of the quick tour in the developer guide.
// See https://docs.aws.amazon.com/sdk-for-net/v3/developer-guide/quick-start.html
// for complete steps.
// Requirements:
// - An SSO profile in the SSO user's shared config file with sufficient privileges for
// STS and S3 buckets.
// - An active SSO Token.
// If an active SSO token isn't available, the SSO user should do the following:
// In a terminal, the SSO user must call "aws sso login".
// Class members.
static async Task Main(string[] args)
{
// Get SSO credentials from the information in the shared config file.
// For this tutorial, the information is in the [default] profile.
var ssoCreds = LoadSsoCredentials("default");
// Display the caller's identity.
var ssoProfileClient = new AmazonSecurityTokenServiceClient(ssoCreds);
Console.WriteLine($"\nSSO Profile:\n {await ssoProfileClient.GetCallerIdentityArn()}");
// Create the S3 client is by using the SSO credentials obtained earlier.
var s3Client = new AmazonS3Client(ssoCreds);
// Parse the command line arguments for the bucket name.
if (GetBucketName(args, out String bucketName))
{
// If a bucket name was supplied, create the bucket.
// Call the API method directly
try
{
Console.WriteLine($"\nCreating bucket {bucketName}...");
var createResponse = await s3Client.PutBucketAsync(bucketName);
Console.WriteLine($"Result: {createResponse.HttpStatusCode.ToString()}");
}
catch (Exception e)
{
Console.WriteLine("Caught exception when creating a bucket:");
Console.WriteLine(e.Message);
}
}
// Display a list of the account's S3 buckets.
Console.WriteLine("\nGetting a list of your buckets...");
var listResponse = await s3Client.ListBucketsAsync();
Console.WriteLine($"Number of buckets: {listResponse.Buckets.Count}");
foreach (S3Bucket b in listResponse.Buckets)
{
Console.WriteLine(b.BucketName);
}
Console.WriteLine();
}
//
// Method to parse the command line.
private static Boolean GetBucketName(string[] args, out String bucketName)
{
Boolean retval = false;
bucketName = String.Empty;
if (args.Length == 0)
{
Console.WriteLine("\nNo arguments specified. Will simply list your Amazon S3 buckets." +
"\nIf you wish to create a bucket, supply a valid, globally unique bucket name.");
bucketName = String.Empty;
retval = false;
}
else if (args.Length == 1)
{
bucketName = args[0];
retval = true;
}
else
{
Console.WriteLine("\nToo many arguments specified." +
"\n\ndotnet_tutorials - A utility to list your Amazon S3 buckets and optionally create a new one." +
"\n\nUsage: S3CreateAndList [bucket_name]" +
"\n - bucket_name: A valid, globally unique bucket name." +
"\n - If bucket_name isn't supplied, this utility simply lists your buckets.");
Environment.Exit(1);
}
return retval;
}
//
// Method to get SSO credentials from the information in the shared config file.
static AWSCredentials LoadSsoCredentials(string profile)
{
var chain = new CredentialProfileStoreChain();
if (!chain.TryGetAWSCredentials(profile, out var credentials))
throw new Exception($"Failed to find the {profile} profile");
return credentials;
}
}
// Class to read the caller's identity.
public static class Extensions
{
public static async Task GetCallerIdentityArn(this IAmazonSecurityTokenService stsClient)
{
var response = await stsClient.GetCallerIdentityAsync(new GetCallerIdentityRequest());
return response.Arn;
}
}
}
```
1. Compilación de la aplicación.
**nota**
Si usa una versión antigua de Visual Studio, es posible que se produzca un error de compilación similar al siguiente:
“La función ‘async main’ no está disponible en C\$1 7.0. Utilice la versión 7.1 o superior del lenguaje”.
Si aparece este error, configure el proyecto para que utilice una versión posterior del lenguaje. Por lo general, esto se lleva a cabo en las propiedades del proyecto, en **Compilación** > **Avanzado**.
## Ejecución de la aplicación
1. Ejecute la aplicación sin argumentos de línea de comandos. Haga esto en el símbolo del sistema (si ya tiene abierto uno) o desde el IDE.
1. Examine la salida para ver el número de buckets de Amazon S3 que posee, si los hay, y sus nombres.
1. Elija un nombre para un nuevo bucket de Amazon S3. Usa "dotnet-quicktour-s3-1-winvs-» como base y añádele algo único, como un GUID o tu nombre. Asegúrese de seguir las reglas de nomenclatura de bucket, como se describe en [Reglas de nomenclatura de buckets](https://docs.aws.amazon.com/AmazonS3/latest/userguide/BucketRestrictions.html#bucketnamingrules) en la [Guía del usuario de Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/).
1. Vuelva a ejecutar la aplicación, esta vez proporcionando el nombre del bucket.
En la línea de comandos, sustituya *amzn-s3-demo-bucket* el siguiente comando por el nombre del bucket que haya elegido.
```
S3CreateAndList amzn-s3-demo-bucket
```
O bien, si está ejecutando la aplicación en el IDE, elija **Project**, **S3 CreateAndList Properties**, **Debug** e introduzca allí el nombre del bucket.
1. Examine la salida para ver el nuevo bucket que se creó.
## Limpieza
Mientras realizaba este tutorial, ha creado algunos recursos que puede decidir limpiar en este momento.
+ Si no quiere conservar el bucket que la aplicación creó en un paso anterior, elimínelo mediante la consola de Amazon S3 en [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).
+ Si no quiere conservar el proyecto de .NET, elimine la carpeta `S3CreateAndList` del entorno de desarrollo.
## Pasos siguientes
Vuelva al [menú de recorrido rápido](quick-start.md) o vaya directamente al [final de este recorrido rápido](quick-start-next-steps.md).
# Pasos a seguir a continuación
Asegúrese de limpiar los recursos sobrantes que haya creado mientras realiza estos tutoriales. Pueden ser AWS recursos o recursos de su entorno de desarrollo, como archivos y carpetas.
Ahora que lo has visitado AWS SDK para .NET, quizá te interese [empezar tu proyecto](net-dg-start-new-project.md).