Versioni precedenti di Archiviazione di Azure
Archiviazione di Azure supporta più versioni. Per effettuare una richiesta in Archiviazione, è necessario specificare la versione che si vuole usare per tale operazione, a meno che la richiesta non sia anonima.
Versioni disponibili
La versione corrente di Archiviazione di Azure è 2023-11-03 e l'uso di tale versione è consigliato se possibile. Per informazioni sulla versione più recente, vedere Controllo delle versioni per Archiviazione di Azure.
Le versioni supportate aggiuntive 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 ), svche specifica la versione da usare per autorizzare ed eseguire la richiesta sas.
Versione 2012-02-12 e versioni successive
Le richieste con firme di accesso condiviso generate tramite la versione 2012-02-12 o successiva richiedono il SignedVersion (sv) parametro. 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 SignedVersion (sv) parametro 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 versioni precedenti, assicurarsi che i servizi che preparano e distribuiscano GLI URL di firma di accesso condiviso ( ovvero, provider di firme di accesso condiviso o generatori) specificano le versioni del servizio di archiviazione di Azure comprese dal software client (ovvero i 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 BLOB di elenco 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 nell'elemento UrlBlob , perché è stato rimosso nella versione 2013-08-15.
Se un'applicazione client usa una versione della libreria client di archiviazione in base alla 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 NullReferenceExceptionoggetto .
Versioni precedenti al 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 SignedVersion (sv) parametro, 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 al 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 valida
x-ms-version, viene usata la versione più recente valida (2009-07-17) per interpretare i parametri delle firme 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 Imposta proprietà archiviazione BLOB, la versione 2009-07-17 viene usata 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 e il proprietario non ha impostato una
x-ms-versionversione predefinita, Archiviazione BLOB usa la versione più recente valida (2009-07-17) per interpretare i parametri. Se il contenitore è pubblico e le restrizioni di accesso sono state impostate con un'operazione Set Container ACL che ha usato la versione 2009-09-19 o successiva, la versione 2009-09-19 viene usata per eseguire l'operazione di archiviazione BLOB.Se la richiesta non ha un'intestazione e il proprietario non ha impostato una
x-ms-versionversione predefinita, 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 Set Container ACL che ha usato la versione 2009-09-19 o successiva, l'operazione di archiviazione BLOB viene eseguita usando la versione più recente del servizio.
La tabella seguente applica queste regole a vari scenari e presuppone che il SignedVersion parametro 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 più 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 usando la versione 2009-09-19 o successiva. In caso contrario, viene usata la versione più recente dell'archiviazione BLOB. |
| 2011-08-18 | Versione più 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 delimitati ETag o intestazioni di risposta valide Accept-Ranges . I browser e altri client di streaming richiedono queste intestazioni per un download e nuovi tentativi efficienti.