通过

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

Microsoft.Storage storageAccounts/blobServices

  • 项目

Bicep 资源定义

可以使用目标操作部署 storageAccounts/blobServices 资源类型：

有关每个 API 版本中已更改属性的列表，请参阅 更改日志。

资源格式

若要创建 Microsoft.Storage/storageAccounts/blobServices 资源，请将以下 Bicep 添加到模板。

resource symbolicname 'Microsoft.Storage/storageAccounts/blobServices@2023-05-01' = {
  name: 'default'
  parent: resourceSymbolicName
  properties: {
    automaticSnapshotPolicyEnabled: bool
    changeFeed: {
      enabled: bool
      retentionInDays: int
    }
    containerDeleteRetentionPolicy: {
      allowPermanentDelete: bool
      days: int
      enabled: bool
    }
    cors: {
      corsRules: [
        {
          allowedHeaders: [
            'string'
          ]
          allowedMethods: [
            'string'
          ]
          allowedOrigins: [
            'string'
          ]
          exposedHeaders: [
            'string'
          ]
          maxAgeInSeconds: int
        }
      ]
    }
    defaultServiceVersion: 'string'
    deleteRetentionPolicy: {
      allowPermanentDelete: bool
      days: int
      enabled: bool
    }
    isVersioningEnabled: bool
    lastAccessTimeTrackingPolicy: {
      blobType: [
        'string'
      ]
      enable: bool
      name: 'AccessTimeTracking'
      trackingGranularityInDays: int
    }
    restorePolicy: {
      days: int
      enabled: bool
    }
  }
}

属性值

storageAccounts/blobServices

名字 描述 价值
名字 资源名称

了解如何在 Bicep中设置子资源的名称和类型。		 “default”
父母 在 Bicep 中，可以为子资源指定父资源。 仅当子资源在父资源外部声明时，才需要添加此属性。

有关详细信息，请参阅 父资源外部的子资源。		 类型资源的符号名称：storageAccounts
性能 存储帐户的 Blob 服务的属性。 BlobServicePropertiesProperties

BlobServicePropertiesProperties

名字 描述 价值
automaticSnapshotPolicyEnabled 弃用支持 isVersioningEnabled 属性。 bool
changeFeed 更改源事件的 Blob 服务属性。 ChangeFeed
containerDeleteRetentionPolicy 容器软删除的 Blob 服务属性。 DeleteRetentionPolicy
cors 指定 Blob 服务的 CORS 规则。 请求中最多可以包含五个 CorsRule 元素。 如果请求正文中不包含 CorsRule 元素，将删除所有 CORS 规则，并且将禁用 Blob 服务的 CORS。 CorsRules
defaultServiceVersion 如果未指定传入请求的版本，则 DefaultServiceVersion 指示用于对 Blob 服务的请求的默认版本。 可能的值包括版本 2008-10-27 和所有较新版本。 字符串
deleteRetentionPolicy Blob 软删除的 Blob 服务属性。 DeleteRetentionPolicy
isVersioningEnabled 如果设置为 true，则启用版本控制。 bool
lastAccessTimeTrackingPolicy 用于配置基于上次访问时间的跟踪策略的 Blob 服务属性。 LastAccessTimeTrackingPolicy
restorePolicy Blob 还原策略的 Blob 服务属性。 RestorePolicyProperties

ChangeFeed

名字 描述 价值
启用 指示是否为 Blob 服务启用了更改源事件日志记录。 bool
retentionInDays 指示 changeFeed 保留期（以天为单位）。 最小值为 1 天，最大值为 146000 天（400 年）。 null 值表示更改源的无限保留期。 int

约束：
最小值 = 1
最大值 = 146000

DeleteRetentionPolicy

名字 描述 价值
allowPermanentDelete 如果设置为 true，则此属性允许删除软删除的 Blob 版本和快照。 此属性不能使用 Blob 还原策略。 此属性仅适用于 Blob 服务，不适用于容器或文件共享。 bool
日 指示应保留已删除项的天数。 最小指定值可以是 1，最大值可以为 365。 int

