Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Configuración del Región de AWS para el AWS SDK para Rust

Puede acceder a Servicios de AWS los que operan en un área geográfica específica utilizando Regiones de AWS. Esto puede resultar útil tanto por motivos de redundancia como para mantener sus datos y aplicaciones funcionando cerca del lugar donde usted y sus usuarios acceden a ellos. Para obtener más información sobre cómo se utilizan las regiones, consulte la Guía Región de AWSde referencia de herramientas AWS SDKs y herramientas.

Debes establecer un SDK predeterminado Región de AWS para que Rust lo utilice en AWS las solicitudes. Este valor predeterminado se usa para cualquier llamada a un método de servicio del SDK que no esté especificada en una región.

Para ver ejemplos sobre cómo configurar la región predeterminada mediante el AWS config archivo compartido o las variables de entorno, consulta Región de AWSla Guía de referencia de herramientas AWS SDKs y herramientas.

Región de AWS cadena de proveedores

El siguiente proceso de búsqueda se utiliza al cargar la configuración de un cliente de servicio desde el entorno de ejecución. El primer valor que el SDK encuentra establecido se utiliza en la configuración del cliente. Para obtener más información sobre la creación de clientes de servicio, consulteConfigure un cliente desde el entorno.

RegionProviderChainSe usa automáticamente sin código adicional al crear una configuración básica para usarla con un cliente de servicio:

let config = aws_config::defaults(BehaviorVersion::latest())
    .load()
    .await;

Configurar el código Región de AWS de entrada

Establecer explícitamente la región en el código

Úselo Region::new() directamente en su configuración cuando desee establecer la región de forma explícita.

La cadena de proveedores de regiones no se utiliza; no comprueba el entorno, el config archivo compartido ni el Amazon EC2 Instance Metadata Service.

use aws_config::{defaults, BehaviorVersion};
use aws_sdk_s3::config::Region;

#[tokio::main]
async fn main() {
    let config = defaults(BehaviorVersion::latest())
        .region(Region::new("us-west-2"))
        .load()
        .await;

    println!("Using Region: {}", config.region().unwrap());
}

Asegúrese de introducir una cadena válida para un Región de AWS; el valor proporcionado no está validado.

Personalizar el RegionProviderChain

Úselo Región de AWS cadena de proveedores cuando desee inyectar una región de forma condicional, anularla o personalizar la cadena de resolución.

use aws_config::{defaults, BehaviorVersion};
use aws_config::meta::region::RegionProviderChain;
use aws_sdk_s3::config::Region;
use std::env;

#[tokio::main]
async fn main() {  
    let region_provider = RegionProviderChain::first_try(env::var("CUSTOM_REGION").ok().map(Region::new))
        .or_default_provider()
        .or_else(Region::new("us-east-2"));
    
    let config = aws_config::defaults(BehaviorVersion::latest())
        .region(region_provider)
        .load()
        .await;

    println!("Using Region: {}", config.region().unwrap());
}

La configuración anterior permitirá: