Udostępnij za pośrednictwem

interfejs API REST Azure Files

  • Artykuł

Azure Files udostępnia hostowane udziały plików w chmurze, do których można uzyskać dostęp (instalowanie) przy użyciu standardowych w branży protokołów systemu plików, takich jak SMB i NFS. Podczas instalowania udziału plików na komputerze przy użyciu protokołu SMB lub NFS system operacyjny przekierowuje żądania interfejsu API dla lokalnego systemu plików. Przekierowanie obejmuje lokalne żądania interfejsu API utworzone przy użyciu interfejsów .NET System.IO lub metod otwierania, odczytu lub zapisu w języku Python. Oznacza to, że użytkownicy tych aplikacji nie muszą wykonywać żadnych specjalnych czynności, a nawet wiedzieć, że ich dane znajdują się w zdalnym udziale plików zamiast w magazynie lokalnym.

Azure Files również udostępnia interfejs API REST, który jest często nazywany interfejsem API FileREST. Aby użyć interfejsu API FileREST, należy utworzyć żądania HTTPS względem punktów końcowych protokołu HTTPS FileREST. Możesz napisać kod do samodzielnego tworzenia żądań HTTPS, ale udostępniamy zestawy SDK platformy Azure, które używają interfejsu API FileREST, zapewniając idiomatyczną otokę języka dla interfejsu API FileREST w popularnych językach, takich jak C#, Java, Python, JavaScript i Go.

Ponieważ interfejs API FileREST został zaprojektowany specjalnie dla Azure Files, umożliwia dostęp do funkcji Azure Files, do których nie można uzyskać dostępu za pośrednictwem protokołu SMB lub NFS. Umożliwia również wykonywanie niektórych operacji, takich jak kopiowanie, wydajniej niż za pośrednictwem protokołu SMB lub NFS.

Bezstanowy charakter protokołu HTTPS sprawia, że interfejs API FileREST jest przydatny w przypadku usług w chmurze lub aplikacji, które muszą uzyskiwać dostęp do wielu udziałów plików platformy Azure. Możesz na przykład dołączyć usługi lub aplikacje dodane do udziału plików platformy Azure, aby dodać możliwość. Te usługi lub aplikacje mogą obejmować oprogramowanie antywirusowe, tworzenie kopii zapasowych, zarządzanie danymi lub produkty replikacji. Azure File Sync i Azure Backup są godnymi uwagi usługami firmy Microsoft, które intensywnie używają interfejsu API FileREST do dodawania wartości na podstawie udziału plików platformy Azure należącego do klienta.

Rozważ użycie interfejsu API FileREST, jeśli tworzysz usługi lub aplikacje o wartości dodanej, zwłaszcza jeśli świadczysz te usługi klientom. Jeśli tworzysz aplikację biznesową, szczególnie taką, której użytkownicy będą używać względem zainstalowanego udziału plików platformy Azure, możesz użyć protokołu SMB/NFS lub FileREST. Jednak może się okazać, że użycie protokołu SMB lub systemu plików NFS jest łatwiejsze, ponieważ te protokoły umożliwiają korzystanie z natywnych interfejsów API systemu plików.

Jeśli masz istniejącą aplikację, która została napisana przy użyciu natywnych interfejsów API systemu plików, nie musisz ponownie zapisywać jej, aby korzystać z Azure Files. Kluczową wartością Azure Files jest uwidacznianie natywnych interfejsów API systemu plików za pomocą protokołu SMB lub NFS.

Aby dowiedzieć się więcej na temat Azure Files, w tym wdrażania, sieci i konfiguracji tożsamości, zobacz:

Płaszczyzna sterowania

Na platformie Azure płaszczyzna sterowania jest udostępniana za pośrednictwem usługi Azure Resource Manager, która zapewnia wspólny sposób uwidaczniania zasobów platformy Azure zarządzanych przez klienta. Jednostka najwyższego poziomu zarządzania to konto magazynu. Konto magazynu jest śledzonym zasobem w Azure Files i innych usługach magazynu, takich jak Azure Blob Storage.

