Referensi REST API Azure Storage

  • Artikel

REST API untuk layanan penyimpanan Microsoft Azure menawarkan akses terprogram ke layanan Blob, Queue, Table, dan File di Azure atau dalam lingkungan pengembangan melalui emulator penyimpanan.

Semua layanan penyimpanan dapat diakses melalui REST API. Layanan penyimpanan dapat diakses dari dalam layanan yang berjalan di Azure, atau langsung melalui Internet dari aplikasi apa pun yang dapat mengirim permintaan HTTP/HTTPS dan menerima respons HTTP/HTTPS.

Penting

Layanan penyimpanan Azure mendukung HTTP dan HTTPS; namun, menggunakan HTTPS sangat disarankan.

Akun Penyimpanan

Semua akses ke layanan penyimpanan berlangsung melalui akun penyimpanan. Akun penyimpanan adalah tingkat tertinggi namespace layanan untuk mengakses setiap layanan dasar. Ini juga merupakan dasar untuk otorisasi.

REST API untuk layanan penyimpanan mengekspos akun penyimpanan sebagai sumber daya.

Blob Service

Blob service menyediakan penyimpanan untuk entitas, seperti file biner dan file teks. REST API untuk blob service mengekspos dua sumber daya: kontainer dan blob. Kontainer seperti folder, yang berisi sekumpulan blob; setiap blob harus berada dalam kontainer. Blob service mendefinisikan tiga jenis blob:

  • Blob blok, yang dioptimalkan untuk streaming. Jenis blob ini adalah satu-satunya jenis blob yang tersedia dengan versi sebelum 2009-09-19.

  • Blob halaman, yang dioptimalkan untuk operasi baca/tulis acak dan yang menyediakan kemampuan untuk menulis ke berbagai byte dalam blob. Blob halaman tersedia dengan versi 2009-09-19 dan yang lebih baru. Ini terutama digunakan untuk file VHD yang mendukung AzureVM.

  • Tambahkan blob, yang dioptimalkan hanya untuk operasi penambah. Blob tambahan hanya tersedia dengan versi 2015-02-21 dan yang lebih baru.

Kontainer dan blob mendukung metadata yang ditentukan pengguna dalam bentuk pasangan nama-nilai yang ditentukan sebagai header pada operasi permintaan.

Dengan menggunakan REST API untuk blob service, pengembang dapat membuat namespace hierarkis yang mirip dengan sistem file. Nama blob dapat mengodekan hierarki dengan menggunakan pemisah jalur yang dapat dikonfigurasi. Misalnya, nama blob MyGroup/MyBlob1 dan MyGroup/MyBlob2 menyiratkan tingkat organisasi virtual untuk blob. Operasi enumerasi untuk blob mendukung melintasi hierarki virtual dengan cara yang mirip dengan sistem file, sehingga Anda dapat mengembalikan sekumpulan blob yang diatur di bawah grup. Misalnya, Anda dapat menghitung semua blob yang diatur di bawah MyGroup/.

Blob blok dapat dibuat dengan salah satu dari dua cara. Anda dapat mengunggah blob dengan satu operasi Put Blob , atau Anda dapat mengunggah blob sebagai satu set blok dengan operasi Put Block dan menerapkan blok ke blob dengan operasi Put Block List .

Blob halaman dibuat dan diinisialisasi dengan ukuran maksimum dengan panggilan ke Put Blob. Untuk menulis konten ke blob halaman, Anda memanggil operasi Letakkan Halaman .

Blob tambahan dapat dibuat dengan memanggil Put Blob. Blob tambahan yang dibuat dengan operasi Put Blob tidak menyertakan konten apa pun. Untuk menulis konten ke blob penambahan, Anda menambahkan blok ke akhir blob dengan memanggil operasi Tambahkan Blok . Memperbarui atau menghapus blok yang ada tidak didukung. Setiap blok dapat memiliki ukuran yang berbeda, hingga maksimum 4 MiB. Ukuran maksimum untuk blob penambahan adalah 195 GiB, dan blob penambahan dapat mencakup tidak lebih dari 50.000 blok.

