Share via

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

BlobSASSignatureValues interface

  • 参考
包:
@azure/storage-blob

仅在 NODE.JS RUNTIME 中可用。

BlobSASSignatureValues 用于帮助为容器或 Blob 生成 Blob 服务 SAS 令牌。

属性

blobName

可选。 SAS 用户可以访问的 Blob 名称。 如果提供了 snapshotTime 或 versionId，则是必需的。
cacheControl

可选。 SAS 的 cache-control 标头。
containerName

SAS 用户可以访问的容器的名称。
contentDisposition

可选。 SAS 的内容处置标头。
contentEncoding

可选。 SAS 的内容编码标头。
contentLanguage

可选。 SAS 的内容语言标头。
contentType

可选。 SAS 的内容类型标头。
correlationId

可选。 从版本 2020-02-10 开始，这是将记录在存储诊断日志中的 GUID 值，可用于将 SAS 生成与存储资源访问相关联。 这仅用于用户委派 SAS。
encryptionScope

可选。 发送使用此 SAS URI 授权的请求时要使用的加密范围。
expiresOn

仅当提供标识符时才可选。 SAS 不再工作的时间。
identifier

可选。 此 SAS 引用的容器上的访问策略的名称（如果有）。

请参见https://docs.microsoft.com/en-us/rest/api/storageservices/establishing-a-stored-access-policy
ipRange

可选。 此 SAS 中允许的 IP 范围。
permissions

仅当提供标识符时才可选。 请参阅 ContainerSASPermissions 或 BlobSASPermissions ，具体取决于要访问的资源，以获取有关构造权限字符串的帮助。
preauthorizedAgentObjectId

可选。 从版本 2020-02-10 开始，以 GUID 格式指定授权的 AAD 对象 ID。 用户委派密钥所有者授权以执行 SAS 授予的操作的用户的 AAD 对象 ID。 Azure 存储服务将确保用户委派密钥的所有者在授予访问权限之前具有所需的权限，但不会对此值中指定的用户执行其他权限检查。 这仅用于用户委派 SAS。
protocol

可选。 SAS 协议、仅限 HTTPS 或 HTTPSandHTTP
snapshotTime

可选。 SAS 用户可以访问的快照时间戳字符串。 仅在 API 版本 2018-11-09 中受支持。
startsOn

可选。 SAS 何时生效。
version

此 SAS 将面向的服务的版本。 如果未指定，它将默认为库所面向的版本。
versionId

可选。 VersionId SAS 用户可以访问的 Blob 版本。 仅在 API 版本 2019-10-10 中受支持。

属性详细信息

blobName

可选。 SAS 用户可以访问的 Blob 名称。 如果提供了 snapshotTime 或 versionId，则是必需的。

blobName?: string

属性值

string

cacheControl

可选。 SAS 的 cache-control 标头。

cacheControl?: string

属性值

string

containerName

SAS 用户可以访问的容器的名称。

containerName: string

属性值

string

contentDisposition

可选。 SAS 的内容处置标头。

contentDisposition?: string

属性值

string

contentEncoding

可选。 SAS 的内容编码标头。

contentEncoding?: string

属性值

string

contentLanguage

可选。 SAS 的内容语言标头。

contentLanguage?: string

属性值

string

contentType

可选。 SAS 的内容类型标头。

contentType?: string

属性值

string

correlationId

可选。 从版本 2020-02-10 开始，这是将记录在存储诊断日志中的 GUID 值，可用于将 SAS 生成与存储资源访问相关联。 这仅用于用户委派 SAS。

correlationId?: string

属性值

string

encryptionScope

可选。 发送使用此 SAS URI 授权的请求时要使用的加密范围。

encryptionScope?: string

属性值

string

expiresOn

仅当提供标识符时才可选。 SAS 不再工作的时间。

expiresOn?: Date

属性值

Date

identifier

可选。 此 SAS 引用的容器上的访问策略的名称（如果有）。

请参见https://docs.microsoft.com/en-us/rest/api/storageservices/establishing-a-stored-access-policy

identifier?: string

属性值

string

ipRange

可选。 此 SAS 中允许的 IP 范围。

ipRange?: SasIPRange

属性值

SasIPRange

permissions

仅当提供标识符时才可选。 请参阅 ContainerSASPermissions 或 BlobSASPermissions ，具体取决于要访问的资源，以获取有关构造权限字符串的帮助。

permissions?: BlobSASPermissions | ContainerSASPermissions

属性值

BlobSASPermissions | ContainerSASPermissions

preauthorizedAgentObjectId

可选。 从版本 2020-02-10 开始，以 GUID 格式指定授权的 AAD 对象 ID。 用户委派密钥所有者授权以执行 SAS 授予的操作的用户的 AAD 对象 ID。 Azure 存储服务将确保用户委派密钥的所有者在授予访问权限之前具有所需的权限，但不会对此值中指定的用户执行其他权限检查。 这仅用于用户委派 SAS。

preauthorizedAgentObjectId?: string

属性值

string

protocol

可选。 SAS 协议、仅限 HTTPS 或 HTTPSandHTTP

protocol?: SASProtocol

属性值

SASProtocol

snapshotTime

可选。 SAS 用户可以访问的快照时间戳字符串。 仅在 API 版本 2018-11-09 中受支持。

snapshotTime?: string

属性值

string

startsOn

可选。 SAS 何时生效。

startsOn?: Date

属性值

Date

version

此 SAS 将面向的服务的版本。 如果未指定，它将默认为库所面向的版本。

version?: string

属性值

string

versionId

可选。 VersionId SAS 用户可以访问的 Blob 版本。 仅在 API 版本 2019-10-10 中受支持。

versionId?: string

属性值

string