Azure Blob 存储的 Azure 角色分配条件的操作和属性

本文介绍了支持的属性字典,可在每个 Azure 存储 DataAction 的 Azure 角色分配条件中使用。 有关特定权限或 DataAction 影响的 Blob 服务操作列表,请参阅 Blob 服务操作的权限

若要了解角色分配条件格式,请参阅 Azure 角色分配条件格式和语法

重要

Azure 基于属性的访问控制 (Azure ABAC) 已正式发布 (GA),用于使用标准和高级存储帐户性能层中的 requestresourceenvironmentprincipal 属性控制对 Azure Blob 存储、Azure Data Lake Storage Gen2 和 Azure 队列的访问。 目前,分层命名空间的“列出 Blob 操作的所含内容”请求属性和“快照”请求属性处于预览状态。 有关 Azure 存储 ABAC 的完整功能状态信息,请参阅 Azure 存储中条件功能的状态

有关 beta 版本、预览版或尚未正式发布的版本的 Azure 功能所适用的法律条款,请参阅 Azure 预览版的补充使用条款

Suboperations

多个存储服务操作可以与单个权限或 DataAction 相关联。 但是,与同一权限相关联的每个操作都可能支持不同的参数。 “子操作”能够区分需要相同权限但支持不同条件属性集的服务操作。 因此,通过使用子操作,可以指定一个条件来访问支持给定参数的操作的子集。 然后,可以对不支持该参数的相同操作使用另一个操作访问条件。

例如,对于数十个不同的服务操作,Microsoft.Storage/storageAccounts/blobServices/containers/blobs/write 操作是必需的。 其中一些操作可以接受 blob 索引标记作为请求参数,而其他操作则不能。 对于接受 blob 索引标记作为参数的操作,可以在请求条件中使用 blob 索引标记。 但是,如果在 Microsoft.Storage/storageAccounts/blobServices/containers/blobs/write 操作上定义了此类条件,则不接受标记作为请求参数的所有操作都无法评估此条件,并且无法通过授权访问检查。

在这种情况下,可以使用可选子操作 Blob.Write.WithTagHeaders 来将条件仅应用于支持 blob 索引标记作为请求参数的操作。

备注

Blob 还能够存储任意用户定义的键值元数据。 尽管元数据与 blob 索引标记类似,但必须使用带条件的 blob 索引标记。 有关详细信息,请查看使用 Blob 索引标记管理和查找 Azure Blob 数据

Azure Blob 存储操作和子操作

本部分列出了可在条件中指定为目标的受支持 Azure Blob 存储操作和子操作。 下表汇总了它们:

Display name DataAction Suboperation
Read operations
按标记查找 Blob Microsoft.Storage/storageAccounts/blobServices/containers/blobs/filter/action n/a
List blobs Microsoft.Storage/storageAccounts/blobServices/containers/blobs/read Blob.List
读取 blob Microsoft.Storage/storageAccounts/blobServices/containers/blobs/read NOT Blob.List
读取 blob 索引标记 Microsoft.Storage/storageAccounts/blobServices/containers/blobs/tags/read n/a
读取具有标记条件的 Blob 中的内容
(已启用)
Microsoft.Storage/storageAccounts/blobServices/containers/blobs/read Blob.Read.WithTagConditions
Write operations
创建 blob 或快照,或追加数据 Microsoft.Storage/storageAccounts/blobServices/containers/blobs/add/action n/a
删除 Blob Microsoft.Storage/storageAccounts/blobServices/containers/blobs/delete n/a
删除 blob 的版本 Microsoft.Storage/storageAccounts/blobServices/containers/blobs/deleteBlobVersion/action n/a
永久删除 blob 替代软删除 Microsoft.Storage/storageAccounts/blobServices/containers/blobs/permanentDelete/action n/a
重命名文件或目录 Microsoft.Storage/storageAccounts/blobServices/containers/blobs/move/action n/a
在 Blob 上设置访问层 Microsoft.Storage/storageAccounts/blobServices/containers/blobs/write Blob.Write.Tier
写入 blob 索引标记 Microsoft.Storage/storageAccounts/blobServices/containers/blobs/tags/write n/a
编写 Blob 法定保留和不可变性策略 Microsoft.Storage/storageAccounts/blobServices/containers/blobs/immutableStorage/runAsSuperUser/action n/a
写入到 blob Microsoft.Storage/storageAccounts/blobServices/containers/blobs/write n/a
写入到具有 blob 索引标记的 blob Microsoft.Storage/storageAccounts/blobServices/containers/blobs/write
Microsoft.Storage/storageAccounts/blobServices/containers/blobs/add/action
Blob.Write.WithTagHeaders
Permissions operations
更改 Blob 的所有权 Microsoft.Storage/storageAccounts/blobServices/containers/blobs/manageOwnership/action n/a
修改 blob 的权限 Microsoft.Storage/storageAccounts/blobServices/containers/blobs/modifyPermissions/action n/a
HNS operations
帐户的所有数据操作均已启用分层命名空间 Microsoft.Storage/storageAccounts/blobServices/containers/blobs/runAsSuperUser/action n/a

