Haal Blob Layout

De Get Blob Layout bewerking retourneert alle door de gebruiker gedefinieerde metagegevens, standaard-HTTP-eigenschappen en systeemeigenschappen voor de blob. Daarnaast kan het optioneel de lay-out van de blob teruggeven. De indeling van een blob is een sub-resource van een blob die een uitsplitsing bevat van alle bereiken in de blob, met een eindpunt (adres) waar dat bereik kan worden gelezen, wat hints geeft over hoe het beste te parallelliseren van reads.

Met deze API kunt u een downloadoperatie optimaliseren door de volgende twee stappen uit te voeren:

  1. Layout Discovery: Aanroep Get Blob Layout om de eigenschappen van de blob op te halen en de datadistributie te ontdekken.
  2. Parallel Get Blob: Roep Get Blob parallel aan voor alle blob-bereiken waarin je geïnteresseerd bent, waarbij je de eindpunten die uit de blob-layout wordt teruggestuurd gebruikt om deze verzoeken naar de optimale locatie te routeren.

Request

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

GET-methode request URI HTTP-versie
https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=layout

https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=layout&snapshot=<DateTime>

https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=layout&versionid=<DateTime>

https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=layout&versionid=<DateTime>&marker=<ContinuationToken>&maxresults=1000		 HTTP/1.0

HTTP/1.1

URI Parameters

U kunt de volgende aanvullende parameters opgeven voor de aanvraag-URI:

Parameter Description
snapshot Optional. De snapshot-parameter is een ondoorzichtige DateTime waarde die, wanneer deze aanwezig is, de blob-snapshot opgeeft die moet worden opgehaald. Voor meer informatie over het werken met blob-snapshots, zie Create a snapshot of a blob.
versionid Optional. De versionid parameter is een ondoorzichtige DateTime waarde die, wanneer deze aanwezig is, de versie van de blob opgeeft die moet worden opgehaald.
marker Optional. Een voortzettingstoken dat door een eerder Get Blob Layout verzoek werd teruggegeven. Gebruik deze token om de volgende set bereiken op te halen. De marker wordt gebruikt om de paginering te hervatten wanneer de respons niet alle bereiken voor de blob of het opgegeven bereik bevat. Als een marker wordt gebruikt, moet er ook een If-Match header worden toegevoegd met een Etag van het vorige verzoek. Voor meer informatie over hoe een header te gebruikenIf-Match, zie Specificeer conditionele headers for Blob Storage operations. Bovendien, als het vorige verzoek een Range of header x-ms-range bevatte, moet dit verzoek ook een identieke header bevatten. Als het laatste verzoek geen bereikheader bevatte, mag dit verzoek ook geen bereiken.
maxresults Optional. Het maximale aantal bereiken dat in de respons moet worden teruggegeven. De API zal nooit meer bereiken teruggeven dan de waarde die door maxresultsis gespecificeerd.
timeout Optional. De parameter timeout wordt uitgedrukt in seconden. Zie Time-outs instellen voor Blob Storage-bewerkingen voor meer informatie.

Headers aanvragen

In de volgende tabel worden de vereiste en optionele aanvraagheaders beschreven.

Header van het verzoek Description
Authorization Required. Hiermee geeft u het autorisatieschema, de accountnaam en de handtekening op. Zie Aanvragen autoriseren voor Azure Storagevoor meer informatie.
Date of x-ms-date Required. Hiermee geeft u de Coordinated Universal Time (UTC) voor de aanvraag. Zie Aanvragen autoriseren voor Azure Storagevoor meer informatie.
x-ms-version Required. Hiermee geeft u de versie van de bewerking die moet worden gebruikt voor deze aanvraag. Get Blob Layout wordt alleen ondersteund in een versie 2026-02-06 of later. Zie Versiebeheer voor de Azure Storage-services voor meer informatie.
Range of x-ms-range Optional. Geef metadata alleen terug voor de opgegeven bereiken. Als zowel Range als x-ms-range zijn gespecificeerd, gebruikt de dienst de waarde van x-ms-range. Als geen van beide bereiken is opgegeven, wordt metadata voor de gehele blob teruggegeven. Voor meer informatie, zie Specificeer de range-header voor Blob Storage operaties.
x-ms-lease-id: <ID> Optional. Als deze header is gespecificeerd, wordt de bewerking alleen uitgevoerd als aan beide volgende voorwaarden is voldaan:

