Hizmet SAS örnekleri

  • Makale

Bu konuda, REST API ile paylaşılan erişim imzalarının örnek kullanımları gösterilmektedir. Paylaşılan erişim imzaları kapsayıcılara ve bloblara, tablolara, kuyruklara veya dosyalara erişim hakları sağlamanıza olanak sağlar. Paylaşılan erişim imzası sağlayarak, kullanıcılara belirli bir süre boyunca belirli bir kapsayıcı, blob, kuyruk, tablo veya tablo varlık aralığına kısıtlı erişim vererek. Paylaşılan erişim imzalarını oluşturma, ayrıştırma ve kullanmayla ilgili tüm ayrıntılar için bkz. Paylaşılan Erişim İmzası ile Erişimi Temsilci Olarak Belirleme. Paylaşılan erişim imzaları oluşturmak için .NET depolama istemci kitaplığını kullanma hakkında bilgi için bkz. Paylaşılan Erişim İmzası Oluşturma ve Kullanma.

Blob Örnekleri

Bu bölüm, bloblardaki REST işlemleri için paylaşılan erişim imzalarını gösteren örnekler içerir.

Örnek: Kapsayıcının Paylaşılan Erişim İmzasını Kullanarak Blob Alma

2013-08-15 Öncesi Sürümler

Aşağıdaki örnekte, bir kapsayıcıda okuma erişimi için paylaşılan erişim imzası oluşturma gösterilmektedir.

URL'yi içerecek imzalı imza alanları şunlardır:

signedstart=2009-02-09  
signedexpiry=2009-02-10  
signedresource=c  
signedpermissions=r  
signature=dD80ihBh5jfNpymO5Hg1IdiJIEvHcJpCMiCMnN/RnbI=  
signedidentifier=YWJjZGVmZw==  
signedversion=2012-02-12

İmza aşağıdaki gibi oluşturulur:

StringToSign = r + \n   
               2009-02-09 + \n  
               2009-02-10 + \n  
               /myaccount/pictures + \n  
               YWJjZGVmZw== + \n  
               2012-02-12  
  
HMAC-SHA256(URL.Decode(UTF8.Encode(StringToSign))) = dD80ihBh5jfNpymO5Hg1IdiJIEvHcJpCMiCMnN/RnbI=

İstek URL'si, belirlenen aralık için kapsayıcı üzerindeki pictures okuma izinlerini belirtir. İstek URL'si tarafından temsil edilen kaynak bir blobdur, ancak kapsayıcıda paylaşılan erişim imzası belirtilir. Blob üzerinde de belirtebilirsiniz.

GET https://myaccount.blob.core.windows.net/pictures/profile.jpg?sv=2012-02-12&st=2009-02-09&se=2009-02-10&sr=c&sp=r&si=YWJjZGVmZw%3d%3d&sig=dD80ihBh5jfNpymO5Hg1IdiJIEvHcJpCMiCMnN%2fRnbI%3d   
HTTP/1.1  
Host: myaccount.blob.core.windows.net  
x-ms-date: <date>

Sürüm 2013-08-15 ve Üzeri

Aşağıdaki örnekte, depolama hizmetlerinin 2013-08-15 sürümünü kullanarak bir kapsayıcıda okuma erişimi için paylaşılan erişim imzası oluşturma gösterilmektedir.

Sürüm 2013-08-15, isteği veren istemcinin yalnızca bu paylaşılan erişim imzası için yanıt üst bilgilerini geçersiz kılmasını sağlayan yeni sorgu parametreleri sunar.

Yanıt üst bilgileri ve karşılık gelen sorgu parametreleri aşağıdaki gibidir:

Yanıt üst bilgisi adı Karşılık gelen SAS sorgu parametresi
Cache-Control rscc
Content-Disposition rscd
Content-Encoding rsce
Content-Language rscl
Content-Type rsct

İmza için imza dizesinden imzaya kadar olan alanlar şunlardır:

signedstart=2013-08-16  
signedexpiry=2013-08-17  
signedresource=c  
signedpermissions=r  
signedidentifier=YWJjZGVmZw==  
signedversion=2013-08-15  
responsecontent-disposition=file; attachment  
responsecontent-type=binary

dizeden imzaya aşağıdaki gibi oluşturulur:

