Pagina plaatsen

Artikel
02/07/2024

Met de Put Page bewerking wordt een bereik van pagina's naar een pagina-blob geschreven.

Aanvraag

U kunt de Put Page 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?comp=page`	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?comp=page`	HTTP/1.1

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

URI-parameters

U kunt de volgende aanvullende parameters opgeven 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 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.
`Range`	`x-ms-range` Of `Range` is vereist. Hiermee geeft u het bereik van bytes moet worden geschreven als een pagina. Zowel het begin als het einde van het bereik moeten worden opgegeven. Deze header wordt gedefinieerd door de http/1.1-protocolspecificatie. Voor een pagina-updatebewerking kan het paginabereik maximaal 4 MiB zijn. Voor een pagina wissen kan het paginabereik net zo groot zijn als de waarde van de volledige grootte van de blob. Omdat pagina's moeten worden uitgelijnd met grenzen van 512 bytes, moet de begin offset een modulus van 512 zijn en de eind offset een modulus van 512 -1. Voorbeelden van geldige bytebereiken zijn 0-511, 512-1023, enzovoort. Blob Storage accepteert slechts één bytebereik voor de `Range` header en het bytebereik moet worden opgegeven in de volgende indeling: `bytes=startByte-endByte`. Als beide `Range` en `x-ms-range` zijn opgegeven, gebruikt de service de waarde van `x-ms-range`. Zie De bereikheader opgeven voor blobservicebewerkingen voor meer informatie.
`x-ms-range`	`x-ms-range` Of `Range` is vereist. Hiermee geeft u het bereik van bytes moet worden geschreven als een pagina. Zowel het begin als het einde van het bereik moeten worden opgegeven. Deze header wordt gedefinieerd door de http/1.1-protocolspecificatie. Voor een pagina-updatebewerking kan het paginabereik maximaal 4 MiB groot zijn. Voor een pagina wissen kan het paginabereik maximaal de waarde van de volledige grootte van de blob hebben. Omdat pagina's moeten worden uitgelijnd met grenzen van 512 bytes, moet de begin offset een modulus van 512 zijn en de eind offset een modulus van 512 – 1. Voorbeelden van geldige bytebereiken zijn 0-511, 512-1023, enzovoort. Blob Storage accepteert slechts één bytebereik voor de `x-ms-range` header en het bytebereik moet worden opgegeven in de volgende indeling: `bytes=startByte-endByte`. Als beide `Range` en `x-ms-range` zijn opgegeven, gebruikt de service de waarde van `x-ms-range`. Zie De bereikheader opgeven voor blobservicebewerkingen voor meer informatie.
`Content-Length`	Vereist. Hiermee geeft u het aantal bytes dat wordt verzonden in de aanvraagbody. Wanneer de `x-ms-page-write` header is ingesteld op `clear`, moet de waarde van deze header worden ingesteld op `0`.
`Content-MD5`	Optioneel. Een MD5-hash van de pagina-inhoud. Deze hash wordt gebruikt om de integriteit van de pagina te controleren tijdens het transport. Wanneer deze header is opgegeven, vergelijkt de opslagservice de hash van de inhoud die is aangekomen met deze headerwaarde. <br / >Opmerking: deze MD5-hash wordt niet opgeslagen met de blob. Als de twee hashes niet overeenkomen, mislukt de bewerking met foutcode 400 (ongeldige aanvraag).
`x-ms-content-crc64`	Optioneel. Een CRC64-hash van de pagina-inhoud. Deze hash wordt gebruikt om de integriteit van de pagina te controleren tijdens het transport. Wanneer deze header is opgegeven, vergelijkt de opslagservice de hash van de inhoud die is aangekomen met deze headerwaarde. Opmerking: deze CRC64-hash wordt niet opgeslagen met de blob. Als de twee hashes niet overeenkomen, mislukt de bewerking met foutcode 400 (ongeldige aanvraag). Als zowel de `Content-MD5x-ms-content-crc64` headers als aanwezig zijn, mislukt de aanvraag met een 400 (Ongeldige aanvraag). Deze header wordt ondersteund in versie 2019-02-02 en hoger.
`x-ms-page-write: {update ¦ clear}`	Vereist. U kunt een van de volgende opties opgeven: - `Update`: schrijft de bytes die zijn opgegeven door de aanvraagbody naar het opgegeven bereik. De `Range` kopteksten en `Content-Length` moeten overeenkomen om de update uit te voeren. - `Clear`: Hiermee wordt het opgegeven bereik gewist en wordt de ruimte vrijgegeven die wordt gebruikt in de opslag voor dat bereik. Als u een bereik wilt wissen, stelt u de `Content-Length` koptekst in op `0`en stelt u de `Range` header in op een waarde die aangeeft dat het bereik moet worden gewist, tot de maximale blobgrootte.
`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 versie 2019-02-02 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-if-sequence-number-le: <num>`	Optioneel. Als het volgnummer van de blob kleiner is dan of gelijk is aan de opgegeven waarde, wordt de aanvraag voortgezet. Anders mislukt het met de SequenceNumberConditionNotMet-fout (HTTP-statuscode 412 – Voorwaarde mislukt).
`x-ms-if-sequence-number-lt: <num>`	Optioneel. Als het volgnummer van de blob kleiner is dan de opgegeven waarde, wordt de aanvraag voortgezet. Anders mislukt het met sequenceNumberConditionNotMet-fout (HTTP-statuscode 412 – Voorwaarde mislukt).
`x-ms-if-sequence-number-eq: <num>`	Optioneel. Als het volgnummer van de blob gelijk is aan de opgegeven waarde, wordt de aanvraag voortgezet. Anders mislukt het met sequenceNumberConditionNotMet-fout (HTTP-statuscode 412 – Voorwaarde mislukt).
`If-Modified-Since`	Optioneel. Een `DateTime` waarde. Geef deze voorwaardelijke koptekst op om de pagina alleen te schrijven als de blob is gewijzigd sinds de opgegeven datum/tijd. Als de blob niet is gewijzigd, retourneert Blob Storage statuscode 412 (Voorwaarde mislukt).
`If-Unmodified-Since`	Optioneel. Een `DateTime` waarde. Geef deze voorwaardelijke koptekst op om de pagina alleen te schrijven als de blob niet is gewijzigd sinds de opgegeven datum/tijd. Als de 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 pagina alleen te schrijven als de ETag-waarde van de blob overeenkomt met de opgegeven waarde. Als de waarden niet overeenkomen, retourneert Blob Storage statuscode 412 (Voorwaarde mislukt).
`If-None-Match`	Optioneel. Een ETag-waarde. Geef een ETag-waarde op voor deze voorwaardelijke header om de pagina alleen te schrijven als de ETag-waarde van de blob niet overeenkomt met de opgegeven waarde. Als de waarden identiek zijn, retourneert Blob Storage statuscode 412 (Voorwaarde mislukt).
`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 logboeken 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 Azure Blob Storage bewaken voor meer informatie.

Deze bewerking ondersteunt ook het gebruik van voorwaardelijke headers om de bewerking alleen uit te voeren als aan een opgegeven voorwaarde wordt voldaan. Zie Voorwaardelijke headers opgeven voor blobservicebewerkingen voor meer informatie.

Aanvraagheaders (door de klant verstrekte versleutelingssleutels)

Vanaf versie 2019-02-02 kunt u de volgende headers opgeven voor de aanvraag 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.

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

De aanvraagtekst bevat de inhoud van de pagina.

Voorbeeldaanvraag: Bytebereik bijwerken

  
Request Syntax:  
PUT https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=page HTTP/1.1  
  
Request Headers:  
x-ms-page-write: update  
x-ms-date: Fri, 16 Sep 2011 22:15:50 GMT  
x-ms-version: 2011-08-18  
x-ms-range: bytes=0-65535  
Authorization: SharedKey myaccount:4KdWDiTdA9HmIF9+WF/8WfYOpUrFhieGIT7f0av+GEI=  
Content-Length: 65536

Voorbeeldaanvraag: Bytebereik wissen

  
Request Syntax:  
PUT https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=page HTTP/1.1  
  
Request Headers:  
Range: bytes=1024-2048  
x-ms-page-write: clear  
x-ms-date: Sun, 25 Sep 2011 23:37:35 GMT  
x-ms-version: 2011-08-18  
Authorization: SharedKey myaccount:4KdWDiTdA9HmIF9+WF/8WfYOpUrFhieGIT7f0av+GEI=

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.

Syntax	Description
`ETag`	De ETag voor de blob. Als de aanvraagversie 2011-08-18 of hoger is, wordt de waarde ETag tussen aanhalingstekens geplaatst. De ETag kan worden gebruikt om een voorwaardelijke `Put Page` bewerking uit te voeren door de waarde op te geven voor de `If-Match` aanvraagheader of `If-None-Match` .
`Last-Modified`	De datum en 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 van de metagegevens of eigenschappen van de blob, verandert de laatste wijzigingstijd van de blob.
`Content-MD5`	Deze koptekst wordt geretourneerd, zodat de client de integriteit van de berichtinhoud kan controleren. De waarde van deze header wordt berekend door Blob Storage. Deze is niet noodzakelijkerwijs hetzelfde als de waarde die is opgegeven in de aanvraagheaders. Voor versie 2019-02-02 en hoger wordt deze header alleen geretourneerd wanneer de aanvraag deze header heeft.
`x-ms-content-crc64`	Voor versie 2019-02-02 of hoger wordt deze header geretourneerd, zodat de client de integriteit van de berichtinhoud kan controleren. De waarde van deze header wordt berekend door Blob Storage. Deze is niet noodzakelijkerwijs hetzelfde als de waarde die is opgegeven in de aanvraagheaders. Deze header wordt geretourneerd wanneer `Content-MD5` de header niet aanwezig is in de aanvraag.
`x-ms-blob-sequence-number`	Het huidige volgnummer voor de pagina-blob.
`x-ms-request-id`	Identificeert op unieke wijze de aanvraag die is gedaan en kan worden gebruikt om problemen met de aanvraag op te lossen. Zie Problemen met API-bewerkingen oplossen voor meer informatie.
`x-ms-version`	Geeft de blobserviceversie aan die is gebruikt om de aanvraag uit te voeren. Deze header wordt 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.
`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 wordt de waarde ingesteld op `false`.
`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-client-request-id`	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.

