Delen via


BlobDownloadHeaders interface

Hiermee definieert u headers voor Blob_download bewerking.

Eigenschappen

acceptRanges

Geeft aan dat de service aanvragen voor gedeeltelijke blob-inhoud ondersteunt.

blobCommittedBlockCount

Het aantal vastgelegde blokken dat aanwezig is in de blob. Deze koptekst wordt alleen geretourneerd voor toevoeg-blobs.

blobContentMD5

Als de blob een MD5-hash heeft en de aanvraag een bereikheader (bereik of x-ms-bereik) bevat, wordt deze antwoordheader geretourneerd met de waarde van de MD5-waarde van de hele blob. Deze waarde kan al dan niet gelijk zijn aan de waarde die wordt geretourneerd in content-MD5-header, waarbij de laatste waarde wordt berekend op basis van het aangevraagde bereik

blobSequenceNumber

Het huidige volgnummer voor een pagina-blob. Deze koptekst wordt niet geretourneerd voor blok-blobs of toevoeg-blobs

blobType

Het type blob.

cacheControl

Deze header wordt geretourneerd als deze eerder is opgegeven voor de blob.

clientRequestId

Als een header van de clientaanvraag-id in de aanvraag wordt verzonden, is deze header aanwezig in het antwoord met dezelfde waarde.

contentCrc64

Als de aanvraag is om een opgegeven bereik te lezen en de x-ms-range-get-content-crc64 is ingesteld op true, retourneert de aanvraag een crc64 voor het bereik, zolang de bereikgrootte kleiner is dan of gelijk is aan 4 MB. Als zowel x-ms-range-get-content-crc64 & x-ms-range-get-content-md5 is opgegeven in dezelfde aanvraag, mislukt dit met 400(Ongeldige aanvraag).

contentDisposition

Deze header retourneert de waarde die is opgegeven voor de header 'x-ms-blob-content-disposition'. Het veld Content-Disposition response header bevat aanvullende informatie over het verwerken van de nettolading van het antwoord en kan ook worden gebruikt om aanvullende metagegevens toe te voegen. Als dit bijvoorbeeld is ingesteld op bijlage, geeft dit aan dat de gebruikersagent het antwoord niet moet weergeven, maar in plaats daarvan een dialoogvenster Opslaan als moet weergeven met een andere bestandsnaam dan de opgegeven blobnaam.

contentEncoding

Deze header retourneert de waarde die is opgegeven voor de aanvraagheader Content-Encoding

contentLanguage

Deze header retourneert de waarde die is opgegeven voor de aanvraagheader Content-Language.

contentLength

Het aantal bytes dat aanwezig is in de hoofdtekst van het antwoord.

contentMD5

Als de blob een MD5-hash heeft en deze bewerking is bedoeld om de volledige blob te lezen, wordt deze antwoordheader geretourneerd, zodat de client kan controleren op integriteit van de berichtinhoud.

contentRange

Geeft het bereik van bytes aan dat wordt geretourneerd in het geval dat de client een subset van de blob heeft aangevraagd door de aanvraagheader Bereik in te stellen.

contentType

Het mediatype van de hoofdtekst van het antwoord. Voor Blob downloaden is dit 'application/octet-stream'

copyCompletedOn

Conclusietijd van de laatste poging om blob te kopiëren 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 is geweest in een blob-bewerking kopiëren of als deze blob is gewijzigd na een voltooide blob-bewerking met blobeigenschappen instellen, Blob plaatsen of Lijst met blokken plaatsen.

copyId

Tekenreeks-id voor deze kopieerbewerking. Gebruik met Blob-eigenschappen ophalen om de status van deze kopieerbewerking te controleren of geef door aan Blob afbreken om een in behandeling zijnde kopie af te breken.

copyProgress

Bevat het aantal bytes dat is gekopieerd en het totale aantal bytes in de bron in de laatste poging blob te kopiëren waarbij deze blob de doel-blob was. Kan tussen 0 en bytes met lengte van inhoud weergeven die zijn gekopieerd. Deze koptekst wordt niet weergegeven als deze blob nooit het doel is geweest in een blob kopiërenbewerking of als deze blob is gewijzigd na een voltooide blob-bewerking kopiëren met blobeigenschappen instellen, blob plaatsen of lijst met blokken plaatsen