约束：
最小值 = 1
最大值 = 365
启用 指示是否启用 DeleteRetentionPolicy。 bool

CorsRules

名字 描述 价值
corsRules CORS 规则列表。 请求中最多可以包含五个 CorsRule 元素。 CorsRule[]

CorsRule

名字 描述 价值
allowedHeaders 如果存在 CorsRule 元素，则为必需。 允许作为跨域请求的一部分的标头列表。 string[] （必需）
allowedMethods 如果存在 CorsRule 元素，则为必需。 源允许执行的 HTTP 方法的列表。 包含任一项的字符串数组：
“CONNECT”
“DELETE”
“GET”
“HEAD”
“MERGE”
“OPTIONS”
“PATCH”
“POST”
“PUT”
“TRACE”（必需）
allowedOrigins 如果存在 CorsRule 元素，则为必需。 将允许通过 CORS 或“*”允许所有域的源域列表 string[] （必需）
exposedHeaders 如果存在 CorsRule 元素，则为必需。 要向 CORS 客户端公开的响应标头列表。 string[] （必需）
maxAgeInSeconds 如果存在 CorsRule 元素，则为必需。 客户端/浏览器应缓存预检响应的秒数。 int （必需）

LastAccessTimeTrackingPolicy

名字 描述 价值
blobType 预定义支持的 Blob 类型的数组。 仅 blockBlob 是受支持的值。 此字段当前为只读 string[]
使 如果设置为 true，则启用基于上次访问时间的跟踪。 bool （必需）
名字 策略的名称。 有效值为 AccessTimeTracking。 此字段当前为只读 “AccessTimeTracking”
trackingGranularityInDays 该字段指定 Blob 对象跟踪粒度（以天为单位），通常应跟踪 Blob 对象的频率。此字段当前为 1 的只读 int

RestorePolicyProperties

名字 描述 价值
日 可以还原此 Blob 的时长。 它应大于零且小于 DeleteRetentionPolicy.days。 int

约束：
最小值 = 1
最大值 = 365
启用 如果设置为 true，则启用 Blob 还原。 bool （必需）

快速入门模板

以下快速入门模板部署此资源类型。

模板 描述
Azure Cloud Shell - VNet 存储

部署到 Azure 		此模板将 Azure Cloud Shell 存储部署到 Azure 虚拟网络。
创建 V2 数据工厂

部署到 Azure 		此模板创建一个 V2 数据工厂，用于将数据从 Azure Blob 存储中的文件夹复制到存储中的另一个文件夹。
使用事件网格连接部署 Azure 数据资源管理器数据库

部署到 Azure 		使用事件网格连接部署 Azure 数据资源管理器数据库。
创建 Azure 机器学习扫描作业

部署到 Azure 		此模板创建用于超参数优化的 Azure 机器学习扫描作业。
在 Azure 上创建 Azure 存储帐户和 Blob 容器

部署到 Azure 		此模板创建 Azure 存储帐户和 Blob 容器。
使用 SSE 和 blob 删除保留策略 存储帐户

部署到 Azure 		此模板使用存储服务加密和 Blob 删除保留策略创建存储帐户
创建包含多个 Blob 容器的存储帐户

部署到 Azure 		创建一个 Azure 存储帐户和多个 Blob 容器。

ARM 模板资源定义

可以使用目标操作部署 storageAccounts/blobServices 资源类型：

有关每个 API 版本中已更改属性的列表，请参阅 更改日志。

资源格式

若要创建 Microsoft.Storage/storageAccounts/blobServices 资源，请将以下 JSON 添加到模板。

