Partilhar via


BlobDownloadHeaders interface

Define cabeçalhos para Blob_download operação.

Propriedades

acceptRanges

Indica que o serviço suporta pedidos de conteúdo de blobs parciais.

blobCommittedBlockCount

O número de blocos consolidados presentes no blob. Este cabeçalho é devolvido apenas para blobs de acréscimo.

blobContentMD5

Se o blob tiver um hash MD5 e se o pedido contiver o cabeçalho de intervalo (Intervalo ou intervalo x-ms), este cabeçalho de resposta é devolvido com o valor MD5 de todo o blob. Este valor pode ou não ser igual ao valor devolvido no cabeçalho Content-MD5, com este último calculado a partir do intervalo pedido

blobSequenceNumber

O número de sequência atual de um blob de página. Este cabeçalho não é devolvido para blobs de blocos ou blobs de acréscimo

blobType

O tipo do blob.

cacheControl

Este cabeçalho é devolvido se tiver sido especificado anteriormente para o blob.

clientRequestId

Se for enviado um cabeçalho de ID de pedido de cliente no pedido, este cabeçalho estará presente na resposta com o mesmo valor.

contentCrc64

Se o pedido for ler um intervalo especificado e o x-ms-range-get-content-crc64 estiver definido como verdadeiro, o pedido devolve um crc64 para o intervalo, desde que o tamanho do intervalo seja menor ou igual a 4 MB. Se ambos x-ms-range-get-content-crc64 & x-ms-range-get-content-md5 forem especificados no mesmo pedido, falhará com 400 (Pedido Incorreto).

contentDisposition

Este cabeçalho devolve o valor especificado para o cabeçalho "x-ms-blob-content-disposition". O campo cabeçalho de resposta Content-Disposition transmite informações adicionais sobre como processar o payload de resposta e também pode ser utilizado para anexar metadados adicionais. Por exemplo, se estiver definido como anexo, indica que o utilizador-agente não deve apresentar a resposta, mas sim mostrar uma caixa de diálogo Guardar Como com um nome de ficheiro diferente do nome do blob especificado.

contentEncoding

Este cabeçalho devolve o valor especificado para o cabeçalho do pedido Codificação de Conteúdo

contentLanguage

Este cabeçalho devolve o valor especificado para o cabeçalho do pedido Idioma de Conteúdo.

contentLength

O número de bytes presentes no corpo da resposta.

contentMD5

Se o blob tiver um hash MD5 e esta operação for ler o blob completo, este cabeçalho de resposta é devolvido para que o cliente possa verificar a integridade do conteúdo da mensagem.

contentRange

Indica o intervalo de bytes devolvido no caso de o cliente ter pedido um subconjunto do blob ao definir o cabeçalho do pedido "Intervalo".

contentType

O tipo de suporte de dados do corpo da resposta. Para Transferir Blob, trata-se de "application/octet-stream"

copyCompletedOn

Hora de conclusão da última operação de Copiar Blob em que este blob foi o blob de destino. Este valor pode especificar a hora de uma tentativa de cópia concluída, abortada ou falhada. Este cabeçalho não é apresentado se uma cópia estiver pendente, se este blob nunca tiver sido o destino numa operação Copiar Blob ou se este blob tiver sido modificado após uma operação de Copiar Blob concluída com Definir Propriedades do Blob, Colocar Blob ou Colocar Lista de Blocos.

copyId

Identificador de cadeia para esta operação de cópia. Utilize com Obter Propriedades do Blob para verificar o estado desta operação de cópia ou passe para Abortar o Blob de Cópia para abortar uma cópia pendente.

copyProgress

Contém o número de bytes copiados e o total de bytes na origem na última operação de Copiar Blob em que este blob era o blob de destino. Pode mostrar entre 0 e bytes de Comprimento do Conteúdo copiados. Este cabeçalho não é apresentado se este blob nunca tiver sido o destino numa operação Copiar Blob ou se este blob tiver sido modificado após uma operação de Copiar Blob concluída com Definir Propriedades do Blob, Colocar Blob ou Colocar Lista de Blocos

copySource

URL com até 2 KB de comprimento que especifica o blob de origem ou o ficheiro utilizado na última operação de Copiar Blob em que este blob era o blob de destino. Este cabeçalho não é apresentado se este blob nunca tiver sido o destino numa operação Copiar Blob ou se este blob tiver sido modificado após uma operação de Copiar Blob concluída com Definir Propriedades do Blob, Colocar Blob ou Colocar Lista de Blocos.

copyStatus

Estado da operação de cópia identificada por x-ms-copy-id.

copyStatusDescription

Só é apresentado quando x-ms-copy-status está com falhas ou pendente. Descreve a causa da última falha fatal ou não fatal da operação de cópia. Este cabeçalho não é apresentado se este blob nunca tiver sido o destino numa operação Copiar Blob ou se este blob tiver sido modificado após uma operação de Copiar Blob concluída com Definir Propriedades do Blob, Colocar Blob ou Colocar Lista de Blocos

