Blob van URL plaatsen

  • Artikel

Met Put Blob From URL de bewerking wordt een nieuwe blok-blob gemaakt waarin de inhoud van de blob wordt gelezen vanaf een opgegeven URL. Deze API is beschikbaar vanaf versie 2020-04-08.

Gedeeltelijke updates worden niet ondersteund met Put Blob From URL. De inhoud van een bestaande blob wordt overschreven met de inhoud van de nieuwe blob. Als u gedeeltelijke updates wilt uitvoeren voor de inhoud van een blok-blob met behulp van een bron-URL, gebruikt u de API Put Blob From URL in combinatie met Put Block List.

De grootte van de bron-blob kan maximaal 5000 mebibytes (MiB) zijn.

Aanvraag

U kunt de Put Blob From URL volgende maken. U wordt aangeraden HTTPS te gebruiken. Vervang myaccount door de naam van uw opslagaccount:

AANVRAAG-URI voor PUT-methode HTTP-versie
https://myaccount.blob.core.windows.net/mycontainer/myblob HTTP/1.1

Aanvraag voor geëmuleerde opslagservice

Wanneer u een aanvraag doet voor de geëmuleerde opslagservice, geeft u de hostnaam van de emulator en de blobservicepoort op als 127.0.0.1:10000, gevolgd door de naam van het geëmuleerde opslagaccount:

AANVRAAG-URI voor PUT-methode HTTP-versie
http://127.0.0.1:10000/devstoreaccount1/mycontainer/myblob HTTP/1.1

De opslagemulator ondersteunt alleen blobgrootten van maximaal 2 gibibytes (GiB).

Zie Use the Azurite emulator for local Azure Storage development (De Azurite-emulator gebruiken voor lokale Azure Storage-ontwikkeling) voor meer informatie.

URI-parameters

De volgende aanvullende parameters kunnen worden opgegeven voor de aanvraag-URI:

Parameter Beschrijving
timeout Optioneel. De timeout parameter wordt uitgedrukt in seconden. Zie Time-outs instellen voor blobservicebewerkingen voor meer informatie.

Aanvraagheaders

De vereiste en optionele aanvraagheaders worden beschreven in de volgende tabel:

Aanvraagheader Beschrijving
Authorization Vereist. Hiermee geeft u het autorisatieschema, de accountnaam en de handtekening. Zie Aanvragen voor Azure Storage autoriseren voor meer informatie.
Date of x-ms-date Vereist. Geef de Coordinated Universal Time (UTC) op voor de aanvraag. Zie Aanvragen voor Azure Storage autoriseren voor meer informatie.
x-ms-version Vereist voor alle geautoriseerde aanvragen. Hiermee geeft u de versie van de bewerking te gebruiken voor deze aanvraag. Zie Versiebeheer voor de Azure Storage-services voor meer informatie.
Content-Length Vereist. Hiermee geeft u het aantal bytes dat wordt verzonden in de aanvraagbody. De waarde van deze header moet worden ingesteld op 0. Wanneer de lengte niet 0 is, mislukt de bewerking met de statuscode 400 (Ongeldige aanvraag).
x-ms-copy-source:name Vereist. Hiermee geeft u de URL van de bron-blob. De waarde kan een URL van maximaal 2 kibibytes (KiB) zijn die een blob aangeeft. De waarde moet URL-gecodeerd zijn zoals deze wordt weergegeven in een aanvraag-URI. De bron-blob moet openbaar zijn of zijn geautoriseerd via een shared access signature. Als de bron-blob openbaar is, is er geen autorisatie vereist om de bewerking uit te voeren. Als de grootte van de bron-blob groter is dan 5000 MiB of als de bron geen geldige Content-Length waarde retourneert, mislukt de aanvraag met statuscode 409 (conflict). Hier volgen enkele voorbeelden van bronobject-URL's:

