partage de fichiers d'instantanés

À compter de la version 2017-04-17, l’opération Snapshot Share crée un instantané en lecture seule d’un partage.

Disponibilité du protocole

Protocole de partage de fichiers activé	Disponible	Statut
SMB		GA
NFS		GA

Requête

Vous pouvez construire la Snapshot Share requête comme suit. HTTPS est recommandé.

Méthode	URI de demande	Version HTTP
PUT	https://myaccount.file.core.windows.net/myshare?restype=share&comp=snapshot	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 le paramètre supplémentaire suivant sur 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 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 demande obligatoires ou 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 l'heure UTC (temps universel coordonné) pour la demande. 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-meta-name:value	facultatif. Spécifie une paire nom-valeur définie par l’utilisateur, associée à l’instantané de partage. Si vous ne spécifiez aucune paire nom-valeur, l’opération copie les métadonnées du partage de base dans l’instantané. Si vous spécifiez une ou plusieurs paires nom-valeur, l’instantané de partage est créé avec les métadonnées spécifiées. Dans ce cas, les métadonnées ne sont pas copiées à partir du partage de base. Les noms de métadonnées doivent respecter les règles d’affectation de noms pour les identificateurs C#.
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 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.

Corps de la demande

Aucun.

Exemple de requête

Request Syntax:  
PUT https://myaccount.file.core.windows.net/myshare?restype=share&comp=snapshot HTTP/1.1

Request Headers:
x-ms-version: 2017-04-17
x-ms-date: Mon, 10 May 2017 22:50:32 GMT
x-ms-meta-Name: StorageSample
Authorization: SharedKey myaccount:Z5043vY9MesKNh0PNtksNc9nbXSSqGHueE00JdjidOQ=

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 renvoie le code d'état 201 (Créé). 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
ETag	Contient une valeur qui représente la version de l’instantané de partage, entre guillemets. Un instantané de partage ne peut pas être modifié, de sorte que le ETag d’un instantané de partage particulier ne change jamais. Toutefois, si vous avez fourni de nouvelles métadonnées avec la Snapshot Share demande, le ETag de l’instantané de partage diffère de celui du partage de base. Si vous n’avez spécifié aucune métadonnées avec la demande, le ETag de l’instantané de partage est identique à celui du partage de base, au moment où l’instantané de partage a été pris.
Last-Modified	Renvoie la date et l'heure de la dernière modification du partage. Pour plus d’informations, consultez Représentation des valeurs date-heure dans les en-têtes. Un instantané de partage ne peut pas être modifié, de sorte que l’heure de la dernière modification d’un instantané de partage particulier ne change jamais. Toutefois, si vous avez fourni de nouvelles métadonnées avec la Snapshot Share demande, l’heure de la dernière modification de l’instantané de partage diffère de celle du partage de base. Si vous n’avez spécifié aucune métadonnées avec la demande, l’heure de la dernière modification de l’instantané de partage est identique à celle du partage de base, au moment où l’instantané de partage a été pris.
x-ms-request-id	Identifie de manière unique la requête qui a été effectuée et peut être utilisée pour la résolution des problèmes de la demande. Pour plus d’informations, consultez Résolution des problèmes liés aux opérations d’API.
x-ms-version	Indique la version d’Azure Files utilisée pour exécuter la demande.
Date ou x-ms-date	Valeur de date/heure UTC qui indique l’heure à laquelle la réponse a été lancée. Le service génère cette valeur.
x-ms-snapshot	Valeur DateTime qui identifie de manière unique l’instantané de partage. Vous pouvez utiliser la valeur de cet en-tête dans les demandes suivantes pour accéder à l’instantané de partage. Cette valeur est opaque.
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 , s’il est présent dans la requête. 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, il ne sera pas présent dans la réponse.

Response body

Aucun.

Exemple de réponse

Response Status:
HTTP/1.1 201 Created

Response Headers:
Content-Length: 0
Date: Mon, 10 May 2017 23:00:12 GMT
ETag: "0x8CB14C3E29B7E82"
Last-Modified: Mon, 10 May 2017 23:00:06 GMT
x-ms-version: 2017-04-17
x-ms-snapshot: 2017-05-10T17:52:33.9551861Z
Server: Windows-Azure-File/1.0 Microsoft-HTTPAPI/2.0

Autorisation

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

Remarques

Les instantanés de partage fournissent des versions en lecture seule des partages. Une fois que vous avez créé un instantané de partage, vous ne pouvez pas le modifier. Un instantané de partage offre un moyen pratique de créer une sauvegarde cohérente de tous les fichiers sur un partage.

Chaque fois que vous appelez l’opération Snapshot Share , un nouvel instantané de partage est créé, avec une valeur unique DateTime qui identifie l’instantané de partage par rapport à son partage de base. Vous pouvez utiliser cette DateTime valeur pour effectuer d’autres opérations sur l’instantané de partage et son contenu. Vous devez traiter cette DateTime valeur comme opaque.

La DateTime valeur identifie l’instantané de partage sur l’URI de requête. Par exemple, un fichier sur le partage de base et ses instantanés ont des URI similaires aux exemples suivants :

• Fichier sur le partage : http://myaccount.file.core.windows.net/myshare/myfile
• Fichier sur l’instantané de partage : http://myaccount.file.core.windows.net/myshare/myfile?sharesnapshot=<DateTime>

Un partage peut prendre en charge la création de 200 instantanés de partage. Si vous tentez de créer plus de 200 instantanés de partage, le service retourne le code d’erreur 409 (Conflit). Si vous tentez de créer un instantané de partage alors qu’une opération précédente Snapshot Share est en cours, le service retourne également le code d’erreur 409 (Conflit).

Les instantanés de partage existants ne sont jamais remplacés. Elles doivent être supprimées explicitement. Pour supprimer explicitement des instantanés de partage, appelez Supprimer le partage et définissez l’en-tête x-ms-include-snapshots , ainsi que le sharesnapshot paramètre de requête, sur la valeur appropriée.

Vous pouvez afficher les instantanés de partage NFS sur un client NFS à l’aide du répertoire virtuel d’instantanés (.snapshot), qui se trouve généralement à la racine du point de montage du partage. L’accès à ce répertoire peut être désactivé en définissant l’en-tête x-ms-enable-snapshot-virtual-directory-access sur false dans l’API Définir les propriétés du partage . Vous pouvez également définir cet en-tête au moment de la création du partage dans le cadre de l’opération Créer un partage .