讀取具有標記的所有註冊
擷取所有具有特定標記的註冊。
要求
| 方法 | 要求 URI | HTTP 版本 |
|---|---|---|
| GET | https://{namespace}.servicebus.windows.net/{NotificationHub}/tags/{tag}/registrations?api-version=2015-01 | HTTP/1.1 |
請注意下列事項：
此呼叫支援 OData 中指定的 $top 查詢字串參數。
此呼叫支援 ContinuationToken 查詢字串參數以繼續列舉型別。
要求標頭
下表描述必要的和選用的要求標頭。
| 要求標頭 | 說明 |
|---|---|
| 授權 | 使用共用存取簽章驗證中所指定產生的語彙基元 服務匯流排, ，或 服務匯流排 利用驗證與授權 Microsoft Azure Active Directory 存取控制服務 (也稱為「存取控制服務」或 ACS)。 |
| x-ms-version | 2015-01 |
要求本文
無。
回應
回應包括 HTTP 狀態碼和一組回應標頭。
回應碼
| 程式碼 | 說明 |
|---|---|
| 200 | 已成功擷取註冊。 |
| 401 | 授權失敗。 存取金鑰不正確。 |
| 404 | 找不到。 通道雜湊不存在。 |
| 403 | 配額已超過。 要求遭拒，因為註冊作業率過高。 |
如需狀態碼的相關資訊，請參閱 狀態和錯誤碼。
回應標頭
| 回應標頭 | 說明 |
|---|---|
| Content-type | application/atom+xml;type=entry;charset=utf-8 |
回應主體
Atom 摘要中所指定的 xml 格式包裝註冊清單的 Create Registration。 例如：
<?xml version="1.0" encoding="utf-8" ?> <feed xmlns="http://www.w3.org/2005/Atom"> <title type="/{NotificationTopic}/channels/{channel hash}" /> <id> https://{tenant}.windows.net/{NotificationTopic}/channels/{channel hash}</id> <updated>2012-08-17T17:32:00Z</updated> <entry xmlns:m=”https://schemas.microsoft.com/ado/2007/08/dataservices/metadata” m:etag=”W/"1234567890"”> <id>https://{tenant}.windows.net/{NotificationTopic}/registrations/{registrationId}</id> <title type="text"> /{NotificationTopic}/registrations/{registrationId}</title> <updated>2012-08-17T17:32:00Z</updated> <content type="application/xml"> <WindowsRegistrationDescription xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="https://schemas.microsoft.com/netservices/2010/10/servicebus/connect"> <ETag>{ETag}</ETag> <ExpirationTime>2012-07-16T19:20+01:00</ExpirationTime> <RegistrationId>{RegistrationId}</RegistrationId> <Tags>myTag, myOtherTag</Tags> <ChannelUri>{ChannelUri}</ChannelUri> </WindowsRegistrationDescription> </content> </entry> <entry> … </entry> </feed>