在指定的位置建立或更新註冊。
要求
| 方法 | 要求 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 |
| 授權 | 使用共用存取簽章驗證中所指定產生的語彙基元 服務匯流排, ，或 服務匯流排 利用驗證與授權 Microsoft Azure Active Directory 存取控制服務 (也稱為「存取控制服務」或 ACS)。 |
| x-ms-version | 2015-01 |
要求本文
Atom 項目，描述內嵌於內容中，做為在 建立註冊。
回應
回應包括 HTTP 狀態碼和一組回應標頭。
回應碼
| 程式碼 | 說明 |
|---|---|
| 201 | 已成功更新註冊。 |
| 400 | 無效的要求內文。 無法建立註冊，因為要求格式錯誤。 |
| 401 | 授權失敗。 存取金鑰不正確。 |
| 403 | 配額已超過；此命名空間中有太多註冊。 並未建立註冊。 |
| 404 | 此位置不存在通知中心。 |
| 409 | 要求遭拒，因為註冊作業率過高。 |
| 410 | 無法使用指定的位置。 請使用不同 registrationid。 |
如需狀態碼的相關資訊，請參閱 狀態和錯誤碼。
回應標頭
| 回應標頭 | 說明 |
|---|---|
| Content-type | application/atom+xml;type=entry;charset=utf-8 |
| ETag | {weak ETag} |
回應主體
成功時，已驗證的 Atom 項目會傳回，如 建立註冊。