Hoofdtekst van de reactie

Geen.

Voorbeeldantwoord

Response Status:  
HTTP/1.1 201 Created  
  
Response Headers:  
x-ms-content-crc64: 77uWZTolTHU  
Date: Sun, 25 Sep 2011 22:33:35 GMT  
ETag: "0x8CB171BA9E94B0B"  
Last-Modified: Sun, 25 Sep 2011 12:13:31 GMT  
x-ms-version: 2011-08-18  
x-ms-blob-sequence-number: 0  
Content-Length: 0  
Server: Windows-Azure-Blob/1.0 Microsoft-HTTPAPI/2.0

Autorisatie

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

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 Page bewerking aan te roepen, en de minst bevoorrechte ingebouwde Azure RBAC-rol die deze actie omvat:

Azure RBAC-actie:Microsoft.Storage/storageAccounts/blobServices/containers/blobs/write
Ingebouwde rol met minimale bevoegdheden:Inzender voor opslagblobgegevens

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

Een Shared Access Signature (SAS) biedt beveiligde gedelegeerde toegang tot resources in een opslagaccount. Met een SAS hebt u gedetailleerde controle over hoe een client toegang heeft tot gegevens. U kunt opgeven tot welke resource de client toegang heeft, welke machtigingen ze hebben voor deze resources en hoe lang de SAS geldig is.

