你当前正在访问 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
授权 使用 服务总线 在共享访问签名身份验证中生成的令牌,或者使用Microsoft Azure Active Directory 访问控制 ((也称为访问控制服务或 ACS) )服务总线身份验证和授权。
If-Match 创建、更新和检索操作返回的 ETag 或 '*'(覆盖)。
x-ms-version 2015-01

请求正文

Atom 条目,其中包含内容中嵌入的说明,如 在“创建注册”中所示

响应

响应包括 HTTP 状态代码和一组响应标头。

响应代码

代码 说明
201 注册更新成功。
400 请求正文无效。 因请求格式错误而无法创建注册。
401 授权失败。 访问密钥不正确。
403 已超出配额;此命名空间中的注册太多。 未创建注册。
404 此位置不存在任何注册。
409 因注册操作率过高请求被拒绝。

有关状态代码的信息,请参阅 “状态”和“错误代码”。

响应头

响应标头 说明
Content-type application/atom+xml;type=entry;charset=utf-8
ETag {weak ETag}

响应正文

成功后,将返回已验证的 Atom 条目,就像 在“创建注册”中一样。