기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 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는 API에서 `dataSources` 객체 대신 `features` 객체를 선호합니다. 이전의 모든 데이터 소스에는 해당 기능이 있지만 최신 기능에는 해당 데이터 소스가 없을 수 있습니다.

다음 목록은 API를 통해 전달된 `dataSources` 및 `features` 객체 간의 비교를 보여줍니다.
+ `dataSources` 객체에는 각 보호 유형에 대한 객체와 상태가 포함되어 있습니다. `features` 객체는 GuardDuty 내의 각 보호 유형에 해당하는 사용 가능한 기능 목록입니다.

  2023년 3월부터 사용자 AWS 환경에서 새로운 GuardDuty 기능을 구성하는 유일한 방법은 기능 활성화입니다.
+ API 요청 또는 응답의 `dataSources` 스키마는 GuardDuty를 사용할 수 있는 각 AWS 리전 에서 동일합니다. 하지만 일부 리전에서는 모든 기능을 사용하지 못할 수 있습니다. 따라서 사용 가능한 기능 이름은 리전에 따라 다를 수 있습니다.

## 기능이 있는 API의 작동 방식 이해
<a name="understanding-how-feature-activation-works"></a>

GuardDuty API는 해당하는 경우 계속해서 `dataSources` 객체를 반환하고, 동일한 정보가 포함된 `features` 객체도 다른 형식으로 반환합니다. 2023년 3월 이전에 출시된 GuardDuty 기능은 `dataSources` 객체와 `features` 객체를 통해 사용할 수 있습니다. 2023년 3월 이후에 출시된 GuardDuty 기능은 `features` 객체를 통해서만 사용할 수 있습니다. 동일한 API 요청에서 `dataSources` 및 `features` 객체 표기법을 AWS Organizations 사용하여 감지기를 생성 또는 업데이트하거나를 설명할 수 없습니다. GuardDuty 보호 유형을 활성화하려면 `features` 객체도 포함된 동일한 API를 사용하여 기존 데이터 소스를 `features` 객체로 마이그레이션해야 합니다.

**참고**  
GuardDuty는 이번 수정 이후 새 데이터 소스를 추가하지 않습니다.

GuardDuty는 보호 요금제와 관련된 데이터 소스 사용을 더 이상 사용하지 않습니다. 하지만 [GuardDuty 기본 데이터 소스](guardduty_data-sources.md) 지원은 계속됩니다. GuardDuty 모범 사례에서는 계정의 모든 보호 요금제에 대한 구성을 사용 설정하거나 편집하는 기능을 사용할 것을 권장합니다.

## API의 기능 변경 사항 통합
<a name="features-activation-incorporating-changes"></a>
+ APIs, SDKs 또는 CloudFormation 템플릿을 통해 GuardDuty 구성을 관리하고 잠재적인 새 GuardDuty 기능을 활성화하려면 각각 코드와 템플릿을 수정해야 합니다. 자세한 내용은 [Amazon GuardDuty API 참조](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/ko_kr/guardduty/latest/ug/guardduty-feature-object-api-changes-march2023.html)

\$1GetUsageStatistics는 고유한 `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)을 참조하세요.