Versões anteriores do Armazenamento do Azure
O Armazenamento do Azure dá suporte a várias versões. Para fazer uma solicitação contra o armazenamento, você deve especificar a versão que deseja usar para essa operação, a menos que a solicitação seja anônima.
Versões disponíveis
A versão atual do Armazenamento do Azure é 2024-11-04, e o uso dessa versão é recomendado sempre que possível. Para obter informações sobre a versão mais recente, consulte Versionamento para o Armazenamento do Azure.
As versões adicionais suportadas incluem:
Pedidos autorizados através de assinatura de acesso partilhado
Uma solicitação feita por meio de uma assinatura de acesso compartilhado é processada de acordo com a versão usada para gerar o SAS. As versões 2013-08-15 e 2012-02-12 incluem um parâmetro de controle de versão (SignedVersionou sv), que especifica qual versão usar para autorizar e executar a solicitação SAS.
Versão 2012-02-12 e posterior
As solicitações com assinaturas de acesso compartilhado geradas usando a versão 2012-02-12 ou posterior exigem o parâmetro SignedVersion (sv).
SignedVersion indica a versão de serviço usada para autorização e para chamar a operação da API. Se o cabeçalho x-ms-version for passado na solicitação, ele será ignorado. Somente o parâmetro SignedVersion (sv) determina a versão de serviço a ser usada para processar a solicitação feita por meio da assinatura de acesso compartilhado.
Observação
Para a versão 2013-08-15 e anteriores, certifique-se de que os serviços que preparam e distribuem URLs de assinatura de acesso compartilhado (ou seja, provedores ou geradores de assinatura de acesso compartilhado) especifiquem as versões do serviço de Armazenamento do Azure que são compreendidas pelo software cliente (ou seja, consumidores de assinatura de acesso compartilhado).
A tabela a seguir indica quais serviços são suportados para qual versão, para uma solicitação feita por meio de uma assinatura de acesso compartilhado:
Valor do parâmetro SignedVersion (sv) |
Serviços suportados |
|---|---|
| 2015-12-11 | Todos (Armazenamento de Blobs do Azure, Armazenamento de Filas do Azure, Armazenamento de Tabela do Azure e Arquivos do Azure) |
| 2015-04-05 | Todos (Armazenamento de Blob, Armazenamento de Filas, Armazenamento de Tabela e Arquivos do Azure) |
| 2015-02-21 | Todos (Armazenamento de Blob, Armazenamento de Filas, Armazenamento de Tabela e Arquivos do Azure) |
| 2014-02-14 | Armazenamento de Blob, Armazenamento de Filas e Armazenamento de Tabela |
| 2013-08-15 | Armazenamento de Blob, Armazenamento de Filas e Armazenamento de Tabela |
| 2012-02-12 | Armazenamento de Blob, Armazenamento de Filas e Armazenamento de Tabela |
O exemplo a seguir mostra uma assinatura de acesso compartilhado que chama de Blobs de Lista usando sv=2013-08-15.
https://myaccount.blob.core.windows.net/mycontainer?restype=container&comp=list&sv=2013-08-15&si=readpolicy&sig=a39 %2BYozJhGp6miujGymjRpN8tsrQfLo9Z3i8IRyIpnQ%3d
Neste exemplo, o serviço autoriza e executa a solicitação usando a versão 2013-08-15. A resposta não incluirá o elemento Url sob o elemento Blob, porque foi removido na versão 2013-08-15.
Se um aplicativo cliente usa uma versão da biblioteca de cliente de armazenamento baseada na versão 2012-02-12 e faz uma solicitação que usa essa assinatura de acesso compartilhado, o cliente espera o elemento Uri. Portanto, a solicitação falha com um NullReferenceException.
Versões anteriores a 2012-02-12 (somente armazenamento de Blob)
O Blob Storage introduziu assinaturas de acesso compartilhado na versão 2009-07-17. O Armazenamento de Tabela e o Armazenamento de Filas introduziram assinaturas de acesso compartilhado na versão 2012-02-12, portanto, o comportamento de assinatura de acesso compartilhado anterior à versão 2012-02-12 se aplica apenas ao Armazenamento de Blobs.
A versão 2012-02-12 também introduziu o parâmetro SignedVersion (sv), que permite que o gerador de assinatura de acesso compartilhado especifique a versão a ser usada para processar a solicitação. Uma assinatura de acesso compartilhado gerada com uma versão anterior a 2012-02-12 não pode especificar a versão a ser usada para processar a solicitação e, portanto, depende das seguintes regras para autorização e execução de API:
Se a solicitação tiver um cabeçalho de
x-ms-versionválido, a versão válida mais antiga (2009-07-17) será usada para interpretar os parâmetros de assinatura de acesso compartilhado. A versão especificada porx-ms-versioné usada para executar a operação de armazenamento de Blob.Se a solicitação não tiver um cabeçalho
x-ms-versione o proprietário tiver definido a versão padrão usando Definir propriedades de armazenamento de Blob, a versão 2009-07-17 será usada para interpretar os parâmetros. A versão padrão especificada pelo proprietário é usada para executar a operação de armazenamento de Blob.Se a solicitação não tiver um cabeçalho
x-ms-versione o proprietário não tiver definido uma versão padrão, o Armazenamento de Blobs usará a versão válida mais antiga (2009-07-17) para interpretar os parâmetros. Se o contêiner for público e suas restrições de acesso tiverem sido definidas com uma operação de de ACL de Contêiner deque usou a versão 2009-09-19 ou posterior, a versão 2009-09-19 será usada para executar a operação de Armazenamento de Blob. Se a solicitação não tiver um cabeçalho
x-ms-versione o proprietário não tiver definido uma versão padrão, o Armazenamento de Blobs usará a versão válida mais antiga (2009-07-17) para interpretar os parâmetros. Se as restrições de acesso ao contêiner não tiverem sido definidas com uma operação de ACL de Contêiner de Conjunto deque usou a versão 2009-09-19 ou posterior, a operação de Armazenamento de Blob será executada usando a versão mais antiga do serviço.
A tabela a seguir aplica essas regras a vários cenários e assume que o parâmetro SignedVersion não está incluído.
| Valor do cabeçalho x-ms-version | Versão usada para interpretar parâmetros para autorização e autorização para armazenamento de Blob | Versão usada para executar a operação de armazenamento de Blob |
|---|---|---|
| Nenhum | Primeira versão válida de assinatura de acesso compartilhado (2009-07-17) | 2009-09-19 é usado se o contêiner foi definido como público por set Container ACL usando a versão 2009-09-19 ou posterior. Caso contrário, a versão mais antiga do Armazenamento de Blob será usada. |
| 2011-08-18 | Primeira versão válida de assinatura de acesso compartilhado (2009-07-17) | 2011-08-18. |
| Qualquer versão XXXX-XX-XX | Primeira versão válida de assinatura de acesso compartilhado (2009-07-17) | Versão XXXX-XX-XX |
Observação
A Microsoft recomenda o uso da versão 2011-08-18 ou posterior para cenários que exigem valores de ETag cotados ou cabeçalhos de resposta Accept-Ranges válidos. Navegadores e outros clientes de streaming exigem esses cabeçalhos para download e tentativas eficientes.
Ver também
Controle de versão para o de Armazenamento do Azure