Définition des propriétés de partage
L’opération Set Share Properties
définit les propriétés du partage de fichiers Azure spécifié. Bien que cette opération soit entièrement prise en charge, il s’agit d’une opération de gestion héritée. Nous vous recommandons d’utiliser l’opération Partages de fichiers - Mise à jour fournie par le fournisseur de ressources de stockage (Microsoft.Storage) à la place. Pour en savoir plus sur l’interaction programmatique avec FileShare
les ressources à l’aide du fournisseur de ressources de stockage, consultez Opérations sur les ressources FileShare.
Disponibilité du protocole
Protocole de partage de fichiers activé | Disponible |
---|---|
SMB | |
NFS |
Requête
Vous pouvez construire la Set Share Properties
requête comme suit. Nous recommandons HTTPS. Remplacez myaccount par le nom de votre compte de stockage.
Méthode | URI de demande | Version HTTP |
---|---|---|
PUT |
https://myaccount.file.core.windows.net/myshare?restype=share&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 Path | Description |
---|---|
myaccount |
nom de votre compte de stockage. |
myshare |
Nom du partage de fichiers. |
Pour plus d’informations sur les restrictions de nommage de chemin d’accès, consultez Affectation de noms et référencement de partages, répertoires, fichiers et métadonnées.
Paramètres URI
Vous pouvez spécifier les paramètres supplémentaires suivants dans l’URI de requête :
Paramètre | Description |
---|---|
timeout |
facultatif. Exprimée en secondes. Pour plus d’informations, consultez Définir des délais d’expiration pour les opérations Azure Files. |
En-têtes de requête
Le tableau suivant décrit les en-têtes de requête obligatoires et facultatifs :
En-tête de requête | Description |
---|---|
Authorization |
Obligatoire. Spécifie le schéma d’autorisation, le nom du compte et la signature. Pour plus d’informations, consultez Autoriser les requêtes auprès du Stockage Azure. |
Date ou x-ms-date |
Obligatoire. Spécifie la date/heure en temps universel coordonné (UTC) pour la requête. Pour plus d’informations, consultez Autoriser les requêtes auprès du Stockage Azure. |
x-ms-version |
Obligatoire pour toutes les demandes autorisées. Spécifie la version de l'opération à utiliser pour cette demande. Pour plus d'informations, consultez la page Contrôle de version pour les services de Stockage Microsoft Azure. |
x-ms-share-quota |
facultatif. Pris en charge dans la version 2015-02-21 et ultérieure. Spécifie la taille maximale du partage, en gibibytes (Gio). |
x-ms-access-tier |
facultatif. Pris en charge dans la version 2019-12-12 et ultérieure. Spécifie le niveau d’accès du partage. Les valeurs correctes sont TransactionOptimized , Hot et Cool . Pour plus d’informations sur la hiérarchisation des partages de fichiers, consultez Niveaux de stockage Azure Files. |
x-ms-root-squash: <NoRootSquash \| RootSquash \| AllSquash> |
facultatif. Pris en charge dans les versions 2020-02-10 et ultérieures. Spécifie le comportement d’écrasement racine sur le partage lorsque NFS est activé.
|
x-ms-enable-snapshot-virtual-directory-access: <true \| false> |
facultatif. Pris en charge dans les versions 2024-08-04 et ultérieures. Spécifie si le répertoire virtuel d’instantané doit être accessible à la racine du point de montage de partage lorsque NFS est activé. |
x-ms-client-request-id |
facultatif. Fournit une valeur opaque générée par le client avec une limite de caractères de 1 kibioctet (Kio) 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 que le serveur reçoit. Pour plus d’informations, consultez Surveiller le Stockage Blob Azure. |
x-ms-lease-id:<ID> |
Obligatoire si le partage de fichiers de destination a un bail actif. Disponible pour les versions 2020-02-10 et ultérieures. Si la demande n’inclut pas l’ID de bail ou s’il n’est pas valide, l’opération échoue avec le code d’état 412 (Échec de la condition préalable). Si cet en-tête est spécifié et que le partage de fichiers de destination n’a pas de bail actif, l’opération échoue avec le code d’état 412 (Échec de la condition préalable). |
Corps de la demande
Aucun.
Exemple de requête
PUT https://myaccount.file.core.windows.net/myshare?restype=share&comp=properties
Request Headers:
x-ms-version: 2020-02-10
x-ms-date: <date>
Authorization: SharedKey myaccount: Z5043vY9MesKNh0PNtksNc9nbXSSqGHueE00Jdjid0Q=
x-ms-share-quota: 55
x-ms-root-squash: RootSquash
response
La réponse inclut un code d'état HTTP et un ensemble d'en-têtes de réponse.
Code d’état
Une opération réussie envoie le code d'état 200 (OK).
Pour plus d’informations sur les codes d’état, consultez Codes d’état et d’erreur.
En-têtes de réponse
La réponse de l'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 du protocole HTTP/1.1.
En-tête de réponse | Description |
---|---|
Last-Modified |
Retourne la date et l’heure de la dernière modification du partage. Le format de date est conforme à la RFC 1123. Pour plus d’informations, consultez Représentation des valeurs de date/heure dans les en-têtes. Toute opération qui modifie le partage 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 partage. |
ETag |
Contient une valeur qui représente la version du partage, sous forme de chaîne entre guillemets. |
x-ms-request-id |
Identifie de manière unique la demande qui a été effectuée. Vous pouvez également l’utiliser pour résoudre les problèmes liés à la demande. Pour plus d’informations, consultez Résoudre les problèmes liés aux opérations d’API. |
x-ms-version |
Indique la version d’Azure Files utilisée pour exécuter la requête. |
Date ou x-ms-date |
Valeur de date/heure UTC qui indique l’heure à laquelle le service a envoyé la réponse. |
x-ms-client-request-id |
Peut être utilisé pour résoudre les problèmes liés aux demandes et aux réponses correspondantes. La valeur de cet 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 est au maximum de 1 024 caractères ASCII visibles. Si l’en-tête x-ms-client-request-id n’est pas présent dans la demande, cet en-tête ne sera pas présent dans la réponse. |
Response body
Aucun.
Autorisation
Seul le propriétaire du compte peut appeler cette opération.
Remarques
Pour plus d’informations sur la définition du quota de partage, consultez Créer un partage.
Si vous définissez le quota de partage pour qu’il soit inférieur à la taille des données sur le partage, l’opération réussit. Toutefois, vous ne pourrez pas ajouter de données au partage tant que la quantité de données sur le partage n’est pas réduite en dessous du quota. Vous pouvez réduire la quantité de données en supprimant ou en compressant des fichiers.
Set Share Properties
n’est pas pris en charge pour un instantané de partage. Une tentative d’exécution de cette opération sur un instantané de partage échoue avec le code d’état 400 (InvalidQueryParameterValue).
Si vous définissez l’en-tête x-ms-enable-snapshot-virtual-directory-access pour les partages NFS, montez à nouveau le partage pour observer le comportement mis à jour.