Realización de Servicio de AWS solicitudes con AWS SDK para Rust

Para acceder mediante programación a Servicios de AWS, AWS SDK para Rust usa una estructura de cliente para cada Servicio de AWS. Por ejemplo, si una aplicación necesita acceder a Amazon EC2, esta crea una estructura de cliente de Amazon EC2 para interactuar con ese servicio. A continuación, utiliza el cliente de servicio para realizar solicitudes al mismo Servicio de AWS.

Para realizar una solicitud a un Servicio de AWS, primero debe crear y configurar un cliente de servicio. Cada Servicio de AWS que utiliza el código tiene su propia caja y su propio tipo dedicado para interactuar con él. El cliente expone un método para cada operación de API expuesta por el servicio.

Para interactuar con Servicios de AWS en AWS SDK para Rust, cree un cliente específico para el servicio, utilice sus métodos de API con un encadenamiento fluido de tipo generador y llame a send() para ejecutar la solicitud.

El Client expone un método para cada operación de API expuesta por el servicio. El valor de retorno de cada uno de estos métodos es un «generador fluido», en el que se añaden diferentes entradas para esa API mediante un encadenamiento de llamadas a funciones similar al de un generador. Después de llamar a los métodos del servicio, llame a send() para obtener un Future que dé como resultado una salida correcta o un SdkError. Para obtener más información sobre SdkError, consulte Gestión de errores en AWS SDK para Rust.

El siguiente ejemplo muestra una operación básica con Amazon S3 para crear un bucket en la Región de AWS de us-west-2:

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;

Cada caja de servicios cuenta con módulos adicionales que se utilizan para las entradas de la API, como los siguientes:

Consulte la documentación de referencia de la API de la caja de servicios para obtener información y organización más detalladas de la caja. Por ejemplo, la caja aws-sdk-s3 de Amazon Simple Storage Service tiene varios módulos. Dos de los cuales son: