Microsoft.Storage storageAccounts/fileServices 2023-01-01

  • Artigo

Definição de recurso do Bicep

O tipo de recurso storageAccounts/fileServices pode ser implementado com operações que visam:

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

Formato do recurso

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

resource symbolicname 'Microsoft.Storage/storageAccounts/fileServices@2023-01-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/fileServices

Nome Descrição Valor
name O nome do recurso

Veja como definir nomes e tipos para recursos subordinados no Bicep.		 "predefinição"
principal No Bicep, pode especificar o recurso principal de um recurso subordinado. Só precisa de adicionar esta propriedade quando o recurso subordinado for declarado fora do recurso principal.

Para obter mais informações, veja Recurso subordinado fora do recurso principal.		 Nome simbólico para recurso do tipo: storageAccounts
propriedades As propriedades dos Serviços de ficheiros na conta de armazenamento. FileServicePropertiesProperties

FileServicePropertiesProperties

Nome Descrição Valor
cors Especifica regras CORS para o serviço Ficheiro. Pode incluir até cinco elementos CorsRule no pedido. Se não estiverem incluídos elementos CorsRule no corpo do pedido, todas as regras CORS serão eliminadas e o CORS será desativado para o serviço Ficheiro. CorsRules
protocolSettings Definições de protocolo para o serviço de ficheiros ProtocolSettings
shareDeleteRetentionPolicy As propriedades do serviço de ficheiros para partilhar a eliminação recuperável. DeleteRetentionPolicy

CorsRules

Nome Descrição Valor
corsRules A Lista de regras CORS. Pode incluir até cinco elementos CorsRule no pedido. CorsRule[]

CorsRule

Nome Descrição Valor
allowedHeaders Necessário se o elemento CorsRule estiver presente. Uma lista de cabeçalhos autorizados a fazer parte do pedido de origem cruzada. string[] (obrigatório)
allowedMethods Necessário se o elemento CorsRule estiver presente. Uma lista de métodos HTTP que podem ser executados pela origem. Matriz de cadeias que contém qualquer um dos seguintes:
"LIGAR"
"ELIMINAR"
'GET'
'CABEÇA'
"INTERCALAR"
"OPÇÕES"
'PATCH'
'POST'
'PUT'
"TRACE" (obrigatório)
allowedOrigins Necessário se o elemento CorsRule estiver presente. Uma lista de domínios de origem que serão permitidos através do CORS ou "*" para permitir todos os domínios string[] (obrigatório)
exposedHeaders Necessário se o elemento CorsRule estiver presente. Uma lista de cabeçalhos de resposta para expor aos clientes CORS. string[] (obrigatório)
maxAgeInSeconds Necessário se o elemento CorsRule estiver presente. O número de segundos que o cliente/browser deve colocar em cache uma resposta de pré-voo. int (obrigatório)

ProtocolSettings

Nome Descrição Valor
smb Definição do protocolo SMB SmbSetting

SmbSetting

Nome Descrição Valor
authenticationMethods Métodos de autenticação SMB suportados pelo servidor. Os valores válidos são NTLMv2, Kerberos. Deve ser transmitida como uma cadeia com o delimitador ";". string
channelEncryption Encriptação de canal SMB suportada pelo servidor. Os valores válidos são AES-128-CCM, AES-128-GCM, AES-256-GCM. Deve ser transmitida como uma cadeia com o delimitador ";". string
kerberosTicketEncryption Encriptação de pedidos Kerberos suportada pelo servidor. Os valores válidos são RC4-HMAC, AES-256. Deve ser transmitida como uma cadeia com delimitador ";" string
multicanal Definição multicanal. Aplica-se apenas a Ficheiros PremiumStorage. Multicanal
versões Versões do protocolo SMB suportadas pelo servidor. Os valores válidos são SMB2.1, SMB3.0, SMB3.1.1. Deve ser transmitida como uma cadeia com o delimitador ";". string

Multicanal

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

DeleteRetentionPolicy

Nome Descrição Valor
allowPermanentDelete Esta propriedade quando definida como verdadeiro permite a eliminação das versões e instantâneos de blobs eliminados de forma recuperável. Esta propriedade não pode ser utilizada na política de restauro de blobs. Esta propriedade aplica-se apenas ao serviço de blobs e não se aplica a contentores ou partilha de ficheiros. bool
dias Indica o número de dias em que o item eliminado 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
ativado Indica se DeleteRetentionPolicy está ativado. bool