Blob mendukung operasi pembaruan kondisional yang mungkin berguna untuk kontrol konkurensi dan pengunggahan yang efisien.

Blob dapat dibaca dengan memanggil operasi Dapatkan Blob . Klien dapat membaca seluruh blob, atau rentang byte arbitrer.

Untuk referensi BLob service API, lihat Blob Service REST API.

Layanan Antrean

Layanan Antrean menyediakan olahpesan persisten yang andal di dalam dan di antara layanan. REST API untuk layanan Antrean mengekspos dua sumber daya: antrean dan pesan.

Antrean mendukung metadata yang ditentukan pengguna dalam bentuk pasangan nama-nilai yang ditentukan sebagai header pada operasi permintaan.

Setiap akun penyimpanan mungkin memiliki jumlah antrean pesan yang tidak terbatas yang dinamai secara unik dalam akun. Setiap antrean pesan mungkin berisi jumlah pesan yang tidak terbatas. Ukuran maksimum untuk pesan dibatasi hingga 64 KiB untuk versi 2011-08-18 dan 8 KiB untuk versi sebelumnya.

Ketika pesan dibaca dari antrean, konsumen diharapkan untuk memproses pesan dan kemudian menghapusnya. Setelah pesan dibaca, pesan dibuat tidak terlihat oleh konsumen lain untuk interval tertentu. Jika pesan belum dihapus pada saat interval kedaluwarsa, visibilitasnya dipulihkan, sehingga konsumen lain dapat memprosesnya.

Untuk informasi selengkapnya tentang layanan Antrean, lihat Queue Service REST API.

Layanan Tabel

Layanan Tabel menyediakan penyimpanan terstruktur dalam bentuk tabel. Layanan Table mendukung REST API yang mengimplementasikan protokol OData.

Dalam akun penyimpanan, pengembang dapat membuat tabel. Tabel menyimpan data sebagai entitas. Entitas adalah kumpulan properti bernama dan nilainya, mirip dengan baris. Tabel dipartisi untuk mendukung penyeimbangan beban di seluruh simpul penyimpanan. Setiap tabel memiliki sebagai properti pertamanya kunci partisi yang menentukan partisi milik entitas. Properti kedua adalah kunci baris yang mengidentifikasi entitas dalam partisi tertentu. Kombinasi kunci partisi dan kunci baris membentuk kunci primer yang mengidentifikasi setiap entitas secara unik dalam tabel.

Layanan Tabel tidak memberlakukan skema apa pun. Pengembang dapat memilih untuk menerapkan dan menerapkan skema di sisi klien. Untuk informasi selengkapnya tentang layanan Table, lihat Table Service REST API.

Layanan File

Protokol Blok Pesan Server (SMB) adalah protokol berbagi file pilihan yang digunakan secara lokal saat ini. Layanan File Microsoft Azure memungkinkan pelanggan untuk memanfaatkan ketersediaan dan skalabilitas SMB Cloud Infrastructure as a Service (IaaS) Azure tanpa harus menulis ulang aplikasi klien SMB.

Layanan Azure File juga menawarkan alternatif menarik untuk solusi Direct Attached Storage (DAS) dan Storage Area Network (SAN) tradisional, yang seringkali rumit dan mahal untuk diinstal, dikonfigurasi, dan dioperasikan.

File yang disimpan dalam berbagi layanan Azure File dapat diakses melalui protokol SMB, dan juga melalui REST API. Layanan File menawarkan empat sumber daya berikut: akun penyimpanan, berbagi, direktori, dan file. Berbagi menyediakan cara untuk mengatur set file dan juga dapat dipasang sebagai berbagi file SMB yang dihosting di cloud.

Lihat juga

Blob Service REST APIQueue Service REST APITable Service REST APIFile Service REST API