StringToSign = r + \n   
               2013-08-16 + \n  
               2013-08-17 + \n  
               /myaccount/pictures + \n  
               YWJjZGVmZw== + \n  
               2013-08-15 + \n  
               + \n    
               file; attachment + \n  
               + \n  
               + \n  
               binary  
  
HMAC-SHA256(URL.Decode(UTF8.Encode(StringToSign))) = a39+YozJhGp6miujGymjRpN8tsrQfLo9Z3i8IRyIpnQ=

Paylaşılan erişim imzası, belirlenen aralık için resimler kapsayıcısı üzerindeki okuma izinlerini belirtir. İstek URL'si tarafından temsil edilen kaynak bir blobdur, ancak kapsayıcıda paylaşılan erişim imzası belirtilir. Blob üzerinde de belirtebilirsiniz.

GET https://myaccount.blob.core.windows.net/pictures/profile.jpg?sv=2013-08-15&st=2013-08-16&se=2013-08-17&sr=c&sp=r&rscd=file;%20attachment&rsct=binary &sig=YWJjZGVmZw%3d%3d&sig=a39%2BYozJhGp6miujGymjRpN8tsrQfLo9Z3i8IRyIpnQ%3d HTTP/1.1

Bu imzayla istekte bulunan bir istemci için, aşağıdaki ölçütler karşılanırsa Blob Al işlemi yürütülür:

  • İstek başarıyla yetkilendirildi.

  • İstek, paylaşılan erişim imzası tarafından belirtilen zaman çerçevesi içinde yapılır.

  • İstek, ilişkili bir depolanmış erişim ilkesinin herhangi bir terimini ihlal etmez.

  • İstek (/myaccount/pictures/profile.jpg) tarafından belirtilen blob, imzalı kaynak (/myaccount/pictures) olarak belirtilen kapsayıcıda bulunur.

Paylaşılan erişim imzasında ve rscd=file; attachment belirtilmesirsct=binary, yanıttaki içerik türü ve içerik bırakma üst bilgilerini sırasıyla geçersiz kılar.

Bu paylaşılan erişim imzası kullanılarak yapılan bir istek için başarılı bir yanıt aşağıdakine benzer olacaktır:

Status Response:  
HTTP/1.1 200 OK  
  
Response Headers:  
x-ms-blob-type: BlockBlob  
Content-Length: 11  
Content-Type: binary  
Content-Disposition: file; attachment  
ETag: "0x8CB171DBEAD6A6B"  
x-ms-version: 2013-08-15  
Server: Windows-Azure-Blob/1.0 Microsoft-HTTPAPI/2.0

Örnek: Kapsayıcının Paylaşılan Erişim İmzasını Kullanarak Blob Yükleme

Aşağıdaki örnekte blob yazmak için paylaşılan erişim imzasının nasıl oluşturulduğu gösterilmektedir. Bu örnekte, kapsayıcıdaki tüm bloblar için yazma izinleri veren bir imza oluştururuz. Ardından kapsayıcıdaki bir bloba yazmak için paylaşılan erişim imzasını kullanırız.

URL'yi içerecek imzalı alanlar şunlardır:

  
signedstart=2015-07-01T08:49Z  
signedexpiry=2015-07-02T08:49Z  
signedresource=c  
signedpermissions=w  
signedidentifier=YWJjZGVmZw==  
signedversion=2015-02-21

İmza aşağıdaki gibi oluşturulur:

  
StringToSign = w + \n   
               2015-07-01T08:49Z + \n  
               2015-07-02T08:49Z + \n  
               /myaccount/pictures + \n  
               YWJjZGVmZw== + \n  
               2013-08-15  
  
HMAC-SHA256(URL.Decode(UTF8.Encode(StringToSign))) = Rcp6gQRfV7WDlURdVTqCa+qEArnfJxDgE+KH3TCChIs=

İstek URL'si, belirlenen aralık için kapsayıcı üzerinde pictures yazma izinlerini belirtir. İstek URL'si tarafından temsil edilen kaynak bir blobdur, ancak kapsayıcıda paylaşılan erişim imzası belirtilir. Blob üzerinde de belirtebilirsiniz.

PUT https://myaccount.blob.core.windows.net/pictures/photo.jpg?sv=2015-02-21&st=2015-07-01T08%3a49Z&se=2015-07-02T08%3a49Z&  
sr=c&sp=w&si=YWJjZGVmZw%3d%3d&sig=Rcp6gQRfV7WDlURdVTqCa%2bqEArnfJxDgE%2bKH3TCChIs%3d HTTP/1.1  
Host: myaccount.blob.core.windows.net  
  
Content-Length: 12  
  
Hello World.

Bu imzayla, aşağıdaki ölçütler karşılanırsa Blob Yerleştir çağrılır:

  • İstek başarıyla yetkilendirildi.

  • İstek, paylaşılan erişim imzası tarafından belirtilen zaman çerçevesi içinde yapılır.

  • İstek, ilişkili bir depolanmış erişim ilkesinin herhangi bir terimini ihlal etmez.

  • İstek (/myaccount/pictures/photo.jpg) tarafından belirtilen blob, imzalı kaynak (/myaccount/pictures) olarak belirtilen kapsayıcıdadır.

Örnek: Blob'un Paylaşılan Erişim İmzasını Kullanarak Blob Silme

Aşağıdaki örnekte, blob için silme izinleri veren ve bir blobu silerek paylaşılan erişim imzası oluşturma işlemi gösterilmektedir.

Dikkat

Bir istemcinin verileri silmesine izin verilmesi istenmeyen sonuçlara neden olabileceği için, DELETE işlemi için paylaşılan erişim imzalarının rastgele dağıtılması gerektiğini unutmayın.

URL'yi içerecek imzalı imza alanları şunlardır:

  
signedstart=2015-07-01T08:49:37.0000000Z  
signedexpiry=2015-07-02T08:49:37.0000000Z  
signedresource=b  
signedpermissions=d  
signature=+SzBm0wi8xECuGkKw97wnkSZ/62sxU+6Hq6a7qojIVE=  
signedidentifier=YWJjZGVmZw==  
signedversion=2015-02-21

İmza aşağıdaki gibi oluşturulur:

  
StringToSign = d + \n   
               2015-07-01T08:49:37.0000000Z + \n  
               2015-07-02T08:49:37.0000000Z + \n  
               blob/myaccount/pictures/profile.jpg + \n  
               YWJjZGVmZw==  
               2015-02-21  
  
HMAC-SHA256(URL.Decode(UTF8.Encode(StringToSign))) = +SzBm0wi8xECuGkKw97wnkSZ/62sxU+6Hq6a7qojIVE=

İstek URL'si, belirlenen aralık için resimler kapsayıcısı üzerindeki silme izinlerini belirtir. İstek URL'si tarafından temsil edilen kaynak bir blobdur ve paylaşılan erişim imzası bu blobda belirtilir. Kapsayıcıdaki herhangi bir blobu silme izni vermek için blob kapsayıcısında da belirtebilirsiniz.

  
DELETE https://myaccount.blob.core.windows.net/pictures/profile.jpg?sv=2015-02-21&st=2015-07-01T08%3a49%3a37.0000000Z&se=2015-07-02T08%3a49%3a37.0000000Z&sr=b&sp=d&si=YWJjZGVmZw%3d%3d&sig=%2bSzBm0wi8xECuGkKw97wnkSZ%2f62sxU%2b6Hq6a7qojIVE%3d HTTP/1.1  
Host: myaccount.blob.core.windows.net  
Content-Length: 0

Bu imzayla, aşağıdaki ölçütler karşılanırsa Blobu Sil çağrılır:

  • İstek başarıyla yetkilendirildi.

  • İstek, paylaşılan erişim imzası tarafından belirtilen zaman çerçevesi içinde yapılır.

  • İstek, ilişkili bir depolanmış erişim ilkesinin herhangi bir terimini ihlal etmez.

  • İstek (/myaccount/pictures/profile.jpg) tarafından belirtilen blob, imzalı kaynak olarak belirtilen blobla eşleşir.

Dosya Örnekleri

Bu bölüm, dosyalardaki REST işlemleri için paylaşılan erişim imzalarını gösteren örnekler içerir.

Örnek: Paylaşımın Paylaşılan Erişim İmzasını Kullanarak Dosya Alma

Aşağıdaki örnekte, paylaşımda okuma erişimi için paylaşılan erişim imzası oluşturma gösterilmektedir.

Az sayıda sorgu parametresi, isteği veren istemcinin bu paylaşılan erişim imzası için yanıt üst bilgilerini geçersiz kılabilmesini sağlayabilir.

Yanıt üst bilgileri ve karşılık gelen sorgu parametreleri aşağıdaki gibidir:

Yanıt üst bilgisi adı Karşılık gelen SAS sorgu parametresi
Cache-Control rscc
Content-Disposition rscd
Content-Encoding rsce
Content-Language rscl
Content-Type rsct

İmza için imza dizesinden imzaya kadar olan alanlar şunlardır:

signedstart=2015-07-01T08:49Z  
signedexpiry=2015-07-02T08:49Z  
signedresource=c  
signedpermissions=r  
signature=dD80ihBh5jfNpymO5Hg1IdiJIEvHcJpCMiCMnN/RnbI=  
signedidentifier=YWJjZGVmZw==  
signedversion=2015—02-21  
responsecontent-disposition=file; attachment  
responsecontent-type=binary

dizeden imzaya aşağıdaki gibi oluşturulur:

StringToSign = r + \n   
               2015-07-01T08:49Z + \n  
               2015-07-02T08:49Z + \n  
               file/myaccount/pictures + \n  
               YWJjZGVmZw== + \n  
               2015—02-21 + \n  
               + \n    
               file; attachment + \n  
               + \n  
               + \n  
               binary  
  
HMAC-SHA256(URL.Decode(UTF8.Encode(StringToSign))) = a39+YozJhGp6miujGymjRpN8tsrQfLo9Z3i8IRyIpnQ=

Paylaşılan erişim imzası, belirlenen aralık için paylaşımda pictures okuma izinlerini belirtir. İstek URL'si tarafından temsil edilen kaynak bir dosyadır, ancak paylaşımda paylaşılan erişim imzası belirtilir. Dosyanın kendisinde de belirtebilirsiniz.

GET https://myaccount.file.core.windows.net/pictures/profile.jpg?sv=2015-02-21&st=2015-07-01T08:49Z&se=2015-07-02T08:49Z&sr=c&sp=r&rscd=file;%20attachment&rsct=binary&sig=YWJjZGVmZw%3d%3d&sig=a39%2BYozJhGp6miujGymjRpN8tsrQfLo9Z3i8IRyIpnQ%3d

Bu imzayla istekte bulunan bir istemci için, aşağıdaki ölçütler karşılanırsa Dosya Al işlemi yürütülür:

  • İstek başarıyla yetkilendirildi.

  • İstek, paylaşılan erişim imzası tarafından belirtilen zaman çerçevesi içinde yapılır.

  • İstek, ilişkili bir depolanmış erişim ilkesinin herhangi bir terimini ihlal etmez.

  • İstek ( /myaccount/pictures/profile.jpg) tarafından belirtilen dosya, imzalı kaynak (/myaccount/pictures) olarak belirtilen paylaşımda bulunur.

Paylaşılan erişim imzasında ve belirtilmesirsct=binary, yanıttaki ve content-disposition üst bilgilerini sırasıyla geçersiz kılarcontent-type.rscd=file; attachment

Bu paylaşılan erişim imzası kullanılarak yapılan bir istek için başarılı bir yanıt aşağıdakine benzer olacaktır:

Status Response:  
HTTP/1.1 200 OK  
  
Response Headers:  
Content-Length: 11  
Content-Type: binary  
Content-Disposition: file; attachment  
ETag: "0x8CB171DBEAD6A6B"  
x-ms-version: 2015-02-21  
Server: Windows-Azure-Blob/1.0 Microsoft-HTTPAPI/2.0

Örnek: Paylaşımda Paylaşılan Erişim İmzası Kullanarak Dosya Yükleme

Aşağıdaki örnekte, dosya yazmak için paylaşılan erişim imzasının nasıl oluşturulduğu gösterilmektedir. Bu örnekte, paylaşımdaki tüm dosyalar için yazma izinleri veren bir imza oluştururuz. Ardından paylaşımdaki bir dosyaya yazmak için paylaşılan erişim imzasını kullanırız.

URL'yi içerecek imzalı imza alanları şunlardır:

signedstart=2015-07-01T08:49Z  
signedexpiry=2015-07-02T08:49Z  
signedresource=c  
signedpermissions=w  
signature=Rcp6gQRfV7WDlURdVTqCa+qEArnfJxDgE+KH3TCChIs=  
signedidentifier=YWJjZGVmZw==  
signedversion=2015-02-21

İmza aşağıdaki gibi oluşturulur:

StringToSign = w + \n   
               2015-07-01T08:49Z + \n  
               2015-07-02T08:49Z + \n  
               file/myaccount/pictures + \n  
               YWJjZGVmZw== + \n  
               2015-02-21  
  
HMAC-SHA256(URL.Decode(UTF8.Encode(StringToSign))) = Rcp6gQRfV7WDlURdVTqCa+qEArnfJxDgE+KH3TCChIs=

İstek URL'si, belirlenen aralık için kapsayıcı üzerinde pictures yazma izinlerini belirtir. İstek URL'si tarafından temsil edilen kaynak bir blobdur, ancak kapsayıcıda paylaşılan erişim imzası belirtilir. Blob üzerinde de belirtebilirsiniz.

PUT https://myaccount.file.core.windows.net/pictures/photo.jpg?sv=2015-02-21&st=2015-07-01T08%3a49Z&se=2015-07-01T08%3a49Z&  
sr=c&sp=w&si=YWJjZGVmZw%3d%3d&sig=Rcp6gQRfV7WDlURdVTqCa%2bqEArnfJxDgE%2bKH3TCChIs%3d HTTP/1.1  
Host: myaccount.blob.core.windows.net  
Content-Length: 12  
  
Hello World.

Bu imzayla, aşağıdaki ölçütler karşılanırsa Dosya Oluştur çağrılır:

  • İstek başarıyla yetkilendirildi.

  • İstek, paylaşılan erişim imzası tarafından belirtilen zaman çerçevesi içinde yapılır.

  • İstek, ilişkili bir saklı erişim ilkesinin herhangi bir terimini ihlal etmez.

  • İstek (/myaccount/pictures/photo.jpg) tarafından belirtilen dosya, imzalı kaynak (/myaccount/pictures) olarak belirtilen paylaşımdadır.

Örnek: Dosyanın Paylaşılan Erişim İmzasını Kullanarak Dosya Silme

Aşağıdaki örnekte, bir dosya için silme izinleri veren ve ardından paylaşılan erişim imzasını kullanarak dosyayı silecek paylaşılan erişim imzası oluşturma işlemi gösterilmektedir.

Dikkat

Bir istemcinin verileri silmesine izin vermek istenmeyen sonuçlara neden olabileceği için, DELETE işlemi için paylaşılan erişim imzası akıllıca dağıtılmalıdır.

URL'yi içerecek imzalı imza alanları şunlardır:

signedstart=2015-07-01T08:49:37.0000000Z  
signedexpiry=2015-07-02T08:49:37.0000000Z  
signedresource=b  
signedpermissions=d  
signature=+SzBm0wi8xECuGkKw97wnkSZ/62sxU+6Hq6a7qojIVE=  
signedidentifier=YWJjZGVmZw==  
signedversion=2015-02-21

İmza aşağıdaki gibi oluşturulur:

StringToSign = d + \n   
               2015-07-01T08:49:37.0000000Z + \n  
               2015-07-02T08:49:37.0000000Z + \n  
               file/myaccount/pictures/profile.jpg + \n  
               YWJjZGVmZw==  
               2015-02-21  
  
HMAC-SHA256(URL.Decode(UTF8.Encode(StringToSign))) = +SzBm0wi8xECuGkKw97wnkSZ/62sxU+6Hq6a7qojIVE=

İstek URL'si, belirlenen aralık için resim paylaşımındaki silme izinlerini belirtir. İstek URL'si tarafından temsil edilen kaynak bir dosyadır ve paylaşılan erişim imzası bu dosyada belirtilir. Paylaşımdaki herhangi bir dosyayı silme izni vermek için dosya paylaşımında bunu belirtmek de mümkündür.

DELETE https://myaccount.file.core.windows.net/pictures/profile.jpg?sv=2015-02-21&st=2015-07-01T08%3a49%3a37.0000000Z&se=2015-07-02T08%3a49%3a37.0000000Z&sr=b&sp=d&si=YWJjZGVmZw%3d%3d&sig=%2bSzBm0wi8xECuGkKw97wnkSZ%2f62sxU%2b6Hq6a7qojIVE%3d HTTP/1.1  
Host: myaccount.blob.core.windows.net  
Content-Length: 0

