Partager via


Microsoft.StorageAccounts/fileServices

Définition de ressource Bicep

Le type de ressource storageAccounts/fileServices peut être déployé avec des opérations qui ciblent :

Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.

Format des ressources

Pour créer une ressource Microsoft.Storage/storageAccounts/fileServices, ajoutez le Bicep suivant à votre modèle.

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
    }
  }
}

Valeurs de propriétés

storageAccounts/fileServices

Nom Description Valeur
name Nom de la ressource

Découvrez comment définir des noms et des types pour des ressources enfants dans Bicep.
'default'
parent Dans Bicep, vous pouvez spécifier la ressource parente pour une ressource enfant. Vous devez uniquement ajouter cette propriété lorsque la ressource enfant est déclarée en dehors de la ressource parente.

Pour plus d’informations, consultez Ressource enfant en dehors de la ressource parente.
Nom symbolique de la ressource de type : storageAccounts
properties Propriétés des services de fichiers dans le compte de stockage. FileServicePropertiesProperties

FileServicePropertiesProperties

Nom Description Valeur
cors Spécifie les règles CORS pour le service De fichiers. Incluez jusqu'à cinq éléments CorsRule dans la requête. Si aucun élément CorsRule n’est inclus dans le corps de la requête, toutes les règles CORS sont supprimées et CORS sont désactivées pour le service De fichiers. CorsRules
protocolSettings Paramètres de protocole pour le service de fichiers ProtocolSettings
shareDeleteRetentionPolicy Propriétés du service de fichiers pour la suppression réversible de partage. DeleteRetentionPolicy

CorsRules

Nom Description Valeur
corsRules Liste des règles CORS. Incluez jusqu'à cinq éléments CorsRule dans la requête. CorsRule[]

CorsRule

Nom Description Valeur
allowedHeaders Obligatoire si l'élément CorsRule est présent. Liste d’en-têtes autorisés à faire partie de la demande d’origine croisée. string[] (obligatoire)
allowedMethods Obligatoire si l'élément CorsRule est présent. Liste des méthodes HTTP autorisées à être exécutées par l’origine. Tableau de chaînes contenant l’un des éléments suivants :
'CONNECT'
'DELETE'
'GET'
'HEAD'
'MERGE'
'OPTIONS'
'PATCH'
'POST'
'PUT'
'TRACE' (obligatoire)
allowedOrigins Obligatoire si l'élément CorsRule est présent. Liste des domaines d’origine qui seront autorisés via CORS, ou « * » pour autoriser tous les domaines string[] (obligatoire)
exposedHeaders Obligatoire si l'élément CorsRule est présent. Liste d’en-têtes de réponse à exposer aux clients CORS. string[] (obligatoire)
maxAgeInSeconds Obligatoire si l'élément CorsRule est présent. Nombre de secondes pendant lesquelles le client/navigateur doit mettre en cache une réponse préliminaire. int (obligatoire)

ProtocolSettings

Nom Description Valeur
smb Paramètre pour le protocole SMB SmbSetting

SmbSetting

Nom Description Valeur
authenticationMethods Méthodes d’authentification SMB prises en charge par le serveur. Les valeurs valides sont NTLMv2, Kerberos. Doit être passé sous forme de chaîne avec le délimiteur ' ;'. string
channelEncryption Chiffrement de canal SMB pris en charge par le serveur. Les valeurs valides sont AES-128-CCM, AES-128-GCM, AES-256-GCM. Doit être passé sous forme de chaîne avec le délimiteur ' ;'. string
kerberosTicketEncryption Chiffrement de ticket Kerberos pris en charge par le serveur. Les valeurs valides sont RC4-HMAC, AES-256. Doit être passé sous forme de chaîne avec le délimiteur « ; » string
Multicanale Paramètre multicanal. S’applique uniquement à Premium FileStorage. Multicanal
versions Versions du protocole SMB prises en charge par le serveur. Les valeurs valides sont SMB2.1, SMB3.0, SMB3.1.1. Doit être passé sous forme de chaîne avec le délimiteur ' ;'. string

Multicanal

Nom Description Valeur
enabled Indique si le multicanal est activé bool

DeleteRetentionPolicy

Nom Description Valeur
allowPermanentDelete Cette propriété, lorsqu’elle est définie sur true, permet la suppression des versions et des instantanés d’objets blob supprimés de manière réversible. Cette propriété ne peut pas être utilisée stratégie de restauration d’objets blob. Cette propriété s’applique uniquement au service blob et ne s’applique pas aux conteneurs ou aux partages de fichiers. bool
jours Indique le nombre de jours pendant lesquels l’élément supprimé doit être conservé. La valeur minimale spécifiée peut être 1 et la valeur maximale peut être 365. int

Contraintes :
Valeur minimale = 1
Valeur maximale = 365
enabled Indique si DeleteRetentionPolicy est activé. bool

Modèles de démarrage rapide

