Skip to content

create_trusted_entity_set

Operation

create_trusted_entity_set

create_trusted_entity_set(request: CreateTrustedEntitySetInput | CreateTrustedEntitySetInputDict | None = None, /, *, plugins: list[Plugin] | None = None, **kwargs: Unpack[CreateTrustedEntitySetInputDict]) -> CreateTrustedEntitySetOutput

Creates a new trusted entity set. In the trusted entity set, you can provide IP addresses and domains that you believe are secure for communication in your Amazon Web Services environment. GuardDuty will not generate findings for the entries that are specified in a trusted entity set. At any given time, you can have only one trusted entity set.

Only users of the administrator account can manage the entity sets, which automatically apply to member accounts.

Parameters:

Name Type Description Default
request CreateTrustedEntitySetInput | CreateTrustedEntitySetInputDict | None

The input as a model or dictionary. Pass this or keyword arguments, not both.

None
plugins list[Plugin] | None

A list of callables that modify the configuration dynamically. Changes made by these plugins only apply for the duration of the operation execution and will not affect any other operation invocations.

None
**kwargs Unpack[CreateTrustedEntitySetInputDict]

The input fields as keyword arguments.

{}

Returns:

Type Description
CreateTrustedEntitySetOutput

An instance of CreateTrustedEntitySetOutput.

create_trusted_entity_set async

create_trusted_entity_set(request: CreateTrustedEntitySetInput | CreateTrustedEntitySetInputDict | None = None, /, *, plugins: list[Plugin] | None = None, **kwargs: Unpack[CreateTrustedEntitySetInputDict]) -> CreateTrustedEntitySetOutput

Creates a new trusted entity set. In the trusted entity set, you can provide IP addresses and domains that you believe are secure for communication in your Amazon Web Services environment. GuardDuty will not generate findings for the entries that are specified in a trusted entity set. At any given time, you can have only one trusted entity set.

Only users of the administrator account can manage the entity sets, which automatically apply to member accounts.

Parameters:

Name Type Description Default
request CreateTrustedEntitySetInput | CreateTrustedEntitySetInputDict | None

The input as a model or dictionary. Pass this or keyword arguments, not both.

None
plugins list[Plugin] | None

A list of callables that modify the configuration dynamically. Changes made by these plugins only apply for the duration of the operation execution and will not affect any other operation invocations.

None
**kwargs Unpack[CreateTrustedEntitySetInputDict]

The input fields as keyword arguments.

{}

Returns:

Type Description
CreateTrustedEntitySetOutput

An instance of CreateTrustedEntitySetOutput.

Input

Pass the input as keyword arguments, a positional dictionary, or a positional model object. Pass plugins separately as a keyword argument.

CreateTrustedEntitySetInputDict

Bases: TypedDict

Dictionary form of CreateTrustedEntitySetInput.

Attributes

activate instance-attribute
activate: Required[bool]

A boolean value that indicates whether GuardDuty is to start using the uploaded trusted entity set.

client_token instance-attribute
client_token: str | None

The idempotency token for the create request.

This field is autopopulated if not provided.

detector_id instance-attribute
detector_id: Required[str]

The unique ID of the detector of the GuardDuty account for which you want to create a trusted entity set.

To find the detectorId in the current Region, see the Settings page in the GuardDuty console, or run the ListDetectors API.

expected_bucket_owner instance-attribute
expected_bucket_owner: str | None

The Amazon Web Services account ID that owns the Amazon S3 bucket specified in the location parameter.

format instance-attribute
format: Required[str]

The format of the file that contains the trusted entity set.

location instance-attribute
location: Required[str]

The URI of the file that contains the threat entity set. The format of the Location URL must be a valid Amazon S3 URL format. Invalid URL formats will result in an error, regardless of whether you activate the entity set or not. For more information about format of the location URLs, see Format of location URL under Step 2: Adding trusted or threat intelligence data in the Amazon GuardDuty User Guide.

name instance-attribute
name: Required[str]

A user-friendly name to identify the trusted entity set.

The name of your list can include lowercase letters, uppercase letters, numbers, dash (-), and underscore (_).

tags instance-attribute
tags: Mapping[str, str] | None

The tags to be added to a new trusted entity set resource.

CreateTrustedEntitySetInput dataclass

Bases: _SerdeShape

Dataclass for CreateTrustedEntitySetInput structure.

Attributes

activate class-attribute instance-attribute
activate: bool | None = ...

A boolean value that indicates whether GuardDuty is to start using the uploaded trusted entity set.

client_token class-attribute instance-attribute
client_token: str | None = ...

The idempotency token for the create request.

This field is autopopulated if not provided.

detector_id class-attribute instance-attribute
detector_id: str | None = ...

The unique ID of the detector of the GuardDuty account for which you want to create a trusted entity set.

To find the detectorId in the current Region, see the Settings page in the GuardDuty console, or run the ListDetectors API.

expected_bucket_owner class-attribute instance-attribute
expected_bucket_owner: str | None = ...

The Amazon Web Services account ID that owns the Amazon S3 bucket specified in the location parameter.

format class-attribute instance-attribute
format: str | None = ...

The format of the file that contains the trusted entity set.

location class-attribute instance-attribute
location: str | None = ...

The URI of the file that contains the threat entity set. The format of the Location URL must be a valid Amazon S3 URL format. Invalid URL formats will result in an error, regardless of whether you activate the entity set or not. For more information about format of the location URLs, see Format of location URL under Step 2: Adding trusted or threat intelligence data in the Amazon GuardDuty User Guide.

name class-attribute instance-attribute
name: str | None = ...

A user-friendly name to identify the trusted entity set.

The name of your list can include lowercase letters, uppercase letters, numbers, dash (-), and underscore (_).

tags class-attribute instance-attribute
tags: dict[str, str] | None = ...

The tags to be added to a new trusted entity set resource.

Output

CreateTrustedEntitySetOutput dataclass

Bases: _SerdeShape

Dataclass for CreateTrustedEntitySetOutput structure.

Attributes

response_metadata class-attribute instance-attribute
response_metadata: ResponseMetadata = ...

Metadata about the response that produced this output. Use this to recover the request identifiers a service's support team needs in order to investigate a call. Members of the metadata are individually optional.

trusted_entity_set_id class-attribute instance-attribute
trusted_entity_set_id: str | None = ...

The ID returned by GuardDuty after creation of the trusted entity set resource.