Aracılığıyla paylaş

Dosya Hizmeti Özelliklerini Ayarlama

  • Makale

İşlem, Set File Service Properties FileREST API'sini kullanarak Dosya hizmeti kaynağının özelliklerini ayarlar. Bu API tam olarak destekleniyor olsa da eski bir yönetim API'sidir. Bunun yerine, Azure Depolama kaynak sağlayıcısı (Microsoft.Storage) tarafından sağlanan Dosya Hizmetleri - Hizmet Özelliklerini Ayarla'yı kullanmanızı öneririz. Azure Depolama kaynak sağlayıcısını kullanarak Dosya hizmeti kaynağıyla program aracılığıyla etkileşim kurma hakkında daha fazla bilgi edinmek için bkz. Dosya hizmetindeki işlemler.

Protokol kullanılabilirliği

Etkin dosya paylaşımı protokolü Kullanılabilir
SMB Evet
NFS Yes

İstek

İsteği aşağıdaki gibi belirtebilirsiniz Set File Service Properties . HTTPS kullanmanızı öneririz. account-name değerini depolama hesabınızın adıyla değiştirin:

Yöntem İstek URI'si HTTP sürümü
PUT https://account-name.file.core.windows.net/?restype=service&comp=properties HTTP/1.1

Not

Ana bilgisayar adını URI'nin yolundan ve sorgu bölümlerinden ayırmak için URI her zaman bir eğik çizgi karakteri (/) içermelidir. Bu işlemde, URI'nin yol kısmı boş.

URI parametreleri

URI parametresi Description
restype=service&comp=properties Gereklidir. Depolama hizmeti özelliklerini ayarlamak için her iki sorgu dizesinin birleşimi gerekir.
timeout İsteğe bağlı. timeout 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, depolama hesabı adını ve imzayı belirtir. Daha fazla bilgi için bkz. Azure Depolama isteklerini yetkilendirme.
Date or x-ms-date Gereklidir. İstek için Eşgüdümlü Evrensel Saat (UTC) biçimini 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. Bu işlem yalnızca 2015-02-21 ve sonraki sürümlerde kullanılabilir. Dosya hizmeti ölçümlerini etkinleştirmek için 2015-04-05 veya sonraki bir sürümü belirtmeniz gerekir.

Daha fazla bilgi için bkz. Azure Depolama hizmetleri için sürüm oluşturma.
x-ms-client-request-id İsteğe bağlı. Günlüğe kaydetme yapılandırıldığında Depolama Analizi günlüklerine kaydedilen 1 kibibayt (KiB) karakter sınırına sahip 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

Sürüm 2020-02-10 için istek gövdesinin biçimi aşağıdaki gibidir:

<?xml version="1.0" encoding="utf-8"?>  
<StorageServiceProperties>  
    <HourMetrics>  
        <Version>version-number</Version>  
        <Enabled>true|false</Enabled>  
        <IncludeAPIs>true|false</IncludeAPIs>  
        <RetentionPolicy>  
            <Enabled>true|false</Enabled>  
            <Days>number-of-days</Days>  
        </RetentionPolicy>  
    </HourMetrics>  
    <MinuteMetrics>  
        <Version>version-number</Version>  
        <Enabled>true|false</Enabled>  
        <IncludeAPIs>true|false</IncludeAPIs>  
        <RetentionPolicy>  
            <Enabled>true|false</Enabled>  
            <Days>number-of-days</Days>  
        </RetentionPolicy>  
    </MinuteMetrics>  
    <Cors>  
        <CorsRule>  
            <AllowedOrigins>comma-separated-list-of-allowed-origins</AllowedOrigins>  
            <AllowedMethods>comma-separated-list-of-HTTP-verb</AllowedMethods>  
            <MaxAgeInSeconds>max-caching-age-in-seconds</MaxAgeInSeconds>  
            <ExposedHeaders>comma-seperated-list-of-response-headers</ExposedHeaders>  
            <AllowedHeaders>comma-seperated-list-of-request-headers</AllowedHeaders>  
        </CorsRule>  
    </Cors>    
    <ShareDeleteRetentionPolicy>
        <Enabled>true|false</Enabled>
        <Days>integer-value</Days>
    </ShareDeleteRetentionPolicy>
    <ProtocolSettings>
        <SMB>
            <Multichannel>
                <Enabled>true|false</Enabled>
            </Multichannel>
            <Versions>comma-separated-list-of-smb-versions</Versions>
            <AuthenticationMethods>comma-separated-list-of-auth-methods</AuthenticationMethod>
            <KerberosTicketEncryption>csv-of-kerb-encryption-algorithms</KerberosTicketEncryption>
            <ChannelEncryption>csv-of-smb-encryption-algorithms</ChannelEncryption>
        </SMB>
    </ProtocolSettings>
</StorageServiceProperties>

İstekte her kök öğenin belirtilmesi gerekmez. Bir kök öğeyi atlarsanız, bu işlev için hizmetin mevcut ayarları korunur. Ancak, belirli bir kök öğe belirtirseniz, bu öğe için her alt öğeyi belirtmeniz gerekir. Kök öğeler şunlardır:

  • HourMetrics
  • MinuteMetrics
  • Cors
  • ProtocolSettings

İstek gövdesinin öğeleri aşağıdaki tabloda açıklanmıştır:

Ad Açıklama
HourMetrics 2015-04-05 ve üzeri sürümler için isteğe bağlı. Önceki sürümler için geçerli değildir. saatlik toplamalarda API'ye göre gruplandırılmış istek istatistiklerinin özetini sağlayan Depolama Analizi HourMetrics ayarlarını gruplandırın.
MinuteMetrics 2015-04-05 ve üzeri sürümler için isteğe bağlı. Önceki sürümler için geçerli değildir. Her dakika için istek istatistikleri sağlayan Depolama Analizi MinuteMetrics ayarlarını gruplandırın.
Version Ölçümler etkinleştirildiyse gereklidir. Yapılandırılan Depolama Analizi sürümü. Bu değer için kullanın 1.0 .
Enabled Gereklidir. Ölçümlerin Dosya hizmeti için etkinleştirilip etkinleştirilmediğini gösterir.
IncludeAPIs Yalnızca ölçümler etkinleştirildiğinde gereklidir. Ölçümlerin çağrılan API işlemleri için özet istatistikleri oluşturup oluşturmayacağını gösterir.
RetentionPolicy/Enabled Gereklidir. Dosya hizmeti için bir bekletme ilkesinin etkinleştirilip etkinleştirilmediğini gösterir. False ise ölçüm verileri korunur ve silme işlemi kullanıcının sorumluluğundadır.
RetentionPolicy/Days Yalnızca bekletme ilkesi etkinleştirildiğinde gereklidir. Ölçüm verilerinin saklanması gereken gün sayısını gösterir. Bu değerden daha eski olan tüm veriler silinir. Belirtebileceğiniz en düşük değer , 1maksimum değer ise (bir yıl) olur 365 . Ölçüm verileri, saklama süresi sona erdikten sonra en iyi çaba temelinde silinir.
Cors İsteğe bağlı. Cors öğesi sürüm 2015-02-21 ve üzeri için desteklenir. Tüm çıkış noktaları arası kaynak paylaşımı (CORS) kurallarını gruplandırır. Bu öğe grubunun atlanması mevcut CORS ayarlarının üzerine yazılmıyor.
CorsRule İsteğe bağlı. Dosya hizmeti için bir CORS kuralı belirtir. İsteğe en çok beş CorsRule öğesi ekleyebilirsiniz. İstek gövdesine öğe CorsRule eklenmezse, tüm CORS kuralları silinir ve Dosya hizmeti için CORS devre dışı bırakılır.
AllowedOrigins Öğe varsa CorsRule gereklidir. CORS aracılığıyla izin verilen çıkış noktası etki alanlarının virgülle ayrılmış listesi veya tüm etki alanlarına izin vermek için "*". Bir kaynak etki alanı, bir etki alanının tüm alt etki alanları için CORS aracılığıyla isteklere izin vermek için alt etki alanına joker karakter de içerebilir. 64 kaynak etki alanıyla sınırlıdır. İzin verilen her kaynağın en fazla 256 karakteri olabilir.
ExposedHeaders Öğe varsa CorsRule gereklidir. CORS istemcilerine kullanıma sunma amacıyla yanıt üst bilgilerinin virgülle ayrılmış listesi. 64 tanımlı üst bilgi ve iki ön ekli üst bilgi ile sınırlıdır. Her üst bilgi en fazla 256 karakter içerebilir.
MaxAgeInSeconds Öğe varsa CorsRule gereklidir. İstemcinin/tarayıcının denetim öncesi yanıtı önbelleğe alması gereken saniye sayısı.
AllowedHeaders Öğesi varsa CorsRule gereklidir. Çıkış noktaları arası isteğin parçası olmasına izin verilen üst bilgilerin virgülle ayrılmış listesi. 64 tanımlı üst bilgi ve 2 ön ekli üst bilgi ile sınırlıdır. Her üst bilgi en fazla 256 karakter içerebilir.
AllowedMethods Öğe varsa CorsRule gereklidir. Kaynak tarafından yürütülmesine izin verilen HTTP yöntemlerinin virgülle ayrılmış listesi. Azure Dosyalar için izin verilen yöntemler , , GET, HEAD, MERGE, POST, OPTIONSve PUTyöntemleridirDELETE.
ShareDeleteRetentionPolicy İsteğe bağlı. Bu depolama hesabındaki Azure dosya paylaşımları için geçici silme özellikleri.
Days İsteğe bağlı. Azure dosya paylaşımının tutulacağı gün sayısını gösterir (geçici olarak silinir). Belirtebileceğiniz en düşük değer , 1maksimum değer ise (bir yıl) olur 365 .
Enabled İsteğe bağlı. Depolama hesabının Azure Dosyalar için geçici silme özelliğinin etkinleştirilip etkinleştirilmediğini gösterir.
ProtocolSettings İsteğe bağlı. Dosya sistemi protokollerinin ayarlarını gruplandırın.
SMB İsteğe bağlı. SMB ayarlarını gruplandırın.
Multichannel İsteğe bağlı. Çok kanallı SMB ayarlarını içerir. Çok kanallı SMB, çok kanallı SMB durumunun geçişini yapan Boole özelliğini içerir Enabled .
Version 2020-04-08 sürümünden itibaren isteğe bağlı. İzin verilen SMB sürümlerinin virgülle ayrılmış listesi. İzin verilen değerler , SMB3.0ve SMB3.1.1değerleridirSMB2.1.
AuthenticationMethods 2020-04-08 sürümünden itibaren isteğe bağlı. İzin verilen kimlik doğrulama yöntemlerinin virgülle ayrılmış listesi. İzin verilen değerler ve KerberosdeğerleridirNTLMv2.
KerberosTicketEncryption 2020-04-08 sürümünden itibaren isteğe bağlı. İzin verilen Kerberos anahtarı şifreleme algoritmalarının virgülle ayrılmış listesi. İzin verilen değerler ve AES-256değerleridirRC4-HMAC.
ChannelEncryption 2020-04-08 sürümünden itibaren isteğe bağlı. İzin verilen SMB kanalı şifreleme protokollerinin virgülle ayrılmış listesi. İzin verilen değerler , AES-128-GCMve AES-256-GCMdeğerleridirAES-128-CCM.

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 202 (Kabul Edildi) durum kodunu döndürür.

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
x-ms-request-id Hizmette yapılan bir isteği benzersiz olarak tanımlayan bir değer.
x-ms-version Yanıt için kullanılan 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-client-request-id İsteklerin ve karşılık gelen yanıtların sorunlarını gidermek için kullanılabilir. Ü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 bulunmaz.

Yanıt gövdesi

Yok.

Yetkilendirme

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

Açıklamalar

Azure Dosyalar'daki CORS kuralları için aşağıdaki kısıtlamalar ve sınırlamalar geçerlidir:

  • En fazla beş kural depolanabilir.

  • XML etiketleri hariç, istek üzerindeki tüm CORS kuralları ayarlarının boyut üst sınırı 2 KiB'ı aşmamalıdır.

  • İzin verilen üst bilgi, kullanıma sunulan üst bilgi veya izin verilen kaynağın uzunluğu 256 karakteri aşmamalıdır.

  • İzin verilen üst bilgiler ve kullanıma sunulan üst bilgiler aşağıdakilerden biri olabilir:

    • Tam üst bilgi adının sağlandığı değişmez başlıklar, örneğin x-ms-meta-processed. İstekte en fazla 64 değişmez değer üst bilgisi belirtilebilir.

    • Üst bilgi ön ekinin sağlandığı önekli üst bilgiler, örneğin x-ms-meta-data*. Bu şekilde bir ön ek belirtmek, bu ön ekle başlayan üst bilgileri kullanıma sunar veya sağlar. İstekte en fazla iki ön ekli üst bilgi belirtilebilir.

  • öğesinde AllowedMethods belirtilen yöntemler (veya HTTP fiilleri), Azure depolama hizmeti API'leri tarafından desteklenen yöntemlere uygun olmalıdır. Desteklenen yöntemler : DELETE, GET, HEAD, MERGE, POST, OPTIONSve PUT.

