Microsoft.Storage storageAccounts/fileServices 2022-09-01

Artículo
12/09/2024

Definición de recursos de Bicep

El tipo de recurso storageAccounts/fileServices se puede implementar con operaciones destinadas a:

grupos de recursos: consulte comandos de implementación de grupos de recursos

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.Storage/storageAccounts/fileServices, agregue el siguiente bicep a la plantilla.

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 propiedad

CorsRule

Nombre	Descripción	Valor
allowedHeaders	Obligatorio si el elemento CorsRule está presente. Lista de encabezados que pueden formar parte de la solicitud entre orígenes.	string[] (obligatorio)
allowedMethods	Obligatorio si el elemento CorsRule está presente. Lista de métodos HTTP que el origen permite ejecutar.	Matriz de cadenas que contiene cualquiera de: 'DELETE' 'GET' 'HEAD' 'MERGE' 'OPTIONS' 'PATCH' 'POST' 'PUT' (obligatorio)
allowedOrigins	Obligatorio si el elemento CorsRule está presente. Una lista de dominios de origen que se permitirán a través de CORS o "*" para permitir todos los dominios	string[] (obligatorio)
exposedHeaders	Obligatorio si el elemento CorsRule está presente. Lista de encabezados de respuesta que se van a exponer a los clientes CORS.	string[] (obligatorio)
maxAgeInSeconds	Obligatorio si el elemento CorsRule está presente. Número de segundos que el cliente o explorador debe almacenar en caché una respuesta preparatoria.	int (obligatorio)

CorsRules

Nombre	Descripción	Valor
corsRules	Lista de reglas de CORS. Puede incluir hasta cinco elementos CorsRule en la solicitud.	corsRule[]

DeleteRetentionPolicy

Nombre	Descripción	Valor
allowPermanentDelete	Esta propiedad cuando se establece en true permite la eliminación de las versiones y instantáneas del blob eliminado temporalmente. Esta propiedad no se puede usar la directiva de restauración de blobs. Esta propiedad solo se aplica a Blob Service y no se aplica a contenedores o recursos compartidos de archivos.	Bool
Días	Indica el número de días que se debe conservar el elemento eliminado. El valor mínimo especificado puede ser 1 y el valor máximo puede ser 365.	Int Restricciones: Valor mínimo = 1 Valor máximo = 365
Habilitado	Indica si DeleteRetentionPolicy está habilitado.	Bool

FileServicePropertiesPropertiesProperties

Nombre	Descripción	Valor
cors	Especifica reglas CORS para el servicio File. Puede incluir hasta cinco elementos CorsRule en la solicitud. Si no se incluyen elementos CorsRule en el cuerpo de la solicitud, se eliminarán todas las reglas de CORS y CORS se deshabilitará para el servicio file.	corsRules
protocolSettings	Configuración del protocolo para el servicio de archivos	ProtocolSettings de
shareDeleteRetentionPolicy	Propiedades del servicio de archivos para la eliminación temporal del recurso compartido.	DeleteRetentionPolicy

Microsoft.Storage/storageAccounts/fileServices

Nombre	Descripción	Valor
nombre	El nombre del recurso	'default' (obligatorio)
padre	En Bicep, puede especificar el recurso primario para un recurso secundario. Solo tiene que agregar esta propiedad cuando el recurso secundario se declara fuera del recurso primario. Para obtener más información, consulte recurso secundario fuera del recurso primario.	Nombre simbólico del recurso de tipo: storageAccounts
Propiedades	Propiedades de servicios de archivos en la cuenta de almacenamiento.	FileServicePropertiesProperties

Multicanal

Nombre	Descripción	Valor
Habilitado	Indica si está habilitado multicanal.	Bool

ProtocolSettings

Nombre	Descripción	Valor
Smb	Configuración del protocolo SMB	SmbSetting

SmbSetting

Nombre	Descripción	Valor
authenticationMethods	Métodos de autenticación SMB admitidos por el servidor. Los valores válidos son NTLMv2, Kerberos. Debe pasarse como una cadena con el delimitador ';'.	cuerda
channelEncryption	Cifrado de canal SMB compatible con el servidor. Los valores válidos son AES-128-CCM, AES-128-GCM, AES-256-GCM. Debe pasarse como una cadena con el delimitador ';'.	cuerda
kerberosTicketEncryption	Cifrado de vales Kerberos compatible con el servidor. Los valores válidos son RC4-HMAC, AES-256. Debe pasarse como una cadena con el delimitador ';'	cuerda
multicanal	Configuración multicanal. Solo se aplica a FileStorage Premium.	multicanal
Versiones	Versiones del protocolo SMB compatibles con el servidor. Los valores válidos son SMB2.1, SMB3.0, SMB3.1.1. Debe pasarse como una cadena con el delimitador ';'.	cuerda

Definición de recursos de plantilla de ARM

El tipo de recurso storageAccounts/fileServices se puede implementar con operaciones destinadas a:

grupos de recursos: consulte comandos de implementación de grupos de recursos

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.Storage/storageAccounts/fileServices, agregue el siguiente json a la plantilla.

