更新事件中心
更新事件中樞。 更新事件中樞時，您只能變更此處所列的屬性。 嘗試變更任何其他屬性會導致錯誤。 可以變更但未指定的屬性會設定為其預設值。
屬性
| 屬性名稱 | 開始提供的 API 版本 | 預設 | 屬性描述 |
|---|---|---|---|
| MessageRetentionInDays | 2014-01 | 0 | MessageRetentionInDays |
要求
| 方法 | 要求 URI |
|---|---|
| PUT | https://{serviceNamespace}.servicebus.windows.net/{eventHubPath} |
要求標頭
如需所有與事件中樞相關的要求所使用的標頭和參數，請參閱 一般參數和標頭 。
其他要求標頭
| 要求標頭 | 必要或選用 | Description |
|---|---|---|
| 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 要求中遺漏的屬性會以預設值傳回。 如果要求未成功，本文會包含錯誤碼和錯誤訊息。
| 元素名稱 | Description |
|---|---|
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>