Blob plaatsen

  • Artikel

Met Put Blob de bewerking wordt een nieuwe blok-, pagina- of toevoeg-blob gemaakt of de inhoud van een bestaande blok-blob bijgewerkt. De Put Blob bewerking overschrijft alle inhoud van een bestaande blob met dezelfde naam.

Wanneer u een bestaande blok-blob bijwerkt, overschrijft u alle bestaande metagegevens op de blob. De inhoud van de bestaande blob wordt overschreven met de inhoud van de nieuwe blob. Gedeeltelijke updates worden niet ondersteund met Put Blob. Als u een gedeeltelijke update van de inhoud van een blok-blob wilt uitvoeren, gebruikt u de bewerking Lijst met blokken plaatsen .

U kunt alleen een toevoeg-blob maken in versies 2015-02-21 en hoger.

Een aanroep naar een Put Blob om een pagina-blob of een toevoeg-blob te maken, initialiseert alleen de blob. Als de blob al bestaat, wordt de inhoud gewist. Als u inhoud wilt toevoegen aan een pagina-blob, roept u de bewerking Pagina plaatsen aan. Als u inhoud wilt toevoegen aan een toevoeg-blob, roept u de bewerking Toevoegblok aan .

Aanvraag

U kunt de Put Blob aanvraag als volgt samenstellen. 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 indient voor de geëmuleerde opslagservice, geeft u de hostnaam van de emulator en de poort van de Blob-service 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 (alle blobtypen)

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

Aanvraagheader Beschrijving
Authorization Vereist. Hiermee geeft u het autorisatieschema, de accountnaam en de handtekening op. Zie Aanvragen autoriseren voor Azure Storage voor meer informatie.
Date of x-ms-date Vereist. Geef de Coordinated Universal Time (UTC) op voor de aanvraag. Zie Aanvragen autoriseren voor Azure Storage 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. De lengte van de aanvraag.

Voor een pagina-blob of een toevoeg-blob moet de waarde van deze koptekst worden ingesteld op nul, omdat Put Blob alleen wordt gebruikt om de blob te initialiseren. Als u inhoud naar een bestaande pagina-blob wilt schrijven, roept u Pagina plaatsen aan. Als u inhoud naar een toevoeg-blob wilt schrijven, roept u Toevoegblok aan.
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 op die door deze resource worden gebruikt.
Content-MD5 Optioneel. Een MD5-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 met de hash die is verzonden. Als de twee hashes niet overeenkomen, mislukt de bewerking met foutcode 400 (ongeldige aanvraag).

Wanneer de header wordt weggelaten in versie 2012-02-12 of hoger, genereert Blob Storage een MD5-hash.

Resultaten van Get Blob, Get Blob Properties en List Blobs bevatten de MD5-hash.
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 met de hash die is verzonden. Als de twee hashes niet overeenkomen, mislukt de bewerking met foutcode 400 (ongeldige aanvraag). Deze header wordt ondersteund in versies 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).
Cache-Control Optioneel. Blob Storage slaat deze waarde op, maar gebruikt of wijzigt deze niet.
x-ms-blob-content-type Optioneel. Stel het inhoudstype van de blob in.
x-ms-blob-content-encoding Optioneel. Stel de inhoudscodering van de blob in.
x-ms-blob-content-language Optioneel. Stel de inhoudstaal van de blob in.
x-ms-blob-content-md5 Optioneel. Stel de MD5-hash van de blob in.
x-ms-blob-cache-control Optioneel. Hiermee stelt u het cachebeheer van de blob in.
x-ms-blob-type: <BlockBlob ¦ PageBlob ¦ AppendBlob> Vereist. Hiermee geeft u het type blob te maken: blok-blob, pagina-blob of toevoeg-blob. Ondersteuning voor het maken van een toevoeg-blob is alleen beschikbaar in versie 21-02-2015 en hoger.
x-ms-meta-name:value Optioneel. Naam-waardeparen die als metagegevens aan de blob zijn gekoppeld.

