建立或更新註冊
在指定的位置建立或更新註冊。
要求
方法 | 要求 URI | HTTP 版本 |
---|---|---|
PUT | https://{namespace}.servicebus.windows.net/{NotificationHub}/registrations/<registrationId>?api-version=2015-01 |
HTTP/1.1 |
要求標頭
下表描述必要的和選用的要求標頭。
要求標頭 | 描述 |
---|---|
Content-Type | application/atom+xml;type=entry;charset=utf-8 |
授權 | 使用 服務匯流排共用存取簽章驗證中所指定的 SAS 權杖。 |
x-ms-version | 2015-01 |
要求本文
內嵌在內容中的描述的 Atom 專案,如同 建立註冊一樣。
回應
回應包括 HTTP 狀態碼和一組回應標頭。
回應碼
程式碼 | 描述 |
---|---|
201 | 註冊已成功更新。 |
400 | 無效的要求內文。 無法建立註冊,因為要求格式不正確。 |
401 | 授權失敗。 存取金鑰不正確。 |
403 | 超過配額;此命名空間中的註冊太多。 未建立註冊。 |
404 | 此位置沒有通知中樞。 |
409 | 因為註冊作業速率太高,所以要求遭到拒絕。 |
410 | 無法使用指定的位置。 使用不同的註冊識別碼。 |
如需狀態碼的相關資訊,請參閱 狀態和錯誤碼。
回應標頭
回應標頭 | 描述 |
---|---|
Content-Type | application/atom+xml;type=entry;charset=utf-8 |
ETag | {weak ETag} |
回應本文
成功時,會傳回已驗證的 Atom 專案,如 建立註冊所示。