Versi Azure Storage sebelumnya

Azure Storage mendukung beberapa versi. Untuk membuat permintaan terhadap Penyimpanan, Anda harus menentukan versi yang ingin Anda gunakan untuk operasi tersebut, kecuali permintaannya anonim.

Versi yang tersedia

Versi Azure Storage saat ini adalah 2024-11-04, dan menggunakan versi tersebut direkomendasikan jika memungkinkan. Untuk informasi tentang versi terbaru, lihat Penerapan Versi untuk Azure Storage.

Versi tambahan yang didukung meliputi:

• versi 2024-08-04

• versi 2024-05-04

• versi 2024-02-04

• versi 2023-11-03

• versi 2023-08-03

• versi 2023-05-03

• versi 2023-01-03

• versi 2022-11-02

• versi 2021-12-02

• versi 2021-10-04

• versi 2021-08-06

• versi 2021-06-08

• versi 2021-04-10

• versi 2021-02-12

• versi 2020-12-06

• versi 2020-10-02

• versi 2020-08-04

• versi 2020-06-12

• versi 2020-04-08

• versi 2020-02-10

• versi 2019-12-12

• versi 2019-07-07

• versi 2019-02-02

• versi 2018-11-09

• versi 2018-03-28

• versi 2017-11-09

• versi 2017-07-29

• versi 2017-04-17

• versi 2016-05-31

• versi 2015-12-11

• versi 2015-07-08

• versi 2015-04-05

• versi 2015-02-21

• versi 2014-02-14

• versi 2013-08-15

• versi 2012-02-12

• versi 2011-08-18

• versi 2009-09-19

• versi 2009-07-17

• versi 2009-04-14

Permintaan yang diotorisasi melalui tanda tangan akses bersama

Permintaan yang dibuat melalui tanda tangan akses bersama diproses sesuai dengan versi mana yang Anda gunakan untuk menghasilkan SAS. Versi 2013-08-15 dan 2012-02-12 menyertakan parameter penerapan versi (SignedVersion, atau sv), yang menentukan versi mana yang akan digunakan untuk mengotorisasi dan menjalankan permintaan SAS.

Versi 2012-02-12 dan yang lebih baru

Permintaan dengan tanda tangan akses bersama yang dihasilkan dengan menggunakan versi 2012-02-12 atau yang lebih baru memerlukan parameter SignedVersion (sv). SignedVersion menunjukkan versi layanan yang digunakan untuk otorisasi dan untuk memanggil operasi API. Jika header x-ms-version diteruskan pada permintaan, header akan diabaikan. Hanya parameter SignedVersion (sv) yang menentukan versi layanan yang akan digunakan untuk memproses permintaan yang dibuat melalui tanda tangan akses bersama.

Nota

Untuk versi 2013-08-15 dan yang lebih lama, pastikan bahwa layanan yang menyiapkan dan mendistribusikan URL tanda tangan akses bersama (yaitu, penyedia tanda tangan akses bersama atau generator) menentukan versi layanan Azure Storage yang dipahami oleh perangkat lunak klien (yaitu, konsumen tanda tangan akses bersama).

Tabel berikut menunjukkan layanan mana yang didukung untuk versi mana, untuk permintaan yang dibuat melalui tanda tangan akses bersama:

Nilai parameter SignedVersion (sv)	Layanan yang didukung
2015-12-11	Semua (Azure Blob Storage, Azure Queue Storage, Azure Table Storage, dan Azure Files)
2015-04-05	Semua (Blob Storage, Queue Storage, Table Storage, dan Azure Files)
2015-02-21	Semua (Blob Storage, Queue Storage, Table Storage, dan Azure Files)
2014-02-14	Penyimpanan Blob, Penyimpanan Antrean, dan Penyimpanan Tabel
2013-08-15	Penyimpanan Blob, Penyimpanan Antrean, dan Penyimpanan Tabel
2012-02-12	Penyimpanan Blob, Penyimpanan Antrean, dan Penyimpanan Tabel

Contoh berikut menunjukkan tanda tangan akses bersama yang memanggil Daftar Blob dengan menggunakan 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

