AWS SDK for Rust を使用した AWS のサービス リクエストの作成

プログラムを使用して AWS のサービスにアクセスするために、AWS SDK for Rust は各 AWS のサービスにクライアント構造体を使用します。例えば、アプリケーションが Amazon EC2 にアクセスする必要がある場合、アプリケーションはそのサービスとインターフェイスをとる Amazon EC2 クライアント構造体を作成します。次に、サービスクライアントを使用して、その AWS のサービス に対してリクエストを実行します。

AWS のサービス にリクエストするには、最初にサービスクライアントを作成して設定する必要があります。コードが使用する各 AWS のサービス には、専用のクレートと、やり取りを行うための専用の型があります。クライアントは、サービスが提供する各 API オペレーションに対応するメソッドをそれぞれ公開しています。

AWS SDK for Rust で AWS のサービスとやり取りするには、サービス固有のクライアントを作成して、その API メソッドを fluent builder スタイルの連鎖で使用し、send() を呼び出してリクエストを実行します。

Client は、サービスが提供する各 API オペレーションに対応するメソッドをそれぞれ公開しています。これらの各メソッドの戻り値は「fluent builder」であり、その API に対するさまざまな入力がビルダースタイルの関数呼び出しの連鎖によって追加されます。サービスのメソッドを呼び出した後に send() を呼び出して Future を取得します。これにより、正常な出力または SdkError のいずれかが生成されます。SdkError の詳細については、「AWS SDK for Rust でのエラーの処理」を参照してください。

次の例は、Amazon S3 を使用して us-west-2 AWS リージョン にバケットを作成する基本的なオペレーションを示しています。

let config = aws_config::defaults(BehaviorVersion::latest())
    .load()
    .await;
  
let s3 = aws_sdk_s3::Client::new(&config);
  
let result = s3.create_bucket()
    // Set some of the inputs for the operation.
    .bucket("my-bucket")
    .create_bucket_configuration(
        CreateBucketConfiguration::builder()
            .location_constraint(aws_sdk_s3::types::BucketLocationConstraint::UsWest2)
            .build()
        )
    // send() returns a Future that does nothing until awaited.
    .send()
    .await;

各サービスクレートには、次のような API 入力に使用される追加モジュールがあります。

サービスクレートの詳細なクレート構成や情報の詳細については、「API リファレンスドキュメント」を参照してください。例えば、Amazon Simple Storage Service aws-sdk-s3 のクレートには、複数のモジュールがあります。そのうちの 2 つは次のとおりです。