List blobs

Property Value
Display name List blobs
Description 列出 Blob 操作。
DataAction Microsoft.Storage/storageAccounts/blobServices/containers/blobs/read
Suboperation Blob.List
Resource attributes Account name
层次结构命名空间是否已启用
Container name
Request attributes Blob prefix
主体属性支持 True
Environment attributes 是专用链接
专用终结点
子网
现在 (UTC)
Examples !(ActionMatches{'Microsoft.Storage/storageAccounts/blobServices/containers/blobs/read'} AND SubOperationMatches{'Blob.List'})
示例:使用路径读取或列出命名容器中的 blob

读取 blob

Property Value
Display name 读取 blob
Description 除列出之外的所有 Blob 读取操作。
DataAction Microsoft.Storage/storageAccounts/blobServices/containers/blobs/read
Suboperation 不是 Blob.List
Resource attributes Account name
是否为当前版本
层次结构命名空间是否已启用
Container name
Blob path
加密范围名称
Request attributes Version ID
Snapshot
主体属性支持 True
Environment attributes 是专用链接
专用终结点
子网
现在 (UTC)
Examples !(ActionMatches{'Microsoft.Storage/storageAccounts/blobServices/containers/blobs/read'} AND NOT SubOperationMatches{'Blob.List'})
示例:使用路径读取命名容器中的 blob

从具有标记条件的 blob 中读取内容

重要

Read content from a blob with tag conditions 子操作已弃用。 尽管目前支持它与 ABAC 功能预览期间实现的条件兼容,但 Azure 建议改用读取 blob 操作。

在 Azure 门户中配置 ABAC 条件时,可能会出现“已弃用: 从具有标记条件的 Blob 中读取内容”。 Azure 建议删除该操作并将其替换为 Read a blob 操作。

如果要创作自己的条件,希望通过标记条件来限制读取访问,请参阅示例:使用 blob 索引标记读取 Blob

读取 blob 索引标记

Property Value
Display name 读取 blob 索引标记
Description 用于读取 blob 索引标记的 DataAction。
DataAction Microsoft.Storage/storageAccounts/blobServices/containers/blobs/tags/read
Suboperation n/a
Resource attributes Account name
是否为当前版本
层次结构命名空间是否已启用
Container name
Blob path
blob 索引标记 [键中的值]
blob 索引标记 [键]
Request attributes Version ID
Snapshot
主体属性支持 True
Environment attributes 是专用链接
专用终结点
子网
现在 (UTC)
Learn more 通过 Blob 索引标记管理和查找 Azure Blob 数据

按标记查找 Blob

Property Value
Display name 按标记查找 Blob
Description 用于按索引标记查找 Blob 的 DataAction。
DataAction Microsoft.Storage/storageAccounts/blobServices/containers/blobs/filter/action
Suboperation n/a
Resource attributes Account name
层次结构命名空间是否已启用
Request attributes
主体属性支持 True
Environment attributes 是专用链接
专用终结点
子网
现在 (UTC)

写入到 blob

Property Value
Display name 写入到 blob
Description 用于写入到 blob 的 DataAction。
DataAction Microsoft.Storage/storageAccounts/blobServices/containers/blobs/write
Suboperation n/a
Resource attributes Account name
层次结构命名空间是否已启用
Container name
Blob path
加密范围名称
Request attributes
主体属性支持 True
Environment attributes 是专用链接
专用终结点
子网
现在 (UTC)
Examples !(ActionMatches{'Microsoft.Storage/storageAccounts/blobServices/containers/blobs/write'})
示例:读取、写入或删除命名容器中的 blob

