Définir les propriétés du service de fichiers

L’opération Set File Service Properties définit les propriétés de la ressource de service de fichiers à l’aide de l’API FileREST. Bien que cette API soit entièrement prise en charge, il s’agit d’une API de gestion héritée. Nous vous recommandons d’utiliser plutôt les services de fichiers - Définir les propriétés du service, qui sont fournies par le fournisseur de ressources stockage Azure (Microsoft.Storage). Pour en savoir plus sur l’interaction programmatique avec la ressource de service de fichiers à l’aide du fournisseur de ressources Stockage Azure, consultez Opérations sur le service De fichiers.

Disponibilité du protocole

Protocole de partage de fichiers activé	Disponible
PME
Système de fichiers en réseau (NFS)

Requête

Vous pouvez spécifier la Set File Service Properties demande comme suit. Nous vous recommandons d’utiliser HTTPS. Remplacez le nom du compte par le nom de votre compte de stockage :

Méthode	URI de la requête	Version HTTP
METTRE	https://account-name.file.core.windows.net/?restype=service&comp=properties	HTTP/1.1

Remarque

L’URI doit toujours inclure un caractère de barre oblique (/) pour séparer le nom d’hôte du chemin d’accès et des parties de requête de l’URI. Dans cette opération, la partie chemin d’accès de l’URI est vide.

Paramètres d’URI

Paramètre d’URI	Descriptif
restype=service&comp=properties	Obligatoire. La combinaison des deux chaînes de requête est requise pour définir les propriétés du service de stockage.
timeout	Optionnel. Le paramètre timeout est exprimé en secondes. Pour plus d’informations, consultez Définir des délais d’attente pour les opérations de service de fichiers.

En-têtes de requête

Les en-têtes de requête obligatoires et facultatifs sont décrits dans le tableau suivant :

En-tête de requête	Descriptif
Authorization	Obligatoire. Spécifie le schéma d’autorisation, le nom du compte de stockage et la signature. Pour plus d’informations, consultez Autoriser les demandes vers le stockage Azure.
Date or x-ms-date	Obligatoire. Spécifie le temps universel coordonné (UTC) de la requête. Pour plus d’informations, consultez Autoriser les demandes vers le stockage Azure.
x-ms-version	Obligatoire pour toutes les demandes autorisées. Spécifie la version de l’opération à utiliser pour cette requête. Cette opération est disponible uniquement dans la version 2015-02-21 et ultérieure. Pour activer les métriques pour le service de fichiers, vous devez spécifier la version 2015-04-05 ou ultérieure. Pour plus d'informations, consultez la page Contrôle de version pour les services de Stockage Microsoft Azure.
x-ms-client-request-id	Optionnel. Fournit une valeur opaque générée par le client avec une limite de caractères de 1 kibioctet (KiB) enregistrée dans les journaux Storage Analytics lors de la configuration de la journalisation. Nous vous recommandons vivement d’utiliser cet en-tête pour mettre en corrélation les activités côté client avec les demandes reçues par le serveur. Pour plus d'informations, consultez la section Superviser Azure Files.

Corps de la requête

Le format du corps de la demande pour la version 2026-02-06 est le suivant :

<?xml version="1.0" encoding="utf-8"?>  
<StorageServiceProperties>  
    <HourMetrics>  
        <Version>version-number</Version>  
        <Enabled>true|false</Enabled>  
        <IncludeAPIs>true|false</IncludeAPIs>  
        <RetentionPolicy>  
            <Enabled>true|false</Enabled>  
            <Days>number-of-days</Days>  
        </RetentionPolicy>  
    </HourMetrics>  
    <MinuteMetrics>  
        <Version>version-number</Version>  
        <Enabled>true|false</Enabled>  
        <IncludeAPIs>true|false</IncludeAPIs>  
        <RetentionPolicy>  
            <Enabled>true|false</Enabled>  
            <Days>number-of-days</Days>  
        </RetentionPolicy>  
    </MinuteMetrics>  
    <Cors>  
        <CorsRule>  
            <AllowedOrigins>comma-separated-list-of-allowed-origins</AllowedOrigins>  
            <AllowedMethods>comma-separated-list-of-HTTP-verb</AllowedMethods>  
            <MaxAgeInSeconds>max-caching-age-in-seconds</MaxAgeInSeconds>  
            <ExposedHeaders>comma-separated-list-of-response-headers</ExposedHeaders>  
            <AllowedHeaders>comma-separated-list-of-request-headers</AllowedHeaders>  
        </CorsRule>  
    </Cors>    
    <ShareDeleteRetentionPolicy>
        <Enabled>true|false</Enabled>
        <Days>integer-value</Days>
    </ShareDeleteRetentionPolicy>
    <ProtocolSettings>
        <SMB>
            <Multichannel>
                <Enabled>true|false</Enabled>
            </Multichannel>
            <Versions>semicolon-separated-list-of-smb-versions</Versions>
            <AuthenticationMethods>semicolon-separated-list-of-auth-methods</AuthenticationMethod>
            <KerberosTicketEncryption>semicolon-separated-list-of-kerberos-encryption-algorithms</KerberosTicketEncryption>
            <ChannelEncryption>semicolon-separated-list-of-smb-channel-encryption-algorithms</ChannelEncryption>
            <EncryptionInTransit>
                <Required>true|false</Required>
            </EncryptionInTransit>
        </SMB>
        <NFS>
            <EncryptionInTransit>
                <Required>true|false</Required>
            </EncryptionInTransit>
        </NFS>
    </ProtocolSettings>
