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 2023-11-03 y se recomienda usar esa versión siempre que sea posible. Para más información sobre la versión más reciente, consulte Control de versiones para Azure Storage.
Entre las versiones admitidas adicionales se incluyen:
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 (SignedVersion, o sv), que especifica qué versión usar para autorizar y ejecutar la solicitud 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 SignedVersion (sv) parámetro . SignedVersion indica la versión del servicio usada para la autorización y para llamar a la operación de API. Si el x-ms-version encabezado se pasa a la solicitud, se omite. Solo el SignedVersion (sv) parámetro 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 direcciones URL de firma de acceso compartido (es decir, proveedores de firmas de acceso compartido o generadores) 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 |
|---|---|
| 11-12-2015 | Todos (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 List 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 Url elemento en el Blob elemento 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 Uri elemento . Por lo tanto, se produce un error en la solicitud con .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 la 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 SignedVersion (sv) parámetro , que permite al generador de firmas de acceso compartido especificar la versión que se va a 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:
Si la solicitud tiene un encabezado válido
x-ms-version, 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 porx-ms-versionse usa para realizar la operación de Blob Storage.Si la solicitud no tiene un
x-ms-versionencabezado 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.Si la solicitud no tiene un
x-ms-versionencabezado 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.Si la solicitud no tiene un
x-ms-versionencabezado 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 operación Set Container ACL que usó la versión 2009-09-19 o posterior, 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 el SignedVersion parámetro no está incluido.
| 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 |
|---|---|---|
| None | Versión de firma de acceso compartido válida más antigua (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 de firma de acceso compartido válida más antigua (2009-07-17) | 2011-08-18. |
| Cualquier versión XXXX-XX-XX | Primera versión 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 requieran valores entre comillas ETag o encabezados de respuesta válidos Accept-Ranges . Los exploradores y otros clientes de streaming requieren estos encabezados para una descarga y reintentos eficaces.