Definir propriedades blob

A Set Blob Properties operação define as propriedades do sistema na bolha.

Pedir

O Set Blob Properties pedido pode ser construído da seguinte forma. HTTPS é recomendado. Substitua a minha conta pelo nome da sua conta de armazenamento:

PUT Método Request URI Versão HTTP
https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=properties HTTP/1.1

Serviço de Armazenamento emulado URI

Ao fazer um pedido contra o serviço de armazenamento emulsionado, especifique o nome de anfitrião emulador e a porta de serviço Blob como 127.0.0.1:10000 , seguido do nome da conta de armazenamento emulada:

PUT Método Request URI Versão HTTP
http://127.0.0.1:10000/ devstoreaccount1/mycontainer/myblob?comp=properties HTTP/1.1

Para obter mais informações, consulte a Utilização do Armazenamento Emulator Azure para Desenvolvimento e Testes.

Parâmetros do URI

Os seguintes parâmetros adicionais podem ser especificados no pedido URI.

Parâmetro Descrição
timeout Opcional. O timeout parâmetro é expresso em segundos. Para obter mais informações, consulte os intervalos de definição para operações de serviço de blob.

Pedido cabeçalhos (todos os tipos de bolhas)

A tabela seguinte descreve os cabeçalhos de pedido necessários e opcionais para todos os tipos de bolhas.

Cabeçalho do Pedido Description
Authorization Obrigatório. Especifica o esquema de autorização, nome da conta e assinatura. Para mais informações, consulte Os pedidos autorizados à Azure Armazenamento.
Date ou x-ms-date Obrigatório. Especifica a Hora Universal Coordenada (UTC) do pedido. Para mais informações, consulte Os pedidos autorizados à Azure Armazenamento.
x-ms-version Requerido para todos os pedidos autorizados. Especifica a versão da operação a utilizar para este pedido. Para mais informações, consulte a versão para os Serviços Azure Armazenamento.
x-ms-blob-cache-control Opcional. Modifica a cadeia de controlo de cache para a bolha.

Se esta propriedade não for especificada no pedido, então a propriedade será apurada para a bolha. As chamadas subsequentes para Get Blob Properties não devolverão esta propriedade, a menos que seja explicitamente definida na bolha novamente.
x-ms-blob-content-type Opcional. Define o tipo de conteúdo da bolha.

Se esta propriedade não for especificada no pedido, então a propriedade será apurada para a bolha. As chamadas subsequentes para Get Blob Properties não devolverão esta propriedade, a menos que seja explicitamente definida na bolha novamente.
x-ms-blob-content-md5 Opcional. Define o hash MD5 da bolha.

Se esta propriedade não for especificada no pedido, então a propriedade será apurada para a bolha. As chamadas subsequentes para Get Blob Properties não devolverão esta propriedade, a menos que seja explicitamente definida na bolha novamente.
x-ms-blob-content-encoding Opcional. Define a codificação do conteúdo da bolha.

Se esta propriedade não for especificada no pedido, então a propriedade será apurada para a bolha. As chamadas subsequentes para Get Blob Properties não devolverão esta propriedade, a menos que seja explicitamente definida na bolha novamente.
x-ms-blob-content-language Opcional. Define a linguagem de conteúdo da bolha.

Se esta propriedade não for especificada no pedido, então a propriedade será apurada para a bolha. As chamadas subsequentes para Get Blob Properties não devolverão esta propriedade, a menos que seja explicitamente definida na bolha novamente.
x-ms-lease-id:<ID> Necessário se a bolha tiver um arrendamento ativo. Para realizar esta operação numa bolha com um arrendamento ativo, especifique o ID de locação válido para este cabeçalho.
x-ms-client-request-id Opcional. Fornece um valor opaco gerado pelo cliente com um limite de caracteres de 1 KiB que é gravado nos registos de análise quando o registo de análise de armazenamento está ativado. Recomenda-se a utilização deste cabeçalho para correlacionar as atividades do lado do cliente com os pedidos recebidos pelo servidor. Para obter mais informações, consulte Sobre Armazenamento Analítica registação e registo de registos Azure: Utilização de Registos para rastrear pedidos de Armazenamento.
x-ms-blob-content-disposition Opcional. Define o cabeçalho da Content-Disposition bolha. Disponível para versões 2013-08-15 e posteriormente.

O Content-Disposition campo do cabeçalho de resposta 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 para attachment , indica que o agente de utilizador não deve apresentar a resposta, mas sim mostrar um diálogo Save As com um nome de ficheiro diferente do nome blob especificado.

