本文介绍了支持的属性字典,可在每个 Azure 存储 DataAction 的 Azure 角色分配条件中使用。 有关特定权限或 DataAction 影响的 Blob 服务操作列表,请参阅 Blob 服务操作的权限。
若要了解角色分配条件格式,请参阅 Azure 角色分配条件格式和语法
Important
Azure 基于属性的访问控制 (Azure ABAC) 已正式发布 (GA),用于使用标准和高级存储帐户性能层中的 request、resource、environment 和 principal 属性控制对 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 索引标记作为请求参数的操作。
Note
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 中读取内容
Important
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/writeMicrosoft.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 数据 |
编写 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 存储属性。 如果为单个条件选择多个操作,则可为条件选择的特性可能较少,因为这些特性必须在所选操作中可用。
Note
除非另有说明,否则列出的属性和值视为不区分大小写。
下表按源汇总了可用属性:
| 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 |
Note
为 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 |
Note
为 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 分层命名空间 |