Blob-eigenschappen ophalen

Artikel
03/16/2023

De Get Blob Properties bewerking retourneert alle door de gebruiker gedefinieerde metagegevens, standaard-HTTP-eigenschappen en systeemeigenschappen voor de blob. De inhoud van de blob wordt niet geretourneerd.

Aanvraag

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

AANVRAAG-URI voor HEAD-methode	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.1

Geëmuleerde opslagservice-URI

Wanneer u een aanvraag indient bij de geëmuleerde opslagservice, geeft u de hostnaam van de emulator en Azure Blob Storage poort op als 127.0.0.1:10000, gevolgd door de naam van het geëmuleerde opslagaccount:

AANVRAAG-URI voor HEAD-methode	HTTP-versie
`http://127.0.0.1:10000/devstoreaccount1/mycontainer/myblob`	HTTP/1.1

Zie De Azure-opslagemulator gebruiken voor ontwikkelen en testen voor meer informatie.

URI-parameters

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

Parameter	Beschrijving
`snapshot`	Optioneel. De momentopnameparameter is een ondoorzichtige `DateTime` waarde die, wanneer deze aanwezig is, de blobmomentopname aangeeft die moet worden opgehaald. Zie Een momentopname van een blob maken voor meer informatie over het werken met blob-momentopnamen.
`versionid`	Optioneel. Versie 2019-12-12 en hoger. De `versionid` parameter is een ondoorzichtige `DateTime` waarde die, wanneer deze aanwezig is, aangeeft welke versie van de blob moet worden opgehaald.
`timeout`	Optioneel. De `timeout` parameter wordt uitgedrukt in seconden. Zie Time-outs instellen voor Blob Storage-bewerkingen voor meer informatie.

Aanvraagheaders

In de volgende tabel worden vereiste en optionele aanvraagheaders beschreven.

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. Optioneel voor anonieme aanvragen. Hiermee geeft u de versie van de bewerking te gebruiken voor deze aanvraag. Zie Versiebeheer voor de Azure Storage-services voor meer informatie.
`x-ms-lease-id: <ID>`	Optioneel. Als deze header is opgegeven, wordt de `Get Blob Properties` bewerking alleen uitgevoerd als aan beide van de volgende voorwaarden wordt voldaan: - De lease van de blob is momenteel actief. - De lease-id die in de aanvraag is opgegeven, komt overeen met de lease-id van de blob. Als niet aan een van deze voorwaarden wordt voldaan, mislukt de aanvraag en mislukt de `Get Blob Properties` bewerking met statuscode 412 (Voorwaarde mislukt).
`x-ms-upn`	Optioneel. Versie 2020-06-12 en hoger. Geldig voor accounts waarvoor hiërarchische naamruimte is ingeschakeld. Als de waarden van de gebruikersidentiteit die worden geretourneerd in de `x-ms-owner`waar zijn, worden ze getransformeerd van Microsoft Entra object-id's naar user principal names. Als de waarden onwaar zijn, worden ze geretourneerd als Microsoft Entra object-id's. De standaardwaarde is onwaar. Houd er rekening mee dat groeps- en toepassingsobject-id's niet worden vertaald, omdat ze geen unieke beschrijvende namen hebben.
`x-ms-client-request-id`	Optioneel. Biedt een door de client gegenereerde, ondoorzichtige waarde met een limiet van 1 kibibyte (KiB) die wordt vastgelegd in de analyselogboeken wanneer logboekregistratie voor opslaganalyse is ingeschakeld. We raden u ten zeerste aan deze header te gebruiken wanneer u activiteiten aan de clientzijde correleert met aanvragen die door de server worden ontvangen. Zie Logboekregistratie van Azure Opslaganalyse voor meer informatie.

