Delen via


BlobQueryHeaders interface

Hiermee definieert u headers voor Blob_query 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 header wordt alleen geretourneerd voor toevoeg-blobs.

blobContentMD5

Als de blob een MD5-hash heeft en als 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 wordt berekend op het aangevraagde bereik

blobSequenceNumber

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

blobType

Het type van de 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 het x-ms-bereik-get-content-crc64 is ingesteld op true, retourneert de aanvraag een crc64 voor het bereik, zolang het bereik 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 kop 'x-ms-blob-content-disposition'. Het veld Content-Disposition-antwoordheader bevat aanvullende informatie over het verwerken van de nettolading van het antwoord en kan ook worden gebruikt om extra metagegevens toe te voegen. Als deze optie 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 bestaat uit het lezen van de volledige blob, wordt deze antwoordheader geretourneerd, zodat de client de integriteit van de berichtinhoud kan controleren.

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'

copyCompletionTime

Tijdstip 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 kopieer-blobbewerking of als deze blob is gewijzigd na een voltooide blob-bewerking met behulp van Blob-eigenschappen instellen, Put Blob of Lijst met putblokken.

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 om blob te kopiëren waarbij deze blob de doel-blob was. Kan bytes tussen 0 en inhoudslengte weergeven die zijn gekopieerd. Deze header wordt niet weergegeven als deze blob nooit het doel is geweest in een blobkopieerbewerking of als deze blob is gewijzigd na een voltooide blob-bewerking kopiëren met behulp van Blob-eigenschappen instellen, Blob plaatsen of Lijst met blokkeringen 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 om 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 behulp van Blob-eigenschappen instellen, Put Blob of Lijst met blokkeringen 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 header wordt niet weergegeven als deze blob nooit het doel is geweest in een blobkopieerbewerking of als deze blob is gewijzigd na een voltooide blob-bewerking kopiëren met behulp van Blob-eigenschappen instellen, Blob plaatsen of Lijst met blokkeringen plaatsen

date

UTC-datum/tijd-waarde gegenereerd door de service die de tijd aangeeft waarop het antwoord is gestart

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 de afwezigheid van deze header het gebruik van het standaardbereik voor accountversleuteling impliceert.

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.

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

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, verandert de laatste wijzigingstijd van de blob.

leaseDuration

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

leaseState

Leasestatus van de blob.

leaseStatus

De huidige leasestatus van de blob.

metadata
requestId

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

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.

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 header wordt alleen geretourneerd voor toevoeg-blobs.

blobCommittedBlockCount?: number

Waarde van eigenschap

number

blobContentMD5

Als de blob een MD5-hash heeft en als 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 wordt berekend op het aangevraagde bereik

blobContentMD5?: Uint8Array

Waarde van eigenschap

Uint8Array

blobSequenceNumber

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

blobSequenceNumber?: number

Waarde van eigenschap

number

blobType

Het type van de 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 het x-ms-bereik-get-content-crc64 is ingesteld op true, retourneert de aanvraag een crc64 voor het bereik, zolang het bereik 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 kop 'x-ms-blob-content-disposition'. Het veld Content-Disposition-antwoordheader bevat aanvullende informatie over het verwerken van de nettolading van het antwoord en kan ook worden gebruikt om extra metagegevens toe te voegen. Als deze optie 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 bestaat uit het lezen van de volledige blob, wordt deze antwoordheader geretourneerd, zodat de client de integriteit van de berichtinhoud kan controleren.

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

copyCompletionTime

Tijdstip 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 kopieer-blobbewerking of als deze blob is gewijzigd na een voltooide blob-bewerking met behulp van Blob-eigenschappen instellen, Put Blob of Lijst met putblokken.

copyCompletionTime?: 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 om blob te kopiëren waarbij deze blob de doel-blob was. Kan bytes tussen 0 en inhoudslengte weergeven die zijn gekopieerd. Deze header wordt niet weergegeven als deze blob nooit het doel is geweest in een blobkopieerbewerking of als deze blob is gewijzigd na een voltooide blob-bewerking kopiëren met behulp van Blob-eigenschappen instellen, Blob plaatsen of Lijst met blokkeringen 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 om 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 behulp van Blob-eigenschappen instellen, Put Blob of Lijst met blokkeringen 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 header wordt niet weergegeven als deze blob nooit het doel is geweest in een blobkopieerbewerking of als deze blob is gewijzigd na een voltooide blob-bewerking kopiëren met behulp van Blob-eigenschappen instellen, Blob plaatsen of Lijst met blokkeringen plaatsen

copyStatusDescription?: string

Waarde van eigenschap

string

date

UTC-datum/tijd-waarde gegenereerd door de service die de tijd aangeeft waarop het antwoord is gestart

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 de afwezigheid van deze header het gebruik van het standaardbereik voor accountversleuteling impliceert.

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

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

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, verandert de laatste wijzigingstijd van de blob.

lastModified?: Date

Waarde van eigenschap

Date

leaseDuration

Wanneer een blob wordt geleased, geeft u aan of de lease een oneindige of een 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

metadata

metadata?: [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

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