As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Nomes de recursos para planos de proteção na GuardDuty API
Quando você ativa a Amazon GuardDuty pela primeira vez, ela começa a ser processada [Fontes de dados fundamentais](guardduty_data-sources.md) em seu AWS ambiente. GuardDuty usa essas fontes de dados para processar um fluxo independente de eventos, como registros de fluxo de VPC, registros de DNS e AWS CloudTrail eventos de gerenciamento. Em seguida, ele analisa esses eventos para identificar possíveis ameaças à segurança e gera descobertas em sua conta.
Quando um ou mais planos de proteção estão habilitados, GuardDuty usa dados adicionais de outros AWS serviços em seu AWS ambiente para monitorar e analisar possíveis ameaças à segurança. Essas fontes de dados adicionais são chamadas de atributos.
## Mudar de fontes de dados para atributos
Ao adicionar GuardDuty proteções adicionais, como S3 Protection, Runtime Monitoring, Lambda Protection e outras, você pode configurar o GuardDuty recurso correspondente ao plano de proteção. Historicamente, GuardDuty as proteções eram chamadas `dataSources` no. APIs No entanto, após março de 2023, os novos planos de GuardDuty proteção agora estão `features` configurados como ou não`dataSources`. GuardDuty ainda oferece suporte à configuração de planos de proteção lançados antes de março de 2023, como `dataSources` por meio da API, mas os novos planos de proteção só estão disponíveis como`features`. Para obter informações sobre quais planos de proteção foram afetados, consulte [GuardDuty Mudanças na API](guardduty-feature-object-api-changes-march2023.md).
Se você gerencia planos de GuardDuty configuração e proteção por meio do console, não será diretamente afetado por essa alteração e não precisará realizar nenhuma ação. Essa alteração afeta o comportamento dos APIs que são invocados para habilitar GuardDuty ou proteger planos internos GuardDuty. Se você AWS CLI usar APIs ou ativar ou editar a configuração de um plano de proteção, deverá usar o nome do recurso associado. Para obter mais informações, consulte [Como mapear `dataSources` para `features`](guardduty-feature-object-api-changes-march2023.md#guardduty-feature-enablement-datasource-relation).
# GuardDuty Mudanças na API em março de 2023
Eles GuardDuty APIs configuram os recursos de proteção que não pertencem à lista de[GuardDuty fontes de dados fundamentais](guardduty_data-sources.md). Um objeto de atributo contém detalhes do recurso, como nome e status do atributo, e pode conter configurações adicionais para alguns planos de proteção. Essa migração afeta o seguinte APIs na *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)
## Comparação de atributos com fontes de dados
Historicamente, todos os GuardDuty recursos eram passados por meio de um `dataSources` objeto na API. A partir de março de 2023, GuardDuty prefere o `features` objeto em vez do `dataSources` objeto na API. Todas as fontes de dados anteriores têm seus respectivos atributos, mas os mais recentes podem não ter suas respectivas fontes de dados.
A lista a seguir mostra a comparação entre os objetos `dataSources` e `features` ao passarem por uma API:
+ O objeto `dataSources` contém objetos para cada tipo de proteção e seu status. O `features` objeto é uma lista de recursos disponíveis que correspondem a cada tipo de proteção contido nele GuardDuty.
A partir de março de 2023, a ativação de recursos será a única forma de configurar novos GuardDuty recursos em seu AWS ambiente.
+ O `dataSources` esquema na solicitação ou resposta da API é o mesmo em todos os Região da AWS lugares GuardDuty disponíveis. No entanto, é possível que nem todos os atributos estejam disponíveis em cada região. Portanto, os nomes dos atributos disponíveis podem variar dependendo da região.
## Entendendo como APIs os recursos funcionam
Eles GuardDuty APIs continuarão retornando um `dataSources` objeto conforme aplicável e também retornarão um `features` objeto contendo as mesmas informações em um formato diferente. GuardDuty recursos lançados antes de março de 2023 estarão disponíveis por meio de `dataSources` objeto e `features` objeto. GuardDuty recursos lançados desde março de 2023 só estarão disponíveis por meio do `features` objeto. Você não pode criar ou atualizar um detector nem descrever seu AWS Organizations uso `dataSources` e a notação de `features` objeto na mesma solicitação de API. Para ativar os tipos de GuardDuty proteção, você precisará migrar suas fontes de dados existentes para o `features` objeto usando as mesmas APIs que agora também incluem o `features` objeto.
**nota**
GuardDuty não adicionará uma nova fonte de dados após essa modificação.
GuardDuty desaprovou o uso de fontes de dados associadas aos planos de proteção. No entanto, ele ainda é compatível com [GuardDuty fontes de dados fundamentais](guardduty_data-sources.md). As GuardDuty melhores práticas recomendam o uso de recursos para ativar ou editar a configuração de qualquer plano de proteção em sua conta.
## Incorporando mudanças de recursos em APIs
+ Se você gerencia GuardDuty configurações por meio de APIs SDKs, ou CloudFormation modelo e deseja habilitar possíveis novos GuardDuty recursos, precisará modificar seu código e modelo, respectivamente. Para obter mais informações, consulte a atualização APIs na *[Amazon GuardDuty API Reference](https://docs.aws.amazon.com/guardduty/latest/APIReference/API_Operations.html)*.
+ Para GuardDuty recursos configurados antes dessa atualização, você pode continuar usando o CloudFormation modelo APIs SDKs, ou. No entanto, recomendamos que se passe a usar o objeto `feature`.
Todas as fontes de dados têm um objeto de atributo equivalente. Para obter mais informações, consulte [Como mapear `dataSources` para `features`](#guardduty-feature-enablement-datasource-relation).
+ Atualmente, `additionalConfiguration` o objeto `features` está disponível apenas para determinados tipos de proteção.
+ Para esses tipos de proteção, se o seu recurso `AdditionalConfiguration` `status` estiver definido como`ENABLED`, mas a configuração do seu recurso não `status` estiver definida`ENABLED`, não GuardDuty tomará nenhuma ação nesse caso.
+ O seguinte APIs é afetado por isso:
+ [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)
## Como mapear `dataSources` para `features`
A tabela a seguir mostra o mapeamento dos tipos de proteção, `dataSources`, e `features`.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/guardduty/latest/ug/guardduty-feature-object-api-changes-march2023.html)
\$1GetUsageStatistics usa seus próprios nomes de `dataSource`. Para acessar mais informações, consulte [Monitorando GuardDuty o uso e estimando os custos](monitoring_costs.md) ou [https://docs.aws.amazon.com/guardduty/latest/APIReference/API_GetUsageStatistics.html](https://docs.aws.amazon.com/guardduty/latest/APIReference/API_GetUsageStatistics.html).