</StorageServiceProperties>  
  

Il n’est pas nécessaire de spécifier chaque élément racine sur la demande. Si vous omettez un élément racine, les paramètres existants du service pour cette fonctionnalité sont conservés. Toutefois, si vous spécifiez un élément racine spécifique, vous devez spécifier chaque élément enfant pour cet élément. Les éléments racines sont les suivants :

• HourMetrics
• MinuteMetrics
• Cors
• ProtocolSettings

Les éléments du corps de la requête sont décrits dans le tableau suivant :

Nom	Descriptif
HourMetrics	Facultatif pour la version 2015-04-05 et ultérieure. Non applicable pour les versions antérieures. Regroupe les paramètres Storage Analytics HourMetrics , qui fournissent un résumé des statistiques de requête regroupées par API en agrégats horaires.
MinuteMetrics	Facultatif pour la version 2015-04-05 et ultérieure. Non applicable pour les versions antérieures. Regroupe les paramètres Storage Analytics MinuteMetrics , qui fournissent des statistiques de requête pour chaque minute.
Version	Obligatoire si les métriques sont activées. Version de Storage Analytics à configurer. Utilisez 1.0 cette valeur.
Enabled	Obligatoire. Indique si les métriques sont activées pour le service de fichiers.
IncludeAPIs	Obligatoire uniquement si les métriques sont activées. Indique si les métriques doivent générer des statistiques récapitulatives pour les opérations d’API appelées.
RetentionPolicy/Enabled	Obligatoire. Indique si une stratégie de rétention est activée pour le service de fichiers. Si la valeur est false, les données de métriques sont conservées et l’utilisateur est responsable de sa suppression.
RetentionPolicy/Days	Obligatoire uniquement si une stratégie de rétention est activée. Indique le nombre de jours pendant lesquels les données de métriques doivent être conservées. Toutes les données antérieures à cette valeur sont supprimées. La valeur minimale que vous pouvez spécifier est 1, et la valeur maximale est 365 (un an). Les données de métriques sont supprimées au mieux après l’expiration de la période de rétention.
Cors	Optionnel. L’élément Cors est pris en charge pour la version 2015-02-21 et ultérieure. Regroupe toutes les règles CORS (Cross-Origin Resource Sharing). L’omission de ce groupe d’éléments ne remplace pas les paramètres CORS existants.
CorsRule	Optionnel. Spécifie une règle CORS pour le service de fichiers. Vous pouvez inclure jusqu’à cinq CorsRule éléments dans la requête. Si aucun élément n’est CorsRule inclus dans le corps de la requête, toutes les règles CORS sont supprimées et CORS est désactivé pour le service de fichiers.
AllowedOrigins	Obligatoire si l’élément CorsRule est présent. Liste séparée par des virgules de domaines d’origine autorisés via CORS ou « * » pour autoriser tous les domaines. Un domaine d’origine peut également inclure un caractère générique dans le sous-domaine pour autoriser les demandes via CORS pour tous les sous-domaines d’un domaine. Limité à 64 domaines d’origine. Chaque origine autorisée peut comporter jusqu’à 256 caractères.
ExposedHeaders	Obligatoire si l’élément CorsRule est présent. Liste séparée par des virgules d’en-têtes de réponse à exposer aux clients CORS. Limité à 64 en-têtes définis et deux en-têtes préfixés. Chaque en-tête peut contenir jusqu’à 256 caractères.
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.
AllowedHeaders	Obligatoire si l’élément CorsRule existe. Liste séparée par des virgules d’en-têtes qui sont autorisés à faire partie de la demande d’origine croisée. Limité à 64 en-têtes définis et à 2 en-têtes préfixés. Chaque en-tête peut contenir jusqu’à 256 caractères.
AllowedMethods	Obligatoire si CorsRule l’élément existe. Liste séparée par des virgules des méthodes HTTP autorisées à être exécutées par l’origine. Pour Azure Files, les méthodes autorisées sont DELETE, , GETHEAD, MERGE, POST, , OPTIONSet PUT.
ShareDeleteRetentionPolicy	Optionnel. Propriétés de suppression réversible pour les partages de fichiers Azure dans ce compte de stockage.
Days	Optionnel. Indique le nombre de jours pendant lesquels le partage de fichiers Azure doit être conservé (supprimé de manière réversible). La valeur minimale que vous pouvez spécifier est 1, et la valeur maximale est 365 (un an).
Enabled	Optionnel. Indique si la suppression réversible du compte de stockage est activée pour Azure Files.
ProtocolSettings	Optionnel. Regroupe les paramètres des protocoles de système de fichiers.
SMB	Optionnel. Regroupe les paramètres de SMB.
Multichannel	Optionnel. Contient les paramètres de SMB multicanal. SMB multichannel contient la Enabled propriété booléenne, qui bascule l’état de SMB multicanal.
Versions	Facultatif à partir de la version 2020-04-08. Liste séparée par des points-virgules des versions SMB autorisées. Les valeurs autorisées sont SMB2.1, SMB3.0 et SMB3.1.1.
AuthenticationMethods	Facultatif à partir de la version 2020-04-08. Liste séparée par des points-virgules des méthodes d’authentification autorisées. Les valeurs autorisées sont NTLMv2 et Kerberos.
KerberosTicketEncryption	Facultatif à partir de la version 2020-04-08. Liste séparée par des points-virgules des algorithmes de chiffrement de ticket Kerberos autorisés. Les valeurs autorisées sont RC4-HMAC et AES-256.
ChannelEncryption	Facultatif à partir de la version 2020-04-08. Liste séparée par des points-virgules des algorithmes de chiffrement de canal SMB autorisés. Les valeurs autorisées sont AES-128-CCM, AES-128-GCM et AES-256-GCM.
NFS	Optionnel à partir de la version 2026-02-06. Regroupe les paramètres pour NFS.
EncryptionInTransit	Optionnel à partir de la version 2026-02-06. Contient les paramètres pour le chiffrement SMB et NFS en transit. Le chiffrement SMB & NFS en transit contient la Required propriété booléenne, qui bascule l’exigence de chiffrement SMB & NFS en transit. Le chiffrement NFS en transit est autorisé uniquement pour les comptes de stockage premium.

