VENTES: 1-800-867-1389

Création de partage

Mis à jour: avril 2015

L'opération Create Share crée un partage sous le compte spécifié. Si un partage portant le même nom existe déjà, l'opération échoue.

La ressource de partage inclut des métadonnées et propriétés pour ce partage. Elle ne comprend pas la liste des fichiers contenus dans le partage.

La demande Create Share 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?restype=share

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. Notez qu'il peut inclure uniquement des caractères minuscules.

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 l'heure UTC (temps universel coordonné) 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-meta-name:value

Facultatif. Paire nom-valeur à associer au partage en tant que métadonnées.

Les noms de métadonnées doivent respecter les règles d'affectation de noms des identificateurs C#.

PUT https://myaccount.file.core.windows.net/myshare?restype=share HTTP/1.1

Request Headers:
x-ms-version: 2014-02-14
x-ms-date: Mon, 27 Jan 2014 22:50:32 GMT
x-ms-meta-Name: StorageSample
Authorization: SharedKey myaccount:Z5043vY9MesKNh0PNtksNc9nbXSSqGHueE00JdjidOQ=

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 201 (Créé).

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 partage, entre guillemets.

Last-Modified

Renvoie la date et l'heure de la dernière modification du partage. 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.

Toute opération modifiant le partage ou ses propriétés ou métadonnées met à jour 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.

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.

Response Status:
HTTP/1.1 201 Created

Response Headers:
Transfer-Encoding: chunked
Date: Mon, 27 Jan 2014 23:00:12 GMT
ETag: "0x8CB14C3E29B7E82"
Last-Modified: Mon, 27 Jan 2014 23:00:06 GMT
x-ms-version: 2014-02-14
Server: Windows-Azure-File/1.0 Microsoft-HTTPAPI/2.0

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

Les partages sont créés immédiatement sous le compte de stockage. Il n'est pas possible d'imbriquer un partage sous un autre.

Vous pouvez spécifier des métadonnées pour un partage lors de sa création en incluant un ou plusieurs en-têtes de métadonnées dans la demande. Le format de l'en-tête de métadonnées est x-ms-meta-name:value.

Si un partage du même nom est supprimé lors de l'appel de Create Share, le serveur renvoie un code d'état 409 (Conflit), avec des informations d'erreur supplémentaires indiquant que le partage est en cours de suppression.

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