AZURE FILES REST API

  • Cikk

Azure Files üzemeltetett felhőbeli fájlmegosztásokat biztosít, amelyekhez iparági szabvány szerinti fájlrendszerprotokollok, például az SMB és az NFS használatával férhet hozzá (csatlakoztatható). Amikor SMB vagy NFS használatával csatlakoztat egy fájlmegosztást a számítógépre, az operációs rendszer átirányítja a helyi fájlrendszer API-kéréseit. Az átirányítás helyi API-kéréseket tartalmaz, amelyeket a .NET-felületek System.IO vagy a Python nyílt, olvasási vagy írási módszereivel tesz meg. Ez azt jelenti, hogy ezeknek az alkalmazásoknak a felhasználóinak nem kell különöset tenniük, sőt azt sem kell tudniuk, hogy az adataik a helyi tárolás helyett távoli fájlmegosztáson vannak.

Azure Files egy REST API-t is biztosít, amelyet gyakran FileREST API-nak neveznek. A FileREST API használatához HTTPS-kéréseket kell létrehoznia a FileREST HTTPS-végpontokon. Írhat kódot a HTTPS-kérések létrehozásához, de olyan Azure SDK-kat biztosítunk, amelyek a FileREST API-t használják, és idiomatikus nyelvi burkolót biztosítanak a FileREST API-n olyan népszerű nyelveken, mint a C#, a Java, a Python, a JavaScript és a Go.

Mivel a FileREST API-t kifejezetten Azure Files tervezték, lehetővé teszi olyan Azure Files funkcióinak elérését, amelyekhez nem lehet SMB-n vagy NFS-en keresztül hozzáférni. Emellett lehetővé teszi bizonyos műveletek, például a másolás, hatékonyabb végrehajtását, mint az SMB-n vagy az NFS-en keresztül.

A HTTPS állapot nélküli jellege hasznossá teszi a FileREST API-t olyan felhőszolgáltatásokhoz vagy alkalmazásokhoz, amelyeknek számos Azure-fájlmegosztáshoz kell hozzáférnie. Például egy képesség hozzáadásához csatolhat értéknövelő szolgáltatásokat vagy alkalmazásokat egy Azure-fájlmegosztáshoz. Ezek a szolgáltatások vagy alkalmazások vírusvédelmi, biztonsági mentési, adatkezelési vagy replikációs termékeket tartalmazhatnak. Azure File Sync és Azure Backup olyan Microsoft-szolgáltatások, amelyek széles körben használják a FileREST API-t, hogy értéket adjanak egy ügyfél tulajdonában lévő Azure-fájlmegosztáshoz.

Fontolja meg a FileREST API használatát, ha értéknövelő szolgáltatásokat vagy alkalmazásokat hoz létre, különösen akkor, ha ezeket a szolgáltatásokat az ügyfeleknek nyújtja. Ha üzletági alkalmazást hoz létre, különösen azt, amelyet a felhasználók egy csatlakoztatott Azure-fájlmegosztáshoz fognak használni, használhatja az SMB/NFS vagy a FileREST fájlt. Előfordulhat azonban, hogy az SMB vagy az NFS használata egyszerűbb utat biztosít, mivel ezek a protokollok lehetővé teszik a natív fájlrendszer API-k használatát.

Ha rendelkezik natív fájlrendszer API-kkal írt meglévő alkalmazással, nem kell újraírnia, hogy kihasználhassa a Azure Files. A Azure Files fő értékajánlata natív fájlrendszer API-k felfedése SMB vagy NFS használatával.

További információ a Azure Files, beleértve az üzembe helyezést, a hálózatkezelést és az identitáskonfigurációt:

Vezérlősík

Az Azure-ban a vezérlősík az Azure Resource Manager keresztül érhető el, amely lehetővé teszi az ügyfél által kezelt Azure-erőforrások elérhetővé tételét. A legfelső szintű felügyeleti egység a tárfiók. A tárfiók egy nyomon követett erőforrás Azure Files és más tárolási szolgáltatásokban, például Azure Blob Storage.