在 Blob 上设置访问层

Property Value
Display name 在 Blob 上设置访问层
Description 用于写入到 blob 的 DataAction。
DataAction Microsoft.Storage/storageAccounts/blobServices/containers/blobs/write
Suboperation Blob.Write.Tier
Resource attributes Account name
是否为当前版本
层次结构命名空间是否已启用
Container name
Blob path
加密范围名称
Request attributes Version ID
Snapshot
主体属性支持 True
Environment attributes 是专用链接
专用终结点
子网
现在 (UTC)
Examples !(ActionMatches{'Microsoft.Storage/storageAccounts/blobServices/containers/blobs/write'} AND SubOperationMatches{'Blob.Write.Tier'})

写入到具有 blob 索引标记的 blob

Property Value
Display name 写入到具有 blob 索引标记的 blob
Description REST 操作:放置 Blob、放置块列表、复制 Blob 和从 URL 复制 Blob。
DataAction Microsoft.Storage/storageAccounts/blobServices/containers/blobs/write
Microsoft.Storage/storageAccounts/blobServices/containers/blobs/add/action
Suboperation Blob.Write.WithTagHeaders
Resource attributes Account name
层次结构命名空间是否已启用
Container name
Blob path
加密范围名称
Request attributes blob 索引标记 [键中的值]
blob 索引标记 [键]
主体属性支持 True
Environment attributes 是专用链接
专用终结点
子网
现在 (UTC)
Examples !(ActionMatches{'Microsoft.Storage/storageAccounts/blobServices/containers/blobs/write'} AND SubOperationMatches{'Blob.Write.WithTagHeaders'})
!(ActionMatches{'Microsoft.Storage/storageAccounts/blobServices/containers/blobs/add/action'} AND SubOperationMatches{'Blob.Write.WithTagHeaders'})
示例:新 blob 必须包含 blob 索引标记
Learn more 通过 Blob 索引标记管理和查找 Azure Blob 数据

创建 blob 或快照,或追加数据

Property Value
Display name 创建 blob 或快照,或追加数据
Description 用于创建 blob 的 DataAction。
DataAction Microsoft.Storage/storageAccounts/blobServices/containers/blobs/add/action
Suboperation n/a
Resource attributes Account name
层次结构命名空间是否已启用
Container name
Blob path
加密范围名称
Request attributes
主体属性支持 True
Environment attributes 是专用链接
专用终结点
子网
现在 (UTC)
Examples !(ActionMatches{'Microsoft.Storage/storageAccounts/blobServices/containers/blobs/add/action'})
示例:读取、写入或删除命名容器中的 blob

写入 blob 索引标记

Property Value
Display name 写入 blob 索引标记
Description 用于写入 blob 索引标记的 DataAction。
DataAction Microsoft.Storage/storageAccounts/blobServices/containers/blobs/tags/write
Suboperation n/a
Resource attributes Account name
是否为当前版本
层次结构命名空间是否已启用
Container name
Blob path
blob 索引标记 [键中的值]
blob 索引标记 [键]
Request attributes blob 索引标记 [键中的值]
blob 索引标记 [键]
Version ID
Snapshot
主体属性支持 True
Environment attributes 是专用链接
专用终结点
子网
现在 (UTC)
Examples !(ActionMatches{'Microsoft.Storage/storageAccounts/blobServices/containers/blobs/tags/write'})
示例:现有 blob 必须具有 blob 索引标记键
Learn more 通过 Blob 索引标记管理和查找 Azure Blob 数据
Property Value
Display name 编写 Blob 法定保留和不可变性策略
Description 用于编写 Blob 法定保留和不可变策略的 DataAction。
DataAction Microsoft.Storage/storageAccounts/blobServices/containers/blobs/immutableStorage/runAsSuperUser/action
Suboperation n/a
Resource attributes Account name
层次结构命名空间是否已启用
Container name
Blob path
Request attributes
主体属性支持 True
Environment attributes 是专用链接
专用终结点
子网
现在 (UTC)

删除 Blob

Property Value
Display name 删除 Blob
Description 用于删除 blob 的 DataAction。
DataAction Microsoft.Storage/storageAccounts/blobServices/containers/blobs/delete
Suboperation n/a
Resource attributes Account name
是否为当前版本
层次结构命名空间是否已启用
Container name
Blob path
Request attributes Version ID
Snapshot
主体属性支持 True
Environment attributes 是专用链接
专用终结点
子网
现在 (UTC)
Examples !(ActionMatches{'Microsoft.Storage/storageAccounts/blobServices/containers/blobs/delete'})
示例:读取、写入或删除命名容器中的 blob

