Azure Files REST API

Azure Files udostępnia hostowane udziały plików w chmurze, do których można uzyskać dostęp ("zainstaluj") przy użyciu standardowych w branży protokołów systemu plików, takich jak SMB i NFS. Po instalacji udziału plików na komputerze przy użyciu SMB lub NFS system operacyjny przekierowuje żądania interfejsu API lokalnego systemu plików, takie jak te, które można wykonać przy użyciu systemu . Interfejsy System.IO net lub metody open/read/write języka Python. Oznacza to, że aplikacje i, co ważne, użytkownicy tych aplikacji, nie muszą robić żadnych specjalnych (lub nawet wiedzieć) danych w zdalnym udziału plików, a nie w magazynie lokalnym.

Azure Files udostępnia również interfejs API REST, często nazywany interfejsem API FileREST, który udostępnia inną metodę uzyskiwania dostępu do danych przechowywanych w udziałach plików platformy Azure. W przeciwieństwie do protokołów SMB i NFS, które umożliwiają przezroczysty dostęp do zdalnych udziałów plików przy użyciu natywnych interfejsów API systemu plików, protokół FileREST udostępnia inną metodę uzyskiwania dostępu do danych udziału plików. Aby użyć interfejsu API FileREST, należy utworzyć żądania HTTPS względem punktów końcowych HTTPS usługi FileREST. Możesz napisać kod, aby samodzielnie tworzyć żądania HTTPS, ale oczekiwanym sposobem na korzystanie z interfejsu API FileREST jest korzystanie z zestawów SDK platformy Azure, które zapewniają idiomatyczne interfejsy API języka dla popularnych języków, takich jak C#, Java, Python, JavaScript, Go i inne.

Ponieważ interfejs API FileREST został zaprojektowany specjalnie dla systemu Azure Files, umożliwia dostęp do funkcji systemu Azure Files, które nie są dostępne za pośrednictwem SMB lub NFS, oraz wykonywanie pewnych operacji, takich jak kopiowanie, wydajniej niż za pośrednictwem SMB/NFS. Bez stanowy charakter protokołu HTTPS sprawia, że interfejs API FileREST jest przydatny do użycia w usługach w chmurze lub aplikacjach, które muszą uzyskać dostęp do wielu udziałów plików platformy Azure, takich jak usługi lub aplikacje o wartości dodanej, które można dołączyć do udziału plików platformy Azure, aby dodać pewne możliwości. Mogą to być programy antywirusowe, produkty do tworzenia kopii zapasowych, zarządzania danymi lub replikacji. Na przykład usługi Azure File Sync i Azure Backup to usługi o wartości dodanej, które intensywnie używają interfejsu API FileREST do dodawania wartości do udziału plików platformy Azure należącego do klienta.

Ogólną zasadą jest użycie interfejsu API FileREST w przypadku tworzenia usług lub aplikacji o wartości dodanej, szczególnie w przypadku świadczenia klientom takich usług o wartości dodanej. Jeśli tworzysz aplikację biznesową, szczególnie tę, która będzie przez użytkowników końcowych używać względem zainstalowanego udziału plików platformy Azure, możesz użyć zarówno SMB/NFS, jak i FileREST, jednak może się okazać, że użycie SMB/NFS zapewnia łatwiejszą ścieżkę, ponieważ umożliwiają one korzystanie z natywnych interfejsów API systemu plików. Jeśli masz istniejącą aplikację, która została napisana natywnych interfejsów API systemu plików, absolutnie nie trzeba pisać go ponownie, aby korzystać z zalet Azure Files; Kluczową wartością oferty Azure Files jest udostępnianie natywnych interfejsów API systemu plików za pomocą SMB lub NFS.

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

Płaszczyzna sterowania

Na platformie Azure płaszczyzna sterowania jest udostępniana za pośrednictwem Azure Resource Manager, czasami skracana jako ARM, co zapewnia wspólny sposób uwypięcia zasobów platformy Azure, które mają być zarządzane przez klienta. Jednostką zarządzania najwyższego poziomu lub śledzony zasób w Azure Files oraz innymi usługami magazynu, takimi jak Blob Storage, jest konto magazynu. 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 w pakiecie na koncie magazynu. W Azure Files istnieją dwa odpowiednie zasoby serwera proxy:

  • Zasób , który Azure Files ustawienia, które mają zastosowanie do wszystkich FileService udziałów plików na koncie magazynu. Zasób jest zasobem podrzędnym zasobu śledzonego konta magazynu, a konto magazynu ma tylko FileService jeden FileService zasób o nazwie default .

  • FileShareZasób, który 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. Mimo że element może zawierać nieskończoną liczbę zasobów, użycie bardzo dużej liczby nie jest dobrym pomysłem, ponieważ wszystkie elementy w ramach konta magazynu mają zdefiniowaną pulę we/wy, przepustowość i FileService FileShare inne limity. Aby uzyskać więcej informacji, zobacz Azure Files cele dotyczące skalowalności i wydajności.

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

Ze względu na starsze wersje operacje na FileService obiektach i FileShare mogą być również wykonywane za pośrednictwem płaszczyzny danych. Jest to artefakt usługi Azure Files przed Azure Resource Manager i chociaż te interfejsy API są w pełni obsługiwane, należy wolisz używać interfejsów API dostawcy zasobów magazynu do zarządzania Azure Files powodów:

  • Operacje udostępniane za pośrednictwem Azure Resource Manager używają usługi Azure AD do uwierzytelniania i autoryzacji, co umożliwia zarządzanie usługami Azure Files przy użyciu kontroli dostępu opartej na rolach (RBAC). Możesz autoryzować aplikację lub usługę do programowego wywołania tych interfejsów API za pomocą jednostki usługi Azure AD.

  • Azure Resource Manager API mogą być wywoływane imperatywnie przy użyciu interfejsu API REST bezpośrednio lub za pośrednictwem zestawu SDK albo deklarując, jakie zasoby należy wdrożyć przy użyciu szablonów platformy Azure. W przypadku zasobów, które muszą być wielokrotnie tworzone razem, wdrożeń usług itp., użycie szablonów może znacznie uprościć wymaganą pracę.

Mimo że preferowane jest używanie dostawcy zasobów magazynu do zarządzania zasobami magazynu, w przypadkach wymagających dużej skali, takich jak obciążenie, które tworzy lub modyfikuje tysiące udziałów plików w ramach tego samego konta magazynu, użycie interfejsów API zarządzania płaszczyzną danych FileREST będzie najbardziej efektywne.

Płaszczyzna danych

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

Zobacz też