Sdílet prostřednictvím

Nastavení vlastností souborové služby

Operace Set File Service Properties nastaví vlastnosti prostředku souborové služby pomocí rozhraní FileREST API. I když je toto rozhraní API plně podporované, jedná se o starší rozhraní API pro správu. Doporučujeme místo toho použít Souborové služby – Nastavit vlastnosti služby, které poskytuje poskytovatel prostředků Azure Storage (Microsoft.Storage). Další informace o programové interakci s prostředkem souborové služby pomocí poskytovatele prostředků Azure Storage najdete v tématu Operace se službou File Service.

Dostupnost protokolu

Povolený protokol sdílené složky K dispozici
protokol SMB Ano
NFS Ano

Žádost

Požadavek můžete zadat Set File Service Properties následujícím způsobem. Doporučujeme používat PROTOKOL HTTPS. Nahraďte název účtu názvem vašeho účtu úložiště:

Metoda Požadavek na URI Verze protokolu HTTP
VLOŽIT https://account-name.file.core.windows.net/?restype=service&comp=properties HTTP/1.1

Poznámka:

Identifikátor URI musí vždy obsahovat znak lomítka (/), aby se název hostitele oddělil od cesty a části dotazu identifikátoru URI. V této operaci je část cesty identifikátoru URI prázdná.

Parametry identifikátoru URI

Parametr identifikátoru URI Popis
restype=service&comp=properties Povinné. Ke nastavení vlastností služby úložiště se vyžaduje kombinace obou řetězců dotazu.
timeout Volitelný. Parametr timeout se vyjadřuje v sekundách. Další informace najdete v tématu Nastavení časových limitů pro operace souborové služby.

Hlavičky žádosti

Povinná a volitelná hlavička požadavku jsou popsána v následující tabulce:

Hlavička požadavku Popis
Authorization Povinné. Určuje schéma autorizace, název účtu úložiště a podpis. Další informace najdete v tématu Autorizace požadavků na službu Azure Storage.
Date or x-ms-date Povinné. Určuje standard UTC (Coordinated Universal Time) pro požadavek. Další informace najdete v tématu Autorizace požadavků na službu Azure Storage.
x-ms-version Vyžaduje se pro všechny autorizované žádosti. Určuje verzi operace, která se má pro tento požadavek použít. Tato operace je dostupná pouze ve verzi 2015-02-21 a novější. Pokud chcete povolit metriky pro souborovou službu, musíte zadat verzi 2015-04-05 nebo novější.

Další informace najdete v tématu Správa verzí pro služby Azure Storage.
x-ms-client-request-id Volitelný. Poskytuje klientem vygenerovanou neprůhlenou hodnotu s limitem znaků 1 kibibajtů (KiB), který je zaznamenán v protokolech Analýzy úložiště při konfiguraci protokolování. Důrazně doporučujeme použít tuto hlavičku ke korelaci aktivit na straně klienta s požadavky, které server přijímá. Další informace najdete v tématu Monitorování služby Azure Files.

Obsah požadavku

Formát těla žádosti pro verzi 2026-02-06 je následující:

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

Není nutné zadat každý kořenový prvek v požadavku. Pokud vynecháte kořenový prvek, zachovají se stávající nastavení služby pro tuto funkci. Pokud však zadáte určitý kořenový prvek, je nutné zadat každý podřízený prvek pro tento prvek. Mezi kořenové prvky patří:

  • HourMetrics
  • MinuteMetrics
  • Cors
  • ProtocolSettings

Prvky textu požadavku jsou popsány v následující tabulce:

Název Popis
HourMetrics Volitelné pro verzi 2015-04-05 a novější. Neplatí pro starší verze. Seskupí nastavení Analýzy HourMetrics úložiště, která poskytují souhrn statistik požadavků seskupených podle rozhraní API v hodinových agregacích.
MinuteMetrics Volitelné pro verzi 2015-04-05 a novější. Neplatí pro starší verze. Seskupí nastavení Analýzy MinuteMetrics úložiště, která poskytují statistiky žádostí za každou minutu.
Version Vyžaduje se, pokud jsou povoleny metriky. Verze Analýzy úložiště, která se má nakonfigurovat. Použije 1.0 se pro tuto hodnotu.
Enabled Povinné. Určuje, jestli jsou pro souborovou službu povoleny metriky.
IncludeAPIs Vyžadováno pouze v případě, že jsou povoleny metriky. Určuje, jestli metriky mají generovat souhrnné statistiky pro operace rozhraní API.
RetentionPolicy/Enabled Povinné. Určuje, jestli je pro službu File povolená zásada uchovávání informací. Pokud je hodnota false, data metrik se zachovají a uživatel je zodpovědný za jejich odstranění.
RetentionPolicy/Days Vyžaduje se jenom v případě, že je povolená zásada uchovávání informací. Určuje počet dnů, po které se mají uchovávat data metrik. Všechna data starší než tato hodnota se odstraní. Minimální hodnota, kterou můžete zadat, je 1a maximální hodnota je 365 (jeden rok). Data metrik se po vypršení doby uchovávání odstraní na základě maximálního úsilí.
Cors Volitelný. Element Cors je podporován pro verzi 2015-02-21 a novější. Seskupí všechna pravidla sdílení prostředků mezi zdroji (CORS). Vynechání této skupiny prvků nepřepíše stávající nastavení CORS.
CorsRule Volitelný. Určuje pravidlo CORS pro souborovou službu. Do požadavku můžete zahrnout až pět CorsRule prvků. Pokud do textu požadavku nejsou zahrnuty žádné CorsRule prvky, odstraní se všechna pravidla CORS a CORS je pro souborovou službu zakázaná.
AllowedOrigins Vyžaduje se, CorsRule pokud je prvek k dispozici. Seznam domén původu oddělených čárkami, které jsou povolené prostřednictvím CORS, nebo *, aby umožňovaly všechny domény. Doména původu může také obsahovat zástupný znak v subdoméně, který umožňuje žádosti prostřednictvím CORS pro všechny subdomény domény. Omezeno na 64 původních domén. Každý povolený původ může mít až 256 znaků.
ExposedHeaders Vyžaduje se, CorsRule pokud je prvek k dispozici. Čárkami oddělený seznam hlaviček odpovědí, které se zpřístupňují klientům CORS. Omezeno na 64 definovaných hlaviček a dvě předpony hlaviček. Každé záhlaví může obsahovat až 256 znaků.
MaxAgeInSeconds Vyžaduje se, CorsRule pokud je prvek k dispozici. Počet sekund, po které má klient nebo prohlížeč ukládat předběžnou odpověď do mezipaměti.
AllowedHeaders Vyžaduje se, CorsRule pokud prvek existuje. Čárkami oddělený seznam hlaviček, které mohou být součástí žádosti mezi zdroji. Omezeno na 64 definovaných hlaviček a 2 předpony hlaviček. Každé záhlaví může obsahovat až 256 znaků.
AllowedMethods Vyžaduje se, pokud CorsRule existuje prvek. Seznam metod HTTP oddělených čárkami, které mohou být spuštěny původem. Pro Soubory Azure jsou DELETEpovolené metody , , GET, HEADMERGE, POST, , OPTIONS, a PUT.
ShareDeleteRetentionPolicy Volitelný. Vlastnosti obnovitelného odstranění sdílených složek Azure v tomto účtu úložiště.
Days Volitelný. Označuje počet dnů, po které by se sdílená složka Azure měla zachovat (obnovitelné odstranění). Minimální hodnota, kterou můžete zadat, je 1a maximální hodnota je 365 (jeden rok).
Enabled Volitelný. Určuje, jestli má účet úložiště povolené obnovitelné odstranění pro službu Azure Files.
ProtocolSettings Volitelný. Seskupí nastavení pro protokoly systému souborů.
SMB Volitelný. Seskupí nastavení protokolu SMB.
Multichannel Volitelný. Obsahuje nastavení pro SMB multichannel. Funkce SMB multichannel obsahuje Enabled logickou vlastnost, která přepíná stav funkce SMB multichannel.
Versions Volitelné od verze 2020-04-08. Seznam povolených verzí SMB oddělených středníkem Povolené hodnoty jsou SMB2.1, SMB3.0a SMB3.1.1.
AuthenticationMethods Volitelné od verze 2020-04-08. Seznam povolených metod ověřování oddělený středníkem Povolené hodnoty jsou NTLMv2 a Kerberos.
KerberosTicketEncryption Volitelné od verze 2020-04-08. Seznam povolených algoritmů šifrování lístků Kerberos oddělený středníkem Povolené hodnoty jsou RC4-HMAC a AES-256.
ChannelEncryption Volitelné od verze 2020-04-08. Seznam povolených algoritmů šifrování kanálů SMB oddělený středníkem Povolené hodnoty jsou AES-128-CCM, AES-128-GCMa AES-256-GCM.
NFS Volitelné od verze 2026-02-06. Seskupuje nastavení pro NFS.
EncryptionInTransit Volitelné od verze 2026-02-06. Obsahuje nastavení pro šifrování SMB a NFS během přenosu. Šifrování SMB a NFS během přenosu obsahuje Booleovu Required vlastnost, která přepíná požadavek na šifrování SMB a NFS během přenosu. NFS šifrování během přenosu je povoleno pouze pro prémiové úložné účty.

