Delen via

Blob ophalen

De Get Blob operatie leest of downloadt een blob uit het systeem, inclusief de metadata en eigenschappen. Je kunt ook bellen Get Blob om een snapshot te lezen.

Aanvraag

U kunt de Get Blob 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

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

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

 HTTP/1.0

HTTP/1.1

Geëmuleerde opslagservice-URI

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

GET-methode request URI HTTP-versie
http://127.0.0.1:10000/devstoreaccount1/mycontainer/myblob HTTP/1.0

HTTP/1.1

Zie De Azure Storage Emulator gebruiken voor ontwikkeling en testen voor meer informatie.

URI Parameters

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

Kenmerk Description
snapshot Optional. De snapshotparameter is een ondoorzichtige DateTime waarde die, wanneer deze aanwezig is, de blob-snapshot specificeert die opgehaald moet worden. Voor meer informatie over het werken met blob-snapshots, zie Create a snapshot of a blob.
versionid Optioneel, versie 2019-12-12 en later. De versionid parameter is een ondoorzichtige DateTime waarde die, wanneer aanwezig, de versie van de blob aangeeft die opgehaald moet worden.
timeout Optional. De timeout parameter wordt uitgedrukt in seconden. Voor meer informatie, zie Stel timeouts in voor Blob Storage operaties.

Headers aanvragen

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

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. Optioneel voor anonieme verzoeken. Hiermee geeft u de versie van de bewerking die moet worden gebruikt voor deze aanvraag. Als deze header wordt weggelaten voor een anoniem verzoek, voert de service het verzoek uit met versie 2009-09-19. Zie Versiebeheer voor de Azure Storage-services voor meer informatie.
Range Optional. Geef de bytes van de blob alleen terug in het opgegeven bereik.
x-ms-range Optional. Geef de bytes van de blob alleen terug in het opgegeven bereik. Als zowel Range als x-ms-range zijn gespecificeerd, gebruikt de dienst de waarde van x-ms-range. Als geen van beide bereiken wordt opgegeven, wordt de volledige inhoud van de 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 deze header wordt gespecificeerd maar aan een van deze voorwaarden niet wordt voldaan, faalt het verzoek en faalt de Get Blob operatie met statuscode 412 (Precondition Failed).
x-ms-range-get-content-md5: true Optional. Wanneer deze header wordt ingesteld op true en samen met de Range header wordt gespecificeerd, retourneert de service de MD5-hash voor het bereik, zolang het bereik kleiner is dan of gelijk aan 4 mebibytes (MiB).

Als de header zonder de Range header wordt opgegeven, geeft de service statuscode 400 (Bad Request) terug.

Als de header is ingesteld op true wanneer het bereik 4 MiB overschrijdt, geeft de service statuscode 400 (Bad Request) terug.
x-ms-range-get-content-crc64: true Optional. Wanneer deze header wordt ingesteld op true en samen met de Range header wordt gespecificeerd, retourneert de service de CRC64-hash voor het bereik, zolang het bereik kleiner is dan of gelijk aan 4 MiB in grootte.

Als de header zonder de Range header wordt opgegeven, geeft de service statuscode 400 (Bad Request) terug.

Als de header is ingesteld op true wanneer het bereik 4 MiB overschrijdt, geeft de service statuscode 400 (Bad Request) terug.

Als zowel de x-ms-range-get-content-md5 and-headers x-ms-range-get-content-crc64 aanwezig zijn, faalt het verzoek met een 400 (Bad Request).

Deze header wordt ondersteund in versies 2019-02-02 en later.
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.
x-ms-upn Optional. Versie 2023-11-03 en later. 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 Storage Analytics loging.
x-ms-structured-body Optional. Versie 2025-01-05 en later. Indien gespecificeerd, zal de service de blob-inhoud teruggeven die gecodeerd is in het structured body-formaat. 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 antwoord crc64-checksumsegmenten in het gecodeerde bericht zal gebruiken. Als de waarde hier niet overeenkomt, faalt de bewerking met foutcode 400 (Bad Request).

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

Request-headers (door de klant verstrekte encryptiesleutels)

Vanaf versie 2019-02-02 kun je 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 om de leesoperatie succesvol te voltooien.