- De lease van de blob is momenteel actief.
- De lease-ID die in het verzoek wordt opgegeven, komt overeen met de lease-ID van de blob.

Als aan een van deze voorwaarden niet wordt voldaan, mislukt de aanvraag en mislukt de Get Blob Layout bewerking met statuscode 412 (Voorvoorwaarde mislukt).
x-ms-upn Optional. Geldig voor accounts met hiërarchische naamruimte ingeschakeld. Als het waar is, worden de gebruikersidentiteitswaarden die worden teruggegeven in de x-ms-owner, x-ms-group, en x-ms-acl responsheaders omgezet van Microsoft Entra-object-ID's naar User Principal Namen. Als de waarde onjuist is, worden ze teruggegeven als Microsoft Entra-object-ID's. De standaardwaarde is onwaar. Let op dat groeps- en applicatieobject-ID's niet worden vertaald, omdat ze geen unieke vriendelijke namen hebben.
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 analyselogs wanneer opslaganalyselogging is ingeschakeld. We raden sterk aan om deze header te gebruiken wanneer je client-side activiteiten correleert met verzoeken die door de server worden ontvangen. Voor meer informatie, zie Over Azure Opslaganalyse loging.

Deze operatie ondersteunt ook het gebruik van conditionele headers om de blob-layout en eigenschappen alleen terug te geven als aan een gespecificeerde voorwaarde is voldaan. Voor meer informatie, zie Specificeer conditionele headers voor Blob Storage operaties. Let op dat een If-Match header vereist is wanneer a marker wordt gebruikt in de URI-parameters.

Request-headers (door de klant verstrekte encryptiesleutels)

Je kunt de volgende headers op het verzoek specificeren om een blob te lezen die versleuteld is met een door de klant verstrekte sleutel. Versleuteling met een door de klant verstrekte sleutel (en de bijbehorende set headers) is optioneel. Als een blob eerder is versleuteld met een door de klant verstrekte sleutel, moet je deze headers op het verzoek opnemen zodat de bewerking succesvol kan worden uitgevoerd.

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

aanvraaginhoud

None.

Antwoord

Het antwoord bevat een HTTP-statuscode, een set responsheaders en eventueel een responsbody met de blob-layout in XML-formaat.

Statuscode

Een succesvolle operatie geeft een van twee statuscodes terug:

  • HTTP 200 (OK) als de respons een blob-layout in de body bevat.
  • HTTP 204 (No Content) als de server geen layout teruggeeft in de responsbody. In dit geval is de API functioneel equivalent aan Get Blob Properties.

Zie Status en foutcodesvoor meer informatie over statuscodes.

Antwoordkopteksten

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

Antwoordheader Description
Content-Type Specificeert het formaat waarin de resultaten worden teruggegeven in de responstekst. De waarde is application/xml als het lichaam wordt teruggebracht.
Content-Length Geeft de grootte van het responslichaam aan, als het wordt teruggestuurd.
Last-Modified De datum/tijd waarop de blob voor het laatst is aangepast. Het datumformaat volgt RFC 1123. Zie Datum-/tijdwaarden weergeven in koptekstenvoor meer informatie.

