Microsoft.Storage storageAccounts/fileServices 2022-09-01
Definición de recursos de Bicep
El tipo de recurso storageAccounts/fileServices se puede implementar con operaciones destinadas a:
- Grupos de recursos: consulte los comandos de implementación del grupo de recursos.
Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.
Formato de los recursos
Para crear un recurso Microsoft.Storage/storageAccounts/fileServices, agregue el siguiente bicep a la plantilla.
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 propiedad
storageAccounts/fileServices
| Nombre | Descripción | Value |
|---|---|---|
| name | El nombre del recurso Vea cómo establecer nombres y tipos para recursos secundarios en Bicep. |
'default' |
| primario | 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 más información, consulte Recurso secundario fuera del recurso primario. |
Nombre simbólico del recurso de tipo: storageAccounts |
| properties | Propiedades de servicios de archivos en la cuenta de almacenamiento. | FileServicePropertiesPropertiesProperties |
FileServicePropertiesPropertiesProperties
| Nombre | Descripción | Valor |
|---|---|---|
| cors | Especifica las reglas de 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 de archivos. | CorsRules |
| protocolSettings | Configuración del protocolo para el servicio de archivos | ProtocolSettings |
| shareDeleteRetentionPolicy | Propiedades del servicio de archivos para la eliminación temporal de recursos compartidos. | DeleteRetentionPolicy |
CorsRules
| Nombre | Descripción | Valor |
|---|---|---|
| corsRules | La lista de reglas de CORS. Puede incluir hasta cinco elementos CorsRule en la solicitud. | CorsRule[] |
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 puede 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 durante los cuales el cliente/explorador debe almacenar en memoria caché una respuesta de comprobaciones preparatorias. | int (obligatorio) |
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 delimitador ';'. | string |
| 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 delimitador ';'. | string |
| kerberosTicketEncryption | Cifrado de vales Kerberos compatible con el servidor. Los valores válidos son RC4-HMAC, AES-256. Debe pasarse como una cadena con delimitador ';' | string |
| Multicanal | Configuración multicanal. Solo se aplica a FileStorage Premium. | Multicanal |
| versions | Versiones de protocolo SMB compatibles con el servidor. Los valores válidos son SMB2.1, SMB3.0, SMB3.1.1. Debe pasarse como una cadena con delimitador ';'. | string |
Multicanal
| Nombre | Descripción | Valor |
|---|---|---|
| enabled | Indica si está habilitado multicanal. | bool |
DeleteRetentionPolicy
| Nombre | Descripción | Valor |
|---|---|---|
| allowPermanentDelete | Esta propiedad cuando se establece en true permite eliminar las instantáneas y las versiones de blobs eliminadas 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 |
| days | 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 |
| enabled | Indica si DeleteRetentionPolicy está habilitado. | bool |
Plantillas de inicio rápido
Las siguientes plantillas de inicio rápido implementan este tipo de recurso.
| Plantilla | Descripción |
|---|---|
Azure Cloud Shell: almacenamiento de red virtual |
Esta plantilla implementa Azure Cloud Shell storage en una red virtual de Azure. |
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 los comandos de implementación del grupo de recursos.
Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.
Formato de los recursos
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": "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
storageAccounts/fileServices
| Nombre | Descripción | Value |
|---|---|---|
| type | Tipo de recurso | 'Microsoft.Storage/storageAccounts/fileServices' |
| apiVersion | La versión de la API de recursos | '2022-09-01' |
| name | El nombre del recurso Vea cómo establecer nombres y tipos para recursos secundarios en plantillas de ARM JSON. |
'default' |
| properties | Propiedades de servicios de archivos en la cuenta de almacenamiento. | FileServicePropertiesPropertiesProperties |
FileServicePropertiesPropertiesProperties
| Nombre | Descripción | Valor |
|---|---|---|
| cors | Especifica las reglas de 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 de archivos. | CorsRules |
| protocolSettings | Configuración del protocolo para el servicio de archivos | ProtocolSettings |
| shareDeleteRetentionPolicy | Propiedades del servicio de archivos para la eliminación temporal de recursos compartidos. | DeleteRetentionPolicy |
CorsRules
| Nombre | Descripción | Valor |
|---|---|---|
| corsRules | Lista de reglas de CORS. Puede incluir hasta cinco elementos CorsRule en la solicitud. | CorsRule[] |
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 puede 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. 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 de CORS. | string[] (obligatorio) |
| maxAgeInSeconds | Obligatorio si el elemento CorsRule está presente. Número de segundos durante los cuales el cliente/explorador debe almacenar en memoria caché una respuesta de comprobaciones preparatorias. | int (obligatorio) |
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. Se debe pasar como una cadena con el delimitador ';'. | string |
| channelEncryption | Cifrado de canal SMB compatible con el servidor. Los valores válidos son AES-128-CCM, AES-128-GCM, AES-256-GCM. Se debe pasar como una cadena con el delimitador ';'. | string |
| 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 ';' | string |
| Multicanal | Configuración multicanal. Solo se aplica a FileStorage Premium. | Multicanal |
| versions | Versiones de protocolo SMB compatibles con el servidor. Los valores válidos son SMB2.1, SMB3.0, SMB3.1.1. Se debe pasar como una cadena con el delimitador ';'. | string |
Multicanal
| Nombre | Descripción | Valor |
|---|---|---|
| enabled | Indica si está habilitado multicanal. | bool |
DeleteRetentionPolicy
| Nombre | Descripción | Valor |
|---|---|---|
| allowPermanentDelete | Esta propiedad cuando se establece en true permite eliminar 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 |
| days | 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 |
| enabled | Indica si DeleteRetentionPolicy está habilitado. | bool |
Plantillas de inicio rápido
Las siguientes plantillas de inicio rápido implementan este tipo de recurso.
| Plantilla | Descripción |
|---|---|
| Azure Cloud Shell: almacenamiento de red virtual |
Esta plantilla implementa Azure Cloud Shell storage en una red virtual de Azure. |
Definición de recursos de Terraform (proveedor AzAPI)
El tipo de recurso storageAccounts/fileServices se puede implementar con las operaciones que tienen como destino:
- Grupos de recursos
Para obtener una lista de las propiedades modificadas en cada versión de api, consulte registro de cambios.
Formato de los recursos
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 = "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 propiedad
storageAccounts/fileServices
| Nombre | Descripción | Value |
|---|---|---|
| type | Tipo de recurso | "Microsoft.Storage/storageAccounts/fileServices@2022-09-01" |
| name | El nombre del recurso | "predeterminado" |
| parent_id | Identificador del recurso que es el elemento primario de este recurso. | Identificador del recurso de tipo: storageAccounts |
| properties | Las propiedades de los servicios file en la cuenta de almacenamiento. | FileServicePropertiesPropertiesProperties |
FileServicePropertiesPropertiesProperties
| Nombre | Descripción | Valor |
|---|---|---|
| cors | Especifica las reglas de CORS para el servicio File. Puede incluir hasta cinco elementos CorsRule en la solicitud. Si no se incluye ningún elemento CorsRule en el cuerpo de la solicitud, se eliminarán todas las reglas de CORS y CORS se deshabilitará para el servicio de archivos. | CorsRules |
| protocolSettings | Configuración de protocolo para el servicio de archivos | ProtocolSettings |
| shareDeleteRetentionPolicy | Propiedades del servicio de archivos para la eliminación temporal de recursos compartidos. | DeleteRetentionPolicy |
CorsRules
| Nombre | Descripción | Valor |
|---|---|---|
| corsRules | Lista de reglas de CORS. Puede incluir hasta cinco elementos CorsRule en la solicitud. | CorsRule[] |
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 puede ejecutar. | Matriz de cadenas que contiene cualquiera de: "DELETE" "GET" "HEAD" "MERGE" "OPCIONES" "PATCH" "POST" "PUT" (obligatorio) |
| allowedOrigins | Obligatorio si el elemento CorsRule está presente. 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 de CORS. | string[] (obligatorio) |
| maxAgeInSeconds | Obligatorio si el elemento CorsRule está presente. Número de segundos durante los cuales el cliente/explorador debe almacenar en memoria caché una respuesta de comprobaciones preparatorias. | int (obligatorio) |
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. Se debe pasar como una cadena con el delimitador ';'. | string |
| channelEncryption | Cifrado de canal SMB compatible con el servidor. Los valores válidos son AES-128-CCM, AES-128-GCM, AES-256-GCM. Se debe pasar como una cadena con el delimitador ';'. | string |
| 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 ';' | string |
| Multicanal | Configuración multicanal. Solo se aplica a FileStorage Premium. | Multicanal |
| versions | Versiones de protocolo SMB compatibles con el servidor. Los valores válidos son SMB2.1, SMB3.0, SMB3.1.1. Se debe pasar como una cadena con el delimitador ';'. | string |
Multicanal
| Nombre | Descripción | Valor |
|---|---|---|
| enabled | Indica si está habilitado multicanal. | bool |
DeleteRetentionPolicy
| Nombre | Descripción | Valor |
|---|---|---|
| allowPermanentDelete | Esta propiedad cuando se establece en true permite eliminar 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 |
| days | 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 |
| enabled | Indica si DeleteRetentionPolicy está habilitado. | bool |
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de