copySource

URL met een lengte van maximaal 2 kB die de bron-blob of het bronbestand aangeeft dat is gebruikt in de laatste poging blob te kopiëren waarbij deze blob de doel-blob was. Deze koptekst wordt niet weergegeven als deze blob nooit het doel is geweest in een blob kopiërenbewerking of als deze blob is gewijzigd na een voltooide blob-bewerking kopiëren met blobeigenschappen instellen, Blob plaatsen of Lijst met blokken plaatsen.

copyStatus

Status van de kopieerbewerking geïdentificeerd door x-ms-copy-id.

copyStatusDescription

Wordt alleen weergegeven wanneer x-ms-copy-status mislukt of in behandeling is. Beschrijft de oorzaak van de laatste fatale of niet-fatale kopieerbewerkingsfout. Deze koptekst wordt niet weergegeven als deze blob nooit het doel is geweest in een blob kopiërenbewerking of als deze blob is gewijzigd na een voltooide blob-bewerking kopiëren met blobeigenschappen instellen, blob plaatsen of lijst met blokken plaatsen

date

UTC-datum/tijd-waarde die is gegenereerd door de service die het tijdstip aangeeft waarop het antwoord is geïnitieerd

encryptionKeySha256

De SHA-256-hash van de versleutelingssleutel die wordt gebruikt om de blob te versleutelen. Deze header wordt alleen geretourneerd wanneer de blob is versleuteld met een door de klant opgegeven sleutel.

encryptionScope

Retourneert de naam van het versleutelingsbereik dat wordt gebruikt voor het versleutelen van de blobinhoud en de metagegevens van de toepassing. Houd er rekening mee dat het ontbreken van deze header impliceert dat het standaardbereik voor accountversleuteling wordt gebruikt.

errorCode

Foutcode

etag

De ETag bevat een waarde die u kunt gebruiken om bewerkingen voorwaardelijk uit te voeren. Als de aanvraagversie 2011-08-18 of nieuwer is, wordt de waarde ETag tussen aanhalingstekens weergegeven.

immutabilityPolicyExpiresOn

Utc-datum/tijd-waarde die wordt gegenereerd door de service die de tijd aangeeft waarop het beleid voor onveranderbaarheid van de blob verloopt.

immutabilityPolicyMode

Hiermee wordt de beleidsmodus voor onveranderbaarheid aangegeven.

isCurrentVersion

De waarde van deze header geeft aan of de versie van deze blob een huidige versie is. Zie ook x-ms-version-id-header.

isSealed

Als deze blob is verzegeld

isServerEncrypted

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).

lastAccessed

UTC-datum/tijd-waarde gegenereerd door de service die de tijd aangeeft waarop de blob voor het laatst is gelezen of geschreven naar

lastModified

Retourneert de datum en tijd waarop de container voor het laatst is gewijzigd. Elke bewerking die de blob wijzigt, inclusief een update van de metagegevens of eigenschappen van de blob, wijzigt de tijd van de laatste wijziging van de blob.

leaseDuration

Wanneer een blob wordt geleased, geeft u op of de lease een oneindige of vaste duur heeft.

leaseState

Leasestatus van de blob.

leaseStatus

De huidige leasestatus van de blob.

legalHold

Hiermee wordt aangegeven of er een juridische bewaring aanwezig is op de blob.

metadata
objectReplicationPolicyId

Optioneel. Alleen geldig wanneer objectreplicatie is ingeschakeld voor de opslagcontainer en op de doel-blob van de replicatie.

objectReplicationRules

Optioneel. Alleen geldig wanneer objectreplicatie is ingeschakeld voor de opslagcontainer en op de bron-blob van de replicatie. Bij het ophalen van deze header wordt de header geretourneerd met de beleids-id en regel-id (bijvoorbeeld x-ms-or-policyid_ruleid) en is de waarde de status van de replicatie (bijvoorbeeld voltooid, mislukt).

