Versiones anteriores de Azure Storage

Azure Storage admite varias versiones. Para realizar una solicitud en Storage, debe especificar la versión que desea usar para esa operación, a menos que la solicitud sea anónima.

Versiones disponibles

La versión actual de Azure Storage es 2024-11-04 y se recomienda usar esa versión siempre que sea posible. Para obtener información sobre la versión más reciente, consulte control de versiones de para Azure Storage.

Entre las versiones admitidas adicionales se incluyen:

• versión 2024-08-04

• versión 2024-05-04

• versión 2024-02-04

• versión 2023-11-03

• versión 2023-08-03

• versión 2023-05-03

• versión 2023-01-03

• versión 2022-11-02

• versión 2021-12-02

• versión 2021-10-04

• versión 2021-08-06

• versión 2021-06-08

• versión 2021-04-10

• versión 2021-02-12

• versión 2020-12-06

• versión 2020-10-02

• versión 2020-08-04

• versión 2020-06-12

• versión 2020-04-08

• versión 2020-02-10

• versión 2019-12-12

• versión 2019-07-07

• versión 2019-02-02

• versión 2018-11-09

• versión 2018-03-28

• versión 2017-11-09

• versión 2017-07-29

• versión 2017-04-17

• versión 2016-05-31

• versión 2015-12-11

• versión 2015-07-08

• versión 2015-04-05

• versión 2015-02-21

• versión 2014-02-14

• versión 2013-08-15

• versión 2012-02-12

• versión 2011-08-18

• versión 2009-09-19

• versión 2009-07-17

• versión 2009-04-14

Solicitudes autorizadas a través de la firma de acceso compartido

Una solicitud realizada a través de una firma de acceso compartido se procesa según la versión que use para generar la SAS. Las versiones 2013-08-15 y 2012-02-12 incluyen un parámetro de control de versiones (SignedVersiono sv), que especifica la versión que se va a usar para autorizar y ejecutar la solicitud de SAS.

Versión 2012-02-12 y posteriores

Las solicitudes con firmas de acceso compartido generadas mediante la versión 2012-02-12 o posterior requieren el parámetro SignedVersion (sv). SignedVersion indica la versión del servicio usada para la autorización y para llamar a la operación de API. Si se pasa el encabezado x-ms-version en la solicitud, se omite. Solo el parámetro SignedVersion (sv) determina la versión del servicio que se va a usar para procesar la solicitud realizada a través de la firma de acceso compartido.

Nota

Para la versión 2013-08-15 y versiones anteriores, asegúrese de que los servicios que preparen y distribuyan las direcciones URL de firma de acceso compartido (es decir, proveedores o generadores de firmas de acceso compartido) especifiquen las versiones de servicio de Azure Storage que entiende el software cliente (es decir, consumidores de firmas de acceso compartido).

En la tabla siguiente se indican los servicios que se admiten para qué versión, para una solicitud realizada a través de una firma de acceso compartido:

Valor del parámetro SignedVersion (sv)	Servicios admitidos
2015-12-11	All (Azure Blob Storage, Azure Queue Storage, Azure Table Storage y Azure Files)
2015-04-05	All (Blob Storage, Queue Storage, Table Storage y Azure Files)
2015-02-21	All (Blob Storage, Queue Storage, Table Storage y Azure Files)
2014-02-14	Blob Storage, Queue Storage y Table Storage
2013-08-15	Blob Storage, Queue Storage y Table Storage
2012-02-12	Blob Storage, Queue Storage y Table Storage

En el ejemplo siguiente se muestra una firma de acceso compartido que llama a Enumerar blobs mediante 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

En este ejemplo, el servicio autoriza y ejecuta la solicitud mediante la versión 2013-08-15. La respuesta no incluirá el elemento Url en el elemento Blob, porque se quitó en la versión 2013-08-15.

Si una aplicación cliente usa una versión de la biblioteca cliente de Storage basada en la versión 2012-02-12 y realiza una solicitud que usa esta firma de acceso compartido, el cliente espera el elemento Uri. Por lo tanto, se produce un error en la solicitud con un NullReferenceException.

Versiones anteriores a 2012-02-12 (solo Blob Storage)

Blob Storage introdujo firmas de acceso compartido en la versión 2009-07-17. Table Storage y Queue Storage introdujeron firmas de acceso compartido en la versión 2012-02-12, por lo que el comportamiento de firma de acceso compartido anterior a la versión 2012-02-12 solo se aplica a Blob Storage.

La versión 2012-02-12 también introdujo el parámetro SignedVersion (sv), que permite al generador de firmas de acceso compartido especificar la versión que se usará para procesar la solicitud. Una firma de acceso compartido generada con una versión anterior al 2012-02-12 no puede especificar la versión que se va a usar para procesar la solicitud, por lo que se basa en las siguientes reglas para la autorización y la ejecución de la API:

1. Si la solicitud tiene un encabezado de x-ms-version válido, se usa la versión válida más antigua (2009-07-17) para interpretar los parámetros de firma de acceso compartido. La versión especificada por x-ms-version se usa para realizar la operación de Blob Storage.

2. Si la solicitud no tiene un encabezado de x-ms-version y el propietario ha establecido la versión predeterminada mediante Establecer propiedades de Blob Storage, se usa la versión 2009-07-17 para interpretar los parámetros. La versión predeterminada especificada por el propietario se usa para realizar la operación de Blob Storage.

3. Si la solicitud no tiene un encabezado x-ms-version y el propietario no ha establecido una versión predeterminada, Blob Storage usa la versión válida más antigua (2009-07-17) para interpretar los parámetros. Si el contenedor es público y sus restricciones de acceso se establecieron con una Operación set Container ACL que usó la versión 2009-09-19 o posterior, se usa la versión 2009-09-19 para realizar la operación de Blob Storage.

4. Si la solicitud no tiene un encabezado x-ms-version y el propietario no ha establecido una versión predeterminada, Blob Storage usa la versión válida más antigua (2009-07-17) para interpretar los parámetros. Si las restricciones de acceso al contenedor no se establecieron con una Set Container ACL operation that used version 2009-09-19 or later, la operación de Blob Storage se realiza mediante la versión más antigua del servicio.

En la tabla siguiente se aplican estas reglas a varios escenarios y se supone que no se incluye el parámetro SignedVersion.

Valor del encabezado x-ms-version	Versión que se usa para interpretar parámetros de autorización y autorización para Blob Storage	Versión usada para realizar la operación de Blob Storage
Ninguno	Versión más antigua válida de la firma de acceso compartido (2009-07-17)	2009-09-19 se usa si el contenedor se estableció en público mediante Set Container ACL by using version 2009-09-19 or later. De lo contrario, se usa la versión más antigua de Blob Storage.
2011-08-18	Versión más antigua válida de la firma de acceso compartido (2009-07-17)	2011-08-18.
Cualquier versión XXXX:XX-XX	Versión más antigua válida de la firma de acceso compartido (2009-07-17)	Versión XXXX:XX-XX

Nota

Microsoft recomienda usar la versión 2011-08-18 o posterior para escenarios que requieren valores de ETag entre comillas o encabezados de respuesta Accept-Ranges válidos. Los exploradores y otros clientes de streaming requieren estos encabezados para una descarga y reintentos eficaces.

Consulte también

control de versiones de para azure Storage