İstekte CORS kurallarının belirtilmesi isteğe bağlıdır. İstek gövdesinde CORS öğesini belirtmeden çağırırsanız Set File Service Properties , mevcut CORS kuralları korunur.

CORS'yi devre dışı bırakmak için boş bir CORS kuralları ayarıyla (yani) </Cors>ve iç CORS kuralları olmadan çağrısında Set File Service Properties bulunma. Bu çağrı mevcut kuralları siler ve Dosya hizmeti için CORS'yi devre dışı bırakır.

Öğe belirtilirse CorsRule tüm CORS kural öğeleri gereklidir. Herhangi bir öğe eksikse istek 400 (Hatalı İstek) hata koduyla başarısız olur.

CORS kuralları ve değerlendirme mantığı hakkında daha fazla bilgi için bkz. Azure Depolama hizmetleri için çıkış noktaları arası kaynak paylaşımı desteği.

Örnek istek ve yanıt

Aşağıdaki örnek URI , myaccount adlı bir depolama hesabının Dosya hizmeti özelliklerini değiştirme isteğinde bulunur:

PUT https://myaccount.file.core.windows.net/?restype=service&comp=properties HTTP/1.1

İstek aşağıdaki üst bilgilerle gönderilir:

x-ms-version: 2020-02-10  
x-ms-date: <date>  
Authorization: SharedKey myaccount:Z1lTLDwtq5o1UYQluucdsXk6/iB7YxEu0m6VofAEkUE=  
Host: myaccount.file.core.windows.net

İstek aşağıdaki XML gövdesiyle gönderilir:

<?xml version="1.0" encoding="utf-8"?>  
<StorageServiceProperties>  
    <HourMetrics>  
        <Version>1.0</Version>  
        <Enabled>true</Enabled>  
        <IncludeAPIs>false</IncludeAPIs>  
        <RetentionPolicy>  
            <Enabled>true</Enabled>  
            <Days>7</Days>  
        </RetentionPolicy>  
    </HourMetrics>  
    <MinuteMetrics>  
        <Version>1.0</Version>  
        <Enabled>true</Enabled>  
        <IncludeAPIs>true</IncludeAPIs>  
        <RetentionPolicy>  
            <Enabled>true</Enabled>  
            <Days>7</Days>  
        </RetentionPolicy>  
    </MinuteMetrics>  
    <Cors>  
        <CorsRule>  
            <AllowedOrigins>http://www.fabrikam.com,http://www.contoso.com</AllowedOrigins>  
            <AllowedMethods>GET,PUT</AllowedMethods>  
            <MaxAgeInSeconds>500</MaxAgeInSeconds>  
            <ExposedHeaders>x-ms-meta-data*,x-ms-meta-customheader</ExposedHeaders>  
            <AllowedHeaders>x-ms-meta-target*,x-ms-meta-customheader</AllowedHeaders>  
        </CorsRule>  
    </Cors>
    <ShareDeleteRetentionPolicy>
        <Enabled>true</Enabled>
        <Days>7</Days>
    </ShareDeleteRetentionPolicy>
    <ProtocolSettings>
        <SMB>
            <Multichannel>
                <Enabled>true</Enabled>
            </Multichannel>
            <Versions>SMB3.1.1</Versions>
            <AuthenticationMethods>Kerberos</AuthenticationMethods>
            <KerberosTicketEncryption>AES-256</KerberosTicketEncryption>
            <ChannelEncryption>AES-256-GCM</ChannelEncryption>
        </SMB>
    </ProtocolSettings>
</StorageServiceProperties>

İstek gönderildikten sonra aşağıdaki yanıt döndürülür:

HTTP/1.1 202 Accepted  
Connection: Keep-Alive  
Transfer-Encoding: chunked  
Date: <date>  
Server: Windows-Azure-File/1.0 Microsoft-HTTPAPI/2.0  
x-ms-request-id: cb939a31-0cc6-49bb-9fe5-3327691f2a30  
x-ms-version: 2015-04-05

Ayrıca bkz.

CORS kuralları ve değerlendirme mantığı hakkında daha fazla bilgi için bkz. Azure Depolama hizmetleri için çıkış noktaları arası kaynak paylaşımı desteği.

Depolama Analizi hakkında daha fazla bilgi için bkz. Depolama Analizi.