Delen via

Een Blob plaatsen

De Put Blob operatie maakt een nieuw blok, pagina of append blob aan, of werkt de inhoud van een bestaande blokblob bij. De Put Blob operatie overschrijft alle inhoud van een bestaande blob met dezelfde naam.

Wanneer je een bestaande block blob bijwerkt, overschrijf je alle bestaande metadata 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. Om een gedeeltelijke update van de inhoud van een blokblob uit te voeren, gebruik je de Put Block List-operatie .

Je kunt een append blob maken in versies 2015-02-21 en later.

Een aanroep naar a Put Blob om een page blob of een append blob te maken, initialiseert alleen de blob. Als de blob al bestaat, wordt de inhoud verwijderd. Om inhoud toe te voegen aan een paginablob, roep je de Put Page-operatie aan. Om content toe te voegen aan een append blob, roep je de Append Block-operatie aan.

Aanvraag

U kunt de Put Blob aanvraag als volgt samenstellen. U wordt aangeraden HTTPS te gebruiken. Vervang myaccount door de naam van je opslagaccount:

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

Emulated storage-serviceaanvraag

Wanneer je een verzoek doet aan de geëmuleerde opslagservice, specificeer dan de hostnaam van de emulator en de poort van de Blob-service als 127.0.0.1:10000, gevolgd door de naam van het geëmuleerde opslagaccount:

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

De opslagemulator ondersteunt alleen blobgroottes tot 2 gibibyte (GiB).

Zie De Azurite-emulator gebruiken voor lokale Azure Storage-ontwikkeling voor meer informatie.

URI Parameters

De volgende aanvullende parameters kunnen worden gespecificeerd op de request URI:

Kenmerk Description
timeout Optional. De timeout parameter wordt uitgedrukt in seconden. Voor meer informatie, zie Time-outs instellen voor Blob-serviceoperaties.

Verzoekheaders (alle blobtypes)

De vereiste en optionele verzoekheaders voor alle blobtypes worden beschreven in de volgende tabel:

Header van het verzoek Description
Authorization Verplicht. Hiermee geeft u het autorisatieschema, de accountnaam en de handtekening op. Zie Aanvragen autoriseren voor Azure Storagevoor meer informatie.
Date of x-ms-date Verplicht. Hiermee geeft u de Coordinated Universal Time (UTC) voor de aanvraag. Zie Aanvragen autoriseren voor Azure Storagevoor meer informatie.
x-ms-version Vereist voor alle geautoriseerde verzoeken. Hiermee geeft u de versie van de bewerking die moet worden gebruikt voor deze aanvraag. Zie Versiebeheer voor de Azure Storage-services voor meer informatie.
Content-Length Verplicht. De lengte van het verzoek.

Voor een page blob of een append blob moet de waarde van deze header op nul worden gezet, omdat Put Blob alleen wordt gebruikt om de blob te initialiseren. Om content te schrijven naar een bestaande page blob, roep je Put Page aan. Om content naar een append blob te schrijven, roep je Append Block aan.
Content-Type Optional. Het type MIME-inhoud van de blob. Het standaardtype is application/octet-stream.
Content-Encoding Optional. Hiermee geeft u op welke inhoudscoderingen zijn toegepast op de blob. Deze waarde wordt teruggegeven aan de client wanneer de Get Blob-operatie wordt uitgevoerd op de blob-resource. Wanneer deze waarde wordt teruggegeven, kan de client deze gebruiken om de blob-inhoud te decoderen.
Content-Language Optional. Specificeert de natuurlijke talen die door deze bron worden gebruikt.
Content-MD5 Optional. Een MD5-hash van de blob-inhoud. Deze hash wordt gebruikt om de integriteit van de blob tijdens het transport te controleren. Wanneer deze header is gespecificeerd, 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 (Ongeldig verzoek).

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

Resultaten van Get Blob, Get Blob Properties en List Blobs bevatten de MD5-hash.
x-ms-content-crc64 Optional. Een CRC64-hash van de blob-inhoud. Deze hash wordt gebruikt om de integriteit van de blob tijdens het transport te controleren. Wanneer deze header is gespecificeerd, 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 (Ongeldig verzoek). Deze header wordt ondersteund in versies 02-02-2019 en later.

Als zowel Content-MD5 als x-ms-content-crc64 headers aanwezig zijn, faalt het verzoek met een 400 (Bad Request).
Cache-Control Optional. Blob Storage slaat deze waarde op, maar gebruikt of wijzigt hem niet.
x-ms-blob-content-type Optional. Stel het inhoudstype van de blob in.
x-ms-blob-content-encoding Optional. Stel de inhoudscodering van de blob in.
x-ms-blob-content-language Optional. Stel de inhoudstaal van de blob in.
x-ms-blob-content-md5 Optional. Stel de MD5-hash van de blob in. Voor BlockBlob heeft deze header voorrang bij Content-MD5 het verifiëren van de integriteit van de blob tijdens transport. Voor PageBlob en AppendBlob stelt deze header direct de MD5-hash van de blob in.
x-ms-blob-cache-control Optional. Stelt de cachecontrole van de blob in.
x-ms-blob-type: <BlockBlob ¦ PageBlob ¦ AppendBlob> Verplicht. Specificeert het type blob dat gemaakt moet worden: block blob, page blob of append blob. Ondersteuning voor het aanmaken van een append blob is alleen beschikbaar in versie 2015-02-21 en later.
x-ms-meta-name:value Optional. Naam-waardeparen die zijn gekoppeld aan de blob als metagegevens.

Opmerking: Vanaf versie 2009-09-19 moeten metagegevensnamen voldoen aan de naamgevingsregels voor C#-id's.
x-ms-encryption-scope Optional. 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 later.
x-ms-encryption-context Optional. Standaard is "Leeg". Als de waarde is ingesteld, wordt de blob-systeemmetadata 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 later.
x-ms-tags Optional. Zet de gegeven querystring-gecodeerde tags op de blob. Zie de opmerkingen voor meer informatie. Ondersteund in versie 2019-12-12 en later.
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 Optional. Stelt de Content-Disposition kop van de blob in. Beschikbaar voor versies 2013-08-15 en later.

Het Content-Disposition responsheaderveld geeft extra informatie over hoe de responspayload verwerkt moet worden, en je kunt het gebruiken om extra metadata toe te voegen. Als bijvoorbeeld de header is ingesteld op attachment, geeft dit aan dat de user-agent het antwoord niet mag tonen. In plaats daarvan zou het een Save As-dialoogvenster moeten tonen met een andere bestandsnaam dan de opgegeven blobnaam.

De respons van de Get Blob - en Get Blob Properties-operaties bevat de content-disposition header.
Origin Optional. Geeft de oorsprong aan vanwaar het verzoek wordt ingediend. De aanwezigheid van deze header resulteert in cross-origin resource sharing (CORS) headers op de respons. Voor meer informatie, zie CORS-ondersteuning voor de Azure Storage-diensten.
x-ms-client-request-id Optional. Biedt een door de client gegenereerde, ondoorzichtige waarde met een tekenlimiet van 1 kibibyte (KiB) die wordt vastgelegd in de analyticslogs wanneer de logging wordt geconfigureerd. We raden u ten zeerste aan deze header te gebruiken om activiteiten aan de clientzijde te correleren met aanvragen die de server ontvangt. Voor meer informatie, zie Over opslaganalyse-logging.
x-ms-access-tier Optional. De tier die op de blob wordt ingesteld. Voor page blobs op een Premium Storage account alleen met versie 2017-04-17 en later. Voor een volledige lijst van door page blobs ondersteunde lagen, zie High-performance premium storage and managed disks for virtual machines (VMs). Voor block blobs, ondersteund op blobopslag of algemene v2-accounts alleen vanaf versie 2018-11-09 en later. Geldige waarden voor blokblob-tiers zijn Hot, Cool, , Colden Archive. Opmerking: Cold tier wordt ondersteund voor versie 2021-12-02 en later. Voor gedetailleerde informatie over block blob tiering, zie Hot, cool en archive storage tiers.
x-ms-immutability-policy-until-date Versie 2020-06-12 en later. Specificeert de behoudsdatum die op de blob moet worden vastgesteld. Dit is de datum waarop de blob beschermd kan worden tegen wijziging of verwijdering. Volgt RFC1123 format.
x-ms-immutability-policy-mode Versie 2020-06-12 en later. Specificeert de onveranderlijkheidsbeleidsmodus die op de blob moet worden ingesteld. Geldige waarden zijn unlocked en locked. Met unlocked, kunnen gebruikers het beleid wijzigen door de retentie-tot-datum te verlengen of te verlagen. Met locked, zijn deze handelingen verboden.
x-ms-legal-hold Versie 2020-06-12 en later. Specificeert de wettelijke houvast die op de blob moet worden ingesteld. Geldige waarden zijn true en false.
x-ms-expiry-option Optional. Versie 2023-08-03 en later. Specificeert de vervaldatumoptie voor het verzoek. Voor meer informatie, zie ExpiryOption. Deze header is geldig voor accounts met hiërarchische naamruimte ingeschakeld.
x-ms-expiry-time Optional. Versie 2023-08-03 en later. Geeft het tijdstip aan waarop de blob verloopt. Het format voor de houdbaarheidsdatum varieert volgens x-ms-expiry-option. Voor meer informatie, zie ExpiryOption. Deze header is geldig voor accounts met hiërarchische naamruimte ingeschakeld.

