Menggunakan AWS SDK for .NET - Amazon Simple Storage Service
Organisasi API .NETMenjalankan Contoh Kode Amazon S3 .NET

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

Menggunakan AWS SDK for .NET

AWS SDK for .NET Ini menyediakan API untuk bucket Amazon S3 dan operasi objek. Untuk operasi objek, selain menyediakan API untuk mengunggah objek dalam satu operasi, SDK menyediakan API untuk mengunggah objek besar dalam beberapa bagian (lihat Mengunggah dan menyalin objek menggunakan unggahan multibagian).

AWS SDK for .NET Ini memberi Anda opsi untuk menggunakan API tingkat tinggi atau tingkat rendah.

API Tingkat Rendah

API tingkat rendah sesuai dengan operasi REST Amazon S3 yang mendasarinya, termasuk operasi buat, perbarui, dan hapus yang berlaku untuk bucket dan objek. Saat Anda mengunggah objek besar menggunakan API pengunggahan multibagian tingkat rendah (lihat Mengunggah dan menyalin objek menggunakan unggahan multibagian), API ini memberikan kontrol yang lebih besar. Misalnya, Anda dapat menjeda dan melanjutkan unggahan multibagian, mengubah ukuran bagian selama pengunggahan, atau memulai pengunggahan saat Anda tidak mengetahui ukuran data sebelumnya. Jika Anda tidak memiliki persyaratan ini, gunakan API tingkat tinggi untuk mengunggah objek.

API Tingkat Tinggi

Untuk mengunggah objek, SDK memberikan tingkat abstraksi yang lebih tinggi dengan menyediakan kelas TransferUtility. API tingkat tinggi adalah API yang lebih sederhana, yaitu hanya dengan beberapa baris kode, Anda dapat mengunggah file dan streaming ke Amazon S3. Anda harus menggunakan API ini untuk mengunggah data, kecuali jika Anda perlu mengontrol pengunggahan sebagaimana dijelaskan di bagian API Tingkat Rendah sebelumnya.

Untuk ukuran data yang lebih kecil, API TransferUtility mengunggah data dalam satu operasi. Namun, TransferUtility akan beralih menggunakan API pengunggahan multibagian saat ukuran data mencapai ambang tertentu. Secara default, aplikasi ini menggunakan beberapa utas untuk mengunggah secara bersamaan. Jika pengunggahan suatu bagian gagal, API akan mengulang pengunggahan bagian yang gagal hingga tiga kali. Namun, ini adalah opsi yang dapat dikonfigurasi.

catatan

Saat Anda menggunakan stream untuk sumber data, kelas TransferUtility tidak mengunggah secara bersamaan.

Organisasi API .NET

Saat menulis aplikasi Amazon S3 menggunakan AWS SDK for .NET, Anda menggunakan file. AWSSDK.dll Namespace berikut dalam rakitan ini menyediakan API unggahan multi-bagian:

  • Amazon.S3.Transfer—Menyediakan API tingkat tinggi untuk mengunggah data Anda dalam beberapa bagian.

    API ini mencakup kelas TransferUtility yang memungkinkan Anda menentukan berkas, direktori, atau stream untuk mengunggah data Anda. Ini juga mencakup kelas TransferUtilityUploadRequest dan TransferUtilityUploadDirectoryRequest untuk mengonfigurasi pengaturan lanjutan, seperti jumlah thread serentak, ukuran bagian, metadata objek, kelas penyimpanan (STANDARD, REDUCED_REDUNDANCY), dan daftar kontrol akses (ACL) objek.

  • Amazon.S3—Menyediakan implementasi untuk API tingkat rendah.

    API ini menyediakan metode yang sesuai dengan API pengunggahan multibagian Amazon S3 REST (lihat Penggunaan API REST).

  • Amazon.S3.Model—Menyediakan kelas API tingkat rendah untuk membuat permintaan dan respons proses. Misalnya, API ini memberikan kelas InitiateMultipartUploadRequest dan InitiateMultipartUploadResponse yang dapat Anda gunakan saat memulai pengunggahan multibagian, dan kelas UploadPartRequest dan UploadPartResponse saat mengunggah bagian.

  • Amazon.S3.Encryption— Menyediakan AmazonS3EncryptionClient.

  • Amazon.S3.Util— Menyediakan berbagai kelas utilitas seperti AmazonS3Util dan BucketRegionDetector.

Untuk informasi selengkapnya tentang AWS SDK for .NET API, lihat AWS SDK for .NET Version 3 API Reference.

Menjalankan Contoh Kode Amazon S3 .NET

Contoh kode.NET dalam panduan ini kompatibel dengan AWS SDK for .NET versi 3.0. Untuk informasi tentang menyiapkan dan menjalankan contoh kode, lihat Memulai SDK for .NET di AWSAWS SDK for .NET Developer Guide.