Partilhar via


Melhores práticas de controlo de versões

A Microsoft recomenda as seguintes melhores práticas de controlo de versões para o Armazenamento do Azure:

  • Especifique explicitamente a versão do protocolo REST a utilizar para cada pedido.

  • Defina uma versão predefinida para Armazenamento de Blobs do Azure com a operação Definir Propriedades do Serviço blob. A versão predefinida especifica a versão a utilizar para pedidos anónimos para os quais o cabeçalho da versão não pode ser definido.

  • O software de cliente que utiliza um URL de assinatura de acesso partilhado (SAS) para aceder a recursos de armazenamento pode ter um comportamento inesperado quando o URL de SAS especifica uma versão do serviço de armazenamento mais recente do que a versão utilizada pelo software de cliente. Para garantir que os seus clientes funcionam bem com tokens DE SAS, recomendamos as seguintes abordagens:

    • Para a versão 2014-02-14 e posterior: se for um consumidor de tokens de SAS que esteja a utilizar a API REST, pode substituir a versão do protocolo REST para especificar a versão adequada com o api-version parâmetro . Para obter mais informações, veja Controlo de versões do Armazenamento do Azure.

      Se for um consumidor de tokens de SAS que está a utilizar a biblioteca de cliente do Armazenamento do Microsoft Azure, a biblioteca garante que é pedida a versão correta do protocolo REST.

    • Para a versão 2013-08-15 e anterior: o código que prepara e distribui URLs de assinatura de acesso partilhado (ou seja, fornecedores de SAS ou geradores) deve especificar versões que são compreendidas pelo software de cliente (ou seja, consumidores de SAS) que está a fazer pedidos de serviço de armazenamento.

  • Utilize sempre a versão mais recente do Armazenamento do Azure para beneficiar de otimizações incluídas em cada nova versão. Alguns exemplos destas alterações incluem:

    • A versão 2013-08-15 introduziu o formato de payload JSON que reduz a utilização da largura de banda de rede em até 70 por cento em comparação com o protocolo OData AtomPub.

    • A versão 2013-08-15 permite que os fornecedores e geradores de SAS adicionem determinados cabeçalhos de resposta, como cache-control, content-dispositione content-type através de parâmetros de consulta SAS.

    • A versão 2011-08-18 introduziu os cabeçalhos citados ETag e Accept-Ranges de resposta necessários para transferência otimizada e transmissão em fluxo através de browsers.

Ver também

Controlo de versões do Armazenamento do Azure