Header van het verzoek Description
x-ms-encryption-key Verplicht. 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 Verplicht. Specificeert het algoritme dat voor encryptie moet worden gebruikt. De waarde van deze header moet zijn AES256.

Inhoud van het verzoek

Geen.

Reactie

Het antwoord bevat een HTTP-statuscode, een set responsheaders en de responsbody, die de inhoud van de blob bevat.

Statuscode

Een succesvolle operatie om de volledige blob te lezen geeft statuscode 200 (OK) terug.

Een succesvolle operatie om een gespecificeerd bereik te lezen geeft statuscode 206 (Gedeeltelijke Inhoud) terug.

Zie Status en foutcodesvoor meer informatie over statuscodes.

Antwoordkopteksten

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

Syntaxis Description
Last-Modified De datum/tijd waarop de blob voor het laatst is aangepast. Het datumformaat volgt RFC 1123.

Elke bewerking die de blob wijzigt, inclusief een update van de metagegevens of eigenschappen van de blob, wijzigt de laatste wijzigingstijd van de blob.
x-ms-creation-time Versie 2017-11-09 en later. De datum/tijd waarop de blob is gemaakt. Het datumformaat volgt RFC 1123.
x-ms-meta-name:value Een set naam-waardeparen die aan deze blob zijn gekoppeld als door de gebruiker gedefinieerde metadata.
x-ms-tag-count Versie 2019-12-12 en later. Als de blob tags heeft, geeft deze header het aantal tags terug dat op de blob is opgeslagen. De header wordt niet teruggegeven als er geen tags op de blob staan.
Content-Length Het aantal bytes dat aanwezig is in de responsbody.
Content-Type Het contenttype dat voor de blob is opgegeven. Het standaardinhoudstype is application/octet-stream.
Content-Range Geeft het bereik van bytes aan dat wordt teruggegeven als de client een subset van de blob heeft aangevraagd door de request-header in te Range stellen.
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. Als de aanvraagversie 2011-08-18 of hoger is, wordt de ETag-waarde tussen aanhalingstekens geplaatst.
Content-MD5 Als de blob een MD5-hash heeft en deze Get Blob bewerking is om de volledige blob te lezen, wordt deze responsheader teruggegeven zodat de client kan controleren op de integriteit van de berichtinhoud.

In versie 2012-02-12 en later Put Blob wordt de MD5-hashwaarde van een blokblob ingesteld, zelfs als het Put Blob verzoek geen MD5-header bevat.

Als het verzoek is om een gespecificeerd bereik te lezen en de x-ms-range-get-content-md5 is ingesteld op true, geeft het verzoek een MD5-hash voor het bereik terug, zolang de bereikgrootte kleiner is dan of gelijk aan 4 MiB.

Als geen van deze sets voorwaarden is true, wordt er geen waarde teruggegeven voor de Content-MD5 header.

Als x-ms-range-get-content-md5 wordt opgegeven zonder de Range header, geeft de service statuscode 400 (Bad Request) terug.

Als x-ms-range-get-content-md5 wordt ingesteld op true wanneer het bereik 4 MiB overschrijdt, geeft de service statuscode 400 (Bad Request) terug.
x-ms-content-crc64 Als het verzoek is om een gespecificeerd bereik te lezen en de x-ms-range-get-content-crc64 is ingesteld op true, geeft het verzoek een CRC64-hash terug voor het bereik, zolang de bereikgrootte kleiner is dan of gelijk aan 4 MiB.

Als x-ms-range-get-content-crc64 wordt opgegeven zonder de Range header, geeft de service statuscode 400 (Bad Request) terug.

Als x-ms-range-get-content-crc64 wordt ingesteld op true wanneer het bereik 4 MiB overschrijdt, geeft de service statuscode 400 (Bad Request) terug.
Content-Encoding Geeft de waarde terug die voor de Content-Encoding request-header is opgegeven.
Content-Language Geeft de waarde terug die voor de Content-Language request-header is opgegeven.
Cache-Control Teruggegeven als de header eerder voor de blob was gespecificeerd.
Content-Disposition Teruggestuurd voor verzoeken tegen versie 2013-08-15 en later. Deze header geeft de waarde terug die voor de x-ms-blob-content-disposition header is opgegeven.

Het Content-Disposition responsheaderveld geeft aanvullende informatie over hoe de responspayload verwerkt moet worden, en kan worden gebruikt 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 toont het een Save Als-dialoogvenster met een andere bestandsnaam dan de opgegeven blobnaam.
x-ms-blob-sequence-number Het huidige volgnummer voor een pagina-blob.

Deze header wordt niet teruggegeven voor block blobs of addend blobs.
x-ms-blob-type: <BlockBlob | PageBlob | AppendBlob> Geeft het type van de blob terug.
x-ms-copy-completion-time: <datetime> Versie 2012-02-12 en later. De afsluittijd van de laatste poging Copy Blob tot operatie waarbij deze blob de bestemmingsblob was. Deze waarde kan de tijd opgeven van een voltooide, afgebroken of mislukte kopieerpoging. Deze header verschijnt niet als er een kopie in behandeling is, als deze blob nooit de bestemming in een Copy Blob operatie is geweest, of als deze blob is aangepast na een voltooide Copy Blob operatie waarbij , Put Blob, of Put Block Listwerd gebruiktSet Blob Properties.
x-ms-copy-status-description: <error string> Versie 2012-02-12 en later. Verschijnt alleen wanneer x-ms-copy-status is failed of pending. Beschrijft de oorzaak van de laatste fatale of niet-fatale kopieerbewerking. Deze header verschijnt niet als deze blob nooit de bestemming in een Copy Blob operatie is geweest, of als deze blob is aangepast na een voltooide Copy Blob operatie waarbij , Put Blob, of Put Block Listwerd gebruiktSet Blob Properties.
x-ms-copy-id: <id> Versie 2012-02-12 en later. Een string-identificatie voor de laatste poging waarbij Copy Blob deze blob de bestemmingsblob was. Deze header verschijnt niet als deze blob nooit de bestemming in een Copy Blob operatie is geweest, of als deze blob is aangepast na een voltooide Copy Blob operatie waarbij , Put Blob, of Put Block Listwerd gebruiktSet Blob Properties.
x-ms-copy-progress: <bytes copied/bytes total> Versie 2012-02-12 en later. Bevat het aantal bytes dat gekopieerd is en het totale aantal bytes in de bron bij de laatste poging Copy Blob waarbij deze blob de bestemmingsblob was. Het kan zien dat er 0 tot Content-Length bytes gekopieerd zijn. Deze header verschijnt niet als deze blob nooit de bestemming in een Copy Blob operatie is geweest, of als deze blob is aangepast na een voltooide Copy Blob operatie waarbij , Put Blob, of Put Block Listwerd gebruiktSet Blob Properties.
x-ms-copy-source: url Versie 2012-02-12 en later. Een URL tot 2 KiB lang die het bron-blob of bestand specificeert dat bij de laatste poging tot Copy Blob operatie werd gebruikt, waarbij deze blob de bestemmingsblob was. Deze header verschijnt niet als deze blob nooit de bestemming in een Copy Blob operatie is geweest, of als deze blob is aangepast na een voltooide Copy Blob operatie waarbij , Put Blob, of Put Block Listwerd gebruiktSet Blob Properties.

De URL die in deze header wordt teruggegeven, bevat alle verzoekparameters die zijn gebruikt bij de kopieeroperatie op de bronblob, inclusief het shared access signature (SAS)-token dat werd gebruikt om toegang te krijgen tot de bronblob.
x-ms-copy-status: <pending | success | aborted | failed> Versie 2012-02-12 en later. De toestand van de kopieeroperatie die wordt geïdentificeerd door x-ms-copy-id, met deze waarden:

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

Deze header verschijnt niet als deze blob nooit de bestemming in een Copy Blob operatie is geweest, of als deze blob is aangepast na een voltooide Copy Blob operatie waarbij , Put Blob, of Put Block Listwerd gebruiktSet Blob Properties.
x-ms-lease-duration: <infinite | fixed> Versie 2012-02-12 en later. 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> Versie 2012-02-12 en later. De lease-status van de blob.
x-ms-lease-status:<locked | unlocked> De huidige leasestatus van de blob.
x-ms-request-id Identificeert uniek het verzoek dat is gedaan en kan worden gebruikt om het verzoek 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. Inbegrepen voor verzoeken die zijn gedaan met versie 2009-09-19 en later.

