restfull服务器端获取文件,使用 FileREST API (获取文件服务) - Azure 文件存储 | Microsoft Docs...

您现在访问的是微软AZURE全球版技术文档网站,若需要访问由世纪互联运营的MICROSOFT AZURE中国区技术文档网站,请访问 https://docs.azure.cn.

获取文件服务属性

06/06/2021

本文内容

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

协议可用性

已启用文件共享协议

可用

SMB

4f9aa364614d6943b524b07a4bcef63f.png

NFS

4f9aa364614d6943b524b07a4bcef63f.png

请求

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

方法

请求 URI

HTTP 版本

GET

https://.file.core.windows.net/?restype=service&comp=properties

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 支持。

有关存储分析的其他信息,请参阅 存储分析。

  • 1
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值