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:

• Versão 2024-08-04

• Versão 2024-05-04

• Versão 2024-02-04

• Versão 2023-11-03

• Versão 2023-08-03

• Versão 2023-05-03

• Versão 2023-01-03

• Versão 2022-11-02

• Versão 2021-12-02

• Versão 2021-10-04

• Versão 2021-08-06

• Versão 2021-06-08

• Versão 2021-04-10

• Versão 2021-02-12

• Versão 2020-12-06

• Versão 2020-10-02

• Versão 2020-08-04

• Versão 2020-06-12

• Versão 2020-04-08

• Versão 2020-02-10

• Versão 2019-12-12

• Versão 2019-07-07

• Versão 2019-02-02

• Versão 2018-11-09

• Versão 2018-03-28

• Versão 2017-11-09

• Versão 2017-07-29

• Versão 2017-04-17

• Versão 2016-05-31

• Versão 2015-12-11

• Versão 2015-07-08

• Versão 2015-04-05

• Versão 2015-02-21

• Versão 2014-02-14

• Versão 2013-08-15

• Versão 2012-02-12

• Versão 2011-08-18

• Versão 2009-09-19

• Versão 2009-07-17

• Versão 2009-04-14

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.

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:

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:

1. Se a solicitação tiver um cabeçalho de x-ms-version vá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 por x-ms-version é usada para executar a operação de armazenamento de Blob.

2. Se a solicitação não tiver um cabeçalho x-ms-version e 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.

3. Se a solicitação não tiver um cabeçalho x-ms-version e 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 de que 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.

4. Se a solicitação não tiver um cabeçalho x-ms-version e 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 de que 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.

Ver também

Controle de versão para o de Armazenamento do Azure