Deze header wordt ook teruggegeven voor anonieme verzoeken zonder een gespecificeerde versie als de container is gemarkeerd voor publieke toegang met Blob Storage versie 2009-09-19.
Accept-Ranges: bytes Geeft aan dat de service aanvragen voor gedeeltelijke blob-inhoud ondersteunt. Inbegrepen voor verzoeken die worden gedaan met versie 2011-08-18 en later, en voor de lokale opslagservice in SDK versie 1.6 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 in geval van een match.
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.
Vary Wordt teruggegeven met de waarde van de Origin header wanneer de CORS-regels worden gespecificeerd. Zie CORS-ondersteuning voor de Azure Storage services voor details.
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 wordt ingesteld op true.
x-ms-blob-committed-block-count Het aantal vastgelegde blokken dat aanwezig is in de blob. Deze header wordt alleen geretourneerd voor toevoeg-blobs.
x-ms-server-encrypted: true/false Versie 2015-12-11 en later. De waarde van deze header wordt ingesteld op true als de blobdata en applicatiemetadata volledig versleuteld zijn door het gespecificeerde algoritme te gebruiken. Anders wordt de waarde ingesteld op false (wanneer de blob niet versleuteld is, of als alleen delen van de blob of applicatiemetadata versleuteld zijn).
x-ms-encryption-key-sha256 Versie 2019-02-02 en later. Deze header wordt teruggegeven als de blob is versleuteld met een door de klant verstrekte sleutel.
x-ms-encryption-context Versie 2021-08-06 en later. Als de eigenschapswaarde van de versleutelingscontext is ingesteld, wordt de ingestelde waarde geretourneerd. Alleen geldig wanneer hiërarchische naamruimte is ingeschakeld voor het account.
x-ms-encryption-scope Versie 2019-02-02 en later. Deze header wordt teruggegeven als de blob is versleuteld met een encryptiescope.
x-ms-blob-content-md5 Versie 2016-05-31 en later. Als de blob een MD5-hash heeft, en als het verzoek een range-header bevat (Range of x-ms-range), wordt deze response-header teruggegeven met de waarde van de MD5-waarde van de hele blob. Deze waarde kan wel of niet gelijk zijn aan de waarde die wordt teruggegeven in de Content-MD5-header, waarbij deze wordt berekend vanuit het gevraagde bereik.
x-ms-client-request-id Kan worden gebruikt om problemen met verzoeken 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 het verzoek, is deze header niet aanwezig in het antwoord.
x-ms-last-access-time Versie 2020-02-10 en later. Geeft de laatste keer aan waarop de gegevens van de blob werden benaderd op basis van het laatste toegangstijdregistratiebeleid van het opslagaccount. De header wordt niet teruggegeven als het opslagaccount geen beleid heeft voor het bijhouden van de laatste toegangstijd, of als het beleid is uitgeschakeld. Voor informatie over het instellen van het beleid voor het volgen van de laatste toegangstijd van het opslagaccount, zie Blob Service API.
x-ms-blob-sealed Versie 2019-12-12 en later. Alleen teruggegeven voor toegevoegde blobs. Als de toegevoegde blob is verzegeld, zou de waarde zijn true. Voor meer informatie, zie Append Blob Seal
x-ms-immutability-policy-until-date Versie 2020-06-12 en later. Specificeert de retentie tot de datum die op de blob is ingesteld. 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 in RFC1123 formaat.
x-ms-immutability-policy-mode: unlocked/locked Versie 2020-06-12 en later. Teruggegeven als er een onveranderlijkheidsbeleid op de blob is ingesteld. De waarden zijn unlocked en locked. unlocked geeft aan dat de gebruiker het beleid kan wijzigen door het behoud tot de datum te verhogen of te verlagen. locked geeft aan dat deze handelingen verboden zijn.
x-ms-legal-hold: true/false Versie 2020-06-12 en later. Deze header wordt niet teruggegeven als er geen wettelijke blokkade op de blob is. De waarde van deze header wordt ingesteld op true als de blob een legale hold bevat en de waarde daarvan is true. Anders wordt de waarde gezet op false als de blob een legale hold bevat en de waarde daarvan is false.
x-ms-owner Versie 2020-06-12 en later, alleen voor accounts met hiërarchische naamruimte ingeschakeld. Geeft de eigenaar-gebruiker van het bestand of de map terug.
x-ms-group Versie 2020-06-12 en later, alleen voor accounts met hiërarchische naamruimte ingeschakeld. Geeft de bezittende groep van het bestand of de map terug.
x-ms-permissions Versie 2020-06-12 en later, alleen voor accounts met hiërarchische naamruimte ingeschakeld. Geeft de rechten terug die zijn ingesteld voor gebruiker, groep en andere rechten in het bestand of de map. Elke individuele toestemming is in formaat [r,w,x,-]{3} .
x-ms-acl Versie 2023-11-03 en later. 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 Versie 2020-10-02 en later, alleen voor accounts met hiërarchische naamruimte ingeschakeld. Geeft het resourcetype voor het pad terug, dat kan zijn of filedirectory.

