Azure Files REST API

Azure Files poskytuje hostované cloudové sdílené složky, ke kterým můžete přistupovat (připojovat) pomocí standardních protokolů systému souborů, jako jsou SMB a NFS. Když ke svému počítači připojíte sdílenou složku pomocí protokolu SMB nebo NFS, váš operační systém přesměruje požadavky rozhraní API pro místní systém souborů. Přesměrování zahrnuje místní požadavky rozhraní API, které provádíte pomocí rozhraní .NET System.IO nebo otevřených, čtení nebo metod zápisu v Pythonu. To znamená, že uživatelé těchto aplikací nemusí dělat nic zvláštního nebo dokonce vědět, že jejich data jsou ve vzdálené sdílené složce místo místního úložiště.

Azure Files také poskytuje rozhraní REST API, které se často nazývá FileREST API. Pokud chcete použít rozhraní FileREST API, vytvoříte požadavky HTTPS pro koncové body FileREST HTTPS. Můžete psát kód pro vytváření požadavků HTTPS sami, ale poskytujeme sady Azure SDK, které používají rozhraní FileREST API, a poskytujeme idiomatickou obálku jazyka přes rozhraní FileREST API v oblíbených jazycích, jako jsou C#, Java, Python, JavaScript a Go.

Vzhledem k tomu, že rozhraní FileREST API bylo navrženo speciálně pro Azure Files, umožňuje přístup k funkcím Azure Files, ke kterým nemáte přístup přes PROTOKOL SMB nebo NFS. Umožňuje také provádět určité operace, jako je kopírování, efektivněji, než můžete provádět prostřednictvím protokolu SMB nebo NFS.

Díky bezstavové povaze protokolu HTTPS je rozhraní FileREST API užitečné pro cloudové služby nebo aplikace, které potřebují přístup k mnoha sdíleným složkám Azure. Ke sdílené složce Azure můžete například připojit služby nebo aplikace s přidanou hodnotou a přidat tak funkci. Mezi tyto služby nebo aplikace můžou patřit antivirové, zálohovací, správě dat nebo produkty replikace. Synchronizace souborů Azure a Azure Backup jsou důležité služby Microsoftu, které ve velké míře využívají rozhraní FileREST API k přidání hodnoty sdílené složky Azure vlastněné zákazníkem.

Pokud vytváříte služby nebo aplikace s přidanou hodnotou, zejména pokud tyto služby poskytujete zákazníkům, zvažte použití rozhraní FileREST API. Pokud vytváříte obchodní aplikaci, zejména aplikaci, kterou budou uživatelé používat pro připojenou sdílenou složku Azure, můžete použít SMB/NFS nebo FileREST. Můžete ale zjistit, že použití protokolu SMB nebo NFS poskytuje jednodušší cestu, protože tyto protokoly umožňují používat nativní rozhraní API systému souborů.

Pokud máte existující aplikaci napsanou pomocí nativních rozhraní API systému souborů, nemusíte ji přepisovat, abyste mohli využívat Azure Files. Klíčovou hodnotou Azure Files je zveřejnění nativních rozhraní API systému souborů pomocí protokolu SMB nebo NFS.

Další informace o Azure Files, včetně nasazení, sítí a konfigurace identity, najdete tady:

Řídicí rovina

V Azure se řídicí rovina poskytuje prostřednictvím Azure Resource Manager, která poskytuje běžný způsob zveřejnění prostředků Azure, které bude zákazník spravovat. Nejvyšší jednotkou správy je účet úložiště. Účet úložiště je sledovaný prostředek v Azure Files a dalších službách úložiště, jako je Azure Blob Storage.

Účet úložiště spravuje poskytovatel prostředků úložiště, který má obor názvů Microsoft.Storage. Poskytovatel prostředků úložiště také zpřístupňuje správu podřízených prostředků neboli prostředků proxy, které umožňují správu služeb úložiště, které jsou součástí účtu úložiště. Pro Azure Files existují dva relevantní proxy prostředky:

  • Prostředek FileService . Poskytuje nastavení specifická pro Azure Files, která platí pro všechny sdílené složky v účtu úložiště. Prostředek FileService je podřízeným účtem úložiště. Účet úložiště má vždy jenom jeden FileService prostředek: default.

  • Prostředek FileShare . Představuje sdílenou složku nebo snímek sdílené složky. Prostředek FileShare je podřízeným objektem FileService prostředku a může obsahovat nekonečný počet sdílených složek.

FileService I když prostředek může obsahovat nekonečný počet FileShare prostředků, není vhodné použít velký počet, protože všechno v rámci účtu úložiště sdílí definovaný fond vstupně-výstupních operací, šířky pásma a dalších omezení. Další informace najdete v tématu Azure Files cíle škálovatelnosti a výkonu.

Informace o volání rozhraní API řídicí roviny najdete tady:

Operace s FileService objekty a FileShare lze provádět také prostřednictvím roviny dat. Jedná se o artefakt Azure Files, který předchází Azure Resource Manager. I když jsou tato rozhraní API plně podporovaná, ve většině případů byste ke správě Azure Files měli použít rozhraní API poskytovatele prostředků úložiště, a to z těchto důvodů:

  • Operace vystavené prostřednictvím Azure Resource Manager používají k ověřování a autorizaci Microsoft Entra ID, takže můžete spravovat Azure Files pomocí řízení přístupu na základě role (RBAC). Aplikaci nebo službu můžete autorizovat k programovému volání těchto rozhraní API pomocí Microsoft Entra instančního objektu.

  • Rozhraní API Azure Resource Manager můžete volat imperativním způsobem, a to buď přímo prostřednictvím rozhraní REST API, nebo prostřednictvím sady SDK. Nebo je můžete volat deklarativně deklarací prostředků, které je potřeba nasadit prostřednictvím šablon Azure. U prostředků, které je potřeba opakovaně vytvářet společně (například při nasazování služeb), může použití šablon výrazně zjednodušit požadovanou práci.

  • I když ke správě prostředků úložiště doporučujeme používat poskytovatele prostředků úložiště, použití rozhraní API pro správu roviny dat FileREST vám poskytne lepší výkon v případech, které vyžadují vysoké škálování. Příkladem takového případu je úloha, která vytvoří nebo upraví tisíce sdílených složek v rámci stejného účtu úložiště.

    • Microsoft.Storage storageAccounts/fileServices/shares aktivuje operaci řídicí roviny prostřednictvím poskytovatele prostředků úložiště.
    • Microsoft.Storage storageAccounts/fileServices/fileshares je operace roviny dat. Nastavení rolí na úrovni sdílené složky, jako je například Čtenář sdílené složky smb dat úložiště , by měla být operace roviny dat a musí používat tento prostředek.

Rovina dat

Azure Files poskytuje hierarchický systém souborů pro nestrukturovaná data. Rozhraní FileREST API modeluje dva důležité objekty v prostoru systému souborů: soubory a adresáře. Informace o volání rozhraní FileREST API najdete v následujících tématech:

Viz také