Deze bewerking ondersteunt ook het gebruik van voorwaardelijke headers om blobeigenschappen en metagegevens te retourneren, alleen als aan een opgegeven voorwaarde wordt voldaan. Zie Voorwaardelijke headers opgeven voor Blob Storage-bewerkingen 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 lezen die is versleuteld 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 u deze headers opnemen in de aanvraag, zodat de leesbewerking kan worden voltooid.

Aanvraagheader	Beschrijving
`x-ms-encryption-key`	Vereist. De met Base64 gecodeerde AES-256-versleutelingssleutel.
`x-ms-encryption-key-sha256`	Optioneel. 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

Geen.

Antwoord

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

Statuscode

Een geslaagde bewerking retourneert statuscode 200 (OK).

Zie Status- en foutcodes voor meer informatie over statuscodes.

Antwoordheaders

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

Antwoordheader	Description
`Last-Modified`	De datum/tijd waarop de blob het laatst is gewijzigd. De datumnotatie volgt RFC 1123. Zie Datum/tijdwaarden weergeven in kopteksten voor meer informatie. Elke bewerking die de blob wijzigt, inclusief een update van de metagegevens of eigenschappen van de blob, verandert de laatste wijzigingstijd van de blob.
`x-ms-creation-time`	Versie 2017-11-09 en hoger. De datum/tijd waarop de blob is gemaakt. De datumnotatie volgt RFC 1123. Zie Datum/tijdwaarden weergeven in kopteksten voor 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`	Versie 2019-12-12 en hoger. Als de blob tags bevat, wordt het aantal tags geretourneerd dat op de blob is opgeslagen. Deze header wordt niet geretourneerd als de blob geen tags bevat.
`x-ms-blob-type:<BlockBlob\\|PageBlob\\|AppendBlob>`	Het blobtype.
`x-ms-copy-completion-time:<datetime>`	Versie 2012-02-12 en hoger. Tijdstip van de laatste poging tot `Copy Blob` bewerking waarbij deze blob de doel-blob was. Deze waarde kan het tijdstip opgeven van een voltooide, afgebroken of mislukte kopieerpoging. Deze koptekst wordt niet weergegeven als er een kopie in behandeling is, als deze blob nooit het doel in een `Copy Blob` bewerking is geweest of als deze blob is gewijzigd na een voltooide `Copy Blob` bewerking die gebruikmaakt van `Set Blob Properties`, `Put Blob`of `Put Block List`.
`x-ms-copy-status-description: <error string>`	Versie 2012-02-12 en hoger. Wordt alleen weergegeven wanneer `x-ms-copy-status` is `failed` of `pending`. Beschrijft de oorzaak van een fatale of niet-fatale kopieerbewerkingsfout. Deze header wordt niet weergegeven als deze blob nooit het doel is geweest in een `Copy Blob` bewerking of als deze blob is gewijzigd na een voltooide `Copy Blob` bewerking die gebruikmaakt van `Set Blob Properties`, `Put Blob`of `Put Block List`.
`x-ms-copy-id: <id>`	Versie 2012-02-12 en hoger. De tekenreeks-id voor de laatste poging tot `Copy Blob` bewerking, waarbij deze blob de doel-blob was. Deze header wordt niet weergegeven als deze blob nooit het doel is geweest in een `Copy Blob` bewerking of als deze blob is gewijzigd na een voltooide `Copy Blob` bewerking die gebruikmaakt van `Set Blob Properties`, `Put Blob`of `Put Block List`.
`x-ms-copy-progress: <bytes copied/bytes total>`	Versie 2012-02-12 en hoger. Bevat het aantal gekopieerde bytes en het totale aantal bytes in de bron in de laatste poging, `Copy Blob` waarbij deze blob de doel-blob was. Kan weergeven van 0 tot `Content-Length` gekopieerde bytes. Deze header wordt niet weergegeven als deze blob nooit het doel is geweest in een `Copy Blob` bewerking of als deze blob is gewijzigd na een voltooide `Copy Blob` bewerking die gebruikmaakt van `Set Blob Properties`, `Put Blob`of `Put Block List`.
`x-ms-copy-source: url`	Versie 2012-02-12 en hoger. Een URL met een lengte van maximaal 2 KiB die de bron-blob aangeeft die is gebruikt in de laatste poging tot `Copy Blob` bewerking, waarbij deze blob de doel-blob was. Deze header wordt niet weergegeven als deze blob nooit het doel is geweest in een `Copy Blob` bewerking of als deze blob is gewijzigd na een voltooide `Copy Blob` bewerking die gebruikmaakt van `Set Blob Properties`, `Put Blob`of `Put Block List`.
`x-ms-copy-status: <pending \\| success \\| aborted \\| failed>`	Versie 2012-02-12 en hoger. De status van de kopieerbewerking die wordt geïdentificeerd door x-ms-copy-id, met deze waarden: - `success`: het kopiëren is voltooid. - `pending`: Kopiëren wordt uitgevoerd. Controleer `x-ms-copy-status-description` of onregelmatige, niet-fatale fouten de kopieervoortgang belemmeren, maar geen fouten veroorzaken. - `aborted`: het kopiëren is beëindigd door `Abort Copy Blob`. - `failed`: Kopiëren is mislukt. Zie `x-ms-copy-status-description` voor foutdetails. Deze header wordt niet weergegeven als deze blob nooit het doel is geweest in een `Copy Blob` bewerking of als deze blob is gewijzigd na een voltooide `Copy Blob` bewerking die gebruikmaakt van `Set Blob Properties`, `Put Blob`of `Put Block List`.
`x-ms-incremental-copy: true`	Versie 2016-05-31 en hoger. Opgenomen als de blob een blob voor incrementeel kopiëren is.
`x-ms-copy-destination-snapshot:<datetime>`	Versie 2016-05-31 en hoger. Opgenomen als de blob een incrementele kopie-blob of momentopname van incrementele kopie is, als `x-ms-copy-status` is geslaagd. Momentopnametijd van de laatste geslaagde momentopname van incrementeel kopiëren voor deze blob.
`x-ms-lease-duration: <infinite \\| fixed>`	Wanneer een blob wordt geleased, geeft u op of de lease een oneindige of vaste duur heeft. Opgenomen voor aanvragen die versie 2012-02-12 en hoger gebruiken.
`x-ms-lease-state: <available \\| leased \\| expired \\| breaking \\| broken>`	De leasestatus van de blob. Opgenomen voor aanvragen die versie 2012-02-12 en hoger gebruiken.
`x-ms-lease-status:<locked\\| unlocked>`	De leasestatus van de blob.
`Content-Length`	De grootte van de blob in bytes. Voor een pagina-blob retourneert deze koptekst de waarde van de `x-ms-blob-content-length` koptekst die is opgeslagen bij de blob.
`Content-Type`	Het inhoudstype dat is opgegeven voor de blob. Als er geen inhoudstype is opgegeven, is `application/octet-stream`het standaardinhoudstype .
`Etag`	De ETag bevat een waarde die u kunt gebruiken om bewerkingen voorwaardelijk uit te voeren. Zie Voorwaardelijke headers opgeven voor Blob Storage-bewerkingen voor meer informatie. Als de aanvraagversie 2011-08-18 of hoger is, wordt de waarde ETag tussen aanhalingstekens geplaatst.
`Content-MD5`	Als de `Content-MD5` header is ingesteld voor de blob, wordt deze antwoordheader geretourneerd, zodat de client de integriteit van de berichtinhoud kan controleren. In versie 2012-02-12 en hoger stelt u de MD5-waarde van een blok-blob in, `Put Blob` zelfs wanneer de `Put Blob` aanvraag geen MD5-header bevat.
`Content-Encoding`	Als de `Content-Encoding` aanvraagheader eerder is ingesteld voor de blob, wordt die waarde geretourneerd in deze header.
`Content-Language`	Als de `Content-Language` aanvraagheader eerder is ingesteld voor de blob, wordt die waarde geretourneerd in deze header.
`Content-Disposition`	Als de `Content-Disposition` aanvraagheader eerder is ingesteld voor de blob, wordt deze waarde geretourneerd in deze header, voor aanvragen met versie 2013-08-15 en hoger. Het `Content-Disposition` veld antwoordheader bevat aanvullende informatie over het verwerken van de nettolading van het antwoord en kan ook worden gebruikt om aanvullende metagegevens toe te voegen. Als de header bijvoorbeeld is ingesteld op `attachment`, geeft dit aan dat de user-agent het antwoord niet moet weergeven, maar in plaats daarvan een dialoogvenster Opslaan als moet weergeven.
`Cache-Control`	Als de `Cache-Control` aanvraagheader eerder is ingesteld voor de blob, wordt die waarde geretourneerd in deze header.
`x-ms-blob-sequence-number`	Het huidige volgnummer voor een pagina-blob. Deze koptekst wordt niet geretourneerd voor blok-blobs of toevoeg-blobs. Deze header wordt niet geretourneerd voor blok-blobs.
`x-ms-request-id`	Deze header identificeert op unieke wijze de aanvraag die is gedaan en u kunt deze gebruiken om problemen met de aanvraag op te lossen. Zie Problemen met API-bewerkingen oplossen voor meer informatie.
`x-ms-version`	Geeft de Blob Storage-versie aan die wordt 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. Deze header wordt ook geretourneerd voor anonieme aanvragen zonder een opgegeven versie als de container is gemarkeerd voor openbare toegang met blobopslagversie 2009-09-19.
`Date`	Een UTC-datum/tijd-waarde die wordt gegenereerd door de service die de tijd aangeeft waarop het antwoord is gestart.
`Accept-Ranges: bytes`	Geeft aan dat de service aanvragen voor gedeeltelijke blob-inhoud ondersteunt. Opgenomen voor aanvragen die zijn gedaan met versie 2013-08-15 en hoger.
`x-ms-blob-committed-block-count`	Het aantal vastgelegde blokken dat aanwezig is in de blob. Deze koptekst wordt alleen geretourneerd voor toevoeg-blobs.
`x-ms-server-encrypted: true/false`	Versie 2015-12-11 en hoger. De waarde van deze header wordt 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`	Versie 2019-02-02 en hoger. Deze header wordt geretourneerd als de blob is versleuteld met een door de klant opgegeven sleutel.
`x-ms-encryption-context`	Versie 2021-08-06 en hoger. 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 hoger. Deze header wordt geretourneerd als de blob is versleuteld met een versleutelingsbereik.
`x-ms-access-tier`	Versie 2017-04-17 en hoger. De laag van pagina-blob op een Premium Storage-account of -laag van een blok-blob in een Blob Storage- of v2-account voor algemeen gebruik. Zie High-performance Premium Storage and managed disks for VM's (High-performance Premium Storage and managed disks for VM's) voor een lijst met toegestane bloblagen voor premium-pagina's. Voor een blobopslagaccount of een v2-account voor algemeen gebruik zijn `Hot`geldige waarden , `Cool`, `Cold`en `Archive`. Opmerking:`Cold` laag wordt ondersteund voor versie 2021-12-02 en hoger. Zie Opslaglagen voor dynamische, statische en archiefopslag voor gedetailleerde informatie over opslaglagen op blok-blobniveau van standaard-blobaccounts.
`x-ms-access-tier-inferred: true`	Versie 2017-04-17 en hoger. Alleen voor pagina-blobs op een Premium Storage-account. Als de toegangslaag niet expliciet is ingesteld op de blob, wordt de laag afgeleid op basis van de lengte van de inhoud en wordt deze header geretourneerd met de waarde .`true` Als voor blok-blobs in Blob Storage of een v2-account voor algemeen gebruik de toegangslaag niet is ingesteld voor de blob, kunt u de laag afleiden uit de eigenschappen van het opslagaccount. Deze header wordt alleen ingesteld als de blok-bloblaag wordt afgeleid.
`x-ms-archive-status`	Versie 2017-04-17 en hoger. Voor blobopslag of een v2-account voor algemeen gebruik zijn `rehydrate-pending-to-hot`geldige waarden , `rehydrate-pending-to-cool`en `rehydrate-pending-to-cold`. Als de blob wordt gerehydrateerd en onvolledig is, wordt deze header geretourneerd, wat aangeeft dat het rehydrate in behandeling is en de doellaag weergeeft. Zie Opslaglagen dynamisch, statisch en archief voor gedetailleerde informatie over opslaglagen op blok-blobniveau voor standaardblobsaccounts.
`x-ms-access-tier-change-time`	Versie 2017-04-17 en hoger. Geeft de laatste keer aan dat de laag voor het object is gewijzigd. Deze header wordt alleen geretourneerd als er ooit een laag op blok-blob is ingesteld. De datumnotatie volgt RFC 1123. Zie Datum/tijdwaarden weergeven in kopteksten voor meer informatie. Zie Opslaglagen dynamisch, statisch en archief voor meer informatie over opslaglagen op blok-blobniveau van standaardblobsaccounts.
`x-ms-client-request-id`	Kan worden gebruikt om problemen met aanvragen en de 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 maximaal 1024 zichtbare ASCII-tekens is. Als de `x-ms-client-request-id` header niet aanwezig is in de aanvraag, is deze header niet aanwezig in het antwoord.
`x-ms-rehydrate-priority`	Versie 2019-12-12 en hoger. Als een object de status Rehydrate in behandeling heeft, wordt deze header geretourneerd met de prioriteit van rehydrate. Geldige waarden zijn `High`/`Standard`. Zie Opslaglagen voor dynamische, statische en archiefopslag voor gedetailleerde informatie over opslaglagen op blok-blobniveau van standaard-blobaccounts.
`x-ms-or-{policy-id}_{rule-id}`	Versie 2019-12-12 en hoger, alleen geretourneerd voor blok-blobs. `policy-id` is een GUID-waarde die de id van een objectreplicatiebeleid voor het opslagaccount vertegenwoordigt. `rule-id` is een GUID-waarde die de id van een beleidsregel in de blobcontainer vertegenwoordigt. Als het account is `ObjectReplication`ingeschakeld, vertegenwoordigt de waarde van deze header de replicatiestatus van de blob met de opgegeven beleids- en regel-id's, ofwel `complete` of `failed`.
`x-ms-or-policy-id`	Versie 2019-12-12 en hoger, alleen geretourneerd voor blok-blobs. Als het account is `ObjectReplication`ingeschakeld, vertegenwoordigt de waarde van deze header het beleid dat de replicatie bepaalt.
`x-ms-last-access-time`	Versie 2020-02-10 en hoger. Geeft de laatste keer aan dat de gegevens van de blob zijn geopend op basis van het beleid voor het bijhouden van de laatste toegangstijd van het opslagaccount. De header 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 informatie over het instellen van het beleid voor het bijhouden van laatste toegangstijden van het opslagaccount.
`x-ms-blob-sealed`	Versie 2019-12-12 en hoger, alleen geretourneerd voor toevoeg-blobs. Als de toevoeg-blob is verzegeld, is de waarde true. Zie Blob-zegel toevoegen voor meer informatie
`x-ms-immutability-policy-until-date`	Versie 2020-06-12 en hoger. Hiermee geeft u de 'retentie tot'-datum die is ingesteld op de blob. Dit is de datum totdat de blob kan worden beveiligd tegen wijziging of verwijdering. Wordt alleen geretourneerd als er een beleid voor onveranderbaarheid is ingesteld op de blob. De waarde van deze koptekst is RFC1123 indeling.
`x-ms-immutability-policy-mode: unlocked/locked`	Versie 2020-06-12 en hoger. De beleidsmodus voor onveranderbaarheid, die wordt geretourneerd als er een onveranderbaarheidsbeleid 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 acties verboden zijn.
`x-ms-legal-hold: true/false`	Versie 2020-06-12 en hoger. Deze header wordt niet geretourneerd als er geen juridische bewaring is voor de blob. De waarde van deze header wordt ingesteld op true als de blob een juridische bewaring bevat en de waarde true is. Anders wordt de waarde ingesteld op false als de blob een juridische bewaring en de bijbehorende waarde false bevat.
`x-ms-owner`	Versie 2020-06-12 en hoger. Alleen voor accounts waarvoor een hiërarchische naamruimte is ingeschakeld. Retourneert de eigenaar van het bestand of de map.
`x-ms-group`	Versie 2020-06-12 en hoger. Alleen voor accounts waarvoor een hiërarchische naamruimte is ingeschakeld. Retourneert de eigenaarsgroep van het bestand of de map.
`x-ms-permissions`	Versie 2020-06-12 en hoger. Alleen voor accounts waarvoor een hiërarchische naamruimte is ingeschakeld. Retourneert de machtigingen die zijn ingesteld voor gebruiker, groep en andere voor het bestand of de map. Elke afzonderlijke machtiging heeft de indeling [r,w,x,-].{3}
`x-ms-resource-type`	Versie 2020-10-02 en hoger. Alleen voor accounts waarvoor een hiërarchische naamruimte is ingeschakeld. Retourneert het resourcetype voor het pad, dat of `directory`kan zijn`file`.
`x-ms-expiry-time`	Versie 2020-02-10 en hoger. Alleen voor accounts waarvoor een hiërarchische naamruimte is ingeschakeld. Retourneert de verlooptijd die is ingesteld op de blob. Wordt alleen geretourneerd voor bestanden waarvoor een verlooptijd is ingesteld.