Bu imzayla, aşağıdaki ölçütler karşılanırsa Dosyayı Sil çağrılır:

  • İstek başarıyla yetkilendirildi.

  • İstek, paylaşılan erişim imzası tarafından belirtilen zaman çerçevesi içinde yapılır.

  • İstek, ilişkili bir saklı erişim ilkesinin herhangi bir terimini ihlal etmez.

  • İstek (/myaccount/pictures/profile.jpg) tarafından belirtilen dosya, imzalı kaynak olarak belirtilen dosyayla eşleşir.

Kuyruk Örnekleri

Bu bölüm, kuyruklardaki REST işlemleri için paylaşılan erişim imzalarını gösteren örnekler içerir. Bu örneklerde Kuyruk hizmeti işlemi yalnızca aşağıdaki ölçütler karşılandığında çalıştırılır:

  • İstek başarıyla yetkilendirildi.

  • İstek, paylaşılan erişim imzası tarafından belirtilen zaman çerçevesi içinde yapılır.

  • İstek, ilişkili bir saklı erişim ilkesinin herhangi bir terimini ihlal etmez.

  • İstek tarafından belirtilen kuyruk, paylaşılan erişim imzası tarafından yetkilendirilen kuyrukla aynıdır.

Örnek: Paylaşılan Erişim İmzası kullanarak İleti alma

Aşağıdaki örnekte, kuyruktan ileti almak için paylaşılan erişim imzası oluşturma işlemi gösterilmektedir. Bu imza kuyruk için ileti işleme izinleri verir. Son olarak, bu örnek kuyruktan bir ileti almak için paylaşılan erişim imzasını kullanır.

aşağıdaki imza alanlarını, imzaya dizenin oluşturulmasını ve istek yetkilendirildikten sonra İleti Al işlemini çağıran URL'nin oluşturulmasını inceleyin:

signedstart=2015-07-01T08:49Z  
signedexpiry=2015-07-02T08:49Z  
signedpermissions=p  
signature=+SzBm0wi8xECuGkKw97wnkSZ/62sxU+6Hq6a7qojIVE=  
signedidentifier=YWJjZGVmZw==   
signedversion=2015-02-21  
  
StringToSign = p + \n   
               2015-07-01T08:49Z + \n  
               2015-07-02T08:49Z + \n  
               queue/myaccount/myqueue + \n  
               YWJjZGVmZw== + \n  
               2015-02-21  
  
GET https://myaccount.queue.core.windows.net/myqueue/messages?visibilitytimeout=120&sv=2015-02-21&st=2015-07-01T08%3a49Z&se=2015-07-02T08%3a49Z&sp=p&si=YWJjZGVmZw%3d%3d&sig=jDrr6cna7JPwIaxWfdH0tT5v9dc%3d HTTP/1.1  
Host: myaccount.queue.core.windows.net

Örnek: Paylaşılan Erişim İmzası Kullanarak İleti Ekleme

Aşağıdaki örnekte, kuyruğa ileti eklemek için paylaşılan erişim imzası oluşturma adımları gösterilmektedir. Bu imza kuyruk için ekleme izinleri verir. Son olarak, bu örnekte ileti eklemek için imza kullanılır.

Aşağıdaki imzalı imza alanlarını, StringToSign dizesinin oluşturulmasını ve istek yetkilendirildikten sonra İleti Koy işlemini çağıran URL'nin oluşturulmasını inceleyin:

signedstart=2015-07-01T08:49Z  
signedexpiry=2015-07-02T08:49Z  
signedpermissions=a  
signature= +SzBm0wi8xECuGkKw97wnkSZ/62sxU+6Hq6a7qojIVE=  
signedidentifier=YWJjZGVmZw==
signedversion=2015-02-21  
  
StringToSign = a + \n
               2015-07-01T08:49Z + \n  
               2015-07-02T08:49Z + \n  
               queue/myaccount/myqueue + \n  
               YWJjZGVmZw== + \n  
               2015-02-21  
  
POST https://myaccount.queue.core.windows.net/myqueue/messages?visibilitytimeout=120&sv=2015-02-21&st=2015-07-01T08%3a49Z&se=2015-07-02T08%3a49Z&sp=a&si=YWJjZGVmZw%3d%3d&sig=jDrr6cna7JPwIaxWfdH0tT5v9dc%3d HTTP/1.1  
Host: myaccount.queue.core.windows.net  
Content-Length: 100  
  
