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 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' = {
  name: 'default'
  parent: resourceSymbolicName
  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

storageAccounts/blobServices

Nome Descrição Valor
name O nome do recurso

Veja como definir nomes e tipos para recursos filho no Bicep.
'default'
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
properties As propriedades dos serviços de arquivo na conta de armazenamento. FileServicePropertiesProperties

FileServicePropertiesProperties

Nome Descrição Valor
cors Especifica 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 compartilhar exclusão temporária. DeleteRetentionPolicy

CorsRules

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

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'
'OPTIONS'
'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 por meio do 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 simulação. int (obrigatório)

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 o delimitador ';'. string
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 o delimitador ';'. string
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 o delimitador ';' string
Multicanal Configuração multicanal. Aplica-se somente ao Arquivo PremiumStorage. 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 o delimitador ';'. string

Vários canais

Nome Descrição Valor
Habilitado Indica se o multicanal está habilitado bool

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 temporariamente. Essa propriedade não pode ser usada na política de restauração de blob. Essa propriedade só se aplica ao serviço blob e não se aplica a contêineres ou compartilhamento de arquivos. bool
dias Indica o número de dias que o item excluído deve ser retido. 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

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 – Armazenamento de VNet

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

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 das propriedades alteradas em cada versão da API, consulte 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": "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

storageAccounts/blobServices

Nome Descrição Valor
tipo O tipo de recurso 'Microsoft.Storage/storageAccounts/fileServices'
apiVersion A versão da API do recurso '2022-09-01'
name O nome do recurso

Veja como definir nomes e tipos para recursos filho em modelos do ARM JSON.
'default'
properties As propriedades dos serviços de arquivo na conta de armazenamento. FileServicePropertiesProperties

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

CorsRules

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

CorsRule

Nome Descrição Valor
allowedHeaders Obrigatório se o elemento CorsRule estiver presente. Uma lista de cabeçalhos com permissão 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'
'OPTIONS'
'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 simulação. int (obrigatório)

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 o delimitador ';'. string
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 o delimitador ';'. string
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 o delimitador ';' string
Multicanal Configuração multicanal. Aplica-se somente ao Arquivo PremiumStorage. 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 o delimitador ';'. string

Vários canais

Nome Descrição Valor
Habilitado Indica se o multicanal está habilitado bool

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 temporariamente. Essa propriedade não pode ser usada na política de restauração de blob. Essa propriedade só se aplica ao serviço blob e não se aplica a contêineres ou compartilhamento de arquivos. bool
dias Indica o número de dias que o item excluído deve ser retido. 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

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 – Armazenamento de VNet

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

Definição de recurso do Terraform (provedor 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 log de alterações.

Formato de recurso

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

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

storageAccounts/blobServices

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

FileServicePropertiesProperties

Nome Descrição Valor
cors Especifica 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 compartilhar exclusão temporária. DeleteRetentionPolicy

CorsRules

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

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 por meio do 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 simulação. int (obrigatório)

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 ';'. string
channelEncryption Criptografia de canal SMB compatível com o 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 ';'. string
kerberosTicketEncryption Criptografia de tíquete Kerberos compatível com o servidor. Os valores válidos são RC4-HMAC, AES-256. Deve ser passada como uma cadeia de caracteres com delimitador ';' string
Multicanal Configuração multicanal. Aplica-se somente a 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 ';'. string

Vários canais

Nome Descrição Valor
Habilitado Indica se o multicanal está habilitado bool

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 temporariamente. Essa propriedade não pode ser usada na política de restauração de blob. Essa propriedade se aplica apenas ao serviço 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 retido. 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