Hoofdtekst van de reactie

Geen.

Voorbeeldantwoord

Response Status:  
HTTP/1.1 200 OK  
  
Response Headers:  
x-ms-meta-Name: myblob.txt  
x-ms-meta-DateUploaded: <date>  
x-ms-blob-type: AppendBlob  
x-ms-lease-status: unlocked  
x-ms-lease-state: available  
Content-Length: 11  
Content-Type: text/plain; charset=UTF-8  
Date: <date>  
ETag: "0x8CAE97120C1FF22"  
Accept-Ranges: bytes  
x-ms-blob-committed–block-count: 1  
x-ms-version: 2015-02-21  
Last-Modified: <date>  
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>

Autorisatie

Autorisatie is vereist bij het aanroepen van een bewerking voor gegevenstoegang in Azure Storage. U kunt de Get Blob Properties 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 Get Blob Properties 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/read
Ingebouwde rol met minimale bevoegdheden:Lezer 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 Get Blob Properties 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 Get Blob Properties bewerking met behulp van een SAS-token dat is gedelegeerd aan een container of blob-resource, is de machtiging Lezen (r) 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.

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
Blob-eigenschappen ophalen	Blob (b)	Object (o)	Lezen (r)

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

Opmerkingen

Als u wilt bepalen of een Copy Blob bewerking is voltooid, controleert u eerst of de x-ms-copy-id headerwaarde overeenkomt met de kopie-id die is opgegeven door de oorspronkelijke aanroep van Copy Blob. Een overeenkomst zorgt ervoor dat een andere toepassing de kopie niet heeft afgebroken en een nieuwe Copy Blob bewerking start. Controleer vervolgens op de x-ms-copy-status: success koptekst. Houd er echter rekening mee dat alle schrijfbewerkingen op een blob, met uitzondering Leasevan , Put Pageen Put Block , alle x-ms-copy-* eigenschappen uit de blob verwijderen. Deze eigenschappen worden ook niet gekopieerd door Copy Blob bewerkingen die gebruikmaken van eerdere versies dan 2012-02-12.

