您现在访问的是微软AZURE全球版技术文档网站,若需要访问由世纪互联运营的MICROSOFT AZURE中国区技术文档网站,请访问 https://docs.azure.cn.
获取文件服务属性
06/06/2021
本文内容
该操作 Get File Service Properties 使用 FileService FileREST API 获取资源的属性。 虽然完全支持此 API,但这是一个旧版管理 API。 建议使用文件 服务 - 改为使用 Microsoft.Storage (存储资源提供程序) 属性。 若要详细了解使用存储资源提供程序以编程方式与资源 FileService 交互,请参阅 FileService 上的操作。
协议可用性
已启用文件共享协议
可用
SMB
NFS
请求
可以按以下方式指定 Get File Service Properties 请求。 建议使用 HTTPS。 将 替换为你的存储帐户名称:
方法
请求 URI
HTTP 版本
GET
HTTP/1.1
请注意,URI 必须始终包含正斜杠 (/),以将主机名与 URI 的路径和查询部分隔开。 在执行此操作时,URI 的路径部分是空的。
URI 参数
URI 参数
说明
restype=service&comp=properties
必需。 必须组合使用这两个查询字符串才能设置存储服务属性。
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,启用存储分析日志记录时,该值记录在分析日志中。 强烈建议使用此标头将客户端活动与服务器接收的请求相关联。 有关详细信息,请参阅监视 Azure Blob 存储。
请求正文
无。
响应
响应包括 HTTP 状态代码、一组响应标头和响应正文。
状态代码
此操作成功后返回状态代码 200(正常)。
响应头
此操作的响应包括以下标头。 该响应还可能包括其他标准 HTTP 标头。 所有标准标头都符合 HTTP/1.1 协议规范。
响应标头
说明
x-ms-request-id
唯一地标识针对服务发出的请求的值。
x-ms-version
指定用于响应的操作版本。 有关详细信息,请参阅 Azure 存储 服务 的版本控制。
x-ms-client-request-id
此标头可用于对请求和相应响应进行故障排除。 如果标头存在于请求中,并且该值最多为 1024 个可见 ASCII 字符,则此标头的值等于标头 x-ms-client-request-id 的值。 如果 x-ms-client-request-id 请求中不存在标头,则响应中将不存在此标头。
响应正文
版本 2020-02-10 的响应正文的格式如下:
version-number
true|false
true|false
true|false
number-of-days
version-number
true|false
true|false
true|false
number-of-days
comma-separated-list-of-allowed-origins
comma-separated-list-of-HTTP-verb
max-caching-age-in-seconds
comma-seperated-list-of-response-headers
comma-seperated-list-of-request-headers
true|false
integer-value
true|false
comma-separated-list-of-smb-versions
comma-separated-list-of-auth-methods
csv-of-kerb-encryption-algorithms
csv-of-smb-encryption-algorithms
下表介绍响应正文的元素:
名称
说明
HourMetrics
将存储分析 HourMetrics 分组。 这些设置 HourMetrics 提供按 API 按每小时聚合分组的请求统计信息的摘要。
MinuteMetrics
对 Azure Analytics 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 多通道的设置。 此设置具有一个属性:已启用/已禁用。
Version
可从开始使用 2020-04-08 。 允许的 SMB 版本的逗号分隔列表。 可能的值: SMB2.1 、 SMB3.0 、 SMB3.1.1 。 默认情况下,如果未指定,则会启用所有版本,但是,仅当存储帐户的 "需要安全传输" 属性处于禁用状态时,才可使用 SMB 2.1,因为 SMB 2.1 不支持加密。
AuthenticationMethods
可从开始使用 2020-04-08 。 允许的身份验证方法的逗号分隔列表。 可能的值:NTLMv2、Kerberos。 如果未指定,则默认情况下允许所有身份验证方法。
KerberosTicketEncryption
可从开始使用 2020-04-08 。 允许使用的 Kerberos 票证加密算法的逗号分隔列表。 可能的值:RC4-HMAC、AES-256。 默认情况下,如果未指定,则支持所有 Kerberos 票证加密算法。
ChannelEncryption
可从开始使用 2020-04-08 。 允许的 SMB 通道加密协议的逗号分隔列表。 可能的值: AES-128-CCM 、 AES-128-GCM 、 AES-256-GCM 。 如果未指定,则默认情况下支持所有通道加密值。 如果存储帐户的 "需要安全传输" 属性处于禁用状态,则还会允许未加密的 SMB 访问。
授权
只有存储帐户所有者才能调用此操作。
示例请求和响应
以下示例 URI 发出请求以获取名为 " 我的帐户" 的存储帐户的文件服务属性:
方法
代码
协议
GET
https://myaccount.file.core.windows.net/?restype=service&comp=properties
HTTP/1.1
请求与以下标头一起发送:
x-ms-version: 2020-02-10
x-ms-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:
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 正文:
1.0
true
false
true
7
1.0
true
true
true
7
http://www.fabrikam.com,http://www.contoso.com
GET,PUT
500
x-ms-meta-data*,x-ms-meta-customheader
x-ms-meta-target*,x-ms-meta-customheader
true
7
true
SMB3.1.1
Kerberos
AES-256
AES-256-GCM
备注
有关 CORS 规则和计算逻辑的详细信息,请参阅对 存储服务的 CORS 支持。
有关存储分析的其他信息,请参阅 存储分析。