<QueueMessage>  
<MessageText>PHNhbXBsZT5zYW1wbGUgbWVzc2FnZTwvc2FtcGxlPg==</MessageText>  
</QueueMessage>

Örnek: Paylaşılan Erişim İmzası Kullanarak İletilere Göz Atma ve İleti Alma

Aşağıdaki örnekte, bir kuyruktaki sonraki iletiye göz atmak ve kuyruğun ileti sayısını almak için paylaşılan erişim imzası oluşturma işlemi gösterilmektedir. Bu imza kuyruk için okuma izinleri verir. Son olarak, bu örnek paylaşılan erişim imzasını kullanarak bir iletiye göz atıp ileti sayısını içeren kuyruklar meta verilerini okur.

Aşağıdaki imzalı imza alanlarını, imzaya dizenin oluşturulmasını ve İletilere Göz Atma ve Kuyruk Meta Verilerini Alma işlemlerini çağıran URL'nin oluşturulmasını inceleyin:

signedstart=2015-07-01T08:49Z  
signedexpiry=2015-07-02T08:49Z  
signedpermissions=r  
signature=+SzBm0wi8xECuGkKw97wnkSZ/62sxU+6Hq6a7qojIVE=  
signedidentifier=YWJjZGVmZw==
signedversion=2015-02-21  
  
StringToSign = r + \n
               2015-07-01T08:49Z + \n  
               2015-07-02T08:49Z + \n  
               queue/myacccount/myqueue + \n  
               YWJjZGVmZw== + \n  
               2015-02-21  
  
GET https://myaccount.queue.core.windows.net/myqueue/messages?peekonly=true&sv=2015-02-21&st=2015-07-01T08%3a49Z&se=2015-07-02T08%3a49Z&sp=r&si=YWJjZGVmZw%3d%3d&sig=jDrr6cna7JPwIaxWfdH0tT5v9dc%3d HTTP/1.1  
Host: myaccount.queue.core.windows.net  
  
GET https://myaccount.queue.core.windows.net/myqueue?comp=metadata&sv=2015-02-21&st=2015-07-01T08%3a49Z&se=2015-07-01T08%3a49Z&sp=r&si=YWJjZGVmZw%3d%3d&sig=jDrr6cna7JPwIaxWfdH0tT5v9dc%3d HTTP/1.1  
Host: myaccount.queue.core.windows.net

Tablo Örnekleri

Bu bölüm, tablolardaki REST işlemleri için paylaşılan erişim imzalarını gösteren örnekler içerir. Bu örneklerde Tablo hizmeti işlemi yalnızca aşağıdaki ölçütler karşılandığında çalıştırılır:

  • İstek başarıyla yetkilendirildi.

  • İstek, paylaşılan erişim imzası tarafından belirtilen zaman çerçevesi içinde yapılır.

  • İstek, ilişkili bir saklı erişim ilkesinin herhangi bir terimini ihlal etmez.

  • İstek tarafından belirtilen kuyruk, paylaşılan erişim imzası tarafından yetkilendirilen kuyrukla aynıdır.

Örnek: Paylaşılan Erişim İmzası Kullanarak Tablo Sorgulama

Aşağıdaki örnekte, bir tablodaki varlıkları sorgulamak için paylaşılan erişim imzası oluşturma gösterilmektedir. İmza, tablodaki belirli bir aralık için sorgu izinleri verir. Son olarak, bu örnek aralıktaki varlıkları sorgulamak için paylaşılan erişim imzasını kullanır.

Aşağıdaki imzalı imza alanlarını, StringToSign dizesinin oluşturulmasını ve Sorgu Varlıkları işlemini çağıran URL'nin oluşturulmasını inceleyin. Bu Sorgu Varlıkları işleminin sonuçları yalnızca , , startrkendpkve endrktarafından startpktanımlanan aralıktaki varlıkları içerir.

signedstart=2015-07-01T08:49Z  
signedexpiry=2015-07-02T08:49Z  
signedpermissions=r  
signature= +SzBm0wi8xECuGkKw97wnkSZ/62sxU+6Hq6a7qojIVE=  
signedidentifier=YWJjZGVmZw==
signedversion=2015-02-21  
startpk="Coho Winery"  
startrk="Auburn"  
endpk="Coho Winery"  
endrk="Seattle"  
  
