İletinin Kilidini Aç

Makale
07/19/2023

Belirtilen abonelikte diğer alıcılar tarafından işlenmek üzere bir iletinin kilidini açar. Bu işlem kilit nesnesini silip iletinin kilidinin açılmasına neden olur. İşlem çağrılmadan önce alıcının iletiyi kilitlemesi gerekir.

İstek

Yöntem	İstek URI'si	HTTP Sürümü
PUT	`http{s}://{serviceNamespace}.servicebus.windows.net/{queuePath}/messages/{messageId\|sequenceNumber}/{lockToken}` veya `http{s}://{serviceNamespace}.servicebus.windows.net/{topicPath}/subscriptions/{subscriptionName}/messages/{messageId\|sequenceNumber}/{lockToken}\|HTTP/1.1`

URI Parametreleri

URI, göz atılan iletinin Konum üst bilgisinde sağlanır veya aşağıdaki tabloda açıklanan bölümlerden oluşturabilirsiniz.

Parametre	Açıklama
`messageId`	İletiye Göz At işlemi tarafından içinde döndürüldükçe `BrokerProperties{MessageId}` kilidi açılacak iletinin kimliği.
`sequence-number`	İletiye Göz At işlemi tarafından içinde döndürüldükçe `BrokerProperties{SequenceNumber}` kilidi açılacak iletinin sıra numarası.
`lockToken`	içindeki İletiye Göz At işlemi `BrokerProperties{LockToken}`tarafından döndürülen şekilde kilidi kaldırılacak ileti kilidinin belirteci.

İstek Üst Bilgileri

Aşağıdaki tabloda gerekli ve isteğe bağlı istek üst bilgileri açıklanmaktadır.

İstek Başlığı Description

Yetkilendirme

İstek Başlığı	Description
Yetkilendirme	Aşağıdaki birini belirtin: Azure Active Directory (Azure AD) JSON Web Belirteci (JWT) belirteci. Örnek: `Authorization: Bearer <Azure AD JWT token>`. Azure AD belirteci oluşturma hakkında bilgi için bkz. Uygulamadan kimlik doğrulaması yapma. SAS belirteci. Örnek: `Authorization: SharedAccessSignature sr=<NAMESPACE NAME>.servicebus.windows.net&sig=<SHARED ACCESS KEY>&se=<TOKEN EXPIRY INSTANT>&skn=<SHARED KEY NAME>`. SAS belirteci oluşturma hakkında bilgi için bkz . Paylaşılan Erişim İmzası belirteci oluşturma ve SAS belirteci oluşturma.

Aşağıdaki birini belirtin:

Azure Active Directory (Azure AD) JSON Web Belirteci (JWT) belirteci.
Örnek: Authorization: Bearer <Azure AD JWT token>.
Azure AD belirteci oluşturma hakkında bilgi için bkz. Uygulamadan kimlik doğrulaması yapma.
SAS belirteci.
Örnek: Authorization: SharedAccessSignature sr=<NAMESPACE NAME>.servicebus.windows.net&sig=<SHARED ACCESS KEY>&se=<TOKEN EXPIRY INSTANT>&skn=<SHARED KEY NAME>.
SAS belirteci oluşturma hakkında bilgi için bkz . Paylaşılan Erişim İmzası belirteci oluşturma ve SAS belirteci oluşturma.

İstek Gövdesi

Yok.

Yanıt

Yanıt bir HTTP durum kodu, bir dizi yanıt üst bilgisi ve yanıt gövdesi içerir.

Yanıt Kodları

Kod	Description
200	İletinin kilidi başarıyla açıldı.
401	Yetkilendirme hatası.
404	Belirtilen `MessageId` veya `LockToken`ile hiçbir ileti bulunamadı.
410	Belirtilen kuyruk veya abonelik yok.
500	İç hata.

Durum kodları hakkında bilgi için bkz. Durum ve Hata Kodları.

Yanıt Üst Bilgileri

Yanıt Üst Bilgisi	Description
İçerik Türü	application/atom+xml;type=entry;charset=utf-8 olarak ayarlayın.

Yanıt Gövdesi

Yok.

Örnek

Aşağıdaki HTTP isteği bir iletinin kilidini açar:

PUT https://your-namespace.servicebus.windows.net/HttpClientSampleQueue/messages/31907572-1647-43c3-8741-631acd554d6f/7da9cfd5-40d5-4bb1-8d64-ec5a52e1c547?timeout=60 HTTP/1.1  
Authorization: SharedAccessSignature sr=rukochbay&sig=rg9iGsK0ZyYlvhIqyH5IS5tqmeb08h8FstjHLPj3%2f8g%3d&se=1404265946&skn=RootManageSharedAccessKey  
Host: your-namespace.servicebus.windows.net  
Content-Length: 0

Service Bus aşağıdaki yanıtı döndürür:

HTTP/1.1 200 OK  
Transfer-Encoding: chunked  
Content-Type: application/xml; charset=utf-8  
Server: Microsoft-HTTPAPI/2.0  
Date: Tue, 01 Jul 2014 23:00:35 GMT  
  
0

Ayrıca Bkz.

Service Bus HTTP İstemcisi örneği