Compartilhar via


Microsoft.Storage storageAccounts/fileServices 2022-09-01

Definição de recurso do Bicep

O tipo de recurso storageAccounts/fileServices pode ser implantado com operações direcionadas:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte de log de alterações.

Formato de recurso

Para criar um recurso Microsoft.Storage/storageAccounts/fileServices, adicione o seguinte Bicep ao modelo.

resource symbolicname 'Microsoft.Storage/storageAccounts/fileServices@2022-09-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
    }
  }
}

Valores de propriedade

CorsRule

Nome Descrição Valor
allowedHeaders Obrigatório se o elemento CorsRule estiver presente. Uma lista de cabeçalhos permitidos para fazer parte da solicitação entre origens. string[] (obrigatório)
allowedMethods Obrigatório se o elemento CorsRule estiver presente. Uma lista de métodos HTTP que têm permissão para serem executados pela origem. Matriz de cadeia de caracteres que contém qualquer um dos:
'DELETE'
'GET'
'HEAD'
'MERGE'
'OPÇÕES'
'PATCH'
'POST'
'PUT' (obrigatório)
allowedOrigins Obrigatório se o elemento CorsRule estiver presente. Uma lista de domínios de origem que serão permitidos via CORS ou "*" para permitir todos os domínios string[] (obrigatório)
exposedHeaders Obrigatório se o elemento CorsRule estiver presente. Uma lista de cabeçalhos de resposta a serem expostos a clientes CORS. string[] (obrigatório)
maxAgeInSeconds Obrigatório se o elemento CorsRule estiver presente. O número de segundos que o cliente/navegador deve armazenar em cache uma resposta de pré-vôo. int (obrigatório)

CorsRules

Nome Descrição Valor
corsRules A lista de regras cors. Você pode incluir até cinco elementos CorsRule na solicitação. CorsRule[]

DeleteRetentionPolicy

Nome Descrição Valor
allowPermanentDelete Essa propriedade quando definida como true permite a exclusão das versões e instantâneos de blob excluídos suavemente. Essa propriedade não pode ser usada na política de restauração de blob. Essa propriedade só se aplica ao serviço de blob e não se aplica a contêineres ou compartilhamento de arquivos. Bool
Dias Indica o número de dias em que o item excluído deve ser mantido. O valor mínimo especificado pode ser 1 e o valor máximo pode ser 365. int

Restrições:
Valor mínimo = 1
Valor máximo = 365
Habilitado Indica se DeleteRetentionPolicy está habilitado. Bool

FileServicePropertiesProperties

Nome Descrição Valor
cors Especifica as regras cors para o serviço de arquivo. Você pode incluir até cinco elementos CorsRule na solicitação. Se nenhum elemento CorsRule estiver incluído no corpo da solicitação, todas as regras CORS serão excluídas e o CORS será desabilitado para o serviço Arquivo. CorsRules
protocolSettings Configurações de protocolo para o serviço de arquivo ProtocolSettings
shareDeleteRetentionPolicy As propriedades do serviço de arquivo para a exclusão reversível de compartilhamento. DeleteRetentionPolicy

Microsoft.Storage/storageAccounts/fileServices

Nome Descrição Valor
nome O nome do recurso 'default' (obrigatório)
pai No Bicep, você pode especificar o recurso pai para um recurso filho. Você só precisa adicionar essa propriedade quando o recurso filho é declarado fora do recurso pai.

Para obter mais informações, consulte recurso filho fora do recurso pai.
Nome simbólico para o recurso do tipo: storageAccounts
Propriedades As propriedades dos serviços de arquivo na conta de armazenamento. FileServicePropertiesProperties

Multicanal

Nome Descrição Valor
Habilitado Indica se o multichannel está habilitado Bool

ProtocolSettings

Nome Descrição Valor
Smb Configuração do protocolo SMB SmbSetting

SmbSetting

Nome Descrição Valor
authenticationMethods Métodos de autenticação SMB compatíveis com o servidor. Os valores válidos são NTLMv2, Kerberos. Deve ser passado como uma cadeia de caracteres com delimitador ';'. corda
channelEncryption Criptografia de canal SMB com suporte pelo servidor. Os valores válidos são AES-128-CCM, AES-128-GCM, AES-256-GCM. Deve ser passado como uma cadeia de caracteres com delimitador ';'. corda
kerberosTicketEncryption Criptografia de tíquete Kerberos compatível com o servidor. Os valores válidos são RC4-HMAC, AES-256. Deve ser passado como uma cadeia de caracteres com delimitador ';' corda
Multicanal Configuração multicanal. Aplica-se somente ao FileStorage Premium. multicanal
Versões Versões de protocolo SMB compatíveis com o servidor. Os valores válidos são SMB2.1, SMB3.0, SMB3.1.1. Deve ser passado como uma cadeia de caracteres com delimitador ';'. corda

Definição de recurso de modelo do ARM

O tipo de recurso storageAccounts/fileServices pode ser implantado com operações direcionadas:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte de log de alterações.

Formato de recurso

Para criar um recurso Microsoft.Storage/storageAccounts/fileServices, adicione o JSON a seguir ao modelo.

{
  "type": "Microsoft.Storage/storageAccounts/fileServices",
  "apiVersion": "2022-09-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"
    }
  }
}

Valores de propriedade

CorsRule

Nome Descrição Valor
allowedHeaders Obrigatório se o elemento CorsRule estiver presente. Uma lista de cabeçalhos permitidos para fazer parte da solicitação entre origens. string[] (obrigatório)
allowedMethods Obrigatório se o elemento CorsRule estiver presente. Uma lista de métodos HTTP que têm permissão para serem executados pela origem. Matriz de cadeia de caracteres que contém qualquer um dos:
'DELETE'
'GET'
'HEAD'
'MERGE'
'OPÇÕES'
'PATCH'
'POST'
'PUT' (obrigatório)
allowedOrigins Obrigatório se o elemento CorsRule estiver presente. Uma lista de domínios de origem que serão permitidos via CORS ou "*" para permitir todos os domínios string[] (obrigatório)
exposedHeaders Obrigatório se o elemento CorsRule estiver presente. Uma lista de cabeçalhos de resposta a serem expostos a clientes CORS. string[] (obrigatório)
maxAgeInSeconds Obrigatório se o elemento CorsRule estiver presente. O número de segundos que o cliente/navegador deve armazenar em cache uma resposta de pré-vôo. int (obrigatório)

CorsRules

Nome Descrição Valor
corsRules A lista de regras cors. Você pode incluir até cinco elementos CorsRule na solicitação. CorsRule[]

DeleteRetentionPolicy

Nome Descrição Valor
allowPermanentDelete Essa propriedade quando definida como true permite a exclusão das versões e instantâneos de blob excluídos suavemente. Essa propriedade não pode ser usada na política de restauração de blob. Essa propriedade só se aplica ao serviço de blob e não se aplica a contêineres ou compartilhamento de arquivos. Bool
Dias Indica o número de dias em que o item excluído deve ser mantido. O valor mínimo especificado pode ser 1 e o valor máximo pode ser 365. int

Restrições:
Valor mínimo = 1
Valor máximo = 365
Habilitado Indica se DeleteRetentionPolicy está habilitado. Bool

FileServicePropertiesProperties

Nome Descrição Valor
cors Especifica as regras cors para o serviço de arquivo. Você pode incluir até cinco elementos CorsRule na solicitação. Se nenhum elemento CorsRule estiver incluído no corpo da solicitação, todas as regras CORS serão excluídas e o CORS será desabilitado para o serviço Arquivo. CorsRules
protocolSettings Configurações de protocolo para o serviço de arquivo ProtocolSettings
shareDeleteRetentionPolicy As propriedades do serviço de arquivo para a exclusão reversível de compartilhamento. DeleteRetentionPolicy

Microsoft.Storage/storageAccounts/fileServices

Nome Descrição Valor
apiVersion A versão da API '2022-09-01'
nome O nome do recurso 'default' (obrigatório)
Propriedades As propriedades dos serviços de arquivo na conta de armazenamento. FileServicePropertiesProperties
tipo O tipo de recurso 'Microsoft.Storage/storageAccounts/fileServices'

Multicanal

Nome Descrição Valor
Habilitado Indica se o multichannel está habilitado Bool

ProtocolSettings

Nome Descrição Valor
Smb Configuração do protocolo SMB SmbSetting

SmbSetting

Nome Descrição Valor
authenticationMethods Métodos de autenticação SMB compatíveis com o servidor. Os valores válidos são NTLMv2, Kerberos. Deve ser passado como uma cadeia de caracteres com delimitador ';'. corda
channelEncryption Criptografia de canal SMB com suporte pelo servidor. Os valores válidos são AES-128-CCM, AES-128-GCM, AES-256-GCM. Deve ser passado como uma cadeia de caracteres com delimitador ';'. corda
kerberosTicketEncryption Criptografia de tíquete Kerberos compatível com o servidor. Os valores válidos são RC4-HMAC, AES-256. Deve ser passado como uma cadeia de caracteres com delimitador ';' corda
Multicanal Configuração multicanal. Aplica-se somente ao FileStorage Premium. multicanal
Versões Versões de protocolo SMB compatíveis com o servidor. Os valores válidos são SMB2.1, SMB3.0, SMB3.1.1. Deve ser passado como uma cadeia de caracteres com delimitador ';'. corda

Modelos de início rápido

Os modelos de início rápido a seguir implantam esse tipo de recurso.

Modelo Descrição
Azure Cloud Shell – de armazenamento de VNet