A resposta das operações Get Blob e Get Blob Properties inclui o content-disposition cabeçalho.
Origin Opcional. Especifica a origem a partir da qual o pedido é emitido. A presença deste cabeçalho resulta em cabeçalhos de partilha de recursos de origem cruzada na resposta. Consulte o SUPORTE CORS para os Serviços de Armazenamento para mais informações.

Esta operação também suporta a utilização de cabeçalhos condicional para definir propriedades blob apenas se uma condição especificada for satisfeita. Para obter mais informações, consulte especificar cabeçalhos condicional para operações de serviço de bolhas.

Pedido cabeçalhos (Apenas blobs de página)

A tabela seguinte descreve os cabeçalhos de pedido aplicáveis apenas para operações em bolhas de página.

Cabeçalho do pedido Descrição
x-ms-blob-content-length: byte value Opcional. Redimensiona uma bolha de página para o tamanho especificado. Se o valor especificado for inferior ao tamanho atual da bolha, todas as páginas acima do valor especificado são apuradas.

Esta propriedade não pode ser usada para alterar o tamanho de uma bolha de bloco ou uma bolha de apêndice. Configurar esta propriedade para uma bolha de bloco ou um apêndice blob devolve o código de estado 400 (Mau Pedido).
x-ms-sequence-number-action: {max, update, increment} Opcional, mas requerido se o x-ms-blob-sequence-number cabeçalho estiver definido para o pedido. Esta propriedade aplica-se apenas a bolhas de página.

Esta propriedade indica como o serviço deve modificar o número de sequência da bolha. Especifique uma das seguintes opções para esta propriedade:

- max: Define o número de sequência para ser o maior do valor incluído com o pedido e o valor atualmente armazenado para a bolha.
- update: Define o número da sequência ao valor incluído com o pedido.
- increment: Incrementa o valor do número de sequência por 1. Se especificar esta opção, não inclua o x-ms-blob-sequence-number header ; fazê-lo irá devolver o código de estado 400 (Mau Pedido).
x-ms-blob-sequence-number: <num> Opcional, mas requerido se o x-ms-sequence-number-action imóvel estiver definido para max ou update . Esta propriedade aplica-se apenas a bolhas de página.

Esta propriedade define o número de sequência da bolha. O número de sequência é uma propriedade controlada pelo utilizador que pode usar para rastrear pedidos e gerir problemas de concordância. Para mais informações, consulte a operação Página Put.

Utilize esta propriedade juntamente com x-ms-sequence-number-action a atualização do número de sequência da bolha, quer ao valor especificado quer ao valor mais elevado dos valores especificados com o pedido ou atualmente armazenados com a bolha. Este cabeçalho não deve ser especificado se x-ms-sequence-number-action estiver definido increment para; neste caso, o serviço aumenta automaticamente o número de sequência por um.

Para definir o número da sequência para um valor à sua escolha, esta propriedade deve ser especificada no pedido juntamente com x-ms-sequence-number-action .

Pedido cabeçalhos (chaves de encriptação fornecidas pelo cliente)

Começando pela versão 2019-02-02, os seguintes cabeçalhos podem ser especificados no pedido de encriptação de uma bolha com uma chave fornecida pelo cliente. A encriptação com uma chave fornecida pelo cliente (e o conjunto correspondente de cabeçalhos) é opcional. Se uma bolha tiver sido encriptada previamente com uma chave fornecida pelo cliente, então estes cabeçalhos devem ser incluídos no pedido para completar a operação de escrita com sucesso.

Cabeçalho do pedido Descrição
x-ms-encryption-key Obrigatório. A chave de encriptação AES-256 codificada pela Base64.
x-ms-encryption-key-sha256 Obrigatório. O hash SHA256 codificado pela Base64 da chave de encriptação.
x-ms-encryption-algorithm: AES256 Obrigatório. Especifica o algoritmo a utilizar para encriptação. O valor deste cabeçalho deve ser AES256 .

Corpo do Pedido

Nenhum.

Resposta

A resposta inclui um código de estado HTTP e um conjunto de cabeçalhos de resposta.

Código de Estado

Uma operação bem sucedida devolve o código de estado 200 (OK).

Para obter informações sobre códigos de estado, consulte códigos de estado e de erro.

Cabeçalhos de Resposta

A resposta para esta operação inclui os seguintes cabeçalhos. A resposta também pode incluir cabeçalhos HTTP padrão adicionais. Todos os cabeçalhos standard estão em conformidade com a especificação do protocolo HTTP/1.1.

