ContextQMD
Back to Aws Doc Sdk Examples

AWS SDK for Rust cross-service code examples

rustv1/cross_service/README.md

latest5.7 KB
Original Source

AWS SDK for Rust cross-service code examples

Purpose

These code examples demonstrate how to perform two or more service operations using the AWS SDK for Rust.

Amazon Simple Storage Service (Amazon S3) is storage for the internet. You can use Amazon S3 to store and retrieve any amount of data at any time, from anywhere on the web.

Amazon Rekognition makes it easy to add image and video analysis to your applications.

Amazon DynamoDB (DynamoDB) is a fully managed NoSQL database service that provides fast and predictable performance with seamless scalability.

Amazon Polly is a Text-to-Speech (TTS) cloud service that converts text into lifelike speech.

Amazon Transcribe provides transcription services for your audio files.

Code examples

Detect faces (detect_faces/)

Detect labels (detect_labels/)

Telephone (telephone/)

⚠ Important

  • We recommend that you grant this code least privilege, or at most the minimum permissions required to perform the task. For more information, see Grant Least Privilege in the AWS Identity and Access Management User Guide.
  • This code has not been tested in all AWS Regions. Some AWS services are available only in specific Regions.
  • Running this code might result in charges to your AWS account.

Running the code examples

Prerequisites

You must have an AWS account, and have configured your default credentials and AWS Region as described in https://github.com/awslabs/aws-sdk-rust.

detect_faces

This code example:

  • Saves the image in an Amazon Simple Storage Service (Amazon S3) bucket with an "uploads/" prefix.
  • Displays facial details age range, gender, and emotion (smiling, etc.).
cd detect_faces;
cargo run -- -b BUCKET -f FILENAME [-r REGION] [-v]
  • BUCKET is the name of the Amazon S3 bucket where the JPG, JPEG, or PNG file is uploaded.
  • FILENAME is the name of the file to upload. It must have a jpg, jpeg, or png file extension.
  • REGION is the name of the Region in which the client is created. If not supplied, uses the value of the AWS_REGION environment variable. If the environment variable is not set, defaults to us-west-2.
  • -v displays additional information.

detect_labels

This code example:

  • Gets EXIF information from a JPG, JPEG, or PNG file.
  • Uploads the file to an Amazon S3 bucket.
  • Uses Amazon Rekognition to identify the three top attributes (labels in Amazon Rekognition) in the file.
  • Adds the EXIF and label information to an Amazon DynamoDB table.
cd detect_labels;
cargo run -- -b BUCKET -f FILENAME -t TABLE [-r REGION] [-v]
  • BUCKET is the name of the Amazon S3 bucket where the JPG, JPEG, or PNG file is uploaded.
  • FILENAME is the name of the file to upload. It must have a jpg, jpeg, or png file extension.
  • TABLE is the DynamoDB table in which the EXIF and label information is stored. It must use the primary key filename.
  • REGION is the name of the Region in which the client is created. If not supplied, uses the value of the AWS_REGION environment variable. If the environment variable is not set, defaults to us-west-2.
  • -v displays additional information.

telephone

This example synthesizes a plain text (UTF-8) input file to an audio file, converts that audio file to text, and displays the text.

cd telephone
cargo run -- -f FILENAME -b BUCKET -j JOB-NAME  [-r REGION] [-v]
  • FILENAME is the name of the input file. The output is saved in MP3 format in a file with the same basename, but with an mp3 extension.
  • BUCKET is the Amazon S3 bucket to which the MP3 file is uploaded.
  • JOB-NAME is the unique name of the job.
  • REGION is the Region in which the client is created. If not supplied, uses the value of the AWS_REGION environment variable. If the environment variable is not set, defaults to us-west-2.
  • -v displays additional information.

Resources

Contributing

To propose a new code example to the AWS documentation team, see CONTRIBUTING.md. The team prefers to create code examples that show broad scenarios rather than individual API calls.

Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved. SPDX-License-Identifier: Apache-2.0