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 2023-11-03, dan menggunakan versi tersebut direkomendasikan jika memungkinkan. Untuk informasi tentang versi terbaru, lihat Penerapan versi untuk Azure Storage.

Versi tambahan yang didukung meliputi:

• 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 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 SignedVersion (sv) parameter . SignedVersion menunjukkan versi layanan yang digunakan untuk otorisasi dan untuk memanggil operasi API. x-ms-version Jika header diteruskan pada permintaan, header akan diabaikan. Hanya parameter yang SignedVersion (sv) menentukan versi layanan yang akan digunakan untuk memproses permintaan yang dibuat melalui tanda tangan akses bersama.

Catatan

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:

SignedVersion (sv) Nilai parameter	Layanan yang didukung
11-12-2015	Semua (Azure Blob Storage, Azure Queue Storage, Azure Table Storage, dan Azure Files)
05-04-2015	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	Blob Storage, Queue Storage, dan Table Storage
2013-08-15	Blob Storage, Queue Storage, dan Table Storage
2012-02-12	Blob Storage, Queue Storage, dan Table Storage

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 Url elemen di bawah Blob elemen , 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. Table Storage dan Queue Storage 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 SignedVersion (sv) parameter , 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 yang valid x-ms-version , versi paling awal yang valid (2009-07-17) digunakan untuk menginterpretasikan parameter tanda tangan akses bersama. Versi yang ditentukan oleh x-ms-version digunakan untuk melakukan operasi Blob Storage.

2. Jika permintaan tidak memiliki x-ms-version header, dan pemilik telah mengatur versi default dengan menggunakan Atur 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 x-ms-version header, 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 x-ms-version header, 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 ACL Atur Kontainer 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 SignedVersion parameter tidak disertakan.

Nilai header x-ms-version	Versi yang digunakan untuk menginterpretasikan parameter untuk otorisasi dan otorisasi untuk Blob Storage	Versi yang digunakan untuk melakukan operasi Blob Storage
Tidak ada	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

Catatan

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

Lihat juga

Penerapan versi untuk Azure Storage