requestId

Deze header identificeert op unieke wijze de aanvraag die is gedaan en kan worden gebruikt voor het oplossen van problemen met de aanvraag.

tagCount

Het aantal tags dat is gekoppeld aan de blob

version

Geeft de versie aan van de Blob-service die wordt gebruikt om de aanvraag uit te voeren. Deze header wordt geretourneerd voor aanvragen die zijn gedaan in versie 2009-09-19 en hoger.

versionId

Een Datum/tijd-waarde die wordt geretourneerd door de service die de blob uniek identificeert. De waarde van deze header geeft de blobversie aan en kan worden gebruikt in volgende aanvragen voor toegang tot deze versie van de blob.

Eigenschapdetails

acceptRanges

Geeft aan dat de service aanvragen voor gedeeltelijke blob-inhoud ondersteunt.

acceptRanges?: string

Waarde van eigenschap

string

blobCommittedBlockCount

Het aantal vastgelegde blokken dat aanwezig is in de blob. Deze koptekst wordt alleen geretourneerd voor toevoeg-blobs.

blobCommittedBlockCount?: number

Waarde van eigenschap

number

blobContentMD5

Als de blob een MD5-hash heeft en de aanvraag een bereikheader (bereik of x-ms-bereik) bevat, wordt deze antwoordheader geretourneerd met de waarde van de MD5-waarde van de hele blob. Deze waarde kan al dan niet gelijk zijn aan de waarde die wordt geretourneerd in content-MD5-header, waarbij de laatste waarde wordt berekend op basis van het aangevraagde bereik

blobContentMD5?: Uint8Array

Waarde van eigenschap

Uint8Array

blobSequenceNumber

Het huidige volgnummer voor een pagina-blob. Deze koptekst wordt niet geretourneerd voor blok-blobs of toevoeg-blobs

blobSequenceNumber?: number

Waarde van eigenschap

number

blobType

Het type blob.

blobType?: BlobType

Waarde van eigenschap

cacheControl

Deze header wordt geretourneerd als deze eerder is opgegeven voor de blob.

cacheControl?: string

Waarde van eigenschap

string

clientRequestId

Als een header van de clientaanvraag-id in de aanvraag wordt verzonden, is deze header aanwezig in het antwoord met dezelfde waarde.

clientRequestId?: string

Waarde van eigenschap

string

contentCrc64

Als de aanvraag is om een opgegeven bereik te lezen en de x-ms-range-get-content-crc64 is ingesteld op true, retourneert de aanvraag een crc64 voor het bereik, zolang de bereikgrootte kleiner is dan of gelijk is aan 4 MB. Als zowel x-ms-range-get-content-crc64 & x-ms-range-get-content-md5 is opgegeven in dezelfde aanvraag, mislukt dit met 400(Ongeldige aanvraag).

contentCrc64?: Uint8Array

Waarde van eigenschap

Uint8Array

contentDisposition

Deze header retourneert de waarde die is opgegeven voor de header 'x-ms-blob-content-disposition'. Het veld Content-Disposition response header bevat aanvullende informatie over het verwerken van de nettolading van het antwoord en kan ook worden gebruikt om aanvullende metagegevens toe te voegen. Als dit bijvoorbeeld is ingesteld op bijlage, geeft dit aan dat de gebruikersagent het antwoord niet moet weergeven, maar in plaats daarvan een dialoogvenster Opslaan als moet weergeven met een andere bestandsnaam dan de opgegeven blobnaam.

contentDisposition?: string

Waarde van eigenschap

string

contentEncoding

Deze header retourneert de waarde die is opgegeven voor de aanvraagheader Content-Encoding

contentEncoding?: string

Waarde van eigenschap

string

contentLanguage

Deze header retourneert de waarde die is opgegeven voor de aanvraagheader Content-Language.

contentLanguage?: string

Waarde van eigenschap

string

contentLength

Het aantal bytes dat aanwezig is in de hoofdtekst van het antwoord.

contentLength?: number

Waarde van eigenschap

number

contentMD5

