Práticas recomendadas de controle de versão

  • Artigo

A Microsoft recomenda as seguintes práticas recomendadas de controle de versão para o Armazenamento do Azure:

  • Especifique explicitamente a versão do protocolo REST a ser usada para cada solicitação.

  • Defina uma versão padrão para Armazenamento de Blobs do Azure usando a operação Definir Propriedades do Serviço Blob. A versão padrão especifica a versão a ser usada para solicitações anônimas para as quais o cabeçalho de versão não pode ser definido.

  • O software cliente que usa uma URL de SAS (assinatura de acesso compartilhado) para acessar recursos de armazenamento pode ter um comportamento inesperado quando a URL sas especifica uma versão do serviço de armazenamento mais recente do que a versão usada pelo software cliente. Para garantir que seus clientes funcionem bem com tokens SAS, recomendamos as seguintes abordagens:

    • Para a versão 2014-02-14 e posterior: se você for um consumidor de token SAS que está usando a API REST, poderá substituir a versão do protocolo REST para especificar a versão apropriada usando o api-version parâmetro . Para obter mais informações, consulte Controle de versão do Armazenamento do Azure.

      Se você for um consumidor de token SAS que está usando a biblioteca de clientes do Armazenamento do Azure, a biblioteca garantirá que a versão correta do protocolo REST seja solicitada.

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

  • Sempre use a versão mais recente do Armazenamento do Azure para se beneficiar de otimizações incluídas em cada nova versão. Alguns exemplos de mudanças incluem:

    • A versão 2013-08-15 introduziu o formato de conteúdo JSON que reduz o uso de largura de banda de rede em até 70% em comparação com o protocolo OData AtomPub.

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

    • A versão 2011-08-18 introduziu os cabeçalhos entre aspas ETag e Accept-Ranges de resposta necessários para download otimizado e streaming por meio de navegadores.

Confira também

Controle de versão do Armazenamento do Azure