Aracılığıyla paylaş


Paylaşım Oluştur

Create Share işlemi, belirtilen hesap altında yeni bir Azure Dosyalar paylaşımı oluşturur. Bu API tam olarak destekleniyor olsa da, bu eski bir yönetim API'sidir. Bunun yerine Azure Depolama kaynak sağlayıcısı (Microsoft.Storage) tarafından sağlanan Dosya Paylaşımları - Oluşturmakullanmanızı öneririz. Azure Depolama kaynak sağlayıcısını kullanarak FileShare kaynaklarıyla program aracılığıyla etkileşim kurma hakkında daha fazla bilgi edinmek için bkz. FileShares'te İşlemler.

Aynı ada sahip bir paylaşım zaten varsa, işlem başarısız olur. Paylaşım kaynağı, bu paylaşımın meta verilerini ve özelliklerini içerir. Paylaşımda yer alan dosyaların listesini içermez.

Protokol kullanılabilirliği

Etkin dosya paylaşımı protokolü Mevcut
Sunucu İleti Bloğu (SMB) Evet
Ağ Dosya Sistemi (NFS) Evet

İstek

burada gösterildiği gibi Create Share isteği oluşturabilirsiniz. HTTPS kullanmanızı öneririz.

Yöntem İstek URI'si HTTP sürümü
PUT https://myaccount.file.core.windows.net/myshare?restype=share HTTP/1.1

İstek URI'sinde gösterilen yol bileşenlerini aşağıdaki gibi kendinizle değiştirin:

Yol bileşeni Açıklama
myaccount Depolama hesabınızın adı.
myshare Dosya paylaşımınızın adı. Ad yalnızca küçük harfli karakterler içerebilir.

Yol adlandırma kısıtlamaları hakkında daha fazla bilgi için bkz. ad ve başvuru paylaşımları, dizinler, dosyalar ve meta veriler.

URI parametreleri

İstek URI'sinde aşağıdaki ek parametreleri belirtebilirsiniz:

Parametre Açıklama
timeout Opsiyonel. Zaman aşımı parametresi saniye cinsinden ifade edilir. Daha fazla bilgi için bkz. Dosya hizmeti işlemleri için zaman aşımlarını ayarlama.

İstek üst bilgileri

Gerekli ve isteğe bağlı istek üst bilgileri aşağıdaki tabloda açıklanmıştır:

İstek üst bilgisi Açıklama
Authorization Gerekli. Yetkilendirme düzenini, hesap adını ve imzayı belirtir. Daha fazla bilgi için bkz. azure depolamaistekleri yetkilendirme .
Date veya x-ms-date Gerekli. İstek için Eşgüdümlü Evrensel Saat (UTC) saatini belirtir. Daha fazla bilgi için bkz. azure depolamaistekleri yetkilendirme .
x-ms-version Tüm yetkili istekler için gereklidir. Bu istek için kullanılacak işlemin sürümünü belirtir. Daha fazla bilgi için bkz. Azure Depolama hizmetleri için sürüm oluşturma.
x-ms-meta-name:value Opsiyonel. Paylaşımla meta veri olarak ilişkilendirilecek bir ad-değer çifti.