Responsheaders (gestructureerde body)

Vanaf versie 2025-01-05 worden de volgende headers teruggegeven als het verzoek een geldige x-ms-structured-body header stuurt.

Antwoordheader Description
Content-Length Zal de lengte van de gecodeerde respons zijn (niet alleen de lengte van de geretourneerde blob-inhoud).
x-ms-structured-body 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.
x-ms-structured-content-length De waarde van deze header is de lengte van de geretourneerde blobinhoud en zal altijd kleiner zijn dan de Content-Length headerwaarde vanwege berichtcodering.

Antwoordlichaam

Het responslichaam bevat de inhoud van de blob.

Voorbeeldantwoord

Status Response:  
HTTP/1.1 200 OK  
  
Response Headers:  
x-ms-blob-type: BlockBlob  
x-ms-lease-status: unlocked  
x-ms-lease-state: available  
x-ms-meta-m1: v1  
x-ms-meta-m2: v2  
Content-Length: 11  
Content-Type: text/plain; charset=UTF-8  
Date: <date>  
ETag: "0x8CB171DBEAD6A6B"  
Vary: Origin  
Last-Modified: <date>  
x-ms-version: 2015-02-21  
Server: Windows-Azure-Blob/1.0 Microsoft-HTTPAPI/2.0  
x-ms-copy-id: 36650d67-05c9-4a24-9a7d-a2213e53caf6  
x-ms-copy-source: <url>  
x-ms-copy-status: success  
x-ms-copy-progress: 11/11  
x-ms-copy-completion-time: <date>

Authorization

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

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 Get 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

Voor een page blob levert een Get Blob bewerking over een bereik pagina's die nog geen inhoud hebben of die zijn gewist, nullen op voor die bytes.

Als je een paginablob aanroept Get Blob zonder opgegeven bereik, geeft de service het bereik van pagina's terug tot aan de opgegeven waarde voor de x-ms-blob-content-length header. Voor pagina's zonder inhoud geeft de dienst nullen terug voor die bytes.

Voor een appende blob geeft de Get Blob bewerking de x-ms-blob-committed-block-count header terug. Deze header geeft het aantal toegewezen blokken in de blob aan. De x-ms-blob-committed-block-count header wordt niet teruggegeven voor block blobs of page blobs.

Een Get Blob operatie mag twee minuten per MiB voltooid worden. Als de operatie gemiddeld langer dan twee minuten per MiB duurt, loopt de operatie uit.

De x-ms-version header is nodig om een blob op te halen die tot een private container behoort. Als de blob behoort tot een container die volledig of gedeeltelijk openbaar toegankelijk is, kan elke client deze lezen zonder een versie te specificeren; De serviceversie is niet vereist om een blob op te halen die bij een publieke container hoort. Voor meer informatie, zie Toegang beperken tot containers en blobs.

Een Get Blob bewerking op een gearchiveerde blokblob zal falen.

Kopieeroperaties

Om te bepalen of een Copy Blob bewerking is voltooid, controleer eerst of de x-ms-copy-id headerwaarde van de bestemmingsblob overeenkomt met de kopieer-ID die door de oorspronkelijke aanroep aan Copy Blobwerd gegeven. Een match zorgt ervoor dat een andere applicatie de kopie niet heeft afgebroken en een nieuwe Copy Blob operatie heeft gestart. Controleer vervolgens op de x-ms-copy-status: success header. Wees er echter van bewust dat alle schrijfbewerkingen op een blob behalve Lease, Put Page, en Put Block operaties alle x-ms-copy-* eigenschappen van de blob verwijderen. Deze eigenschappen worden ook niet gekopieerd door Copy Blob bewerkingen die gebruikmaken van Blob Storage-versies van vóór 2012-02-12.

