BlobGetPropertiesHeaders interface
Define cabeçalhos para Blob_getProperties operação.
Propriedades
| accept |
Indica que o serviço oferece suporte a solicitações de conteúdo de blob parcial. |
| access |
A camada de blob de página em uma conta de armazenamento premium ou a camada de blob de bloco em contas LRS de armazenamento de blob. Para obter uma lista de camadas de blob de página premium permitidas, consulte https://learn.microsoft.com/azure/virtual-machines/disks-types#premium-ssd. Para contas LRS de armazenamento de blob, 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 bloco tiver sido definida. |
| access |
Apenas para blobs de página 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 blob, os valores válidos são rehydrate-pending-to-hot/rehydrate-pending-to-cool. Se o blob estiver sendo reidratado e não estiver completo, esse cabeçalho será retornado indicando que o reidratamento está pendente e também informará 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 para um blob de página. Este cabeçalho não é retornado para blobs de bloco ou blobs de acréscimo |
| blob |
O tipo do blob. |
| cache |
Esse cabeçalho será retornado se tiver sido especificado anteriormente 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 de cabeçalho de resposta Content-Disposition transmite informações adicionais sobre como processar a carga útil de 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 mostrar uma caixa de diálogo Salvar como com um nome de arquivo diferente do nome de blob especificado. |
| content |
Esse cabeçalho retorna o valor especificado para o cabeçalho da solicitação Content-Encoding |
| content |
Esse cabeçalho retorna o valor especificado para o cabeçalho da solicitação Content-Language. |
| content |
O tamanho do blob em bytes. Para um blob de página, 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 de Blob de cópia em que esse blob era o blob de destino. Esse valor pode especificar a hora de uma tentativa de cópia concluída, abortada ou com falha. Esse cabeçalho não aparecerá se uma cópia estiver pendente, se esse blob nunca tiver sido o destino em uma operação de Blob de Cópia ou se esse blob tiver sido modificado após uma operação de Blob de Cópia concluída usando Definir Propriedades de Blob, Colocar Blob ou Colocar Lista de Bloqueios. |
| copy |
Identificador de cadeia de caracteres para esta operação de cópia. Use com Obter Propriedades de Blob para verificar o status dessa operação de cópia ou passe para Abortar Blob de Cópia para abortar 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 de Blob de Cópia 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 aparecerá se esse blob nunca tiver sido o destino em uma operação de Blob de Cópia ou se esse blob tiver sido modificado após uma operação de Blob de Cópia concluída usando Definir Propriedades de Blob, Colocar Blob ou Colocar Lista de Bloqueios |
| copy |
URL de até 2 KB de comprimento que especifica o blob ou arquivo de origem usado na última tentativa de operação de Blob de Cópia em que esse blob era o blob de destino. Esse cabeçalho não aparecerá se esse blob nunca tiver sido o destino em uma operação de Blob de Cópia ou se esse blob tiver sido modificado após uma operação de Blob de Cópia concluída usando Definir Propriedades de Blob, Colocar Blob ou Colocar Lista de Bloqueios. |
| 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 da operação de cópia fatal ou não fatal. Esse cabeçalho não aparecerá se esse blob nunca tiver sido o destino em uma operação de Blob de Cópia ou se esse blob tiver sido modificado após uma operação de Blob de Cópia concluída usando Definir Propriedades de Blob, Colocar Blob ou Colocar Lista de Bloqueios |
| 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. Tempo de instantâneo do último instantâneo de cópia incremental bem-sucedido para este 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 o uso do escopo de criptografia de conta padrão. |
| error |
Código de erro |
| etag | O ETag contém um valor que você pode usar para executar operações condicionalmente. Se a versão do pedido for 2011-08-18 ou mais recente, o valor ETag estará entre aspas. |
| expires |
O tempo que este blob irá expirar. |
| immutability |
Valor de data/hora UTC gerado pelo serviço que indica a hora em que a política de imutabilidade de blob expirará. |
| immutability |
Indica o modo de política de imutabilidade. |
| is |
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. |
| is |
Incluído se o blob for blob de cópia incremental. |
| is |
Se este blob tiver sido selado |
| 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 não estiver criptografado ou se apenas partes dos metadados 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 modifique o blob, incluindo uma atualização dos metadados ou propriedades do blob, altera a hora da última modificação do blob. |
| lease |
Quando um blob é alugado, especifica se a concessão é de duração infinita ou fixa. |
| lease |
Estado de concessão do blob. |
| lease |
O status de 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 Objetos estiver 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 Objetos estiver 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ída, falha). |
| rehydrate |
Se um objeto estiver no estado pendente de reidratação, esse cabeçalho será retornado com prioridade de reidratar. |
| request |
Esse cabeçalho identifica exclusivamente a solicitação que foi feita e pode ser usado para solucionar a solicitação. |
| tag |
O número de tags associadas ao blob |
| version | Indica a versão do serviço de Blob usada para executar a solicitação. Este cabeçalho é retornado para solicitações feitas contra a versão 2009-09-19 e superior. |
| 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 de Propriedade
acceptRanges
Indica que o serviço oferece suporte a solicitações de conteúdo de blob parcial.
acceptRanges?: string
Valor de Propriedade
string
accessTier
A camada de blob de página em uma conta de armazenamento premium ou a camada de blob de bloco em contas LRS de armazenamento de blob. Para obter uma lista de camadas de blob de página premium permitidas, consulte https://learn.microsoft.com/azure/virtual-machines/disks-types#premium-ssd. Para contas LRS de armazenamento de blob, 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. Isso só será retornado se a camada no blob de bloco tiver sido definida.
accessTierChangedOn?: Date
Valor de Propriedade
Date
accessTierInferred
Apenas para blobs de página 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 de Propriedade
boolean
archiveStatus
Para contas LRS de armazenamento de blob, os valores válidos são rehydrate-pending-to-hot/rehydrate-pending-to-cool. Se o blob estiver sendo reidratado e não estiver completo, esse cabeçalho será retornado indicando que o reidratamento está pendente e também informará a camada de destino.
archiveStatus?: string
Valor de 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 de Propriedade
number
blobSequenceNumber
O número de sequência atual para um blob de página. Este cabeçalho não é retornado para blobs de bloco ou blobs de acréscimo
blobSequenceNumber?: number
Valor de Propriedade
number
blobType
cacheControl
Esse cabeçalho será retornado se tiver sido especificado anteriormente para o blob.
cacheControl?: string
Valor de 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 de Propriedade
string
contentDisposition
Esse cabeçalho retorna o valor especificado para o cabeçalho 'x-ms-blob-content-disposition'. O campo de cabeçalho de resposta Content-Disposition transmite informações adicionais sobre como processar a carga útil de 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 mostrar uma caixa de diálogo Salvar como com um nome de arquivo diferente do nome de blob especificado.
contentDisposition?: string
Valor de Propriedade
string
contentEncoding
Esse cabeçalho retorna o valor especificado para o cabeçalho da solicitação Content-Encoding
contentEncoding?: string
Valor de Propriedade
string
contentLanguage
Esse cabeçalho retorna o valor especificado para o cabeçalho da solicitação Content-Language.
contentLanguage?: string
Valor de Propriedade
string
contentLength
O tamanho do blob em bytes. Para um blob de página, esse cabeçalho retorna 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 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 de 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 de Propriedade
string
copyCompletedOn
Hora de conclusão da última tentativa de operação de Blob de cópia em que esse blob era o blob de destino. Esse valor pode especificar a hora de uma tentativa de cópia concluída, abortada ou com falha. Esse cabeçalho não aparecerá se uma cópia estiver pendente, se esse blob nunca tiver sido o destino em uma operação de Blob de Cópia ou se esse blob tiver sido modificado após uma operação de Blob de Cópia concluída usando Definir Propriedades de Blob, Colocar Blob ou Colocar Lista de Bloqueios.
copyCompletedOn?: Date
Valor de Propriedade
Date
copyId
Identificador de cadeia de caracteres para esta operação de cópia. Use com Obter Propriedades de Blob para verificar o status dessa operação de cópia ou passe para Abortar 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 tentativa de operação de Blob de Cópia 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 aparecerá se esse blob nunca tiver sido o destino em uma operação de Blob de Cópia ou se esse blob tiver sido modificado após uma operação de Blob de Cópia concluída usando Definir Propriedades de Blob, Colocar Blob ou Colocar Lista de Bloqueios
copyProgress?: string
Valor de 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 de Blob de Cópia em que esse blob era o blob de destino. Esse cabeçalho não aparecerá se esse blob nunca tiver sido o destino em uma operação de Blob de Cópia ou se esse blob tiver sido modificado após uma operação de Blob de Cópia concluída usando Definir Propriedades de Blob, Colocar Blob ou Colocar Lista de Bloqueios.
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ó aparece quando x-ms-copy-status está com falha ou pendente. Descreve a causa da última falha da operação de cópia fatal ou não fatal. Esse cabeçalho não aparecerá se esse blob nunca tiver sido o destino em uma operação de Blob de Cópia ou se esse blob tiver sido modificado após uma operação de Blob de Cópia concluída usando Definir Propriedades de Blob, Colocar Blob ou Colocar Lista de Bloqueios
copyStatusDescription?: string
Valor de Propriedade
string
createdOn
Retorna a data e a 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 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 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 de 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 o uso do escopo de criptografia de conta padrão.
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 você pode usar para executar 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
O tempo 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 de blob 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 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 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 não estiver criptografado ou se apenas partes dos metadados blob/aplicativo forem criptografadas).
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 gravado pela última vez
lastAccessed?: Date
Valor de Propriedade
Date
lastModified
Retorna a data e a 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 é alugado, especifica se a concessão é de duração infinita ou fixa.
leaseDuration?: LeaseDurationType
Valor de Propriedade
leaseState
leaseStatus
O status de concessão atual do blob.
leaseStatus?: LeaseStatusType
Valor de Propriedade
legalHold
Indica se uma retenção legal está presente no blob.
legalHold?: boolean
Valor de Propriedade
boolean
metadata
metadata?: {[propertyName: string]: string}
Valor de Propriedade
{[propertyName: string]: string}
objectReplicationPolicyId
Opcional. Válido somente quando a Replicação de Objetos estiver habilitada para o contêiner de armazenamento e no blob de destino da replicação.
objectReplicationPolicyId?: string
Valor de Propriedade
string
objectReplicationRules
Opcional. Válido somente quando a Replicação de Objetos estiver 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ída, falha).
objectReplicationRules?: {[propertyName: string]: string}
Valor de Propriedade
{[propertyName: string]: string}
rehydratePriority
Se um objeto estiver no estado pendente de reidratação, esse cabeçalho será retornado com prioridade de reidratar.
rehydratePriority?: RehydratePriority
Valor de Propriedade
requestId
Esse cabeçalho identifica exclusivamente a solicitação que foi feita e pode ser usado para solucionar a solicitação.
requestId?: string
Valor de Propriedade
string
tagCount
O número de tags associadas ao blob
tagCount?: number
Valor de Propriedade
number
version
Indica a versão do serviço de Blob usada para executar a solicitação. Este cabeçalho é retornado para solicitações feitas contra a versão 2009-09-19 e superior.
version?: string
Valor de 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 de Propriedade
string