Versi 4 (V4) AWS SDK untuk .NET telah dirilis!

Untuk informasi tentang mengubah perubahan dan memigrasikan aplikasi Anda, lihat topik https://docs.aws.amazon.com/sdk-for-net/v4/developer-guide/net-dg-v4.html migrasi.

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Percobaan ulang dan batas waktu

Ini AWS SDK untuk .NET memungkinkan Anda untuk mengonfigurasi jumlah percobaan ulang dan nilai batas waktu untuk permintaan HTTP ke AWS layanan. Jika nilai default untuk percobaan ulang dan batas waktu tidak sesuai untuk aplikasi Anda, Anda dapat menyesuaikannya dengan persyaratan spesifik Anda, tetapi penting untuk memahami bagaimana hal itu akan mempengaruhi perilaku aplikasi Anda.

Untuk menentukan nilai mana yang akan digunakan untuk percobaan ulang dan batas waktu, pertimbangkan hal berikut:

Pengaturan coba ulang dan batas waktu memengaruhi performa aplikasi yang dirasakan. Untuk rekomendasi terkait, lihatPraktik terbaik kinerja.

Percobaan ulang

Gambaran umum

Per AWS SDK untuk .NET mintaan dapat mencoba lagi yang gagal karena pelambatan sisi server atau koneksi terputus. Ada dua properti kelas konfigurasi layanan yang dapat Anda gunakan untuk menentukan perilaku coba ulang klien layanan. Kelas konfigurasi layanan mewarisi properti ini dari Amazon.Runtime.ClientConfig kelas abstrak Refer AWS SDK untuk .NET ensi API:

Deskripsi terperinci untuk properti ini dapat ditemukan di Amazon.Runtime.ClientConfig kelas abstrak Refer AWS SDK untuk .NET ensi API. Setiap nilai RetryMode sesuai secara default dengan nilai tertentuMaxErrorRetry, seperti yang ditunjukkan pada tabel berikut.

Perilaku

Saat aplikasi Anda dimulai

Saat aplikasi Anda dimulai, nilai default untuk RetryMode dan MaxErrorRetry dikonfigurasi oleh SDK. Nilai default ini digunakan saat Anda membuat klien layanan kecuali Anda menentukan nilai lain.

Saat aplikasi Anda berjalan

Saat Anda membuat klien layanan, Anda dapat menggunakan nilai default untuk RetryMode danMaxErrorRetry, seperti yang dijelaskan sebelumnya, atau Anda dapat menentukan nilai lain. Untuk menentukan nilai lain, buat dan sertakan objek konfigurasi layanan seperti AmazonDynamoDBConfig atau AmazonSQSConfig saat Anda membuat klien layanan.

Nilai-nilai ini tidak dapat diubah untuk klien layanan setelah dibuat.

Pertimbangan-pertimbangan

Ketika percobaan ulang terjadi, latensi permintaan Anda meningkat. Anda harus mengonfigurasi percobaan ulang berdasarkan batas aplikasi untuk total latensi permintaan dan tingkat kesalahan.

Waktu habis

Ini AWS SDK untuk .NET memungkinkan Anda untuk mengonfigurasi batas waktu permintaan di tingkat klien layanan dan per panggilan metode. Ada dua mekanisme untuk mengonfigurasi batas waktu, yang tercakup dalam bagian berikutnya:

Menggunakan CancellationToken parameter untuk batas waktu

Ini AWS SDK untuk .NET memungkinkan Anda untuk mengkonfigurasi batas waktu permintaan pada panggilan asinkron dengan menggunakan parameter. CancellationToken Cuplikan kode berikut menunjukkan contoh. Kode melempar System.Threading.Tasks.TaskCanceledException jika permintaan tidak selesai dalam 10 detik.

string bucketName = "amzn-s3-demo-bucket";
string path = "pathToBucket";
using (var amazonS3Client = new AmazonS3Client(new AmazonS3Config()))
{
    // Cancel request after 10 seconds
    CancellationTokenSource cancellationTokenSource = new CancellationTokenSource(TimeSpan.FromMilliseconds(10000));
    CancellationToken cancellationToken = cancellationTokenSource.Token;
    ListObjectsV2Request listRequestV2 = new()
    {
        BucketName = bucketName,
        Prefix = path,
    };

    ListObjectsV2Response listResponseV2 = await amazonS3Client.ListObjectsV2Async(listRequestV2, cancellationToken);
}

Menggunakan T imeout dan ReadWriteTimeout properti untuk batas waktu

Ini AWS SDK untuk .NET memungkinkan Anda untuk mengonfigurasi nilai batas waktu permintaan dan batas read/write waktu soket di tingkat klien layanan. Nilai-nilai ini ditentukan dalam Timeout dan ReadWriteTimeout properti Amazon.Runtime.ClientConfig kelas abstrak. Nilai-nilai ini diteruskan sebagai ReadWriteTimeout properti Timeout dan dari HttpWebRequest objek yang dibuat oleh objek klien AWS layanan. Secara default, nil Timeout ainya adalah 100 detik dan ReadWriteTimeout nilainya 300 detik.

Ketika jaringan Anda memiliki latensi tinggi, atau ada kondisi yang menyebabkan operasi dicoba ulang, menggunakan nilai batas waktu yang lama dan jumlah percobaan ulang yang tinggi dapat menyebabkan beberapa operasi SDK tampak tidak responsif.

Berikut ini adalah pengecualian untuk nilai batas waktu default. Nilai-nilai ini diganti ketika Anda secara eksplisit menetapkan nilai batas waktu.

Contoh berikut menunjukkan cara menentukan mode coba ulang standar, maksimal 3 kali percobaan ulang, batas waktu 10 detik, dan batas read/write waktu 10 detik (jika berlaku). Konstruktor Amazons3Client diberi objek Amazons3config. https://docs.aws.amazon.com/sdkfornet/v4/apidocs/items/S3/TS3Config.html

var s3Client = new AmazonS3Client(
  new AmazonS3Config
  {
    Timeout = TimeSpan.FromSeconds(10),
    // NOTE: The following property is obsolete for
    //       versions of the AWS SDK untuk .NET that target .NET Core.
    ReadWriteTimeout = TimeSpan.FromSeconds(10),
    RetryMode = RequestRetryMode.Standard,
    MaxErrorRetry = 3
  });