Fai richieste

Per fare una richiesta a un Servizio AWS, devi prima creare un client di servizio. Per ogni Servizio AWS codice utilizzato, ha una propria cassa e una propria Client per interagire con esso.

ClientEspone un metodo per ogni operazione API esposta dal servizio. Il valore restituito da ciascuno di questi metodi è un «generatore fluente», in cui diversi input per quell'API vengono aggiunti mediante il concatenamento di chiamate di funzioni in stile builder. Dopo aver chiamato i metodi del servizio, chiama send() per ottenere un risultato Futureche genererà un output corretto o un. SdkError Per ulteriori informazioni su SdkError, consulta Gestione degli errori.

L'esempio seguente illustra un'operazione di base con Amazon S3 per creare un bucket in: us-west-2 Regione 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;

Ogni service crate dispone di moduli aggiuntivi utilizzati per gli input delle API, come i seguenti:

Consulta la documentazione di riferimento dell'API per il service crate per informazioni e organizzazione più dettagliate delle casse. Ad esempio, la aws-sdk-s3 cassa per Amazon Simple Storage Service ha diversi moduli. Due dei quali sono: