BlobGetPropertiesResponse interface

Pacote:

@azure/storage-blob

Contém dados de resposta para a <xref:BlobClient.getProperties> operação.

Extends

BlobGetPropertiesHeaders & Object

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 falha ou está 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 instantâneo de cópia incremental, se x-ms-copy-status for bem-sucedido. Tempo de 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	A 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 irá 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 do blob 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 estiverem 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 é concedido, 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 retenção legal no blob.
metadata
objectReplicationDestinationPolicyId	ID da Política de Replicação de Objetos do blob de destino.
objectReplicationPolicyId	Opcional. Apenas é 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. Apenas 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ída, com falha).
objectReplicationSourceProperties	ID da Política de Replicação de Objetos Analisados, ID(s) da Regra e estado do blob de origem.
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

BlobType

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

CopyStatusType

copyStatusDescription

Só é apresentado quando x-ms-copy-status falha ou está 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 instantâneo de cópia incremental, se x-ms-copy-status for bem-sucedido. Tempo de 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

A 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 irá 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

BlobImmutabilityPolicyMode

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 do blob 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 estiverem 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 é concedido, especifica se a concessão é de duração infinita ou fixa.

leaseDuration?: LeaseDurationType

Valor de Propriedade

LeaseDurationType

leaseState

Estado de concessão do blob.

leaseState?: LeaseStateType

Valor de Propriedade

LeaseStateType

leaseStatus

O estado atual da concessão do blob.

leaseStatus?: LeaseStatusType

Valor de Propriedade

LeaseStatusType

legalHold

Indica se existe uma retenção legal no blob.

legalHold?: boolean

Valor de Propriedade

boolean

metadata

metadata?: [key: string]: string

Valor de Propriedade

[key: string]: string

objectReplicationDestinationPolicyId

ID da Política de Replicação de Objetos do blob de destino.

objectReplicationDestinationPolicyId?: string

Valor de Propriedade

string

objectReplicationPolicyId

Opcional. Apenas é 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. Apenas 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ída, com falha).

objectReplicationRules?: [key: string]: string

Valor de Propriedade

[key: string]: string

objectReplicationSourceProperties

ID da Política de Replicação de Objetos Analisados, ID(s) da Regra e estado do blob de origem.

objectReplicationSourceProperties?: ObjectReplicationPolicy[]

Valor de Propriedade

ObjectReplicationPolicy[]

rehydratePriority

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

rehydratePriority?: RehydratePriority

Valor de Propriedade

RehydratePriority

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