你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

获取文件服务属性

项目
07/19/2023

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

协议可用性

已启用文件共享协议	可用
SMB
NFS

请求

可以按以下方式指定 Get File Service Properties 请求。建议使用 HTTPS。将 <account-name> 替换为你的存储帐户名称：

方法	请求 URI	HTTP 版本
GET	`https://<account-name>.file.core.windows.net/?restype=service&comp=properties`	HTTP/1.1

注意

URI 必须始终包含斜杠字符 (/) ，以便将主机名与 URI 的路径和查询部分分开。在此操作中，URI 的路径部分为空。

URI 参数

URI 参数	说明
`restype=service&comp=properties`	必需。必须组合使用这两个查询字符串才能设置存储服务属性。
`timeout`	可选。 `timeout` 参数以秒表示。有关详细信息，请参阅设置文件服务操作的超时。

请求标头

下表介绍必需的和可选的请求标头。

请求标头	说明
`Authorization`	必需。指定授权方案、存储帐户名称和签名。有关详细信息，请参阅授权对 Azure 存储的请求。
`Date` 或 `x-ms-date`	必需。指定请求的协调世界时 (UTC)。有关详细信息，请参阅授权对 Azure 存储的请求。
`x-ms-version`	对于所有已授权的请求是必需的。指定用于此请求的操作的版本。此操作仅在版本 2015-02-21 及更高版本中可用。若要检索文件服务的指标属性，必须指定版本 2015-04-05 或更高版本。有关详细信息，请参阅 Azure 存储服务的版本控制。
`x-ms-client-request-id`	可选。提供客户端生成的不透明值，其中包含 1 kiB (KiB) 配置日志记录时记录在 Azure 存储分析日志中的字符限制。强烈建议使用此标头将客户端活动与服务器接收的请求相关联。有关详细信息，请参阅监视Azure 文件存储。

请求正文

无。

响应

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

状态代码

此操作成功后返回状态代码 200（正常）。

响应头

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

响应标头	说明
`x-ms-request-id`	唯一标识针对服务发出的请求。
`x-ms-version`	指定用于响应的操作的版本。有关详细信息，请参阅 Azure 存储服务的版本控制。
`x-ms-client-request-id`	可用于对请求及其相应响应进行故障排除。如果请求中存在此标头的值，并且该值包含不超过 1，024 个可见 ASCII 字符，则此标头的值等于该标头的值 `x-ms-client-request-id` 。 `x-ms-client-request-id`如果请求中不存在标头，则响应中不存在该标头。

响应正文

版本 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`	对存储分析`HourMetrics`设置进行分组。这些 `HourMetrics` 设置提供请求统计信息的摘要，按 API 按小时聚合分组。
`MinuteMetrics`	对存储分析`MinuteMetrics`设置进行分组。设置 `MinuteMetrics` 提供每分钟的请求统计信息。
`Version`	当前正在使用的存储分析的版本。
`Enabled`	指示是否为文件服务启用指标。
`IncludeAPIs`	指示度量值是否为调用的 API 操作生成汇总统计信息。
`RetentionPolicy/Enabled`	指示是否为文件服务启用保留策略。
`RetentionPolicy/Days`	指示指标数据的保留天数。所有早于此值的数据都会尽力删除。
`Cors`	将所有跨域资源共享 (CORS) 规则进行分组。
`CorsRule`	对 CORS 规则的设置进行分组。
`AllowedOrigins`	将通过 CORS 允许的源域的以逗号分隔的列表，或者为“*”（如果允许所有域）。
`ExposedHeaders`	要公开给 CORS 客户端的响应标头的以逗号分隔的列表。
`MaxAgeInSeconds`	客户端或浏览器应缓存预检响应的秒数。
`AllowedHeaders`	允许作为跨域请求的一部分的标头列表，以逗号分隔。
`AllowedMethods`	允许由源执行的 HTTP 方法的以逗号分隔的列表。对于Azure 文件存储，允许的方法包括 DELETE、GET、HEAD、MERGE、POST、OPTIONS 和 PUT。
`ShareDeleteRetentionPolicy`	此存储帐户中 Azure 文件共享的软删除属性。
`Days`	指示 Azure 文件共享应保留 (软删除) 的天数。指定的最小值可以为 1，最大值为 365。
`Enabled`	指示存储帐户是否为Azure 文件存储启用了软删除。
`ProtocolSettings`	对文件系统协议的设置进行分组。
`SMB`	将服务器消息块 (SMB) 的设置分组。
`Multichannel`	包含 SMB 多通道的设置。此设置有一个属性：enabled/disabled。
`Version`	自版本 2020-04-08 起可用。允许的 SMB 版本的逗号分隔列表。可能的值：`SMB2.1`、`SMB3.0` 和 `SMB3.1.1`。如果未 `Version` 指定，则默认启用所有版本。但是，SMB 2.1 仅在存储帐户 `require secure transit` 的属性被禁用时才可用，因为 SMB 2.1 不支持加密。
`AuthenticationMethods`	自版本 2020-04-08 起可用。允许的身份验证方法的逗号分隔列表。可能的值：`NTLMv2`、`Kerberos`。如果未 `AuthenticationMethods` 指定，则默认允许所有身份验证方法。
`KerberosTicketEncryption`	自版本 2020-04-08 起可用。允许的 Kerberos 票证加密算法的逗号分隔列表。可能的值： `RC4-HMAC` 和 `AES-256`。如果未 `KerberosTicketEncryption` 指定，则默认支持所有 Kerberos 票证加密算法。
`ChannelEncryption`	自版本 2020-04-08 起可用。允许的 SMB 通道加密协议的逗号分隔列表。可能的值：`AES-128-CCM`、`AES-128-GCM` 和 `AES-256-GCM`。如果未 `ChannelEncryption` 指定，则默认为支持所有通道加密值。如果存储帐户的属性 `require secure transit` 处于禁用状态，则还允许未加密的 SMB 访问。

授权

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

示例请求和响应

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

方法	URL	协议
GET	`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

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

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

响应包括以下 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>

注解

有关 CORS 规则和评估逻辑的详细信息，请参阅对 Azure 存储服务的 CORS 支持。

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