设置文件服务属性

该 Set File Service Properties 作使用 FileREST API 设置文件服务资源的属性。 尽管完全支持此 API，但它是旧版管理 API。 建议改用 文件服务 - 设置服务属性，该属性由 Azure 存储资源提供程序（Microsoft.Storage）提供。 若要详细了解如何使用 Azure 存储资源提供程序以编程方式与文件服务资源交互，请参阅 文件服务上的作。

协议可用性

已启用文件共享协议	可用
中小型企业 (SMB)
网络文件系统(NFS)

请求

可以按如下所示指定 Set File Service Properties 请求。 建议使用 HTTPS。 将 帐户名称 替换为存储帐户的名称：

URI 参数

请求标头

下表描述了必需和可选的请求标头：

请求主体

版本 2020-02-10 的请求正文的格式如下所示：

<?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>
        </SMB>
    </ProtocolSettings>
</StorageServiceProperties>  
  

不需要在请求上指定每个根元素。 如果省略根元素，则会保留该服务的现有功能设置。 但是，如果确实指定了特定的根元素，则必须为该元素指定每个子元素。 根元素包括：

• HourMetrics
• MinuteMetrics
• Cors
• ProtocolSettings

下表描述了请求正文的元素：

响应

响应包括 HTTP 状态代码和一组响应标头。

状态代码

成功的作返回状态代码 202（已接受）。

响应标头

此操作的响应包括以下标头。 响应还可能包括其他标准 HTTP 标头。 所有标准标头都符合 HTTP/1.1 协议规范。

响应体

没有。

授权

只有帐户所有者才能调用此操作。

注解

以下限制和限制适用于 Azure 文件中的 CORS 规则：

• 最多可以存储五个规则。

• 请求上所有 CORS 规则设置的最大大小（不包括 XML 标记）不应超过 2 KiB。

• 允许的标头、公开的标头或允许的源的长度不应超过 256 个字符。

• 允许的标头和公开的标头可以是以下任一项：

  • 文本标头，其中提供了确切的标头名称，例如 x-ms-meta-processed。 请求最多可以指定 64 个文本标头。

  • 前缀标头，其中提供了标头的前缀，例如 x-ms-meta-data*。 以这种方式指定前缀允许或公开以该前缀开头的任何标头。 请求最多可以指定两个前缀标头。

• 元素中指定的 AllowedMethods 方法（或 HTTP 谓词）必须符合 Azure 存储服务 API 支持的方法。 支持的方法包括DELETE、、GET、HEADMERGE、POST、 OPTIONS和PUT。

在请求上指定 CORS 规则是可选的。 如果在请求正文中未指定 CORS 元素的情况下调用 Set File Service Properties ，则维护任何现有的 CORS 规则。

若要禁用 CORS，请使用空的 CORS 规则设置（即</Cors>）和没有内部 CORS 规则进行调用Set File Service Properties。 此调用将删除任何现有规则，并禁用文件服务的 CORS。

如果指定了元素， CorsRule 则需要所有 CORS 规则元素。 如果缺少任何元素，则请求失败，错误代码为 400（错误请求）。

有关 CORS 规则和评估逻辑的详细信息，请参阅 Azure 存储服务的跨域资源共享支持。

示例请求和响应

以下示例 URI 发出更改名为 myaccount 的存储帐户的文件服务属性的请求：

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

请求使用以下标头发送：

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

请求使用以下 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>
        </SMB>
    </ProtocolSettings>
</StorageServiceProperties>  

发送请求后，将返回以下响应：

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  

另请参阅

有关 CORS 规则和评估逻辑的详细信息，请参阅 Azure 存储服务的跨域资源共享支持。

有关存储分析的详细信息，请参阅 存储分析。