- 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> Optioneel. Hiermee geeft u het autorisatieschema en de handtekening voor de kopieerbron. Zie Aanvragen voor Azure Storage autoriseren voor meer informatie.
Alleen schema bearer wordt ondersteund voor Azure Active Directory.
Deze header wordt ondersteund in versie 2020-10-02 en hoger.
x-ms-blob-type: BlockBlob Vereist. Hiermee geeft u het type blob te maken, dat moet zijn BlockBlob. Als het blobtype niet BlockBlobis, mislukt de bewerking met statuscode 400 (Ongeldige aanvraag).
Content-Type Optioneel. Het MIME-inhoudstype van de blob. Het standaardtype is application/octet-stream.
Content-Encoding Optioneel. Hiermee geeft u op welke inhoudscoderingen zijn toegepast op de blob. Deze waarde wordt geretourneerd naar de client wanneer de bewerking Blob ophalen wordt uitgevoerd op de blobresource. Wanneer deze waarde wordt geretourneerd, kan de client deze gebruiken om de blobinhoud te decoderen.
Content-Language Optioneel. Hiermee geeft u de natuurlijke talen die door deze resource worden gebruikt.
Cache-Control Optioneel. Blob Storage slaat deze waarde op, maar gebruikt of wijzigt deze niet.
x-ms-source-content-md5 Optioneel. Een MD5-hash van de blob-inhoud van de URI. Deze hash wordt gebruikt om de integriteit van de blob te controleren tijdens het transport van de gegevens uit de URI. Wanneer deze header is opgegeven, vergelijkt de opslagservice de hash van de inhoud die afkomstig is van de kopieerbron met deze headerwaarde. Als u deze header weglaat, genereert Blob Storage een MD5-hash.

Als de twee hashes niet overeenkomen, mislukt de bewerking met foutcode 400 (Ongeldige aanvraag).
x-ms-content-crc64 Optioneel. Een CRC64-hash van de blobinhoud. Deze hash wordt gebruikt om de integriteit van de blob tijdens het transport te controleren. Wanneer deze header is opgegeven, controleert de opslagservice de hash die is aangekomen ten opzichte van de hash die is verzonden. Als de twee hashes niet overeenkomen, mislukt de bewerking met foutcode 400 (Ongeldige aanvraag). Deze header wordt ondersteund in versie 02-02-2019 en hoger.

Als zowel Content-MD5- als x-ms-content-crc64-headers aanwezig zijn, mislukt de aanvraag met een 400 (Ongeldige aanvraag).
x-ms-blob-content-type Optioneel. Hiermee stelt u het inhoudstype van de blob in.
x-ms-blob-content-encoding Optioneel. Hiermee stelt u de inhoudscodering van de blob in.
x-ms-blob-content-language Optioneel. Hiermee stelt u de inhoudstaal van de blob in.
x-ms-blob-content-md5 Optioneel. Hiermee stelt u de MD5-hash van de blob in.
x-ms-blob-cache-control Optioneel. Hiermee stelt u het cachebeheer van de blob in.
x-ms-meta-name:value Optioneel. De naam-waardeparen die als metagegevens aan de blob zijn gekoppeld.

Opmerking: vanaf versie 2009-09-19 moeten metagegevensnamen voldoen aan de naamgevingsregels voor C#-id's.
x-ms-encryption-scope Optioneel. Het versleutelingsbereik dat moet worden gebruikt om de inhoud van de aanvraag te versleutelen. Deze header wordt ondersteund in versie 2019-02-02 en hoger.
x-ms-tags Optioneel. Hiermee stelt u de opgegeven query-tekenreeks gecodeerde tags op de blob. Ga voor meer informatie naar de sectie Opmerkingen . Ondersteund in versie 2019-12-12 en hoger.
x-ms-copy-source-tag-option Optioneel. Mogelijke waarden zijn REPLACE of COPY (hoofdlettergevoelig). De standaardwaarde is VERVANGEN.