Elke bewerking waarmee de blob wordt gewijzigd, inclusief een update van de metagegevens of eigenschappen van de blob, wijzigt de laatste wijzigingstijd van de blob.
x-ms-creation-time De datum/tijd waarop de blob is gemaakt. Het datumformaat volgt RFC 1123. Zie Datum-/tijdwaarden weergeven in koptekstenvoor meer informatie.
x-ms-meta-name:value Een set naam-waardeparen die overeenkomen met de door de gebruiker gedefinieerde metagegevens die aan deze blob zijn gekoppeld.
x-ms-tag-count Als de blob tags heeft, geeft dit het aantal tags terug dat op de blob is opgeslagen. Deze koptekst wordt niet geretourneerd als er geen tags op de blob staan.
ETag Bevat een waarde die je kunt gebruiken om bewerkingen voorwaardelijk uit te voeren. Voor meer informatie, zie Specificeer conditionele headers voor Blob Storage operaties. De ETag-waarde staat tussen aanhalingstekens.
x-ms-copy-completion-time:<datetime> Conclusietijd van de laatste poging tot Copy Blob bewerking waarbij deze blob de doel-blob was. Deze waarde kan de tijd opgeven van een voltooide, afgebroken of mislukte kopieerpoging. Deze koptekst wordt niet weergegeven als er een kopie in behandeling is, als deze blob nooit de bestemming in een Copy Blob bewerking is geweest of als deze blob is gewijzigd na een voltooide Copy Blob bewerking waarin wordt gebruikgemaakt van Set Blob Properties, Put Blob, of Put Block List.
x-ms-copy-status-description: <error string> Verschijnt alleen wanneer x-ms-copy-status is failed of pending. Beschrijft de oorzaak van een fatale of niet-fatale kopieerbewerking. Deze koptekst wordt niet weergegeven als deze blob nooit de bestemming is geweest in een Copy Blob bewerking of als deze blob is gewijzigd na een voltooide Copy Blob bewerking waarin wordt gebruikgemaakt van Set Blob Properties, Put Blob, of Put Block List.
x-ms-copy-id: <id> De tekenreeks-id voor de laatste poging Copy Blob tot bewerking, waarbij deze blob de doel-blob was. Deze koptekst wordt niet weergegeven als deze blob nooit de bestemming is geweest in een Copy Blob bewerking of als deze blob is gewijzigd na een voltooide Copy Blob bewerking waarin wordt gebruikgemaakt van Set Blob Properties, Put Blob, of Put Block List.
x-ms-copy-progress: <bytes copied/bytes total> Bevat het aantal gekopieerde bytes en het totale aantal bytes in de bron in de laatste poging Copy Blob tot bewerking, waarbij deze blob de doel-blob was. Kan van 0 tot Content-Length gekopieerde bytes weergeven. Deze koptekst wordt niet weergegeven als deze blob nooit de bestemming is geweest in een Copy Blob bewerking of als deze blob is gewijzigd na een voltooide Copy Blob bewerking waarin wordt gebruikgemaakt van Set Blob Properties, Put Blob, of Put Block List.
x-ms-copy-source: url Een URL met een lengte van maximaal 2 KiB die de bron-blob aangeeft die is gebruikt in de laatste poging Copy Blob tot bewerking, waarbij deze blob de doel-blob was. Deze koptekst wordt niet weergegeven als deze blob nooit de bestemming is geweest in een Copy Blob bewerking of als deze blob is gewijzigd na een voltooide Copy Blob bewerking waarin wordt gebruikgemaakt van Set Blob Properties, Put Blob, of Put Block List.

De URL die in deze header wordt teruggegeven, bevat alle verzoekparameters die zijn gebruikt bij de kopieeroperatie op de bronblob. Als de URL een Shared Access Signature (SAS) token bevat, wordt de handtekening (sig parameter) niet opgenomen.
x-ms-copy-status: <pending \| success \| aborted \| failed> De status van de kopieerbewerking die wordt geïdentificeerd door x-ms-copy-id, met de volgende waarden:

- success: Kopie succesvol voltooid.
- pending: Kopie is in uitvoering. Controleer of x-ms-copy-status-description intermitterende, niet-fatale fouten de voortgang van het kopiëren belemmeren, maar geen fouten veroorzaken.
- aborted: Kopie werd beëindigd door Abort Copy Blob.
- failed: Kopie mislukt. Zie x-ms-copy-status-description voor foutdetails.

