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

更新事件中心

更新事件中心。 更新事件中心时,只能更改此处列出的属性。 尝试更改任何其他属性会导致错误。 可以更改但未指定的属性设置为其默认值。

属性

属性名称 随 API 版本一起提供 默认 属性说明
MessageRetentionInDays 2014-01 0 MessageRetentionInDays

请求

方法 请求 URI
PUT https://{serviceNamespace}.servicebus.windows.net/{eventHubPath}

请求标头

有关与事件中心相关的所有请求使用的标头和参数,请参阅 通用参数和标头

其他请求标头

请求标头 必需还是可选 描述
If-Match 必需 将此标头设置为“*”以更新事件中心。 必须在更新的事件中心上提供所有所需的属性值;未提供的任何值都设置为服务默认值。 如果缺少此标头,则更新调用将返回一个错误,指示此事件中心已存在。

请求正文

在内容中嵌入了描述的 Atom 条目。 例如:

<entry xmlns='http://www.w3.org/2005/Atom'>  
  <content type='application/xml'>  
    {EventHubDescription}  
  </content>  
</entry>  

响应

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

响应代码

代码 说明
200 成功。
400 请求错误。
401 授权失败。
409 由于 缺少 If-Match 标头而发生冲突。
500 内部错误。

响应正文

如果请求成功,响应正文将包含事件中心说明。 将会返回从 PUT 请求丢失的属性,具有默认值。 如果请求未成功,正文包含错误代码和错误消息。

元素名称 说明
AuthorizationRules 授权规则。
MessageRetentionInDays 保留此事件中心的事件的天数。
Status 事件中心的当前状态 (启用或禁用) 。
CreatedAt 创建事件中心的确切时间。
UpdatedAt 事件中心更新的确切时间。
PartitionCount 事件中心上的当前分区数。
PartitionIds 为事件中心创建的分区的标识符。

示例

请求

注意

还可以使用授权标头的Azure Active Directory令牌,如 Common 参数和标头中所述。 例如:Authorization: Bearer <Azure AD token>

PUT https://your-namespace.servicebus.windows.net/your-event-hub?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
If-Match: *
Content-Length: 264  
Expect: 100-continue  
Connection: Keep-Alive  
  
<entry xmlns='http://www.w3.org/2005/Atom'>  
  <content type='application/xml'>  
    <EventHubDescription xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.microsoft.com/netservices/2010/10/servicebus/connect">  
      <MessageRetentionInDays>3</MessageRetentionInDays>  
    </EventHubDescription>  
  </content>  
</entry>  

响应

HTTP/1.1 201 Created  
Transfer-Encoding: chunked  
Content-Type: application/atom+xml;type=entry;charset=utf-8  
Server: Microsoft-HTTPAPI/2.0  
Date: Wed, 25 Jun 2014 22:43:27 GMT  
  
<entry xmlns="http://www.w3.org/2005/Atom">  
  <id>https://your-namespace.servicebus.windows.net/your-event-hub?timeout=60&api-version=2014-01</id>  
  <title type="text">your-event-hub</title>  
  <published>2014-06-25T22:43:16Z</published>  
  <updated>2014-06-25T22:43:27Z</updated>  
  <author>  
     <name>your-namespace</name>  
  </author>  
  <link rel="self" href="https://your-namespace.servicebus.windows.net/your-event-hub?timeout=60&api-version=2014-01"/>  
  <content type="application/xml">  
    <EventHubDescription xmlns="http://schemas.microsoft.com/netservices/2010/10/servicebus/connect" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">  
        <MessageRetentionInDays>3</MessageRetentionInDays>  
    </EventHubDescription>  
  </content>  
</entry>