Placer l’objet blob à partir de l’URL
L’opération Put Blob From URL crée un objet blob de blocs où le contenu de l’objet blob est lu à partir d’une URL spécifiée. Cette API est disponible à partir de la version 2020-04-08.
Les mises à jour partielles ne sont pas prises en charge avec Put Blob From URL. Le contenu d’un objet blob existant est remplacé par le contenu du nouvel objet blob. Pour effectuer des mises à jour partielles du contenu d’un objet blob de blocs à l’aide d’une URL source, utilisez l’API Put Block From URL conjointement avec Put Block List.
La taille de l’objet blob source peut atteindre jusqu’à une longueur maximale de 5 000 mebibytes (MiB).
Requête
Vous pouvez construire le Put Blob From URL comme suit. Nous vous recommandons d’utiliser HTTPS. Remplacez mon compte par le nom de votre compte de stockage :
| URI de demande de méthode PUT | Version HTTP |
|---|---|
https://myaccount.blob.core.windows.net/mycontainer/myblob |
HTTP/1.1 |
Demande de service de stockage émulée
Lorsque vous effectuez une requête sur le service de stockage émulé, spécifiez le nom d’hôte de l’émulateur et le port du service Blob comme 127.0.0.1:10000, suivi du nom du compte de stockage émulé :
| URI de demande de méthode PUT | Version HTTP |
|---|---|
http://127.0.0.1:10000/devstoreaccount1/mycontainer/myblob |
HTTP/1.1 |
L’émulateur de stockage prend en charge les tailles d’objets blob d’un maximum de 2 gibioctets (Gio) uniquement.
Pour plus d’informations, consultez Utiliser l’émulateur Azurite pour le développement Azure Storage local.
Paramètres d’URI
Les paramètres supplémentaires suivants peuvent être spécifiés sur l’URI de requête :
| Paramètre | Description |
|---|---|
timeout |
facultatif. Le paramètre timeout est exprimé en secondes. Pour plus d’informations, consultez Définir des délais d’attente pour les opérations de service Blob. |
En-têtes de demande
Les en-têtes de requête obligatoires et facultatifs sont décrits dans le tableau suivant :
| 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 demandes vers le stockage Azure. |
Date ou x-ms-date |
Obligatoire. Spécifie le temps universel coordonné (UTC) de la requête. Pour plus d’informations, consultez Autoriser les demandes vers le stockage Azure. |
x-ms-version |
Obligatoire pour toutes les demandes autorisées. Spécifie la version de l’opération à utiliser pour cette requête. Pour plus d’informations, consultez Contrôle de version pour les services stockage Azure. |
Content-Length |
Obligatoire. Spécifie le nombre d’octets transmis dans le corps de la requête. La valeur de cet en-tête doit être définie sur 0. Lorsque la longueur n’est pas 0, l’opération échoue avec le code d’état 400 (demande incorrecte). |
x-ms-copy-source:name |
Obligatoire. Spécifie l’URL de l’objet blob source. La valeur peut être une URL de jusqu’à 2 kibioctets (KiB) de longueur qui spécifie un objet blob. La valeur doit être encodée en URL, car elle apparaît dans un URI de requête. L’objet blob source doit être public ou être autorisé via une signature d’accès partagé. Si l’objet blob source est public, aucune autorisation n’est requise pour effectuer l’opération. Si la taille de l’objet blob source est supérieure à 5 000 Mio ou si la source ne retourne pas de valeur de Content-Length valide, la requête échoue avec le code d’état 409 (Conflit). Voici quelques exemples d’URL d’objet source :- https://myaccount.blob.core.windows.net/mycontainer/myblob- https://myaccount.blob.core.windows.net/mycontainer/myblob?snapshot=<DateTime>- https://myaccount.blob.core.windows.net/mycontainer/myblob?versionid=<DateTime> |
x-ms-copy-source-authorization: <scheme> <signature> |
facultatif. Spécifie le schéma d’autorisation et la signature de la source de copie. Pour plus d’informations, consultez Autoriser les demandes vers le stockage Azure. Remarque: seul un schéma de porteur est pris en charge pour Microsoft Entra. Remarque: si votre objet source est accessible publiquement ou si votre objet source se trouve dans un compte de stockage et que vous utilisez un jeton SAP passé dans x-ms-copy-source:name, cet en-tête n’est pas nécessaire.Cet en-tête est pris en charge dans les versions 2020-10-02 et ultérieures. |
x-ms-blob-type: BlockBlob |
Obligatoire. Spécifie le type d’objet blob à créer, qui doit être BlockBlob. Si le type d’objet blob n’est pas BlockBlob, l’opération échoue avec le code d’état 400 (requête incorrecte). |
Content-Type |
facultatif. Type de contenu MIME de l’objet blob. Le type par défaut est application/octet-stream. |
Content-Encoding |
facultatif. Spécifie les encodages de contenu qui ont été appliqués à l’objet blob. Cette valeur est retournée au client lorsque l’opération Obtenir l’objet blob est effectuée sur la ressource d’objet blob. Lorsque cette valeur est retournée, le client peut l’utiliser pour décoder le contenu de l’objet blob. |
Content-Language |
facultatif. Spécifie les langages naturels utilisés par cette ressource. |
Cache-Control |
facultatif. Le Stockage Blob stocke cette valeur, mais ne l’utilise pas ni ne la modifie. |
x-ms-source-content-md5 |
facultatif. Hachage MD5 du contenu de l’objet blob à partir de l’URI. Ce hachage est utilisé pour vérifier l’intégrité de l’objet blob pendant le transport des données à partir de l’URI. Lorsque cet en-tête est spécifié, le service de stockage compare le hachage du contenu arrivé à partir de la source de copie avec cette valeur d’en-tête. Si cet en-tête est omis, le stockage Blob génère un hachage MD5. Si les deux hachages ne correspondent pas, l'opération échoue avec le code d'erreur 400 (Demande incorrecte). |
x-ms-content-crc64 |
facultatif. Hachage CRC64 du contenu de l’objet blob. Ce hachage est utilisé pour vérifier l’intégrité de l’objet blob pendant le transport. Lorsque cet en-tête est spécifié, le service de stockage vérifie le hachage arrivé par rapport à celui qui a été envoyé. Si les deux hachages ne correspondent pas, l'opération échoue avec le code d'erreur 400 (Demande incorrecte). Cet en-tête est pris en charge dans la version 02-02-2019 et ultérieure. Si les en-têtes Content-MD5 et x-ms-content-crc64 sont présents, la requête échoue avec une demande 400 (demande incorrecte). |
x-ms-blob-content-type |
facultatif. Définit le type de contenu de l’objet blob. |
x-ms-blob-content-encoding |
facultatif. Définit l’encodage de contenu de l’objet blob. |
x-ms-blob-content-language |
facultatif. Définit la langue du contenu de l’objet blob. |
x-ms-blob-content-md5 |
facultatif. Définit le hachage MD5 de l’objet blob. |
x-ms-blob-cache-control |
facultatif. Définit le contrôle de cache de l’objet blob. |
x-ms-meta-name:value |
facultatif. Paires nom-valeur associées à l’objet blob en tant que métadonnées. Remarque: à partir de la version 2009-09-19, les noms de métadonnées doivent respecter les règles d’affectation de noms pour les identificateurs C# . |
x-ms-encryption-scope |
facultatif. Étendue de chiffrement à utiliser pour chiffrer le contenu de la requête. Cet en-tête est pris en charge dans la version 2019-02-02 et ultérieure. |
x-ms-tags |
facultatif. Définit les balises encodées par chaîne de requête spécifiées sur l’objet blob. Pour plus d’informations, accédez à la section Remarques. Prise en charge dans la version 2019-12-12 et ultérieure. |
x-ms-copy-source-tag-option |
facultatif. Les valeurs possibles sont REPLACE ou COPY (respectant la casse). La valeur par défaut est REPLACE. Si COPY est spécifié, les balises de l’objet blob source sont copiées dans l’objet blob de destination. L’objet blob source doit être privé, et la demande doit avoir l’autorisation d'Obtenir des balises d’objet blob sur l’objet blob source et Définir des balises d’objet blob sur l’objet blob de destination. Cela entraîne un appel supplémentaire au Obtenir des balises d’objet blob opération sur le compte source. REPLACE définit les balises spécifiées par l’en-tête x-ms-tags sur l’objet blob de destination. Si REPLACE est utilisé et qu’aucune étiquette n’est spécifiée par x-ms-tags, aucune balise n’est définie sur l’objet blob de destination. La spécification de COPY et de x-ms-tags entraîne un conflit 409 (conflit).Prise en charge dans la version 2021-04-10 et ultérieure. |
x-ms-copy-source-blob-properties |
facultatif. Spécifie le comportement des propriétés de l’objet blob source de copie. Si la valeur est True, les propriétés de l’objet blob source sont copiées dans le nouvel objet blob. La valeur par défaut est True. |
x-ms-source-if-modified-since |
facultatif. Une valeurDateTime. Spécifiez cet en-tête conditionnel pour placer l’objet blob uniquement si l’objet blob source a été modifié depuis la date/heure spécifiée. Si l’objet blob source n’a pas été modifié, le stockage Blob renvoie le code d’état 412 (Échec de la condition préalable). Cet en-tête ne peut pas être spécifié si la source est un partage Azure Files. |
x-ms-source-if-unmodified-since |
facultatif. Une valeurDateTime. Spécifiez cet en-tête conditionnel pour placer l’objet blob uniquement si l’objet blob source n’a pas été modifié depuis la date/heure spécifiée. Si l’objet blob source a été modifié, le stockage Blob renvoie le code d’état 412 (Échec de la condition préalable). Cet en-tête ne peut pas être spécifié si la source est un partage Azure Files. |
x-ms-source-if-match |
facultatif. Valeur ETag. Spécifiez cet en-tête conditionnel pour placer l’objet blob source uniquement si son ETag correspond à la valeur spécifiée. Si les valeurs ETag ne correspondent pas, le stockage Blob retourne le code d’état 412 (Échec de la condition préalable). Cet en-tête ne peut pas être spécifié si la source est un partage Azure Files. |
x-ms-source-if-none-match |
facultatif. Valeur ETag. Spécifiez cet en-tête conditionnel pour placer l’objet blob uniquement si son ETag ne correspond pas à la valeur spécifiée. Si les valeurs sont identiques, le Stockage Blob retourne le code d’état 412 (Échec de la condition préalable). Cet en-tête ne peut pas être spécifié si la source est un partage Azure Files. |
If-Modified-Since |
facultatif. Une valeurDateTime. Spécifiez cet en-tête conditionnel pour placer l’objet blob uniquement si l’objet blob de destination a été modifié depuis la date/heure spécifiée. Si l’objet blob de destination n’a pas été modifié, le stockage Blob retourne le code d’état 412 (Échec de la condition préalable). |
If-Unmodified-Since |
facultatif. Une valeurDateTime. Spécifiez cet en-tête conditionnel pour placer l’objet blob uniquement si l’objet blob de destination n’a pas été modifié depuis la date/heure spécifiée. Si l’objet blob de destination a été modifié, le stockage Blob retourne le code d’état 412 (Échec de la condition préalable). |
If-Match |
facultatif. Valeur ETag. Spécifiez une valeur ETag pour cet en-tête conditionnel pour placer l’objet blob uniquement si la valeur ETag spécifiée correspond à la valeur ETag pour un objet blob de destination existant. Si l’ETag pour l’objet blob de destination ne correspond pas à l’ETag spécifié pour If-Match, le stockage Blob retourne le code d’état 412 (Échec de la condition préalable). |
If-None-Match |
facultatif. Valeur ETag ou caractère générique (*). Spécifiez une valeur ETag pour cet en-tête conditionnel pour placer l’objet blob uniquement si la valeur ETag spécifiée ne correspond pas à la valeur ETag pour l’objet blob de destination. Spécifiez le caractère générique (*) pour effectuer l’opération uniquement si l’objet blob de destination n’existe pas. Si la condition spécifiée n’est pas remplie, le stockage Blob retourne le code d’état 412 (Échec de la condition préalable). |
x-ms-lease-id:<ID> |
Obligatoire si l’objet blob a un bail actif. Pour effectuer cette opération sur un objet blob avec un bail actif, spécifiez l’ID de bail valide pour cet en-tête. |
x-ms-blob-content-disposition |
facultatif. Définit l’en-tête Content-Disposition de l’objet blob. Disponible pour la version 2013-08-15 et ultérieure.Le champ d’en-tête de réponse Content-Disposition transmet des informations supplémentaires sur la façon de traiter la charge utile de réponse, et il peut être utilisé pour attacher des métadonnées supplémentaires. Par exemple, si l’en-tête est défini sur attachment, cela indique que l’agent utilisateur ne doit pas afficher la réponse. Au lieu de cela, il doit afficher une boîte de dialogue Enregistrer sous avec un nom de fichier autre que le nom d’objet blob spécifié.La réponse de l'Obtenir d’objets blob et obtenir des propriétés d’objet blob opérations inclut l’en-tête content-disposition. |
Origin |
facultatif. Spécifie l’origine à partir de laquelle la requête est émise. La présence de cet en-tête entraîne des en-têtes CORS (Cross-Origin Resource Sharing) sur la réponse. Pour plus d’informations, consultez prise en charge de CORS pour les services stockage Azure. |
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 (KiB) enregistrée dans les journaux d’activité d’analytique lorsque la journalisation d’analyse de stockage est activée. 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. |
x-ms-access-tier |
facultatif. Indique le niveau à définir sur l’objet blob. Les valeurs valides pour les niveaux d’objets blob de blocs sont Hot, Cool, Coldet Archive.
Remarque: Cold niveau est pris en charge pour la version 2021-12-02 et ultérieure.
Hot, Coolet Archive sont pris en charge pour la version 2018-11-09 et ultérieure. Pour plus d’informations sur la hiérarchisation des objets blob de blocs, consultez niveaux de stockage chaud, froid et archive. |
x-ms-expiry-option |
facultatif. Version 2023-08-03 et ultérieure. Spécifie l’option de date d’expiration de la requête. Pour plus d’informations, consultez ExpiryOption . Cet en-tête est valide pour les comptes dont l’espace de noms hiérarchique est activé. |
x-ms-expiry-time |
facultatif. Version 2023-08-03 et ultérieure. Spécifie l’heure à laquelle l’objet blob est défini pour expirer. Le format de la date d’expiration varie en fonction de x-ms-expiry-option. Pour plus d’informations, consultez ExpiryOption . Cet en-tête est valide pour les comptes dont l’espace de noms hiérarchique est activé. |
Cette opération prend également en charge l’utilisation d’en-têtes conditionnels pour écrire l’objet blob uniquement si une certaine condition est remplie. Pour plus d’informations, consultez Spécifier des en-têtes conditionnels pour les opérations de stockage Blob.
En-têtes de requête (clés de chiffrement fournies par le client)
Les en-têtes suivants peuvent être spécifiés sur la demande pour chiffrer un objet blob avec une clé fournie par le client. Le chiffrement avec une clé fournie par le client (et l’ensemble d’en-têtes correspondant) est facultatif.
| En-tête de requête | Description |
|---|---|
x-ms-encryption-key |
Obligatoire. Clé de chiffrement AES-256 codée en base64. |
x-ms-encryption-key-sha256 |
Obligatoire. Hachage SHA256 codé en Base64 de la clé de chiffrement. |
x-ms-encryption-algorithm: AES256 |
Obligatoire. Spécifie l’algorithme à utiliser pour le chiffrement. La valeur de cet en-tête doit être AES256. |
Corps de la demande
Aucun.
Exemple de requête
L’exemple suivant montre une demande de création d’un objet blob de blocs :
Request Syntax:
PUT https://myaccount.blob.core.windows.net/mycontainer/myblockblob HTTP/1.1
Request Headers:
x-ms-version: 2020-04-08
x-ms-date: <date>
Content-Type: text/plain; charset=UTF-8
x-ms-blob-content-disposition: attachment; filename="fname.ext"
x-ms-blob-type: BlockBlob
x-ms-meta-m1: v1
x-ms-meta-m2: v2
x-ms-copy-source: https://myaccount.blob.core.windows.net/mycontainer/myblob
x-ms-expiry-option: RelativeToNow
x-ms-expiry-time: 30000
Authorization: SharedKey myaccount:YhuFJjN4fAR8/AmBrqBz7MG2uFinQ4rkh4dscbj598g=
Content-Length: 0
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 retourne le code d’état 201 (créé).
Pour plus d’informations sur les codes d’état, consultez Les codes d’état et d’erreur.
En-têtes de réponse
La réponse de cette 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 de protocole HTTP/1.1
| En-tête de réponse | Description |
|---|---|
ETag |
L’ETag contient une valeur que le client peut utiliser pour effectuer des opérations de PUT conditionnelles à l’aide de l’en-tête de requête If-Match. La valeur ETag est placée entre guillemets. |
Last-Modified |
Date/heure de la dernière modification de l’objet blob. Le format de date suit RFC 1123. Pour plus d’informations, consultez Représenter les valeurs de date/heure dans les en-têtes. Toute opération d’écriture sur l’objet blob (y compris les mises à jour sur les métadonnées ou propriétés de l’objet blob) modifie l’heure de dernière modification de l’objet blob. |
Content-MD5 |
Retourné pour un objet blob de blocs afin que le client puisse vérifier l’intégrité du contenu du message. La valeur Content-MD5 retournée est calculée par Stockage Blob. Cet en-tête est retourné même lorsque la requête n’inclut pas Content-MD5 ou x-ms-blob-content-md5 en-têtes. |
x-ms-content-crc64 |
Retourné pour un objet blob de blocs afin que le client puisse vérifier l’intégrité du contenu du message. La valeur x-ms-content-crc64 retournée est calculée par Stockage Blob. Cet en-tête est toujours retourné. |
x-ms-request-id |
Identifie de manière unique la demande qui a été effectuée et vous pouvez l’utiliser pour résoudre la demande. Pour plus d’informations, consultez Résoudre les problèmes d’opérations d’API. |
x-ms-version |
Version du stockage d’objets blob utilisée pour exécuter la requête. |
Date |
Valeur de date/heure UTC générée par le service, qui indique l’heure à laquelle la réponse a été lancée. |
Access-Control-Allow-Origin |
Retourné si la requête inclut un en-tête Origin et CORS est activé avec une règle correspondante. Cet en-tête retourne la valeur de l’en-tête de demande d’origine en cas de correspondance. |
Access-Control-Expose-Headers |
Retourné si la requête inclut un en-tête Origin et CORS est activé avec une règle correspondante. Retourne la liste des en-têtes de réponse à exposer au client ou à l’émetteur de la demande. |
Access-Control-Allow-Credentials |
Retourné si la requête inclut un en-tête Origin et CORS est activé avec une règle correspondante qui n’autorise pas toutes les origines. Cet en-tête est défini sur true. |
x-ms-request-server-encrypted: true/false |
La valeur de cet en-tête est définie sur true si le contenu de la requête est correctement chiffré à l’aide de l’algorithme spécifié. Sinon, la valeur est définie sur false. |
x-ms-encryption-key-sha256 |
Retourné si la demande a utilisé une clé fournie par le client pour le chiffrement, afin que le client puisse s’assurer que le contenu de la demande est correctement chiffré à l’aide de la clé fournie. |
x-ms-encryption-scope |
Retourné si la requête a utilisé une étendue de chiffrement, afin que le client puisse s’assurer que le contenu de la demande est correctement chiffré à l’aide de l’étendue de chiffrement. |
x-ms-version-id: <DateTime> |
Retourne une valeur DateTime opaque qui identifie de manière unique l’objet blob. La valeur de cet en-tête indique la version de l’objet blob et peut être utilisée dans les requêtes suivantes pour accéder à l’objet blob. |
Corps de la réponse
Aucun.
Exemple de réponse
Response Status:
HTTP/1.1 201 Created
Response Headers:
Transfer-Encoding: chunked
Content-MD5: sQqNsWTgdUEFt6mb5y4/5Q==
x-ms-content-crc64: 77uWZTolTHU
Date: <date>
ETag: "0x8CB171BA9E94B0B"
Last-Modified: <date>
Access-Control-Allow-Origin: http://contoso.com
Access-Control-Expose-Headers: Content-MD5
Access-Control-Allow-Credentials: True
Server: Windows-Azure-Blob/1.0 Microsoft-HTTPAPI/2.0
x-ms-version-id: <DateTime>
l’autorisation,
L’autorisation est requise lors de l’appel d’une opération d’accès aux données dans stockage Azure. Vous pouvez autoriser l’opération de Put Blob From URL comme décrit ci-dessous.
Si une demande spécifie des balises avec l’en-tête de requête x-ms-tags, l’appelant doit respecter les exigences d’autorisation de l'Définir des balises d’objet blob opération.
Important
Microsoft recommande d’utiliser l’ID Microsoft Entra avec des identités managées pour autoriser les demandes adressées au stockage Azure. Microsoft Entra ID offre une sécurité et une facilité d’utilisation supérieures par rapport à l’autorisation de clé partagée.
Stockage Azure prend en charge l’utilisation de l’ID Microsoft Entra pour autoriser les demandes aux données d’objet blob. Avec l’ID Microsoft Entra, vous pouvez utiliser le contrôle d’accès en fonction du rôle Azure (Azure RBAC) pour accorder des autorisations à un principal de sécurité. Le principal de sécurité peut être un utilisateur, un groupe, un principal de service d’application ou une identité managée Azure. Le principal de sécurité est authentifié par l’ID Microsoft Entra pour retourner un jeton OAuth 2.0. Le jeton peut ensuite être utilisé pour autoriser une demande auprès du service Blob.
Pour en savoir plus sur l’autorisation à l’aide de l’ID Microsoft Entra, consultez Autoriser l’accès aux objets blob à l’aide de Microsoft Entra ID.
Autorisations
Voici l’action RBAC nécessaire pour un utilisateur, un groupe, une identité managée ou un principal de service Microsoft Entra pour appeler l’opération de Put Blob From URL et le rôle RBAC Azure intégré le moins privilégié qui inclut cette action :
-
action Azure RBAC :
- Créer un objet blob de blocs : Microsoft.Storage/storageAccounts/blobServices/containers/blobs/add/action
- Créez ou remplacez un objet blob de blocs existant : Microsoft.Storage/storageAccounts/blobServices/containers/blobs/write
- rôle intégré moins privilégié :Contributeur aux données Blob de stockage
Pour en savoir plus sur l’attribution de rôles à l’aide d’Azure RBAC, consultez Attribuer un rôle Azure pour accéder aux données blob.
Remarques
L’opération Put Blob From URL est prise en charge à compter de la version 2020-04-08.
Dans la version 2020-10-02 et ultérieure, l’autorisation Microsoft Entra est prise en charge pour la source de l’opération de copie.
L’objet blob source peut être de n’importe quel type, y compris un objet blob de blocs, un objet blob d’ajout ou un objet blob de pages. Toutefois, l’objet blob de destination doit être un objet blob de blocs.
L’opération Put Blob From URL copie toujours l’intégralité de l’objet 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, reportez-vous à Put Block From URL. L’objet blob de destination peut être un objet blob de blocs existant, ou il peut s’agir d’un objet blob créé par l’opération.
Lorsque vous utilisez un objet blob de blocs comme objet source, tout le contenu d’objet blob validé est copié. Toutefois, la liste de blocs n’est 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.
Put Blob properties and metadata
Lorsque vous créez un objet blob de blocs à partir d’une source de copie, les propriétés d’objet blob standard sont copiées par défaut à partir de l’objet blob source. Si les métadonnées de l’application sont spécifiées dans la requête, elles sont stockées sans copier les métadonnées d’objet blob source. Pour définir explicitement les en-têtes de contenu HTTP, vous pouvez spécifier l’en-tête correspondant dans la requête.
Content-TypeContent-EncodingContent-LengthCache-ControlContent-Disposition
La taille de l’objet blob de destination correspond toujours à celle de l’objet blob source. L’en-tête Content-Length doit être 0 dans la requête Put Blob From URL (car il n’y a pas de corps de requête), et la propriété de longueur de contenu de l’objet blob de destination est déduite de la taille de la source.
placer des propriétés personnalisées d’URL à partir d’objets blob
Put Blob From Url suit la même sémantique que Put Blob pour définir des propriétés personnalisées associées à des en-têtes HTTP standard. Pour plus d’informations, consultez propriétés personnalisées d’objets blob
balises d’index d’objets blob
Si des balises pour l’objet blob de destination sont fournies dans l’en-tête x-ms-tags, elles doivent être encodées sous forme de chaîne de requête. Les clés et valeurs de balise doivent être conformes aux exigences de nommage et de longueur spécifiées dans Set Blob Tags. En outre, l’en-tête x-ms-tags peut contenir jusqu’à 2 Kio de balises. Si d’autres balises sont requises, utilisez l’opération de Set Blob Tags.
Si les balises ne sont pas fournies dans l’en-tête x-ms-tags, elles ne sont pas copiées à partir de l’objet blob source.
étendues de chiffrement et clés fournies par le client
L’API Put Blob From URL prend en charge les étendues de chiffrement et les clés fournies par le client à l’aide des en-têtes x-ms-encryption-scope et x-ms-encryption-key, respectivement.
Si l’en-tête x-ms-copy-source fait référence au même objet blob source que l’objet blob de destination dans l’URI de requête, l’opération Put Blob From URL effectue une réécriture synchrone sur place de l’objet blob. Cela permet de réécrire un objet blob pour utiliser une autre clé de chiffrement ou une autre étendue de chiffrement.
Facturation
Les demandes de tarification peuvent provenir de clients qui utilisent des API Stockage Blob, directement via l’API REST Stockage Blob ou à partir d’une bibliothèque cliente Stockage Azure. Ces demandes accumulent des frais par transaction. Le type de transaction affecte la façon dont le compte est facturé. Par exemple, les transactions de lecture s’accumulent dans une catégorie de facturation différente de celle des transactions en écriture. Le tableau suivant montre la catégorie de facturation pour les requêtes Put Blob From URL en fonction du type de compte de stockage :
| Opération | Type de compte de stockage | Catégorie de facturation |
|---|---|---|
| Placer l’URL d’objet blob (compte de destination1) | Objet blob de blocs Premium Standard v2 à usage général Standard v1 à usage général |
Opérations d’écriture |
| Placer l’URL d’objet blob (compte source2) | Objet blob de blocs Premium Standard v2 à usage général Standard v1 à usage général |
Lire les opérations |
1Le compte de destination est facturé pour une transaction pour lancer l’écriture.
2Le compte source entraîne une transaction pour chaque demande de lecture à l’objet source.
En outre, si les comptes source et de destination résident dans différentes régions (par exemple, USA Nord et USA Sud), la bande passante utilisée pour transférer la demande est facturée au compte de stockage source comme sortie. La sortie entre les comptes au sein de la même région est gratuite.
Enfin, la création d’un objet blob avec un nom différent dans le même compte de stockage utilise des ressources de stockage supplémentaires. L’opération entraîne donc des frais sur l’utilisation de capacité du compte de stockage pour ces ressources supplémentaires.
Pour en savoir plus sur la tarification des catégories de facturation spécifiées, consultez tarification du Stockage Blob Azure.
Voir aussi
Autoriser les demandes adressées au stockage AzureÉtat et codes d’erreurcodes d’erreur du service BlobDéfinir des délais d’attente pour les opérations du service Blob