使用 Web 服務 › 變更資料保留期間

變更資料保留期間

您可以變更 Data Repository 保留輪詢資料、每小時彙總資料、每日彙總資料及每週彙總資料的時間長度。 例如，您可以將輪詢資料保留值變更為 30 天，以節省磁碟空間。 請在需求與環境之間找出最佳平衡點。

根據預設，資料保留在 Data Repository 中的天數如下：

• 輪詢的資料：45 天

  附註：如果您是從舊版的 Data Aggregator 升級到此版本，則輪詢資料保留將維持先前的 10 天預設值。

• 每小時彙總的資料：90 天
• 每天彙總的資料：365 天
• 每週彙總的資料：730 天

Data Repository 可保留資料的最短天數如下：

• 輪詢的資料：2 天
• 每小時彙總的資料：8 天
• 每天彙總的資料：31 天
• 每週彙總的資料：366 天

遵循這些步驟：

1. 在 Web 瀏覽器輸入下列資訊：
2. http://hostname:port/rest/globalretentiondefinition

   hostname:port

   指定 Data Aggregator 主機名稱和連接埠號碼。

   預設連接埠：8581

   globalretentiondefinition Web 服務端點 URL 隨即開啟。

3. 記下已指派給 globalretentiondefinition 的 ID。
4. 尋找具有 GtdRollupDataRetentionPeriod、DailyRollupDataRetentionPeriod、PolledDataRetentionPeriod 和 HourlyRollupDataRetentionPeriod 的元素。 此資訊可協助您判斷要修改哪些資料類型的保留期間。
5. 開啟可傳送要求和取得回應的 REST 用戶端編輯器或 HTTP 工具，並將 Content-type 設為 application/xml。
6. 輸入下列準則：
   • URL: http://hostname:port/rest/globalretentiondefinition/ID

     ID

     指派給 globalretentiondefinition 的唯一識別號碼。

   • HTTP 方法 = PUT
   • 在 [HTTP 要求] 窗格的 [內文] 索引標籤中，輸入想要變更的保留期間。

     例如：

     <GlobalRetentionDefinition version="1.0.0"> 
     <PolledDataRetentionPeriod>4</PolledDataRetentionPeriod>
     </GlobalRetentionDefinition>
     

     重要！ 確認每一行的開頭都沒有空格，否則 PUT 會失敗。

     在此範例中，輪詢的資料保留期間已變更為 4 天。

   結果會傳回到 [HTTP 回應] 窗格的 [內文] 索引標籤中。

   例如：

   <GlobalRetentionDefinitionList>
   <GlobalRetentionDefinition version="1.0.0">
     <ID>4</ID> 
     <GtdRollupDataRetentionPeriod>730</GtdRollupDataRetentionPeriod> 
     <DailyRollupDataRetentionPeriod>365</DailyRollupDataRetentionPeriod> 
     <PolledDataRetentionPeriod>4</PolledDataRetentionPeriod> 
     <HourlyRollupDataRetentionPeriod>90</HourlyRollupDataRetentionPeriod> 
   <Item version="1.0.0">
     <CreateTime>Thu Dec 08 16:03:05 CST 2011</CreateTime> 
     <Name>Global Retention Definition</Name> 
     </Item>
     </GlobalRetentionDefinition>
     </GlobalRetentionDefinitionList>
   

   在此範例中，輪詢的資料保留期間已變更為 4 天。 每週彙總資料、每日彙總資料和每小時彙總資料的預設保留期間。