Deze operatie ondersteunt ook het gebruik van conditionele headers om de blob alleen te schrijven als aan een gespecificeerde voorwaarde is voldaan. Voor meer informatie, zie Specificeer conditionele headers voor Blob Storage operaties.

Verzoekheaders (alleen paginablobs)

De verzoekheaders die alleen van toepassing zijn op bewerkingen op paginablobs worden beschreven in de volgende tabel:

Header van het verzoek Description
x-ms-blob-content-length: bytes Vereist voor page blobs. Deze header specificeert de maximale grootte van de paginablob, tot 8 tebibytes (TiB). De paginablobgrootte moet worden uitgelijnd met een grens van 512 bytes.

Als deze header is gespecificeerd voor een block blob of een append blob, geeft Blob Storage statuscode 400 (Bad Request) terug.
x-ms-blob-sequence-number: <num> Optional. Ingesteld voor paginaklonten alleen. Het volgnummer is een door de gebruiker beheerde waarde die u kunt gebruiken om aanvragen bij te houden. De waarde van het volgnummer moet van 0 tot 2^63 - 1 liggen. De standaardwaarde is 0.
x-ms-access-tier Versie 2017-04-17 en later. Alleen voor pagina-blobs in een Premium-opslagaccount. Specificeert welke laag op de blob moet worden ingesteld. Voor een volledige lijst van ondersteunde lagen, zie High-performance premium storage en managed disks voor VM's.
x-ms-client-request-id Deze header kan worden gebruikt om problemen met aanvragen en bijbehorende antwoorden op te lossen. 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.

Request-headers (door de klant verstrekte encryptiesleutels)

Vanaf versie 2019-02-02 kunnen de volgende headers worden opgegeven bij het verzoek om een blob te versleutelen met een door de klant verstrekte sleutel. Versleuteling met een door de klant verstrekte sleutel (en de bijbehorende set headers) is optioneel.

Header van het verzoek Description
x-ms-encryption-key Verplicht. De door Base64 gecodeerde AES-256 encryptiesleutel.
x-ms-encryption-key-sha256 Verplicht. De door Base64 gecodeerde SHA256-hash van de encryptiesleutel.
x-ms-encryption-algorithm: AES256 Verplicht. Specificeert het algoritme dat voor encryptie moet worden gebruikt. De waarde van deze header moet zijn AES256.

Request-headers (gestructureerde body, alleen block blob)

Vanaf versie 2025-01-05 kunnen de volgende headers op het verzoek worden gespecificeerd om gebruik te maken van het gestructureerde lichaamsformaat. Deze gelden alleen voor blokblobs.

Header van het verzoek Description
Content-Length Verplicht. Moet de lengte van het gecodeerde verzoek zijn (niet alleen de lengte van de blob-inhoud).

Als de waarde van de header niet overeenkomt met de verwachte lengte van het gecodeerde verzoek, faalt de bewerking met foutcode 400 (Bad Request).
x-ms-structured-body Verplicht. Moet worden opgenomen als het berichtformaat is gestructureerd. De waarde van deze header bevat de versie en eigenschappen van het berichtschema.