Implantar no Azure
Esse modelo implanta o armazenamento do Azure Cloud Shell em uma rede virtual do Azure.

Definição de recurso do Terraform (provedor de AzAPI)

O tipo de recurso storageAccounts/fileServices pode ser implantado com operações direcionadas:

  • grupos de recursos

Para obter uma lista de propriedades alteradas em cada versão da API, consulte de log de alterações.

Formato de recurso

Para criar um recurso Microsoft.Storage/storageAccounts/fileServices, adicione o Terraform a seguir ao seu modelo.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Storage/storageAccounts/fileServices@2022-09-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
      }
    }
  })
}

Valores de propriedade

CorsRule

Nome Descrição Valor
allowedHeaders Obrigatório se o elemento CorsRule estiver presente. Uma lista de cabeçalhos permitidos para fazer parte da solicitação entre origens. string[] (obrigatório)
allowedMethods Obrigatório se o elemento CorsRule estiver presente. Uma lista de métodos HTTP que têm permissão para serem executados pela origem. Matriz de cadeia de caracteres que contém qualquer um dos:
'DELETE'
'GET'
'HEAD'
'MERGE'
'OPÇÕES'
'PATCH'
'POST'
'PUT' (obrigatório)
allowedOrigins Obrigatório se o elemento CorsRule estiver presente. Uma lista de domínios de origem que serão permitidos via CORS ou "*" para permitir todos os domínios string[] (obrigatório)
exposedHeaders Obrigatório se o elemento CorsRule estiver presente. Uma lista de cabeçalhos de resposta a serem expostos a clientes CORS. string[] (obrigatório)
maxAgeInSeconds Obrigatório se o elemento CorsRule estiver presente. O número de segundos que o cliente/navegador deve armazenar em cache uma resposta de pré-vôo. int (obrigatório)

CorsRules

Nome Descrição Valor
corsRules A lista de regras cors. Você pode incluir até cinco elementos CorsRule na solicitação. CorsRule[]

DeleteRetentionPolicy

Nome Descrição Valor
allowPermanentDelete Essa propriedade quando definida como true permite a exclusão das versões e instantâneos de blob excluídos suavemente. Essa propriedade não pode ser usada na política de restauração de blob. Essa propriedade só se aplica ao serviço de blob e não se aplica a contêineres ou compartilhamento de arquivos. Bool
Dias Indica o número de dias em que o item excluído deve ser mantido. O valor mínimo especificado pode ser 1 e o valor máximo pode ser 365. int

Restrições:
Valor mínimo = 1
Valor máximo = 365
Habilitado Indica se DeleteRetentionPolicy está habilitado. Bool

FileServicePropertiesProperties

Nome Descrição Valor
cors Especifica as regras cors para o serviço de arquivo. Você pode incluir até cinco elementos CorsRule na solicitação. Se nenhum elemento CorsRule estiver incluído no corpo da solicitação, todas as regras CORS serão excluídas e o CORS será desabilitado para o serviço Arquivo. CorsRules
protocolSettings Configurações de protocolo para o serviço de arquivo ProtocolSettings
shareDeleteRetentionPolicy As propriedades do serviço de arquivo para a exclusão reversível de compartilhamento. DeleteRetentionPolicy

Microsoft.Storage/storageAccounts/fileServices

Nome Descrição Valor
nome O nome do recurso 'default' (obrigatório)
parent_id A ID do recurso que é o pai desse recurso. ID do recurso do tipo: storageAccounts
Propriedades As propriedades dos serviços de arquivo na conta de armazenamento. FileServicePropertiesProperties
tipo O tipo de recurso "Microsoft.Storage/storageAccounts/fileServices@2022-09-01"

Multicanal

Nome Descrição Valor
Habilitado Indica se o multichannel está habilitado Bool

ProtocolSettings

Nome Descrição Valor
Smb Configuração do protocolo SMB SmbSetting

SmbSetting

Nome Descrição Valor
authenticationMethods Métodos de autenticação SMB compatíveis com o servidor. Os valores válidos são NTLMv2, Kerberos. Deve ser passado como uma cadeia de caracteres com delimitador ';'. corda
channelEncryption Criptografia de canal SMB com suporte pelo servidor. Os valores válidos são AES-128-CCM, AES-128-GCM, AES-256-GCM. Deve ser passado como uma cadeia de caracteres com delimitador ';'. corda
kerberosTicketEncryption Criptografia de tíquete Kerberos compatível com o servidor. Os valores válidos são RC4-HMAC, AES-256. Deve ser passado como uma cadeia de caracteres com delimitador ';' corda
Multicanal Configuração multicanal. Aplica-se somente ao FileStorage Premium. multicanal
Versões Versões de protocolo SMB compatíveis com o servidor. Os valores válidos são SMB2.1, SMB3.0, SMB3.1.1. Deve ser passado como uma cadeia de caracteres com delimitador ';'. corda