REST API'Azure Dosyalar

  • Makale

Azure Dosyalar, SMB ve NFS gibi endüstri standardı dosya sistemi protokollerini kullanarak erişebileceğiniz (bağlayabildiğiniz) barındırılan bulut dosya paylaşımları sağlar. SMB veya NFS kullanarak bilgisayarınıza bir dosya paylaşımı bağladığınızda, işletim sisteminiz yerel dosya sistemi için API isteklerini yeniden yönlendirir. Yeniden yönlendirme, .NET System.IO arabirimlerini veya Python açma, okuma veya yazma yöntemlerini kullanarak yaptığınız yerel API isteklerini içerir. Bu, bu uygulamaların kullanıcılarının özel bir şey yapmalarına gerek olmadığı ve hatta verilerinin yerel depolama yerine uzak bir dosya paylaşımında olduğunu bilmeleri gerekmeyen anlamına gelir.

Azure Dosyalar genellikle FileREST API olarak adlandırılan bir REST API de sağlar. FileREST API'sini kullanmak için FileREST HTTPS uç noktalarına yönelik HTTPS istekleri oluşturursunuz. HTTPS isteklerini kendiniz oluşturmak için kod yazabilirsiniz, ancak sizin için FileREST API'sini kullanan Azure SDK'ları sunarak C#, Java, Python, JavaScript ve Go gibi popüler dillerde FileREST API'si üzerinde bir diyotmatik dil sarmalayıcı sağlarız.

FileREST API özellikle Azure Dosyalar için tasarlandığından, SMB veya NFS üzerinden erişemediğiniz Azure Dosyalar özelliklerine erişmenizi sağlar. Ayrıca kopyalama gibi belirli işlemleri SMB veya NFS aracılığıyla gerçekleştirebileceğinizden daha verimli bir şekilde gerçekleştirmenizi sağlar.

HTTPS'nin durum bilgisi olmayan yapısı, FileREST API'sini birçok Azure dosya paylaşımına erişmesi gereken bulut hizmetleri veya uygulamalar için kullanışlı hale getirir. Örneğin, bir özellik eklemek için azure dosya paylaşımına katma değerli hizmetler veya uygulamalar ekleyebilirsiniz. Bu hizmetler veya uygulamalar virüsten koruma, yedekleme, veri yönetimi veya çoğaltma ürünlerini içerebilir. Azure Dosya Eşitleme ve Azure Backup, müşteriye ait Azure dosya paylaşımının üzerine değer katmak için FileREST API'sini yaygın olarak kullanan önemli Microsoft hizmetleridir.

Özellikle bu hizmetleri müşterilere sağlıyorsanız, katma değerli hizmetler veya uygulamalar oluşturuyorsanız FileREST API'sini kullanmayı göz önünde bulundurun. Özellikle kullanıcıların bağlı bir Azure dosya paylaşımında kullanacağı bir iş kolu uygulaması oluşturursanız, SMB/NFS veya FileREST kullanabilirsiniz. Ancak, SMB veya NFS kullanmanın daha kolay bir yol sağladığını fark edebilirsiniz çünkü bu protokoller yerel dosya sistemi API'lerini kullanmanızı sağlar.

Yerel dosya sistemi API'leriyle yazılmış mevcut bir uygulamanız varsa, Azure Dosyalar yararlanmak için uygulamayı yeniden yazmanız gerekmez. Azure Dosyalar temel değer teklifi, SMB veya NFS kullanarak yerel dosya sistemi API'lerini kullanıma çıkarmaktır.

Dağıtım, ağ ve kimlik yapılandırması dahil olmak üzere Azure Dosyalar hakkında daha fazla bilgi edinmek için bkz:

Kontrol düzlemi

Azure'da denetim düzlemi, müşterinin yöneteceği Azure kaynaklarını kullanıma sunmanın yaygın bir yolunu sağlayan Azure Resource Manager aracılığıyla sağlanır. En üst düzey yönetim birimi depolama hesabıdır. Depolama hesabı, Azure Dosyalar ve Azure Blob Depolama gibi diğer depolama hizmetlerinde izlenen bir kaynaktır.