删除 blob 的版本

Property Value
Display name 删除 blob 的版本
Description 用于删除 blob 的版本的 DataAction。
DataAction Microsoft.Storage/storageAccounts/blobServices/containers/blobs/deleteBlobVersion/action
Suboperation n/a
Resource attributes Account name
层次结构命名空间是否已启用
Container name
Blob path
Request attributes Version ID
主体属性支持 True
Environment attributes 是专用链接
专用终结点
子网
现在 (UTC)
Examples !(ActionMatches{'Microsoft.Storage/storageAccounts/blobServices/containers/blobs/deleteBlobVersion/action'})
示例:删除旧 blob 版本

永久删除 blob 替代软删除

Property Value
Display name 永久删除 blob 替代软删除
Description 用于永久删除 blob 替代软删除的 DataAction。
DataAction Microsoft.Storage/storageAccounts/blobServices/containers/blobs/permanentDelete/action
Suboperation n/a
Resource attributes Account name
是否为当前版本
层次结构命名空间是否已启用
Container name
Blob path
Request attributes Version ID
Snapshot
主体属性支持 True
Environment attributes 是专用链接
专用终结点
子网
现在 (UTC)

修改 blob 的权限

Property Value
Display name 修改 blob 的权限
Description 用于修改 blob 的权限的 DataAction。
DataAction Microsoft.Storage/storageAccounts/blobServices/containers/blobs/modifyPermissions/action
Suboperation n/a
Resource attributes Account name
层次结构命名空间是否已启用
Container name
Blob path
Request attributes
主体属性支持 True
Environment attributes 是专用链接
专用终结点
子网
现在 (UTC)

更改 Blob 的所有权

Property Value
Display name 更改 Blob 的所有权
Description 用于更改 blob 的所有权的DataAction。
DataAction Microsoft.Storage/storageAccounts/blobServices/containers/blobs/manageOwnership/action
Suboperation n/a
Resource attributes Account name
层次结构命名空间是否已启用
Container name
Blob path
Request attributes
主体属性支持 True
Environment attributes 是专用链接
专用终结点
子网
现在 (UTC)

重命名文件或目录

Property Value
Display name 重命名文件或目录
Description 用于重命名文件或目录的 DataAction。
DataAction Microsoft.Storage/storageAccounts/blobServices/containers/blobs/move/action
Suboperation n/a
Resource attributes Account name
层次结构命名空间是否已启用
Container name
Blob path
Request attributes
主体属性支持 True
Environment attributes 是专用链接
专用终结点
子网
现在 (UTC)

帐户的所有数据操作均已启用分层命名空间

Property Value
Display name 帐户的所有数据操作均已启用分层命名空间
Description 存储帐户上所有数据操作的 DataAction 均已启用分层命名空间。
如果角色定义包含 Microsoft.Storage/storageAccounts/blobServices/containers/blobs/runAsSuperUser/action 操作,则应在条件中将此操作指定为目标。 如果为存储帐户启用了分层命名空间,则将此操作指定为目标可确保条件仍按预期方式工作。
DataAction Microsoft.Storage/storageAccounts/blobServices/containers/blobs/runAsSuperUser/action
Suboperation n/a
Resource attributes Account name
是否为当前版本
层次结构命名空间是否已启用
Container name
Blob path
Request attributes
主体属性支持 True
Environment attributes 是专用链接
专用终结点
子网
现在 (UTC)
Examples 示例:读取、写入或删除命名容器中的 blob
示例:使用路径读取命名容器中的 blob
示例:使用路径读取或列出命名容器中的 blob
示例:使用路径在命名容器中写入 blob
示例:仅读取当前 blob 版本
示例:读取当前 blob 版本和任何 blob 快照
示例:仅读取已启用分层命名空间的存储帐户
Learn more Azure Data Lake Storage 分层命名空间

Azure Blob 存储属性

本部分列出了可在条件表达式中根据目标操作使用的 Azure Blob 存储属性。 如果为单个条件选择多个操作,则可为条件选择的特性可能较少,因为这些特性必须在所选操作中可用。

备注

