Microsoft.Storage/storageAccounts/blobServices 2022-09-01 - Bicep, ARM template & Terraform AzAPI reference

Bicep 资源定义

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

资源组 - 请参阅资源组部署命令

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

资源格式

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

resource symbolicname 'Microsoft.Storage/storageAccounts/blobServices@2022-09-01' = {
  parent: resourceSymbolicName
  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: 'string'
      trackingGranularityInDays: int
    }
    restorePolicy: {
      days: int
      enabled: bool
    }
  }
}

属性值

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

CorsRule

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

CorsRules

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

DeleteRetentionPolicy

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

LastAccessTimeTrackingPolicy

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

Microsoft.Storage/storageAccounts/blobServices

名字	描述	价值
名字	资源名称	“default”（必需）
父母	在 Bicep 中，可以为子资源指定父资源。仅当子资源在父资源外部声明时，才需要添加此属性。有关详细信息，请参阅父资源外部的子资源。	类型资源的符号名称：storageAccounts
性能	存储帐户的 Blob 服务的属性。	BlobServicePropertiesProperties

RestorePolicyProperties

名字	描述	价值
日	可以还原此 Blob 的时长。它应大于零且小于 DeleteRetentionPolicy.days。	int 约束：最小值 = 1 最大值 = 365
启用	如果设置为 true，则启用 Blob 还原。	bool （必需）

快速入门示例

以下快速入门示例部署此资源类型。

Bicep 文件	描述
创建包含多个 Blob 容器的存储帐户	创建一个 Azure 存储帐户和多个 Blob 容器。
创建 V2 数据工厂	此模板创建一个 V2 数据工厂，用于将数据从 Azure Blob 存储中的文件夹复制到存储中的另一个文件夹。
创建 Azure 机器学习扫描作业	此模板创建用于超参数优化的 Azure 机器学习扫描作业。
在 Azure 上创建 Azure 存储帐户和 Blob 容器	此模板创建 Azure 存储帐户和 Blob 容器。
使用容器应用创建 Dapr 微服务应用	使用容器应用创建 Dapr 微服务应用。
使用容器应用创建 Dapr pub-sub servicebus 应用	使用容器应用创建 Dapr pub-sub servicebus 应用。
使用事件网格连接部署 Azure 数据资源管理器数据库	使用事件网格连接部署 Azure 数据资源管理器数据库。
使用托管虚拟网络部署安全 Azure AI Studio	此模板创建一个安全的 Azure AI Studio 环境，其中包含可靠的网络和标识安全限制。
FinOps 中心	此模板创建新的 FinOps 中心实例，包括 Data Lake 存储和数据工厂。
使用 SSE 和 blob 删除保留策略存储帐户	此模板使用存储服务加密和 Blob 删除保留策略创建存储帐户

ARM 模板资源定义

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

资源组 - 请参阅资源组部署命令

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

资源格式

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

{
  "type": "Microsoft.Storage/storageAccounts/blobServices",
  "apiVersion": "2022-09-01",
  "name": "string",
  "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": "string",
      "trackingGranularityInDays": "int"
    },
    "restorePolicy": {
      "days": "int",
      "enabled": "bool"
    }
  }
}

属性值

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

CorsRule

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

CorsRules

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

DeleteRetentionPolicy

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

LastAccessTimeTrackingPolicy

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

Microsoft.Storage/storageAccounts/blobServices

名字	描述	价值
apiVersion	API 版本	'2022-09-01'
名字	资源名称	“default”（必需）
性能	存储帐户的 Blob 服务的属性。	BlobServicePropertiesProperties
类型	资源类型	“Microsoft.Storage/storageAccounts/blobServices”

RestorePolicyProperties

名字	描述	价值
日	可以还原此 Blob 的时长。它应大于零且小于 DeleteRetentionPolicy.days。	int 约束：最小值 = 1 最大值 = 365
启用	如果设置为 true，则启用 Blob 还原。	bool （必需）

快速入门模板

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

模板	描述
Azure Cloud Shell - VNet 存储	此模板将 Azure Cloud Shell 存储部署到 Azure 虚拟网络。
创建包含多个 Blob 容器的存储帐户	创建一个 Azure 存储帐户和多个 Blob 容器。
创建 V2 数据工厂	此模板创建一个 V2 数据工厂，用于将数据从 Azure Blob 存储中的文件夹复制到存储中的另一个文件夹。
创建 Azure 机器学习扫描作业	此模板创建用于超参数优化的 Azure 机器学习扫描作业。
在 Azure 上创建 Azure 存储帐户和 Blob 容器	此模板创建 Azure 存储帐户和 Blob 容器。
使用容器应用创建 Dapr 微服务应用	使用容器应用创建 Dapr 微服务应用。
使用容器应用创建 Dapr pub-sub servicebus 应用	使用容器应用创建 Dapr pub-sub servicebus 应用。
使用事件网格连接部署 Azure 数据资源管理器数据库	使用事件网格连接部署 Azure 数据资源管理器数据库。
使用托管虚拟网络部署安全 Azure AI Studio	此模板创建一个安全的 Azure AI Studio 环境，其中包含可靠的网络和标识安全限制。
FinOps 中心	此模板创建新的 FinOps 中心实例，包括 Data Lake 存储和数据工厂。
使用 SSE 和 blob 删除保留策略存储帐户	此模板使用存储服务加密和 Blob 删除保留策略创建存储帐户

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

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

资源组

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

资源格式

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Storage/storageAccounts/blobServices@2022-09-01"
  name = "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 = "string"
        trackingGranularityInDays = int
      }
      restorePolicy = {
        days = int
        enabled = bool
      }
    }
  })
}

属性值

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

CorsRule

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

CorsRules

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

DeleteRetentionPolicy

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

LastAccessTimeTrackingPolicy

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

Microsoft.Storage/storageAccounts/blobServices

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

RestorePolicyProperties

名字	描述	价值
日	可以还原此 Blob 的时长。它应大于零且小于 DeleteRetentionPolicy.days。	int 约束：最小值 = 1 最大值 = 365
启用	如果设置为 true，则启用 Blob 还原。	bool （必需）

通过

Microsoft.Storage StorageAccounts/blobServices 2022-09-01

Bicep 资源定义

资源格式

属性值

BlobServicePropertiesProperties

ChangeFeed

CorsRule

CorsRules

DeleteRetentionPolicy

LastAccessTimeTrackingPolicy

Microsoft.Storage/storageAccounts/blobServices

RestorePolicyProperties

快速入门示例

ARM 模板资源定义

资源格式

属性值

BlobServicePropertiesProperties

ChangeFeed

CorsRule

CorsRules

DeleteRetentionPolicy

LastAccessTimeTrackingPolicy

Microsoft.Storage/storageAccounts/blobServices

RestorePolicyProperties

快速入门模板

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

资源格式

属性值

BlobServicePropertiesProperties

ChangeFeed

CorsRule

CorsRules

DeleteRetentionPolicy

LastAccessTimeTrackingPolicy

Microsoft.Storage/storageAccounts/blobServices

RestorePolicyProperties

反馈

其他资源