設定檔案服務屬性

作業會 Set File Service Properties 使用 FileREST API 來設定 File 服務資源的屬性。 雖然完全支援此 API，但它是舊版管理 API。 建議您改用 檔案服務 - 設定服務屬性，這是由 Azure 儲存體資源提供者提供， (Microsoft.Storage) 。 若要深入瞭解如何使用 Azure 儲存體資源提供者以程式設計方式與檔案服務資源互動，請參閱 檔案服務上的作業。

通訊協定可用性

已啟用檔案共用通訊協定	可用
SMB
NFS

要求

您可以指定 Set File Service Properties 要求，如下所示。 建議您使用 HTTPS。 以儲存體帳戶的名稱取代 account-name ：

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

不需要在要求上指定每個根項目。 如果省略根元素，將會保留服務該項功能現有的設定。 不過，如果您確實指定特定根項目，則必須指定該元素的每個子專案。 根元素包括：

• 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 、 HEAD 、 MERGEPOST 、、 OPTIONS 和 PUT 。

在要求上指定 CORS 規則是選擇性的作法。 如果您在要求本文中未指定 CORS 元素的情況下呼叫 Set File Service Properties ，則會維護任何現有的 CORS 規則。

若要停用 CORS，請使用空的 CORS 規則設定 (來呼叫 Set File Service Properties ， </Cors> 也就是) 且沒有內部 CORS 規則。 此呼叫會刪除任何現有的規則，並停用 File 服務的 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 儲存體服務的跨原始來源資源分享支援。

如需儲存體分析的詳細資訊，請參閱儲存體分析。