Als COPY is opgegeven, worden de tags van de bron-blob gekopieerd naar de doel-blob. De bron-blob moet privé zijn en de aanvraag moet machtigingen hebben voor Het ophalen van blobtags op de bron-blob en het instellen van blobtags op de doel-blob. Hierdoor wordt de bewerking Blobtags ophalen voor het bronaccount extra aangeroepen.

Met VERVANGEN worden tags ingesteld die zijn opgegeven door de x-ms-tags header op de doel-blob. Als REPLACE wordt gebruikt en er geen tags zijn opgegeven door x-ms-tags, worden er geen tags ingesteld op de doel-blob. Het opgeven van COPY en x-ms-tags resulteert in een 409 (conflict).

Ondersteund in versie 2021-04-10 en hoger.
x-ms-copy-source-blob-properties Optioneel. Hiermee geeft u het gedrag van de eigenschappen van de bron-blob kopiëren op. Als dit is ingesteld op True, worden de eigenschappen van de bron-blob gekopieerd naar de nieuwe blob. De standaardwaarde is True.
x-ms-source-if-modified-since Optioneel. Een DateTime waarde. Geef deze voorwaardelijke header op om de blob alleen te plaatsen als de bron-blob is gewijzigd sinds de opgegeven datum/tijd. Als de bron-blob niet is gewijzigd, retourneert Blob Storage statuscode 412 (voorwaarde mislukt). Deze header kan niet worden opgegeven als de bron een Azure Files share is.
x-ms-source-if-unmodified-since Optioneel. Een DateTime waarde. Geef deze voorwaardelijke header op om de blob alleen te plaatsen als de bron-blob niet is gewijzigd sinds de opgegeven datum/tijd. Als de bron-blob is gewijzigd, retourneert Blob Storage statuscode 412 (voorwaarde mislukt). Deze header kan niet worden opgegeven als de bron een Azure Files share is.
x-ms-source-if-match Optioneel. Een ETag-waarde. Geef deze voorwaardelijke header op om de bron-blob alleen te plaatsen als de ETag overeenkomt met de opgegeven waarde. Als de ETag-waarden niet overeenkomen, retourneert Blob Storage statuscode 412 (voorwaarde mislukt). Deze header kan niet worden opgegeven als de bron een Azure Files share is.
x-ms-source-if-none-match Optioneel. Een ETag-waarde. Geef deze voorwaardelijke header op om de blob alleen te plaatsen als de ETag niet overeenkomt met de opgegeven waarde. Als de waarden identiek zijn, retourneert Blob Storage statuscode 412 (voorwaarde mislukt). Deze header kan niet worden opgegeven als de bron een Azure Files share is.
If-Modified-Since Optioneel. Een DateTime waarde. Geef deze voorwaardelijke header op om de blob alleen te plaatsen als de doel-blob is gewijzigd sinds de opgegeven datum/tijd. Als de doel-blob niet is gewijzigd, retourneert Blob Storage statuscode 412 (voorwaarde mislukt).
If-Unmodified-Since Optioneel. Een DateTime waarde. Geef deze voorwaardelijke header op om de blob alleen te plaatsen als de doel-blob niet is gewijzigd sinds de opgegeven datum/tijd. Als de doel-blob is gewijzigd, retourneert Blob Storage statuscode 412 (voorwaarde mislukt).
If-Match Optioneel. Een ETag-waarde. Geef een ETag-waarde op voor deze voorwaardelijke header om de blob alleen te plaatsen als de opgegeven ETag-waarde overeenkomt met de ETag waarde voor een bestaande doel-blob. Als de ETag voor de doel-blob niet overeenkomt met de ETag die is opgegeven voor If-Match, retourneert Blob Storage statuscode 412 (voorwaarde mislukt).
If-None-Match Optioneel. Een ETag-waarde of het jokerteken (*).

Geef een ETag-waarde op voor deze voorwaardelijke header om de blob alleen te plaatsen als de opgegeven ETag-waarde niet overeenkomt met de ETag-waarde voor de doel-blob.