x-ms-copy-status-description bevat meer informatie over de Copy Blob fout. De x-ms-copy-status-description waarden worden beschreven in de volgende tabel:

Onderdeel	Beschrijving
HTTP-statuscode	Een standaard 3-cijferig geheel getal dat de fout aangeeft.
Foutcode	Een trefwoord dat de fout beschrijft die door Azure wordt geleverd in het <element ErrorCode> . Als er geen <ErrorCode-element> wordt weergegeven, wordt een trefwoord met standaardfouttekst gebruikt dat is gekoppeld aan de 3-cijferige HTTP-statuscode in de HTTP-specificatie. Zie Algemene REST API-foutcodes voor meer informatie.
Informatie	Gedetailleerde beschrijving van de fout, tussen aanhalingstekens.

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

Belangrijk

De volgende foutbeschrijvingen kunnen zonder waarschuwing worden gewijzigd, zelfs zonder een versiewijziging, waardoor de tekst mogelijk niet exact overeenkomt.

Scenario	x-ms-copy-statuswaarde	x-ms-copy-status-description-waarde
De kopieerbewerking is voltooid.	voltooid	leeg
De kopieerbewerking is door de gebruiker afgebroken voordat deze is voltooid.	Afgebroken	leeg
Er is een fout opgetreden bij het lezen van de bron-blob tijdens een kopieerbewerking, 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. Time of failure: <time>"
Er is een fout opgetreden bij het schrijven naar de doel-blob van een kopieerbewerking, maar de bewerking wordt opnieuw geprobeerd.	in behandeling	500 InternalServerError 'Er is een fout opgetreden die opnieuw kan worden geprobeerd. Zal het opnieuw proberen. Time of failure: <time>"
Er is een onherstelbare fout opgetreden bij het lezen van de bron-blob van een kopieerbewerking.	mislukt	404 ResourceNotFound 'Kopiëren is mislukt bij het lezen van de bron'. Opmerking: wanneer de service deze onderliggende fout rapporteert `ResourceNotFound` , wordt deze geretourneerd in het <element ErrorCode> . Als er geen <ErrorCode-element> in het antwoord wordt weergegeven, wordt een standaardtekenreeksweergave van de HTTP-status, zoals `NotFound`, weergegeven.
De time-outperiode die alle kopieerbewerkingen beperkt, is verstreken. (Momenteel is de time-outperiode twee weken.)	mislukt	500 OperationCancelled "De kopie heeft de maximaal toegestane tijd overschreden."
De kopieerbewerking is te vaak mislukt bij het lezen van de bron en voldoet niet aan een minimale verhouding van pogingen tot geslaagde pogingen. (Deze time-out voorkomt dat een zeer slechte bron gedurende twee weken opnieuw wordt geprobeerd voordat het mislukt).	mislukt	500 OperationCancelled 'Het kopiëren is mislukt bij het lezen van de bron'.

x-ms-last-access-time houdt de tijd bij waarop de gegevens van de blob zijn geopend, op basis van het laatste beleid voor het bijhouden van toegangstijden van het opslagaccount. Het openen van de metagegevens van een blob verandert niet 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. Met deze aanvragen worden kosten per transactie in rekening gebracht. Het type transactie is van invloed op de manier waarop de rekening in rekening wordt gebracht. Leestransacties worden bijvoorbeeld toegevoegd aan een andere factureringscategorie dan schrijftransacties. In de volgende tabel ziet u de factureringscategorie voor Get Blob Properties aanvragen op basis van het type opslagaccount:

Bewerking	Type opslagaccount	Factureringscategorie
Blob-eigenschappen ophalen	Premium-blok-blob Standard v2 voor algemeen gebruik	Andere bewerkingen
Blob-eigenschappen ophalen	Standard v1 voor algemeen gebruik	Leesbewerkingen

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

Zie ook

Aanvragen voor Azure Storage autoriseren
Status en foutcodes
Blob Storage-foutcodes