除非另有说明,否则列出的属性和值视为不区分大小写。

下表按源汇总了可用属性:

Attribute Source Display name Description
Environment
是专用链接 访问是否通过专用链接进行
Private endpoint 用于访问对象的专用终结点
Subnet 用于访问对象的子网
UTC now 当前日期和时间(协调世界时)
Request
blob 索引标记 [键] blob 资源(键)的索引标记;仅适用于未启用分层命名空间的存储帐户
blob 索引标记 [键中的值] blob 资源(键中的值)的索引标记;仅适用于未启用分层命名空间的存储帐户
Blob prefix 允许列出的 blob 的前缀
列出 Blob 包含 可以随列出操作一起包含的信息,例如元数据、快照或版本
Snapshot blob 快照的快照标识符
Version ID 进行版本控制 blob 的版本 ID;仅适用于未启用分层命名空间的存储帐户
Resource
Account name 存储帐户名称
blob 索引标记 [键] blob 资源上的索引标记(键)
blob 索引标记 [键中的值] blob 资源上的索引标记(键中的值)
Blob path 虚拟目录、blob、文件夹或文件资源的路径
Container name 存储容器或文件系统的名称
Container metadata 与容器关联的元数据键/值对
加密范围名称 用于加密数据的加密范围的名称
是当前版本 资源是否为 blob 的当前版本
层次结构命名空间是否已启用 存储帐户上是否已启用分层命名空间

Account name

Property Value
Display name Account name
Description 存储帐户的名称。
Attribute Microsoft.Storage/storageAccounts:name
Attribute source Resource
Attribute type String
Examples @Resource[Microsoft.Storage/storageAccounts:name] StringEquals 'sampleaccount'
示例:在具有特定加密范围的命名存储帐户中读取或写入 blob

blob 索引标记 [键]

Property Value
Display name blob 索引标记 [键]
Description blob 资源上的索引标记。
可以与 blob 资源一起存储的任意用户定义的键值属性。 想要检查 blob 索引标记中的键时使用。
仅适用于未启用分层命名空间的存储帐户。
Attribute Microsoft.Storage/storageAccounts/blobServices/containers/blobs/tags&$keys$&
Attribute source Resource
Request
Attribute type StringList
键是否区分大小写 True
分层命名空间支持 False
Examples @Request[Microsoft.Storage/storageAccounts/blobServices/containers/blobs/tags&$keys$&] ForAllOfAnyValues:StringEquals {'Project', 'Program'}
示例:现有 blob 必须具有 blob 索引标记键
Learn more 通过 Blob 索引标记管理和查找 Azure Blob 数据
Azure Data Lake Storage 分层命名空间

blob 索引标记 [键中的值]

