Partager via

Copier un objet blob à partir d’une URL d’objet source avec Java

  • Article

Cet article explique comment copier un blob d’une URL d’objet source à l’aide de la Bibliothèque de client Stockage Azure pour Java. Vous pouvez copier un objet blob à partir d’une source du même compte de stockage, d’une source dans un autre compte de stockage ou de tout objet accessible récupéré via une requête HTTP GET sur une URL donnée.

Les méthodes de bibliothèque de client décrites dans cet article utilisent les opérations d’API REST Placer un blob à partir d’une URL et Placer un bloc à partir d’une URL. Ces méthodes sont recommandées pour les scénarios de copie dans lesquels vous souhaitez déplacer des données dans un compte de stockage et avoir une URL pour l’objet source. Pour les opérations de copie dans lesquelles vous souhaitez une planification asynchrone, consultez Copier un objet blob avec planification asynchrone à l’aide de Java.

Prérequis

  • Cet article suppose que vous disposez déjà d'un projet configuré pour fonctionner avec la bibliothèque client Stockage Blob Azure pour Java. Pour en savoir plus sur la configuration de votre projet, y compris l’installation de packages, l’ajout de directives import et la création d’un objet client autorisé, consultez Prise en main du Stockage Azure et de Java.
  • Le mécanisme d’autorisation doit disposer des autorisations nécessaires pour effectuer une opération de copie. Pour plus d’informations, consultez les conseils d’autorisation pour les opérations d’API REST suivantes :

À propos de la copie de blob à partir d’une URL d’objet source

L’opération Put Blob From URL crée un objet blob de blocs où le contenu du blob est lu à partir d’une URL donnée. L’opération se termine de manière synchrone.

La source peut être n’importe quel objet récupérable via une requête HTTP GET standard sur l’URL donnée. Cela inclut les objets blob de blocs, les objets blob d’ajout, les objets blob de pages, les instantanés d’objets blob, les versions d’objets blob ou tout objet accessible à l’intérieur ou à l’extérieur d’Azure.

Lorsque l’objet source est un objet blob de blocs, tout le contenu de l’objet blob validé est copié. La liste de blocs n’est toutefois pas conservée et les blocs non validés ne sont pas copiés. Le contenu de l’objet blob de destination est identique à celui de la source, mais la liste de blocs validée n’est pas conservée.

La destination est toujours un objet blob de blocs, existant ou nouveau créé par l’opération. Le contenu d’un blob existant est remplacé par le contenu du nouveau blob.

L’opération Put Blob From URL copie toujours l’intégralité du blob source. La copie d’une plage d’octets ou d’un ensemble de blocs n’est pas prise en charge. Pour effectuer des mises à jour partielles du contenu d’un objet blob de blocs à l’aide d’une URL source, utilisez l’API Placer un bloc à partir d’une URL avec Put Block List.

Pour en savoir plus sur l’opération Put Blob From URL, y compris les limitations de taille d’objet blob et les considérations relatives à la facturation, consultez Remarques sur la mise en place d’un objet blob à partir d’une URL.

Copier un blob à partir d’une URL d’objet source

Cette section fournit une vue d’ensemble des méthodes fournies par la bibliothèque de client Stockage Azure pour Java pour effectuer une opération de copie à partir d’une URL d’objet source.

Les méthodes suivantes encapsulent l’opération d’API REST Put Blob From URL et créent un objet blob de blocs où le contenu de l’objet blob est lu à partir d’une URL donnée :

Ces méthodes sont recommandées pour les scénarios où vous souhaitez déplacer des données dans un compte de stockage et avoir une URL pour l’objet source.

Pour les objets volumineux, vous pouvez utiliser des blocs individuels. La méthode suivante encapsule l’opération d’API REST Put Block From URL. Cette méthode crée un bloc à commiter dans le cadre d’un objet blob où le contenu est lu à partir d’une URL source :

Copier un objet blob à partir d’une source dans Azure

Si vous copiez un objet blob depuis une source dans Azure, l’accès à l’objet blob source peut être autorisé au travers de Microsoft Entra ID, une signature d’accès partagé (SAS) ou une clé de compte.

L’exemple suivant illustre un scénario de copie à partir d’un objet blob source dans Azure. La méthode uploadFromUrl peut éventuellement accepter un paramètre booléen pour indiquer si un objet blob existant doit être remplacé, comme indiqué dans l’exemple.

public void copyFromSourceInAzure(BlobClient sourceBlob, BlockBlobClient destinationBlob) {
    // Get the source blob URL and create the destination blob
    // set overwrite param to true if you want to overwrite an existing blob
    destinationBlob.uploadFromUrl(sourceBlob.getBlobUrl(), false);
}

La méthode uploadFromUrlWithResponse peut également accepter un paramètre BlobUploadFromUrlOptions pour spécifier d’autres options pour l’opération.

Copier un objet blob à partir d’une source externe

Vous pouvez effectuer une opération de copie sur n’importe quel objet source qui peut être récupéré via une requête HTTP GET sur une URL donnée, y compris les objets accessibles en dehors d’Azure. L’exemple suivant illustre un scénario de copie d’un blob à partir d’une URL d’objet source accessible.

public void copyFromExternalSource(String sourceURL, BlockBlobClient destinationBlob) {
    // Create the destination blob from the source URL
    // set overwrite param to true if you want to overwrite an existing blob
    destinationBlob.uploadFromUrl(sourceURL, false);
}

Ressources

Pour en savoir plus sur la copie d’objets blob à l’aide de la bibliothèque de client Stockage Blob Azure pour Java, consultez les ressources suivantes.

Opérations de l'API REST

Le Kit de développement logiciel (SDK) Azure pour Java contient des bibliothèques qui s'appuient sur l'API REST Azure, vous permettant d’interagir avec les opérations de l’API REST par le biais de paradigmes Java familiers. Les méthodes de bibliothèque de client décrites dans cet article utilisent les opérations d’API REST suivantes :

Exemples de code

Ressources de bibliothèque cliente