Depolama hesabı, ad alanına Microsoft.Storagesahip depolama kaynak sağlayıcısı tarafından yönetilir. Depolama kaynağı sağlayıcısı, depolama hesabında paketlenmiş depolama hizmetlerinin yönetimini sağlayan alt kaynakların veya proxy kaynaklarının yönetimini de kullanıma sunar. Azure Dosyalar için iki ilgili ara sunucu kaynağı vardır:

  • Kaynak FileService . Depolama hesabındaki tüm dosya paylaşımları için geçerli olan Azure Dosyalar özgü ayarlar sağlar. Kaynak FileService , depolama hesabının alt öğesidir. Depolama hesabının her zaman tek bir FileService kaynağı vardır: default.

  • Kaynak FileShare . Dosya paylaşımını veya dosya paylaşımının anlık görüntüsünü temsil eder. Kaynak FileShare , kaynağın FileService alt öğesidir ve sonsuz sayıda dosya paylaşımı içerebilir.

Bir FileService kaynak sonsuz sayıda FileShare kaynak içerebilse de, çok büyük bir sayı kullanmak iyi bir fikir değildir çünkü depolama hesabındaki her şey tanımlı G/Ç, bant genişliği ve diğer sınırlardan oluşan bir havuzu paylaşır. Daha fazla bilgi için bkz. ölçeklenebilirlik ve performans hedefleri Azure Dosyalar.

Kontrol düzlemi API'lerini çağırmayı öğrenmek için bkz:

ve FileShare nesneleri üzerinde FileService işlemler veri düzlemi aracılığıyla da yapılabilir. Bu, Azure Resource Manager Azure Dosyalar predating işleminin bir yapıtıdır. Bu API'ler tam olarak destekleniyor olsa da, çoğu durumda Azure Dosyalar yönetmek için depolama kaynak sağlayıcısı API'lerini kullanmanız gerekir:

  • Azure Resource Manager aracılığıyla kullanıma sunulan işlemler kimlik doğrulaması ve yetkilendirme için Microsoft Entra ID kullanır; böylece rol tabanlı erişim denetimi (RBAC) kullanarak Azure Dosyalar yönetebilirsiniz. Uygulamanızı veya hizmetinizi bir Microsoft Entra hizmet sorumlusuyla bu API'leri program aracılığıyla çağırma yetkisi vekleyebilirsiniz.

  • Azure Resource Manager API'lerini doğrudan REST API aracılığıyla veya bir SDK aracılığıyla zorunlu olarak çağırabilirsiniz. Alternatif olarak, Azure şablonları aracılığıyla dağıtılması gereken kaynakları bildirerek bunları bildirimli olarak çağırabilirsiniz. Birlikte tekrar tekrar oluşturulması gereken kaynaklar için (örneğin, hizmet dağıtımlarında), şablonların kullanılması gereken işi önemli ölçüde basitleştirebilir.

  • Depolama kaynaklarını yönetmek için depolama kaynak sağlayıcısını kullanmanızı öneririz ancak FileREST veri düzlemi yönetim API'lerini kullanmak, yüksek ölçek gerektiren durumlarda size daha iyi performans sağlar. Bu tür bir duruma örnek olarak, aynı depolama hesabı içinde binlerce dosya paylaşımı oluşturan veya değiştiren bir iş yükü gösteriliyor.

    • Microsoft.Storage storageAccounts/fileServices/shares , depolama kaynak sağlayıcısı aracılığıyla bir denetim düzlemi işlemi tetikler.
    • Microsoft.Storage storageAccounts/fileServices/fileshares bir veri düzlemi işlemidir. Depolama Dosyası Verileri SMB Paylaşım Okuyucusu gibi paylaşım düzeyinde rollerin ayarlanması bir veri düzlemi işlemi olmalı ve bu kaynağı kullanmalıdır.

Veri düzlemi

Azure Dosyalar yapılandırılmamış veriler için hiyerarşik bir dosya sistemi sağlar. FileREST API,dosya sistemi alanında iki önemli nesneyi modeller: dosyalar ve dizinler. FileREST API'lerini çağırmayı öğrenmek için bkz:

Ayrıca bkz.