{
  "type": "Microsoft.Storage/storageAccounts/blobServices",
  "apiVersion": "2023-05-01",
  "name": "default",
  "properties": {
    "automaticSnapshotPolicyEnabled": "bool",
    "changeFeed": {
      "enabled": "bool",
      "retentionInDays": "int"
    },
    "containerDeleteRetentionPolicy": {
      "allowPermanentDelete": "bool",
      "days": "int",
      "enabled": "bool"
    },
    "cors": {
      "corsRules": [
        {
          "allowedHeaders": [ "string" ],
          "allowedMethods": [ "string" ],
          "allowedOrigins": [ "string" ],
          "exposedHeaders": [ "string" ],
          "maxAgeInSeconds": "int"
        }
      ]
    },
    "defaultServiceVersion": "string",
    "deleteRetentionPolicy": {
      "allowPermanentDelete": "bool",
      "days": "int",
      "enabled": "bool"
    },
    "isVersioningEnabled": "bool",
    "lastAccessTimeTrackingPolicy": {
      "blobType": [ "string" ],
      "enable": "bool",
      "name": "AccessTimeTracking",
      "trackingGranularityInDays": "int"
    },
    "restorePolicy": {
      "days": "int",
      "enabled": "bool"
    }
  }
}

属性值

storageAccounts/blobServices

名字 描述 价值
类型 资源类型 “Microsoft.Storage/storageAccounts/blobServices”
apiVersion 资源 API 版本 '2023-05-01'
名字 资源名称

了解如何在 JSON ARM 模板中设置子资源的名称和类型。		 “default”
性能 存储帐户的 Blob 服务的属性。 BlobServicePropertiesProperties

BlobServicePropertiesProperties

名字 描述 价值
automaticSnapshotPolicyEnabled 弃用支持 isVersioningEnabled 属性。 bool
changeFeed 更改源事件的 Blob 服务属性。 ChangeFeed
containerDeleteRetentionPolicy 容器软删除的 Blob 服务属性。 DeleteRetentionPolicy
cors 指定 Blob 服务的 CORS 规则。 请求中最多可以包含五个 CorsRule 元素。 如果请求正文中不包含 CorsRule 元素，将删除所有 CORS 规则，并且将禁用 Blob 服务的 CORS。 CorsRules
defaultServiceVersion 如果未指定传入请求的版本，则 DefaultServiceVersion 指示用于对 Blob 服务的请求的默认版本。 可能的值包括版本 2008-10-27 和所有较新版本。 字符串
deleteRetentionPolicy Blob 软删除的 Blob 服务属性。 DeleteRetentionPolicy
isVersioningEnabled 如果设置为 true，则启用版本控制。 bool
lastAccessTimeTrackingPolicy 用于配置基于上次访问时间的跟踪策略的 Blob 服务属性。 LastAccessTimeTrackingPolicy
restorePolicy Blob 还原策略的 Blob 服务属性。 RestorePolicyProperties

ChangeFeed

名字 描述 价值
启用 指示是否为 Blob 服务启用了更改源事件日志记录。 bool
retentionInDays 指示 changeFeed 保留期（以天为单位）。 最小值为 1 天，最大值为 146000 天（400 年）。 null 值表示更改源的无限保留期。 int

约束：
最小值 = 1
最大值 = 146000

DeleteRetentionPolicy

名字 描述 价值
allowPermanentDelete 如果设置为 true，则此属性允许删除软删除的 Blob 版本和快照。 此属性不能使用 Blob 还原策略。 此属性仅适用于 Blob 服务，不适用于容器或文件共享。 bool
日 指示应保留已删除项的天数。 最小指定值可以是 1，最大值可以为 365。 int

约束：
最小值 = 1
最大值 = 365
启用 指示是否启用 DeleteRetentionPolicy。 bool

CorsRules

名字 描述 价值
corsRules CORS 规则列表。 请求中最多可以包含五个 CorsRule 元素。 CorsRule[]

CorsRule

名字 描述 价值
allowedHeaders 如果存在 CorsRule 元素，则为必需。 允许作为跨域请求的一部分的标头列表。 string[] （必需）
allowedMethods 如果存在 CorsRule 元素，则为必需。 源允许执行的 HTTP 方法的列表。 包含任一项的字符串数组：
“CONNECT”
“DELETE”
“GET”
“HEAD”
“MERGE”
“OPTIONS”
“PATCH”
“POST”
“PUT”
“TRACE”（必需）
allowedOrigins 如果存在 CorsRule 元素，则为必需。 将允许通过 CORS 或“*”允许所有域的源域列表 string[] （必需）
exposedHeaders 如果存在 CorsRule 元素，则为必需。 要向 CORS 客户端公开的响应标头列表。 string[] （必需）
maxAgeInSeconds 如果存在 CorsRule 元素，则为必需。 客户端/浏览器应缓存预检响应的秒数。 int （必需）