Odezva

Odpověď obsahuje stavový kód HTTP a sadu hlaviček odpovědi.

Stavový kód

Úspěšná operace vrátí stavový kód 202 (přijato).

Hlavičky odpovědi

Odpověď pro tuto operaci obsahuje následující hlavičky. Odpověď může obsahovat také další standardní hlavičky HTTP. Všechny standardní hlavičky odpovídají specifikaci protokolu HTTP/1.1.

Hlavička odpovědi Popis
x-ms-request-id Hodnota, která jednoznačně identifikuje požadavek, který je proveden proti službě.
x-ms-version Určuje verzi operace, která byla použita pro odpověď. Další informace najdete v tématu Správa verzí pro služby Azure Storage.
x-ms-client-request-id Dá se použít k řešení potíží s požadavky a odpovídajícími odpověďmi. Hodnota hlavičky se rovná hodnotě hlavičky, pokud je v požadavku přítomna a hodnota neobsahuje více než 1 024 viditelných x-ms-client-request-id znaků ASCII. Pokud v požadavku není hlavička x-ms-client-request-id, nezobrazí se v odpovědi.

Obsah odpovědi

Žádné.

Autorizace

Tuto operaci může volat pouze vlastník účtu.

Poznámky

Pro pravidla CORS ve službě Azure Files platí následující omezení a omezení:

  • Lze uložit maximálně pět pravidel.

  • Maximální velikost všech nastavení pravidel CORS v požadavku, s výjimkou značek XML, by neměla překročit 2 KiB.

  • Délka povolené hlavičky, vystavené hlavičky nebo povoleného původu by neměla překročit 256 znaků.

  • Povolené hlavičky a vystavené hlavičky můžou být následující:

    • Literály, kde je zadaný přesný název záhlaví, například x-ms-meta-processed. V požadavku lze zadat maximálně 64 literálových hlaviček.

    • Předpona hlaviček, kde je zadanou předponou hlavičky, například x-ms-meta-data*. Zadáním předpony tímto způsobem povolíte nebo zveřejníte jakékoli záhlaví, které začíná touto předponou. V požadavku lze zadat maximálně dvě hlavičky s předponou.

  • Metody (nebo příkazy HTTP) zadané v elementu AllowedMethods musí odpovídat metodám podporovaným rozhraními API služby Azure Storage. Podporované metody jsou DELETE, , GET, HEADMERGEPOST, , OPTIONS, a PUT.

Zadání pravidel CORS v požadavku je volitelné. Pokud voláte Set File Service Properties bez zadání elementu CORS v textu požadavku, zachovají se všechna existující pravidla CORS.

Pokud chcete CORS zakázat, volejte Set File Service Properties s prázdným nastavením pravidel CORS (tj </Cors>. ) a žádnými vnitřními pravidly CORS. Toto volání odstraní všechna existující pravidla a zakáže CORS pro souborovou službu.

Všechny elementy pravidla CORS jsou vyžadovány, pokud CorsRule je prvek zadán. Požadavek selže s kódem chyby 400 (Chybný požadavek), pokud nějaký prvek chybí.

Další informace opravidlech

Ukázkový požadavek a odpověď

Následující ukázkový identifikátor URI vytvoří požadavek na změnu vlastností souborové služby pro účet úložiště s názvem myaccount:

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

Požadavek se odešle s následujícími hlavičkami:

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

Požadavek se odešle s následujícím textem XML:

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

Po odeslání požadavku se vrátí následující odpověď:

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

Viz také

Další informace opravidlech

Další informace o Analýze úložiště najdete v tématu Analýza úložiště.

  • Last updated on