Geef het jokerteken (*) op om de bewerking alleen uit te voeren als de doel-blob niet bestaat.

Als niet aan de opgegeven voorwaarde wordt voldaan, retourneert Blob Storage statuscode 412 (voorwaarde mislukt).
x-ms-lease-id:<ID> Vereist als de blob een actieve lease heeft. Als u deze bewerking wilt uitvoeren op een blob met een actieve lease, geeft u de geldige lease-id voor deze header op.
x-ms-blob-content-disposition Optioneel. Hiermee stelt u de koptekst van Content-Disposition de blob in. Beschikbaar voor versie 2013-08-15 en hoger.

Het Content-Disposition veld antwoordheader bevat aanvullende informatie over het verwerken van de nettolading van het antwoord en kan worden gebruikt om extra metagegevens toe te voegen. Als de header bijvoorbeeld is ingesteld op attachment, geeft dit aan dat de user-agent het antwoord niet mag weergeven. In plaats daarvan wordt het dialoogvenster Opslaan als weergegeven met een andere bestandsnaam dan de opgegeven blobnaam.

Het antwoord van de bewerkingen Blob ophalen en Eigenschappen van blob ophalen bevat de content-disposition header.
Origin Optioneel. Hiermee geeft u de oorsprong van waaruit de aanvraag wordt uitgegeven. De aanwezigheid van deze header resulteert in CORS-headers (Cross-Origin Resource Sharing) in het antwoord. Zie CORS-ondersteuning voor de Azure Storage-services voor meer informatie.
x-ms-client-request-id Optioneel. Biedt een door de client gegenereerde, ondoorzichtige waarde met een limiet van 1 kibibyte (KiB) die wordt vastgelegd in de analyselogboeken wanneer logboekregistratie van opslaganalyse is ingeschakeld. We raden u ten zeerste aan deze header te gebruiken om activiteiten aan de clientzijde te correleren met aanvragen die de server ontvangt.
x-ms-access-tier Optioneel. Geeft de laag aan die moet worden ingesteld voor de blob. Geldige waarden voor blok-bloblagen zijn Hot, Cool, Colden Archive. Opmerking: Cold laag wordt ondersteund voor versie 2021-12-02 en hoger. Hot, Coolen Archive worden ondersteund voor versie 2018-11-09 en hoger. Zie Dynamische, statische en archiefopslaglagen voor meer informatie over opslaglagen voor blokblobs.
x-ms-expiry-option Optioneel. Versie 2023-08-03 en hoger. Hiermee geeft u de vervaldatumoptie voor de aanvraag op. Zie ExpiryOption voor meer informatie. Deze header is geldig voor accounts waarvoor hiërarchische naamruimte is ingeschakeld.
x-ms-expiry-time Optioneel. Versie 2023-08-03 en hoger. Hiermee geeft u het tijdstip op waarop de blob is ingesteld om te verlopen. De notatie voor de vervaldatum is afhankelijk van x-ms-expiry-option. Zie ExpiryOption voor meer informatie. Deze header is geldig voor accounts waarvoor hiërarchische naamruimte is ingeschakeld.

Deze bewerking ondersteunt ook het gebruik van voorwaardelijke headers om de blob alleen te schrijven als aan een bepaalde voorwaarde wordt voldaan. Zie Voorwaardelijke headers opgeven voor Blob Storage-bewerkingen voor meer informatie.

Aanvraagheaders (door de klant verstrekte versleutelingssleutels)

De volgende headers kunnen worden opgegeven in de aanvraag om een blob te versleutelen met een door de klant opgegeven sleutel. Versleuteling met een door de klant verstrekte sleutel (en de bijbehorende set headers) is optioneel.

