Microsoft.StorageAccounts/fileServices

Article
02/15/2024

Définition de ressource Bicep

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

Groupes de ressources - Voir commandes de déploiement de 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 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	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 :

Groupes de ressources - Voir commandes de déploiement de 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 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	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

Partager via

Microsoft.StorageAccounts/fileServices

Définition de ressource Bicep

Format des ressources

Valeurs de propriétés

storageAccounts/fileServices

FileServicePropertiesProperties

CorsRules

CorsRule

ProtocolSettings

SmbSetting

Multicanal

DeleteRetentionPolicy

Modèles de démarrage rapide

Définition de ressources de modèle ARM

Format des ressources

Valeurs de propriétés

storageAccounts/fileServices

FileServicePropertiesProperties

CorsRules

CorsRule

ProtocolSettings

SmbSetting

Multicanal

DeleteRetentionPolicy

Modèles de démarrage rapide

Définition de ressource Terraform (fournisseur AzAPI)

Format des ressources

Valeurs de propriétés

storageAccounts/fileServices

FileServicePropertiesProperties

CorsRules

CorsRule

ProtocolSettings

SmbSetting

Multicanal

DeleteRetentionPolicy

Commentaires

Ressources supplémentaires