Als de blob een MD5-hash heeft en deze bewerking is bedoeld om de volledige blob te lezen, wordt deze antwoordheader geretourneerd, zodat de client kan controleren op integriteit van de berichtinhoud.

contentMD5?: Uint8Array

Waarde van eigenschap

Uint8Array

contentRange

Geeft het bereik van bytes aan dat wordt geretourneerd in het geval dat de client een subset van de blob heeft aangevraagd door de aanvraagheader Bereik in te stellen.

contentRange?: string

Waarde van eigenschap

string

contentType

Het mediatype van de hoofdtekst van het antwoord. Voor Blob downloaden is dit 'application/octet-stream'

contentType?: string

Waarde van eigenschap

string

copyCompletedOn

Conclusietijd van de laatste poging om blob te kopiëren 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 is geweest in een blob-bewerking kopiëren of als deze blob is gewijzigd na een voltooide blob-bewerking met blobeigenschappen instellen, Blob plaatsen of Lijst met blokken plaatsen.

copyCompletedOn?: Date

Waarde van eigenschap

Date

copyId

Tekenreeks-id voor deze kopieerbewerking. Gebruik met Blob-eigenschappen ophalen om de status van deze kopieerbewerking te controleren of geef door aan Blob afbreken om een in behandeling zijnde kopie af te breken.

copyId?: string

Waarde van eigenschap

string

copyProgress

Bevat het aantal bytes dat is gekopieerd en het totale aantal bytes in de bron in de laatste poging blob te kopiëren waarbij deze blob de doel-blob was. Kan tussen 0 en bytes met lengte van inhoud weergeven die zijn gekopieerd. Deze koptekst wordt niet weergegeven als deze blob nooit het doel is geweest in een blob kopiërenbewerking of als deze blob is gewijzigd na een voltooide blob-bewerking kopiëren met blobeigenschappen instellen, blob plaatsen of lijst met blokken plaatsen

copyProgress?: string

Waarde van eigenschap

string

copySource

URL met een lengte van maximaal 2 kB die de bron-blob of het bronbestand aangeeft dat is gebruikt in de laatste poging blob te kopiëren waarbij deze blob de doel-blob was. Deze koptekst wordt niet weergegeven als deze blob nooit het doel is geweest in een blob kopiërenbewerking of als deze blob is gewijzigd na een voltooide blob-bewerking kopiëren met blobeigenschappen instellen, Blob plaatsen of Lijst met blokken plaatsen.

copySource?: string

Waarde van eigenschap

string

copyStatus

Status van de kopieerbewerking geïdentificeerd door x-ms-copy-id.

copyStatus?: CopyStatusType

Waarde van eigenschap

copyStatusDescription

Wordt alleen weergegeven wanneer x-ms-copy-status mislukt of in behandeling is. Beschrijft de oorzaak van de laatste fatale of niet-fatale kopieerbewerkingsfout. Deze koptekst wordt niet weergegeven als deze blob nooit het doel is geweest in een blob kopiërenbewerking of als deze blob is gewijzigd na een voltooide blob-bewerking kopiëren met blobeigenschappen instellen, blob plaatsen of lijst met blokken plaatsen

copyStatusDescription?: string

Waarde van eigenschap

string

date

UTC-datum/tijd-waarde die is gegenereerd door de service die het tijdstip aangeeft waarop het antwoord is geïnitieerd

date?: Date

Waarde van eigenschap

Date

encryptionKeySha256

De SHA-256-hash van de versleutelingssleutel die wordt gebruikt om de blob te versleutelen. Deze header wordt alleen geretourneerd wanneer de blob is versleuteld met een door de klant opgegeven sleutel.

encryptionKeySha256?: string

Waarde van eigenschap

string

encryptionScope

Retourneert de naam van het versleutelingsbereik dat wordt gebruikt voor het versleutelen van de blobinhoud en de metagegevens van de toepassing. Houd er rekening mee dat het ontbreken van deze header impliceert dat het standaardbereik voor accountversleuteling wordt gebruikt.

encryptionScope?: string

Waarde van eigenschap

string

errorCode

Foutcode

errorCode?: string

Waarde van eigenschap