Aanvraagheader Beschrijving
x-ms-encryption-key Vereist. De met Base64 gecodeerde AES-256-versleutelingssleutel.
x-ms-encryption-key-sha256 Vereist. De Base64-gecodeerde SHA256-hash van de versleutelingssleutel.
x-ms-encryption-algorithm: AES256 Vereist. Hiermee geeft u het algoritme te gebruiken voor versleuteling. De waarde van deze header moet zijn AES256.

Aanvraagbody

Geen.

Voorbeeldaanvraag

In het volgende voorbeeld ziet u een aanvraag voor het maken van een blok-blob:

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

Antwoord

Het antwoord bevat een HTTP-statuscode en een set antwoordheaders.

Statuscode

Een geslaagde bewerking retourneert statuscode 201 (gemaakt).

Zie Status- en foutcodes voor meer informatie over statuscodes.

Antwoordheaders

Het antwoord voor deze bewerking bevat de volgende headers. Het antwoord kan ook extra standaard-HTTP-headers bevatten. Alle standaardheaders voldoen aan de HTTP/1.1-protocolspecificatie.

Antwoordheader Description
ETag De ETag bevat een waarde die de client kan gebruiken om voorwaardelijke PUT bewerkingen uit te voeren met behulp van de If-Match aanvraagheader. De ETag-waarde staat tussen aanhalingstekens.
Last-Modified De datum/tijd waarop de blob voor het laatst is gewijzigd. De datumnotatie volgt RFC 1123. Zie Datum-/tijdwaarden weergeven in kopteksten voor meer informatie.

Elke schrijfbewerking op de blob (inclusief updates voor de metagegevens of eigenschappen van de blob) verandert de laatste wijzigingstijd van de blob.
Content-MD5 Geretourneerd voor een blok-blob, zodat de client de integriteit van de berichtinhoud kan controleren. De Content-MD5 geretourneerde waarde wordt berekend door Blob Storage. Deze header wordt geretourneerd, zelfs wanneer de aanvraag geen headers bevatContent-MD5.x-ms-blob-content-md5
x-ms-content-crc64 Geretourneerd voor een blok-blob, zodat de client de integriteit van de berichtinhoud kan controleren. De x-ms-content-crc64 geretourneerde waarde wordt berekend door Blob Storage. Deze header wordt altijd geretourneerd.
x-ms-request-id Identificeert op unieke wijze de aanvraag die is gedaan en u kunt deze gebruiken om problemen met de aanvraag op te lossen. Zie Problemen met API-bewerkingen oplossen voor meer informatie.
x-ms-version De versie van Blob Storage die is gebruikt om de aanvraag uit te voeren.
Date Een UTC-datum/tijd-waarde die wordt gegenereerd door de service, die de tijd aangeeft waarop het antwoord is gestart.
Access-Control-Allow-Origin Wordt geretourneerd als de aanvraag een Origin header bevat en CORS is ingeschakeld met een overeenkomende regel. Deze header retourneert de waarde van de aanvraagheader van de oorsprong als er een overeenkomst is.
Access-Control-Expose-Headers Wordt geretourneerd als de aanvraag een Origin header bevat en CORS is ingeschakeld met een overeenkomende regel. Retourneert de lijst met antwoordheaders die moeten worden weergegeven voor de client of verlener van de aanvraag.
Access-Control-Allow-Credentials Wordt geretourneerd als de aanvraag een Origin header bevat en CORS is ingeschakeld met een overeenkomende regel die niet alle origins toestaat. Deze header is ingesteld op true.
x-ms-request-server-encrypted: true/false De waarde van deze header wordt ingesteld op true als de inhoud van de aanvraag is versleuteld met behulp van het opgegeven algoritme. Anders wordt de waarde ingesteld op false.
x-ms-encryption-key-sha256 Wordt geretourneerd als de aanvraag een door de klant verstrekte sleutel heeft gebruikt voor versleuteling, zodat de client ervoor kan zorgen dat de inhoud van de aanvraag is versleuteld met behulp van de opgegeven sleutel.
x-ms-encryption-scope Wordt geretourneerd als de aanvraag een versleutelingsbereik heeft gebruikt, zodat de client ervoor kan zorgen dat de inhoud van de aanvraag is versleuteld met behulp van het versleutelingsbereik.
x-ms-version-id: <DateTime> Retourneert een ondoorzichtige DateTime waarde die de blob uniek identificeert. De waarde van deze header geeft de versie van de blob aan en deze kan worden gebruikt in volgende aanvragen voor toegang tot de blob.