Property Value
Display name blob 索引标记 [键中的值]
Description blob 资源上的索引标记。
可以与 blob 资源一起存储的任意用户定义的键值属性。 想要检查 blob 索引标记中的键(区分大小写)和值时使用。
仅适用于未启用分层命名空间的存储帐户。
Attribute Microsoft.Storage/storageAccounts/blobServices/containers/blobs/tags
Attribute source Resource
Request
Attribute type String
键是否区分大小写 True
分层命名空间支持 False
Examples @Resource[Microsoft.Storage/storageAccounts/blobServices/containers/blobs/tags: keyname<$key_case_sensitive$>
@Resource[Microsoft.Storage/storageAccounts/blobServices/containers/blobs/tags:Project<$key_case_sensitive$>] StringEquals 'Cascade'
示例:使用 blob 索引标记读取 blob
Learn more 通过 Blob 索引标记管理和查找 Azure Blob 数据
Azure Data Lake Storage 分层命名空间

Blob path

Property Value
Display name Blob path
Description 虚拟目录、blob、文件夹或文件资源的路径。
想要检查 blob 路径中的 blob 名称或文件夹时使用。
Attribute Microsoft.Storage/storageAccounts/blobServices/containers/blobs:path
Attribute source Resource
Attribute type String
Examples @Resource[Microsoft.Storage/storageAccounts/blobServices/containers/blobs:path] StringLike 'readonly/*'
示例:使用路径读取命名容器中的 blob

备注

Microsoft.Storage/storageAccounts/blobServices/containers/blobs:path 属性指定条件时,值不应包含容器名称或前导斜杠 (/) 字符。 使用不带任何 URL 编码的路径字符。

Blob prefix

Property Value
Display name Blob prefix
Description 允许列出的 Blob 的前缀。
虚拟目录或文件夹资源的路径。 想要检查 Blob 路径中的文件夹时使用。
Attribute Microsoft.Storage/storageAccounts/blobServices/containers/blobs:prefix
Attribute source Request
Attribute type String
Examples @Request[Microsoft.Storage/storageAccounts/blobServices/containers/blobs:prefix] StringStartsWith 'readonly/'
示例:使用路径读取或列出命名容器中的 blob

备注

Microsoft.Storage/storageAccounts/blobServices/containers/blobs:prefix 属性指定条件时,值不应包含容器名称或前导斜杠 (/) 字符。 使用不带任何 URL 编码的路径字符。

Container name

Property Value
Display name Container name
Description 存储容器或文件系统的名称。
想要检查容器名称时使用。
Attribute Microsoft.Storage/storageAccounts/blobServices/containers:name
Attribute source Resource
Attribute type String
Examples @Resource[Microsoft.Storage/storageAccounts/blobServices/containers:name] StringEquals 'blobs-example-container'
示例:读取、写入或删除命名容器中的 blob

Container metadata

Property Value
Display name Container metadata
Description 与容器关联的元数据键/值对。
想要检查容器的特定元数据时使用。
Attribute Microsoft.Storage/storageAccounts/blobServices/containers/metadata
Attribute source Resource
Attribute type String
Examples @Resource[Microsoft.Storage/storageAccounts/blobServices/containers/metadata:testKey] StringEquals 'testValue'
示例:读取包含特定元数据的容器中的 Blob
示例:在包含特定元数据的容器中写入或删除 Blob

加密范围名称

Property Value
Display name 加密范围名称
Description 用于加密数据的加密范围的名称。
Attribute Microsoft.Storage/storageAccounts/encryptionScopes:name
Attribute source Resource
Attribute type String
Exists support True
Examples @Resource[Microsoft.Storage/storageAccounts/encryptionScopes:name] ForAnyOfAnyValues:StringEquals {'validScope1', 'validScope2'}
示例:读取具有特定加密范围的 blob
Learn more 创建和管理加密范围

是当前版本

Property Value
Display name 是当前版本
Description 资源是否为当前版本的 blob,与快照或特定 blob 版本对比。
Attribute Microsoft.Storage/storageAccounts/blobServices/containers/blobs:isCurrentVersion
Attribute source Resource
Attribute type Boolean
Examples @Resource[Microsoft.Storage/storageAccounts/blobServices/containers/blobs:isCurrentVersion] BoolEquals true
示例:仅读取当前 blob 版本
示例:读取当前 blob 版本和特定 blob 版本

层次结构命名空间是否已启用

Property Value
Display name 层次结构命名空间是否已启用
Description 存储帐户上是否已启用分层命名空间。
仅适用于资源组范围或更大范围。
Attribute Microsoft.Storage/storageAccounts:isHnsEnabled
Attribute source Resource
Attribute type Boolean
Examples @Resource[Microsoft.Storage/storageAccounts:isHnsEnabled] BoolEquals true
示例:仅读取已启用分层命名空间的存储帐户
Learn more Azure Data Lake Storage 分层命名空间
Property Value
Display name 是专用链接
Description 访问是否通过专用链接进行。
用于要求通过任何专用链接进行访问。
Attribute isPrivateLink
Attribute source Environment
Attribute type Boolean
Applies to 对于使用以下 REST 操作的复制操作,此属性仅适用于目标存储帐户,不适用于源:

Copy Blob
从 URL 复制 Blob
从 URL 放置 Blob
从 URL 放置块
从 URL 追加块
从 URL 放置页

对于所有其他读取、写入、创建、删除和重命名操作,它适用于作为操作目标的存储帐户
Examples @Environment[isPrivateLink] BoolEquals true
示例:需要专用链接访问权限才能读取具有高敏感度的 Blob
Learn more 为 Azure 存储使用专用终结点

列出 Blob 包含

Property Value
Display name 列出 Blob 包含
Description 可以随列出 Blob 操作一起包含的信息,例如元数据、快照或版本。
想要在调用include 操作时允许或限制 参数值的情况下使用。
目前采用预览版。 仅适用于未启用分层命名空间的存储帐户。
Attribute Microsoft.Storage/storageAccounts/blobServices/containers/blobs:include
Attribute source Request
Attribute type String
Examples @Request[Microsoft.Storage/storageAccounts/blobServices/containers/blobs:include] ForAllOfAnyValues:StringEqualsIgnoreCase {'metadata', 'snapshots', 'versions'}
@Request[Microsoft.Storage/storageAccounts/blobServices/containers/blobs:include] ForAllOfAllValues:StringNotEquals {'metadata'}
示例:允许列出 Blob 操作包含 Blob 元数据、快照或版本
示例:将列出 Blob 操作限制为不能包含 Blob 元数据

Private endpoint

Property Value
Display name Private endpoint
Description 用于访问对象的专用终结点。
用于限制通过特定专用终结点的访问。
仅适用于订阅中至少配置了一个专用终结点的存储帐户。
Attribute Microsoft.Network/privateEndpoints
Attribute source Environment
Attribute type String
Applies to 对于使用以下 REST 操作的复制操作,此属性仅适用于目标存储帐户,不适用于源:

Copy Blob
从 URL 复制 Blob
从 URL 放置 Blob
从 URL 放置块
从 URL 追加块
从 URL 放置页

对于所有其他读取、写入、创建、删除和重命名操作,它适用于作为操作目标的存储帐户
Examples @Environment[Microsoft.Network/privateEndpoints] StringEqualsIgnoreCase '/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/example-group/providers/Microsoft.Network/privateEndpoints/privateendpoint1'
示例:仅允许从特定专用终结点对容器进行读取访问
Learn more 为 Azure 存储使用专用终结点

Snapshot

Property Value
Display name Snapshot
Description Blob 快照的快照标识符。
仅适用于未启用分层命名空间的存储帐户,当前为已启用分层命名空间的存储帐户提供预览版。
Attribute Microsoft.Storage/storageAccounts/blobServices/containers/blobs:snapshot
Attribute source Request
Attribute type DateTime
Exists support True
分层命名空间支持 False
Examples Exists @Request[Microsoft.Storage/storageAccounts/blobServices/containers/blobs:snapshot]
示例:读取当前 blob 版本和任何 blob 快照
Learn more Blob snapshots
Azure Data Lake Storage 分层命名空间

Subnet

Property Value
Display name Subnet
Description 用于访问对象的子网。
用于限制对特定子网的访问。
仅适用于订阅中至少配置了一个使用服务终结点的虚拟网络子网的存储帐户。
Attribute Microsoft.Network/virtualNetworks/subnets
Attribute source Environment
Attribute type String
Applies to 对于使用以下 REST 操作的复制操作,此属性仅适用于目标存储帐户,不适用于源:

Copy Blob
从 URL 复制 Blob
从 URL 放置 Blob
从 URL 放置块
从 URL 追加块
从 URL 放置页

对于所有其他读取、写入、创建、删除和重命名操作,它适用于作为操作目标的存储帐户
Examples @Environment[Microsoft.Network/virtualNetworks/subnets] StringEqualsIgnoreCase '/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/example-group/providers/Microsoft.Network/virtualNetworks/virtualnetwork1/subnets/default'
示例:允许从特定子网访问特定容器中的 Blob
Learn more Subnets

UTC now

Property Value
Display name UTC now
Description 协调世界时的当前日期和时间。
用于控制特定日期和时间段内对对象的访问。
Attribute UtcNow
Attribute source Environment
Attribute type DateTime
(UTC now 属性仅支持运算符 DateTimeGreaterThan 和 DateTimeLessThan。
Examples @Environment[UtcNow] DateTimeGreaterThan '2023-05-01T13:00:00.0Z'
示例:允许在特定日期和时间之后对 blob 进行读取访问

Version ID

Property Value
Display name Version ID
Description 带有版本的 Blob 的版本 ID。
仅适用于未启用分层命名空间的存储帐户。
Attribute Microsoft.Storage/storageAccounts/blobServices/containers/blobs:versionId
Attribute source Request
Attribute type DateTime
Exists support True
分层命名空间支持 False
Examples @Request[Microsoft.Storage/storageAccounts/blobServices/containers/blobs:versionId] DateTimeEquals '2022-06-01T23:38:32.8883645Z'
示例:读取当前 blob 版本和特定 blob 版本
示例:读取当前 blob 版本和任何 blob 快照
Learn more Azure Data Lake Storage 分层命名空间

See also