String-To-Sign = r + \n
                 2015-07-01T08:49Z + \n  
                 2015-07-02T08:49Z + \n  
                 table/myaccount/mytable + \n  
                 YWJjZGVmZw==  + \n  
                 2015-02-21 + \n  
                 Coho Winery + \n  
                 Auburn + \n  
                 Coho Winery + \n  
                 Seattle  
  
GET https://myaccount.table.core.windows.net/MyTable?$filter=PartitionKey%20eq%20'Coho%20Winery'&sv=2015-02-21&tn=MyTable&st=2015-07-01T08%3a49Z&se=2015-07-02T08%3a49Z&sp=r&si=YWJjZGVmZw%3d%3d&sig=jDrr6cna7JPwIaxWfdH0tT5v9dc%3d&spk=Coho%20Winery&srk=Auburn&epk=Coho%20Winery&erk=Seattle HTTP/1.1  
Host: myaccount.table.core.windows.net  
DataServiceVersion: 3.0;NetFx  
MaxDataServiceVersion: 3.0;NetFx

Örnek: Paylaşılan Erişim İmzası Kullanarak Tablo Güncelleştirme

Aşağıdaki örnekte, bir tablodaki varlıkları güncelleştirmek için paylaşılan erişim imzası oluşturma gösterilmektedir. İmza, belirli bir varlık aralığı için güncelleştirme izinleri verir. Son olarak, bu örnek aralıktaki bir varlığı güncelleştirmek için paylaşılan erişim imzasını kullanır.

Aşağıdaki imzalı imza alanlarını, StringToSign dizesinin oluşturulmasını ve Varlığı Güncelleştir işlemini çağıran URL'nin oluşturulmasını inceleyin. Varlığı Güncelleştir işlemi yalnızca ve endpktarafından startpk tanımlanan bölüm aralığındaki varlıkları güncelleştirebilir.

signedstart=2015-07-01T08:49Z  
signedexpiry=2015-07-02T08:49Z  
signedpermissions=u  
signature= +SzBm0wi8xECuGkKw97wnkSZ/62sxU+6Hq6a7qojIVE=  
signedidentifier=YWJjZGVmZw==   
signedversion=2015-02-21  
startpk="Coho Winery"  
endpk="Coho Winery"  
  
String-To-Sign = u + \n   
                 2015-07-01T08:49Z + \n  
                 2015-07-02T08:49Z + \n  
                 table/myaccount/mytable + \n  
                 YWJjZGVmZw== + \n  
                 2015-02-21 + \n  
                 Coho Winery + \n  
                 + \n  
                 Coho Winery + \n  
  
MERGE https://myaccount.table.core.windows.net/MyTable(PartitionKey='Coho%20Winery',RowKey='Seattle')?sv=2015-02-21&tn=MyTable&st=2015-07-01T08%3a49Z&se=2015-07-02T08%3a49Z&sp=u&si=YWJjZGVmZw%3d%3d&sig=jDrr6cna7JPwIaxWfdH0tT5v9dc%3d&spk=Coho%20Winery&epk=Coho%20Winery HTTP/1.1  
Host: myaccount.table.core.windows.net  
DataServiceVersion: 3.0;NetFx  
MaxDataServiceVersion: 3.0;NetFx  
If-Match: *  
Content-Type: application/atom+xml  
Content-Length: 696  
  
<?xml version="1.0" encoding="utf-8" standalone="yes"?>  
<entry xmlns:d="http://schemas.microsoft.com/ado/2007/08/dataservices" xmlns:m="http://schemas.microsoft.com/ado/2007/08/dataservices/metadata" xmlns="http://www.w3.org/2005/Atom">  
  <title />  
  <author>  
    <name />  
  </author>  
  <id>https://myaccount.table.core.windows.net/MyTable(PartitionKey='Coho Winery',RowKey='Seattle')</id>  
  <content type="application/xml">  
    <m:properties>  
      <d:PartitionKey>P</d:PartitionKey>  
      <d:RowKey>R</d:RowKey>  
      <d:Timestamp m:type="Edm.DateTime">0001-01-01T00:00:00</d:Timestamp>  
    </m:properties>  
  </content>  
</entry>

Ayrıca Bkz.

Paylaşılan erişim imzası ile temsilci erişimi
Hizmet SAS’si oluşturma