Hoofdtekst van de reactie

Geen.

Voorbeeldantwoord

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>

Autorisatie

Autorisatie is vereist bij het aanroepen van een bewerking voor gegevenstoegang in Azure Storage. U kunt de Put Blob From URL bewerking autoriseren zoals hieronder wordt beschreven.

Als een aanvraag tags met de x-ms-tags aanvraagheader opgeeft, moet de aanroeper voldoen aan de autorisatievereisten van de bewerking Blobtags instellen .

Azure Storage ondersteunt het gebruik van Microsoft Entra ID om aanvragen voor blobgegevens te autoriseren. Met Microsoft Entra ID kunt u op rollen gebaseerd toegangsbeheer van Azure (Azure RBAC) gebruiken om machtigingen te verlenen aan een beveiligingsprincipal. De beveiligingsprincipal kan een gebruiker, groep, toepassingsservice-principal of door Azure beheerde identiteit zijn. De beveiligingsprincipal wordt geverifieerd door Microsoft Entra ID om een OAuth 2.0-token te retourneren. Het token kan vervolgens worden gebruikt om een aanvraag voor de Blob-service te autoriseren.

Zie Toegang tot blobs autoriseren met behulp van Microsoft Entra ID voor meer informatie over autorisatie met behulp van Microsoft Entra ID.

Machtigingen

Hieronder vindt u de RBAC-actie die nodig is voor een Microsoft Entra gebruiker, groep of service-principal om de Put Blob From URL bewerking aan te roepen, en de ingebouwde Azure RBAC-rol met de minste bevoegdheden die deze actie omvat:

Zie Een Azure-rol toewijzen voor toegang tot blobgegevens voor meer informatie over het toewijzen van rollen met behulp van Azure RBAC.

Opmerkingen

De Put Blob From URL bewerking wordt ondersteund vanaf versie 2020-04-08.

In versie 2020-10-02 en hoger wordt Azure Active Directory-autorisatie ondersteund voor de bron van de kopieerbewerking.

De bron-blob kan van elk type zijn, inclusief een blok-blob, toevoeg-blob of pagina-blob. De doel-blob moet echter een blok-blob zijn.

De Put Blob From URL bewerking kopieert altijd de volledige bron-blob. Het kopiëren van een bereik van bytes of een set blokken wordt niet ondersteund. Als u gedeeltelijke updates wilt uitvoeren, raadpleegt u Blokkeren van URL plaatsen. De doel-blob kan een bestaande blok-blob zijn of een nieuwe blob die door de bewerking wordt gemaakt.

Wanneer u een blok-blob als bronobject gebruikt, wordt alle vastgelegde blob-inhoud gekopieerd. De blokkeringslijst blijft echter niet behouden en niet-doorgevoerde blokken worden niet gekopieerd. De inhoud van de doel-blob is identiek aan die van de bron, maar de lijst met vastgelegde blokkeringen blijft niet behouden.

Blob-eigenschappen en metagegevens plaatsen

Wanneer u een blok-blob maakt op basis van een kopieerbron, worden de standaard blobeigenschappen standaard gekopieerd uit de bron-blob. Als de metagegevens van de toepassing zijn opgegeven in de aanvraag, worden deze opgeslagen zonder de metagegevens van de bronblob te kopiëren. Als u http-inhoudsheaders expliciet wilt instellen, kunt u de bijbehorende header opgeven in de aanvraag.

  • Content-Type

  • Content-Encoding

  • Content-Length

  • Cache-Control

  • Content-Disposition