De Put Page bewerking ondersteunt drie typen handtekeningen voor gedeelde toegang: sas voor gebruikersdelegatie, service-SAS en account-SAS.

Als best practice voor beveiliging raden we u aan Microsoft Entra referenties te gebruiken in plaats van de sleutel van het opslagaccount, die gemakkelijker kan worden aangetast. Als voor uw toepassingsontwerp handtekeningen voor gedeelde toegang zijn vereist, gebruikt u Microsoft Entra referenties om, indien mogelijk, een SAS voor gebruikersdelegatie te maken.

Wanneer gedeelde sleuteltoegang niet is toegestaan voor het opslagaccount, is een service-SAS-token of een ACCOUNT-SAS-token niet toegestaan op een aanvraag voor Blob Storage. Zie Begrijpen hoe het niet toewijzen van gedeelde sleutel van invloed is op SAS-tokens voor meer informatie.

SAS voor gebruikersdelegatie

Een SAS voor gebruikersdelegatie wordt beveiligd met Microsoft Entra referenties en ook met de machtigingen die zijn opgegeven voor de SAS.

Voor het aanroepen van de Put Page bewerking met behulp van een SAS-token dat is gedelegeerd aan een container of blob-resource, is de machtiging Schrijven (w) vereist als onderdeel van het SAS-token voor gebruikersdelegatie.

Zie Een SAS voor gebruikersdelegatie maken voor meer informatie over de SAS voor gebruikersdelegatie.

Service-SAS

Een service-SAS wordt beveiligd met de sleutel van het opslagaccount. Een service-SAS delegeert de toegang tot een resource in één Azure Storage-service, zoals blobopslag.