createdOn

Devolve a data e hora em que o blob foi criado.

date

Valor de data/hora UTC gerado pelo serviço que indica a hora em que a resposta foi iniciada

encryptionKeySha256

O hash SHA-256 da chave de encriptação utilizada para encriptar o blob. Este cabeçalho só é devolvido quando o blob foi encriptado com uma chave fornecida pelo cliente.

encryptionScope

Devolve o nome do âmbito de encriptação utilizado para encriptar o conteúdo do blob e os metadados da aplicação. Tenha em atenção que a ausência deste cabeçalho implica a utilização do âmbito de encriptação de conta predefinido.

errorCode

Código de Erro

etag

O ETag contém um valor que pode utilizar para realizar operações condicionalmente. Se a versão do pedido for 2011-08-18 ou mais recente, o valor ETag estará entre aspas.

immutabilityPolicyExpiresOn

Valor de data/hora UTC gerado pelo serviço que indica a hora em que a política de imutabilidade do blob irá expirar.

immutabilityPolicyMode

Indica o modo de política de imutabilidade.

isCurrentVersion

O valor deste cabeçalho indica se a versão deste blob é uma versão atual. Consulte também o cabeçalho x-ms-version-id.

isSealed

Se este blob tiver sido selado

isServerEncrypted

O valor deste cabeçalho é definido como verdadeiro se os dados de blobs e os metadados da aplicação estiverem completamente encriptados com o algoritmo especificado. Caso contrário, o valor é definido como falso (quando o blob não está encriptado ou se apenas partes dos metadados de blob/aplicação forem encriptadas).

lastAccessed

Valor de data/hora UTC gerado pelo serviço que indica a hora em que o blob foi lido ou escrito pela última vez

lastModified

Devolve a data e hora em que o contentor foi modificado pela última vez. Qualquer operação que modifique o blob, incluindo uma atualização dos metadados ou propriedades do blob, altera a hora da última modificação do blob.

leaseDuration

Quando um blob é arrendado, especifica se a concessão é de duração infinita ou fixa.

leaseState

Estado de concessão do blob.

leaseStatus

O estado atual da concessão do blob.

legalHold

Indica se existe uma suspensão legal no blob.

metadata
objectReplicationPolicyId

Opcional. Só é válido quando a Replicação de Objetos está ativada para o contentor de armazenamento e no blob de destino da replicação.

objectReplicationRules

Opcional. Só é válido quando a Replicação de Objetos está ativada para o contentor de armazenamento e no blob de origem da replicação. Ao obter este cabeçalho, devolverá o cabeçalho com o ID da política e o ID da regra (por exemplo, x-ms-or-policyid_ruleid) e o valor será o estado da replicação (por exemplo, concluído, com falha).

requestId

Este cabeçalho identifica exclusivamente o pedido que foi feito e pode ser utilizado para resolver o pedido.

tagCount

O número de etiquetas associadas ao blob

version

Indica a versão do serviço Blob utilizada para executar o pedido. Este cabeçalho é devolvido para pedidos feitos na versão 2009-09-19 e superior.

versionId

Um valor DateTime devolvido pelo serviço que identifica exclusivamente o blob. O valor deste cabeçalho indica a versão do blob e pode ser utilizado em pedidos subsequentes para aceder a esta versão do blob.

Detalhes de Propriedade

acceptRanges

Indica que o serviço suporta pedidos de conteúdo de blobs parciais.

acceptRanges?: string

Valor de Propriedade

string

blobCommittedBlockCount

O número de blocos consolidados presentes no blob. Este cabeçalho é devolvido apenas para blobs de acréscimo.

blobCommittedBlockCount?: number

Valor de Propriedade

number

blobContentMD5

Se o blob tiver um hash MD5 e se o pedido contiver o cabeçalho de intervalo (Intervalo ou intervalo x-ms), este cabeçalho de resposta é devolvido com o valor MD5 de todo o blob. Este valor pode ou não ser igual ao valor devolvido no cabeçalho Content-MD5, com este último calculado a partir do intervalo pedido

blobContentMD5?: Uint8Array

Valor de Propriedade

Uint8Array

blobSequenceNumber

O número de sequência atual de um blob de página. Este cabeçalho não é devolvido para blobs de blocos ou blobs de acréscimo

blobSequenceNumber?: number

Valor de Propriedade

number

blobType

O tipo do blob.

blobType?: BlobType

Valor de Propriedade

cacheControl

Este cabeçalho é devolvido se tiver sido especificado anteriormente para o blob.

cacheControl?: string

Valor de Propriedade

string

clientRequestId

