Exporter (0) Imprimer
Développer tout

Abort Copy Blob

Mis à jour: février 2014

L'opération Abort Copy Blob interrompt une opération Copy Blob en attente et laisse un objet blob de destination avec une longueur de zéro et des métadonnées complètes. Version du 12/02/2012 et ultérieure.

Construisez Abort Copy Blob comme suit. HTTPS est recommandé. Remplacez myaccount par le nom de votre compte de stockage, mycontainer par le nom de votre conteneur, myblob par le nom de votre objet blob de destination et <id> par l'identificateur de copie indiqué dans l'en-tête x-ms-copy-id de l'opération d'origine Copy Blob :

 

URI de demande de la méthode PUT Version HTTP

https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=copy&copyid=<id>

HTTP/1.1

Lorsque vous élaborez une demande pour le service de stockage local, spécifiez le nom d'hôte local et le port de service BLOB sous la forme 127.0.0.1:10000, suivi du nom de compte de stockage local :

 

URI de demande de la méthode PUT Version HTTP

http://127.0.0.1:10000/devstoreaccount1/mycontainer/myblob?comp=copy&copyid=<id>

HTTP/1.1

Pour plus d'informations, consultez Utilisation de l'émulateur de stockage Azure pour le développement et le test.

Les paramètres supplémentaires suivants peuvent être spécifiés dans l'URI de la demande.

 

Parameter Description

timeout

Ce paramètre est 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 du service BLOB.

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 le temps universel coordonné (UTC) 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. Pour plus d'informations, consultez Contrôle de version pour les services de stockage Azure.

x-ms-lease-id:<ID>

Obligatoire si l'objet blob de destination a un bail infini actif.

x-ms-copy-action: abort

Obligatoire.

x-ms-client-request-id

Ce paramètre est facultatif. Fournit une valeur opaque générée par le client avec une limite de caractère de 1 Ko qui est enregistrée dans les journaux d'analyse quand la journalisation de l'analyse de stockage est activée. L'utilisation de cet en-tête est recommandée pour la corrélation des activités côté client avec les requêtes reçues par le serveur. Pour plus d'informations, consultez À propos de la journalisation Storage Analytics et Journalisation du stockage Windows Azure : utilisation des journaux pour suivre les demandes de stockage.

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 retourne le code d'état 204 (Aucun contenu).

Pour plus d'informations sur les codes d'état, consultez Codes d'état et codes 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 demande Description

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 BLOB 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.

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

Lorsque vous interrompez une opération Copy Blob en attente, l'en-tête x-ms-copy-status de l'objet blob de destination a la valeur aborted. L'interruption d'une opération de copie produit un objet blob de destination d'une longueur égale à zéro pour les objets blob de blocs et les objets blob de pages. Toutefois, les métadonnées pour l'objet blob de destination auront les nouvelles valeurs copiées de l'objet blob source ou définies explicitement dans l'appel de l'opération Copy Blob. Pour conserver les métadonnées d'origine avant la copie, effectuez un instantané de l'objet blob de destination avant d'appeler Copy Blob.

Vous ne pouvez suspendre qu'une opération de copie en attente. Si vous essayez de suspendre une copie terminée ou qui a échoué, vous obtiendrez un conflit 409. Si vous essayez de suspendre une opération de copie à l'aide d'un ID de copie incorrect, vous obtiendrez également un conflit 409.

Afficher:
© 2015 Microsoft