Réponse

La réponse inclut un code d’état HTTP et un ensemble d’en-têtes de réponse.

Code de statut

Une opération réussie retourne le code d’état 202 (accepté).

En-têtes de réponse

La réponse de cette opération inclut les en-têtes suivants. La réponse peut également inclure des en-têtes HTTP standard supplémentaires. Tous les en-têtes standard sont conformes à la spécification de protocole HTTP/1.1.

En-tête de réponse	Descriptif
x-ms-request-id	Valeur qui identifie de façon unique une requête effectuée sur le service.
x-ms-version	Spécifie la version de l’opération utilisée pour la réponse. Pour plus d'informations, consultez la page Contrôle de version pour les services de Stockage Microsoft Azure.
x-ms-client-request-id	Peut être utilisé pour résoudre les demandes et les réponses correspondantes. La valeur de l’en-tête est égale à la valeur de l’en-tête x-ms-client-request-id si elle est présente dans la requête et que la valeur ne contient pas plus de 1 024 caractères ASCII visibles. Si l’en-tête x-ms-client-request-id n’est pas présent dans la requête, il ne sera pas présent dans la réponse.

Corps de réponse

Aucun.

Autorisation

Seul le propriétaire du compte peut appeler cette opération.

Remarques

Les restrictions et limitations suivantes s’appliquent aux règles CORS dans Azure Files :

• Un maximum de cinq règles peuvent être stockées.

• La taille maximale de tous les paramètres de règles CORS sur la demande, à l’exclusion des balises XML, ne doit pas dépasser 2 Kib.

• La longueur d’un en-tête autorisé, d’un en-tête exposé ou d’origine autorisée ne doit pas dépasser 256 caractères.

• Les en-têtes autorisés et les en-têtes exposés peuvent être l’un des éléments suivants :

  • En-têtes littérals, où le nom d’en-tête exact est fourni, par x-ms-meta-processedexemple . Un maximum de 64 en-têtes littéraux peut être spécifié sur la demande.

  • En-têtes préfixés, où un préfixe de l’en-tête est fourni, tel que x-ms-meta-data*. La spécification d’un préfixe de cette façon autorise ou expose tout en-tête commençant par ce préfixe. Un maximum de deux en-têtes préfixés peut être spécifié sur la demande.