Opmerking: vanaf versie 2009-09-19 moeten namen van metagegevens voldoen aan de naamgevingsregels voor C#-id's.
x-ms-encryption-scope Optioneel. Geeft het versleutelingsbereik aan dat moet worden gebruikt om de inhoud van de aanvraag te versleutelen. Deze header wordt ondersteund in versies 2019-02-02 en hoger.
x-ms-encryption-context Optioneel. De standaardwaarde is Leeg. Als de waarde is ingesteld, worden de metagegevens van het blobsysteem ingesteld. Maximale lengte-1024. Alleen geldig wanneer hiërarchische naamruimte is ingeschakeld voor het account. Deze header wordt ondersteund in versies 2021-08-06 en hoger.
x-ms-tags Optioneel. Hiermee stelt u de opgegeven querytekenreeks gecodeerde tags op de blob. Zie de Opmerkingen voor meer informatie. Ondersteund in versie 2019-12-12 en hoger.
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 versies 2013-08-15 en hoger.

Het Content-Disposition veld antwoordheader bevat aanvullende informatie over het verwerken van de nettolading van het antwoord en u kunt deze gebruiken om aanvullende 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 moet het dialoogvenster Opslaan als worden weergegeven met een andere bestandsnaam dan de opgegeven blobnaam.

