Menggunakan versi perilaku di AWS SDK for Rust

AWS SDK for Rust pengembang mengharapkan dan mengandalkan perilaku yang kuat dan dapat diprediksi yang ditawarkan bahasa dan perpustakaan utamanya. Untuk membantu pengembang yang menggunakan SDK for Rust mendapatkan perilaku yang diharapkan, konfigurasi klien diperlukan untuk menyertakan file. BehaviorVersion BehaviorVersionMenentukan versi SDK yang defaultnya diharapkan. Hal ini memungkinkan SDK berkembang dari waktu ke waktu, mengubah praktik terbaik agar sesuai dengan standar baru dan mendukung fitur baru tanpa dampak buruk yang tidak terduga pada perilaku aplikasi Anda.

Awas

Jika Anda mencoba mengonfigurasi SDK atau membuat klien tanpa secara eksplisit menentukan aBehaviorVersion, konstruktor akan melakukannya. panic

Misalnya, bayangkan bahwa versi baru SDK dirilis dengan kebijakan coba ulang default yang baru. Jika aplikasi Anda menggunakan BehaviorVersion pencocokan versi SDK sebelumnya, maka konfigurasi sebelumnya akan digunakan sebagai ganti konfigurasi default yang baru.

Setiap kali versi perilaku baru SDK untuk Rust dirilis, versi sebelumnya BehaviorVersion ditandai dengan deprecated atribut SDK for Rust dan versi baru ditambahkan. Hal ini menyebabkan peringatan terjadi pada waktu kompilasi, tetapi sebaliknya, biarkan build berlanjut seperti biasa. BehaviorVersion::latest()juga diperbarui untuk menunjukkan perilaku default versi baru.

catatan

Jika kode Anda tidak bergantung pada karakteristik perilaku yang sangat spesifik, Anda harus menggunakan BehaviorVersion::latest() dalam kode atau menggunakan tanda fitur behavior-version-latest dalam Cargo.toml file. Jika Anda menulis kode yang sensitif terhadap latensi, atau yang menyetel perilaku Rust SDK, pertimbangkan BehaviorVersion untuk menyematkan ke versi utama tertentu.

Setel versi perilaku di Cargo.toml

Anda dapat menentukan versi perilaku untuk SDK dan modul individual, seperti aws-sdk-s3 atauaws-sdk-iam, dengan menyertakan tanda fitur yang sesuai dalam Cargo.toml file. Saat ini, hanya latest versi SDK yang didukung diCargo.toml:

[dependencies]
aws-config = { version = "1", features = ["behavior-version-latest"] }
aws-sdk-s3 = { version = "1", features = ["behavior-version-latest"] }

Mengatur versi perilaku dalam kode

Kode Anda dapat mengubah versi perilaku sesuai kebutuhan dengan menentukannya saat mengonfigurasi SDK atau klien:

let config = aws_config::load_defaults(BehaviorVersion::v2023_11_09()).await;

Contoh ini membuat konfigurasi yang menggunakan lingkungan untuk mengkonfigurasi SDK tetapi menetapkan BehaviorVersion kev2023_11_09().