Modelos de início rápido

Os seguintes modelos de início rápido implementam este tipo de recurso.

Modelo Description
Azure Cloud Shell - Armazenamento de VNet

Implementar no Azure		 Este modelo implementa o armazenamento Cloud Shell do Azure numa rede virtual do Azure.

Definição de recurso de modelo do ARM

O tipo de recurso storageAccounts/fileServices pode ser implementado com operações que visam:

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

Formato do recurso

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

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

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

Veja como definir nomes e tipos para recursos subordinados em modelos do ARM JSON.		 "predefinição"
propriedades As propriedades dos Serviços de ficheiros na conta de armazenamento. FileServicePropertiesProperties

FileServicePropertiesProperties

Nome Descrição Valor
cors Especifica regras CORS para o serviço Ficheiro. Pode incluir até cinco elementos CorsRule no pedido. Se não estiverem incluídos elementos CorsRule no corpo do pedido, todas as regras CORS serão eliminadas e o CORS será desativado para o serviço Ficheiro. CorsRules
protocolSettings Definições de protocolo para o serviço de ficheiros ProtocolSettings
shareDeleteRetentionPolicy As propriedades do serviço de ficheiros para partilhar a eliminação recuperável. DeleteRetentionPolicy

CorsRules

Nome Descrição Valor
corsRules A Lista de regras CORS. Pode incluir até cinco elementos CorsRule no pedido. CorsRule[]

CorsRule

Nome Descrição Valor
allowedHeaders Necessário se o elemento CorsRule estiver presente. Uma lista de cabeçalhos autorizados a fazer parte do pedido de origem cruzada. string[] (obrigatório)
allowedMethods Necessário se o elemento CorsRule estiver presente. Uma lista de métodos HTTP que podem ser executados pela origem. Matriz de cadeias que contém qualquer um dos seguintes:
"LIGAR"
"ELIMINAR"
'GET'
'CABEÇA'
"INTERCALAR"
"OPÇÕES"
'PATCH'
'POST'
'PUT'
"TRACE" (obrigatório)
allowedOrigins Necessário se o elemento CorsRule estiver presente. Uma lista de domínios de origem que serão permitidos através do CORS ou "*" para permitir todos os domínios string[] (obrigatório)
exposedHeaders Necessário se o elemento CorsRule estiver presente. Uma lista de cabeçalhos de resposta para expor aos clientes CORS. string[] (obrigatório)
maxAgeInSeconds Necessário se o elemento CorsRule estiver presente. O número de segundos que o cliente/browser deve colocar em cache uma resposta de pré-voo. int (obrigatório)

ProtocolSettings

Nome Descrição Valor
smb Definição do protocolo SMB SmbSetting

SmbSetting

Nome Descrição Valor
authenticationMethods Métodos de autenticação SMB suportados pelo servidor. Os valores válidos são NTLMv2, Kerberos. Deve ser transmitida como uma cadeia com o delimitador ";". string
channelEncryption Encriptação de canal SMB suportada pelo servidor. Os valores válidos são AES-128-CCM, AES-128-GCM, AES-256-GCM. Deve ser transmitida como uma cadeia com o delimitador ";". string
kerberosTicketEncryption Encriptação de pedidos Kerberos suportada pelo servidor. Os valores válidos são RC4-HMAC, AES-256. Deve ser transmitida como uma cadeia com delimitador ";" string
multicanal Definição multicanal. Aplica-se apenas a Ficheiros PremiumStorage. Multicanal
versões Versões do protocolo SMB suportadas pelo servidor. Os valores válidos são SMB2.1, SMB3.0, SMB3.1.1. Deve ser transmitida como uma cadeia com o delimitador ";". string

Multicanal

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

DeleteRetentionPolicy

Nome Descrição Valor
allowPermanentDelete Esta propriedade quando definida como verdadeiro permite a eliminação das versões e instantâneos de blobs eliminados de forma recuperável. Esta propriedade não pode ser utilizada na política de restauro de blobs. Esta propriedade aplica-se apenas ao serviço de blobs e não se aplica a contentores ou partilha de ficheiros. bool
dias Indica o número de dias em que o item eliminado 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
ativado Indica se DeleteRetentionPolicy está ativado. bool

Modelos de início rápido

Os seguintes modelos de início rápido implementam este tipo de recurso.