Het antwoord van de bewerkingen Blob ophalen en Blobeigenschappen ophalen bevat de content-disposition header.
Origin Optioneel. Hiermee geeft u de oorsprong op 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 is geconfigureerd. We raden u ten zeerste aan deze header te gebruiken om activiteiten aan de clientzijde te correleren met aanvragen die de server ontvangt. Zie Logboekregistratie van Opslaganalyse voor meer informatie.
x-ms-access-tier Optioneel. De laag die moet worden ingesteld op de blob. Voor pagina-blobs op een Premium Storage-account alleen met versie 2017-04-17 en hoger. Zie Premium-opslag met hoge prestaties en beheerde schijven voor virtuele machines (VM's) voor een volledige lijst met pagina-blob-ondersteunde lagen. Voor blok-blobs, alleen ondersteund op blobopslag- of v2-accounts voor algemeen gebruik met versie 2018-11-09 en hoger. Geldige waarden voor blok-bloblagen zijn Hot, Cool, Colden Archive. Opmerking: Cold laag wordt ondersteund voor versie 2021-12-02 en hoger. Zie Dynamische, statische en archiefopslaglagen voor gedetailleerde informatie over blok-bloblagen.
x-ms-immutability-policy-until-date Versie 2020-06-12 en hoger. Hiermee geeft u de retentie-tot-datum die moet worden ingesteld op de blob. Dit is de datum totdat de blob kan worden beveiligd tegen wijziging of verwijdering. Volgt RFC1123 indeling.
x-ms-immutability-policy-mode Versie 2020-06-12 en hoger. Hiermee geeft u de beleidsmodus voor onveranderbaarheid op die moet worden ingesteld op de blob. Geldige waarden zijn unlocked en locked. Met unlockedkunnen gebruikers het beleid wijzigen door de retentie-tot-datum te verhogen of te verlagen. Met lockedzijn deze acties verboden.
x-ms-legal-hold Versie 2020-06-12 en hoger. Hiermee geeft u de juridische bewaring moet worden ingesteld voor de blob. Geldige waarden zijn true en false.
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 opgegeven voorwaarde wordt voldaan. Zie Voorwaardelijke headers opgeven voor Blob Storage-bewerkingen voor meer informatie.

Aanvraagheaders (alleen pagina-blobs)

De aanvraagheaders die alleen van toepassing zijn op bewerkingen op pagina-blobs, worden beschreven in de volgende tabel:

Aanvraagheader Beschrijving
x-ms-blob-content-length: bytes Vereist voor pagina-blobs. Deze koptekst geeft de maximale grootte voor de pagina-blob op, maximaal 8 tebibytes (TiB). De pagina-blobgrootte moet worden uitgelijnd op een grens van 512 bytes.

Als deze header is opgegeven voor een blok-blob of een toevoeg-blob, retourneert Blob Storage statuscode 400 (ongeldige aanvraag).
x-ms-blob-sequence-number: <num> Optioneel. Alleen instellen voor pagina-blobs. Het volgnummer is een door de gebruiker beheerde waarde die u kunt gebruiken om aanvragen bij te houden. De waarde van het volgnummer moet tussen 0 en 2^63 - 1 zijn. De standaardwaarde is 0.
x-ms-access-tier Versie 2017-04-17 en hoger. Alleen voor pagina-blobs in een Premium Storage-account. Hiermee geeft u de laag die moet worden ingesteld op de blob. Zie Premium-opslag met hoge prestaties en beheerde schijven voor VM's voor een volledige lijst met ondersteunde lagen.
x-ms-client-request-id Deze header kan worden gebruikt voor het oplossen van problemen met aanvragen en bijbehorende antwoorden. De waarde van deze header is gelijk aan de waarde van de x-ms-client-request-id header als deze aanwezig is in de aanvraag en de waarde niet meer dan 1024 zichtbare ASCII-tekens bevat. Als de x-ms-client-request-id header niet aanwezig is in de aanvraag, is deze niet aanwezig in het antwoord.

Aanvraagheaders (door de klant verstrekte versleutelingssleutels)

Vanaf versie 2019-02-02 kunnen de volgende headers worden opgegeven in de aanvraag voor het versleutelen van een blob met een door de klant verstrekte 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

Voor een blok-blob bevat de aanvraagbody de inhoud van de blob.

Voor een pagina-blob of een toevoeg-blob is de aanvraagbody leeg.

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: 2015-02-21  
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-expiry-option: RelativeToNow
x-ms-expiry-time: 30000
Authorization: SharedKey myaccount:YhuFJjN4fAR8/AmBrqBz7MG2uFinQ4rkh4dscbj598g=  
Content-Length: 11  
  
Request Body:  
hello world

Met deze voorbeeldaanvraag wordt een pagina-blob gemaakt en wordt de maximale grootte 1024 bytes opgegeven. Als u inhoud wilt toevoegen aan een pagina-blob, moet u Pagina plaatsen aanroepen:

Request Syntax:  
PUT https://myaccount.blob.core.windows.net/mycontainer/mypageblob HTTP/1.1  
  
Request Headers:  
x-ms-version: 2015-02-21  
x-ms-date: <date>  
Content-Type: text/plain; charset=UTF-8  
x-ms-blob-type: PageBlob  
x-ms-blob-content-length: 1024  
x-ms-blob-sequence-number: 0  
Authorization: SharedKey   
Origin: http://contoso.com  
Vary: Origin  
myaccount:YhuFJjN4fAR8/AmBrqBz7MG2uFinQ4rkh4dscbj598g=  
Content-Length: 0

Met deze voorbeeldaanvraag wordt een toevoeg-blob gemaakt. Als u inhoud wilt toevoegen aan de toevoeg-blob, moet u Toevoegblok aanroepen:

Request Syntax:  
PUT https://myaccount.blob.core.windows.net/mycontainer/myappendblob HTTP/1.1  
  
Request Headers:  
x-ms-version: 2015-02-21  
x-ms-date: <date>  
Content-Type: text/plain; charset=UTF-8  
x-ms-blob-type: AppendBlob  
Authorization: SharedKey myaccount:YhuFJjN4fAR8/AmBrqBz7MG2uFinQ4rkh4dscbj598g=  
Origin: http://contoso.com  
Vary: Origin  
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 Bevat een waarde die de client kan gebruiken om voorwaardelijke PUT bewerkingen uit te voeren met behulp van de If-Match aanvraagheader. Als de aanvraagversie 2011-08-18 of hoger is, wordt de waarde ETag tussen aanhalingstekens geplaatst.
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.

Bij een schrijfbewerking op de blob (inclusief updates voor de metagegevens of eigenschappen van de blob) wordt de laatste wijzigingstijd van de blob gewijzigd.
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. In versie 2012-02-12 en hoger wordt deze header 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 vanaf versie 2019-02-02.
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 Geeft de Blob Storage-versie aan die is gebruikt om de aanvraag uit te voeren. Geretourneerd voor aanvragen die zijn gedaan op basis van versie 2009-09-19 en hoger.
Date Een UTC-datum/tijd-waarde die wordt gegenereerd door de service, die de tijd aangeeft waarop het antwoord is geïnitieerd.
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 Versie 2015-12-11 en hoger. De waarde van deze header wordt ingesteld op true als de inhoud van de aanvraag is versleuteld met behulp van het opgegeven algoritme. Anders is falsede waarde .
x-ms-encryption-key-sha256 Versie 2019-02-02 en hoger. 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 Versie 2019-02-02 en hoger. 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> Versie 2019-12-12 en hoger. Deze header retourneert een ondoorzichtige DateTime waarde die de blob uniek identificeert. De waarde van deze header geeft de versie van de blob aan en 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 bewerking autoriseren zoals hieronder wordt beschreven.

Als een aanvraag tags opgeeft met de x-ms-tags aanvraagheader, 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 beheerde Azure-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 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 bewerking aan te roepen, en de minst bevoorrechte ingebouwde Azure RBAC-rol 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

Wanneer u een blob maakt, moet u opgeven of het een blok-blob, toevoeg-blob of pagina-blob is door de waarde van de x-ms-blob-type koptekst op te geven. Nadat een blob is gemaakt, kan het type blob alleen worden gewijzigd als deze wordt verwijderd en opnieuw wordt gemaakt.

In de volgende tabel worden de maximaal toegestane blok- en blobgrootten per serviceversie beschreven:

Serviceversie Maximale blokgrootte (via Put Block) Maximale blobgrootte (via Put Block List) Maximale blobgrootte via één schrijfbewerking (via Put Blob)
Versie 2019-12-12 en hoger 4.000 mebibytes (MiB) Ongeveer 190,7 TiB (4.000 MiB × 50.000 blokken) 5.000 MiB
Versies 2016-05-31 tot en met 2019-07-07 100 MiB Ongeveer 4,75 TiB (100 MiB × 50.000 blokken) 256 MiB
Versies ouder dan 2016-05-31 4 MiB Ongeveer 195 GiB (4 MiB × 50.000 blokken) 64 MiB

Als u probeert een blok-blob te uploaden die groter is dan de maximaal toegestane grootte voor die serviceversie of een pagina-blob die groter is dan 8 TiB, retourneert de service statuscode 413 (Aanvraagentiteit te groot). Blob Storage retourneert ook aanvullende informatie over de fout in het antwoord, inclusief de maximaal toegestane blobgrootte, in bytes.

Als u een nieuwe pagina-blob wilt maken, initialiseert u eerst de blob door aan te roepen Put Bloben vervolgens de maximale grootte op te geven, tot 8 TiB. Wanneer u een pagina-blob maakt, moet u geen inhoud opnemen in de hoofdtekst van de aanvraag. Nadat de blob is gemaakt, roept u Pagina plaatsen aan om inhoud toe te voegen aan de blob of om deze te wijzigen.

Als u een nieuwe toevoeg-blob wilt maken, roept Put Blob u aan om deze te maken met een inhoudslengte van 0 bytes. Nadat de toevoeg-blob is gemaakt, roept u Toevoegblok aan om inhoud toe te voegen aan het einde ervan.

Als u aanroept Put Blob om een bestaande blob met dezelfde naam te overschrijven, blijven momentopnamen die zijn gekoppeld aan de oorspronkelijke blob behouden. Als u gekoppelde momentopnamen wilt verwijderen, roept u eerst Blob verwijderen aan en roept Put Blob u vervolgens aan om de blob opnieuw te maken.

Aangepaste blobeigenschappen

Een blob heeft aangepaste eigenschappen (ingesteld via headers) die u kunt gebruiken om waarden op te slaan die zijn gekoppeld aan standaard HTTP-headers. U kunt deze waarden vervolgens lezen door Blob-eigenschappen ophalen aan te roepen of ze te wijzigen door Blobeigenschappen instellen aan te roepen. De aangepaste eigenschapheaders en de bijbehorende standaard-HTTP-header worden vermeld in de volgende tabel:

HTTP-header Koptekst van aangepaste blob-eigenschap
Content-Type x-ms-blob-content-type
Content-Encoding x-ms-blob-content-encoding
Content-Language x-ms-blob-content-language
Content-MD5 x-ms-blob-content-md5
Cache-Control x-ms-blob-cache-control

De semantiek voor het instellen of behouden van deze eigenschapswaarden met de blob is als volgt:

  • Als de client een aangepaste eigenschapheader opgeeft, zoals aangegeven door het x-ms-blob voorvoegsel, wordt deze waarde opgeslagen met de blob.

  • Als de client een standaard HTTP-header opgeeft, maar niet de aangepaste eigenschapheader, wordt de waarde opgeslagen in de bijbehorende aangepaste eigenschap die is gekoppeld aan de blob en wordt deze geretourneerd door een aanroep naar Get Blob Properties. Als de client bijvoorbeeld de Content-Type header voor de aanvraag instelt, wordt die waarde opgeslagen in de eigenschap van x-ms-blob-content-type de blob.

  • Als de client zowel de standaard HTTP-header als de bijbehorende eigenschapsheader instelt voor dezelfde aanvraag, gebruikt de PUT-aanvraag de waarde die is opgegeven voor de standaard-HTTP-header, maar wordt de waarde die is opgegeven voor de header van de aangepaste eigenschap behouden bij de blob en geretourneerd door volgende GET-aanvragen.

Als tags 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 2kb aan tags bevatten. Als er meer tags vereist zijn, gebruikt u de bewerking Blobtags instellen .

Als de blob een actieve lease heeft, moet de client een geldige lease-id opgeven voor de aanvraag om de blob te overschrijven. Als de client geen lease-id opgeeft of een ongeldige lease-id opgeeft, retourneert Blob Storage statuscode 412 (Voorwaarde mislukt). Als de client een lease-id opgeeft, maar de blob geen actieve lease heeft, retourneert Blob Storage ook statuscode 412 (Voorwaarde mislukt). Als de client een lease-id opgeeft voor een blob die nog niet bestaat, retourneert Blob Storage statuscode 412 (Voorwaarde mislukt) voor aanvragen die zijn gedaan in versie 2013-08-15 en hoger. Voor versies ouder dan 2013-08-15 retourneert Blob Storage statuscode 201 (Gemaakt).

Als een bestaande blob met een actieve lease wordt overschreven door een Put Blob bewerking, blijft de lease behouden op de bijgewerkte blob totdat deze verloopt of wordt vrijgegeven.

Een Put Blob bewerking mag 10 minuten per MiB worden voltooid. Als de bewerking gemiddeld langer duurt dan 10 minuten per MiB, treedt er een time-out op voor de bewerking.

Het overschrijven van een archive blob mislukt en het overschrijven van een hot of cool blob neemt de laag over van de oude blob als er x-ms-access-tier geen header is opgegeven.

ExpiryOption

U kunt de volgende waarden als header x-ms-expiry-option verzenden. Deze header is niet hoofdlettergevoelig.

Verloopoptie Description
RelativeToNow Hiermee stelt u de vervaldatum ten opzichte van de huidige tijd in. x-ms-expiry-time moet worden opgegeven als het aantal milliseconden dat vanaf de huidige tijd verstrijkt.
Absolute x-ms-expiry-time moet worden opgegeven als een absolute tijd, in RFC 1123-indeling.
NeverExpire Hiermee stelt u in dat de blob nooit verloopt of verwijdert u de huidige vervaldatum. x-ms-expiry-time mag niet worden opgegeven.

De semantiek voor het instellen van een vervaldatum op een blob is als volgt:

  • Set Expiry kan alleen worden ingesteld op een blob en niet op een map.
  • Set Expiry met een expiryTime in het verleden is niet toegestaan.
  • ExpiryTime kan niet worden opgegeven met een expiryOption waarde van Never.

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 aanvragen op basis van het type opslagaccount:

Bewerking Type opslagaccount Factureringscategorie
Blob plaatsen Premium blok-blob
Standaard v2 voor algemeen gebruik
Standaard v1 voor algemeen gebruik		 Schrijfbewerkingen

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

Zie ook

Aanvragen voor Azure Storage autoriseren
Status en foutcodes
Foutcodes voor de Blob-service
Time-outs instellen voor blobservicebewerkingen