Voor het aanroepen van de Put Page bewerking met behulp van een SAS-token dat is gedelegeerd aan een container of blob-resource, is de machtiging Schrijven (w) vereist als onderdeel van het service-SAS-token.

Zie Een service-SAS maken voor meer informatie over de service-SAS.

Account-SAS

Een account-SAS wordt beveiligd met de sleutel van het opslagaccount. Een account-SAS delegeert toegang tot resources in een of meer van de opslagservices. Alle bewerkingen die beschikbaar zijn via een service of gebruikersdelegatie-SAS zijn ook beschikbaar via een account-SAS.

In de volgende tabel ziet u het ondertekende resourcetype en de ondertekende machtigingen die moeten worden opgegeven bij het delegeren van toegang:

Bewerking	Ondertekende service	Ondertekend resourcetype	Ondertekende machtiging
Pagina plaatsen	Blob (b)	Object (o)	Schrijven (w)

Zie Een account-SAS maken voor meer informatie over de account-SAS.

Opmerkingen

Met de Put Page bewerking wordt een bereik van pagina's naar een pagina-blob geschreven. Deze bewerking kan alleen worden aangeroepen op een bestaande pagina-blob. Het kan niet worden aangeroepen om een nieuwe pagina-blob te maken en kan ook niet worden aangeroepen op een blok-blob. Als u aanroept Put Page met een blobnaam die momenteel niet bestaat, wordt http-statuscode 404 (Niet gevonden) geretourneerd.

Als u een nieuwe pagina-blob wilt maken, roept u Put Blob aan en geeft u het type blob op dat moet worden gemaakt als een pagina-blob. Een pagina-blob kan maximaal 8 TiB groot zijn.

Als de blob een actieve lease heeft, moet de client een geldige lease-id opgeven voor de aanvraag om een pagina te schrijven.

Bewerkingen voor pagina-updates

Aanroepen Put Page met de Update optie voert een in-place schrijfbewerking uit op de opgegeven pagina-blob. Alle inhoud op de opgegeven pagina wordt overschreven met de update.

Belangrijk

Als er een time-out optreedt voor de server of als de verbinding wordt verbroken tijdens een Put Page bewerking, is de pagina mogelijk wel of niet bijgewerkt. Daarom moet u de update opnieuw uitvoeren totdat u een antwoord ontvangt dat aangeeft dat het is gelukt.

Elk paginabereik dat wordt verzonden met Put Page voor een updatebewerking, kan maximaal 4 MiB groot zijn. Het begin- en eindbereik van de pagina moeten worden uitgelijnd met grenzen van 512 bytes. Als u probeert een bereik van pagina's te uploaden dat groter is dan 4 MiB, retourneert de service statuscode 413 (Aanvraagentiteit is te groot).

Bewerkingen voor pagina wissen

Door aan te roepen Put Page met de Clear optie wordt de opslagruimte vrijgegeven die door de opgegeven pagina wordt gebruikt. Pagina's die zijn gewist, worden niet meer bijgehouden als onderdeel van de pagina-blob.

Voor pagina's die zijn gewist, worden geen kosten meer in rekening gebracht voor het opslagaccount, omdat de opslagresources zijn vrijgegeven. De enige uitzondering hierop is als er bestaande momentopnamen van de pagina-blob zijn. Voor pagina's in momentopnamen worden kosten in rekening gebracht als diezelfde pagina's niet meer bestaan als onderdeel van de bron-blob.

Gelijktijdigheidsproblemen beheren

Blob Storage verwerkt gelijktijdige schrijfbewerkingen naar overlappende pagina's sequentieel. Dat wil gezegd dat de laatste pagina die door de service wordt verwerkt, de inhoud van de blob bepaalt. Om de integriteit van de inhoud van de blob te waarborgen, moet de client schrijfbewerkingen naar overlappende pagina's afhandelen met behulp van een of meer van de volgende methoden:

U kunt de waarde van de Last-Modified antwoordheader controleren voor elke geslaagde aanroep naar Put Page. De volgorde van antwoorden die worden geretourneerd door Blob Storage komt niet noodzakelijkerwijs overeen met de volgorde waarin ze door de service zijn uitgevoerd. Maar de waarde van Last-Modified geeft altijd de volgorde aan waarin de service de aanvragen heeft verwerkt.
U kunt updates voorwaardelijk uitvoeren op basis van de ETag van de blob of de laatste wijzigingstijd met behulp van optimistische gelijktijdigheid. Deze aanpak werkt goed als het aantal gelijktijdige schrijfbewerkingen relatief laag is. Gebruik hiervoor de headers If-Matchvoor voorwaardelijke aanvragen , If-None-MatchIf-Modified-Since, en If-Unmodified-Since .
U kunt Lease-blob aanroepen om de blob gedurende een periode van één minuut te vergrendelen tegen andere schrijfbewerkingen, of langer als de lease wordt verlengd.
U kunt het volgnummer van de blob gebruiken om ervoor te zorgen dat het opnieuw proberen van een aanvraag waarvoor geen antwoord is ontvangen, niet leidt tot gelijktijdige updates. Deze benadering is mogelijk het beste voor clients die een hoge doorvoer nodig hebben voor pagina-schrijfbewerkingen. Dit wordt in de volgende sectie in detail beschreven.

Het reeksnummer van de pagina-blob gebruiken om aanvragen opnieuw te proberen

Wanneer een time-out optreedt voor een aanroep Put Page of geen antwoord retourneert, is er geen manier om zeker te weten of de aanvraag is geslaagd. U moet de aanvraag daarom opnieuw proberen, maar vanwege de gedistribueerde aard van de Azure-opslagservices is het mogelijk dat de oorspronkelijke aanvraag wordt verwerkt nadat de aanvraag opnieuw is geprobeerd. De vertraagde oorspronkelijke aanvraag kan andere updates overschrijven en een onverwacht resultaat opleveren. In de volgende volgorde ziet u hoe dit kan gebeuren:

Er Put Page treedt een time-out op bij een aanvraag om de waarde 'X' naar pagina 0 te schrijven of er wordt geen antwoord geretourneerd.
Een nieuwe poging om de waarde 'X' naar pagina 0 te schrijven, slaagt.
Een aanvraag voor het schrijven van de waarde 'Y' naar pagina 0 slaagt.
De oorspronkelijke aanvraag slaagt en de waarde 'X' wordt naar pagina 0 geschreven.
Als u pagina 0 leest, wordt de waarde 'X' geretourneerd, toen de client op dit moment de waarde 'Y' verwachtte.

Dit soort conflict kan optreden wanneer de oorspronkelijke aanvraag geen statuscode van 100 tot 499 of 503 (server bezet) retourneert. Als een van deze statuscodes wordt geretourneerd, kunt u er zeker van zijn of de aanvraag is geslaagd of mislukt. Maar als de service een statuscode buiten dit bereik retourneert, is er geen manier om de status van de oorspronkelijke aanvraag te achterhalen.

Om dit soort conflicten te voorkomen, kunt u het volgnummer van de pagina-blob gebruiken om ervoor te zorgen dat wanneer u een aanvraag opnieuw probeert, de oorspronkelijke aanvraag niet slaagt. Hiervoor moet u het reeksnummer verhogen voordat u de oorspronkelijke aanvraag opnieuw probeert uit te voeren. U kunt vervolgens de headers voor voorwaardelijke reeksnummers gebruiken om ervoor te zorgen dat de aanvraag mislukt als het volgnummer niet overeenkomt met het verwachte volgnummer. De volgende volgorde illustreert deze benadering:

De client maakt een pagina-blob met Put Blob en stelt het volgnummer in op 0.
Een Put Page aanvraag voor het schrijven van de waarde 'X' naar pagina 0 met de if-sequence-number-lt koptekst ingesteld op 1 een time-out of retourneert geen antwoord.
De client roept Set Blob Properties aan om het volgnummer bij te werken naar 1.
Een opnieuw geprobeerd aanvraag om de waarde 'X' te schrijven naar pagina 0 met if-sequence-number-lt ingesteld op 2 geslaagd.
Een aanvraag voor het schrijven van de waarde 'Y' naar pagina 0 met if-sequence-number-lt ingesteld op 2 slaagt.
De oorspronkelijke aanvraag wordt uiteindelijk verwerkt, maar deze mislukt omdat hiermee de voorwaarde wordt opgegeven dat het reeksnummer kleiner moet zijn dan 1 (dat wil gezegd, de if-sequence-num-lt header is ingesteld op 1). De fout is SequenceNumberConditionNotMet (HTTP-statuscode 412 – Voorwaarde mislukt).
Als u pagina 0 leest, wordt de verwachte waarde van 'Y' geretourneerd.

Zie ook

Aanvragen autoriseren voor Azure Storage
Status en foutcodes
Time-outs instellen voor Blob-servicebewerkingen