{
  "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 propiedad

CorsRule

Nombre	Descripción	Valor
allowedHeaders	Obligatorio si el elemento CorsRule está presente. Lista de encabezados que pueden formar parte de la solicitud entre orígenes.	string[] (obligatorio)
allowedMethods	Obligatorio si el elemento CorsRule está presente. Lista de métodos HTTP que el origen permite ejecutar.	Matriz de cadenas que contiene cualquiera de: 'DELETE' 'GET' 'HEAD' 'MERGE' 'OPTIONS' 'PATCH' 'POST' 'PUT' (obligatorio)
allowedOrigins	Obligatorio si el elemento CorsRule está presente. Una lista de dominios de origen que se permitirán a través de CORS o "*" para permitir todos los dominios	string[] (obligatorio)
exposedHeaders	Obligatorio si el elemento CorsRule está presente. Lista de encabezados de respuesta que se van a exponer a los clientes CORS.	string[] (obligatorio)
maxAgeInSeconds	Obligatorio si el elemento CorsRule está presente. Número de segundos que el cliente o explorador debe almacenar en caché una respuesta preparatoria.	int (obligatorio)

CorsRules

Nombre	Descripción	Valor
corsRules	Lista de reglas de CORS. Puede incluir hasta cinco elementos CorsRule en la solicitud.	corsRule[]

DeleteRetentionPolicy

Nombre	Descripción	Valor
allowPermanentDelete	Esta propiedad cuando se establece en true permite la eliminación de las versiones y instantáneas del blob eliminado temporalmente. Esta propiedad no se puede usar la directiva de restauración de blobs. Esta propiedad solo se aplica a Blob Service y no se aplica a contenedores o recursos compartidos de archivos.	Bool
Días	Indica el número de días que se debe conservar el elemento eliminado. El valor mínimo especificado puede ser 1 y el valor máximo puede ser 365.	Int Restricciones: Valor mínimo = 1 Valor máximo = 365
Habilitado	Indica si DeleteRetentionPolicy está habilitado.	Bool

FileServicePropertiesPropertiesProperties

Nombre	Descripción	Valor
cors	Especifica reglas CORS para el servicio File. Puede incluir hasta cinco elementos CorsRule en la solicitud. Si no se incluyen elementos CorsRule en el cuerpo de la solicitud, se eliminarán todas las reglas de CORS y CORS se deshabilitará para el servicio file.	corsRules
protocolSettings	Configuración del protocolo para el servicio de archivos	ProtocolSettings de
shareDeleteRetentionPolicy	Propiedades del servicio de archivos para la eliminación temporal del recurso compartido.	DeleteRetentionPolicy

Microsoft.Storage/storageAccounts/fileServices

Nombre	Descripción	Valor
apiVersion	La versión de api	'2022-09-01'
nombre	El nombre del recurso	'default' (obligatorio)
Propiedades	Propiedades de servicios de archivos en la cuenta de almacenamiento.	FileServicePropertiesProperties
tipo	El tipo de recurso	'Microsoft.Storage/storageAccounts/fileServices'

Multicanal

Nombre	Descripción	Valor
Habilitado	Indica si está habilitado multicanal.	Bool

ProtocolSettings

Nombre	Descripción	Valor
Smb	Configuración del protocolo SMB	SmbSetting

SmbSetting

Nombre	Descripción	Valor
authenticationMethods	Métodos de autenticación SMB admitidos por el servidor. Los valores válidos son NTLMv2, Kerberos. Debe pasarse como una cadena con el delimitador ';'.	cuerda
channelEncryption	Cifrado de canal SMB compatible con el servidor. Los valores válidos son AES-128-CCM, AES-128-GCM, AES-256-GCM. Debe pasarse como una cadena con el delimitador ';'.	cuerda
kerberosTicketEncryption	Cifrado de vales Kerberos compatible con el servidor. Los valores válidos son RC4-HMAC, AES-256. Debe pasarse como una cadena con el delimitador ';'	cuerda
multicanal	Configuración multicanal. Solo se aplica a FileStorage Premium.	multicanal
Versiones	Versiones del protocolo SMB compatibles con el servidor. Los valores válidos son SMB2.1, SMB3.0, SMB3.1.1. Debe pasarse como una cadena con el delimitador ';'.	cuerda

Plantillas de inicio rápido

Las siguientes plantillas de inicio rápido implementan este tipo de recurso.

Plantilla	Descripción
Azure Cloud Shell: de almacenamiento de red virtual	Esta plantilla implementa el almacenamiento de Azure Cloud Shell en una red virtual de Azure.

Definición de recursos de Terraform (proveedor AzAPI)

El tipo de recurso storageAccounts/fileServices se puede implementar con operaciones destinadas a:

grupos de recursos de

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.Storage/storageAccounts/fileServices, agregue el siguiente terraform a la plantilla.

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 propiedad

CorsRule

Nombre	Descripción	Valor
allowedHeaders	Obligatorio si el elemento CorsRule está presente. Lista de encabezados que pueden formar parte de la solicitud entre orígenes.	string[] (obligatorio)
allowedMethods	Obligatorio si el elemento CorsRule está presente. Lista de métodos HTTP que el origen permite ejecutar.	Matriz de cadenas que contiene cualquiera de: 'DELETE' 'GET' 'HEAD' 'MERGE' 'OPTIONS' 'PATCH' 'POST' 'PUT' (obligatorio)
allowedOrigins	Obligatorio si el elemento CorsRule está presente. Una lista de dominios de origen que se permitirán a través de CORS o "*" para permitir todos los dominios	string[] (obligatorio)
exposedHeaders	Obligatorio si el elemento CorsRule está presente. Lista de encabezados de respuesta que se van a exponer a los clientes CORS.	string[] (obligatorio)
maxAgeInSeconds	Obligatorio si el elemento CorsRule está presente. Número de segundos que el cliente o explorador debe almacenar en caché una respuesta preparatoria.	int (obligatorio)

CorsRules

Nombre	Descripción	Valor
corsRules	Lista de reglas de CORS. Puede incluir hasta cinco elementos CorsRule en la solicitud.	corsRule[]

DeleteRetentionPolicy

Nombre	Descripción	Valor
allowPermanentDelete	Esta propiedad cuando se establece en true permite la eliminación de las versiones y instantáneas del blob eliminado temporalmente. Esta propiedad no se puede usar la directiva de restauración de blobs. Esta propiedad solo se aplica a Blob Service y no se aplica a contenedores o recursos compartidos de archivos.	Bool
Días	Indica el número de días que se debe conservar el elemento eliminado. El valor mínimo especificado puede ser 1 y el valor máximo puede ser 365.	Int Restricciones: Valor mínimo = 1 Valor máximo = 365
Habilitado	Indica si DeleteRetentionPolicy está habilitado.	Bool

FileServicePropertiesPropertiesProperties

Nombre	Descripción	Valor
cors	Especifica reglas CORS para el servicio File. Puede incluir hasta cinco elementos CorsRule en la solicitud. Si no se incluyen elementos CorsRule en el cuerpo de la solicitud, se eliminarán todas las reglas de CORS y CORS se deshabilitará para el servicio file.	corsRules
protocolSettings	Configuración del protocolo para el servicio de archivos	ProtocolSettings de
shareDeleteRetentionPolicy	Propiedades del servicio de archivos para la eliminación temporal del recurso compartido.	DeleteRetentionPolicy

Microsoft.Storage/storageAccounts/fileServices

Nombre	Descripción	Valor
nombre	El nombre del recurso	'default' (obligatorio)
parent_id	Identificador del recurso que es el elemento primario de este recurso.	Identificador del recurso de tipo: storageAccounts
Propiedades	Propiedades de servicios de archivos en la cuenta de almacenamiento.	FileServicePropertiesProperties
tipo	El tipo de recurso	"Microsoft.Storage/storageAccounts/fileServices@2022-09-01"

Multicanal

Nombre	Descripción	Valor
Habilitado	Indica si está habilitado multicanal.	Bool

ProtocolSettings

Nombre	Descripción	Valor
Smb	Configuración del protocolo SMB	SmbSetting

SmbSetting

Nombre	Descripción	Valor
authenticationMethods	Métodos de autenticación SMB admitidos por el servidor. Los valores válidos son NTLMv2, Kerberos. Debe pasarse como una cadena con el delimitador ';'.	cuerda
channelEncryption	Cifrado de canal SMB compatible con el servidor. Los valores válidos son AES-128-CCM, AES-128-GCM, AES-256-GCM. Debe pasarse como una cadena con el delimitador ';'.	cuerda
kerberosTicketEncryption	Cifrado de vales Kerberos compatible con el servidor. Los valores válidos son RC4-HMAC, AES-256. Debe pasarse como una cadena con el delimitador ';'	cuerda
multicanal	Configuración multicanal. Solo se aplica a FileStorage Premium.	multicanal
Versiones	Versiones del protocolo SMB compatibles con el servidor. Los valores válidos son SMB2.1, SMB3.0, SMB3.1.1. Debe pasarse como una cadena con el delimitador ';'.	cuerda

Compartir a través de

Microsoft.Storage storageAccounts/fileServices 2022-09-01

Definición de recursos de Bicep

Formato de recurso

Valores de propiedad

CorsRule

CorsRules

DeleteRetentionPolicy

FileServicePropertiesPropertiesProperties

Microsoft.Storage/storageAccounts/fileServices

Multicanal

ProtocolSettings

SmbSetting

Definición de recursos de plantilla de ARM

Formato de recurso

Valores de propiedad

CorsRule

CorsRules

DeleteRetentionPolicy

FileServicePropertiesPropertiesProperties

Microsoft.Storage/storageAccounts/fileServices

Multicanal

ProtocolSettings

SmbSetting

Plantillas de inicio rápido

Definición de recursos de Terraform (proveedor AzAPI)

Formato de recurso

Valores de propiedad

CorsRule

CorsRules

DeleteRetentionPolicy

FileServicePropertiesPropertiesProperties

Microsoft.Storage/storageAccounts/fileServices

Multicanal

ProtocolSettings

SmbSetting

Comentarios

Recursos adicionales