本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 2023 年 3 月的 GuardDuty API 變更
<a name="guardduty-feature-object-api-changes-march2023"></a>

GuardDuty API 會設定不屬於 [GuardDuty 基礎資料來源](guardduty_data-sources.md) 清單的保護功能。功能物件包含功能詳細資訊，例如功能名稱和狀態，而且可能包含某些保護計畫的其他組態。此遷移會影響《Amazon GuardDuty API 參考》**中的下列 API：
+ [CreateDetector](https://docs.aws.amazon.com/guardduty/latest/APIReference/API_CreateDetector.html)
+ [GetDetector](https://docs.aws.amazon.com/guardduty/latest/APIReference/API_GetDetector.html)
+ [UpdateDetector](https://docs.aws.amazon.com/guardduty/latest/APIReference/API_UpdateDetector.html)
+ [GetMemberDetectors](https://docs.aws.amazon.com/guardduty/latest/APIReference/API_GetMemberDetectors.html)
+ [UpdateMemberDetectors](https://docs.aws.amazon.com/guardduty/latest/APIReference/API_UpdateMemberDetectors.html)
+ [DescribeOrganizationConfiguration](https://docs.aws.amazon.com/guardduty/latest/APIReference/API_DescribeOrganizationConfiguration.html)
+ [UpdateOrganizationConfiguration](https://docs.aws.amazon.com/guardduty/latest/APIReference/API_UpdateOrganizationConfiguration.html)
+ [GetRemainingFreeTrialDays](https://docs.aws.amazon.com/guardduty/latest/APIReference/API_GetRemainingFreeTrialDays.html)
+ [GetUsageStatistics](https://docs.aws.amazon.com/guardduty/latest/APIReference/API_GetUsageStatistics.html)

## 與資料來源相比的功能
<a name="comparison-datasources-features-activation"></a>

從歷史上看，所有 GuardDuty 功能都是透過 API 中的 `dataSources` 物件傳遞。從 2023 年 3 月起，GuardDuty 偏好 `features` 物件而不是 API 中的 `dataSources` 物件。所有較早的資料來源都具有對應的功能，但較新的功能可能沒有對應的資料來源。

下列清單顯示了透過 API 傳遞時 `dataSources` 和 `features` 物件之間的比較：
+ `dataSources` 物件包含每種保護類型的物件及其狀態。`features` 物件是對應於 GuardDuty 中每個保護類型的可用功能清單。

  從 2023 年 3 月開始，功能啟用將是您 AWS 環境中設定新 GuardDuty 功能的唯一方法。
+ API 請求或回應中的 `dataSources` 結構描述在可用 GuardDuty 的每個 AWS 區域 位置中都相同。但是，並非每個區域都會提供所有功能。因此，可用的功能名稱可能會因區域而有所不同。

## 了解具有 功能的 APIs如何運作
<a name="understanding-how-feature-activation-works"></a>

GuardDuty API 將繼續傳回適用的 `dataSources` 物件，並且還將以不同格式傳回包含相同資訊的 `features` 物件。在 2023 年 3 月之前推出的 GuardDuty 功能將透過 `dataSources` 物件和 `features` 物件提供。自 2023 年 3 月起推出的 GuardDuty 功能將只能透過 `features` 物件提供。您無法建立或更新偵測器，或在相同的 API 請求中使用 AWS Organizations `dataSources`和 `features` 物件標記法來描述您的 。若要啟用 GuardDuty 保護類型，您需要使用現在也包含 `features` 物件的相同 API，將現有資料來源遷移至 `features` 物件。

**注意**  
GuardDuty 將不會在此修改之後新增資料來源。

GuardDuty 已棄用與保護計畫相關聯的資料來源。但是仍支援 [GuardDuty 基礎資料來源](guardduty_data-sources.md)。GuardDuty 最佳實務建議使用功能來啟用或停用您帳戶中任何保護計畫的組態。

## 在 APIs中整合功能變更
<a name="features-activation-incorporating-changes"></a>
+ 如果您透過 APIs、軟體SDKs或 CloudFormation 範本管理 GuardDuty 組態，並想要啟用潛在的新 GuardDuty 功能，您將需要分別修改程式碼和範本。如需詳細資訊，請參閱《[Amazon GuardDuty API Reference](https://docs.aws.amazon.com/guardduty/latest/APIReference/API_Operations.html)》**中更新後的 API。
+ 對於在此升級之前設定的 GuardDuty 功能，您可以繼續使用 APIs、SDKs或 CloudFormation 範本。不過，建議您切換為使用 `feature` 物件。

  所有資料來源均具有對等的功能物件。如需詳細資訊，請參閱[將 `dataSources` 映射至 `features`](#guardduty-feature-enablement-datasource-relation)。
+ 目前，`features` 物件中的 `additionalConfiguration` 僅適用於某些保護類型。
  + 對於此類保護類型，如果您的功能 `AdditionalConfiguration` `status` 已設定為 `ENABLED`，但功能的組態 `status` 未設定為 `ENABLED`，則 GuardDuty 在此情況下不會採取任何動作。
  + 以下 API 受到此影響：
    + [UpdateDetector](https://docs.aws.amazon.com/guardduty/latest/APIReference/API_UpdateDetector.html)
    + [UpdateMemberDetectors](https://docs.aws.amazon.com/guardduty/latest/APIReference/API_UpdateMemberDetectors.html)
    + [UpdateOrganizationConfiguration](https://docs.aws.amazon.com/guardduty/latest/APIReference/API_UpdateOrganizationConfiguration.html) 

## 將 `dataSources` 映射至 `features`
<a name="guardduty-feature-enablement-datasource-relation"></a>

以下表格顯示保護類型 `dataSources` 和 `features` 的映射。

[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/guardduty/latest/ug/guardduty-feature-object-api-changes-march2023.html)

\$1 GetUsageStatistics 使用自己的 `dataSource` 名稱。如需詳細資訊，請參閱 [監控 GuardDuty 用量和估算成本](monitoring_costs.md) 或 [https://docs.aws.amazon.com/guardduty/latest/APIReference/API_GetUsageStatistics.html](https://docs.aws.amazon.com/guardduty/latest/APIReference/API_GetUsageStatistics.html) 。