設定事件中樞的屬性

發行項
2024-03-19

本文會說明如何設定事件中樞的狀態、分割區計數、保留時間等屬性。

設定狀態

您可以在事件中樞建立之後，將事件中樞的狀態更新為 [屬性] 頁面上的其中一個值。

若想從事件中樞傳送事件和接收事件，請選取 [作用中] (預設)。
若想停用事件中樞的傳送和接收事件，請選取 [已停用]。
若想停用將事件傳送至事件中樞，請選取 [SendDisabled]。

設定分割區計數

[屬性] 頁面可讓您查看所有階層中事件中樞事件中樞的分割區數目。它可讓您更新進階或專用階層中事件中樞的分割區計數。對於其他階層，您只能在建立事件中樞時指定分割區計數。若要了解事件中樞中的分割區，請參閱 [可擴縮性]

設定清除原則

您會在 [屬性] 頁面上看到事件中樞的清除原則。您無法更新它。根據預設，會使用刪除清除原則來建立事件中樞，其中事件會在保留時間到期時清除。建立事件中樞時，您可以將清除原則設定為 [壓縮]。如需記錄壓縮的詳細資訊，請參閱設定記錄壓縮。

設定保留時間

如果清除原則設定為 [刪除]保留時間 是事件中樞在捨棄事件之前會保留事件最長的時間。 [屬性] 頁面可讓您以小時為單位指定保留時間。

如果在建立事件中樞時清除原則設定為 [壓縮]，則會自動啟用 [無限保留時間]。不過，您可以設定 [標記保留時間，以小時為單位]。用戶端應用程式可以傳送具有現有索引鍵和 null 事件裝載的新事件，來標記要在壓縮作業期間刪除的事件中心現有事件。這些標記稱為 [標記]。 以小時為單位標記保留時間 是將墓碑標記保留在壓縮事件中樞的時間。

Azure CLI

使用 az eventhubs eventhub update 命令來設定事件中樞的分割區計數和保留設定。

使用 --status 參數，將現有事件中樞的狀態設定為 Active、 Disabled 或 SendDisabled 或 ReceiveDisabled。
使用 --partition-count 參數來指定分割區數目。只有當現有事件中樞位於進階或專用層命名空間時，才可以指定分割區計數。
如果 cleanupPolicy 是 Delete，請使用 --retention-time 來指定保留事件中樞的事件時數。
如果 cleanupPolicy 是 Compact，請使用 --tombstone-retention-time-in-hours 來指定標記標記的時數。

Azure PowerShell

透過使用 -Status、-RetentionTimeInHour 或 TomstoneRetentionTimeInHour 來使用 Set-AzEventHub。目前，PowerShell 命令不支援更新事件中樞的分割區計數。

Azure Resource Manager 範本

如果您使用 Azure Resource Manager 範本，請使用 partitionCount 和 retentionTimeinHours，如下列範例所示。 MYNAMESPACE 是事件中樞命名空間的名稱，MYEVENTHUB 在此範例中是事件中樞的名稱。

{
	"type": "Microsoft.EventHub/namespaces/eventhubs",
	"apiVersion": "2022-10-01-preview",
	"name": "MYNAMESPACE/MYEVENTHUB ",
	"properties": {
		"partitionIds": [],
		"partitionCount": 1,
		"captureDescription": null,
		"retentionDescription": {
			"cleanupPolicy": "Delete",
			"retentionTimeInHours": 1
		}
	}
}

下一步

請參閱以下文章：

共用方式為