string

etag

De ETag bevat een waarde die u kunt gebruiken om bewerkingen voorwaardelijk uit te voeren. Als de aanvraagversie 2011-08-18 of nieuwer is, wordt de waarde ETag tussen aanhalingstekens weergegeven.

etag?: string

Waarde van eigenschap

string

immutabilityPolicyExpiresOn

Utc-datum/tijd-waarde die wordt gegenereerd door de service die de tijd aangeeft waarop het beleid voor onveranderbaarheid van de blob verloopt.

immutabilityPolicyExpiresOn?: Date

Waarde van eigenschap

Date

immutabilityPolicyMode

Hiermee wordt de beleidsmodus voor onveranderbaarheid aangegeven.

immutabilityPolicyMode?: BlobImmutabilityPolicyMode

Waarde van eigenschap

isCurrentVersion

De waarde van deze header geeft aan of de versie van deze blob een huidige versie is. Zie ook x-ms-version-id-header.

isCurrentVersion?: boolean

Waarde van eigenschap

boolean

isSealed

Als deze blob is verzegeld

isSealed?: boolean

Waarde van eigenschap

boolean

isServerEncrypted

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).

isServerEncrypted?: boolean

Waarde van eigenschap

boolean

lastAccessed

UTC-datum/tijd-waarde gegenereerd door de service die de tijd aangeeft waarop de blob voor het laatst is gelezen of geschreven naar

lastAccessed?: Date

Waarde van eigenschap

Date

lastModified

Retourneert de datum en tijd waarop de container voor het laatst is gewijzigd. Elke bewerking die de blob wijzigt, inclusief een update van de metagegevens of eigenschappen van de blob, wijzigt de tijd van de laatste wijziging van de blob.

lastModified?: Date

Waarde van eigenschap

Date

leaseDuration

Wanneer een blob wordt geleased, geeft u op of de lease een oneindige of vaste duur heeft.

leaseDuration?: LeaseDurationType

Waarde van eigenschap

leaseState

Leasestatus van de blob.

leaseState?: LeaseStateType

Waarde van eigenschap

leaseStatus

De huidige leasestatus van de blob.

leaseStatus?: LeaseStatusType

Waarde van eigenschap

legalHold

Hiermee wordt aangegeven of er een juridische bewaring aanwezig is op de blob.

legalHold?: boolean

Waarde van eigenschap

boolean

metadata

metadata?: [key: string]: string

Waarde van eigenschap

[key: string]: string

objectReplicationPolicyId

Optioneel. Alleen geldig wanneer objectreplicatie is ingeschakeld voor de opslagcontainer en op de doel-blob van de replicatie.

objectReplicationPolicyId?: string

Waarde van eigenschap

string

objectReplicationRules

Optioneel. Alleen geldig wanneer objectreplicatie is ingeschakeld voor de opslagcontainer en op de bron-blob van de replicatie. Bij het ophalen van deze header wordt de header geretourneerd met de beleids-id en regel-id (bijvoorbeeld x-ms-or-policyid_ruleid) en is de waarde de status van de replicatie (bijvoorbeeld voltooid, mislukt).

objectReplicationRules?: [key: string]: string

Waarde van eigenschap

[key: string]: string

requestId

Deze header identificeert op unieke wijze de aanvraag die is gedaan en kan worden gebruikt voor het oplossen van problemen met de aanvraag.

requestId?: string

Waarde van eigenschap

string

tagCount

Het aantal tags dat is gekoppeld aan de blob

tagCount?: number

Waarde van eigenschap

number

version

Geeft de versie aan van de Blob-service die wordt gebruikt om de aanvraag uit te voeren. Deze header wordt geretourneerd voor aanvragen die zijn gedaan in versie 2009-09-19 en hoger.

version?: string

Waarde van eigenschap

string

versionId

Een Datum/tijd-waarde die wordt geretourneerd door de service die de blob uniek identificeert. De waarde van deze header geeft de blobversie aan en kan worden gebruikt in volgende aanvragen voor toegang tot deze versie van de blob.

versionId?: string

Waarde van eigenschap

string