你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

事件中心服务 REST - 通用参数和标头

这些 API 使你能够访问事件中心服务,以对事件中心执行操作。

通用参数

以下信息是与事件中心发布者相关的所有任务的通用信息:

  • 将 URL 中的 替换为 {api-version}2014-01

  • 将 替换为 {namespaceName} 命名空间的名称。

  • 将 替换为 {eventHubPath} 事件中心的路径。

  • 将 替换为 {publisherId} 发布者的名称。

  • 将 替换为 {partitionId} 事件中心上分区的 ID。

常用标头

  • Content-Type 标头设置为 application/atom+xml;type=entry;charset=utf-8

  • Authorization 标头设置为以下标记之一:

    • Azure Active Directory (Azure AD) JSON Web 令牌 (JWT) 令牌。 示例:Authorization: Bearer <Azure AD JWT token>

      有关生成 Azure AD 令牌的信息,请参阅 获取 Azure AD 令牌

    • SAS 令牌。 示例:Authorization: SharedAccessSignature sr=<NAMESPACE NAME>.servicebus.windows.net&sig=<SHARED ACCESS KEY>&se=<TOKEN EXPIRY INSTANT>&skn=<SHARED KEY NAME>

      有关生成 SAS 令牌的信息,请参阅 生成共享访问签名令牌

  • (可选) 将 x-ms-retrypolicy 标头设置为 NoRetry,以在发生暂时性错误时禁用发送操作的自动重试。

    POST https://your-namespace.servicebus.windows.net/your-event-hub/messages?timeout=60&api-version=2014-01 HTTP/1.1  
    Authorization: SharedAccessSignature sr=your-namespace.servicebus.windows.net&sig=tYu8qdH563Pc96Lky0SFs5PhbGnljF7mLYQwCZmk9M0%3d&se=1403736877&skn=RootManageSharedAccessKey  
    Content-Type: application/atom+xml;type=entry;charset=utf-8  
    Host: your-namespace.servicebus.windows.net  
    
    { "DeviceId":"dev-01", "Temperature":"37.0" }  
    
  • 将可选 UserProperties 标头设置为属性名称为键、属性值为值的自定义属性列表。 例如:

    WindAlert: Strong Winds  
    GeneralAlert: Thunderstorms  
    
    

任务

可以执行以下发布者策略操作: