你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
创建或更新注册
在指定位置创建或更新注册。
请求
| 方法 | 请求 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 | 无法使用指定的位置。 使用不同的注册 ID。 |
有关状态代码的信息，请参阅 状态和错误代码。
响应头
| 响应标头 | 说明 |
|---|---|
| Content-type | application/atom+xml;type=entry;charset=utf-8 |
| ETag | {weak ETag} |
响应正文
成功后，将返回已验证的 Atom 条目，如 创建注册中所示。