Deze koptekst wordt niet weergegeven als deze blob nooit de bestemming in een Copy Blob bewerking is geweest of als deze blob is gewijzigd na een voltooide Copy Blob bewerking waarin wordt gebruikgemaakt van Set Blob Properties, Put Blob, of Put Block List.
x-ms-incremental-copy: true Inbegrepen als de blob een incrementele kopieer-blob is.
x-ms-copy-destination-snapshot:<datetime> Inbegrepen als de blob een incrementele kopie-blob of een momentopname van een incrementele kopie is, als x-ms-copy-status dit is gelukt. Momentopnametijd van de laatste geslaagde incrementele kopiemomentopname voor deze blob.
x-ms-lease-duration: <infinite \| fixed> Wanneer een blob wordt geleased, geeft u aan of de lease een oneindige of vaste duur heeft.
x-ms-lease-state: <available \| leased \| expired \| breaking \| broken> De lease-status van de blob.
x-ms-lease-status:<locked\| unlocked> De leasestatus van de blob.
Cache-Control Als de Cache-Control aanvraagheader eerder is ingesteld voor de blob, wordt die waarde in deze header geretourneerd.
x-ms-request-id Deze koptekst identificeert op unieke wijze de aanvraag die is ingediend 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 wordt gebruikt om de aanvraag uit te voeren.
Accept-Ranges: bytes Geeft aan dat de service aanvragen voor gedeeltelijke blob-inhoud ondersteunt.
x-ms-server-encrypted: true/false De waarde van deze header is ingesteld op true als de blobgegevens en metagegevens van de toepassing volledig zijn versleuteld met behulp van het opgegeven algoritme. Anders wordt de waarde ingesteld op false (wanneer de blob niet is versleuteld of als alleen delen van de metagegevens van de blob/toepassing zijn versleuteld).
x-ms-encryption-key-sha256 Deze header wordt teruggegeven als de blob is versleuteld met een door de klant verstrekte sleutel.
x-ms-encryption-context Als de encryptiecontext-eigenschapswaarde is ingesteld, zal deze de ingestelde waarde teruggeven. Alleen geldig wanneer hiërarchische naamruimte is ingeschakeld voor het account.
x-ms-encryption-scope Deze header wordt teruggegeven als de blob is versleuteld met een encryptiescope.
x-ms-access-tier De laag van een block blob in een Blob Storage- of algemeen v2-account. Geldige waarden zijnHot, Cool, en ColdSmartArchive . Voor gedetailleerde informatie over standaard blob-accountblok blob-niveau tiering, zie Blob storage tiers.
x-ms-smart-access-tier Deze header wordt alleen teruggegeven voor verzoeken die zijn ingediend tegen blobs in Smart de tier. Geldige waarden zijn Hot, Cool en Cold. Voor gedetailleerde informatie over standaard blob-accountblok blob-niveau tiering, zie Blob storage tiers.
x-ms-archive-status Voor blobopslag of algemene v2-accounts zijn rehydrate-pending-to-hotde geldige waarden , rehydrate-pending-to-cool, en rehydrate-pending-to-cold. Als de blob wordt gerehydrateerd en onvolledig is, wordt deze header geretourneerd, wat zowel aangeeft dat het rehydraten in behandeling is als de doellaag weergeeft. Voor gedetailleerde informatie over standaard blob-accountblok blob-niveau tiering, zie Blob storage tiers.
x-ms-access-tier-change-time Geeft de laatste keer aan dat de laag voor het object is gewijzigd. Deze header wordt alleen geretourneerd als er ooit een laag op een blokblob is ingesteld. Het datumformaat volgt RFC 1123. Zie Datum-/tijdwaarden weergeven in koptekstenvoor meer informatie. Voor meer informatie over standaard blob-accountblok blob-niveau tiering, zie Blob storage tiers.
x-ms-rehydrate-priority Als een object de status Rehydrate in behandeling heeft, wordt deze header geretourneerd met de prioriteit rehydrate. Geldige waarden worden High/Standard. Voor gedetailleerde informatie over standaard blob-accountblok blob-niveau tiering, zie Blob storage tiers.
x-ms-or-{policy-id}_{rule-id} Alleen teruggestuurd voor blokklonten. policy-id is een GUID-waarde die de id van een objectreplicatiebeleid op het opslagaccount vertegenwoordigt. rule-id is een GUID-waarde die de id van een beleidsregel in de blobcontainer vertegenwoordigt. Als het account -enabled is ObjectReplication, vertegenwoordigt de waarde van deze header de replicatiestatus van de blob met de gegeven beleids- en regel-id's, of completefailed.
x-ms-or-policy-id Alleen teruggestuurd voor blokklonten. Als het account -enabled is ObjectReplication, vertegenwoordigt de waarde van deze header het beleid dat van toepassing is op de replicatie.
x-ms-last-access-time Geeft de laatste keer aan dat de gegevens van de blob zijn benaderd op basis van het laatste toegangstijdregistratiebeleid van het opslagaccount. De koptekst wordt niet geretourneerd als het opslagaccount geen beleid voor het bijhouden van de laatste toegangstijd heeft of als het beleid is uitgeschakeld. Zie Blob Storage API voor meer informatie over het instellen van het beleid voor tijdregistratie voor de laatste toegang van het opslagaccount.
x-ms-blob-sealed Alleen teruggegeven voor toegevoegde blobs. Als de toevoegingsblob is verzegeld, is de waarde waar. Voor meer informatie, zie Append Blob Seal
x-ms-immutability-policy-until-date Hiermee geeft u de 'bewaardatum tot' op die is ingesteld op de blob. Dit is de datum waarop de blob beschermd kan worden tegen wijziging of verwijdering. Wordt alleen teruggegeven als er een onveranderlijkheidsbeleid op de blob is ingesteld. De waarde van deze header is RFC1123 formaat.
x-ms-immutability-policy-mode: unlocked/locked De modus voor onveranderlijkheidsbeleid wordt geretourneerd als er een onveranderlijkheidsbeleid is ingesteld op de blob. Waarden zijn unlocked/locked. unlocked geeft aan dat de gebruiker het beleid kan wijzigen door de retentie tot datum te verhogen of te verlagen. locked geeft aan dat deze handelingen verboden zijn.
x-ms-legal-hold: true/false Deze koptekst wordt niet geretourneerd als er geen juridische bewaring op de blob is. De waarde van deze koptekst wordt ingesteld op true als de blob een wettelijke bewaring bevat en de waarde ervan true is. Anders wordt de waarde ingesteld op false als de blob een wettelijke bewaring bevat en de waarde false is.
x-ms-owner Alleen voor accounts met hiërarchische naamruimte ingeschakeld. Geeft als resultaat de gebruiker die de eigenaar is van het bestand of de map.
x-ms-group Alleen voor accounts met hiërarchische naamruimte ingeschakeld. Geeft als resultaat de eigenaarsgroep van het bestand of de map.
x-ms-permissions Alleen voor accounts met hiërarchische naamruimte ingeschakeld. Retourneert de machtigingen die zijn ingesteld voor gebruiker, groep en andere in het bestand of de map. Elke individuele toestemming is in formaat [r,w,x,-]{3} .
x-ms-acl Alleen voor accounts met hiërarchische naamruimte ingeschakeld. Geeft de gecombineerde lijst van toegangs- en standaard toegangscontrolelijst terug die zijn ingesteld voor gebruiker, groep en anderen in het bestand of de map. Elke toegangscontrole-invoer (ACE) bestaat uit een scope, een type, een gebruikers- of groepsidentificatie, en permissies in het formaat [scope]:[type]:[id]:[permissions]. De default scope geeft aan dat de ACE behoort tot de standaard ACL voor een directory; anders is scope impliciet en behoort de ACE tot de access ACL. Elke individuele toestemming is in formaat [r,w,x,-]{3} .
x-ms-resource-type Alleen voor accounts waarvoor een hiërarchische naamruimte is ingeschakeld. Geeft het resourcetype voor het pad terug, dat kan zijn of filedirectory.
x-ms-expiry-time Alleen voor accounts waarvoor een hiërarchische naamruimte is ingeschakeld. Retourneert de vervaltijd die is ingesteld op de blob. Wordt alleen geretourneerd voor bestanden waarvoor een vervaltijd is ingesteld.

