Not
Bu sayfaya erişim yetkilendirme gerektiriyor. Oturum açmayı veya dizinleri değiştirmeyi deneyebilirsiniz.
Bu sayfaya erişim yetkilendirme gerektiriyor. Dizinleri değiştirmeyi deneyebilirsiniz.
Azure Depolama birden çok sürümü destekler. Depolama hizmetlerinde istekte bulunmak için, istek anonim olmadığı sürece bu işlem için kullanmak istediğiniz sürümü belirtmeniz gerekir.
20 Temmuz 2026 itibarıyla, Azure Depolama 2026-04-06hizmetinin en son tam olarak dağıtılmış sürümü .
2026-06-06 Useast2EUAP ve UScentralEUAP'deki az sayıda kiracı hariç, küresel olarak etkinleştirilmiştir.
2026-10-06 çoğu bölgede etkinleştirilmiş ve en son beta SDK sürümü için varsayılan olarak kullanılmıştır.
SDK'ların en son GA sürümleri varsayılan olarak .2026-06-06
Aşağıdaki tablo bir bölgede etkinleştirilmiş x-ms-version olduğunu gösteriyorsa, önceki x-ms-versions tüm kişiler de etkin. Depolama hesabınızın bölgesinde tam olarak dağıtılmamış bir hizmet sürümünü kullanmaya çalışmak bir x-ms-version uyuşmazlık hatası oluşturabilir.
| Bölge | x-ms-version |
|---|---|
| asiaeast | 06-10-2026 |
| asiasoutheast | 06-10-2026 |
| australiac | 06-10-2026 |
| australiac2 | 06-10-2026 |
| australiaeast | 2026-06-06 |
| australiasoutheast | 06-10-2026 |
| austriae | 06-10-2026 |
| belgiumc | 06-10-2026 |
| brazilse | 06-10-2026 |
| brazilsouth | 06-10-2026 |
| canadacentral | 06-10-2026 |
| canadaeast | 06-10-2026 |
| chilec | 06-10-2026 |
| denmarke | 06-10-2026 |
| europenorth | 06-10-2026 |
| europewest | 2026-06-06 |
| eusslv | 06-10-2026 |
| francec | 06-10-2026 |
| frances | 06-10-2026 |
| germanyn | 06-10-2026 |
| germanywc | 06-10-2026 |
| indiacentral | 06-10-2026 |
| indiasc | 06-10-2026 |
| indiasouth | 06-10-2026 |
| indiawest | 06-10-2026 |
| indonesiac | 06-10-2026 |
| israelc | 06-10-2026 |
| israelnw | 06-10-2026 |
| italyn | 06-10-2026 |
| japaneast | 06-10-2026 |
| japanwest | 06-10-2026 |
| jioinc | 06-10-2026 |
| jioinw | 06-10-2026 |
| koreacentral | 06-10-2026 |
| koreasouth | 06-10-2026 |
| malaysias | 06-10-2026 |
| malaysiaw | 06-10-2026 |
| mexicoc | 06-10-2026 |
| newzealandn | 06-10-2026 |
| norwaye | 06-10-2026 |
| norwayw | 06-10-2026 |
| polandc | 06-10-2026 |
| qatarc | 06-10-2026 |
| southafrican | 06-10-2026 |
| southafricaw | 06-10-2026 |
| spainc | 06-10-2026 |
| swedenc | 06-10-2026 |
| swedens | 06-10-2026 |
| switzerlandn | 06-10-2026 |
| switzerlandw | 06-10-2026 |
| taiwann | 06-10-2026 |
| taiwannw | 06-10-2026 |
| uaec | 06-10-2026 |
| uaen | 06-10-2026 |
| uksouth | 06-10-2026 |
| ukwest | 06-10-2026 |
| uscentral | 2026-06-06 |
| uscentraleuap | 2026-04-06 |
| useast | 06-10-2026 |
| useast2 | 2026-06-06 |
| useast2euap | 2026-04-06 |
| kullanışlı3 | 06-10-2026 |
| usnorth | 06-10-2026 |
| USNORTHEAST5 | 06-10-2026 |
| ussouth | 06-10-2026 |
| ussouth2 | 06-10-2026 |
| ussoutheast | 06-10-2026 |
| ussoutheast3 | 06-10-2026 |
| ussoutheast5 | 06-10-2026 |
| ussouthwest | 06-10-2026 |
| uswest | 06-10-2026 |
| uswest2 | 06-10-2026 |
| uswest3 | 06-10-2026 |
| uswestcentral | 06-10-2026 |
Azure Depolama veri düzlemi SDK'ları tarafından kullanılan varsayılan değer x-ms-version , aşağıdaki tabloda yer alan değişiklik günlüklerinde bulunabilir:
Veri düzlemi Depolama SDK'ları, söz konusu sürümün varsayılan değeri x-ms-version tüm bölgelerde tam olarak kullanıma sunulana kadar diğer resmi paket akışlarında GA sürümleri gerçekleştirmez. Bu nedenle, resmi paket yöneticilerinden en son GA SDK sürümü herhangi bir bölgede güvenle kullanılabilir.
Desteklenen diğer tüm sürümlerin listesi ve her sürümü kullanma hakkında bilgi için Önceki Azure Depolama hizmeti sürümlerine bakın.
2026-10-06 hizmet versiyonu aşağıdaki özellikleri içerir:
- Yeni ve
maxresultssorgu parametreleriylemarkerDosya Listesi Aralıklarına sayfalanmış destek eklendi. - Eğer istek başlığı aşağıdaki API'ler için belirlenmişse, yanıt
x-ms-content-crc64başlığı artık gerix-ms-source-content-md5dönecektir:
İsteklerde hizmet sürümlerini belirtme
bir istek için kullanılacak depolama hizmetlerinin sürümünü nasıl belirttiğiniz, bu isteğin nasıl yetkilendirildiğini belirtir. Aşağıdaki bölümlerde yetkilendirme seçenekleri ve hizmet sürümünün her biri için nasıl belirtildiği açıklanmaktadır.
Microsoft Entra'dan OAuth 2.0 belirteci kullanan istekler: Microsoft Entra ID ile bir isteği yetkilendirmek için, isteğin üst bilgisini 2017-11-09 veya daha yüksek bir hizmet sürümüyle geçirin
x-ms-version. Daha fazla bilgi için Microsoft Entra ID ile yetkilendirme bölümündeki OAuth belirteçleriyle depolama işlemlerini çağırma bölümüne bakın.Shared Key veya Shared Key Lite kullanan istekler: Shared Key veya Shared Key Lite ile bir isteği yetkilendirmek için isteğin başlığını
x-ms-versioniletin. Azure Blob Depolama kullanırken, Blob Hizmeti Özelliklerini Ayarla'yı çağırarak tüm istekler için varsayılan sürümü belirtebilirsiniz.Paylaşılan erişim imzası (SAS) kullanan istekler: Paylaşılan erişim imzasında iki sürüm oluşturma seçeneği belirtebilirsiniz. İsteğe bağlı
api-versionüst bilgi, API işlemini yürütmek için hangi hizmet sürümünün kullanılacağını gösterir. GerekliSignedVersion (sv)parametre, SAS ile yapılan isteği yetkilendirmek için kullanılacak hizmet sürümünü belirtir.api-versionÜst bilgi belirtilmezse, parametreninSignedVersion (sv)değeri API işlemini yürütmek için kullanılacak sürümü de gösterir.Anonim erişim kullanan istekler: Blob Depolama'da anonim erişim kullanılırken hiçbir sürüm geçirilmez. İstek için hangi sürümün kullanılacağını belirlemeye yönelik buluşsal yöntemler sonraki bölümlerde açıklanmıştır.
Microsoft Entra ID, Shared Key veya Shared Key Lite kullanarak istekleri yetkilendirme
Microsoft Entra ID, Shared Key veya Shared Key Lite ile bir isteği yetkilendirmek için istekte üst bilgiyi belirtin x-ms-version .
x-ms-version İstek üstbilgisi değeri YYYY-AA-GG biçiminde belirtilmelidir. Örneğin:
Request Headers:
x-ms-version: 2020-04-08
Aşağıdaki kurallar, isteği işlemek için hangi sürümün kullanılacağını belirlemek için bu isteklerin nasıl değerlendirildiğini açıklar.
Bir isteğin geçerli
x-ms-versionbir üst bilgisi varsa, depolama hizmeti belirtilen sürümü kullanır. Paylaşılan erişim imzası kullanmayan Azure Tablo Depolama ve Azure Kuyruk Depolama tüm isteklerde birx-ms-versionüst bilgi belirtilmelidir. Paylaşılan erişim imzası kullanmayan Blob Depolama'ya yönelik tüm istekler, sonraki paragrafta açıklandığı gibi varsayılan sürüm ayarlanmadığı sürece birx-ms-versionüst bilgi belirtmelidir.Blob Depolama isteği üst
x-ms-versionbilgi içermiyorsa ancak hesap sahibi Blob Hizmeti Özelliklerini Ayarla işlemini kullanarak varsayılan bir sürüm ayarlıyorsa, isteğin sürümü olarak belirtilen varsayılan sürüm kullanılır.
Paylaşılan erişim imzası kullanarak istekleri yetkilendirme
Sürüm 2014-02-14 veya üzeri kullanılarak oluşturulan paylaşılan erişim imzası (SAS) iki sürüm oluşturma seçeneğini destekler:
Sorgu
api-versionparametresi, SAS kullanılarak yapılan bir isteği işlemek için kullanılacak REST protokolü sürümünü tanımlar.Sorgu
SignedVersion (sv)parametresi, yetkilendirme için kullanılacak SAS sürümünü tanımlar.
Sorgu SignedVersion parametresi, bir istemci SAS kullanarak bir istekte bulunduğunda yetkilendirme için kullanılır. , , , si, srspsigstsetnspkve srk gibi epkyetkilendirme parametrelerinin tümü belirtilen sürüm kullanılarak yorumlanır. erk
, rscc, , rscdrsceve gibi rsclREST protokol parametreleri, parametre rsct başlığında api-version sağlanan sürüm kullanılarak zorlanır.
api-version Üst bilgi belirtilmezse, için SignedVersion sağlanan hizmet sürümü kullanılır.
Parametre api-version , Hizmet SAS'si oluşturma bölümünde açıklandığı gibi yetkilendirme üst bilgisindeki imzalanacak dizenin bir parçası değildir.
Aşağıdaki tabloda, parametre 2014-02-14 veya sonraki bir sürüme ayarlandığında hizmet tarafından yetkilendirme ve REST protokolünü çağırmak için kullanılan sürüm oluşturma şeması SignedVersion açıklanmaktadır.
| api-version parametresinin değeri | Yetkilendirme için kullanılan sürüm | Protokol davranışı için kullanılan sürüm |
|---|---|---|
| Belirtilmemiş | Parametrede sv belirtilen sürüm |
Parametrede sv belirtilen sürüm |
Biçimdeki herhangi bir geçerli depolama hizmetleri sürümü XXXX-XX-XX |
Parametrede sv belirtilen sürüm |
Geçerli depolama hizmetleri sürümü XXXX-XX-XX |
Örnek 1
Aşağıdaki örnek istek, parametresi ile ve parametresi olmadan sv=2015-04-05 çağırırapi-version.
https://myaccount.blob.core.windows.net/mycontainer?restype=container&comp=list&sv=2015-04-05&si=readpolicy&sig=a39 %2BYozJhGp6miujGymjRpN8tsrQfLo9Z3i8IRyIpnQ%3d
Bu durumda hizmet, 2015-04-05 sürümünü kullanarak isteğin kimliğini doğrular ve yetkisini alır ve işlemi 2015-04-05 sürümünü kullanarak çalıştırır.
Örnek 2
Aşağıdaki örnek istek, parametresiyle ve parametresiyle sv=2015-04-05api-version çağırır.
https://myaccount.blob.core.windows.net/mycontainer?restype=container&comp=list&sv=2015-04-05&si=readpolicy&sig=a39 %2BYozJhGp6miujGymjRpN8tsrQfLo9Z3i8IRyIpnQ%3d&api-version=2012-02-12
Burada hizmet, isteği 2015-04-05 sürümünü kullanarak yetkiler ve 2012-02-12 sürümünü kullanarak işlemi çalıştırır.
Note
.NET Depolama istemci kitaplığı her zaman REST protokol sürümünü (parametrede api-version ) temel sürüme ayarlar.
Anonim erişim yoluyla istekler
Anonim erişim yoluyla yapılan istekler, yapılan depolama hesabının türüne bağlı olarak farklı şekilde işlenir.
Genel amaçlı depolama hesapları
Genel amaçlı bir depolama hesabına yönelik anonim bir istek üst bilgiyi belirtmezse x-ms-version ve hizmetin varsayılan sürümü Blob Hizmeti Özelliklerini Ayarla kullanılarak ayarlanmamışsa, hizmet isteği işlemek için mümkün olan en eski sürümü kullanır. Kapsayıcı, 2009-09-19 veya sonraki bir sürüm kullanılarak Kapsayıcı ACL'sini Ayarla işlemi kullanılarak genel hale getirildiyse, istek 2009-09-19 sürümü kullanılarak işlenir.
Blob Depolama hesapları için
Blob Depolama hesabına yönelik anonim bir istek üst bilgiyi belirtmezse x-ms-version ve hizmetin varsayılan sürümü Blob Hizmeti Özelliklerini Ayarla kullanılarak ayarlanmamışsa, hizmet isteği işlemek için mümkün olan en erken sürümü kullanır. Blob Depolama hesabı için mümkün olan en erken sürüm 2014-02-14'dür.
Bilinen sorunlar
Bu bölümde Azure Depolama REST API'leri ile ilgili bilinen sorunlar ayrıntılı olarak açıklanmaktadır.
InvalidHeaderValue hata mesajı
Nadir senaryolarda, doğrudan REST API çağrıları yapan uygulamalar bir InvalidHeaderValue hata iletisi alabilir. Hata aşağıdaki örneğe benzer:
HTTP/1.1 400 The value for one of the HTTP headers is not in the correct format.
Content-Length: 328
Content-Type: application/xml
Server: Microsoft-HTTPAPI/2.0
x-ms-request-id: <REMOVED>
Date: Fri, 19 May 2023 17:10:33 GMT
<?xml version="1.0" encoding="utf-8"?><Error><Code>InvalidHeaderValue</Code><Message>The value for one of the HTTP headers is not in the correct format.
RequestId:<REMOVED>
Time:2023-05-19T17:10:34.2972651Z</Message><HeaderName>x-ms-version</HeaderName><HeaderValue>yyyy-mm-dd</HeaderValue></Error>
Sorunu çözmeye çalışmak için önceki bir REST API sürümünün kullanılması önerilir. Sorun devam ederse veya öneri mümkün değilse, daha fazla seçeneği görüşmek için destek bileti açın .