Delen via

Blob-eigenschappen ophalen

  • Artikel

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 parameter momentopname is een ondoorzichtige DateTime waarde die, wanneer deze aanwezig is, de blob-momentopname aangeeft die moet worden opgehaald. Zie een momentopname van een blob Creatie voor meer informatie over het werken met blobmomentopnamen.
versionid Optioneel. Versie 2019-12-12 en hoger. De versionid parameter is een ondoorzichtige DateTime waarde die, wanneer deze aanwezig is, de versie van de blob aangeeft die 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. Zie Aanvragen voor Azure Storage autoriseren voor meer informatie.
Date of x-ms-date Vereist. Geef de Coordinated Universal Time (UTC) op voor de aanvraag. Zie Aanvragen voor Azure Storage autoriseren 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 dit waar is, worden de waarden van de gebruikersidentiteit die worden geretourneerd in de x-ms-ownerx-ms-group antwoordheaders , en x-ms-acl getransformeerd van Microsoft Entra object-id's naar User Principal Names. Als de waarde false is, worden deze 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 van 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 Over Azure Opslaganalyse logboekregistratie 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 extra 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, wijzigt 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 Blobof 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 Blobof 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 Blobof 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 Blobof 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 Blobof 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 Blobof 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-streamhet 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 Hotgeldige waarden , Cool, Colden 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-hotgeldige waarden , rehydrate-pending-to-coolen 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 dynamisch, statisch en archief voor gedetailleerde informatie over opslaglagen op blok-blobniveau van standard-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 ObjectReplicationingeschakeld, vertegenwoordigt de waarde van deze header de replicatiestatus van de blob met het opgegeven beleid en regel-id's, of completefailed.
x-ms-or-policy-id Versie 2019-12-12 en hoger, alleen geretourneerd voor blok-blobs. Als het account is ObjectReplicationingeschakeld, vertegenwoordigt de waarde van deze header het beleid dat de replicatie regelt.
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 laatste beleid voor het bijhouden van toegangstijden 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 Append Blob Seal (Blobafdichting toevoegen) voor meer informatie
x-ms-immutability-policy-until-date Versie 2020-06-12 en hoger. Hiermee geeft u de datum 'retentie tot' die is ingesteld op de blob. Dit is de datum totdat de blob kan worden beveiligd tegen wijzigen of verwijderen. Alleen geretourneerd als een beleid voor onveranderbaarheid is ingesteld op de blob. De waarde van deze header is RFC1123 indeling.
x-ms-immutability-policy-mode: unlocked/locked Versie 2020-06-12 en hoger. De beleidsmodus voor onveranderbaarheid, die wordt geretourneerd als een beleid voor onveranderbaarheid 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 voor de blob is. 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 waarde false bevat.
x-ms-owner Versie 2020-06-12 en hoger. Alleen voor accounts waarvoor 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 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 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 [r,w,x,-]{3} de indeling.
x-ms-acl Versie 2023-11-03 en hoger. Alleen voor accounts waarvoor hiërarchische naamruimte is ingeschakeld. Retourneert de gecombineerde lijst met toegangsbeheer en standaardtoegangsbeheerlijst die zijn ingesteld voor gebruiker, groep en andere in het bestand of de map. Elke toegangsbeheervermelding (ACE) bestaat uit een bereik, een type, een gebruikers- of groeps-id en machtigingen in de indeling [scope]:[type]:[id]:[permissions]. Het default bereik geeft aan dat de ACE behoort tot de standaard-ACL voor een map; anders is het bereik impliciet en behoort de ACE tot de toegangs-ACL. Elke afzonderlijke machtiging heeft [r,w,x,-]{3} de indeling.
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 directorykan zijnfile.
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 voor 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.

Belangrijk

Microsoft raadt aan 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 beveiligingsprincipal. De beveiligingsprincipal kan een gebruiker, groep, toepassingsservice-principal of door Azure beheerde 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 behulp van 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, beheerde identiteit of service-principal om de Get Blob Properties bewerking aan te roepen, en de ingebouwde Azure RBAC-rol met de minste bevoegdheden 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

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