Not
Bu sayfaya erişim yetkilendirme gerektiriyor. Oturum açmayı veya dizinleri değiştirmeyi deneyebilirsiniz.
Bu sayfaya erişim yetkilendirme gerektiriyor. Dizinleri değiştirmeyi deneyebilirsiniz.
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) |
![]() |
Ağ Dosya Sistemi (NFS) |
![]() |
İ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ı, |
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 , Hot ve 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 bilgiler
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