你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
向通知中心中的模板注册发送通知。
请求
| 方法 | 请求 URI | HTTP 版本 | 
|---|---|---|
| POST | https://{namespace}.servicebus.windows.net/{NotificationHub}/messages/?api-version=2015-01 | 
HTTP/1.1 | 
请求标头
下表介绍必需的和可选的请求标头。
| 请求标头 | 说明 | 
|---|---|
| 授权 | 按 服务总线的共享访问签名身份验证中指定的方式生成的 SAS 令牌。 | 
| Content-Type | 设置为 application/json;charset=utf-8。 | 
| ServiceBusNotification-Tags | 
              {single tag identifier}(可选) | 
| ServiceBusNotification-Format | 设置为 template (可选)  | 
请求正文
请求正文是 JSON 对象,只具有字符串属性。 例如:
{
    "message": "My message!",
    "otherPropety": "my other value"
}
响应
响应包括 HTTP 状态代码和一组响应标头。
响应代码
| 代码 | 说明 | 
|---|---|
| 200 | 已成功发送消息。 | 
| 400 | 请求格式不正确(例如,路由标头无效、内容类型无效、消息大小超出限制、消息格式错误)。 | 
| 401 | 授权失败。 访问密钥不正确。 | 
| 403 | 已超出配额或消息太大;消息被拒绝。 | 
| 404 | URI 中没有消息分支。 | 
| 413 | 请求的实体太大。 消息大小不能超过 64 Kb。 | 
有关状态代码的信息,请参阅 状态和错误代码。
响应头
| 响应标头 | 说明 | 
|---|---|
| 位置 | 此标头仅适用于标准层通知中心。 此标头将包含通知消息 ID。 它与 按消息遥测和关联 PNS 反馈一起使用。 位置标头使用以下格式: https://{your namespace}.servicebus.windows.net/{your hub name}/messages/{notification message id}?api-version=2015-04 | 
响应正文
无。