A tárfiókot a tárerőforrás-szolgáltató kezeli, amely a névtérrel Microsoft.Storagerendelkezik. A tárerőforrás-szolgáltató emellett elérhetővé teszi a gyermekerőforrások vagy proxyerőforrások kezelését is, amelyek lehetővé teszik a tárfiókba csomagolt tárolási szolgáltatások kezelését. A Azure Files esetében két releváns proxyerőforrás létezik:

  • Az FileService erőforrás. A Azure Files olyan beállításokat biztosít, amelyek a tárfiókban lévő összes fájlmegosztásra vonatkoznak. Az FileService erőforrás a tárfiók gyermeke. A tárfiókok mindig csak egy FileService erőforrással rendelkeznek: default.

  • Az FileShare erőforrás. Egy fájlmegosztást vagy egy fájlmegosztás pillanatképét jelöli. Az FileShare erőforrás az FileService erőforrás gyermeke, és végtelen számú fájlmegosztást tartalmazhat.

Bár egy FileService erőforrás végtelen számú FileShare erőforrást tartalmazhat, a nagyon nagy szám használata nem jó ötlet, mert a tárfiókon belül minden egy meghatározott I/O-készletet, sávszélességet és egyéb korlátokat oszt meg. További információ: Azure Files skálázhatósági és teljesítménycélok.

A vezérlősík API-inak meghívásáról a következő témakörben olvashat:

A és FileShare objektumok FileService műveletei az adatsíkon keresztül is elvégezhetők. Ez az Azure Resource Manager előtti Azure Files egyik összetevője. Bár ezek az API-k teljes mértékben támogatottak, a legtöbb esetben a tárolási erőforrás-szolgáltató API-kat kell használnia a Azure Files kezeléséhez az alábbi okokból:

  • Az Azure Resource Manager által közzétett műveletek Microsoft Entra ID használnak hitelesítéshez és engedélyezéshez, így a Azure Files szerepköralapú hozzáférés-vezérléssel (RBAC) kezelheti. Engedélyezheti, hogy az alkalmazás vagy szolgáltatás programozott módon hívja meg ezeket az API-kat egy Microsoft Entra szolgáltatásnévvel.

  • Az Azure Resource Manager API-kat igény szerint hívhatja meg közvetlenül a REST API-val vagy egy SDK-val. Deklaratív módon is meghívhatja őket, ha deklarálja, hogy milyen erőforrásokat kell üzembe helyezni az Azure-sablonokon keresztül. Az olyan erőforrások esetében, amelyeket ismételten együtt kell létrehozni (például szolgáltatástelepítésekben), a sablonok használata jelentősen leegyszerűsítheti a szükséges munkát.

  • Bár azt javasoljuk, hogy a tárolási erőforrás-szolgáltatót használja a tárolási erőforrások kezeléséhez, a FileREST adatsík-kezelési API-k jobb teljesítményt nyújtanak a nagy léptékű esetekben. Ilyen eset például egy számítási feladat, amely több ezer fájlmegosztást hoz létre vagy módosít ugyanabban a tárfiókban.

    • Microsoft.Storage storageAccounts/fileServices/shares vezérlősík-műveletet indít el a tárolási erőforrás-szolgáltatón keresztül.
    • Microsoft.Storage storageAccounts/fileServices/fileshares adatsík-művelet. A megosztási szintű szerepkörök, például a Storage File Data SMB Share Reader beállítása adatsík-műveletnek kell lennie, és ezt az erőforrást kell használnia.

Adatsík

Azure Files hierarchikus fájlrendszert biztosít a strukturálatlan adatokhoz. A FileREST API a fájlrendszer két fontos objektumát modellzi: fájlokat és könyvtárakat. A FileREST API-k meghívásáról a következő témakörben olvashat:

Lásd még