Les modèles de démarrage rapide suivants déploient ce type de ressource.

Modèle Description
Azure Cloud Shell - Stockage de réseau virtuel

Déployer sur Azure
Ce modèle déploie le stockage Azure Cloud Shell dans un réseau virtuel Azure.

Définition de ressources de modèle ARM

Le type de ressource storageAccounts/fileServices peut être déployé avec des opérations qui ciblent :

Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.

Format des ressources

Pour créer une ressource Microsoft.Storage/storageAccounts/fileServices, ajoutez le CODE JSON suivant à votre modèle.

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

Valeurs de propriétés

storageAccounts/fileServices

Nom Description Valeur
type Type de ressource « Microsoft.Storage/storageAccounts/fileServices »
apiVersion Version de l’API de ressource '2023-01-01'
name Nom de la ressource

Découvrez comment définir des noms et des types pour des ressources enfants dans des modèles ARM JSON.
'default'
properties Propriétés des services de fichiers dans le compte de stockage. FileServicePropertiesProperties

FileServicePropertiesProperties

Nom Description Valeur
cors Spécifie les règles CORS pour le service De fichiers. Incluez jusqu'à cinq éléments CorsRule dans la requête. Si aucun élément CorsRule n’est inclus dans le corps de la requête, toutes les règles CORS sont supprimées et CORS sont désactivées pour le service De fichiers. CorsRules
protocolSettings Paramètres de protocole pour le service de fichiers ProtocolSettings
shareDeleteRetentionPolicy Propriétés du service de fichiers pour la suppression réversible de partage. DeleteRetentionPolicy

CorsRules

Nom Description Valeur
corsRules Liste des règles CORS. Incluez jusqu'à cinq éléments CorsRule dans la requête. CorsRule[]

CorsRule

Nom Description Valeur
allowedHeaders Obligatoire si l'élément CorsRule est présent. Liste des en-têtes autorisés à faire partie de la demande cross-origin. string[] (obligatoire)
allowedMethods Obligatoire si l'élément CorsRule est présent. Liste des méthodes HTTP autorisées à être exécutées par l’origine. Tableau de chaînes contenant l’un des éléments suivants :
'CONNECT'
'DELETE'
'GET'
'HEAD'
'MERGE'
'OPTIONS'
'PATCH'
'POST'
'PUT'
'TRACE' (obligatoire)
allowedOrigins Obligatoire si l'élément CorsRule est présent. Liste des domaines d’origine qui seront autorisés via CORS, ou « * » pour autoriser tous les domaines string[] (obligatoire)
exposedHeaders Obligatoire si l'élément CorsRule est présent. Liste d’en-têtes de réponse à exposer aux clients CORS. string[] (obligatoire)
maxAgeInSeconds Obligatoire si l'élément CorsRule est présent. Nombre de secondes pendant lesquelles le client/navigateur doit mettre en cache une réponse préliminaire. int (obligatoire)

ProtocolSettings

Nom Description Valeur
smb Définition du protocole SMB SmbSetting

SmbSetting

Nom Description Valeur
authenticationMethods Méthodes d’authentification SMB prises en charge par le serveur. Les valeurs valides sont NTLMv2, Kerberos. Doit être passé en tant que chaîne avec le délimiteur ' ;'. string
channelEncryption Chiffrement de canal SMB pris en charge par le serveur. Les valeurs valides sont AES-128-CCM, AES-128-GCM, AES-256-GCM. Doit être passé en tant que chaîne avec le délimiteur ' ;'. string
kerberosTicketEncryption Chiffrement de ticket Kerberos pris en charge par le serveur. Les valeurs valides sont RC4-HMAC, AES-256. Doit être passé en tant que chaîne avec le délimiteur ' ;' string
Multicanale Paramètre multicanal. S’applique uniquement à Premium FileStorage. Multicanal
versions Versions du protocole SMB prises en charge par le serveur. Les valeurs valides sont SMB2.1, SMB3.0, SMB3.1.1. Doit être passé en tant que chaîne avec le délimiteur ' ;'. string

Multicanal

Nom Description Valeur
enabled Indique si le multicanal est activé bool

DeleteRetentionPolicy

Nom Description Valeur
allowPermanentDelete Cette propriété, lorsqu’elle est définie sur true, permet la suppression des versions et instantanés des objets blob supprimés de manière réversible. Cette propriété ne peut pas être utilisée comme stratégie de restauration d’objets blob. Cette propriété s’applique uniquement au service blob et ne s’applique pas aux conteneurs ou aux partages de fichiers. bool
jours Indique le nombre de jours pendant lesquels l’élément supprimé doit être conservé. La valeur minimale spécifiée peut être 1 et la valeur maximale peut être 365. int

Contraintes :
Valeur minimale = 1
Valeur maximale = 365
enabled Indique si DeleteRetentionPolicy est activé. bool

Modèles de démarrage rapide

