を使用したシンプルな Windows ベースのアプリケーション AWS SDK for .NET - AWS SDK for .NET

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

を使用したシンプルな Windows ベースのアプリケーション AWS SDK for .NET

このチュートリアルでは、Visual Studio と で Windows AWS SDK for .NET 上の を使用します。NET コア。このチュートリアルでは、 を使用して、所有している Amazon S3 バケットSDKを一覧表示し、オプションでバケットを作成する方法を示します。

このチュートリアルは、Visual Studio と を使用して Windows で実行します。NET コア。開発環境を設定するその他の方法については、「ツールチェーンのインストールと設定」を参照してください。

Visual Studio および を使用した Windows での開発に必要です。NET コア:

  • Microsoft 。NET Core 2.1、3.1 以降

    これは通常、Visual Studio の最新バージョンをインストールするとデフォルトで追加されます。

注記

これらのチュートリアルを使用する前に、最初にツールチェーンをインストールし、SDK認証 を設定しておく必要があります。

ステップ

プロジェクトの作成

  1. Visual Studio を開き、コンソールアプリケーションテンプレートの C# バージョンを使用する新しいプロジェクトを作成します。つまり、「」で実行できるコマンドラインアプリケーションを作成するためにNET「」という説明を使用します。プロジェクトに S3CreateAndList という名前を付けます。

    注記

    を選択しないでください。NET コンソールアプリケーションテンプレートのフレームワークバージョン。その場合は、必ず を使用してください。NET Framework 4.7.2 以降。

  2. 新しく作成されたプロジェクトをロードしたら、ツール、NuGetパッケージマネージャーソリューションの NuGet パッケージの管理 を選択します。

  3. 次の NuGet パッケージを参照し、プロジェクトにインストールします: AWSSDK.S3AWSSDK.SecurityTokenAWSSDK.SSOAWSSDK.SSOOIDC

    このプロセスは、 NuGet パッケージNuGet マネージャー からパッケージをインストールします。このチュートリアルに必要な NuGet パッケージが正確にわかっているため、このステップを今すぐ実行できます。また、開発中に必要なパッケージが判明することは一般的なことです。その場合は、その時点で同様の手順に従ってインストールしてください。

  4. コマンドプロンプトからアプリケーションを実行する場合は、ここでコマンドプロンプトを開き、ビルド出力を含むフォルダに移動します。通常は S3CreateAndList\S3CreateAndList\bin\Debug\net6.0 のようになりますが、環境によって異なります。

コードの作成

  1. S3CreateAndList プロジェクトProgram.csで、 を見つけて開きますIDE。

  2. 内容を次のコードに置き換えて、ファイルを保存します。

    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<string> GetCallerIdentityArn(this IAmazonSecurityTokenService stsClient) { var response = await stsClient.GetCallerIdentityAsync(new GetCallerIdentityRequest()); return response.Arn; } } }
  3. アプリケーションをビルドします。

    注記

    古いバージョンの Visual Studio を使用している場合は、次のようなビルドエラーが発生することがあります。

    "Feature 'async main' is not available in C# 7.0. Please use language version 7.1 or greater." (C# 7.0 では async main 機能を使用できません。言語バージョン 7.1 以降を使用してください。)

    このエラーが発生した場合は、新しいバージョンの言語を使用するようにプロジェクトをセットアップします。これは通常、プロジェクトのプロパティ (BuildAdvanced) で実行します。

アプリケーションを実行する

  1. コマンドライン引数なしでアプリケーションを実行します。これは、コマンドプロンプト (以前に開いた場合) または から行いますIDE。

  2. 出力を調べ、所有している Amazon S3 バケットの数 (存在する場合) とその名前を確認します。

  3. 新しい Amazon S3 バケットの名前を選択します。dotnet-quicktour-s「3-1-winvs-」をベースとして使用し、 GUIDや名前など、それに固有のものを追加します。「Amazon S3 ユーザーガイド」の「バケット命名規則」で説明されているように、バケット名のルールに従ってください。

  4. アプリケーションを再度実行します。今回はバケット名を指定します。

    コマンドラインで、 を置き換えます。amzn-s3-demo-bucket 次のコマンドで、選択したバケットの名前を指定します。

    S3CreateAndList amzn-s3-demo-bucket

    または、 でアプリケーションを実行している場合はIDE、Project S3CreateAndList Properties Debug を選択し、そこにバケット名を入力します。

  5. 出力を調べて、作成された新しいバケットを確認します。

クリーンアップ

このチュートリアルでは、この時点でクリーンアップを選択できるいくつかのリソースを作成しました。

  • 前のステップでアプリケーションが作成したバケットを保持しない場合は、 の Amazon S3 コンソールを使用して削除しますhttps://console.aws.amazon.com/s3/

  • .NET プロジェクトを保持しない場合は、開発環境から S3CreateAndListフォルダを削除します。

次の段階

クイックツアーメニューに戻るか、このクイックツアーの最後までスキップします。