VENTES: 1-800-867-1389

Définition des propriétés d'un fichier

Mis à jour: avril 2015

L'opération Set File Properties définit des propriétés système sur le fichier.

La demande Set File Properties peut être construite comme indiqué ci-dessous. HTTPS est recommandé.

 

Méthode URI de demande Version HTTP

PUT

https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfile?comp=properties

HTTP/1.1

Remplacez les composants du chemin indiqués dans l'URI de la demande par les vôtres, comme suit :

 

Composant de chemin Description

moncompte

Nom du compte de stockage.

monpartage

Nom du partage de fichiers.

cheminmonrépertoire

Facultatif. Chemin d'accès au répertoire parent.

monfichier

Nom du fichier.

Pour plus d'informations sur les restrictions d'affectation de noms pour les chemins, consultez la rubrique Attribution de noms et référencement des partages, des répertoires, des fichiers et des métadonnées.

Les paramètres supplémentaires suivants peuvent être spécifiés dans l'URI de la demande.

 

Paramètre Description

timeout

Facultatif. Le paramètre timeout est exprimé en secondes. Pour plus d'informations, consultez Définition de délais d'expiration pour les opérations de service de fichiers.

Le tableau suivant décrit les en-têtes de demande obligatoires ou facultatifs.

 

En-tête de demande Description

Authorization

Obligatoire. Spécifie le schéma d'authentification, le nom du compte et la signature. Pour plus d'informations, consultez Authentification pour les services de stockage Azure.

Date ou x-ms-date

Obligatoire. Spécifie le temps universel coordonné (UTC) pour la demande. Pour plus d'informations, consultez Authentification pour les services de stockage Azure.

x-ms-version

Obligatoire pour toutes les demandes authentifiées. Spécifie la version de l'opération à utiliser pour cette demande. Pour plus d'informations, consultez Contrôle de version des services BLOB, de File d'attente et de Table dans Windows Azure.

x-ms-cache-control

Facultatif. Modifie la chaîne de contrôle du cache pour le fichier.

Si cette propriété n'est pas spécifiée dans la demande, elle est désactivée pour le fichier. Les appels suivants à Obtention des propriétés du fichier ne renvoient pas cette propriété, sauf si elle est explicitement définie de nouveau dans le fichier.

x-ms-content-type

Facultatif. Définit le type de contenu du fichier.

Si cette propriété n'est pas spécifiée dans la demande, elle est désactivée pour le fichier. Les appels suivants à Obtention des propriétés du fichier ne renvoient pas cette propriété, sauf si elle est explicitement définie de nouveau dans le fichier.

x-ms-content-md5

Facultatif. Définit le hachage MD5 du fichier.

Si cette propriété n'est pas spécifiée dans la demande, elle est désactivée pour le fichier. Les appels suivants à Obtention des propriétés du fichier ne renvoient pas cette propriété, sauf si elle est explicitement définie de nouveau dans le fichier.

x-ms-content-encoding

Facultatif. Définit l'encodage du contenu du fichier.

Si cette propriété n'est pas spécifiée dans la demande, elle est désactivée pour le fichier. Les appels suivants à Obtention des propriétés du fichier ne renvoient pas cette propriété, sauf si elle est explicitement définie de nouveau dans le fichier.

x-ms-content-language

Facultatif. Définit la langue du contenu du fichier.

Si cette propriété n'est pas spécifiée dans la demande, elle est désactivée pour le fichier. Les appels suivants à Obtention des propriétés du fichier ne renvoient pas cette propriété, sauf si elle est explicitement définie de nouveau dans le fichier.

x-ms-content-disposition

Facultatif. Définit l'en-tête Content-Disposition du fichier.

Si cette propriété n'est pas spécifiée dans la demande, elle est désactivée pour le fichier. Les appels suivants à Obtention des propriétés du fichier ne renvoient pas cette propriété, sauf si elle est explicitement définie de nouveau dans le fichier.

x-ms-content-length: bytes

Facultatif. Redimensionne un fichier à la taille spécifiée. Si la valeur d'octet spécifiée est inférieure à la taille actuelle du fichier, toutes les plages au-dessus de la valeur d'octet spécifiée sont effacées.

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

Une opération ayant réussi renvoie le code d'état 200 (OK).

Pour plus d'informations sur les codes d'état, consultez Codes d'état et d'erreur.

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

 

En-tête de réponse Description

ETag

L'ETag contient une valeur qui représente la version du fichier, entre guillemets.

Last-Modified

Renvoie la date et l'heure de la dernière modification du répertoire. Le format de date suit RFC 1123. Pour plus d'informations, consultez la rubrique Représentation des valeurs Date/Heure dans les en-têtes. N'importe quelle opération qui modifie le répertoire ou ses propriétés entraîne la mise à jour de l'heure de la dernière modification. Les opérations sur les fichiers n'affectent pas l'heure de la dernière modification du répertoire.

x-ms-request-id

Cet en-tête identifie de façon unique la demande qui a été effectuée et peut être utilisé pour résoudre les problèmes de la demande. Pour plus d'informations, consultez Dépannage des opérations de l'API.

x-ms-version

Indique la version du service de Fichier utilisée pour exécuter la demande.

Date

Une valeur de date/heure UTC générée par le service qui indique le moment auquel la réponse a été initiée.

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

La sémantique de mise à jour des propriétés d'un fichier est la suivante :

  • La taille d'un fichier est modifiée uniquement si la demande spécifie une valeur pour l'en-tête x-ms-content-length.

  • Si une demande définit uniquement x-ms-content-length, et aucune autre propriété, alors aucune autre propriété du fichier n'est modifiée.

  • Si une ou plusieurs des propriétés suivantes sont définies dans la demande, alors toutes ces propriétés sont définies ensemble. Si une valeur n'est pas fournie pour une propriété donnée lorsqu'au moins une des propriétés répertoriées ci-dessous est définie, cette propriété est effacée pour le fichier.

    • x-ms-cache-control

    • x-ms-content-type

    • x-ms-content-md5

    • x-ms-content-encoding

    • x-ms-content-language

noteRemarque
Les propriétés répertoriées ci-dessus sont distinctes des propriétés de système de fichiers disponibles pour les clients SMB. Les clients SMB ne peuvent pas lire, écrire ou modifier ces valeurs de propriété.

Cela vous a-t-il été utile ?
(1500 caractères restants)
Merci pour vos suggestions.
Afficher:
© 2015 Microsoft