Suppression du partage
L’opération Delete Share supprime le partage ou le partage spécifié instantané. Cette API est entièrement prise en charge, mais sachez qu’il s’agit d’une API de gestion héritée.
Il est judicieux d’utiliser des partages de fichiers - Supprimer à la place. Il est fourni par le fournisseur de ressources de stockage (Microsoft.Storage). Pour en savoir plus sur l’interaction programmatique avec FileShare les ressources à l’aide du fournisseur de ressources de stockage, consultez Operations on FileShares.
Disponibilité du protocole
| Protocole de partage de fichiers activé | Disponible |
|---|---|
| SMB |
|
| NFS |
|
Requête
Vous pouvez construire la Delete Share requête comme suit. HTTPS est recommandé.
| Méthode | URI de demande | Version HTTP |
|---|---|---|
DELETE |
https://myaccount.file.core.windows.net/myshare?restype=share |
HTTP/1.1 |
DELETE |
https://myaccount.file.core.windows.net/myshare?sharesnapshot=<DateTime>&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 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 les paramètres supplémentaires suivants dans l’URI de requête.
| Paramètre | Description |
|---|---|
sharesnapshot |
facultatif. Version 2017-04-17 et versions ultérieures. Le sharesnapshot paramètre est une valeur opaque DateTime qui, lorsqu’il est présent, spécifie le partage instantané à supprimer. |
timeout |
Optionnel. 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 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-delete-snapshots: { include, include-leased } |
Facultatif si le partage a des instantanés associés. Spécifiez l’une des options suivantes :
|
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 (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 Azure Files. |
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 status code 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 également avec status code 412 (Échec de la condition préalable). |
Corps de la demande
Aucun.
Exemple de requête
DELETE 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
Authorization: SharedKey myaccount:Z5043vY9MesKNh0PNtksNc9nbXSSqGHueE00JdjidOQ= TBD
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 202 (Accepté). 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 |
|---|---|
x-ms-request-id |
Cet en-tête identifie de manière unique la demande qui a été effectuée et peut être utilisé 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-client-request-id |
Vous pouvez utiliser cet en-tête 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 requête, 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.
Notes
Lorsque vous supprimez un partage, vous ne pouvez pas créer un partage portant le même nom pendant au moins 30 secondes. Pendant la suppression du partage, les tentatives de recréation d’un partage du même nom échouent avec status code 409 (Conflit). Le service retourne des informations supplémentaires sur l’erreur, indiquant que le partage est en cours de suppression. Toutes les autres opérations, y compris les opérations sur des fichiers du partage, échouent avec le code d'état 404 (Introuvable) pendant la suppression du partage.
Actuellement, la suppression d’un partage contenant des instantanés n’est pas autorisée. Les instantanés de partage peuvent être supprimés individuellement ou peuvent être supprimés avec le partage à l’aide de l’en-tête x-ms-delete-snapshots=include .
Vous devez uniquement spécifier x-ms-delete-snapshots pour une requête sur la ressource de partage de base. Si vous spécifiez cet en-tête lors d’une demande de suppression d’un instantané individuel, Azure Files retourne status code 400 (valeur de paramètre de requête non valide). Si cet en-tête n’est pas spécifié dans la demande de suppression et que le partage a des instantanés associés, le Azure Files retourne status code 409 (Partager a des instantanés).