Hoofdtekst van de reactie

Wanneer de responsstatuscode HTTP 200 (OK) is, bevat de responsbody de blob-indeling in XML-formaat. De vorm van het antwoord is als volgt:

<?xml version="1.0" encoding="utf-8"?>
<BlobLayout>
    <Ranges>
        <Range Start="0" End="1023" EndpointIndex="0" />
        <Range Start="1024" End="4096" EndpointIndex="1" />
    </Ranges>
    <Endpoints>
        <Endpoint Index="0" Value="host1:port" />
        <Endpoint Index="1" Value="host2:port" />
    </Endpoints>
    <NextMarker>marker</NextMarker>
    <MaxResults>2</MaxResults>
</BlobLayout>

De XML-respons bevat de volgende elementen:

  • Ranges: Bevat een lijst van Range-elementen, elk met een aaneengesloten bereik van bytes in de blob met een bijbehorende endpoint-index.

    • Bereik: Vertegenwoordigt een aaneengesloten bereik van bytes in de blob.
      • Start: De startbyte-offset van het bereik (inclusief).
      • Einde: De eindbyte-offset van het bereik (inclusief).
      • EndpointIndex: De index van het eindpunt in de Endpoints-lijst waaruit dit bereik gelezen moet worden.

  • Eindpunten: Bevat een lijst van eindpuntelementen, elk met een service-eindpunt.

    • Eindpunt: Stelt een service-eindpunt voor waaruit blob-bereiken kunnen worden gelezen.
      • Index: De index van dit eindpunt, verwezen door Range-elementen.
      • Waarde: De DNS-hostnaam en poort in het formaat hostname:port. Dit is het service-eindpunt waar je vervolgens vanaf zou moeten lezen.

  • NextMarker: Een voortzettingstoken om te gebruiken in een volgend Get Blob Layout verzoek om de volgende set bereiken op te halen. Dit element is alleen aanwezig als er extra bereiken zijn om op te halen.

  • MaxResults: Het maximale aantal bereiken dat wordt gevraagd in de API-aanroep.

