Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Nomi delle funzionalità per i piani di protezione nell' GuardDuty API
Quando abiliti Amazon GuardDuty per la prima volta, inizia l'elaborazione [Origini dati fondamentali](guardduty_data-sources.md) all'interno del tuo AWS ambiente. GuardDuty utilizza queste fonti di dati per elaborare un flusso indipendente di eventi come log di flusso VPC, log DNS ed eventi di gestione. AWS CloudTrail Successivamente analizza questi eventi per identificare potenziali minacce alla sicurezza e genera esiti nel tuo account.
Quando uno o più piani di protezione sono abilitati, GuardDuty utilizza dati aggiuntivi provenienti da altri AWS servizi AWS dell'ambiente per monitorare e analizzare potenziali minacce alla sicurezza. Queste fonti di dati aggiuntive sono chiamate funzionalità.
## Passaggio dalle fonti di dati alle funzionalità
Quando aggiungi GuardDuty protezioni aggiuntive, come S3 Protection, Runtime Monitoring, Lambda Protection e altre, puoi configurare la GuardDuty funzionalità corrispondente al piano di protezione. Storicamente, le GuardDuty protezioni venivano chiamate in. `dataSources` APIs Tuttavia, dopo marzo 2023, i nuovi piani di GuardDuty protezione sono ora configurati così `features` e non. `dataSources` GuardDuty supporta ancora la configurazione dei piani di protezione lanciati prima di marzo 2023, come `dataSources` tramite l'API, ma i nuovi piani di protezione sono disponibili solo come`features`. Per informazioni sui piani di protezione interessati, consulta. [GuardDuty Modifiche all'API](guardduty-feature-object-api-changes-march2023.md)
Se gestisci i piani di GuardDuty configurazione e protezione tramite la console, non sei direttamente interessato da questa modifica e non devi intraprendere alcuna azione. Questa modifica influisce sul comportamento di coloro APIs che vengono richiamati per abilitare GuardDuty o sui piani di protezione all'interno. GuardDuty Se si utilizza APIs o si AWS CLI desidera abilitare o modificare la configurazione di un piano di protezione, è necessario utilizzare il nome della funzionalità associata. Per ulteriori informazioni, consulta [Mappatura di `dataSources` su `features`](guardduty-feature-object-api-changes-march2023.md#guardduty-feature-enablement-datasource-relation).
# GuardDuty Modifiche all'API a marzo 2023
GuardDuty APIs Configurano le funzionalità di protezione che non appartengono all'elenco di[GuardDuty fonti di dati fondamentali](guardduty_data-sources.md). Un oggetto feature contiene dettagli sulle funzionalità, come il nome e lo stato della funzionalità, e può contenere configurazioni aggiuntive per alcuni piani di protezione. Questa migrazione influisce su quanto segue APIs nell'*Amazon GuardDuty API Reference*:
+ [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)
## Funzionalità rispetto alle fonti di dati
Storicamente, tutte le GuardDuty funzionalità venivano trasmesse attraverso un `dataSources` oggetto nell'API. A partire da marzo 2023, GuardDuty preferisce `features` l'oggetto anziché l'`dataSources`oggetto nell'API. Tutte le origini dati precedenti hanno funzionalità corrispondenti, ma le funzionalità più recenti potrebbero non avere origini dati corrispondenti.
L'elenco seguente mostra il confronto tra l'oggetto `dataSources` e l'oggetto `features` quando viene trasmesso tramite un'API:
+ L'oggetto `dataSources` contiene oggetti per ogni tipo di protezione e il relativo stato. L'`features`oggetto è un elenco di funzionalità disponibili che corrispondono a ciascun tipo di protezione all'interno GuardDuty.
A partire da marzo 2023, l'attivazione delle funzionalità sarà l'unico modo per configurare nuove GuardDuty funzionalità nel proprio AWS ambiente.
+ Lo `dataSources` schema nella richiesta o nella risposta dell'API è lo stesso in tutti i paesi in Regione AWS cui GuardDuty è disponibile. Tuttavia, è possibile che non tutte le funzionalità siano disponibili in ogni regione. Pertanto, i nomi delle funzionalità disponibili possono variare in base alla regione.
## Capire come funzionano APIs le funzionalità
GuardDuty APIs Continueranno a restituire un `dataSources` oggetto, se applicabile, e restituiranno anche un `features` oggetto contenente le stesse informazioni in un formato diverso. GuardDuty le funzionalità lanciate prima di marzo 2023 saranno disponibili tramite `dataSources` object and `features` object. GuardDuty le funzionalità lanciate a partire da marzo 2023 saranno disponibili solo tramite l'`features`oggetto. Non è possibile creare o aggiornare un rilevatore o descrivere AWS Organizations l'utilizzo di entrambi `dataSources` e della notazione `features` degli oggetti nella stessa richiesta API. Per abilitare i tipi di GuardDuty protezione, dovrai migrare le fonti di dati esistenti `features` sull'oggetto utilizzando le stesse APIs che ora includono anche l'`features`oggetto.
**Nota**
GuardDuty non aggiungerà una nuova fonte di dati dopo questa modifica.
GuardDuty ha reso obsoleto l'uso di fonti di dati associate ai piani di protezione. Tuttavia, supporta ancora le [GuardDuty fonti di dati fondamentali](guardduty_data-sources.md). Le GuardDuty migliori pratiche consigliano di utilizzare funzionalità per abilitare o modificare la configurazione di qualsiasi piano di protezione del proprio account.
## Incorporazione delle modifiche alle funzionalità in APIs
+ Se gestisci GuardDuty le configurazioni tramite APIs o CloudFormation modello e desideri abilitare potenziali nuove GuardDuty funzionalità, dovrai modificare rispettivamente il codice e il modello. SDKs Per ulteriori informazioni, consulta l'aggiornamento APIs nell'*[Amazon GuardDuty API Reference](https://docs.aws.amazon.com/guardduty/latest/APIReference/API_Operations.html)*.
+ Per GuardDuty le funzionalità configurate prima di questo aggiornamento, puoi continuare a utilizzare il CloudFormation modello APIs SDKs, o. Tuttavia, ti consigliamo di passare all'utilizzo dell'oggetto `feature`.
Tutte le origini dati hanno un oggetto funzionalità equivalente. Per ulteriori informazioni, consulta [Mappatura di `dataSources` su `features`](#guardduty-feature-enablement-datasource-relation).
+ Attualmente, la `additionalConfiguration` nell'oggetto `features` è disponibile solo per determinati tipi di protezione.
+ Per questi tipi di protezione, se la funzionalità `AdditionalConfiguration` `status` è impostata su `ENABLED` ma la configurazione della funzionalità non `status` è impostata su`ENABLED`, non GuardDuty intraprenderà alcuna azione in questo caso.
+ Ciò influisce APIs su quanto segue:
+ [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)
## Mappatura di `dataSources` su `features`
La tabella seguente mostra la mappatura dei tipi di protezione, delle `dataSources` e delle `features`.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/guardduty/latest/ug/guardduty-feature-object-api-changes-march2023.html)
\$1GetUsageStatistics utilizza i propri nomi di `dataSource`. Per ulteriori informazioni, consulta [Monitoraggio GuardDuty dell'utilizzo e stima dei costi](monitoring_costs.md) o [https://docs.aws.amazon.com/guardduty/latest/APIReference/API_GetUsageStatistics.html](https://docs.aws.amazon.com/guardduty/latest/APIReference/API_GetUsageStatistics.html).