Waarschuwing

De URL die in de x-ms-copy-source header wordt teruggegeven bevat alle verzoekparameters die zijn gebruikt bij de kopieeroperatie op de bronblob. Als je een SAS-token gebruikt om toegang te krijgen tot de bronblob, verschijnt dat SAS-token in de x-ms-copy-source header wanneer Get Blob het op de bestemmingsblob wordt aangeroepen.

Wanneer x-ms-copy-status: failed verschijnt in de reactie, x-ms-copy-status-description bevat meer informatie over de Copy Blob mislukking.

De drie velden van elke x-ms-copy-status-description waarde worden beschreven in de volgende tabel:

Onderdeel Description
HTTP-statuscode Een standaard 3-cijferig geheel getal dat de mislukking specificeert.
Foutcode Een trefwoord dat de fout beschrijft, die door Azure wordt geleverd in het <ErrorCode-element> . Als er geen ErrorCode-element <> verschijnt, wordt een trefwoord gebruikt met standaard fouttekst die gekoppeld is aan de 3-cijferige HTTP-statuscode in de HTTP-specificatie. Zie veelvoorkomende foutcodes voor REST API.
Information Een gedetailleerde beschrijving van het falen, tussen aanhalingstekens.

De x-ms-copy-status en x-ms-copy-status-description waarden van veelvoorkomende faalscenario's worden beschreven in de volgende tabel:

Belangrijk

De foutbeschrijvingen in deze tabel kunnen zonder waarschuwing veranderen, zelfs zonder een versiewijziging, dus ze komen mogelijk niet exact overeen met je tekst.

Scenario X-ms-copy-status waarde x-ms-kopieer-status-beschrijvingswaarde
De kopieerbewerking is voltooid. succes empty
De gebruiker heeft de kopieeroperatie afgebroken voordat deze voltooid was. rudimentair empty
Er deed zich een storing op bij het lezen van de bronblob tijdens een kopieeroperatie, maar de bewerking wordt opnieuw geprobeerd. in behandeling 502 BadGateway 'Er is een fout opgetreden die opnieuw kan worden geprobeerd bij het lezen van de bron. Zal het opnieuw proberen. Tijd van mislukking: <tijd>"
Er deed zich een fout voor bij het schrijven naar de bestemmingsblob van een kopieeroperatie, maar de bewerking wordt opnieuw geprobeerd. in behandeling 500 InternalServerError 'Er is een fout opgetreden die opnieuw kan worden geprobeerd. Zal het opnieuw proberen. Tijd van mislukking: <tijd>"
Er is een onherstelbare fout opgetreden bij het lezen van de bron-blob van een kopieerbewerking. mislukt 404 ResourceNotFound "Kopie mislukt bij het lezen van de bron."

Opmerking: Wanneer de service deze onderliggende fout rapporteert, keert deze terug ResourceNotFound in het ErrorCode element. Als er geen element ErrorCode in de respons verscheen, verschijnt er een standaardstringrepresentatie van de HTTP-status, zoals NotFound,
De time-outperiode voor het beperken van alle kopieerbewerkingen die zijn verstreken. (Momenteel is de time-out periode 2 weken.) mislukt 500 OperationCancelled "De kopie heeft de maximale toegestane tijd overschreden."
De kopieeroperatie faalde te vaak bij het lezen van de bron en voldeed niet aan een minimale verhouding tussen pogingen en successen. (Deze time-out voorkomt dat een zeer slechte bron meer dan twee weken opnieuw wordt geprobeerd voordat deze mislukt). mislukt 500 OperationCancelled "De kopie is mislukt bij het lezen van de bron."

x-ms-last-access-time Houdt de tijd bij waarop de gegevens van de blob werden benaderd op basis van het laatste toegangstijdregistratiebeleid van het opslagaccount. Het benaderen van de metadata van een blob verandert niets aan de laatste toegangstijd.

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 Get Blob basis van het type opslagaccount:

Operation Type opslagaccount Facturering categorie
Blob ophalen Premium blok-blob
Standaard algemeen gebruik v2
Standaard algemeen gebruik v1		 Leesbewerkingen

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 Storage-foutcodes
Stel timeouts in voor Blob Storage operaties

  • Last updated on