Dosya Hizmeti Özelliklerini Alma

  • Makale

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

Protokol kullanılabilirliği

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

İstek

İstek Get File Service Properties aşağıdaki gibi belirtilebilir. HTTPS kullanmanızı öneririz. değerini depolama hesabınızın adıyla değiştirin <account-name> :

Yöntem İstek URI'si HTTP sürümü
GET 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

Aşağıdaki tabloda gerekli ve isteğe bağlı istek üst bilgileri açıklanmaktadı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'ya istekleri yetkilendirme.
Date veya 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'ya istekleri 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 hizmetinin ölçüm özelliklerini almak 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 Azure Depolama Analizi günlüklerine 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. İzleme Azure Dosyalar.

İstek gövdesi

Yok.

Yanıt

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

Durum kodu

Başarılı bir işlem 200 (Tamam) 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ımlar.
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 İsteklerde ve karşılık gelen yanıtlarda sorun gidermek için kullanılabilir. Bu üst bilginin değeri, istekte varsa 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

Sürüm 2020-02-10 için yanıt 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>

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

Ad Açıklama
HourMetrics Depolama Analizi HourMetrics ayarlarını gruplandırın. Ayarlar, HourMetrics saatlik toplamalar halinde API'ye göre gruplandırılmış istek istatistiklerinin özetini sağlar.
MinuteMetrics Depolama Analizi MinuteMetrics ayarlarını gruplandırın. Ayarlar her MinuteMetrics dakika için istek istatistikleri sağlar.
Version Şu anda kullanımda olan Depolama Analizi sürümü.
Enabled Ölçümlerin Dosya hizmeti için etkinleştirilip etkinleştirilmediğini gösterir.
IncludeAPIs Ölçümlerin çağrılan API işlemleri için özet istatistikleri oluşturup oluşturmadığını gösterir.
RetentionPolicy/Enabled Dosya hizmeti için bir bekletme ilkesinin etkinleştirilip etkinleştirilmediğini gösterir.
RetentionPolicy/Days Ölçüm verilerinin tutıldığı gün sayısını gösterir. Bu değerden daha eski olan tüm veriler en iyi çabayla silinir.
Cors Tüm çıkış noktaları arası kaynak paylaşımı (CORS) kurallarını gruplandırır.
CorsRule CORS kuralı için grup ayarları.
AllowedOrigins CORS aracılığıyla izin verilen kaynak etki alanlarının virgülle ayrılmış listesi veya tüm etki alanlarına izin veriliyorsa "*".
ExposedHeaders CORS istemcilerinin kullanıma sunmasına yönelik yanıt üst bilgilerinin virgülle ayrılmış listesi.
MaxAgeInSeconds İstemcinin veya tarayıcının denetim öncesi yanıtını önbelleğe alması gereken saniye sayısı.
AllowedHeaders Çıkış noktaları arası isteğin parçası olmasına izin verilen üst bilgilerin virgülle ayrılmış listesi.
AllowedMethods 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 DELETE, GET, HEAD, MERGE, POST, OPTIONS ve PUT yöntemleridir.
ShareDeleteRetentionPolicy Bu depolama hesabındaki Azure dosya paylaşımlarının geçici silme özellikleri.
Days Azure dosya paylaşımının saklanacağı gün sayısını gösterir (geçici olarak silinebilir). Belirtilen en düşük değer 1, maksimum değer ise 365 olabilir.
Enabled Depolama hesabında Azure Dosyalar için geçici silme özelliğinin etkinleştirilip etkinleştirilmediğini gösterir.
ProtocolSettings Dosya sistemi protokollerinin ayarlarını gruplar.
SMB Sunucu İleti Bloğu (SMB) ayarlarını gruplandırın.
Multichannel Çok Kanallı SMB ayarlarını içerir. Bu ayarın bir özelliği vardır: enabled/disabled.
Version Sürüm 2020-04-08 itibarıyla kullanılabilir. İzin verilen SMB sürümlerinin virgülle ayrılmış listesi. Olası değerler: SMB2.1, SMB3.0ve SMB3.1.1. Belirtilmezse Version , varsayılan değer tüm sürümlerin etkin olmasıdır. Ancak SMB 2.1 yalnızca depolama hesabının require secure transit özelliği devre dışı bırakıldıysa kullanılabilir çünkü SMB 2.1 şifrelemeyi desteklemez.
AuthenticationMethods Sürüm 2020-04-08 itibarıyla kullanılabilir. İzin verilen kimlik doğrulama yöntemlerinin virgülle ayrılmış listesi. Olası değerler: NTLMv2, Kerberos. Belirtilmezse AuthenticationMethods , varsayılan olarak tüm kimlik doğrulama yöntemlerine izin verilir.
KerberosTicketEncryption Sürüm 2020-04-08 itibarıyla kullanılabilir. İzin verilen Kerberos anahtar şifreleme algoritmalarının virgülle ayrılmış listesi. Olası değerler: RC4-HMAC ve AES-256. Belirtilmezse KerberosTicketEncryption , varsayılan değer tüm Kerberos anahtar şifreleme algoritmalarının desteklendiğidir.
ChannelEncryption Sürüm 2020-04-08 itibarıyla kullanılabilir. İzin verilen SMB kanalı şifreleme protokollerinin virgülle ayrılmış listesi. Olası değerler: AES-128-CCM, AES-128-GCMve AES-256-GCM. Belirtilmezse ChannelEncryption , varsayılan değer tüm kanal şifreleme değerlerinin desteklendiğidir. Depolama hesabının require secure transit özelliği devre dışı bırakılırsa şifrelenmemiş SMB erişimine de izin verilir.

Yetkilendirme

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

Örnek istek ve yanıt

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

Yöntem URL Protokol
GET 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 gönderildikten sonra aşağıdaki yanıt döndürülür:

HTTP/1.1 200 OK  
Content-Length: 1020  
Content-Type: application/xml  
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

Yanıt aşağıdaki XML gövdesini içerir:

<?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>

Açıklamalar

CORS kuralları ve değerlendirme mantığı hakkında ayrıntılı bilgi için bkz. Azure Depolama hizmetleri için CORS desteği.

Daha fazla bilgi için bkz. Depolama Analizi.