LastAccessTimeTrackingPolicy

名字 描述 价值
blobType 预定义支持的 Blob 类型的数组。 仅 blockBlob 是受支持的值。 此字段当前为只读 string[]
使 如果设置为 true，则启用基于上次访问时间的跟踪。 bool （必需）
名字 策略的名称。 有效值为 AccessTimeTracking。 此字段当前为只读 “AccessTimeTracking”
trackingGranularityInDays 该字段指定 Blob 对象跟踪粒度（以天为单位），通常应跟踪 Blob 对象的频率。此字段当前为 1 的只读 int

RestorePolicyProperties

名字 描述 价值
日 可以还原此 Blob 的时长。 它应大于零且小于 DeleteRetentionPolicy.days。 int

约束：
最小值 = 1
最大值 = 365
启用 如果设置为 true，则启用 Blob 还原。 bool （必需）

快速入门模板

以下快速入门模板部署此资源类型。

模板 描述
Azure Cloud Shell - VNet 存储

部署到 Azure 		此模板将 Azure Cloud Shell 存储部署到 Azure 虚拟网络。
创建 V2 数据工厂

部署到 Azure 		此模板创建一个 V2 数据工厂，用于将数据从 Azure Blob 存储中的文件夹复制到存储中的另一个文件夹。
使用事件网格连接部署 Azure 数据资源管理器数据库

部署到 Azure 		使用事件网格连接部署 Azure 数据资源管理器数据库。
创建 Azure 机器学习扫描作业

部署到 Azure 		此模板创建用于超参数优化的 Azure 机器学习扫描作业。
在 Azure 上创建 Azure 存储帐户和 Blob 容器

部署到 Azure 		此模板创建 Azure 存储帐户和 Blob 容器。
使用 SSE 和 blob 删除保留策略 存储帐户

部署到 Azure 		此模板使用存储服务加密和 Blob 删除保留策略创建存储帐户
创建包含多个 Blob 容器的存储帐户

部署到 Azure 		创建一个 Azure 存储帐户和多个 Blob 容器。

Terraform （AzAPI 提供程序）资源定义

可以使用目标操作部署 storageAccounts/blobServices 资源类型：

  • 资源组

有关每个 API 版本中已更改属性的列表，请参阅 更改日志。

资源格式

若要创建 Microsoft.Storage/storageAccounts/blobServices 资源，请将以下 Terraform 添加到模板。

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Storage/storageAccounts/blobServices@2023-05-01"
  name = "default"
  parent_id = "string"
  body = jsonencode({
    properties = {
      automaticSnapshotPolicyEnabled = bool
      changeFeed = {
        enabled = bool
        retentionInDays = int
      }
      containerDeleteRetentionPolicy = {
        allowPermanentDelete = bool
        days = int
        enabled = bool
      }
      cors = {
        corsRules = [
          {
            allowedHeaders = [
              "string"
            ]
            allowedMethods = [
              "string"
            ]
            allowedOrigins = [
              "string"
            ]
            exposedHeaders = [
              "string"
            ]
            maxAgeInSeconds = int
          }
        ]
      }
      defaultServiceVersion = "string"
      deleteRetentionPolicy = {
        allowPermanentDelete = bool
        days = int
        enabled = bool
      }
      isVersioningEnabled = bool
      lastAccessTimeTrackingPolicy = {
        blobType = [
          "string"
        ]
        enable = bool
        name = "AccessTimeTracking"
        trackingGranularityInDays = int
      }
      restorePolicy = {
        days = int
        enabled = bool
      }
    }
  })
}

属性值

storageAccounts/blobServices

名字 描述 价值
类型 资源类型 “Microsoft.Storage/storageAccounts/blobServices@2023-05-01”
名字 资源名称 “default”
parent_id 此资源的父资源的 ID。 类型资源的 ID：storageAccounts
性能 存储帐户的 Blob 服务的属性。 BlobServicePropertiesProperties

