CfnTrustedEntitySetProps

class aws_cdk.aws_guardduty.CfnTrustedEntitySetProps(*, format, location, activate=None, detector_id=None, expected_bucket_owner=None, name=None, tags=None)

Bases: object

Properties for defining a CfnTrustedEntitySet.

Parameters:
  • format (str) – The format of the file that contains the trusted entity set. For information about supported formats, see List formats in the Amazon GuardDuty User Guide .

  • location (str) – The URI of the file that contains the trusted entity set.

  • activate (Union[bool, IResolvable, None]) – A boolean value that determines if GuardDuty can start using this list for custom threat detection. For GuardDuty to prevent generating findings based on an activity associated with these entries, this list must be active.

  • detector_id (Optional[str]) – The unique regional detector ID 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 (Optional[str]) – The AWS account ID that owns the Amazon S3 bucket specified in the Location field. Whether or not you provide the account ID for this optional field, GuardDuty validates that the account ID associated with the DetectorId value owns the S3 bucket in the Location field. If GuardDuty finds that this S3 bucket doesn’t belong to the specified account ID, you will get an error at the time of activating this list.

  • name (Optional[str]) – A user-friendly name to identify the trusted entity set. Valid characters include lowercase letters, uppercase letters, numbers, dash(-), and underscore (_).

  • tags (Optional[Sequence[Union[TagItemProperty, Dict[str, Any]]]]) – The tags to be added to a new trusted entity set resource. Each tag consists of a key and an optional value, both of which you define. For more information, see Tag .

See:

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-guardduty-trustedentityset.html

ExampleMetadata:

fixture=_generated

Example:

# The code below shows an example of how to instantiate this type.
# The values are placeholders you should change.
from aws_cdk import aws_guardduty as guardduty

cfn_trusted_entity_set_props = guardduty.CfnTrustedEntitySetProps(
    format="format",
    location="location",

    # the properties below are optional
    activate=False,
    detector_id="detectorId",
    expected_bucket_owner="expectedBucketOwner",
    name="name",
    tags=[guardduty.CfnTrustedEntitySet.TagItemProperty(
        key="key",
        value="value"
    )]
)

Attributes

activate

A boolean value that determines if GuardDuty can start using this list for custom threat detection.

For GuardDuty to prevent generating findings based on an activity associated with these entries, this list must be active.

See:

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-guardduty-trustedentityset.html#cfn-guardduty-trustedentityset-activate

detector_id

The unique regional detector ID 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.

See:

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-guardduty-trustedentityset.html#cfn-guardduty-trustedentityset-detectorid

expected_bucket_owner

The AWS account ID that owns the Amazon S3 bucket specified in the Location field.

Whether or not you provide the account ID for this optional field, GuardDuty validates that the account ID associated with the DetectorId value owns the S3 bucket in the Location field. If GuardDuty finds that this S3 bucket doesn’t belong to the specified account ID, you will get an error at the time of activating this list.

See:

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-guardduty-trustedentityset.html#cfn-guardduty-trustedentityset-expectedbucketowner

format

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

For information about supported formats, see List formats in the Amazon GuardDuty User Guide .

See:

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-guardduty-trustedentityset.html#cfn-guardduty-trustedentityset-format

location

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

See:

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-guardduty-trustedentityset.html#cfn-guardduty-trustedentityset-location

name

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

Valid characters include lowercase letters, uppercase letters, numbers, dash(-), and underscore (_).

See:

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-guardduty-trustedentityset.html#cfn-guardduty-trustedentityset-name

tags

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

Each tag consists of a key and an optional value, both of which you define.

For more information, see Tag .

See:

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-guardduty-trustedentityset.html#cfn-guardduty-trustedentityset-tags