Dalam contoh ini, layanan mengotorisasi dan menjalankan permintaan dengan menggunakan versi 2013-08-15. Respons tidak akan menyertakan elemen Url di bawah elemen Blob, karena dihapus dalam versi 2013-08-15.

Jika aplikasi klien menggunakan versi pustaka klien Storage berdasarkan versi 2012-02-12, dan membuat permintaan yang menggunakan tanda tangan akses bersama ini, klien mengharapkan elemen Uri. Oleh karena itu, permintaan gagal dengan NullReferenceException.

Versi sebelum 2012-02-12 (hanya Blob Storage)

Blob Storage memperkenalkan tanda tangan akses bersama dalam versi 2009-07-17. Penyimpanan Tabel dan Penyimpanan Antrean memperkenalkan tanda tangan akses bersama dalam versi 2012-02-12, sehingga perilaku tanda tangan akses bersama sebelum versi 2012-02-12 hanya berlaku untuk Blob Storage.

Versi 2012-02-12 juga memperkenalkan parameter SignedVersion (sv), yang memungkinkan generator tanda tangan akses bersama untuk menentukan versi yang akan digunakan untuk memproses permintaan. Tanda tangan akses bersama yang dihasilkan dengan versi sebelum 2012-02-12 tidak dapat menentukan versi yang akan digunakan untuk memproses permintaan, sehingga bergantung pada aturan berikut untuk otorisasi dan eksekusi API:

1. Jika permintaan memiliki header x-ms-version yang valid, versi paling awal yang valid (2009-07-17) digunakan untuk menafsirkan parameter tanda tangan akses bersama. Versi yang ditentukan oleh x-ms-version digunakan untuk melakukan operasi Blob Storage.

2. Jika permintaan tidak memiliki header x-ms-version, dan pemilik telah mengatur versi default dengan menggunakan Mengatur Properti Penyimpanan Blob, maka versi 2009-07-17 digunakan untuk menginterpretasikan parameter. Versi default yang ditentukan pemilik digunakan untuk melakukan operasi Blob Storage.

3. Jika permintaan tidak memiliki header x-ms-version, dan pemilik belum mengatur versi default, Blob Storage menggunakan versi paling awal yang valid (2009-07-17) untuk menginterpretasikan parameter. Jika kontainer bersifat publik, dan pembatasan aksesnya diatur dengan operasi Set Container ACL yang menggunakan versi 2009-09-19 atau yang lebih baru, versi 2009-09-19 digunakan untuk melakukan operasi Blob Storage.

4. Jika permintaan tidak memiliki header x-ms-version, dan pemilik belum mengatur versi default, Blob Storage menggunakan versi paling awal yang valid (2009-07-17) untuk menginterpretasikan parameter. Jika pembatasan akses kontainer tidak diatur dengan operasi Set Container ACL yang menggunakan versi 2009-09-19 atau yang lebih baru, operasi Blob Storage dilakukan dengan menggunakan versi paling awal layanan.

Tabel berikut menerapkan aturan ini ke berbagai skenario, dan mengasumsikan parameter SignedVersion tidak disertakan.

Nilai header versi x-ms	Versi yang digunakan untuk menginterpretasikan parameter untuk otorisasi dan otorisasi untuk Blob Storage	Versi yang digunakan untuk melakukan operasi Blob Storage
Tidak	Versi tanda tangan akses bersama paling awal yang valid (2009-07-17)	2009-09-19 digunakan jika kontainer diatur ke publik oleh Set Container ACL dengan menggunakan versi 2009-09-19 atau yang lebih baru. Jika tidak, versi paling awal Blob Storage digunakan.
2011-08-18	Versi tanda tangan akses bersama paling awal yang valid (2009-07-17)	2011-08-18.
Versi XXXX-XX-XX apa pun	Versi tanda tangan akses bersama paling awal yang valid (2009-07-17)	Versi XXXX-XX-XX

Nota

Microsoft merekomendasikan penggunaan versi 2011-08-18 atau yang lebih baru untuk skenario yang memerlukan nilai ETag yang dikutip, atau header respons Accept-Ranges yang valid. Browser dan klien streaming lainnya memerlukan header ini untuk unduhan dan coba lagi yang efisien.

Lihat juga

Penerapan Versi untuk azure Storage