BlobGetPropertiesHeaders interface
Define cabeçalhos para Blob_getProperties operação.
Propriedades
accept |
Indica se o serviço oferece suporte a solicitações de conteúdo de blob parcial. |
access |
A camada de blob de páginas em uma conta de armazenamento premium ou camada de blob de blocos em contas LRS de armazenamento de blobs. Para obter uma lista de camadas de blob de páginas premium permitidas, 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. |
access |
A hora em que a camada foi alterada no objeto . Isso só será retornado se a camada no blob de blocos tiver sido definida. |
access |
Somente para blobs de páginas em uma conta de armazenamento Premium. Se a camada de acesso não estiver definida explicitamente no blob, a camada será inferida com base em seu comprimento de conteúdo e esse cabeçalho será retornado com valor verdadeiro. |
archive |
Para contas LRS de armazenamento de blobs, os valores válidos são reidratar-pending-to-hot/rehydrate-pending-to-cool. Se o blob estiver sendo reidratado e não estiver concluído, esse cabeçalho será retornado indicando que a reidratação está pendente e também informa a camada de destino. |
blob |
O número de blocos confirmados presentes no blob. Esse cabeçalho é retornado somente para blobs de acréscimo. |
blob |
O número de sequência atual de um blob de páginas. Esse cabeçalho não é retornado para blobs de blocos ou blobs de acréscimo |
blob |
O tipo do blob. |
cache |
Esse cabeçalho será retornado, caso tenha sido especificado antes para o blob. |
client |
Se um cabeçalho de ID de solicitação do cliente for enviado na solicitação, esse cabeçalho estará presente na resposta com o mesmo valor. |
content |
Esse cabeçalho retorna 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 conteúdo da resposta e também pode ser usado para anexar metadados adicionais. Por exemplo, se definido como anexo, indica que o agente do usuário não deve exibir a resposta, mas, em vez disso, mostra uma caixa de diálogo Salvar como com um nome de arquivo diferente do nome do blob especificado. |
content |
Esse cabeçalho retorna o valor especificado para o cabeçalho de solicitação Content-Encoding |
content |
Esse cabeçalho retorna o valor especificado para o cabeçalho de solicitação Content-Language. |
content |
O tamanho do blob em bytes. Para um blob de páginas, esse cabeçalho retorna o valor do cabeçalho x-ms-blob-content-length armazenado com o blob. |
contentMD5 | Se o blob tiver um hash MD5 e essa operação for para ler o blob completo, esse cabeçalho de resposta será retornado para que o cliente possa verificar a integridade do conteúdo da mensagem. |
content |
O tipo de conteúdo especificado para o blob. O tipo de conteúdo padrão é 'application/octet-stream' |
copy |
Hora de conclusão da última tentativa de operação copiar blob em que esse blob era o blob de destino. Esse valor pode especificar a hora de uma tentativa de cópia concluída, cancelada o com falha. Esse cabeçalho não será exibido se uma cópia estiver pendente, se esse blob nunca tiver sido o destino em uma operação Copiar Blob ou se esse blob tiver sido modificado após uma operação de Copiar Blob concluída usando Definir Propriedades do Blob, Colocar Blob ou Colocar Lista de Blocos. |
copy |
Identificador de cadeia de caracteres para essa operação de cópia. Use com Obter Propriedades de Blob para verificar o status desta operação de cópia ou passe para Anular Copiar Blob para anular uma cópia pendente. |
copy |
Contém o número de bytes copiados e o total de bytes na origem na última tentativa de operação copiar blob em que esse blob era o blob de destino. Pode mostrar entre 0 e bytes de comprimento de conteúdo copiados. Esse cabeçalho não será exibido se esse blob nunca tiver sido o destino em uma operação Copiar Blob ou se esse blob tiver sido modificado após uma operação de Copiar Blob concluída usando Definir Propriedades de Blob, Colocar Blob ou Colocar Lista de Blocos |
copy |
URL de até 2 KB de comprimento que especifica o blob ou arquivo de origem usado na última tentativa de operação copiar blob em que esse blob era o blob de destino. Esse cabeçalho não será exibido se esse blob nunca tiver sido o destino em uma operação Copiar Blob ou se esse blob tiver sido modificado após uma operação de Copiar Blob concluída usando Definir Propriedades de Blob, Colocar Blob ou Colocar Lista de Blocos. |
copy |
Estado da operação de cópia identificada por x-ms-copy-id. |
copy |
Só aparece quando x-ms-copy-status está com falha ou pendente. Descreve a causa da última falha fatal ou não fatal da operação de cópia. Esse cabeçalho não será exibido se esse blob nunca tiver sido o destino em uma operação Copiar Blob ou se esse blob tiver sido modificado após uma operação de Copiar Blob concluída usando Definir Propriedades de Blob, Colocar Blob ou Colocar Lista de Blocos |
created |
Retorna a data e a 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 |
destination |
Incluído se o blob for blob de cópia incremental ou 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 esse blob. |
encryption |
O hash SHA-256 da chave de criptografia usada para criptografar os metadados. Esse cabeçalho só é retornado quando os metadados foram criptografados com uma chave fornecida pelo cliente. |
encryption |
Retorna o nome do escopo de criptografia usado para criptografar o conteúdo do blob e os metadados do aplicativo. Observe que a ausência desse cabeçalho implica no uso do escopo de criptografia de conta padrão. |
error |
Código do Erro |
etag | A ETag contém um valor que você pode usar para executar operações de forma condicional. Se a versão da solicitação for a 2011-08-18 ou mais recente, o valor de ETag será exibido entre aspas. |
expires |
A hora em que esse blob expirará. |
immutability |
Valor de data/hora UTC gerado pelo serviço que indica a hora em que a política de imutabilidade do blob expirará. |
immutability |
Indica o modo de política de imutabilidade. |
is |
O valor desse cabeçalho indica se a versão desse blob é uma versão atual, consulte também x-ms-version-id header. |
is |
Incluído se o blob for um blob de cópia incremental. |
is |
Se esse blob tiver sido lacrado |
is |
O valor desse cabeçalho será definido como true se os dados de blob e os metadados do aplicativo forem completamente criptografados usando o algoritmo especificado. Caso contrário, o valor será definido como false (quando o blob for descriptografado ou se apenas partes dos metadados de blob/aplicativo forem criptografadas). |
last |
Valor de data/hora UTC gerado pelo serviço que indica a hora em que o blob foi lido ou gravado pela última vez |
last |
Retorna a data e a hora em que o blob foi modificado pela última vez. Qualquer operação que modificar o blob, incluindo uma atualização dos metadados ou das propriedades do blob, alterará a hora da última modificação do blob. |
lease |
Quando um blob é concedido, especifica se a concessão tem duração infinita ou fixa. |
lease |
Estado da concessão do blob. |
lease |
O status da concessão atual do blob. |
legal |
Indica se uma retenção legal está presente no blob. |
metadata | |
object |
Opcional. Válido somente quando a Replicação de Objeto está habilitada para o contêiner de armazenamento e no blob de destino da replicação. |
object |
Opcional. Válido somente quando a Replicação de Objeto está habilitada para o contêiner de armazenamento e no blob de origem da replicação. Ao recuperar esse cabeçalho, ele retornará o cabeçalho com a ID da política e a ID da regra (por exemplo, x-ms-or-policyid_ruleid) e o valor será o status da replicação (por exemplo, concluído, com falha). |
rehydrate |
Se um objeto estiver no estado pendente de reidração, esse cabeçalho será retornado com prioridade de reidratar. |
request |
Esse cabeçalho identifica a solicitação que foi feita de forma exclusiva e pode ser usado para solucionar problemas na solicitação. |
tag |
O número de marcas associadas ao blob |
version | Indica a versão do serviço Blob usado para executar a solicitação. Esse cabeçalho é retornado para solicitações feitas na versão 2009-09-19 e mais recentes. |
version |
Um valor DateTime retornado pelo serviço que identifica exclusivamente o blob. O valor desse cabeçalho indica a versão do blob e pode ser usado em solicitações subsequentes para acessar essa versão do blob. |
Detalhes da propriedade
acceptRanges
Indica se o serviço oferece suporte a solicitações de conteúdo de blob parcial.
acceptRanges?: string
Valor da propriedade
string
accessTier
A camada de blob de páginas em uma conta de armazenamento premium ou camada de blob de blocos em contas LRS de armazenamento de blobs. Para obter uma lista de camadas de blob de páginas premium permitidas, 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 da propriedade
string
accessTierChangedOn
A hora em que a camada foi alterada no objeto . Isso só será retornado se a camada no blob de blocos tiver sido definida.
accessTierChangedOn?: Date
Valor da propriedade
Date
accessTierInferred
Somente para blobs de páginas em uma conta de armazenamento Premium. Se a camada de acesso não estiver definida explicitamente no blob, a camada será inferida com base em seu comprimento de conteúdo e esse cabeçalho será retornado com valor verdadeiro.
accessTierInferred?: boolean
Valor da propriedade
boolean
archiveStatus
Para contas LRS de armazenamento de blobs, os valores válidos são reidratar-pending-to-hot/rehydrate-pending-to-cool. Se o blob estiver sendo reidratado e não estiver concluído, esse cabeçalho será retornado indicando que a reidratação está pendente e também informa a camada de destino.
archiveStatus?: string
Valor da propriedade
string
blobCommittedBlockCount
O número de blocos confirmados presentes no blob. Esse cabeçalho é retornado somente para blobs de acréscimo.
blobCommittedBlockCount?: number
Valor da propriedade
number
blobSequenceNumber
O número de sequência atual de um blob de páginas. Esse cabeçalho não é retornado para blobs de blocos ou blobs de acréscimo
blobSequenceNumber?: number
Valor da propriedade
number
blobType
cacheControl
Esse cabeçalho será retornado, caso tenha sido especificado antes para o blob.
cacheControl?: string
Valor da propriedade
string
clientRequestId
Se um cabeçalho de ID de solicitação do cliente for enviado na solicitação, esse cabeçalho estará presente na resposta com o mesmo valor.
clientRequestId?: string
Valor da propriedade
string
contentDisposition
Esse cabeçalho retorna 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 conteúdo da resposta e também pode ser usado para anexar metadados adicionais. Por exemplo, se definido como anexo, indica que o agente do usuário não deve exibir a resposta, mas, em vez disso, mostra uma caixa de diálogo Salvar como com um nome de arquivo diferente do nome do blob especificado.
contentDisposition?: string
Valor da propriedade
string
contentEncoding
Esse cabeçalho retorna o valor especificado para o cabeçalho de solicitação Content-Encoding
contentEncoding?: string
Valor da propriedade
string
contentLanguage
Esse cabeçalho retorna o valor especificado para o cabeçalho de solicitação Content-Language.
contentLanguage?: string
Valor da propriedade
string
contentLength
O tamanho do blob em bytes. Para um blob de páginas, esse cabeçalho retorna o valor do cabeçalho x-ms-blob-content-length armazenado com o blob.
contentLength?: number
Valor da propriedade
number
contentMD5
Se o blob tiver um hash MD5 e essa operação for para ler o blob completo, esse cabeçalho de resposta será retornado para que o cliente possa verificar a integridade do conteúdo da mensagem.
contentMD5?: Uint8Array
Valor da propriedade
Uint8Array
contentType
O tipo de conteúdo especificado para o blob. O tipo de conteúdo padrão é 'application/octet-stream'
contentType?: string
Valor da propriedade
string
copyCompletedOn
Hora de conclusão da última tentativa de operação copiar blob em que esse blob era o blob de destino. Esse valor pode especificar a hora de uma tentativa de cópia concluída, cancelada o com falha. Esse cabeçalho não será exibido se uma cópia estiver pendente, se esse blob nunca tiver sido o destino em uma operação Copiar Blob ou se esse blob tiver sido modificado após uma operação de Copiar Blob concluída usando Definir Propriedades do Blob, Colocar Blob ou Colocar Lista de Blocos.
copyCompletedOn?: Date
Valor da propriedade
Date
copyId
Identificador de cadeia de caracteres para essa operação de cópia. Use com Obter Propriedades de Blob para verificar o status desta operação de cópia ou passe para Anular Copiar Blob para anular uma cópia pendente.
copyId?: string
Valor da propriedade
string
copyProgress
Contém o número de bytes copiados e o total de bytes na origem na última tentativa de operação copiar blob em que esse blob era o blob de destino. Pode mostrar entre 0 e bytes de comprimento de conteúdo copiados. Esse cabeçalho não será exibido se esse blob nunca tiver sido o destino em uma operação Copiar Blob ou se esse blob tiver sido modificado após uma operação de Copiar Blob concluída usando Definir Propriedades de Blob, Colocar Blob ou Colocar Lista de Blocos
copyProgress?: string
Valor da propriedade
string
copySource
URL de até 2 KB de comprimento que especifica o blob ou arquivo de origem usado na última tentativa de operação copiar blob em que esse blob era o blob de destino. Esse cabeçalho não será exibido se esse blob nunca tiver sido o destino em uma operação Copiar Blob ou se esse blob tiver sido modificado após uma operação de Copiar Blob concluída usando Definir Propriedades de Blob, Colocar Blob ou Colocar Lista de Blocos.
copySource?: string
Valor da propriedade
string
copyStatus
Estado da operação de cópia identificada por x-ms-copy-id.
copyStatus?: CopyStatusType
Valor da propriedade
copyStatusDescription
Só aparece quando x-ms-copy-status está com falha ou pendente. Descreve a causa da última falha fatal ou não fatal da operação de cópia. Esse cabeçalho não será exibido se esse blob nunca tiver sido o destino em uma operação Copiar Blob ou se esse blob tiver sido modificado após uma operação de Copiar Blob concluída usando Definir Propriedades de Blob, Colocar Blob ou Colocar Lista de Blocos
copyStatusDescription?: string
Valor da propriedade
string
createdOn
Retorna a data e a hora em que o blob foi criado.
createdOn?: Date
Valor da 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 da propriedade
Date
destinationSnapshot
Incluído se o blob for blob de cópia incremental ou 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 esse blob.
destinationSnapshot?: string
Valor da propriedade
string
encryptionKeySha256
O hash SHA-256 da chave de criptografia usada para criptografar os metadados. Esse cabeçalho só é retornado quando os metadados foram criptografados com uma chave fornecida pelo cliente.
encryptionKeySha256?: string
Valor da propriedade
string
encryptionScope
Retorna o nome do escopo de criptografia usado para criptografar o conteúdo do blob e os metadados do aplicativo. Observe que a ausência desse cabeçalho implica no uso do escopo de criptografia de conta padrão.
encryptionScope?: string
Valor da propriedade
string
errorCode
Código do Erro
errorCode?: string
Valor da propriedade
string
etag
A ETag contém um valor que você pode usar para executar operações de forma condicional. Se a versão da solicitação for a 2011-08-18 ou mais recente, o valor de ETag será exibido entre aspas.
etag?: string
Valor da propriedade
string
expiresOn
A hora em que esse blob expirará.
expiresOn?: Date
Valor da 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 expirará.
immutabilityPolicyExpiresOn?: Date
Valor da propriedade
Date
immutabilityPolicyMode
Indica o modo de política de imutabilidade.
immutabilityPolicyMode?: BlobImmutabilityPolicyMode
Valor da propriedade
isCurrentVersion
O valor desse cabeçalho indica se a versão desse blob é uma versão atual, consulte também x-ms-version-id header.
isCurrentVersion?: boolean
Valor da propriedade
boolean
isIncrementalCopy
Incluído se o blob for um blob de cópia incremental.
isIncrementalCopy?: boolean
Valor da propriedade
boolean
isSealed
Se esse blob tiver sido lacrado
isSealed?: boolean
Valor da propriedade
boolean
isServerEncrypted
O valor desse cabeçalho será definido como true se os dados de blob e os metadados do aplicativo forem completamente criptografados usando o algoritmo especificado. Caso contrário, o valor será definido como false (quando o blob for descriptografado ou se apenas partes dos metadados de blob/aplicativo forem criptografadas).
isServerEncrypted?: boolean
Valor da propriedade
boolean
lastAccessed
Valor de data/hora UTC gerado pelo serviço que indica a hora em que o blob foi lido ou gravado pela última vez
lastAccessed?: Date
Valor da propriedade
Date
lastModified
Retorna a data e a hora em que o blob foi modificado pela última vez. Qualquer operação que modificar o blob, incluindo uma atualização dos metadados ou das propriedades do blob, alterará a hora da última modificação do blob.
lastModified?: Date
Valor da propriedade
Date
leaseDuration
Quando um blob é concedido, especifica se a concessão tem duração infinita ou fixa.
leaseDuration?: LeaseDurationType
Valor da propriedade
leaseState
leaseStatus
O status da concessão atual do blob.
leaseStatus?: LeaseStatusType
Valor da propriedade
legalHold
Indica se uma retenção legal está presente no blob.
legalHold?: boolean
Valor da propriedade
boolean
metadata
metadata?: {[propertyName: string]: string}
Valor da propriedade
{[propertyName: string]: string}
objectReplicationPolicyId
Opcional. Válido somente quando a Replicação de Objeto está habilitada para o contêiner de armazenamento e no blob de destino da replicação.
objectReplicationPolicyId?: string
Valor da propriedade
string
objectReplicationRules
Opcional. Válido somente quando a Replicação de Objeto está habilitada para o contêiner de armazenamento e no blob de origem da replicação. Ao recuperar esse cabeçalho, ele retornará o cabeçalho com a ID da política e a ID da regra (por exemplo, x-ms-or-policyid_ruleid) e o valor será o status da replicação (por exemplo, concluído, com falha).
objectReplicationRules?: {[propertyName: string]: string}
Valor da propriedade
{[propertyName: string]: string}
rehydratePriority
Se um objeto estiver no estado pendente de reidração, esse cabeçalho será retornado com prioridade de reidratar.
rehydratePriority?: RehydratePriority
Valor da propriedade
requestId
Esse cabeçalho identifica a solicitação que foi feita de forma exclusiva e pode ser usado para solucionar problemas na solicitação.
requestId?: string
Valor da propriedade
string
tagCount
O número de marcas associadas ao blob
tagCount?: number
Valor da propriedade
number
version
Indica a versão do serviço Blob usado para executar a solicitação. Esse cabeçalho é retornado para solicitações feitas na versão 2009-09-19 e mais recentes.
version?: string
Valor da propriedade
string
versionId
Um valor DateTime retornado pelo serviço que identifica exclusivamente o blob. O valor desse cabeçalho indica a versão do blob e pode ser usado em solicitações subsequentes para acessar essa versão do blob.
versionId?: string
Valor da propriedade
string