Se for enviado um cabeçalho de ID de pedido de cliente no pedido, este cabeçalho estará presente na resposta com o mesmo valor.

clientRequestId?: string

Valor de Propriedade

string

contentCrc64

Se o pedido for ler um intervalo especificado e o x-ms-range-get-content-crc64 estiver definido como verdadeiro, o pedido devolve um crc64 para o intervalo, desde que o tamanho do intervalo seja menor ou igual a 4 MB. Se ambos x-ms-range-get-content-crc64 & x-ms-range-get-content-md5 forem especificados no mesmo pedido, falhará com 400 (Pedido Incorreto).

contentCrc64?: Uint8Array

Valor de Propriedade

Uint8Array

contentDisposition

Este cabeçalho devolve o valor especificado para o cabeçalho "x-ms-blob-content-disposition". O campo cabeçalho de resposta Content-Disposition transmite informações adicionais sobre como processar o payload de resposta e também pode ser utilizado para anexar metadados adicionais. Por exemplo, se estiver definido como anexo, indica que o utilizador-agente não deve apresentar a resposta, mas sim mostrar uma caixa de diálogo Guardar Como com um nome de ficheiro diferente do nome do blob especificado.

contentDisposition?: string

Valor de Propriedade

string

contentEncoding

Este cabeçalho devolve o valor especificado para o cabeçalho do pedido Codificação de Conteúdo

contentEncoding?: string

Valor de Propriedade

string

contentLanguage

Este cabeçalho devolve o valor especificado para o cabeçalho do pedido Idioma de Conteúdo.

contentLanguage?: string

Valor de Propriedade

string

contentLength

O número de bytes presentes no corpo da resposta.

contentLength?: number

Valor de Propriedade

number

contentMD5

Se o blob tiver um hash MD5 e esta operação for ler o blob completo, este cabeçalho de resposta é devolvido para que o cliente possa verificar a integridade do conteúdo da mensagem.

contentMD5?: Uint8Array

Valor de Propriedade

Uint8Array

contentRange

Indica o intervalo de bytes devolvido no caso de o cliente ter pedido um subconjunto do blob ao definir o cabeçalho do pedido "Intervalo".

contentRange?: string

Valor de Propriedade

string

contentType

O tipo de suporte de dados do corpo da resposta. Para Transferir Blob, trata-se de "application/octet-stream"

contentType?: string

Valor de Propriedade

string

copyCompletedOn

Hora de conclusão da última operação de Copiar Blob em que este blob foi o blob de destino. Este valor pode especificar a hora de uma tentativa de cópia concluída, abortada ou falhada. Este cabeçalho não é apresentado se uma cópia estiver pendente, se este blob nunca tiver sido o destino numa operação Copiar Blob ou se este blob tiver sido modificado após uma operação de Copiar Blob concluída com Definir Propriedades do Blob, Colocar Blob ou Colocar Lista de Blocos.

copyCompletedOn?: Date

Valor de Propriedade

Date

copyId

Identificador de cadeia para esta operação de cópia. Utilize com Obter Propriedades do Blob para verificar o estado desta operação de cópia ou passe para Abortar o Blob de Cópia para abortar uma cópia pendente.

copyId?: string

Valor de Propriedade

string

copyProgress

Contém o número de bytes copiados e o total de bytes na origem na última operação de Copiar Blob em que este blob era o blob de destino. Pode mostrar entre 0 e bytes de Comprimento do Conteúdo copiados. Este cabeçalho não é apresentado se este blob nunca tiver sido o destino numa operação Copiar Blob ou se este blob tiver sido modificado após uma operação de Copiar Blob concluída com Definir Propriedades do Blob, Colocar Blob ou Colocar Lista de Blocos

copyProgress?: string

Valor de Propriedade

string

copySource

URL com até 2 KB de comprimento que especifica o blob de origem ou o ficheiro utilizado na última operação de Copiar Blob em que este blob era o blob de destino. Este cabeçalho não é apresentado se este blob nunca tiver sido o destino numa operação Copiar Blob ou se este blob tiver sido modificado após uma operação de Copiar Blob concluída com Definir Propriedades do Blob, Colocar Blob ou Colocar Lista de Blocos.

copySource?: string

Valor de Propriedade

string

copyStatus

Estado da operação de cópia identificada por x-ms-copy-id.

copyStatus?: CopyStatusType

Valor de Propriedade

copyStatusDescription

Só é apresentado quando x-ms-copy-status está com falhas ou pendente. Descreve a causa da última falha fatal ou não fatal da operação de cópia. Este cabeçalho não é apresentado se este blob nunca tiver sido o destino numa operação Copiar Blob ou se este blob tiver sido modificado após uma operação de Copiar Blob concluída com Definir Propriedades do Blob, Colocar Blob ou Colocar Lista de Blocos

copyStatusDescription?: string

Valor de Propriedade

string

