通过

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

Microsoft.Storage StorageAccounts/fileServices

  • 项目

Bicep 资源定义

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

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

资源格式

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

resource symbolicname 'Microsoft.Storage/storageAccounts/fileServices@2023-05-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-05-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-05-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-05-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-05-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。 应作为带分隔符“;”的字符串传递。 字符串