• Les méthodes (ou verbes HTTP) spécifiées dans l’élément AllowedMethods doivent être conformes aux méthodes prises en charge par les API du service de stockage Azure. Les méthodes prises en charge sont DELETE, , GETHEAD, MERGEPOST, OPTIONS, et PUT.

La spécification de règles CORS sur la demande est facultative. Si vous appelez Set File Service Properties sans spécifier l’élément CORS dans le corps de la demande, toutes les règles CORS existantes sont conservées.

Pour désactiver CORS, appelez Set File Service Properties avec un paramètre de règles CORS vide (autrement dit) </Cors>et aucune règle CORS interne. Cet appel supprime toutes les règles existantes et désactive CORS pour le service de fichiers.

Tous les éléments de règle CORS sont requis si l’élément CorsRule est spécifié. La requête échoue avec le code d’erreur 400 (Requête incorrecte) si un élément est manquant.

Pour plus d’informations sur les règles CORS et la logique d’évaluation, consultez la prise en charge du partage de ressources cross-origin pour les services stockage Azure.

Exemple de requête et de réponse

L’exemple d’URI suivant effectue une demande de modification des propriétés du service de fichiers pour un compte de stockage nommé myaccount :

PUT https://myaccount.file.core.windows.net/?restype=service&comp=properties HTTP/1.1

La demande est envoyée avec les en-têtes suivants :

x-ms-version: 2026-02-06  
x-ms-date: <date>  
Authorization: SharedKey myaccount:Z1lTLDwtq5o1UYQluucdsXk6/iB7YxEu0m6VofAEkUE=  
Host: myaccount.file.core.windows.net  

La requête est envoyée avec le corps XML suivant :

<?xml version="1.0" encoding="utf-8"?>  
<StorageServiceProperties>  
    <HourMetrics>  
        <Version>1.0</Version>  
        <Enabled>true</Enabled>  
        <IncludeAPIs>false</IncludeAPIs>  
        <RetentionPolicy>  
            <Enabled>true</Enabled>  
            <Days>7</Days>  
        </RetentionPolicy>  
    </HourMetrics>  
    <MinuteMetrics>  
        <Version>1.0</Version>  
        <Enabled>true</Enabled>  
        <IncludeAPIs>true</IncludeAPIs>  
        <RetentionPolicy>  
            <Enabled>true</Enabled>  
            <Days>7</Days>  
        </RetentionPolicy>  
    </MinuteMetrics>  
    <Cors>  
        <CorsRule>  
            <AllowedOrigins>http://www.fabrikam.com,http://www.contoso.com</AllowedOrigins>  
            <AllowedMethods>GET,PUT</AllowedMethods>  
            <MaxAgeInSeconds>500</MaxAgeInSeconds>  
            <ExposedHeaders>x-ms-meta-data*,x-ms-meta-customheader</ExposedHeaders>  
            <AllowedHeaders>x-ms-meta-target*,x-ms-meta-customheader</AllowedHeaders>  
        </CorsRule>  
    </Cors>
    <ShareDeleteRetentionPolicy>
        <Enabled>true</Enabled>
        <Days>7</Days>
    </ShareDeleteRetentionPolicy>
    <ProtocolSettings>
        <SMB>
            <Multichannel>
                <Enabled>true</Enabled>
            </Multichannel>
            <Versions>SMB3.1.1</Versions>
            <AuthenticationMethods>Kerberos</AuthenticationMethods>
            <KerberosTicketEncryption>AES-256</KerberosTicketEncryption>
            <ChannelEncryption>AES-256-GCM</ChannelEncryption>
            <EncryptionInTransit>
                <Required>true</Required>
            </EncryptionInTransit>
        </SMB>
        <NFS>
            <EncryptionInTransit>
                <Required>true</Required>
            </EncryptionInTransit>
        </NFS>
    </ProtocolSettings>
</StorageServiceProperties>  

Une fois la demande envoyée, la réponse suivante est retournée :

HTTP/1.1 202 Accepted  
Connection: Keep-Alive  
Transfer-Encoding: chunked  
Date: <date>  
Server: Windows-Azure-File/1.0 Microsoft-HTTPAPI/2.0  
x-ms-request-id: cb939a31-0cc6-49bb-9fe5-3327691f2a30  
x-ms-version: 2026-02-06  

Voir aussi

Pour plus d’informations sur les règles CORS et la logique d’évaluation, consultez la prise en charge du partage de ressources cross-origin pour les services stockage Azure.

Pour plus d’informations sur Storage Analytics, consultez Storage Analytics.