createdOn

Devolve a data e hora em que o blob foi criado.

createdOn?: Date

Valor de Propriedade

Date

date

Valor de data/hora UTC gerado pelo serviço que indica a hora em que a resposta foi iniciada

date?: Date

Valor de Propriedade

Date

encryptionKeySha256

O hash SHA-256 da chave de encriptação utilizada para encriptar o blob. Este cabeçalho só é devolvido quando o blob foi encriptado com uma chave fornecida pelo cliente.

encryptionKeySha256?: string

Valor de Propriedade

string

encryptionScope

Devolve o nome do âmbito de encriptação utilizado para encriptar o conteúdo do blob e os metadados da aplicação. Tenha em atenção que a ausência deste cabeçalho implica a utilização do âmbito de encriptação de conta predefinido.

encryptionScope?: string

Valor de Propriedade

string

errorCode

Código de Erro

errorCode?: string

Valor de Propriedade

string

etag

O ETag contém um valor que pode utilizar para realizar operações condicionalmente. Se a versão do pedido for 2011-08-18 ou mais recente, o valor ETag estará entre aspas.

etag?: string

Valor de Propriedade

string

immutabilityPolicyExpiresOn

Valor de data/hora UTC gerado pelo serviço que indica a hora em que a política de imutabilidade do blob irá expirar.

immutabilityPolicyExpiresOn?: Date

Valor de Propriedade

Date

immutabilityPolicyMode

Indica o modo de política de imutabilidade.

immutabilityPolicyMode?: BlobImmutabilityPolicyMode

Valor de Propriedade

isCurrentVersion

O valor deste cabeçalho indica se a versão deste blob é uma versão atual. Consulte também o cabeçalho x-ms-version-id.

isCurrentVersion?: boolean

Valor de Propriedade

boolean

isSealed

Se este blob tiver sido selado

isSealed?: boolean

Valor de Propriedade

boolean

isServerEncrypted

O valor deste cabeçalho é definido como verdadeiro se os dados de blobs e os metadados da aplicação estiverem completamente encriptados com o algoritmo especificado. Caso contrário, o valor é definido como falso (quando o blob não está encriptado ou se apenas partes dos metadados de blob/aplicação forem encriptadas).

isServerEncrypted?: boolean

Valor de Propriedade

boolean

lastAccessed

Valor de data/hora UTC gerado pelo serviço que indica a hora em que o blob foi lido ou escrito pela última vez

lastAccessed?: Date

Valor de Propriedade

Date

lastModified

Devolve a data e hora em que o contentor foi modificado pela última vez. Qualquer operação que modifique o blob, incluindo uma atualização dos metadados ou propriedades do blob, altera a hora da última modificação do blob.

lastModified?: Date

Valor de Propriedade

Date

leaseDuration

Quando um blob é arrendado, especifica se a concessão é de duração infinita ou fixa.

leaseDuration?: LeaseDurationType

Valor de Propriedade

leaseState

Estado de concessão do blob.

leaseState?: LeaseStateType

Valor de Propriedade

leaseStatus

O estado atual da concessão do blob.

leaseStatus?: LeaseStatusType

Valor de Propriedade

legalHold

Indica se existe uma suspensão legal no blob.

legalHold?: boolean

Valor de Propriedade

boolean

metadata

metadata?: {[propertyName: string]: string}

Valor de Propriedade

{[propertyName: string]: string}

objectReplicationPolicyId

Opcional. Só é válido quando a Replicação de Objetos está ativada para o contentor de armazenamento e no blob de destino da replicação.

objectReplicationPolicyId?: string

Valor de Propriedade

string

objectReplicationRules

Opcional. Só é válido quando a Replicação de Objetos está ativada para o contentor de armazenamento e no blob de origem da replicação. Ao obter este cabeçalho, devolverá o cabeçalho com o ID da política e o ID da regra (por exemplo, x-ms-or-policyid_ruleid) e o valor será o estado da replicação (por exemplo, concluído, com falha).

objectReplicationRules?: {[propertyName: string]: string}

Valor de Propriedade

{[propertyName: string]: string}

requestId

Este cabeçalho identifica exclusivamente o pedido que foi feito e pode ser utilizado para resolver o pedido.

requestId?: string

Valor de Propriedade

string

tagCount

O número de etiquetas associadas ao blob

tagCount?: number

Valor de Propriedade

number

version

Indica a versão do serviço Blob utilizada para executar o pedido. Este cabeçalho é devolvido para pedidos feitos na versão 2009-09-19 e superior.

version?: string

Valor de Propriedade

string

versionId

Um valor DateTime devolvido pelo serviço que identifica exclusivamente o blob. O valor deste cabeçalho indica a versão do blob e pode ser utilizado em pedidos subsequentes para aceder a esta versão do blob.

versionId?: string

Valor de Propriedade

string