Syntax Descrição
ETag O ETag contém um valor que pode utilizar para realizar operações condicionalmente. Consulte a especificação de cabeçalhos condicional para operações de serviço blob para obter mais informações. Se a versão de pedido for 2011-08-18 ou mais recente, o valor ETag estará em cotações.
Last-Modified A data/hora em que a bolha foi modificada pela última vez. O formato de data segue o RFC 1123. Para obter mais informações, consulte Representação de Valores Date-Time em Cabeçalhos.

Qualquer operação de escrita na bolha (incluindo atualizações nos metadados ou propriedades da bolha) altera o último tempo modificado da bolha.
x-ms-blob-sequence-number Se a bolha for uma bolha de página, o número de sequência atual da bolha é devolvido com este cabeçalho.
x-ms-request-id Este cabeçalho identifica exclusivamente o pedido que foi feito e pode ser usado para resolver problemas no pedido. Para obter mais informações, consulte operações de API de resolução de problemas.
x-ms-version Indica a versão do serviço Blob utilizado para executar o pedido. Este cabeçalho é devolvido para pedidos feitos contra a versão 2009-09-19 e mais tarde.
Date Uma data/valor de hora UTC gerado pelo serviço que indica o momento em que a resposta foi iniciada.
Access-Control-Allow-Origin Devolvido se o pedido incluir um Origin cabeçalho e o CORS estiver ativado com uma regra de correspondência. Este cabeçalho devolve o valor do cabeçalho pedido de origem em caso de correspondência.
Access-Control-Expose-Headers Devolvido se o pedido incluir um Origin cabeçalho e o CORS estiver ativado com uma regra de correspondência. Devolve a lista de cabeçalhos de resposta que devem ser expostos ao cliente ou emitente do pedido.
Access-Control-Allow-Credentials Devolvido se o pedido incluir um Origin cabeçalho e o CORS estiver ativado com uma regra correspondente que não permite todas as origens. Este cabeçalho será definido como verdadeiro.
x-ms-client-request-id Este cabeçalho pode ser usado para resolver pedidos e respostas correspondentes. O valor deste cabeçalho é igual ao valor do x-ms-client-request-id cabeçalho se estiver presente no pedido e o valor for no máximo 1024 caracteres ASCII visíveis. Se o x-ms-client-request-id cabeçalho não estiver presente no pedido, este cabeçalho não estará presente na resposta.

Corpo de Resposta

Nenhum.

Autorização

Esta operação só pode ser chamada pelo proprietário da conta e por qualquer pessoa com uma Assinatura de Acesso Partilhado que tenha permissão para escrever a esta bolha ou ao seu recipiente.

Observações

A semântica para atualizar as propriedades de uma bolha é a seguinte:

  • O número de sequência de uma mancha de página só é atualizado se o pedido satisfaça uma das seguintes condições:

    • O pedido define x-ms-sequence-number-action o de ou , e especifica também um valor para o max update x-ms-blob-sequence-number cabeçalho.

    • O pedido define x-ms-sequence-number-action o de increment , indicando que o serviço deve incrementar o número de sequência por um.

  • O tamanho de uma bolha de página só é modificado se o pedido especificar um valor para o x-ms-content-length cabeçalho.

  • Para alterar o tamanho de uma bolha de página numa conta de armazenamento premium, o novo tamanho não deve exceder o comprimento de conteúdo permitido pelo nível existente. Ligue para o Blob Tier antes de redimensionar a bolha. Para obter uma lista de níveis e comprimento de conteúdo permitido, consulte Premium Armazenamento de alto desempenho e discos geridos para VMs.

  • Se um pedido apenas x-ms-blob-sequence-number e/ou x-ms-content-length , e nenhuma outra propriedade, então nenhuma das outras propriedades da bolha é modificada.

  • Se alguma ou mais das seguintes propriedades forem definidas no pedido, então todas estas propriedades são definidas em conjunto. Se não for fornecido um valor para uma determinada propriedade quando pelo menos uma das propriedades listadas abaixo estiver definida, então essa propriedade será apurada para a bolha.

    • x-ms-blob-cache-control

    • x-ms-blob-content-type

    • x-ms-blob-content-md5

    • x-ms-blob-content-encoding

    • x-ms-blob-content-language

    • x-ms-blob-content-disposition

Nota

Note que para uma assinatura de acesso partilhado, pode sobrepor certas propriedades armazenadas para a bolha, especificando parâmetros de consulta como parte da assinatura de acesso partilhado. Estas propriedades cache-control incluem, content-type content-encoding e content-language propriedades, e content-disposition propriedades. Para mais informações, consulte Criar um serviço SAS.

Consulte também

Autorizar pedidos à Azure Armazenamento
Códigos de Estado e erro