Les modèles de démarrage rapide suivants déploient ce type de ressource.

Modèle Description
Azure Cloud Shell - Stockage de réseau virtuel

Déployer sur Azure
Ce modèle déploie le stockage Azure Cloud Shell dans un réseau virtuel Azure.

Définition de ressource Terraform (fournisseur AzAPI)

Le type de ressource storageAccounts/fileServices peut être déployé avec des opérations qui ciblent :

  • Groupes de ressources

Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.

Format des ressources

Pour créer une ressource Microsoft.Storage/storageAccounts/fileServices, ajoutez le Terraform suivant à votre modèle.

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
      }
    }
  })
}

Valeurs de propriétés

storageAccounts/fileServices

Nom Description Valeur
type Type de ressource « Microsoft.Storage/storageAccounts/fileServices@2023-01-01 »
name Nom de la ressource « valeur par défaut »
parent_id ID de la ressource qui est le parent de cette ressource. ID de ressource de type : storageAccounts
properties Propriétés des services de fichiers dans le compte de stockage. FileServicePropertiesProperties

FileServicePropertiesProperties

Nom Description Valeur
cors Spécifie les règles CORS pour le service De fichiers. Incluez jusqu'à cinq éléments CorsRule dans la requête. Si aucun élément CorsRule n’est inclus dans le corps de la requête, toutes les règles CORS sont supprimées et CORS sont désactivées pour le service De fichiers. CorsRules
protocolSettings Paramètres de protocole pour le service de fichiers ProtocolSettings
shareDeleteRetentionPolicy Propriétés du service de fichiers pour la suppression réversible de partage. DeleteRetentionPolicy

CorsRules

Nom Description Valeur
corsRules Liste des règles CORS. Incluez jusqu'à cinq éléments CorsRule dans la requête. CorsRule[]

CorsRule

Nom Description Valeur
allowedHeaders Obligatoire si l'élément CorsRule est présent. Liste d’en-têtes autorisés à faire partie de la demande d’origine croisée. string[] (obligatoire)
allowedMethods Obligatoire si l'élément CorsRule est présent. Liste des méthodes HTTP autorisées à être exécutées par l’origine. Tableau de chaînes contenant l’un des éléments suivants :
« CONNECT »
« SUPPRIMER »
« OBTERNIR »
« HEAD »
« MERGE »
« OPTIONS »
« PATCH »
« POST »
« PUT »
« TRACE » (obligatoire)
allowedOrigins Obligatoire si l'élément CorsRule est présent. Liste des domaines d’origine qui seront autorisés via CORS, ou « * » pour autoriser tous les domaines string[] (obligatoire)
exposedHeaders Obligatoire si l'élément CorsRule est présent. Liste d’en-têtes de réponse à exposer aux clients CORS. string[] (obligatoire)
maxAgeInSeconds Obligatoire si l'élément CorsRule est présent. Nombre de secondes pendant lesquelles le client/navigateur doit mettre en cache une réponse préliminaire. int (obligatoire)

ProtocolSettings

Nom Description Valeur
smb Paramètre pour le protocole SMB SmbSetting

SmbSetting

Nom Description Valeur
authenticationMethods Méthodes d’authentification SMB prises en charge par le serveur. Les valeurs valides sont NTLMv2, Kerberos. Doit être passé en tant que chaîne avec le délimiteur ' ;'. string
channelEncryption Chiffrement de canal SMB pris en charge par le serveur. Les valeurs valides sont AES-128-CCM, AES-128-GCM, AES-256-GCM. Doit être passé en tant que chaîne avec le délimiteur ' ;'. string
kerberosTicketEncryption Chiffrement de ticket Kerberos pris en charge par le serveur. Les valeurs valides sont RC4-HMAC, AES-256. Doit être passé en tant que chaîne avec le délimiteur ' ;' string
Multicanale Paramètre multicanal. S’applique uniquement à Premium FileStorage. Multicanal
versions Versions du protocole SMB prises en charge par le serveur. Les valeurs valides sont SMB2.1, SMB3.0, SMB3.1.1. Doit être passé en tant que chaîne avec le délimiteur ' ;'. string

Multicanal

Nom Description Valeur
enabled Indique si le multicanal est activé bool

DeleteRetentionPolicy

Nom Description Valeur
allowPermanentDelete Cette propriété, lorsqu’elle est définie sur true, permet la suppression des versions et instantanés des objets blob supprimés de manière réversible. Cette propriété ne peut pas être utilisée comme stratégie de restauration d’objets blob. Cette propriété s’applique uniquement au service blob et ne s’applique pas aux conteneurs ou aux partages de fichiers. bool
jours Indique le nombre de jours pendant lesquels l’élément supprimé doit être conservé. La valeur minimale spécifiée peut être 1 et la valeur maximale peut être 365. int

Contraintes :
Valeur minimale = 1
Valeur maximale = 365
enabled Indique si DeleteRetentionPolicy est activé. bool