Azure Files REST API

  • Artikel

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

Azure Files juga menyediakan REST API, yang sering disebut FileREST API. Untuk menggunakan FileREST API, Anda membuat permintaan HTTPS terhadap titik akhir Https FileREST. Anda dapat menulis kode untuk membuat permintaan HTTPS sendiri, tetapi kami menyediakan Azure SDK yang menggunakan FileREST API untuk Anda, menyediakan pembungkus bahasa idiomatik melalui FileREST API dalam bahasa populer seperti C#, Java, Python, JavaScript, dan Go.

Karena FileREST API dirancang khusus untuk Azure Files, ini memungkinkan Anda untuk mengakses fitur Azure Files yang tidak dapat Anda akses melalui SMB atau NFS. Ini juga memungkinkan Anda untuk melakukan operasi tertentu, seperti menyalin, lebih efisien daripada yang Anda bisa melalui SMB atau NFS.

Sifat HTTPS tanpa status membuat FileREST API berguna untuk layanan cloud atau aplikasi yang perlu mengakses banyak berbagi file Azure. Misalnya, Anda dapat melampirkan layanan atau aplikasi bernilai tambah ke berbagi file Azure untuk menambahkan kemampuan. Layanan atau aplikasi ini mungkin mencakup antivirus, cadangan, manajemen data, atau produk replikasi. Azure File Sync dan Azure Backup adalah layanan Microsoft penting yang secara ekstensif menggunakan FileREST API untuk menambahkan nilai di atas berbagi file Azure milik pelanggan.

Pertimbangkan untuk menggunakan FileREST API jika Anda membangun layanan atau aplikasi bernilai tambah, terutama jika Anda menyediakan layanan tersebut kepada pelanggan. Jika Anda membuat aplikasi lini bisnis, terutama yang akan digunakan pengguna terhadap berbagi file Azure yang dipasang, Anda dapat menggunakan SMB/NFS atau FileREST. Namun, Anda mungkin menemukan bahwa menggunakan SMB atau NFS menyediakan jalur yang lebih mudah karena protokol tersebut memungkinkan Anda menggunakan API sistem file asli.

Jika Anda memiliki aplikasi yang sudah ada yang ditulis dengan API sistem file asli, Anda tidak perlu menulis ulang aplikasi tersebut 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:

Sarana kontrol

Di Azure, sarana kontrol disediakan melalui Azure Resource Manager, yang menyediakan cara umum untuk mengekspos sumber daya Azure yang akan dikelola pelanggan. Unit manajemen tingkat atas adalah akun penyimpanan. Akun penyimpanan adalah sumber daya terlacak di Azure Files dan layanan penyimpanan lainnya, seperti Azure Blob Storage.

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 pengelolaan layanan penyimpanan yang dibundel di akun penyimpanan. Untuk Azure Files, ada dua sumber daya proksi yang relevan:

  • Sumber FileService daya. Ini menyediakan pengaturan khusus untuk Azure Files yang berlaku untuk semua berbagi file di akun penyimpanan. Sumber FileService daya adalah anak dari akun penyimpanan. Akun penyimpanan selalu hanya memiliki satu FileService sumber daya: default.

  • Sumber FileShare daya. Ini mewakili berbagi file atau rekam jepret dari berbagi file. Sumber FileShare daya adalah anak dari FileService sumber daya dan dapat berisi jumlah berbagi file yang tak terbatas.

FileService Meskipun sumber daya dapat berisi jumlah FileShare sumber daya yang tak terbatas, menggunakan jumlah yang sangat besar bukanlah ide yang baik karena segala sesuatu dalam akun penyimpanan berbagi kumpulan I/O, bandwidth, dan batas lainnya yang ditentukan. Untuk informasi selengkapnya, lihat Target skalabilitas dan performa Azure Files.

Untuk mempelajari cara memanggil API sarana kontrol, lihat:

Operasi pada FileService objek dan FileShare juga dapat dilakukan melalui bidang data. Ini adalah artefak Azure Files yang mendahului Azure Resource Manager. Meskipun API ini didukung penuh, dalam banyak kasus Anda harus menggunakan API penyedia sumber daya penyimpanan untuk mengelola Azure Files karena alasan ini:

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

  • Anda dapat memanggil AZURE Resource Manager API secara imperatif, baik melalui REST API secara langsung atau melalui SDK. Atau Anda dapat memanggilnya secara deklaratif, dengan menyatakan sumber daya apa yang perlu disebarkan melalui templat Azure. Untuk sumber daya yang perlu dibuat berulang kali bersama-sama (misalnya, dalam penyebaran layanan), menggunakan templat dapat sangat menyederhanakan pekerjaan yang diperlukan.

  • Meskipun sebaiknya gunakan penyedia sumber daya penyimpanan untuk mengelola sumber daya penyimpanan, menggunakan API manajemen sarana data FileREST akan memberi Anda performa yang lebih baik jika membutuhkan skala tinggi. Contoh kasus seperti itu adalah beban kerja yang membuat atau memodifikasi ribuan berbagi file dalam akun penyimpanan yang sama.

    • Microsoft.Storage storageAccounts/fileServices/shares memicu operasi sarana kontrol melalui penyedia sumber daya penyimpanan.
    • Microsoft.Storage storageAccounts/fileServices/fileshares adalah operasi sarana data. Mengatur peran tingkat berbagi seperti Storage File Data SMB Share Reader harus menjadi operasi data plane dan harus menggunakan sumber daya ini.

Pesawat data

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

Lihat juga