AWS::GuardDuty::MalwareProtectionPlan

Creates a new Malware Protection plan for the protected resource.

When you create a Malware Protection plan, the AWS service terms for GuardDuty Malware Protection will apply.

Syntax

To declare this entity in your AWS CloudFormation template, use the following syntax:

JSON

{
  "Type" : "AWS::GuardDuty::MalwareProtectionPlan",
  "Properties" : {
      "Actions" : CFNActions,
      "ProtectedResource" : CFNProtectedResource,
      "Role" : String,
      "Tags" : [ TagItem, ... ]
    }
}

YAML

Type: AWS::GuardDuty::MalwareProtectionPlan
Properties:
  Actions: 
    CFNActions
  ProtectedResource: 
    CFNProtectedResource
  Role: String
  Tags: 
    - TagItem

Properties

Actions

Specifies the action that is to be applied to the Malware Protection plan resource.

Required: No

Type: CFNActions

Update requires: No interruption

ProtectedResource

Information about the protected resource. Presently, S3Bucket is the only supported protected resource.

Required: Yes

Type: CFNProtectedResource

Update requires: No interruption

Role

Amazon Resource Name (ARN) of the IAM role that includes the permissions required to scan and (optionally) add tags to the associated protected resource.

To find the ARN of your IAM role, go to the IAM console, and select the role name for details.

Required: Yes

Type: String

Update requires: No interruption

Tags

The tags to be added to the created Malware Protection plan resource. Each tag consists of a key and an optional value, both of which you need to specify.

Required: No

Type: Array of TagItem

Update requires: No interruption

Return values

Ref

When you pass the logical ID of this resource to the intrinsic Ref function, Ref returns

Fn::GetAtt

The Fn::GetAtt intrinsic function returns a value for a specified attribute of this type. The following are the available attributes and sample return values.

For more information about using the Fn::GetAtt intrinsic function, see Fn::GetAtt.

Arn

Amazon Resource Name (ARN) associated with this Malware Protection plan.

CreatedAt

The timestamp when the Malware Protection plan resource was created.

MalwareProtectionPlanId

A unique identifier associated with Malware Protection plan.

Status

Status of the Malware Protection plan resource.

StatusReasons

Status details associated with the Malware Protection plan resource status.