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

Microsoft.Storage storageAccounts/fileServices 2023-01-01

Bicep 资源定义

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

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

资源格式

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

resource symbolicname 'Microsoft.Storage/storageAccounts/fileServices@2023-01-01' = {
  parent: resourceSymbolicName
  name: 'default'
  properties: {
    cors: {
      corsRules: [
        {
          allowedHeaders: [
            'string'
          ]
          allowedMethods: [
            'string'
          ]
          allowedOrigins: [
            'string'
          ]
          exposedHeaders: [
            'string'
          ]
          maxAgeInSeconds: int
        }
      ]
    }
    protocolSettings: {
      smb: {
        authenticationMethods: 'string'
        channelEncryption: 'string'
        kerberosTicketEncryption: 'string'
        multichannel: {
          enabled: bool
        }
        versions: 'string'
      }
    }
    shareDeleteRetentionPolicy: {
      allowPermanentDelete: bool
      days: int
      enabled: bool
    }
  }
}

属性值

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 (必需)

CorsRules

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

DeleteRetentionPolicy

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

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

FileServicePropertiesProperties

名字 描述 价值
cors 指定文件服务的 CORS 规则。 请求中最多可以包含五个 CorsRule 元素。 如果请求正文中不包含 CorsRule 元素,将删除所有 CORS 规则,并且将禁用文件服务的 CORS。 CorsRules
protocolSettings 文件服务的协议设置 ProtocolSettings
shareDeleteRetentionPolicy 共享软删除的文件服务属性。 DeleteRetentionPolicy

Microsoft.Storage/storageAccounts/fileServices

名字 描述 价值
名字 资源名称 “default”(必需)
父母 在 Bicep 中,可以为子资源指定父资源。 仅当子资源在父资源外部声明时,才需要添加此属性。

有关详细信息,请参阅 父资源外部的子资源
类型资源的符号名称:storageAccounts
性能 存储帐户中文件服务的属性。 FileServicePropertiesProperties

多通道

名字 描述 价值
启用 指示是否启用多通道 bool

ProtocolSettings

名字 描述 价值
smb SMB 协议的设置 SmbSetting

SmbSetting

名字 描述 价值
authenticationMethods 服务器支持的 SMB 身份验证方法。 有效值为 NTLMv2、Kerberos。 应作为带分隔符“;”的字符串传递。 字符串
channelEncryption 服务器支持的 SMB 通道加密。 有效值为 AES-128-CCM、AES-128-GCM、AES-256-GCM。 应作为带分隔符“;”的字符串传递。 字符串
kerberosTicketEncryption 服务器支持的 Kerberos 票证加密。 有效值为 RC4-HMAC、AES-256。 应作为带分隔符“;”的字符串传递 字符串
多通道 多通道设置。 仅适用于高级 FileStorage。 多通道
版本 服务器支持的 SMB 协议版本。 有效值为 SMB2.1、SMB3.0、SMB3.1.1。 应作为带分隔符“;”的字符串传递。 字符串

ARM 模板资源定义

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

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

资源格式

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

{
  "type": "Microsoft.Storage/storageAccounts/fileServices",
  "apiVersion": "2023-01-01",
  "name": "string",
  "properties": {
    "cors": {
      "corsRules": [
        {
          "allowedHeaders": [ "string" ],
          "allowedMethods": [ "string" ],
          "allowedOrigins": [ "string" ],
          "exposedHeaders": [ "string" ],
          "maxAgeInSeconds": "int"
        }
      ]
    },
    "protocolSettings": {
      "smb": {
        "authenticationMethods": "string",
        "channelEncryption": "string",
        "kerberosTicketEncryption": "string",
        "multichannel": {
          "enabled": "bool"
        },
        "versions": "string"
      }
    },
    "shareDeleteRetentionPolicy": {
      "allowPermanentDelete": "bool",
      "days": "int",
      "enabled": "bool"
    }
  }
}

属性值

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 (必需)

CorsRules

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

DeleteRetentionPolicy

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

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

FileServicePropertiesProperties

名字 描述 价值
cors 指定文件服务的 CORS 规则。 请求中最多可以包含五个 CorsRule 元素。 如果请求正文中不包含 CorsRule 元素,将删除所有 CORS 规则,并且将禁用文件服务的 CORS。 CorsRules
protocolSettings 文件服务的协议设置 ProtocolSettings
shareDeleteRetentionPolicy 共享软删除的文件服务属性。 DeleteRetentionPolicy

