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

BlobSasQueryParameters 类

定义

命名空间:

Azure.Storage.Sas

程序集:

Azure.Storage.Blobs.dll

包:

Azure.Storage.Blobs v12.20.0

Source:

BlobSasQueryParameters.cs

对象 BlobSasQueryParameters 表示构成 Azure 存储共享访问签名查询参数的组件。 可以使用 构造新实例 BlobSasBuilder。

有关详细信息，请参阅： 创建服务 SAS。

public sealed class BlobSasQueryParameters : Azure.Storage.Sas.SasQueryParameters

type BlobSasQueryParameters = class
    inherit SasQueryParameters

Public NotInheritable Class BlobSasQueryParameters
Inherits SasQueryParameters

继承

Object

SasQueryParameters

BlobSasQueryParameters

字段

DefaultSasVersion

用于共享访问签名的默认服务版本。 (继承自 SasQueryParameters)

属性

AgentObjectId	获取与共享访问签名关联的未经授权的 AAD 对象 ID。 用户委派密钥的所有者假定未授权的用户的 AAD 对象 ID。 Azure 存储服务将执行额外的 POSIX ACL 检查，以确定用户是否有权执行请求的操作。 这不能用于与 PreauthorizedAgentObjectId的结合。 仅在已启用 HNS 的帐户中有效。 如果在未启用 HNS 的帐户中设置此值，则会引发授权失败。 (继承自 SasQueryParameters)
CacheControl	获取Cache-Control响应标头，该标头允许指定要用于 Blob 和文件下载的客户端缓存。 (继承自 SasQueryParameters)
ContentDisposition	获取 Content-Disposition 响应标头，该标头允许指定 Blob 或文件内容在浏览器中的显示方式。 (继承自 SasQueryParameters)
ContentEncoding	获取内容编码响应标头，该标头允许指定用于 Blob 和文件下载的编码类型。 (继承自 SasQueryParameters)
ContentLanguage	获取 Content-Language 响应标头，该标头允许指定下载的 Blob 或文件内容的语言。 (继承自 SasQueryParameters)
ContentType	获取 Content-Type 响应标头，该标头允许指定下载的 Blob 或文件内容的类型。 (继承自 SasQueryParameters)
CorrelationId	获取与共享访问签名关联的关联 ID。 这用于将存储审核日志与生成和分发 SAS 的主体使用的审核日志相关联。 (继承自 SasQueryParameters)
DirectoryDepth	获取字符串到符号的规范化resource 字段中指定的目录深度。 目录的深度是根文件夹下的目录数。 当资源 (sr) = d 以指示目录深度时是必需的。 该值必须是非负整数。 (继承自 SasQueryParameters)
Empty	获取空的共享访问签名查询参数。
EncryptionScope	获取与共享访问签名关联的加密范围。 (继承自 SasQueryParameters)
ExpiresOn	获取共享访问签名失效的时间。 MinValue 表示未设置。 (继承自 SasQueryParameters)
Identifier	获取长度为 64 个字符的可选唯一值，该值与为 Blob 容器、队列或共享指定的访问策略相关联。 (继承自 SasQueryParameters)
IPRange	获取接受请求的可选 IP 地址或 IP 地址范围。 指定范围时，请注意该区域是非独占的。 (继承自 SasQueryParameters)
KeyExpiresOn	获取密钥过期的时间。
KeyObjectId	获取 GUID 格式的 Azure Active Directory 对象 ID。
KeyService	获取接受密钥的存储服务。
KeyStartsOn	获取密钥生效的时间。
KeyTenantId	获取 GUID 格式的 Azure Active Directory 租户 ID
KeyVersion	获取创建密钥的存储服务版本。
Permissions	获取与共享访问签名关联的权限。 用户只能执行权限允许的操作。 如果已在关联的存储访问策略中指定，则必须省略此字段。 (继承自 SasQueryParameters)
PreauthorizedAgentObjectId	获取与共享访问签名关联的授权 AAD 对象 ID。 用户委派密钥所有者授权执行 SAS 授予的操作的用户的 AAD 对象 ID。 Azure 存储服务将确保用户委派密钥的所有者在授予访问权限之前具有所需的权限，但不会对此值中指定的用户执行其他权限检查。 这不能用于与 AgentObjectId的结合。 仅在已启用 HNS 的帐户中有效。 如果在未启用 HNS 的帐户中设置此值，则会引发授权失败。 (继承自 SasQueryParameters)
Protocol	可选。 指定允许使用共享访问签名发出的请求的协议。 (继承自 SasQueryParameters)
Resource	获取可通过共享访问签名访问的资源。 (继承自 SasQueryParameters)
ResourceTypes	获取可通过共享访问签名访问的资源。 (继承自 SasQueryParameters)
Services	获取可通过帐户级别共享访问签名访问的已签名服务。 (继承自 SasQueryParameters)
Signature	获取字符串到签名，这是从字段构造的唯一字符串，必须验证该字段才能对请求进行身份验证。 该签名是利用 SHA256 算法通过 string-to-sign 和密钥计算，然后使用 Base64 编码方式进行编码的 HMAC。 (继承自 SasQueryParameters)
StartsOn	获取共享访问签名生效的可选时间。 如果省略，将假定此调用的开始时间就是存储服务收到请求的时间。 MinValue 表示未设置。 (继承自 SasQueryParameters)
Version	获取用于对此共享访问签名发出的请求进行身份验证的存储服务版本，以及处理使用此共享访问签名发出的请求时要使用的服务版本。 (继承自 SasQueryParameters)

方法

AppendProperties(StringBuilder)	生成 SasQueryParameters 实例的查询参数字符串。 (继承自 SasQueryParameters)
ToString()	将 SAS 查询参数转换为 URL 编码的查询字符串。