Momenteel wordt alleen de waarde ondersteund , XSM/1.0; properties=crc64wat aangeeft dat het verzoek crc64-checksumsegmenten gebruikt in het gecodeerde bericht. Als de waarde hier niet overeenkomt, faalt de bewerking met foutcode 400 (Bad Request). Het verzoek faalt ook als de inhoud die in het verzoek wordt verstrekt niet overeenkomt met de opgegeven checksum voor een bepaald segment.
x-ms-structured-content-length Verplicht. Moet worden opgenomen als het berichtformaat is gestructureerd. De waarde van deze header is de lengte van de blobinhoud en zal altijd kleiner zijn dan de Content-Length headerwaarde vanwege berichtcodering.

Als de waarde van de header niet overeenkomt met de lengte van de blob-inhoud die in het verzoek wordt gegeven, mislukt de bewerking met foutcode 400 (Bad Request).

Inhoud van het verzoek

Voor een blokblob bevat het requestbody de inhoud van de blob.

Voor een page blob of een append blob is de request body leeg.

Voorbeeldaanvraag

Het volgende voorbeeld toont een verzoek om een blokblok te creëren:

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

Dit voorbeeldverzoek maakt een paginablob aan en specificeert de maximale grootte van 1.024 bytes. Om inhoud toe te voegen aan een paginablob, moet je Put Page 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

Dit voorbeeldverzoek creëert een append blob. Om content toe te voegen aan de append blob, moet je Append Block 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

Reactie

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

Statuscode

Een geslaagde bewerking retourneert statuscode 201 (gemaakt).

Zie Status en foutcodesvoor meer informatie over statuscodes.

Antwoordkopteksten

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

Antwoordheader Description
ETag Bevat een waarde die de client kan gebruiken om conditionele PUT bewerkingen uit te voeren door de If-Match request-header te gebruiken. Als de aanvraagversie 2011-08-18 of hoger is, wordt de ETag-waarde tussen aanhalingstekens geplaatst.
Last-Modified De datum/tijd waarop de blob voor het laatst is aangepast. Het datumformaat volgt RFC 1123. Voor meer informatie, zie Datum-/tijdwaarden weergeven in headers.

Elke schrijfoperatie op de blob (inclusief updates van de metadata of eigenschappen van de blob) verandert de laatste gewijzigde tijd van de blob.
Content-MD5 Returneerde voor een block blob zodat de client de integriteit van de berichtinhoud kan controleren. De Content-MD5 teruggegeven waarde wordt berekend door Blob Storage. In versie 2012-02-12 en later wordt deze header teruggegeven, zelfs als het verzoek geen headers bevat Content-MD5x-ms-blob-content-md5 .
x-ms-content-crc64 Teruggestuurd voor een blokblob zodat de client de integriteit van de berichtinhoud kan controleren. De x-ms-content-crc64 teruggegeven waarde wordt berekend door Blob Storage. Deze header wordt altijd teruggegeven vanaf versie 2019-02-02.
x-ms-request-id Identificeer de aanvraag die is gedaan en u kunt deze gebruiken om problemen met de aanvraag op te lossen. Zie Problemen met API-bewerkingen oplossenvoor meer informatie.
x-ms-version Geeft de Blob Storage-versie aan die werd gebruikt om het verzoek uit te voeren. Geretourneerd voor verzoeken ingediend tegen versie 2009-09-19 en later.
Date Een UTC-datum/tijdwaarde die wordt gegenereerd door de service, wat de tijd aangeeft waarop het antwoord is gestart.
Access-Control-Allow-Origin Teruggestuurd als het verzoek een Origin header bevat en CORS is ingeschakeld met een matchingregel. Deze header geeft de waarde van de origin request-header terug als er een match is.
Access-Control-Expose-Headers Teruggestuurd als het verzoek een Origin header bevat en CORS is ingeschakeld met een matchingregel. Geeft de lijst met responsheaders terug die blootgesteld moeten worden aan de klant of uitgever van het verzoek.
Access-Control-Allow-Credentials Teruggestuurd als het verzoek een Origin header bevat en CORS is ingeschakeld met een matchingregel die niet alle oorsprongen toestaat. Deze header staat op true.
x-ms-request-server-encrypted: true/false Versie 2015-12-11 en later. De waarde van deze header wordt ingesteld op true als de inhoud van het verzoek succesvol is versleuteld met het opgegeven algoritme. Anders is falsede waarde .
x-ms-encryption-key-sha256 Versie 2019-02-02 en later. Teruggestuurd als het verzoek een door de klant verstrekte sleutel gebruikte voor versleuteling, zodat de client kan garanderen dat de inhoud van het verzoek succesvol wordt versleuteld door de geleverde sleutel te gebruiken.
x-ms-encryption-scope Versie 2019-02-02 en later. Teruggestuurd als het verzoek een encryptiescope gebruikte, zodat de client kan garanderen dat de inhoud van het verzoek succesvol is versleuteld door gebruik te maken van de encryptiescope.
x-ms-version-id: <DateTime> Versie 2019-12-12 en later. Deze header geeft een ondoorzichtige DateTime waarde terug die de blob uniek identificeert. De waarde van deze header geeft de versie van de blob aan, en deze kan in latere verzoeken worden gebruikt om toegang te krijgen tot de blob.
x-ms-structured-body Teruggestuurd als het verzoek als een gestructureerd body request is verwerkt. De waarde van deze header is gelijk aan de waarde die in het verzoek wordt verzonden, die momenteel moet zijn XSM/1.0; properties=crc64.

