

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# GuardDuty Perubahan API pada Maret 2023
<a name="guardduty-feature-object-api-changes-march2023"></a>

Fitur perlindungan GuardDuty APIs konfigurasi yang tidak termasuk dalam daftar[GuardDuty sumber data dasar](guardduty_data-sources.md). Objek fitur berisi detail fitur, seperti nama fitur dan status, dan mungkin berisi konfigurasi tambahan untuk beberapa paket perlindungan. Migrasi ini memengaruhi hal-hal berikut APIs di *Referensi Amazon GuardDuty 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)

## Fitur dibandingkan dengan sumber data
<a name="comparison-datasources-features-activation"></a>

Secara historis, semua GuardDuty fitur dilewatkan melalui `dataSources` objek di API. Mulai Maret 2023, GuardDuty lebih memilih `features` objek daripada `dataSources` objek di API. Semua sumber data sebelumnya memiliki fitur yang sesuai, tetapi fitur yang lebih baru mungkin tidak memiliki sumber data yang sesuai.

Daftar berikut menunjukkan perbandingan antara `dataSources` dan `features` objek saat melewati API:
+ `dataSources`Objek berisi objek untuk setiap jenis perlindungan dan statusnya. `features`Objek adalah daftar fitur yang tersedia yang sesuai dengan setiap jenis perlindungan di dalamnya GuardDuty.

  Mulai Maret 2023, aktivasi fitur akan menjadi satu-satunya cara untuk mengonfigurasi GuardDuty fitur baru di AWS lingkungan Anda.
+ `dataSources`Skema dalam permintaan atau respons API sama di setiap Wilayah AWS tempat yang GuardDuty tersedia. Namun, setiap fitur mungkin tidak tersedia di setiap Wilayah. Oleh karena itu, nama fitur yang tersedia mungkin berbeda berdasarkan Wilayah.

## Memahami cara APIs kerja fitur
<a name="understanding-how-feature-activation-works"></a>

 GuardDuty APIs Akan terus mengembalikan `dataSources` objek sebagaimana berlaku, dan mereka juga akan mengembalikan `features` objek yang berisi informasi yang sama dalam format yang berbeda. GuardDuty Fitur yang diluncurkan sebelum Maret 2023 akan tersedia melalui `dataSources` objek dan `features` objek. GuardDuty fitur yang diluncurkan sejak Maret 2023 hanya akan tersedia melalui `features` objek. Anda tidak dapat membuat atau memperbarui detektor, atau menjelaskan AWS Organizations penggunaan keduanya `dataSources` dan notasi `features` objek dalam permintaan API yang sama. Untuk mengaktifkan jenis GuardDuty perlindungan, Anda harus memigrasikan sumber data yang ada ke `features` objek dengan menggunakan yang sama APIs yang sekarang menyertakan `features` objek juga.

**catatan**  
GuardDuty tidak akan menambahkan sumber data baru setelah modifikasi ini.

GuardDuty telah menghentikan penggunaan sumber data yang terkait dengan rencana perlindungan. Namun, masih mendukung[GuardDuty sumber data dasar](guardduty_data-sources.md). Praktik GuardDuty terbaik merekomendasikan penggunaan fitur untuk mengaktifkan atau mengedit konfigurasi untuk paket perlindungan apa pun di akun Anda.

## Menggabungkan perubahan fitur di APIs
<a name="features-activation-incorporating-changes"></a>
+ Jika Anda mengelola GuardDuty konfigurasi melalui APIs, SDKs, atau CloudFormation template, dan ingin mengaktifkan GuardDuty fitur baru yang potensial, Anda harus memodifikasi kode dan template Anda, masing-masing. Untuk informasi selengkapnya, lihat yang diperbarui APIs di *[Referensi Amazon GuardDuty API](https://docs.aws.amazon.com/guardduty/latest/APIReference/API_Operations.html)*.
+ Untuk GuardDuty fitur yang dikonfigurasi sebelum pemutakhiran ini, Anda dapat terus menggunakan APIs, SDKs, atau CloudFormation templat. Namun, kami menyarankan Anda beralih menggunakan `feature` objek.

  Semua sumber data memiliki objek fitur yang setara. Untuk informasi selengkapnya, lihat [Pemetaan ke `dataSources` `features`](#guardduty-feature-enablement-datasource-relation).
+ Saat ini, `additionalConfiguration` dalam `features` objek hanya tersedia untuk jenis perlindungan tertentu.
  + Untuk jenis perlindungan seperti itu, jika fitur Anda `AdditionalConfiguration` `status` disetel ke `ENABLED` tetapi konfigurasi fitur Anda tidak `status` disetel ke`ENABLED`, tidak GuardDuty akan mengambil tindakan apa pun dalam kasus ini.
  + Berikut ini APIs akan terpengaruh oleh ini:
    + [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) 

## Pemetaan ke `dataSources` `features`
<a name="guardduty-feature-enablement-datasource-relation"></a>

Tabel berikut menunjukkan pemetaan jenis perlindungan,`dataSources`, dan`features`.

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

\$1 GetUsageStatistics menggunakan `dataSource` namanya sendiri. Untuk informasi selengkapnya, lihat [Memantau GuardDuty Penggunaan dan Memperkirakan Biaya](monitoring_costs.md) atau [https://docs.aws.amazon.com/guardduty/latest/APIReference/API_GetUsageStatistics.html](https://docs.aws.amazon.com/guardduty/latest/APIReference/API_GetUsageStatistics.html).