Paylaşım Oluştur
İşlem, Create Share
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şturma'yı kullanmanızı öneririz. Azure Depolama kaynak sağlayıcısını kullanarak kaynaklarla FileShare
program aracılığıyla etkileşim kurma hakkında daha fazla bilgi edinmek için bkz. FileShares İşlemleri.
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ü | Kullanılabilir |
---|---|
Sunucu İleti Bloğu (SMB) | |
Ağ Dosya Sistemi (NFS) |
İstek
İsteği burada gösterildiği gibi oluşturabilirsiniz Create Share
. 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 | Description |
---|---|
myaccount |
Depolama hesabınızın adı. |
myshare |
Dosya paylaşımınızın adı. Ad yalnızca küçük harf 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 |
İsteğe bağlı. 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 |
Gereklidir. Yetkilendirme düzenini, hesap adını ve imzayı belirtir. Daha fazla bilgi için bkz. Azure Depolama isteklerini yetkilendirme. |
Date veya x-ms-date |
Gereklidir. İstek için Eşgüdümlü Evrensel Saat (UTC) saatini belirtir. Daha fazla bilgi için bkz. Azure Depolama isteklerini 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 |
İsteğe bağlı. 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 |
İsteğe bağlı. 2015-02-21 ve sonraki sürümlerde desteklenir. Paylaşımın en büyük boyutunu , gibibayt (GiB) cinsinden belirtir. |
x-ms-access-tier |
İsteğe bağlı. 2019-12-12 ve sonraki sürümlerde desteklenir. Paylaşımın erişim katmanını belirtir. Geçerli değerler , Hot ve Cool değerleridirTransactionOptimized . Dosya paylaşımı katmanları hakkında ayrıntılı bilgi için bkz. Azure Dosyalar depolama katmanları. |
x-ms-enabled-protocols: <SMB \| NFS> |
İsteğe bağlı. 2019-07-07 ve sonraki sürümlerde desteklenir. Paylaşımdaki etkin protokolleri belirtir. Bunlar 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> |
İsteğe bağlı. Yalnızca NFS. 2019-07-07 ve sonraki 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-client-request-id |
İsteğe bağlı. Günlüğe kaydetme yapılandırıldığında günlüklere kaydedilen 1 kibibaytlık (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. İzleme Azure Dosyalar. |
İstek gövdesi
Yok.
Ö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 yanıt üst bilgileri kümesi 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 . Durum 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 HTTP/1.1 protokol belirtimine uygundur.
Yanıt üst bilgisi | Description |
---|---|
ETag |
Paylaşımın sürümünü tırnak içine alınmış olarak temsil eden 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 göredir. 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şlemleriyle ilgili sorunları 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 |
İsteklerin ve karşılık gelen yanıtların sorunlarını 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 üst bilginin değerine x-ms-client-request-id eşittir. x-ms-client-request-id Üst bilgi istekte yoksa yanıtta mevcut değildir. |
Yanıt gövdesi
Yok.
Ö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
Yetkilendirme
Bu işlemi yalnızca hesap sahibi çağırabilir.
Açıklamalar
Paylaşımlar depolama hesabında 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 şeklindedir x-ms-meta-name:value
.
çağrısı Create Share
yaptığı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.
Kotayı değiştirmenin veya ayarlamanın faturalama üzerinde hiçbir etkisi yoktur. Dosyaların boyutu ve ek yük için faturalandırılmanıza rağmen faturalandırılırsınız.