Microsoft.Storage/storageAccounts/fileServices

名字 描述 价值
apiVersion API 版本 '2023-01-01'
名字 资源名称 “default”(必需)
性能 存储帐户中文件服务的属性。 FileServicePropertiesProperties
类型 资源类型 “Microsoft.Storage/storageAccounts/fileServices”

多通道

名字 描述 价值
启用 指示是否启用多通道 bool

ProtocolSettings

名字 描述 价值
smb SMB 协议的设置 SmbSetting

SmbSetting

名字 描述 价值
authenticationMethods 服务器支持的 SMB 身份验证方法。 有效值为 NTLMv2、Kerberos。 应作为带分隔符“;”的字符串传递。 字符串
channelEncryption 服务器支持的 SMB 通道加密。 有效值为 AES-128-CCM、AES-128-GCM、AES-256-GCM。 应作为带分隔符“;”的字符串传递。 字符串
kerberosTicketEncryption 服务器支持的 Kerberos 票证加密。 有效值为 RC4-HMAC、AES-256。 应作为带分隔符“;”的字符串传递 字符串
多通道 多通道设置。 仅适用于高级 FileStorage。 多通道
版本 服务器支持的 SMB 协议版本。 有效值为 SMB2.1、SMB3.0、SMB3.1.1。 应作为带分隔符“;”的字符串传递。 字符串

快速入门模板

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

模板 描述
Azure Cloud Shell - VNet 存储

部署到 Azure
此模板将 Azure Cloud Shell 存储部署到 Azure 虚拟网络。

Terraform (AzAPI 提供程序)资源定义

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

  • 资源组

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

资源格式

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Storage/storageAccounts/fileServices@2023-01-01"
  name = "string"
  body = jsonencode({
    properties = {
      cors = {
        corsRules = [
          {
            allowedHeaders = [
              "string"
            ]
            allowedMethods = [
              "string"
            ]
            allowedOrigins = [
              "string"
            ]
            exposedHeaders = [
              "string"
            ]
            maxAgeInSeconds = int
          }
        ]
      }
      protocolSettings = {
        smb = {
          authenticationMethods = "string"
          channelEncryption = "string"
          kerberosTicketEncryption = "string"
          multichannel = {
            enabled = bool
          }
          versions = "string"
        }
      }
      shareDeleteRetentionPolicy = {
        allowPermanentDelete = bool
        days = int
        enabled = bool
      }
    }
  })
}

属性值

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 (必需)

CorsRules

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

DeleteRetentionPolicy

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

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

FileServicePropertiesProperties

名字 描述 价值
cors 指定文件服务的 CORS 规则。 请求中最多可以包含五个 CorsRule 元素。 如果请求正文中不包含 CorsRule 元素,将删除所有 CORS 规则,并且将禁用文件服务的 CORS。 CorsRules
protocolSettings 文件服务的协议设置 ProtocolSettings
shareDeleteRetentionPolicy 共享软删除的文件服务属性。 DeleteRetentionPolicy

Microsoft.Storage/storageAccounts/fileServices

名字 描述 价值
名字 资源名称 “default”(必需)
parent_id 此资源的父资源的 ID。 类型资源的 ID:storageAccounts
性能 存储帐户中文件服务的属性。 FileServicePropertiesProperties
类型 资源类型 “Microsoft.Storage/storageAccounts/fileServices@2023-01-01”

多通道

名字 描述 价值
启用 指示是否启用多通道 bool

ProtocolSettings

名字 描述 价值
smb SMB 协议的设置 SmbSetting

SmbSetting

名字 描述 价值
authenticationMethods 服务器支持的 SMB 身份验证方法。 有效值为 NTLMv2、Kerberos。 应作为带分隔符“;”的字符串传递。 字符串
channelEncryption 服务器支持的 SMB 通道加密。 有效值为 AES-128-CCM、AES-128-GCM、AES-256-GCM。 应作为带分隔符“;”的字符串传递。 字符串
kerberosTicketEncryption 服务器支持的 Kerberos 票证加密。 有效值为 RC4-HMAC、AES-256。 应作为带分隔符“;”的字符串传递 字符串
多通道 多通道设置。 仅适用于高级 FileStorage。 多通道
版本 服务器支持的 SMB 协议版本。 有效值为 SMB2.1、SMB3.0、SMB3.1.1。 应作为带分隔符“;”的字符串传递。 字符串