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

ShareSasBuilder 类

定义

ShareSasBuilder 用于为 Azure 存储共享、目录或文件生成共享访问签名 (SAS) 。

   For more information, see
创建服务 SAS
public class ShareSasBuilder
type ShareSasBuilder = class
Public Class ShareSasBuilder
继承
ShareSasBuilder

构造函数

ShareSasBuilder(ShareFileSasPermissions, DateTimeOffset)

初始化 类的新实例 ShareSasBuilder 以创建 Azure 文件 Sas。

ShareSasBuilder(ShareSasPermissions, DateTimeOffset)

初始化 类的新实例 ShareSasBuilder 以创建文件共享 Sas。

属性

CacheControl

重写为Cache-Control响应标头返回的值。

ContentDisposition

重写为 Content-Disposition 响应标头返回的值。

ContentEncoding

重写为Cache-Encoding响应标头返回的值。

ContentLanguage

重写为Cache-Language响应标头返回的值。

ContentType

重写为Cache-Type响应标头返回的值。

ExpiresOn

共享访问签名变为无效的时间。 如果已在关联的存储访问策略中指定,则必须省略此字段。

FilePath

可供访问的文件或目录的路径,或 Empty 共享 SAS 的路径。

Identifier

长度为 64 个字符的可选唯一值,与为共享指定的访问策略相关联。

IPRange

指定从中接受请求的 IP 地址或 IP 地址范围。 如果请求源自的 IP 地址与 SAS 令牌上指定的 IP 地址或地址范围不匹配,则不会对请求进行身份验证。 指定 IP 地址范围时,请注意,该范围是非独占的。

Permissions

与共享访问签名关联的权限。 用户只能执行权限允许的操作。 如果已在关联的存储访问策略中指定,则必须省略此字段。 ShareFileSasPermissionsShareSasPermissionsShareAccountSasPermissions 可用于创建权限字符串。

Protocol

可选的已签名协议字段指定允许使用 SAS 发出的请求的协议。 可能值为 HttpsAndHttpHttpsNone

Resource

指定可通过共享访问签名访问哪些资源。

如果共享资源是文件,则指定“f”。 这会授予对文件内容和元数据的访问权限。

如果共享资源是共享,则指定“s”。 这会授予对共享中任何文件的内容和元数据以及共享中目录和文件列表的访问权限。

ShareName

可供访问的共享的名称。

StartsOn

(可选)指定共享访问签名生效的时间。 如果使用 DateTimeOffset.MinValue 时省略,则此调用的开始时间假定为存储服务接收请求的时间。

方法

SetPermissions(ShareAccountSasPermissions)

设置文件帐户级别 SAS 的权限。

SetPermissions(ShareFileSasPermissions)

设置文件 SAS 的权限。

SetPermissions(ShareSasPermissions)

设置共享 SAS 的权限。

SetPermissions(String)

使用原始权限字符串设置 SAS 的权限。

SetPermissions(String, Boolean)

使用原始权限字符串设置 SAS 的权限。

ToSasQueryParameters(StorageSharedKeyCredential)

使用帐户的 StorageSharedKeyCredential 对此共享访问签名值进行签名,以生成适当的 SAS 查询参数来对请求进行身份验证。

适用于