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 Chemin d’accès | 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 Nommer et référencer des partages, des répertoires, des fichiers et des métadonnées.
Paramètres URI
Vous pouvez spécifier le paramètre supplémentaire suivant sur l’URI de 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 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 au partage instantané. Si vous ne spécifiez aucune paire nom-valeur, l’opération copie les métadonnées du partage de base dans le instantané. Si vous spécifiez une ou plusieurs paires nom-valeur, le partage instantané 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 de nommage des 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 reçues par le serveur. Pour plus d’informations, consultez Surveiller 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 status, consultez État et codes 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 du partage instantané, entre guillemets. Un partage instantané ne peut pas être modifié, de sorte que le ETag d’un partage particulier instantané jamais modifié. Toutefois, si vous avez fourni de nouvelles métadonnées avec la Snapshot Share demande, le ETag du partage instantané diffère de celui du partage de base. Si vous n’avez spécifié aucune métadonnées avec la demande, le ETag du partage instantané est identique à celui du partage de base, au moment où le partage instantané 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 de valeurs date-heure dans les en-têtes. Une instantané de partage ne pouvant pas être modifiée, l’heure de la dernière modification d’un partage particulier instantané jamais modifiée. Toutefois, si vous avez fourni de nouvelles métadonnées avec la Snapshot Share demande, l’heure de la dernière modification du partage instantané 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 du partage instantané est identique à celle du partage de base, au moment où le partage instantané a été pris. |
x-ms-request-id |
Identifie de manière unique la demande 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 de 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 le partage instantané. Vous pouvez utiliser la valeur de cet en-tête dans les demandes suivantes pour accéder au partage instantané. Cette valeur est opaque. |
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 , s’il est présent dans la demande. 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 partage instantané, vous ne pouvez pas le modifier. Un partage instantané 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érationSnapshot Share
, un nouveau partage instantané est créé, avec une valeur unique DateTime
qui identifie le partage instantané par rapport à son partage de base. Vous pouvez utiliser cette DateTime
valeur pour effectuer d’autres opérations sur le partage instantané et son contenu. Vous devez traiter cette DateTime
valeur comme opaque.
La DateTime
valeur identifie le partage instantané sur l’URI de la demande. 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 le partage instantané :
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 partage instantané 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. Ils doivent être supprimés 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.