BlobServicePropertiesProperties

名字 描述 价值
automaticSnapshotPolicyEnabled 弃用支持 isVersioningEnabled 属性。 bool
changeFeed 更改源事件的 Blob 服务属性。 ChangeFeed
containerDeleteRetentionPolicy 容器软删除的 Blob 服务属性。 DeleteRetentionPolicy
cors 指定 Blob 服务的 CORS 规则。 请求中最多可以包含五个 CorsRule 元素。 如果请求正文中不包含 CorsRule 元素，将删除所有 CORS 规则，并且将禁用 Blob 服务的 CORS。 CorsRules
defaultServiceVersion 如果未指定传入请求的版本，则 DefaultServiceVersion 指示用于对 Blob 服务的请求的默认版本。 可能的值包括版本 2008-10-27 和所有较新版本。 字符串
deleteRetentionPolicy Blob 软删除的 Blob 服务属性。 DeleteRetentionPolicy
isVersioningEnabled 如果设置为 true，则启用版本控制。 bool
lastAccessTimeTrackingPolicy 用于配置基于上次访问时间的跟踪策略的 Blob 服务属性。 LastAccessTimeTrackingPolicy
restorePolicy Blob 还原策略的 Blob 服务属性。 RestorePolicyProperties

ChangeFeed

名字 描述 价值
启用 指示是否为 Blob 服务启用了更改源事件日志记录。 bool
retentionInDays 指示 changeFeed 保留期（以天为单位）。 最小值为 1 天，最大值为 146000 天（400 年）。 null 值表示更改源的无限保留期。 int

约束：
最小值 = 1
最大值 = 146000

DeleteRetentionPolicy

名字 描述 价值
allowPermanentDelete 如果设置为 true，则此属性允许删除软删除的 Blob 版本和快照。 此属性不能使用 Blob 还原策略。 此属性仅适用于 Blob 服务，不适用于容器或文件共享。 bool
日 指示应保留已删除项的天数。 最小指定值可以是 1，最大值可以为 365。 int

约束：
最小值 = 1
最大值 = 365
启用 指示是否启用 DeleteRetentionPolicy。 bool

CorsRules

名字 描述 价值
corsRules CORS 规则列表。 请求中最多可以包含五个 CorsRule 元素。 CorsRule[]

CorsRule

名字 描述 价值
allowedHeaders 如果存在 CorsRule 元素，则为必需。 允许作为跨域请求的一部分的标头列表。 string[] （必需）
allowedMethods 如果存在 CorsRule 元素，则为必需。 源允许执行的 HTTP 方法的列表。 包含任一项的字符串数组：
“CONNECT”
“DELETE”
“GET”
“HEAD”
“MERGE”
“OPTIONS”
“PATCH”
“POST”
“PUT”
“TRACE”（必需）
allowedOrigins 如果存在 CorsRule 元素，则为必需。 将允许通过 CORS 或“*”允许所有域的源域列表 string[] （必需）
exposedHeaders 如果存在 CorsRule 元素，则为必需。 要向 CORS 客户端公开的响应标头列表。 string[] （必需）
maxAgeInSeconds 如果存在 CorsRule 元素，则为必需。 客户端/浏览器应缓存预检响应的秒数。 int （必需）

LastAccessTimeTrackingPolicy

名字 描述 价值
blobType 预定义支持的 Blob 类型的数组。 仅 blockBlob 是受支持的值。 此字段当前为只读 string[]
使 如果设置为 true，则启用基于上次访问时间的跟踪。 bool （必需）
名字 策略的名称。 有效值为 AccessTimeTracking。 此字段当前为只读 “AccessTimeTracking”
trackingGranularityInDays 该字段指定 Blob 对象跟踪粒度（以天为单位），通常应跟踪 Blob 对象的频率。此字段当前为 1 的只读 int

RestorePolicyProperties

名字 描述 价值
日 可以还原此 Blob 的时长。 它应大于零且小于 DeleteRetentionPolicy.days。 int

约束：
最小值 = 1
最大值 = 365
启用 如果设置为 true，则启用 Blob 还原。 bool （必需）