Versioni precedenti di Archiviazione di Azure
Archiviazione di Azure supporta più versioni. Per effettuare una richiesta in Archiviazione, è necessario specificare la versione da usare per tale operazione, a meno che la richiesta non sia anonima.
Versioni disponibili
La versione corrente di Archiviazione di Azure è 2025-05-05 e l'uso di tale versione è consigliato laddove possibile. Per informazioni sulla versione più recente, vedere controllo delle versioni per Archiviazione di Azure.
Altre versioni supportate includono:
Richieste autorizzate tramite firma di accesso condiviso
Una richiesta effettuata tramite una firma di accesso condiviso viene elaborata in base alla versione usata per generare la firma di accesso condiviso. Le versioni 2013-08-15 e 2012-02-12 includono un parametro di controllo delle versioni (SignedVersiono sv), che specifica la versione da usare per autorizzare ed eseguire la richiesta di firma di accesso condiviso.
Versione 2012-02-12 e successive
Le richieste con firme di accesso condiviso generate tramite la versione 2012-02-12 o successiva richiedono il parametro SignedVersion (sv).
SignedVersion indica la versione del servizio usata per l'autorizzazione e per chiamare l'operazione API. Se l'intestazione x-ms-version viene passata alla richiesta, viene ignorata. Solo il parametro SignedVersion (sv) determina la versione del servizio da usare per elaborare la richiesta effettuata tramite la firma di accesso condiviso.
Nota
Per la versione 2013-08-15 e precedenti, assicurarsi che i servizi che preparano e distribuiscano gli URL delle firme di accesso condiviso (ovvero i provider di firme di accesso condiviso o i generatori) specifichino le versioni del servizio archiviazione di Azure riconosciute dal software client (ovvero consumer di firme di accesso condiviso).
La tabella seguente indica quali servizi sono supportati per quale versione, per una richiesta effettuata tramite una firma di accesso condiviso:
Valore del parametro SignedVersion (sv) |
Servizi supportati |
|---|---|
| 2015-12-11 | Tutti (Archiviazione BLOB di Azure, Archiviazione code di Azure, Archiviazione tabelle di Azure e File di Azure) |
| 2015-04-05 | Tutti (Archiviazione BLOB, Archiviazione code, Archiviazione tabelle e File di Azure) |
| 2015-02-21 | Tutti (Archiviazione BLOB, Archiviazione code, Archiviazione tabelle e File di Azure) |
| 2014-02-14 | Archiviazione BLOB, archiviazione code e archiviazione tabelle |
| 2013-08-15 | Archiviazione BLOB, archiviazione code e archiviazione tabelle |
| 2012-02-12 | Archiviazione BLOB, archiviazione code e archiviazione tabelle |
Nell'esempio seguente viene illustrata una firma di accesso condiviso che chiama list BLOB 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
In questo esempio il servizio autorizza ed esegue la richiesta usando la versione 2013-08-15. La risposta non includerà l'elemento Url sotto l'elemento Blob, perché è stato rimosso nella versione 2013-08-15.
Se un'applicazione client usa una versione della libreria client di archiviazione basata sulla versione 2012-02-12 e effettua una richiesta che usa questa firma di accesso condiviso, il client prevede l'elemento Uri. Pertanto, la richiesta ha esito negativo con un NullReferenceException.
Versioni precedenti alla versione 2012-02-12 (solo archiviazione BLOB)
Archiviazione BLOB ha introdotto firme di accesso condiviso nella versione 2009-07-17. Archiviazione tabelle e Archiviazione code hanno introdotto firme di accesso condiviso nella versione 2012-02-12, quindi il comportamento della firma di accesso condiviso prima della versione 2012-02-12 si applica solo all'archiviazione BLOB.
La versione 2012-02-12 ha introdotto anche il parametro SignedVersion (sv), che consente al generatore di firme di accesso condiviso di specificare la versione da usare per elaborare la richiesta. Una firma di accesso condiviso generata con una versione precedente alla versione 2012-02-12 non può specificare la versione da usare per elaborare la richiesta e quindi si basa sulle regole seguenti per l'autorizzazione e l'esecuzione dell'API:
Se la richiesta ha un'intestazione di
x-ms-versionvalida, viene usata la versione precedente valida (2009-07-17) per interpretare i parametri della firma di accesso condiviso. La versione specificata dax-ms-versionviene usata per eseguire l'operazione di archiviazione BLOB.Se la richiesta non ha un'intestazione
x-ms-versione il proprietario ha impostato la versione predefinita usando Impostare le proprietà dell'archiviazione BLOB, viene usata la versione 2009-07-17 per interpretare i parametri. La versione predefinita specificata dal proprietario viene usata per eseguire l'operazione di archiviazione BLOB.Se la richiesta non ha un'intestazione
x-ms-versione il proprietario non ha impostato una versione predefinita, l'archiviazione BLOB usa la versione più recente valida (2009-07-17) per interpretare i parametri. Se il contenitore è pubblico e le relative restrizioni di accesso sono state impostate con un'operazione di Set Container ACL che usava la versione 2009-09-19 o successiva, viene usata la versione 2009-09-19 per eseguire l'operazione di archiviazione BLOB.Se la richiesta non ha un'intestazione
x-ms-versione il proprietario non ha impostato una versione predefinita, l'archiviazione BLOB usa la versione più recente valida (2009-07-17) per interpretare i parametri. Se le restrizioni di accesso al contenitore non sono state impostate con un'operazione di Set Container ACL che usava la versione 2009-09-19 o successiva, l'operazione di archiviazione BLOB viene eseguita usando la versione meno recente del servizio.
La tabella seguente applica queste regole a vari scenari e presuppone che il parametro SignedVersion non sia incluso.
| Valore dell'intestazione x-ms-version | Versione usata per interpretare i parametri per l'autorizzazione e l'autorizzazione per l'archiviazione BLOB | Versione usata per eseguire l'operazione di archiviazione BLOB |
|---|---|---|
| Nessuno | Versione meno recente della firma di accesso condiviso valida (2009-07-17) | 2009-09-19 viene usato se il contenitore è stato impostato su public by Set Container ACL using version 2009-09-19 or later. In caso contrario, viene usata la versione meno recente dell'archiviazione BLOB. |
| 2011-08-18 | Versione meno recente della firma di accesso condiviso valida (2009-07-17) | 2011-08-18. |
| Qualsiasi versione XXXX-XX-XX | Versione meno recente della firma di accesso condiviso valida (2009-07-17) | Versione XXXX-XX-XX |
Nota
Microsoft consiglia di usare la versione 2011-08-18 o successiva per scenari che richiedono valori di ETag tra virgolette o intestazioni di risposta valide Accept-Ranges. I browser e altri client di streaming richiedono queste intestazioni per un download efficiente e nuovi tentativi.