BlobGetPropertiesHeaders interface

Define cabeçalhos para Blob_getProperties operação.

Propriedades

acceptRanges

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

accessTier

A camada de blob de páginas numa conta de armazenamento premium ou numa camada de blob de blocos em contas LRS de armazenamento de blobs. Para obter uma lista dos escalões de blobs de página premium permitidos, consulte https://docs.microsoft.com/en-us/azure/virtual-machines/windows/premium-storage#features. Para contas LRS de armazenamento de blobs, os valores válidos são Hot/Cool/Archive.

accessTierChangedOn

A hora em que a camada foi alterada no objeto. Esta opção só é devolvida se a camada do blob de blocos tiver sido definida.

accessTierInferred

Apenas para blobs de páginas numa conta de armazenamento premium. Se a camada de acesso não estiver explicitamente definida no blob, a camada é inferida com base no respetivo comprimento de conteúdo e este cabeçalho será devolvido com valor verdadeiro.

archiveStatus

Para contas LRS de armazenamento de blobs, os valores válidos são reidratar pendentes para frequentes/reidratar pendentes para esporádico. Se o blob estiver a ser reidratado e não estiver concluído, este cabeçalho é devolvido indicando que a reidrata está pendente e também indica a camada de destino.

blobCommittedBlockCount

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

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.

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 tamanho do blob em bytes. Para um blob de página, este cabeçalho devolve o valor do cabeçalho x-ms-blob-content-length armazenado com o blob.

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.

contentType

O tipo de conteúdo especificado para o blob. O tipo de conteúdo predefinido é "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

destinationSnapshot

Incluído se o blob for um blob de cópia incremental ou um instantâneo de cópia incremental, se x-ms-copy-status for bem-sucedido. Hora do instantâneo do último instantâneo de cópia incremental bem-sucedido para este blob.

encryptionKeySha256

O hash SHA-256 da chave de encriptação utilizada para encriptar os metadados. Este cabeçalho só é devolvido quando os metadados foram encriptados 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.

expiresOn

A hora em que este blob expirará.

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.

isIncrementalCopy

Incluído se o blob for um blob de cópia incremental.

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

rehydratePriority

Se um objeto estiver no estado de reidratar pendente, este cabeçalho é devolvido com prioridade de reidratar.

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

accessTier

A camada de blob de páginas numa conta de armazenamento premium ou numa camada de blob de blocos em contas LRS de armazenamento de blobs. Para obter uma lista dos escalões de blobs de página premium permitidos, consulte https://docs.microsoft.com/en-us/azure/virtual-machines/windows/premium-storage#features. Para contas LRS de armazenamento de blobs, os valores válidos são Hot/Cool/Archive.

accessTier?: string

Valor de Propriedade

string

accessTierChangedOn

A hora em que a camada foi alterada no objeto. Esta opção só é devolvida se a camada do blob de blocos tiver sido definida.

accessTierChangedOn?: Date

Valor de Propriedade

Date

accessTierInferred

Apenas para blobs de páginas numa conta de armazenamento premium. Se a camada de acesso não estiver explicitamente definida no blob, a camada é inferida com base no respetivo comprimento de conteúdo e este cabeçalho será devolvido com valor verdadeiro.

accessTierInferred?: boolean

Valor de Propriedade

boolean

archiveStatus

Para contas LRS de armazenamento de blobs, os valores válidos são reidratar pendentes para frequentes/reidratar pendentes para esporádico. Se o blob estiver a ser reidratado e não estiver concluído, este cabeçalho é devolvido indicando que a reidrata está pendente e também indica a camada de destino.

archiveStatus?: 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

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

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 tamanho do blob em bytes. Para um blob de página, este cabeçalho devolve o valor do cabeçalho x-ms-blob-content-length armazenado com o blob.

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

contentType

O tipo de conteúdo especificado para o blob. O tipo de conteúdo predefinido é "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

destinationSnapshot

Incluído se o blob for um blob de cópia incremental ou um instantâneo de cópia incremental, se x-ms-copy-status for bem-sucedido. Hora do instantâneo do último instantâneo de cópia incremental bem-sucedido para este blob.

destinationSnapshot?: string

Valor de Propriedade

string

encryptionKeySha256

O hash SHA-256 da chave de encriptação utilizada para encriptar os metadados. Este cabeçalho só é devolvido quando os metadados foram encriptados 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

expiresOn

A hora em que este blob expirará.

expiresOn?: Date

Valor de Propriedade

Date

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

isIncrementalCopy

Incluído se o blob for um blob de cópia incremental.

isIncrementalCopy?: 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 blob 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}

rehydratePriority

Se um objeto estiver no estado de reidratar pendente, este cabeçalho é devolvido com prioridade de reidratar.

rehydratePriority?: RehydratePriority

Valor de Propriedade

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