Azure Files REST API

  • Artikel
  • 4 menit untuk membaca

Azure Files menyediakan berbagi file cloud yang dihosting yang dapat Anda akses ("mount") menggunakan protokol sistem file standar industri seperti SMB dan NFS. Saat Anda memasang berbagi file di komputer Anda menggunakan SMB atau NFS, sistem operasi Anda mengalihkan permintaan API sistem file lokal, seperti yang mungkin Anda buat menggunakan . Antarmuka System.IO NET atau metode buka/baca/tulis Python. Ini berarti bahwa aplikasi, dan yang penting pengguna aplikasi ini, tidak perlu melakukan sesuatu yang istimewa (atau bahkan tahu) data mereka berada di berbagi file jarak jauh alih-alih penyimpanan lokal.

Azure Files juga menyediakan REST API, yang sering disebut FileREST API, yang menyediakan metode lain untuk mengakses data yang disimpan dalam berbagi file Azure. Tidak seperti SMB dan NFS, yang memungkinkan akses transparan ke berbagi file jarak jauh menggunakan API sistem file asli, protokol FileREST menyediakan metode yang berbeda untuk mengakses data berbagi file. Untuk menggunakan FileREST API, Anda membuat permintaan HTTPS terhadap titik akhir HTTPS FileREST. Anda dapat menulis kode untuk membuat permintaan HTTPS sendiri, tetapi cara yang diharapkan untuk menggunakan FileREST API adalah melalui Azure SDK, yang menyediakan API bahasa idiomatik untuk bahasa populer seperti C#, Java, Python, JavaScript, Go, dan lainnya.

Karena FileREST API dirancang khusus untuk Azure Files, ini memungkinkan Anda mengakses fitur Azure Files yang tidak dapat diakses melalui SMB atau NFS, dan melakukan operasi tertentu, seperti penyalinan, lebih efisien daripada melalui SMB/NFS. Sifat HTTPS tanpa status membuat FileREST API berguna untuk digunakan dalam layanan cloud atau aplikasi yang perlu mengakses banyak berbagi file Azure, seperti layanan atau aplikasi bernilai tambah yang dapat dilampirkan ke berbagi file Azure untuk menambahkan beberapa kemampuan. Ini mungkin termasuk antivirus, cadangan, manajemen data, atau produk replikasi. Sebagai contoh, Azure File Sync dan Azure Backup adalah layanan bernilai tambah pihak pertama yang secara ekstensif menggunakan FileREST API untuk menambahkan nilai di atas berbagi file Azure milik pelanggan.

Sebagai aturan umum, Anda harus mempertimbangkan untuk menggunakan FileREST API jika Anda membangun layanan atau aplikasi bernilai tambah, terutama jika Anda memberikan layanan bernilai tambah tersebut kepada pelanggan Anda. Jika Anda membuat aplikasi lini bisnis, terutama yang akan digunakan pengguna akhir terhadap berbagi file Azure yang dipasang, Anda dapat menggunakan SMB/NFS atau FileREST, namun, Anda mungkin menemukan bahwa menggunakan SMB/NFS menyediakan jalur yang lebih mudah karena mereka memungkinkan Anda menggunakan API sistem file asli. Jika Anda memiliki aplikasi yang sudah ada yang ditulis API sistem file asli, Anda benar-benar tidak perlu menulis ulang untuk memanfaatkan Azure Files; proposisi nilai kunci Azure Files mengekspos API sistem file asli melalui penggunaan SMB atau NFS.

Untuk mempelajari selengkapnya tentang Azure Files, termasuk penyebaran, jaringan, dan konfigurasi identitas, lihat:

Pesawat kontrol

Di Azure, sarana kontrol disediakan melalui Azure Resource Manager, terkadang disingkat ARM, yang menyediakan cara umum untuk mengekspos sumber daya Azure untuk dikelola oleh pelanggan. Unit manajemen tingkat atas, atau sumber daya terlacak di Azure Files, dan layanan penyimpanan lainnya seperti penyimpanan Blob, adalah akun penyimpanan. Akun penyimpanan dikelola oleh penyedia sumber daya penyimpanan, yang memiliki namespace Microsoft. Storage. Penyedia sumber daya penyimpanan juga mengekspos manajemen sumber daya anak, atau sumber daya proksi, yang memungkinkan manajemen layanan penyimpanan yang dibundel di akun penyimpanan. Untuk Azure Files, ada dua sumber daya proksi yang relevan:

  • Sumber FileService daya, yang menyediakan pengaturan khusus Azure Files yang berlaku untuk semua berbagi file di akun penyimpanan. Sumber FileService daya adalah anak dari sumber daya yang dilacak akun penyimpanan, dan akun penyimpanan hanya pernah memiliki satu FileService sumber daya, yang disebut default.

  • Sumber FileShare daya, yang mewakili berbagi file (atau rekam jepret berbagi file). Sumber FileShare daya adalah anak dari FileService sumber daya, dan mungkin berisi jumlah berbagi file yang tak terbatas. FileService Meskipun dapat berisi sejumlah FileShare besar sumber daya, menggunakan jumlah yang sangat besar bukanlah ide yang baik karena segala sesuatu dalam akun penyimpanan berbagi kumpulan IO, bandwidth, dan batas lainnya yang ditentukan. Untuk informasi selengkapnya, lihat Target skalabilitas dan performa Azure Files.

Untuk mempelajari cara memanggil API sarana kontrol, lihat:

Untuk alasan warisan, operasi pada FileService objek dan FileShare juga dapat dilakukan melalui bidang data. Ini adalah artefak Azure Files yang mendahului Azure Resource Manager, dan meskipun API ini didukung sepenuhnya, Anda harus lebih suka menggunakan API penyedia sumber daya penyimpanan untuk mengelola Azure Files karena beberapa alasan:

  • Operasi yang diekspos melalui Azure Resource Manager menggunakan Azure AD untuk autentikasi dan otorisasi, memungkinkan Anda mengelola Azure Files dengan kontrol akses berbasis peran (RBAC). Anda dapat mengotorisasi aplikasi atau layanan Anda untuk memanggil API ini secara terprogram dengan perwakilan layanan Azure AD.

  • Azure Resource Manager API dapat dipanggil secara imperatif, menggunakan REST API secara langsung atau melalui SDK, atau secara deklaratif, dengan menyatakan sumber daya apa yang perlu disebarkan menggunakan templat Azure. Untuk sumber daya yang perlu dibuat berulang kali bersama-sama, penyebaran layanan, dll., menggunakan templat dapat sangat menyederhanakan pekerjaan yang diperlukan.

Meskipun menggunakan penyedia sumber daya penyimpanan untuk mengelola sumber daya penyimpanan lebih disukai, dalam kasus yang membutuhkan skala tinggi, seperti beban kerja yang membuat atau memodifikasi ribuan berbagi file dalam akun penyimpanan yang sama, menggunakan API manajemen sarana data FileREST akan paling berkinerja.

Pesawat data

Azure Files menyediakan sistem file hierarkis untuk data yang tidak terstruktur ("file"). FileREST API memodelkan dua objek penting dalam ruang sistem file: File dan Direktori. Untuk mempelajari cara memanggil API FileREST, lihat:

Lihat juga