Antwoordlichaam

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>

Authorization

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 verzoek tags specificeert met de x-ms-tags requestheader, moet de caller voldoen aan de autorisatievereisten van de Set Blob Tags-operatie .

Belangrijk

Microsoft raadt aan om Microsoft Entra ID met beheerde identiteiten te gebruiken om aanvragen voor Azure Storage te autoriseren. Microsoft Entra ID biedt superieure beveiliging en gebruiksgemak in vergelijking met autorisatie van gedeelde sleutels.

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 beveiligingsprincipaal. De beveiligingsprincipaal kan een door een gebruiker, groep, toepassingsservice-principal of door Azure beheerde identiteit zijn. De beveiligingsprincipaal wordt geverifieerd door Microsoft Entra ID om een OAuth 2.0-token terug te geven. Het token kan vervolgens worden gebruikt om een aanvraag te autoriseren voor de Blob-service.

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

Permissions

Hieronder vindt u de RBAC-actie die nodig is voor een Microsoft Entra-gebruiker, groep, beheerde identiteit 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 je een blob maakt, moet je aangeven of het een blokblob, een append blob of een page blob is door de waarde van de x-ms-blob-type header te specificeren. Nadat een blob is gemaakt, kan het type blob niet worden gewijzigd tenzij deze wordt verwijderd en opnieuw aangemaakt.

De volgende tabel beschrijft de maximaal toegestane blok- en blobgroottes, per serviceversie:

Serviceversie Maximale blokgrootte (via Put Block) Maximale blobgrootte (via Put Block List) Maximale blobgrootte via een enkele schrijfoperatie (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 van vóór 31-05-2016 4 MiB Ongeveer 195 GiB (4 MiB × 50.000 blokken) 64 MiB

Als je probeert een blokblok te uploaden die groter is dan de maximaal toegestane grootte voor die serviceversie of een pagina-blob groter dan 8 TiB, geeft de service statuscode 413 (Request Entity Too Large) terug. Blob Storage geeft ook aanvullende informatie terug over de fout in de respons, inclusief de maximaal toegestane blobgrootte, in bytes.

Om een nieuwe pagina-blob te maken, initialiseert u eerst de blob door aan te roepen Put Blob, en specificeert u vervolgens de maximale grootte, tot 8 TiB. Als je een page blob maakt, voeg dan geen content toe aan de request body. Nadat de blob is aangemaakt, roep je Put Page aan om content aan de blob toe te voegen of deze aan te passen.

Om een nieuwe append blob te maken, roep Put Blob je aan om deze te maken met een inhoudslengte van 0 bytes. Nadat de append blob is aangemaakt, roep je Append Block aan om content aan het einde toe te voegen.

Als je een Put Blob bestaande blob met dezelfde naam wilt overschrijven, worden alle snapshots die aan de originele blob zijn gekoppeld behouden. Om bijbehorende snapshots te verwijderen, roep eerst Delete Blob aan en roep Put Blob vervolgens aan om de blob opnieuw aan te maken.

Blob aangepaste eigenschappen

Een blob heeft aangepaste eigenschappen (ingesteld via headers) die je kunt gebruiken om waarden op te slaan die gekoppeld zijn aan standaard HTTP-headers. Je kunt deze waarden vervolgens lezen door Get Blob Properties aan te roepen, of ze aanpassen door Set Blob Properties aan te roepen. De aangepaste eigenschapsheaders en de bijbehorende standaard HTTP-header worden in de volgende tabel weergegeven:

HTTP-header Aangepaste blob-eigenschapsheader
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 eigenschappen met de blob is als volgt:

  • Als de client een aangepaste eigenschapsheader specificeert, zoals aangegeven door het x-ms-blob prefix, wordt deze waarde opgeslagen bij de blob.

  • Als de client een standaard HTTP-header specificeert, maar niet de custom property-header, wordt de waarde opgeslagen in de bijbehorende custom property die aan de blob is gekoppeld, en wordt deze teruggegeven door een aanroep naar Get Blob Properties. Als de client bijvoorbeeld de Content-Type header op het verzoek instelt, wordt die waarde opgeslagen in de x-ms-blob-content-type eigenschap van de blob.

  • Als de client zowel de standaard HTTP-header als de bijbehorende property-header op hetzelfde verzoek zet, gebruikt het PUT-verzoek de waarde die voor de standaard HTTP-header wordt gegeven, maar de waarde die voor de custom property-header is gespecificeerd, wordt behouden bij de blob en teruggegeven door latere GET-verzoeken.

Als tags in de x-ms-tags header worden gegeven, moeten ze met querystring-codering worden gecodeerd. Tagsleutels en -waarden moeten voldoen aan de naamgevings- en lengtevereisten zoals gespecificeerd in Set Blob Tags. Bovendien kan de x-ms-tags header tot 2 kb aan tags bevatten. Als er meer tags nodig zijn, gebruik dan de Set Blob Tags-operatie .

Als de blob een actieve lease heeft, moet de client een geldige lease-ID op het verzoek opgeven om de blob te overschrijven. Als de client geen lease-ID specificeert of een ongeldige lease-ID opgeeft, geeft Blob Storage statuscode 412 (Precondition Failed) terug. Als de client een lease-ID specificeert maar de blob geen actieve lease heeft, geeft Blob Storage ook statuscode 412 (Precondition Failed) terug. Als de client een lease-ID specificeert op een blob die nog niet bestaat, geeft Blob Storage statuscode 412 (Precondition Failed) terug voor verzoeken die zijn gedaan tegen versie 2013-08-15 en later. Voor versies van vóór 2013-08-15 geeft Blob Storage statuscode 201 (Aangemaakt) terug.

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

Een Put Blob operatie mag 10 minuten per MiB voltooien. Als de operatie gemiddeld langer dan 10 minuten per MiB duurt, loopt de operatie in time-out.

Het overschrijven van een archive blob faalt, en overschrijven van een hot of cool blob erft de tier van de oude blob als er geen x-ms-access-tier header wordt geleverd.

Verloopoptie

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

Vervaloptie Description
RelativeToNow Stelt de vervaldatum in ten opzichte van de huidige tijd. x-ms-expiry-time moet worden gespecificeerd als het aantal milliseconden dat verstreken is vanaf de huidige tijd.
Absolute x-ms-expiry-time moet worden gespecificeerd als een absolute tijd, in RFC 1123-formaat.
NeverExpire Stelt de blob in om nooit te verlopen of verwijdert de huidige vervaldatum. x-ms-expiry-time mag niet worden gespecificeerd.

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

  • Set Expiry kan alleen op een blob worden ingesteld en niet op een map.
  • Set Expiry Met een expiryTime in het verleden is het niet toegestaan.
  • ExpiryTime kan niet worden gespecificeerd 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. Voor deze verzoeken worden kosten per transactie in rekening gebracht. Het type transactie is van invloed op de manier waarop de kosten in rekening worden gebracht op de rekening. Leestransacties worden bijvoorbeeld toegerekend aan een andere factureringscategorie dan schrijftransacties. In de volgende tabel ziet u de factureringscategorie voor aanvragen op Put Blob basis van het type opslagaccount:

Operation Type opslagaccount Facturering categorie
Een Blob plaatsen Premium blok-blob
Standaard algemeen gebruik v2
Standaard algemeen gebruik v1		 Schrijfbewerkingen

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

Zie ook

Aanvragen voor Azure Storage autoriseren
status en foutcodes
Blob service foutcodes
Stel time-outs in voor Blob-serviceoperaties

  • Last updated on