De grootte van de doel-blob komt altijd overeen met die van de bron-blob. De Content-Length header moet 0 in de Put Blob From URL aanvraag zijn (omdat er geen aanvraagbody is) en de eigenschap lengte van de inhoud voor de doel-blob wordt afgeleid uit de grootte van de bron.

Aangepaste eigenschappen van blob van URL plaatsen

Put Blob From Url volgt dezelfde semantiek als Put Blob voor het instellen van aangepaste eigenschappen die zijn gekoppeld aan standaard HTTP-headers. Zie Aangepaste blobeigenschappen voor meer informatie

Blob-indextags

Als tags voor de doel-blob zijn opgegeven in de x-ms-tags header, moeten ze worden gecodeerd met querytekenreeksen. Tagsleutels en -waarden moeten voldoen aan de naamgevings- en lengtevereisten zoals opgegeven in Set Blob Tags. Verder kan de x-ms-tags header maximaal 2 KiB tags bevatten. Als er meer tags nodig zijn, gebruikt u de Set Blob Tags bewerking.

Als tags niet zijn opgegeven in de x-ms-tags koptekst, worden ze niet gekopieerd uit de bron-blob.

Versleutelingsbereiken en door de klant verstrekte sleutels

De Put Blob From URL-API ondersteunt zowel versleutelingsbereiken als door de klant verstrekte sleutels, met behulp van respectievelijk de x-ms-encryption-scope headers en x-ms-encryption-key .

Als de x-ms-copy-source header verwijst naar dezelfde bron-blob als de doel-blob in de aanvraag-URI, voert de Put Blob From URL bewerking een synchrone herschrijving van de blob ter plaatse uit. Hierdoor kunt u een blob herschrijven om een andere versleutelingssleutel of versleutelingsbereik te gebruiken.

Billing

Prijsaanvragen kunnen afkomstig zijn van clients die gebruikmaken van Blob Storage-API's, rechtstreeks via de Blob Storage REST API of vanuit een Azure Storage-clientbibliotheek. Met deze aanvragen worden kosten per transactie in rekening gebracht. Het type transactie is van invloed op de manier waarop de rekening in rekening wordt gebracht. Leestransacties hebben bijvoorbeeld een andere factureringscategorie dan schrijftransacties. In de volgende tabel ziet u de factureringscategorie voor Put Blob From URL aanvragen op basis van het type opslagaccount:

Bewerking Type opslagaccount Factureringscategorie
Blob van URL plaatsen (doelaccount1) Premium blok-blob
Standaard v2 voor algemeen gebruik
Standaard v1 voor algemeen gebruik		 Schrijfbewerkingen
Blob van URL plaatsen (bronaccount2) Premium blok-blob
Standaard v2 voor algemeen gebruik
Standaard v1 voor algemeen gebruik		 Leesbewerkingen

1Het doelaccount wordt in rekening gebracht voor één transactie om de schrijfbewerking te starten.
2Het bronaccount maakt één transactie voor elke leesaanvraag naar het bronobject.

Als de bron- en doelaccounts zich in verschillende regio's bevinden (bijvoorbeeld US - noord en US - zuid), wordt de bandbreedte die wordt gebruikt voor het overdragen van de aanvraag als uitgaand verkeer in rekening gebracht bij het bronopslagaccount. Uitgaand verkeer tussen accounts binnen dezelfde regio is gratis.

Ten slotte maakt het maken van een nieuwe blob met een andere naam in hetzelfde opslagaccount gebruik van extra opslagresources, zodat de bewerking resulteert in een kosten voor het capaciteitsgebruik van het opslagaccount voor die extra resources.

Zie prijzen voor Azure Blob Storage voor meer informatie over prijzen voor de opgegeven factureringscategorieën.

Zie ook

Aanvragen autoriseren voor AzureStorage-status en foutcodesBlob-servicefoutcodesTime-outs instellen voor blobservicebewerkingen