AZURE FILES REST API

  • Cikk

Azure Files üzemeltetett felhőbeli fájlmegosztásokat biztosít, amelyek az iparági szabványnak megfelelő fájlrendszerprotokollok, például az SMB és az NFS használatával érhetők el (csatlakoztathatók). Amikor SMB vagy NFS használatával csatlakoztat egy fájlmegosztást a számítógépen, 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 is tartalmaz, amelyeket .NET-felületek System.IO vagy Python nyílt, olvasási vagy írási metódusok használatával küld el. Ez azt jelenti, hogy ezeknek az alkalmazásoknak a felhasználóinak nem kell semmilyen különleges műveletet végrehajtaniuk, sőt azt sem kell tudniuk, hogy az adataik egy távoli fájlmegosztáson vannak a helyi tároló helyett.

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 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-hoz 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 Azure Files olyan 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. Hozzáadhat például értéknóta-szolgáltatásokat vagy alkalmazásokat egy Azure-fájlmegosztáshoz egy képesség hozzáadásához. 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 jelentős 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áson.

Érdemes lehet a FileREST API-t használni, 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 olyant, amelyet a felhasználók egy csatlakoztatott Azure-fájlmegosztáshoz fognak használni, használhatja az SMB/NFS vagy a FileREST parancsot. Előfordulhat azonban, hogy az SMB vagy az NFS használata egyszerűbb utat biztosít, mivel ezek a protokollok lehetővé teszik natív fájlrendszer API-k használatát.

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

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

Vezérlősík

Az Azure-ban a vezérlősíkot az Azure Resource Manager biztosítja, amely általános módot kínál az ügyfél által kezelt Azure-erőforrások felfedésére. A felső 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 rendelkezik a névtérrel Microsoft.Storage. A tárolási erő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 két kapcsolódó proxyerőforrást biztosít:

  • Az FileService erőforrás. A tárfiókban lévő összes fájlmegosztásra vonatkozó Azure Files vonatkozó beállításokat biztosít. 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, 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 tartalmaz. További információ: Azure Files méretezhetőségi és teljesítménycélok.

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

A és FileShare az FileService objektumon végzett műveletek az adatsíkon keresztül is elvégezhetők. Ez az Azure Resource Manager előtagjának Azure Files összetevője. Bár ezek az API-k teljes mértékben támogatottak, a legtöbb esetben a storage erőforrás-szolgáltató API-kkal kell kezelnie a Azure Files az alábbi okokból:

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

  • Az Azure Resource Manager API-kat imperatív módon 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 újra és újra létre kell hozni (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 javasoljuk, hogy a tárolóerőforrás-szolgáltatót használja a tárolási erőforrások kezeléséhez, a FileREST adatsíkkezelé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 ugyanazon a tárfiókon belül.

    • 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 egy adatsíkművelet. A megosztási szintű szerepkörök, például a Storage-fájladatok SMB-megosztási olvasója beállításának adatsíkmű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ájlrendszertér 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