Définir les 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 les partages de fichiers - Mettre à jour opération fournie par le fournisseur de ressources de stockage (Microsoft.Storage) à la place. Pour en savoir plus sur l’interaction programmatique avec les ressources FileShare à 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 |
|
Demander
Vous pouvez construire la requête Set Share Properties comme suit. Nous vous recommandons HTTPS. Remplacez mon compte par le nom de votre compte de stockage.
| Méthode | URI de requête | Version HTTP |
|---|---|---|
PUT |
https://myaccount.file.core.windows.net/myshare?restype=share&comp=properties |
HTTP/1.1 |
Remplacez les composants de chemin d’accès indiqués dans l’URI de requête par vos propres composants, comme suit :
| Composant Path | Description |
|---|---|
myaccount |
Nom de votre compte de stockage. |
myshare |
Nom de votre partage de fichiers. |
Pour plus d’informations sur les restrictions de nommage de chemin d’accès, consultez nommage et référencement de partages, répertoires, fichiers et métadonnées.
Paramètres d’URI
Vous pouvez spécifier les paramètres supplémentaires suivants dans l’URI de requête :
| Paramètre | Description |
|---|---|
timeout |
Optionnel. Exprimé 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 demandes vers le stockage Azure. |
Date ou 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. Pour plus d’informations, consultez Contrôle de version pour les services stockage Azure. |
x-ms-share-quota |
Optionnel. Prise 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 |
Optionnel. Prise en charge dans la version 2019-12-12 et ultérieure. Spécifie le niveau d’accès du partage. Les valeurs valides sont TransactionOptimized, Hotet 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> |
Optionnel. Pris en charge dans la version 2020-02-10 et versions ultérieures. Spécifie le comportement de courge racine sur le partage lorsque NFS est activé.
|
x-ms-enable-snapshot-virtual-directory-access: <true \| false> |
Optionnel. Prise en charge dans la version 2024-08-04 et ultérieure. Spécifie si le répertoire virtuel d’instantané doit être accessible à la racine du point de montage du partage lorsque NFS est activé. |
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 de stockage Analytique 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 Monitor Stockage Blob Azure. |
x-ms-lease-id:<ID> |
Obligatoire si le partage de fichiers de destination a un bail actif. Disponible pour la version 2020-02-10 et ultérieure. 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). |
x-ms-share-paid-bursting-enabled: <true \| false> |
Optionnel. Prise en charge dans la version 2024-11-04 et ultérieures. Uniquement autorisé pour les partages de fichiers Premium (partages de fichiers dans le type de compte de stockage FileStorage). Cette propriété peut être utilisée pour activer ou désactiver le bursting payant. Si la propriété n’est pas spécifiée, le partage conserve son état d’activation de rafale payant existant. |
x-ms-share-paid-bursting-max-iops |
Optionnel. Prise en charge dans la version 2024-11-04 et ultérieures. Uniquement autorisé pour les partages de fichiers Premium. Entier représentant le nombre maximal d’opérations d’entrée/sortie payantes par seconde (IOPS) autorisées pour le partage. Si le bursting payant n’est pas déjà activé sur le partage : le comportement est identique à l’en-tête x-ms-share-paid-bursting-max-iops dans Créer un partage. La valeur par défaut s’il n’est pas spécifié est le nombre maximal d’IOPS autorisés pour un partage. Si cet en-tête est défini, x-ms-share-paid-bursting-enabled doit également avoir la valeur true.Si le bursting payant est déjà activé sur le partage : x-ms-share-paid-bursting-max-iops pouvez être utilisé pour mettre à jour le nombre maximal d’E/S par seconde de rafales payantes pour le partage.
x-ms-share-paid-bursting-enabled n’a pas besoin d’être définie dans ce cas. Si x-ms-share-paid-bursting-enabled a la valeur true, mais que x-ms-share-paid-bursting-max-iops n’est pas défini, le nombre maximal d’E/S par seconde avec rafales payantes reste inchangé. |
x-ms-share-paid-bursting-max-bandwidth-mibps |
Optionnel. Prise en charge dans la version 2024-11-04 et ultérieures. Uniquement autorisé pour les partages de fichiers Premium. Entier représentant le nombre maximal de mbioctets payants par seconde (MiB/s) autorisé pour le partage. Si le bursting payant n’est pas déjà activé sur le partage : le comportement est identique à l’en-tête x-ms-share-paid-bursting-max-bandwidth-mibps dans Créer un partage. La valeur par défaut si elle n’est pas spécifiée est le nombre maximal de Mio/s autorisés pour un partage. Si cet en-tête est défini, x-ms-share-paid-bursting-enabled doit également avoir la valeur true.Si le bursting payant est déjà activé sur le partage : x-ms-share-paid-bursting-max-bandwidth-mibps pouvez être utilisé pour mettre à jour le nombre maximal de mio/s payants pour le partage.
x-ms-share-paid-bursting-enabled n’a pas besoin d’être définie dans ce cas. Si x-ms-share-paid-bursting-enabled a la valeur true, mais que x-ms-share-paid-bursting-max-bandwidth-mibps n’est pas défini, la bande passante de rafale payante maximale reste inchangée. |
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
Réponse
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 retourne le code d’état 200 (OK).
Pour plus d’informations sur les codes d’état, consultez Les codes d’état et d’erreur.
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 | Description |
|---|---|
Last-Modified |
Retourne la date et l’heure de la dernière modification du partage. Le format de date suit 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 met à jour l’heure de dernière modification. Les opérations sur les fichiers n’affectent pas l’heure de 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 de la demande. Pour plus d’informations, consultez Résoudre les problèmes d’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 demandes et les 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 requête, cet en-tête ne sera pas présent dans la réponse. |
Corps de la réponse
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 sur une taille inférieure à la taille des données sur le partage, l’opération réussit. Toutefois, vous ne pourrez pas ajouter de données supplémentaires au partage tant que la quantité de données sur le partage n’est pas réduite sous le 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.
Voir aussi
opérations sur les ressources FileShare (Azure Files)