Konto magazynu jest zarządzane przez dostawcę zasobów magazynu, który ma przestrzeń nazw Microsoft.Storage. Dostawca zasobów magazynu udostępnia również zarządzanie zasobami podrzędnymi lub zasobami serwera proxy, które umożliwiają zarządzanie usługami magazynu dołączonymi na koncie magazynu. W przypadku Azure Files istnieją dwa istotne zasoby serwera proxy:

  • Zasób FileService . Udostępnia ona ustawienia specyficzne dla Azure Files, które mają zastosowanie do wszystkich udziałów plików na koncie magazynu. Zasób FileService jest elementem podrzędnym konta magazynu. Konto magazynu zawsze ma tylko jeden FileService zasób: default.

  • Zasób FileShare . Reprezentuje udział plików lub migawkę udziału plików. Zasób FileShare jest elementem podrzędnym FileService zasobu i może zawierać nieskończoną liczbę udziałów plików.

FileService Chociaż zasób może zawierać nieskończoną liczbę FileShare zasobów, użycie bardzo dużej liczby nie jest dobrym pomysłem, ponieważ wszystko w ramach konta magazynu współudzieli zdefiniowaną pulę operacji we/wy, przepustowość i inne limity. Aby uzyskać więcej informacji, zobacz Azure Files cele dotyczące skalowalności i wydajności.

Aby dowiedzieć się, jak wywoływać interfejsy API płaszczyzny sterowania, zobacz:

Operacje na FileService obiektach i FileShare można również wykonywać za pośrednictwem płaszczyzny danych. Jest to artefakt Azure Files poprzedzania Resource Manager Azure. Chociaż te interfejsy API są w pełni obsługiwane, w większości przypadków należy użyć interfejsów API dostawcy zasobów magazynu do zarządzania Azure Files z następujących powodów:

  • Operacje uwidocznione za pośrednictwem usługi Azure Resource Manager używają Tożsamość Microsoft Entra do uwierzytelniania i autoryzacji, dzięki czemu można zarządzać Azure Files przy użyciu kontroli dostępu opartej na rolach (RBAC). Możesz autoryzować aplikację lub usługę do programowego wywoływania tych interfejsów API przy użyciu jednostki usługi Microsoft Entra.

  • Interfejsy API usługi Azure Resource Manager można wywoływać imperatywowo za pośrednictwem interfejsu API REST bezpośrednio lub za pośrednictwem zestawu SDK. Można je również wywołać deklaratywnie, deklarując, jakie zasoby należy wdrożyć za pomocą szablonów platformy Azure. W przypadku zasobów, które muszą być wielokrotnie tworzone razem (na przykład we wdrożeniach usług), użycie szablonów może znacznie uprościć wymaganą pracę.

  • Mimo że zalecamy użycie dostawcy zasobów magazynu do zarządzania zasobami magazynu, użycie interfejsów API zarządzania płaszczyzną danych FileREST zapewni lepszą wydajność w przypadkach wymagających dużej skali. Przykładem takiego przypadku jest obciążenie, które tworzy lub modyfikuje tysiące udziałów plików na tym samym koncie magazynu.

    • Microsoft.Storage storageAccounts/fileServices/shares wyzwala operację płaszczyzny sterowania za pośrednictwem dostawcy zasobów magazynu.
    • Microsoft.Storage storageAccounts/fileServices/fileshares jest operacją płaszczyzny danych. Ustawienie ról na poziomie udziału, takich jak Czytelnik udziału SMB danych pliku magazynu , powinno być operacją płaszczyzny danych i musi używać tego zasobu.

Płaszczyzna danych

Azure Files zapewnia hierarchiczny system plików dla danych bez struktury. Interfejs API FileREST modeluje dwa ważne obiekty w przestrzeni systemu plików: pliki i katalogi. Aby dowiedzieć się, jak wywoływać interfejsy API FileREST, zobacz:

Zobacz też