Meta veri adları,C# tanımlayıcıları için adlandırma kurallarına uymalıdır.
x-ms-share-quota Opsiyonel. 2015-02-21 ve sonraki sürümlerde desteklenir. Paylaşımın en büyük boyutunu ( gibibaytlar (GiB) cinsinden belirtir.
x-ms-access-tier Opsiyonel. 2019-12-12 ve sonraki sürümlerde desteklenir. Paylaşımın erişim katmanını belirtir. Geçerli değerler TransactionOptimized, Hotve Cool. Dosya paylaşımı katmanları hakkında ayrıntılı bilgi için bkz.Azure Dosyalar depolama katmanlarını .
x-ms-enabled-protocols: <SMB \| NFS> Opsiyonel. Sürüm 2019-07-07 ve üzeri sürümlerde desteklenir. Paylaşımdaki etkin protokolleri belirtir. Belirtilmezse, varsayılan değer SMB'dir.

- SMB: Paylaşıma SMBv3.0, SMBv2.1 ve REST tarafından erişilebilir.
- NFS: Paylaşıma NFSv4.1 tarafından erişilebilir. Bu seçenek için bir premium hesap gereklidir.
x-ms-root-squash: <NoRootSquash \| RootSquash \| AllSquash> Opsiyonel. Yalnızca NFS. Sürüm 2019-07-07 ve üzeri sürümlerde desteklenir. NFS etkinleştirildiğinde paylaşımdaki kök sıkıştırma davranışını belirtir. Belirtilmezse, varsayılan değer NoRootSquash'tir.

- NoRootSquash: Kök sıkıştırmayı kapatın.
- RootSquash: uid/gid 0'dan gelen istekleri anonim uid/gid ile eşleyin.
- AllSquash: Tüm uid'leri ve gid'leri anonim kullanıcıyla eşleyin.
x-ms-enable-snapshot-virtual-directory-access: <true \| false> Opsiyonel. Sürüm 2024-08-04 ve sonraki sürümlerde desteklenir. NFS etkinleştirildiğinde paylaşım bağlama noktasının kökünde anlık görüntü sanal dizinine erişilip erişilemeyeceğini belirtir. Belirtilmezse, varsayılan değer true olur.
x-ms-client-request-id Opsiyonel. Günlüğe kaydetme yapılandırıldığında günlüklere kaydedilen 1 kibibayt (KiB) karakter sınırıyla istemci tarafından oluşturulan, opak bir değer sağlar. İstemci tarafı etkinlikleriyle sunucunun aldığı istekler arasında bağıntı sağlamak için bu üst bilgiyi kullanmanızı kesinlikle öneririz. Daha fazla bilgi için bkz. azure dosyalarıizleme .
x-ms-share-paid-bursting-enabled: <true \| false> Opsiyonel. 2024-11-04 ve sonraki sürümlerde desteklenir. Yalnızca premium dosya paylaşımları için izin verilir (FileStorage depolama hesabı türündeki dosya paylaşımları). Bu özellik ücretli seri artışa olanak tanır. Özellik belirtilmezse, varsayılan değer false olur.
x-ms-share-paid-bursting-max-iops Opsiyonel. 2024-11-04 ve sonraki sürümlerde desteklenir. Yalnızca premium dosya paylaşımları için izin verilir. Paylaşım için izin verilen saniyede en fazla ücretli seri giriş/çıkış işlemini (IOPS) temsil eden bir tamsayı. Belirtilmezse varsayılan değer, bir paylaşım için izin verilen en yüksek IOPS'dir. Bu üst bilgi ayarlandıysa, x-ms-share-paid-bursting-enabled de true olarak ayarlanmalıdır.
x-ms-share-paid-bursting-max-bandwidth-mibps Opsiyonel. 2024-11-04 ve sonraki sürümlerde desteklenir. Yalnızca premium dosya paylaşımları için izin verilir. Paylaşım için izin verilen maksimum ücretli mebibayt/saniye (MiB/sn) sayısını gösteren tamsayı. Belirtilmezse varsayılan değer, bir paylaşım için izin verilen en yüksek MiB/sn değeridir. Bu üst bilgi ayarlandıysa, x-ms-share-paid-bursting-enabled de true olarak ayarlanmalıdır.

İstek gövdesi

Hiç kimse.

Örnek istek

PUT https://myaccount.file.core.windows.net/myshare?restype=share HTTP/1.1  
  
Request Headers:  
x-ms-version: 2020-02-10  
x-ms-date: <date>  
x-ms-meta-Name: StorageSample  
x-ms-enabled-protocols: NFS
x-ms-root-squash: RootSquash
Authorization: SharedKey myaccount:Z5043vY9MesKNh0PNtksNc9nbXSSqGHueE00JdjidOQ=  

Yanıt

Yanıt bir HTTP durum kodu ve bir dizi yanıt üst bilgisi içerir.

Durum kodu

Başarılı bir işlem 201 (Oluşturuldu) durum kodunu döndürür.

Daha fazla bilgi için bkz. Durumu ve hata kodları.

Yanıt üst bilgileri

Bu işlemin yanıtı aşağıdaki üst bilgileri içerir. Yanıt, ek standart HTTP üst bilgileri de içerebilir. Tüm standart üst bilgilerHTTP/1.1 protokol belirtimine uygundur.

Yanıt üst bilgisi Açıklama
ETag Paylaşımın sürümünü temsil eden, tırnak içine alınmış bir değer içerir.
Last-Modified Paylaşımın en son değiştirildiği tarihi ve saati döndürür. Tarih biçimi RFC 1123'e uyar. Daha fazla bilgi için bkz. üst bilgilerde tarih/saat değerlerini temsil edin.

Paylaşımı veya özelliklerini veya meta verilerini değiştiren tüm işlemler son değiştirme zamanını güncelleştirir. Dosyalardaki işlemler paylaşımın son değiştirme zamanını etkilemez.
x-ms-request-id İsteği benzersiz olarak tanımlar ve isteğin sorunlarını gidermek için bunu kullanabilirsiniz. Daha fazla bilgi için bkz. API işlem sorunlarını giderme
x-ms-version İsteği yürütmek için kullanılan Azure Dosyalar sürümünü gösterir.
Date Hizmet tarafından oluşturulan ve yanıtın başlatıldığı saati gösteren UTC tarih/saat değeri.
x-ms-client-request-id İsteklerde ve ilgili yanıtlarda sorun gidermek için kullanılabilir. bu üst bilginin değeri, istekte mevcutsa ve değer 1.024'ten fazla görünür ASCII karakteri içermiyorsa x-ms-client-request-id üst bilgisinin değerine eşittir. İstekte x-ms-client-request-id üst bilgisi yoksa yanıtta bulunmaz.

Yanıt gövdesi

Hiç kimse.

Örnek yanıt

Response Status:  
HTTP/1.1 201 Created  
  
Response Headers:  
Transfer-Encoding: chunked  
Date: <date>  
ETag: "0x8CB14C3E29B7E82"  
Last-Modified: <date>  
x-ms-version: 2020-02-10  
Server: Windows-Azure-File/1.0 Microsoft-HTTPAPI/2.0  

İzin

Bu işlemi yalnızca hesap sahibi çağırabilir.

Açıklamalar

Paylaşımlar depolama hesabı içinde hemen oluşturulur. Bir paylaşımı başka bir paylaşımın içine yerleştirmek mümkün değildir.

Bir paylaşımı oluştururken istekte bir veya daha fazla meta veri üst bilgisi ekleyerek meta verileri belirtebilirsiniz. Meta veri üst bilgisinin biçimi x-ms-meta-name:value.

Create Shareçağırdığınızda aynı ada sahip bir paylaşım siliniyorsa, sunucu 409 (Çakışma) durum kodunu döndürür ve ek hata bilgileri paylaşımın silindiğini gösterir.

Paylaşımda depolanan dosyaların boyutunu sınırlamak için paylaşım boyutu kotasını kullanabilirsiniz. Kota anlık görüntülerin boyutunu sınırlamaz. Dosyalarla ilişkili olan ve depolama hesabının faturalama boyutunu hesaplamak için kullanılan ek yük kotada hesaba bağlanmaz.

Paylaşımdaki dosyaların boyutlarının toplamı paylaşımda ayarlanan kotayı aştığında, dosyanın boyutunu artırma girişimleri başarısız olur ve yeni boş olmayan dosyalar oluşturma (REST aracılığıyla) başarısız olur. Yine de boş dosyalar oluşturabilirsiniz.

Kotanın değiştirilmesi veya ayarlanması faturalamayı etkilemez. Dosyaların boyutu ve ek yük için faturalandırılırsınız.

Ayrıca bkz.

Azure Dosyalar paylaşımlarında İşlemleri