Autorisatie

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

Important

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

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

Remarks

  • Deze API is alleen geldig voor append- en blockblobs.

  • De API kan slagen met zowel HTTP 200 (OK) als HTTP 204 (No Content). Als HTTP 204 wordt teruggegeven, is er geen layout-informatie beschikbaar voor de blob, en is de API functioneel equivalent aan Get Blob Properties. Als er geen layoutinformatie beschikbaar is, moeten clients standaardaanroepen Get Blob gebruiken om de blob te downloaden.

  • Als een layout wordt teruggegeven, kun je de host en poort die in elk bereik zijn geleverd gebruiken om de inhoud van de blob die door dat bereik wordt bedekt te downloaden. Het wordt sterk aanbevolen om die downloads op de ETag die uit de Get Blob Layout oproep worden teruggestuurd te conditioneren om een sterke consistentie voor de reads te waarborgen.

  • De responsheaders x-ms-blob-content-* verwijzen naar de blob zelf en niet naar de layout-subresource. De respons Content-Type is altijd application/xml als een responslichaam is teruggegeven.

  • De API accepteert een Range or-header x-ms-range . Als de range-header wordt weggelaten, geldt het verzoek voor de volledige blob. De API zal nooit bereiken teruggeven die verder reiken dan de Range-header.

  • De API is gepagineerd. De API geeft mogelijk niet genoeg bereiken terug om de hele blob te dekken, of, voor range-verzoeken, genoeg bereiken om het gehele gevraagde bereik te dekken. Als dit gebeurt, geeft de API een NextMarker terug die je moet gebruiken om extra bereiken aan te vragen. Als een marker wordt gebruikt, MOET je ook een If-Match voorwaarde doorgeven die overeenkomt met de ETag van het verzoek dat de marker genereerde. Bovendien, als het verzoek dat de marker genereerde een Range of header x-ms-range bevatte, MOET het volgende verzoek een identieke header bevatten. Als het verzoek dat de marker genereerde geen bereikheader bevatte, MAG het volgende verzoek ook geen rangeheader bevatten.

  • Je MAG NIET aannemen dat de lijst met eindpunten in de respons overeenkomt met de lijst van eindpunten van eerdere Get Blob Layout verzoeken aan deze blob. Dit geldt zelfs als het verzoek een marker gebruikt – de eindpuntlijst hoeft niet overeen te komen met de eindpuntlijst van het verzoek dat de marker genereerde.

  • Het eindpunt dat voor elk bereik wordt geretourneerd is een DNS-hostnaam en poort, geretourneerd in de vorm hostname:port. Dit is het service-eindpunt dat voor dit bereik gelezen moet worden. Je MOET zowel de hostnaam als de poort gebruiken die zijn opgegeven bij het construeren van je HTTP-verzoek. De hostnaam bevat mogelijk geen accountnaam, dus je MOET expliciet de juiste Host header toevoegen in volgende Get Blob API-aanroepen tegen dit endpoint.

  • De indeling van een blob kan in de loop van de tijd veranderen, zelfs als de blob niet wordt aangepast. De lay-out van een bepaalde blob moet na vijf minuten worden ververst, of wanneer de blob wordt aangepast.

Zie ook

aanvragen autoriseren voor Azure Storage
status en foutcodes
Foutcodes voor Blob Storage
Stel time-outs in voor Blob Storage-operatiesBlob Service-conceptenSpecificeer conditionele headers voor Blob Storage-operaties

  • Laatst bijgewerkt om