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

BlobSasBuilder 类

定义

命名空间:

Azure.Storage.Sas

程序集:

Azure.Storage.Blobs.dll

包:

Azure.Storage.Blobs v12.19.1

Source:

BlobSasBuilder.cs

BlobSasBuilder 用于为 Azure 存储容器或 blob 生成共享访问签名 (SAS) 。 有关详细信息，请参阅 创建服务 SAS。

public class BlobSasBuilder

type BlobSasBuilder = class

Public Class BlobSasBuilder

继承

Object

BlobSasBuilder

构造函数

BlobSasBuilder(BlobContainerSasPermissions, DateTimeOffset)	初始化 类的新实例 BlobSasBuilder 以创建 Blob 容器服务 Sas。
BlobSasBuilder(BlobSasPermissions, DateTimeOffset)	初始化 类的新实例 BlobSasBuilder 以创建 Blob 服务 Sas。

属性

BlobContainerName	可供访问的 Blob 容器的名称。
BlobName	可访问的 Blob 的名称，或 Empty 容器 SAS 的名称。
BlobVersionId	可供访问的 Blob 版本的名称，或 Empty Blob SAS 的名称。
CacheControl	重写为Cache-Control响应标头返回的值。
ContentDisposition	重写为 Content-Disposition 响应标头返回的值。
ContentEncoding	重写为 Content-Encoding 响应标头返回的值。
ContentLanguage	重写为 Content-Language 响应标头返回的值。
ContentType	重写为 Content-Type 响应标头返回的值。
CorrelationId	可选。 从版本 2020-02-10 开始，此值将用于将存储审核日志与生成和分发 SAS 的主体使用的审核日志相关联。 这仅用于用户委派 SAS。
EncryptionScope	可选。 发送使用此 SAS URI 授权的请求时要使用的加密范围。
ExpiresOn	共享访问签名变为无效的时间。 如果已在关联的存储访问策略中指定，则必须省略此字段。
Identifier	长度为 64 个字符的可选唯一值，与为容器指定的访问策略相关联。
IPRange	指定从中接受请求的 IP 地址或 IP 地址范围。 如果请求源自的 IP 地址与 SAS 令牌上指定的 IP 地址或地址范围不匹配，则不会对请求进行身份验证。 指定 IP 地址范围时，请注意，该范围是非独占的。
Permissions	与共享访问签名关联的权限。 用户只能执行权限允许的操作。 如果已在关联的存储访问策略中指定，则必须省略此字段。 BlobSasPermissions、BlobContainerSasPermissions、 SnapshotSasPermissions或 BlobAccountSasPermissions 可用于创建权限字符串。
PreauthorizedAgentObjectId	可选。 从版本 2020-02-10 开始，此值将用于用户委派密钥所有者授权以执行 SAS 授予的操作的用户的 AAD 对象 ID。 在授予访问权限之前，Azure 存储服务将确保用户委派密钥的所有者具有所需的权限。 不会对此值中指定的用户执行任何其他权限检查。 这仅用于生成用户委派 SAS。
Protocol	可选的已签名协议字段指定允许使用 SAS 发出的请求的协议。 可能值为 HttpsAndHttp、Https 和 None。
Resource	指定可通过共享访问签名访问哪些资源。 如果共享资源是 Blob，则指定“b”。 这将授予对 Blob 的内容和元数据的访问权限。 如果共享资源是 Blob 容器，则指定“c”。 这将授予对容器中的任何 Blob 的内容和元数据的访问权限，以及对容器中的 Blob 列表的访问权限。 从版本 2018-11-09 开始，如果共享资源是 blob 快照，请指定“bs”。 这会授予对特定快照的内容和元数据的访问权限，但不会授予相应的根 Blob 的访问权限。 从版本 2019-12-12 开始，如果共享资源是 Blob 版本，请指定“bv”。 这会授予对特定版本的内容和元数据的访问权限，但不允许访问相应的根 Blob。
Snapshot	可访问的快照的名称，或 Empty Blob SAS 的名称。
StartsOn	（可选）指定共享访问签名生效的时间。 如果使用 DateTimeOffset.MinValue 时省略，则此调用的开始时间假定为存储服务接收请求的时间。

方法

SetPermissions(BlobAccountSasPermissions)	设置 Blob 帐户级别 SAS 的权限。
SetPermissions(BlobContainerSasPermissions)	设置 Blob 容器 SAS 的权限。
SetPermissions(BlobSasPermissions)	设置 Blob SAS 的权限。
SetPermissions(BlobVersionSasPermissions)	设置版本 SAS 的权限。
SetPermissions(SnapshotSasPermissions)	设置快照 SAS 的权限。
SetPermissions(String)	使用原始权限字符串设置 SAS 的权限。
SetPermissions(String, Boolean)	使用原始权限字符串设置 SAS 的权限。
ToSasQueryParameters(StorageSharedKeyCredential)	使用帐户的 StorageSharedKeyCredential 对此共享访问签名值进行签名，以生成适当的 SAS 查询参数来对请求进行身份验证。
ToSasQueryParameters(UserDelegationKey, String)	使用帐户的 UserDelegationKey 对此共享访问签名值进行签名，以生成适当的 SAS 查询参数来对请求进行身份验证。