Modelo Description
Azure Cloud Shell - Armazenamento de VNet

Implementar no Azure		 Este modelo implementa o armazenamento Cloud Shell do Azure numa rede virtual do Azure.

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

O tipo de recurso storageAccounts/fileServices pode ser implementado com operações que visam:

  • Grupos de recursos

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

Formato do recurso

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Storage/storageAccounts/fileServices@2023-01-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/fileServices

Nome Descrição Valor
tipo O tipo de recurso "Microsoft.Storage/storageAccounts/fileServices@2023-01-01"
name O nome do recurso "predefinição"
parent_id O ID do recurso que é o principal para este recurso. ID do recurso do tipo: storageAccounts
propriedades As propriedades dos Serviços de ficheiros na conta de armazenamento. FileServicePropertiesProperties

FileServicePropertiesProperties

Nome Descrição Valor
cors Especifica regras CORS para o serviço Ficheiro. Pode incluir até cinco elementos CorsRule no pedido. Se não estiverem incluídos elementos CorsRule no corpo do pedido, todas as regras CORS serão eliminadas e o CORS será desativado para o serviço Ficheiro. CorsRules
protocolSettings Definições de protocolo para o serviço de ficheiros ProtocolSettings
shareDeleteRetentionPolicy As propriedades do serviço de ficheiros para partilhar a eliminação recuperável. DeleteRetentionPolicy

CorsRules

Nome Descrição Valor
corsRules A Lista de regras CORS. Pode incluir até cinco elementos CorsRule no pedido. CorsRule[]

CorsRule

Nome Descrição Valor
allowedHeaders Necessário se o elemento CorsRule estiver presente. Uma lista de cabeçalhos autorizados a fazer parte do pedido de origem cruzada. string[] (obrigatório)
allowedMethods Necessário se o elemento CorsRule estiver presente. Uma lista de métodos HTTP que podem ser executados pela origem. Matriz de cadeias que contém qualquer um dos seguintes:
"LIGAR"
"ELIMINAR"
"GET"
"CABEÇA"
"INTERCALAR"
"OPÇÕES"
"PATCH"
"POST"
"PUT"
"TRACE" (obrigatório)
allowedOrigins Necessário se o elemento CorsRule estiver presente. Uma lista de domínios de origem que serão permitidos através do CORS ou "*" para permitir todos os domínios string[] (obrigatório)
exposedHeaders Necessário se o elemento CorsRule estiver presente. Uma lista de cabeçalhos de resposta para expor aos clientes CORS. string[] (obrigatório)
maxAgeInSeconds Necessário se o elemento CorsRule estiver presente. O número de segundos que o cliente/browser deve colocar em cache uma resposta de pré-voo. int (obrigatório)

ProtocolSettings

Nome Descrição Valor
smb Definição do protocolo SMB SmbSetting

SmbSetting

Nome Descrição Valor
authenticationMethods Métodos de autenticação SMB suportados pelo servidor. Os valores válidos são NTLMv2, Kerberos. Deve ser transmitida como uma cadeia com o delimitador ';'. string
channelEncryption Encriptação de canal SMB suportada pelo servidor. Os valores válidos são AES-128-CCM, AES-128-GCM, AES-256-GCM. Deve ser transmitida como uma cadeia com o delimitador ';'. string
kerberosTicketEncryption Encriptação de pedidos Kerberos suportada pelo servidor. Os valores válidos são RC4-HMAC, AES-256. Deve ser transmitida como uma cadeia com delimitador ';' string
multicanal Definição multicanal. Aplica-se apenas a Ficheiros PremiumStorage. Multicanal
versões Versões do protocolo SMB suportadas pelo servidor. Os valores válidos são SMB2.1, SMB3.0, SMB3.1.1. Deve ser transmitida como uma cadeia com o delimitador ';'. string

Multicanal

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

DeleteRetentionPolicy

Nome Descrição Valor
allowPermanentDelete Esta propriedade quando definida como verdadeira permite a eliminação de versões e instantâneos de blobs eliminados de forma recuperável. Esta propriedade não pode ser utilizada na política de restauro de blobs. Esta propriedade aplica-se apenas ao serviço blob e não se aplica a contentores ou partilha de ficheiros. bool
dias Indica o número de dias em que o item eliminado 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
ativado Indica se DeleteRetentionPolicy está ativado. bool