Dosya Hizmeti Özelliklerini Alma

İş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 kaynağı 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ü Mevcut
Küçük ve Orta Büyüklükteki İşletme (SMB) Evet
Ağ Dosya Sistemi (NFS) Evet

İ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 İstenilen URI HTTP sürümü
AL https://<account-name>.file.core.windows.net/?restype=service&comp=properties HTTP/1.1

Uyarı

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 bölümü boş olur.

URI parametreleri

URI parametresi Açıklama
restype=service&comp=properties Gerekli. Depolama hizmeti özelliklerini ayarlamak için her iki sorgu dizesinin birleşimi gerekir.
timeout Opsiyonel. timeout parametresi saniye cinsinden ifade edilir. Daha fazla bilgi için bkz. Dosya hizmeti işlemleri için zaman aşımlarını ayarlama.

İstek başlıkları

Aşağıdaki tabloda gerekli ve isteğe bağlı istek üst bilgileri açıklanmaktadır.

İstek başlığı Açıklama
Authorization Gerekli. Yetkilendirme düzenini, depolama hesabı 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 Saati (UTC) 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. 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 Opsiyonel. 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 içeriği

Yok.

Yanıt

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

Durum kodu

Başarılı bir işlem 200 durum kodunu döndürür (Tamam).

Yanıt başlıkları

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
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 İstekleri ve ilgili yanıtları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 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ın içeriği

2026-02-06 sürümü için yanıt gövdesinin formatı şu şekildedir:

<?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-separated-list-of-response-headers</ExposedHeaders>  
            <AllowedHeaders>comma-separated-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>semicolon-separated-list-of-smb-versions</Versions>
            <AuthenticationMethods>semicolon-separated-list-of-auth-methods</AuthenticationMethod>
            <KerberosTicketEncryption>semicolon-separated-list-of-kerberos-encryption-algorithms</KerberosTicketEncryption>
            <ChannelEncryption>semicolon-separated-list-of-smb-channel-encryption-algorithms</ChannelEncryption>
            <EncryptionInTransit>
                <Required>true|false</Required>
            </EncryptionInTransit>
        </SMB>
        <NFS>
            <EncryptionInTransit>
                <Required>true|false</Required>
            </EncryptionInTransit>
        </NFS>
    </ProtocolSettings>
</StorageServiceProperties>

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

İsim Açıklama
HourMetrics Depolama Analizi ayarlarını gruplandırın HourMetrics . Ayarlar, HourMetrics saatlik toplamalarda API'ye göre gruplandırılmış istek istatistiklerinin özetini sağlar.
MinuteMetrics Depolama Analizi ayarlarını gruplandırın MinuteMetrics . Ayarlar MinuteMetrics her 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 çaba temelinde 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 çıkış noktası 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 saklanması gereken gün sayısını gösterir (geçici olarak silinir). Belirtilen en düşük değer 1, maksimum değer ise 365 olabilir.
Enabled Depolama hesabının 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: etkin/devre dışı.
Versions 2020-04-08 sürümünden itibaren kullanılabilir. İzin verilen SMB sürümlerinin noktalı 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 2020-04-08 sürümünden itibaren kullanılabilir. İzin verilen kimlik doğrulama yöntemlerinin noktalı 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 2020-04-08 sürümünden itibaren kullanılabilir. İzin verilen Kerberos anahtarı şifreleme algoritmalarının noktalı 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 2020-04-08 sürümünden itibaren kullanılabilir. İzin verilen SMB kanalı şifreleme algoritmalarının noktalı 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.
NFS 2026-02-06 sürümü itibarıyla mevcut. NFS için ayarları gruplar.
EncryptionInTransit 2026-02-06 sürümü itibarıyla mevcut. Geçiş sırasında SMB & NFS şifrelemesi, geçiş sırasında SMB & NFS şifreleme gereksinimini gösteren Boolean özelliğini içerir Required . Geçiş sırasında NFS şifreleme yalnızca premium depolama hesapları için mevcuttur.

İzin

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
AL https://myaccount.file.core.windows.net/?restype=service&comp=properties HTTP/1.1

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

x-ms-version: 2026-02-06  
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: 2026-02-06

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>
            <EncryptionInTransit>
                <Required>true</Required>
            </EncryptionInTransit>
        </SMB>
        <NFS>
            <EncryptionInTransit>
                <Required>true</Required>
            </EncryptionInTransit>
        </NFS>
    </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.

  • Last updated on