shield

package
v6.59.1 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Nov 12, 2024 License: Apache-2.0 Imports: 7 Imported by: 0

Documentation

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

This section is empty.

Types

type ApplicationLayerAutomaticResponse added in v6.3.0 

type ApplicationLayerAutomaticResponse struct {
	pulumi.CustomResourceState

	// One of `COUNT` or `BLOCK`
	Action pulumi.StringOutput `pulumi:"action"`
	// ARN of the resource to protect (Cloudfront Distributions and ALBs only at this time).
	ResourceArn pulumi.StringOutput                                `pulumi:"resourceArn"`
	Timeouts    ApplicationLayerAutomaticResponseTimeoutsPtrOutput `pulumi:"timeouts"`
}

Resource for managing an AWS Shield Application Layer Automatic Response for automatic DDoS mitigation.

## Example Usage

### Basic Usage

```go package main

import ( 

"fmt"

"github.com/pulumi/pulumi-aws/sdk/v6/go/aws"
"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/shield"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi/config"

) 

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := aws.GetRegion(ctx, &aws.GetRegionArgs{}, nil)
		if err != nil {
			return err
		}
		currentGetCallerIdentity, err := aws.GetCallerIdentity(ctx, &aws.GetCallerIdentityArgs{}, nil)
		if err != nil {
			return err
		}
		currentGetPartition, err := aws.GetPartition(ctx, &aws.GetPartitionArgs{}, nil)
		if err != nil {
			return err
		}
		cfg := config.New(ctx, "")
		// The Cloudfront Distribution on which to enable the Application Layer Automatic Response.
		distributionId := cfg.Require("distributionId")
		_, err = shield.NewApplicationLayerAutomaticResponse(ctx, "example", &shield.ApplicationLayerAutomaticResponseArgs{
			ResourceArn: pulumi.Sprintf("arn:%v:cloudfront:%v:distribution/%v", currentGetPartition.Partition, currentGetCallerIdentity.AccountId, distributionId),
			Action:      pulumi.String("COUNT"),
		})
		if err != nil {
			return err
		}
		return nil
	})
}

```

func GetApplicationLayerAutomaticResponse added in v6.3.0 

func GetApplicationLayerAutomaticResponse(ctx *pulumi.Context,
	name string, id pulumi.IDInput, state *ApplicationLayerAutomaticResponseState, opts ...pulumi.ResourceOption) (*ApplicationLayerAutomaticResponse, error)

GetApplicationLayerAutomaticResponse gets an existing ApplicationLayerAutomaticResponse resource's state with the given name, ID, and optional state properties that are used to uniquely qualify the lookup (nil if not required).

func NewApplicationLayerAutomaticResponse added in v6.3.0 

func NewApplicationLayerAutomaticResponse(ctx *pulumi.Context,
	name string, args *ApplicationLayerAutomaticResponseArgs, opts ...pulumi.ResourceOption) (*ApplicationLayerAutomaticResponse, error)

NewApplicationLayerAutomaticResponse registers a new resource with the given unique name, arguments, and options.

func (*ApplicationLayerAutomaticResponse) ElementType added in v6.3.0 

func (*ApplicationLayerAutomaticResponse) ElementType() reflect.Type

func (*ApplicationLayerAutomaticResponse) ToApplicationLayerAutomaticResponseOutput added in v6.3.0 

func (i *ApplicationLayerAutomaticResponse) ToApplicationLayerAutomaticResponseOutput() ApplicationLayerAutomaticResponseOutput

func (*ApplicationLayerAutomaticResponse) ToApplicationLayerAutomaticResponseOutputWithContext added in v6.3.0 

func (i *ApplicationLayerAutomaticResponse) ToApplicationLayerAutomaticResponseOutputWithContext(ctx context.Context) ApplicationLayerAutomaticResponseOutput

type ApplicationLayerAutomaticResponseArgs added in v6.3.0 

type ApplicationLayerAutomaticResponseArgs struct {
	// One of `COUNT` or `BLOCK`
	Action pulumi.StringInput
	// ARN of the resource to protect (Cloudfront Distributions and ALBs only at this time).
	ResourceArn pulumi.StringInput
	Timeouts    ApplicationLayerAutomaticResponseTimeoutsPtrInput
}

The set of arguments for constructing a ApplicationLayerAutomaticResponse resource.

func (ApplicationLayerAutomaticResponseArgs) ElementType added in v6.3.0 

func (ApplicationLayerAutomaticResponseArgs) ElementType() reflect.Type

type ApplicationLayerAutomaticResponseArray added in v6.3.0 

type ApplicationLayerAutomaticResponseArray []ApplicationLayerAutomaticResponseInput

func (ApplicationLayerAutomaticResponseArray) ElementType added in v6.3.0 

func (ApplicationLayerAutomaticResponseArray) ElementType() reflect.Type

func (ApplicationLayerAutomaticResponseArray) ToApplicationLayerAutomaticResponseArrayOutput added in v6.3.0 

func (i ApplicationLayerAutomaticResponseArray) ToApplicationLayerAutomaticResponseArrayOutput() ApplicationLayerAutomaticResponseArrayOutput

func (ApplicationLayerAutomaticResponseArray) ToApplicationLayerAutomaticResponseArrayOutputWithContext added in v6.3.0 

func (i ApplicationLayerAutomaticResponseArray) ToApplicationLayerAutomaticResponseArrayOutputWithContext(ctx context.Context) ApplicationLayerAutomaticResponseArrayOutput

type ApplicationLayerAutomaticResponseArrayInput added in v6.3.0 

type ApplicationLayerAutomaticResponseArrayInput interface {
	pulumi.Input

	ToApplicationLayerAutomaticResponseArrayOutput() ApplicationLayerAutomaticResponseArrayOutput
	ToApplicationLayerAutomaticResponseArrayOutputWithContext(context.Context) ApplicationLayerAutomaticResponseArrayOutput
}

ApplicationLayerAutomaticResponseArrayInput is an input type that accepts ApplicationLayerAutomaticResponseArray and ApplicationLayerAutomaticResponseArrayOutput values. You can construct a concrete instance of `ApplicationLayerAutomaticResponseArrayInput` via: 

ApplicationLayerAutomaticResponseArray{ ApplicationLayerAutomaticResponseArgs{...} }

type ApplicationLayerAutomaticResponseArrayOutput added in v6.3.0 

type ApplicationLayerAutomaticResponseArrayOutput struct{ *pulumi.OutputState }

func (ApplicationLayerAutomaticResponseArrayOutput) ElementType added in v6.3.0 

func (ApplicationLayerAutomaticResponseArrayOutput) ElementType() reflect.Type

func (ApplicationLayerAutomaticResponseArrayOutput) Index added in v6.3.0 

func (o ApplicationLayerAutomaticResponseArrayOutput) Index(i pulumi.IntInput) ApplicationLayerAutomaticResponseOutput

func (ApplicationLayerAutomaticResponseArrayOutput) ToApplicationLayerAutomaticResponseArrayOutput added in v6.3.0 

func (o ApplicationLayerAutomaticResponseArrayOutput) ToApplicationLayerAutomaticResponseArrayOutput() ApplicationLayerAutomaticResponseArrayOutput

func (ApplicationLayerAutomaticResponseArrayOutput) ToApplicationLayerAutomaticResponseArrayOutputWithContext added in v6.3.0 

func (o ApplicationLayerAutomaticResponseArrayOutput) ToApplicationLayerAutomaticResponseArrayOutputWithContext(ctx context.Context) ApplicationLayerAutomaticResponseArrayOutput

type ApplicationLayerAutomaticResponseInput added in v6.3.0 

type ApplicationLayerAutomaticResponseInput interface {
	pulumi.Input

	ToApplicationLayerAutomaticResponseOutput() ApplicationLayerAutomaticResponseOutput
	ToApplicationLayerAutomaticResponseOutputWithContext(ctx context.Context) ApplicationLayerAutomaticResponseOutput
}

type ApplicationLayerAutomaticResponseMap added in v6.3.0 

type ApplicationLayerAutomaticResponseMap map[string]ApplicationLayerAutomaticResponseInput

func (ApplicationLayerAutomaticResponseMap) ElementType added in v6.3.0 

func (ApplicationLayerAutomaticResponseMap) ElementType() reflect.Type

func (ApplicationLayerAutomaticResponseMap) ToApplicationLayerAutomaticResponseMapOutput added in v6.3.0 

func (i ApplicationLayerAutomaticResponseMap) ToApplicationLayerAutomaticResponseMapOutput() ApplicationLayerAutomaticResponseMapOutput

func (ApplicationLayerAutomaticResponseMap) ToApplicationLayerAutomaticResponseMapOutputWithContext added in v6.3.0 

func (i ApplicationLayerAutomaticResponseMap) ToApplicationLayerAutomaticResponseMapOutputWithContext(ctx context.Context) ApplicationLayerAutomaticResponseMapOutput

type ApplicationLayerAutomaticResponseMapInput added in v6.3.0 

type ApplicationLayerAutomaticResponseMapInput interface {
	pulumi.Input

	ToApplicationLayerAutomaticResponseMapOutput() ApplicationLayerAutomaticResponseMapOutput
	ToApplicationLayerAutomaticResponseMapOutputWithContext(context.Context) ApplicationLayerAutomaticResponseMapOutput
}

ApplicationLayerAutomaticResponseMapInput is an input type that accepts ApplicationLayerAutomaticResponseMap and ApplicationLayerAutomaticResponseMapOutput values. You can construct a concrete instance of `ApplicationLayerAutomaticResponseMapInput` via: 

ApplicationLayerAutomaticResponseMap{ "key": ApplicationLayerAutomaticResponseArgs{...} }

type ApplicationLayerAutomaticResponseMapOutput added in v6.3.0 

type ApplicationLayerAutomaticResponseMapOutput struct{ *pulumi.OutputState }

func (ApplicationLayerAutomaticResponseMapOutput) ElementType added in v6.3.0 

func (ApplicationLayerAutomaticResponseMapOutput) ElementType() reflect.Type

func (ApplicationLayerAutomaticResponseMapOutput) MapIndex added in v6.3.0 

func (o ApplicationLayerAutomaticResponseMapOutput) MapIndex(k pulumi.StringInput) ApplicationLayerAutomaticResponseOutput

func (ApplicationLayerAutomaticResponseMapOutput) ToApplicationLayerAutomaticResponseMapOutput added in v6.3.0 

func (o ApplicationLayerAutomaticResponseMapOutput) ToApplicationLayerAutomaticResponseMapOutput() ApplicationLayerAutomaticResponseMapOutput

func (ApplicationLayerAutomaticResponseMapOutput) ToApplicationLayerAutomaticResponseMapOutputWithContext added in v6.3.0 

func (o ApplicationLayerAutomaticResponseMapOutput) ToApplicationLayerAutomaticResponseMapOutputWithContext(ctx context.Context) ApplicationLayerAutomaticResponseMapOutput

type ApplicationLayerAutomaticResponseOutput added in v6.3.0 

type ApplicationLayerAutomaticResponseOutput struct{ *pulumi.OutputState }

func (ApplicationLayerAutomaticResponseOutput) Action added in v6.3.0 

func (o ApplicationLayerAutomaticResponseOutput) Action() pulumi.StringOutput

One of `COUNT` or `BLOCK`

func (ApplicationLayerAutomaticResponseOutput) ElementType added in v6.3.0 

func (ApplicationLayerAutomaticResponseOutput) ElementType() reflect.Type

func (ApplicationLayerAutomaticResponseOutput) ResourceArn added in v6.3.0 

func (o ApplicationLayerAutomaticResponseOutput) ResourceArn() pulumi.StringOutput

ARN of the resource to protect (Cloudfront Distributions and ALBs only at this time).

func (ApplicationLayerAutomaticResponseOutput) Timeouts added in v6.3.0 

func (o ApplicationLayerAutomaticResponseOutput) Timeouts() ApplicationLayerAutomaticResponseTimeoutsPtrOutput

func (ApplicationLayerAutomaticResponseOutput) ToApplicationLayerAutomaticResponseOutput added in v6.3.0 

func (o ApplicationLayerAutomaticResponseOutput) ToApplicationLayerAutomaticResponseOutput() ApplicationLayerAutomaticResponseOutput

func (ApplicationLayerAutomaticResponseOutput) ToApplicationLayerAutomaticResponseOutputWithContext added in v6.3.0 

func (o ApplicationLayerAutomaticResponseOutput) ToApplicationLayerAutomaticResponseOutputWithContext(ctx context.Context) ApplicationLayerAutomaticResponseOutput

type ApplicationLayerAutomaticResponseState added in v6.3.0 

type ApplicationLayerAutomaticResponseState struct {
	// One of `COUNT` or `BLOCK`
	Action pulumi.StringPtrInput
	// ARN of the resource to protect (Cloudfront Distributions and ALBs only at this time).
	ResourceArn pulumi.StringPtrInput
	Timeouts    ApplicationLayerAutomaticResponseTimeoutsPtrInput
}

func (ApplicationLayerAutomaticResponseState) ElementType added in v6.3.0 

func (ApplicationLayerAutomaticResponseState) ElementType() reflect.Type

type ApplicationLayerAutomaticResponseTimeouts added in v6.3.0 

type ApplicationLayerAutomaticResponseTimeouts struct {
	// A string that can be [parsed as a duration](https://pkg.go.dev/time#ParseDuration) consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).
	Create *string `pulumi:"create"`
	// A string that can be [parsed as a duration](https://pkg.go.dev/time#ParseDuration) consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours). Setting a timeout for a Delete operation is only applicable if changes are saved into state before the destroy operation occurs.
	Delete *string `pulumi:"delete"`
	// A string that can be [parsed as a duration](https://pkg.go.dev/time#ParseDuration) consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).
	Update *string `pulumi:"update"`
}

type ApplicationLayerAutomaticResponseTimeoutsArgs added in v6.3.0 

type ApplicationLayerAutomaticResponseTimeoutsArgs struct {
	// A string that can be [parsed as a duration](https://pkg.go.dev/time#ParseDuration) consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).
	Create pulumi.StringPtrInput `pulumi:"create"`
	// A string that can be [parsed as a duration](https://pkg.go.dev/time#ParseDuration) consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours). Setting a timeout for a Delete operation is only applicable if changes are saved into state before the destroy operation occurs.
	Delete pulumi.StringPtrInput `pulumi:"delete"`
	// A string that can be [parsed as a duration](https://pkg.go.dev/time#ParseDuration) consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).
	Update pulumi.StringPtrInput `pulumi:"update"`
}

func (ApplicationLayerAutomaticResponseTimeoutsArgs) ElementType added in v6.3.0 

func (ApplicationLayerAutomaticResponseTimeoutsArgs) ElementType() reflect.Type

func (ApplicationLayerAutomaticResponseTimeoutsArgs) ToApplicationLayerAutomaticResponseTimeoutsOutput added in v6.3.0 

func (i ApplicationLayerAutomaticResponseTimeoutsArgs) ToApplicationLayerAutomaticResponseTimeoutsOutput() ApplicationLayerAutomaticResponseTimeoutsOutput

func (ApplicationLayerAutomaticResponseTimeoutsArgs) ToApplicationLayerAutomaticResponseTimeoutsOutputWithContext added in v6.3.0 

func (i ApplicationLayerAutomaticResponseTimeoutsArgs) ToApplicationLayerAutomaticResponseTimeoutsOutputWithContext(ctx context.Context) ApplicationLayerAutomaticResponseTimeoutsOutput

func (ApplicationLayerAutomaticResponseTimeoutsArgs) ToApplicationLayerAutomaticResponseTimeoutsPtrOutput added in v6.3.0 

func (i ApplicationLayerAutomaticResponseTimeoutsArgs) ToApplicationLayerAutomaticResponseTimeoutsPtrOutput() ApplicationLayerAutomaticResponseTimeoutsPtrOutput

func (ApplicationLayerAutomaticResponseTimeoutsArgs) ToApplicationLayerAutomaticResponseTimeoutsPtrOutputWithContext added in v6.3.0 

func (i ApplicationLayerAutomaticResponseTimeoutsArgs) ToApplicationLayerAutomaticResponseTimeoutsPtrOutputWithContext(ctx context.Context) ApplicationLayerAutomaticResponseTimeoutsPtrOutput

type ApplicationLayerAutomaticResponseTimeoutsInput added in v6.3.0 

type ApplicationLayerAutomaticResponseTimeoutsInput interface {
	pulumi.Input

	ToApplicationLayerAutomaticResponseTimeoutsOutput() ApplicationLayerAutomaticResponseTimeoutsOutput
	ToApplicationLayerAutomaticResponseTimeoutsOutputWithContext(context.Context) ApplicationLayerAutomaticResponseTimeoutsOutput
}

ApplicationLayerAutomaticResponseTimeoutsInput is an input type that accepts ApplicationLayerAutomaticResponseTimeoutsArgs and ApplicationLayerAutomaticResponseTimeoutsOutput values. You can construct a concrete instance of `ApplicationLayerAutomaticResponseTimeoutsInput` via: 

ApplicationLayerAutomaticResponseTimeoutsArgs{...}

type ApplicationLayerAutomaticResponseTimeoutsOutput added in v6.3.0 

type ApplicationLayerAutomaticResponseTimeoutsOutput struct{ *pulumi.OutputState }

func (ApplicationLayerAutomaticResponseTimeoutsOutput) Create added in v6.3.0 

func (o ApplicationLayerAutomaticResponseTimeoutsOutput) Create() pulumi.StringPtrOutput

A string that can be [parsed as a duration](https://pkg.go.dev/time#ParseDuration) consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).

func (ApplicationLayerAutomaticResponseTimeoutsOutput) Delete added in v6.3.0 

func (o ApplicationLayerAutomaticResponseTimeoutsOutput) Delete() pulumi.StringPtrOutput

A string that can be [parsed as a duration](https://pkg.go.dev/time#ParseDuration) consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours). Setting a timeout for a Delete operation is only applicable if changes are saved into state before the destroy operation occurs.

func (ApplicationLayerAutomaticResponseTimeoutsOutput) ElementType added in v6.3.0 

func (ApplicationLayerAutomaticResponseTimeoutsOutput) ElementType() reflect.Type

func (ApplicationLayerAutomaticResponseTimeoutsOutput) ToApplicationLayerAutomaticResponseTimeoutsOutput added in v6.3.0 

func (o ApplicationLayerAutomaticResponseTimeoutsOutput) ToApplicationLayerAutomaticResponseTimeoutsOutput() ApplicationLayerAutomaticResponseTimeoutsOutput

func (ApplicationLayerAutomaticResponseTimeoutsOutput) ToApplicationLayerAutomaticResponseTimeoutsOutputWithContext added in v6.3.0 

func (o ApplicationLayerAutomaticResponseTimeoutsOutput) ToApplicationLayerAutomaticResponseTimeoutsOutputWithContext(ctx context.Context) ApplicationLayerAutomaticResponseTimeoutsOutput

func (ApplicationLayerAutomaticResponseTimeoutsOutput) ToApplicationLayerAutomaticResponseTimeoutsPtrOutput added in v6.3.0 

func (o ApplicationLayerAutomaticResponseTimeoutsOutput) ToApplicationLayerAutomaticResponseTimeoutsPtrOutput() ApplicationLayerAutomaticResponseTimeoutsPtrOutput

func (ApplicationLayerAutomaticResponseTimeoutsOutput) ToApplicationLayerAutomaticResponseTimeoutsPtrOutputWithContext added in v6.3.0 

func (o ApplicationLayerAutomaticResponseTimeoutsOutput) ToApplicationLayerAutomaticResponseTimeoutsPtrOutputWithContext(ctx context.Context) ApplicationLayerAutomaticResponseTimeoutsPtrOutput

func (ApplicationLayerAutomaticResponseTimeoutsOutput) Update added in v6.3.0 

func (o ApplicationLayerAutomaticResponseTimeoutsOutput) Update() pulumi.StringPtrOutput

A string that can be [parsed as a duration](https://pkg.go.dev/time#ParseDuration) consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).

type ApplicationLayerAutomaticResponseTimeoutsPtrInput added in v6.3.0 

type ApplicationLayerAutomaticResponseTimeoutsPtrInput interface {
	pulumi.Input

	ToApplicationLayerAutomaticResponseTimeoutsPtrOutput() ApplicationLayerAutomaticResponseTimeoutsPtrOutput
	ToApplicationLayerAutomaticResponseTimeoutsPtrOutputWithContext(context.Context) ApplicationLayerAutomaticResponseTimeoutsPtrOutput
}

ApplicationLayerAutomaticResponseTimeoutsPtrInput is an input type that accepts ApplicationLayerAutomaticResponseTimeoutsArgs, ApplicationLayerAutomaticResponseTimeoutsPtr and ApplicationLayerAutomaticResponseTimeoutsPtrOutput values. You can construct a concrete instance of `ApplicationLayerAutomaticResponseTimeoutsPtrInput` via: 

        ApplicationLayerAutomaticResponseTimeoutsArgs{...}

or:

        nil

func ApplicationLayerAutomaticResponseTimeoutsPtr added in v6.3.0 

func ApplicationLayerAutomaticResponseTimeoutsPtr(v *ApplicationLayerAutomaticResponseTimeoutsArgs) ApplicationLayerAutomaticResponseTimeoutsPtrInput

type ApplicationLayerAutomaticResponseTimeoutsPtrOutput added in v6.3.0 

type ApplicationLayerAutomaticResponseTimeoutsPtrOutput struct{ *pulumi.OutputState }

func (ApplicationLayerAutomaticResponseTimeoutsPtrOutput) Create added in v6.3.0 

func (o ApplicationLayerAutomaticResponseTimeoutsPtrOutput) Create() pulumi.StringPtrOutput

A string that can be [parsed as a duration](https://pkg.go.dev/time#ParseDuration) consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).

func (ApplicationLayerAutomaticResponseTimeoutsPtrOutput) Delete added in v6.3.0 

func (o ApplicationLayerAutomaticResponseTimeoutsPtrOutput) Delete() pulumi.StringPtrOutput

A string that can be [parsed as a duration](https://pkg.go.dev/time#ParseDuration) consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours). Setting a timeout for a Delete operation is only applicable if changes are saved into state before the destroy operation occurs.

func (ApplicationLayerAutomaticResponseTimeoutsPtrOutput) Elem added in v6.3.0 

func (o ApplicationLayerAutomaticResponseTimeoutsPtrOutput) Elem() ApplicationLayerAutomaticResponseTimeoutsOutput

func (ApplicationLayerAutomaticResponseTimeoutsPtrOutput) ElementType added in v6.3.0 

func (ApplicationLayerAutomaticResponseTimeoutsPtrOutput) ElementType() reflect.Type

func (ApplicationLayerAutomaticResponseTimeoutsPtrOutput) ToApplicationLayerAutomaticResponseTimeoutsPtrOutput added in v6.3.0 

func (o ApplicationLayerAutomaticResponseTimeoutsPtrOutput) ToApplicationLayerAutomaticResponseTimeoutsPtrOutput() ApplicationLayerAutomaticResponseTimeoutsPtrOutput

func (ApplicationLayerAutomaticResponseTimeoutsPtrOutput) ToApplicationLayerAutomaticResponseTimeoutsPtrOutputWithContext added in v6.3.0 

func (o ApplicationLayerAutomaticResponseTimeoutsPtrOutput) ToApplicationLayerAutomaticResponseTimeoutsPtrOutputWithContext(ctx context.Context) ApplicationLayerAutomaticResponseTimeoutsPtrOutput

func (ApplicationLayerAutomaticResponseTimeoutsPtrOutput) Update added in v6.3.0 

func (o ApplicationLayerAutomaticResponseTimeoutsPtrOutput) Update() pulumi.StringPtrOutput

A string that can be [parsed as a duration](https://pkg.go.dev/time#ParseDuration) consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).

type DrtAccessLogBucketAssociation added in v6.1.0 

type DrtAccessLogBucketAssociation struct {
	pulumi.CustomResourceState

	// The Amazon S3 bucket that contains the logs that you want to share.
	LogBucket pulumi.StringOutput `pulumi:"logBucket"`
	// The ID of the Role Arn association used for allowing Shield DRT Access.
	RoleArnAssociationId pulumi.StringOutput                            `pulumi:"roleArnAssociationId"`
	Timeouts             DrtAccessLogBucketAssociationTimeoutsPtrOutput `pulumi:"timeouts"`
}

Resource for managing an AWS Shield DRT Access Log Bucket Association. Up to 10 log buckets can be associated for DRT Access sharing with the Shield Response Team (SRT).

## Example Usage

### Basic Usage

```go package main

import ( 

"fmt"

"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/shield"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"

) 

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		test, err := shield.NewDrtAccessRoleArnAssociation(ctx, "test", &shield.DrtAccessRoleArnAssociationArgs{
			RoleArn: pulumi.Sprintf("arn:aws:iam:%v:%v:%v", current.Name, currentAwsCallerIdentity.AccountId, shieldDrtAccessRoleName),
		})
		if err != nil {
			return err
		}
		_, err = shield.NewDrtAccessLogBucketAssociation(ctx, "test", &shield.DrtAccessLogBucketAssociationArgs{
			LogBucket:            pulumi.Any(shieldDrtAccessLogBucket),
			RoleArnAssociationId: test.ID(),
		})
		if err != nil {
			return err
		}
		return nil
	})
}

```

## Import

Using `pulumi import`, import Shield DRT access log bucket associations using the `log_bucket`. For example:

```sh $ pulumi import aws:shield/drtAccessLogBucketAssociation:DrtAccessLogBucketAssociation example example-bucket ```

func GetDrtAccessLogBucketAssociation added in v6.1.0 

func GetDrtAccessLogBucketAssociation(ctx *pulumi.Context,
	name string, id pulumi.IDInput, state *DrtAccessLogBucketAssociationState, opts ...pulumi.ResourceOption) (*DrtAccessLogBucketAssociation, error)

GetDrtAccessLogBucketAssociation gets an existing DrtAccessLogBucketAssociation resource's state with the given name, ID, and optional state properties that are used to uniquely qualify the lookup (nil if not required).

func NewDrtAccessLogBucketAssociation added in v6.1.0 

func NewDrtAccessLogBucketAssociation(ctx *pulumi.Context,
	name string, args *DrtAccessLogBucketAssociationArgs, opts ...pulumi.ResourceOption) (*DrtAccessLogBucketAssociation, error)

NewDrtAccessLogBucketAssociation registers a new resource with the given unique name, arguments, and options.

func (*DrtAccessLogBucketAssociation) ElementType added in v6.1.0 

func (*DrtAccessLogBucketAssociation) ElementType() reflect.Type

func (*DrtAccessLogBucketAssociation) ToDrtAccessLogBucketAssociationOutput added in v6.1.0 

func (i *DrtAccessLogBucketAssociation) ToDrtAccessLogBucketAssociationOutput() DrtAccessLogBucketAssociationOutput

func (*DrtAccessLogBucketAssociation) ToDrtAccessLogBucketAssociationOutputWithContext added in v6.1.0 

func (i *DrtAccessLogBucketAssociation) ToDrtAccessLogBucketAssociationOutputWithContext(ctx context.Context) DrtAccessLogBucketAssociationOutput

type DrtAccessLogBucketAssociationArgs added in v6.1.0 

type DrtAccessLogBucketAssociationArgs struct {
	// The Amazon S3 bucket that contains the logs that you want to share.
	LogBucket pulumi.StringInput
	// The ID of the Role Arn association used for allowing Shield DRT Access.
	RoleArnAssociationId pulumi.StringInput
	Timeouts             DrtAccessLogBucketAssociationTimeoutsPtrInput
}

The set of arguments for constructing a DrtAccessLogBucketAssociation resource.

func (DrtAccessLogBucketAssociationArgs) ElementType added in v6.1.0 

func (DrtAccessLogBucketAssociationArgs) ElementType() reflect.Type

type DrtAccessLogBucketAssociationArray added in v6.1.0 

type DrtAccessLogBucketAssociationArray []DrtAccessLogBucketAssociationInput

func (DrtAccessLogBucketAssociationArray) ElementType added in v6.1.0 

func (DrtAccessLogBucketAssociationArray) ElementType() reflect.Type

func (DrtAccessLogBucketAssociationArray) ToDrtAccessLogBucketAssociationArrayOutput added in v6.1.0 

func (i DrtAccessLogBucketAssociationArray) ToDrtAccessLogBucketAssociationArrayOutput() DrtAccessLogBucketAssociationArrayOutput

func (DrtAccessLogBucketAssociationArray) ToDrtAccessLogBucketAssociationArrayOutputWithContext added in v6.1.0 

func (i DrtAccessLogBucketAssociationArray) ToDrtAccessLogBucketAssociationArrayOutputWithContext(ctx context.Context) DrtAccessLogBucketAssociationArrayOutput

type DrtAccessLogBucketAssociationArrayInput added in v6.1.0 

type DrtAccessLogBucketAssociationArrayInput interface {
	pulumi.Input

	ToDrtAccessLogBucketAssociationArrayOutput() DrtAccessLogBucketAssociationArrayOutput
	ToDrtAccessLogBucketAssociationArrayOutputWithContext(context.Context) DrtAccessLogBucketAssociationArrayOutput
}

DrtAccessLogBucketAssociationArrayInput is an input type that accepts DrtAccessLogBucketAssociationArray and DrtAccessLogBucketAssociationArrayOutput values. You can construct a concrete instance of `DrtAccessLogBucketAssociationArrayInput` via: 

DrtAccessLogBucketAssociationArray{ DrtAccessLogBucketAssociationArgs{...} }

type DrtAccessLogBucketAssociationArrayOutput added in v6.1.0 

type DrtAccessLogBucketAssociationArrayOutput struct{ *pulumi.OutputState }

func (DrtAccessLogBucketAssociationArrayOutput) ElementType added in v6.1.0 

func (DrtAccessLogBucketAssociationArrayOutput) ElementType() reflect.Type

func (DrtAccessLogBucketAssociationArrayOutput) Index added in v6.1.0 

func (o DrtAccessLogBucketAssociationArrayOutput) Index(i pulumi.IntInput) DrtAccessLogBucketAssociationOutput

func (DrtAccessLogBucketAssociationArrayOutput) ToDrtAccessLogBucketAssociationArrayOutput added in v6.1.0 

func (o DrtAccessLogBucketAssociationArrayOutput) ToDrtAccessLogBucketAssociationArrayOutput() DrtAccessLogBucketAssociationArrayOutput

func (DrtAccessLogBucketAssociationArrayOutput) ToDrtAccessLogBucketAssociationArrayOutputWithContext added in v6.1.0 

func (o DrtAccessLogBucketAssociationArrayOutput) ToDrtAccessLogBucketAssociationArrayOutputWithContext(ctx context.Context) DrtAccessLogBucketAssociationArrayOutput

type DrtAccessLogBucketAssociationInput added in v6.1.0 

type DrtAccessLogBucketAssociationInput interface {
	pulumi.Input

	ToDrtAccessLogBucketAssociationOutput() DrtAccessLogBucketAssociationOutput
	ToDrtAccessLogBucketAssociationOutputWithContext(ctx context.Context) DrtAccessLogBucketAssociationOutput
}

type DrtAccessLogBucketAssociationMap added in v6.1.0 

type DrtAccessLogBucketAssociationMap map[string]DrtAccessLogBucketAssociationInput

func (DrtAccessLogBucketAssociationMap) ElementType added in v6.1.0 

func (DrtAccessLogBucketAssociationMap) ElementType() reflect.Type

func (DrtAccessLogBucketAssociationMap) ToDrtAccessLogBucketAssociationMapOutput added in v6.1.0 

func (i DrtAccessLogBucketAssociationMap) ToDrtAccessLogBucketAssociationMapOutput() DrtAccessLogBucketAssociationMapOutput

func (DrtAccessLogBucketAssociationMap) ToDrtAccessLogBucketAssociationMapOutputWithContext added in v6.1.0 

func (i DrtAccessLogBucketAssociationMap) ToDrtAccessLogBucketAssociationMapOutputWithContext(ctx context.Context) DrtAccessLogBucketAssociationMapOutput

type DrtAccessLogBucketAssociationMapInput added in v6.1.0 

type DrtAccessLogBucketAssociationMapInput interface {
	pulumi.Input

	ToDrtAccessLogBucketAssociationMapOutput() DrtAccessLogBucketAssociationMapOutput
	ToDrtAccessLogBucketAssociationMapOutputWithContext(context.Context) DrtAccessLogBucketAssociationMapOutput
}

DrtAccessLogBucketAssociationMapInput is an input type that accepts DrtAccessLogBucketAssociationMap and DrtAccessLogBucketAssociationMapOutput values. You can construct a concrete instance of `DrtAccessLogBucketAssociationMapInput` via: 

DrtAccessLogBucketAssociationMap{ "key": DrtAccessLogBucketAssociationArgs{...} }

type DrtAccessLogBucketAssociationMapOutput added in v6.1.0 

type DrtAccessLogBucketAssociationMapOutput struct{ *pulumi.OutputState }

func (DrtAccessLogBucketAssociationMapOutput) ElementType added in v6.1.0 

func (DrtAccessLogBucketAssociationMapOutput) ElementType() reflect.Type

func (DrtAccessLogBucketAssociationMapOutput) MapIndex added in v6.1.0 

func (o DrtAccessLogBucketAssociationMapOutput) MapIndex(k pulumi.StringInput) DrtAccessLogBucketAssociationOutput

func (DrtAccessLogBucketAssociationMapOutput) ToDrtAccessLogBucketAssociationMapOutput added in v6.1.0 

func (o DrtAccessLogBucketAssociationMapOutput) ToDrtAccessLogBucketAssociationMapOutput() DrtAccessLogBucketAssociationMapOutput

func (DrtAccessLogBucketAssociationMapOutput) ToDrtAccessLogBucketAssociationMapOutputWithContext added in v6.1.0 

func (o DrtAccessLogBucketAssociationMapOutput) ToDrtAccessLogBucketAssociationMapOutputWithContext(ctx context.Context) DrtAccessLogBucketAssociationMapOutput

type DrtAccessLogBucketAssociationOutput added in v6.1.0 

type DrtAccessLogBucketAssociationOutput struct{ *pulumi.OutputState }

func (DrtAccessLogBucketAssociationOutput) ElementType added in v6.1.0 

func (DrtAccessLogBucketAssociationOutput) ElementType() reflect.Type

func (DrtAccessLogBucketAssociationOutput) LogBucket added in v6.1.0 

func (o DrtAccessLogBucketAssociationOutput) LogBucket() pulumi.StringOutput

The Amazon S3 bucket that contains the logs that you want to share.

func (DrtAccessLogBucketAssociationOutput) RoleArnAssociationId added in v6.1.0 

func (o DrtAccessLogBucketAssociationOutput) RoleArnAssociationId() pulumi.StringOutput

The ID of the Role Arn association used for allowing Shield DRT Access.

func (DrtAccessLogBucketAssociationOutput) Timeouts added in v6.1.0 

func (o DrtAccessLogBucketAssociationOutput) Timeouts() DrtAccessLogBucketAssociationTimeoutsPtrOutput

func (DrtAccessLogBucketAssociationOutput) ToDrtAccessLogBucketAssociationOutput added in v6.1.0 

func (o DrtAccessLogBucketAssociationOutput) ToDrtAccessLogBucketAssociationOutput() DrtAccessLogBucketAssociationOutput

func (DrtAccessLogBucketAssociationOutput) ToDrtAccessLogBucketAssociationOutputWithContext added in v6.1.0 

func (o DrtAccessLogBucketAssociationOutput) ToDrtAccessLogBucketAssociationOutputWithContext(ctx context.Context) DrtAccessLogBucketAssociationOutput

type DrtAccessLogBucketAssociationState added in v6.1.0 

type DrtAccessLogBucketAssociationState struct {
	// The Amazon S3 bucket that contains the logs that you want to share.
	LogBucket pulumi.StringPtrInput
	// The ID of the Role Arn association used for allowing Shield DRT Access.
	RoleArnAssociationId pulumi.StringPtrInput
	Timeouts             DrtAccessLogBucketAssociationTimeoutsPtrInput
}

func (DrtAccessLogBucketAssociationState) ElementType added in v6.1.0 

func (DrtAccessLogBucketAssociationState) ElementType() reflect.Type

type DrtAccessLogBucketAssociationTimeouts added in v6.1.0 

type DrtAccessLogBucketAssociationTimeouts struct {
	// A string that can be [parsed as a duration](https://pkg.go.dev/time#ParseDuration) consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).
	Create *string `pulumi:"create"`
	// A string that can be [parsed as a duration](https://pkg.go.dev/time#ParseDuration) consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours). Setting a timeout for a Delete operation is only applicable if changes are saved into state before the destroy operation occurs.
	Delete *string `pulumi:"delete"`
}

type DrtAccessLogBucketAssociationTimeoutsArgs added in v6.1.0 

type DrtAccessLogBucketAssociationTimeoutsArgs struct {
	// A string that can be [parsed as a duration](https://pkg.go.dev/time#ParseDuration) consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).
	Create pulumi.StringPtrInput `pulumi:"create"`
	// A string that can be [parsed as a duration](https://pkg.go.dev/time#ParseDuration) consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours). Setting a timeout for a Delete operation is only applicable if changes are saved into state before the destroy operation occurs.
	Delete pulumi.StringPtrInput `pulumi:"delete"`
}

func (DrtAccessLogBucketAssociationTimeoutsArgs) ElementType added in v6.1.0 

func (DrtAccessLogBucketAssociationTimeoutsArgs) ElementType() reflect.Type

func (DrtAccessLogBucketAssociationTimeoutsArgs) ToDrtAccessLogBucketAssociationTimeoutsOutput added in v6.1.0 

func (i DrtAccessLogBucketAssociationTimeoutsArgs) ToDrtAccessLogBucketAssociationTimeoutsOutput() DrtAccessLogBucketAssociationTimeoutsOutput

func (DrtAccessLogBucketAssociationTimeoutsArgs) ToDrtAccessLogBucketAssociationTimeoutsOutputWithContext added in v6.1.0 

func (i DrtAccessLogBucketAssociationTimeoutsArgs) ToDrtAccessLogBucketAssociationTimeoutsOutputWithContext(ctx context.Context) DrtAccessLogBucketAssociationTimeoutsOutput

func (DrtAccessLogBucketAssociationTimeoutsArgs) ToDrtAccessLogBucketAssociationTimeoutsPtrOutput added in v6.1.0 

func (i DrtAccessLogBucketAssociationTimeoutsArgs) ToDrtAccessLogBucketAssociationTimeoutsPtrOutput() DrtAccessLogBucketAssociationTimeoutsPtrOutput

func (DrtAccessLogBucketAssociationTimeoutsArgs) ToDrtAccessLogBucketAssociationTimeoutsPtrOutputWithContext added in v6.1.0 

func (i DrtAccessLogBucketAssociationTimeoutsArgs) ToDrtAccessLogBucketAssociationTimeoutsPtrOutputWithContext(ctx context.Context) DrtAccessLogBucketAssociationTimeoutsPtrOutput

type DrtAccessLogBucketAssociationTimeoutsInput added in v6.1.0 

type DrtAccessLogBucketAssociationTimeoutsInput interface {
	pulumi.Input

	ToDrtAccessLogBucketAssociationTimeoutsOutput() DrtAccessLogBucketAssociationTimeoutsOutput
	ToDrtAccessLogBucketAssociationTimeoutsOutputWithContext(context.Context) DrtAccessLogBucketAssociationTimeoutsOutput
}

DrtAccessLogBucketAssociationTimeoutsInput is an input type that accepts DrtAccessLogBucketAssociationTimeoutsArgs and DrtAccessLogBucketAssociationTimeoutsOutput values. You can construct a concrete instance of `DrtAccessLogBucketAssociationTimeoutsInput` via: 

DrtAccessLogBucketAssociationTimeoutsArgs{...}

type DrtAccessLogBucketAssociationTimeoutsOutput added in v6.1.0 

type DrtAccessLogBucketAssociationTimeoutsOutput struct{ *pulumi.OutputState }

func (DrtAccessLogBucketAssociationTimeoutsOutput) Create added in v6.1.0 

func (o DrtAccessLogBucketAssociationTimeoutsOutput) Create() pulumi.StringPtrOutput

A string that can be [parsed as a duration](https://pkg.go.dev/time#ParseDuration) consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).

func (DrtAccessLogBucketAssociationTimeoutsOutput) Delete added in v6.1.0 

func (o DrtAccessLogBucketAssociationTimeoutsOutput) Delete() pulumi.StringPtrOutput

A string that can be [parsed as a duration](https://pkg.go.dev/time#ParseDuration) consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours). Setting a timeout for a Delete operation is only applicable if changes are saved into state before the destroy operation occurs.

func (DrtAccessLogBucketAssociationTimeoutsOutput) ElementType added in v6.1.0 

func (DrtAccessLogBucketAssociationTimeoutsOutput) ElementType() reflect.Type

func (DrtAccessLogBucketAssociationTimeoutsOutput) ToDrtAccessLogBucketAssociationTimeoutsOutput added in v6.1.0 

func (o DrtAccessLogBucketAssociationTimeoutsOutput) ToDrtAccessLogBucketAssociationTimeoutsOutput() DrtAccessLogBucketAssociationTimeoutsOutput

func (DrtAccessLogBucketAssociationTimeoutsOutput) ToDrtAccessLogBucketAssociationTimeoutsOutputWithContext added in v6.1.0 

func (o DrtAccessLogBucketAssociationTimeoutsOutput) ToDrtAccessLogBucketAssociationTimeoutsOutputWithContext(ctx context.Context) DrtAccessLogBucketAssociationTimeoutsOutput

func (DrtAccessLogBucketAssociationTimeoutsOutput) ToDrtAccessLogBucketAssociationTimeoutsPtrOutput added in v6.1.0 

func (o DrtAccessLogBucketAssociationTimeoutsOutput) ToDrtAccessLogBucketAssociationTimeoutsPtrOutput() DrtAccessLogBucketAssociationTimeoutsPtrOutput

func (DrtAccessLogBucketAssociationTimeoutsOutput) ToDrtAccessLogBucketAssociationTimeoutsPtrOutputWithContext added in v6.1.0 

func (o DrtAccessLogBucketAssociationTimeoutsOutput) ToDrtAccessLogBucketAssociationTimeoutsPtrOutputWithContext(ctx context.Context) DrtAccessLogBucketAssociationTimeoutsPtrOutput

type DrtAccessLogBucketAssociationTimeoutsPtrInput added in v6.1.0 

type DrtAccessLogBucketAssociationTimeoutsPtrInput interface {
	pulumi.Input

	ToDrtAccessLogBucketAssociationTimeoutsPtrOutput() DrtAccessLogBucketAssociationTimeoutsPtrOutput
	ToDrtAccessLogBucketAssociationTimeoutsPtrOutputWithContext(context.Context) DrtAccessLogBucketAssociationTimeoutsPtrOutput
}

DrtAccessLogBucketAssociationTimeoutsPtrInput is an input type that accepts DrtAccessLogBucketAssociationTimeoutsArgs, DrtAccessLogBucketAssociationTimeoutsPtr and DrtAccessLogBucketAssociationTimeoutsPtrOutput values. You can construct a concrete instance of `DrtAccessLogBucketAssociationTimeoutsPtrInput` via: 

        DrtAccessLogBucketAssociationTimeoutsArgs{...}

or:

        nil

func DrtAccessLogBucketAssociationTimeoutsPtr added in v6.1.0 

func DrtAccessLogBucketAssociationTimeoutsPtr(v *DrtAccessLogBucketAssociationTimeoutsArgs) DrtAccessLogBucketAssociationTimeoutsPtrInput

type DrtAccessLogBucketAssociationTimeoutsPtrOutput added in v6.1.0 

type DrtAccessLogBucketAssociationTimeoutsPtrOutput struct{ *pulumi.OutputState }

func (DrtAccessLogBucketAssociationTimeoutsPtrOutput) Create added in v6.1.0 

func (o DrtAccessLogBucketAssociationTimeoutsPtrOutput) Create() pulumi.StringPtrOutput

A string that can be [parsed as a duration](https://pkg.go.dev/time#ParseDuration) consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).

func (DrtAccessLogBucketAssociationTimeoutsPtrOutput) Delete added in v6.1.0 

func (o DrtAccessLogBucketAssociationTimeoutsPtrOutput) Delete() pulumi.StringPtrOutput

A string that can be [parsed as a duration](https://pkg.go.dev/time#ParseDuration) consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours). Setting a timeout for a Delete operation is only applicable if changes are saved into state before the destroy operation occurs.

func (DrtAccessLogBucketAssociationTimeoutsPtrOutput) Elem added in v6.1.0 

func (o DrtAccessLogBucketAssociationTimeoutsPtrOutput) Elem() DrtAccessLogBucketAssociationTimeoutsOutput

func (DrtAccessLogBucketAssociationTimeoutsPtrOutput) ElementType added in v6.1.0 

func (DrtAccessLogBucketAssociationTimeoutsPtrOutput) ElementType() reflect.Type

func (DrtAccessLogBucketAssociationTimeoutsPtrOutput) ToDrtAccessLogBucketAssociationTimeoutsPtrOutput added in v6.1.0 

func (o DrtAccessLogBucketAssociationTimeoutsPtrOutput) ToDrtAccessLogBucketAssociationTimeoutsPtrOutput() DrtAccessLogBucketAssociationTimeoutsPtrOutput

func (DrtAccessLogBucketAssociationTimeoutsPtrOutput) ToDrtAccessLogBucketAssociationTimeoutsPtrOutputWithContext added in v6.1.0 

func (o DrtAccessLogBucketAssociationTimeoutsPtrOutput) ToDrtAccessLogBucketAssociationTimeoutsPtrOutputWithContext(ctx context.Context) DrtAccessLogBucketAssociationTimeoutsPtrOutput

type DrtAccessRoleArnAssociation added in v6.1.0 

type DrtAccessRoleArnAssociation struct {
	pulumi.CustomResourceState

	// The Amazon Resource Name (ARN) of the role the SRT will use to access your AWS account. Prior to making the AssociateDRTRole request, you must attach the `AWSShieldDRTAccessPolicy` managed policy to this role.
	RoleArn  pulumi.StringOutput                          `pulumi:"roleArn"`
	Timeouts DrtAccessRoleArnAssociationTimeoutsPtrOutput `pulumi:"timeouts"`
}

Authorizes the Shield Response Team (SRT) using the specified role, to access your AWS account to assist with DDoS attack mitigation during potential attacks. For more information see [Configure AWS SRT Support](https://docs.aws.amazon.com/waf/latest/developerguide/authorize-srt.html)

## Example Usage

### Basic Usage

```go package main

import ( 

"encoding/json"

"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/iam"
"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/shield"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"

) 

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		tmpJSON0, err := json.Marshal(map[string]interface{}{
			"Version": "2012-10-17",
			"Statement": []map[string]interface{}{
				map[string]interface{}{
					"Sid":    "",
					"Effect": "Allow",
					"Principal": map[string]interface{}{
						"Service": "drt.shield.amazonaws.com",
					},
					"Action": "sts:AssumeRole",
				},
			},
		})
		if err != nil {
			return err
		}
		json0 := string(tmpJSON0)
		exampleRole, err := iam.NewRole(ctx, "example", &iam.RoleArgs{
			Name:             pulumi.String("example-role"),
			AssumeRolePolicy: pulumi.String(json0),
		})
		if err != nil {
			return err
		}
		_, err = shield.NewDrtAccessRoleArnAssociation(ctx, "example", &shield.DrtAccessRoleArnAssociationArgs{
			RoleArn: exampleRole.Arn,
		})
		if err != nil {
			return err
		}
		_, err = iam.NewRolePolicyAttachment(ctx, "example", &iam.RolePolicyAttachmentArgs{
			Role:      exampleRole.Name,
			PolicyArn: pulumi.String("arn:aws:iam::aws:policy/service-role/AWSShieldDRTAccessPolicy"),
		})
		if err != nil {
			return err
		}
		return nil
	})
}

```

## Import

Using `pulumi import`, import Shield DRT access role ARN association using the AWS account ID. For example:

```sh $ pulumi import aws:shield/drtAccessRoleArnAssociation:DrtAccessRoleArnAssociation example 123456789012 ```

func GetDrtAccessRoleArnAssociation added in v6.1.0 

func GetDrtAccessRoleArnAssociation(ctx *pulumi.Context,
	name string, id pulumi.IDInput, state *DrtAccessRoleArnAssociationState, opts ...pulumi.ResourceOption) (*DrtAccessRoleArnAssociation, error)

GetDrtAccessRoleArnAssociation gets an existing DrtAccessRoleArnAssociation resource's state with the given name, ID, and optional state properties that are used to uniquely qualify the lookup (nil if not required).

func NewDrtAccessRoleArnAssociation added in v6.1.0 

func NewDrtAccessRoleArnAssociation(ctx *pulumi.Context,
	name string, args *DrtAccessRoleArnAssociationArgs, opts ...pulumi.ResourceOption) (*DrtAccessRoleArnAssociation, error)

NewDrtAccessRoleArnAssociation registers a new resource with the given unique name, arguments, and options.

func (*DrtAccessRoleArnAssociation) ElementType added in v6.1.0 

func (*DrtAccessRoleArnAssociation) ElementType() reflect.Type

func (*DrtAccessRoleArnAssociation) ToDrtAccessRoleArnAssociationOutput added in v6.1.0 

func (i *DrtAccessRoleArnAssociation) ToDrtAccessRoleArnAssociationOutput() DrtAccessRoleArnAssociationOutput

func (*DrtAccessRoleArnAssociation) ToDrtAccessRoleArnAssociationOutputWithContext added in v6.1.0 

func (i *DrtAccessRoleArnAssociation) ToDrtAccessRoleArnAssociationOutputWithContext(ctx context.Context) DrtAccessRoleArnAssociationOutput

type DrtAccessRoleArnAssociationArgs added in v6.1.0 

type DrtAccessRoleArnAssociationArgs struct {
	// The Amazon Resource Name (ARN) of the role the SRT will use to access your AWS account. Prior to making the AssociateDRTRole request, you must attach the `AWSShieldDRTAccessPolicy` managed policy to this role.
	RoleArn  pulumi.StringInput
	Timeouts DrtAccessRoleArnAssociationTimeoutsPtrInput
}

The set of arguments for constructing a DrtAccessRoleArnAssociation resource.

func (DrtAccessRoleArnAssociationArgs) ElementType added in v6.1.0 

func (DrtAccessRoleArnAssociationArgs) ElementType() reflect.Type

type DrtAccessRoleArnAssociationArray added in v6.1.0 

type DrtAccessRoleArnAssociationArray []DrtAccessRoleArnAssociationInput

func (DrtAccessRoleArnAssociationArray) ElementType added in v6.1.0 

func (DrtAccessRoleArnAssociationArray) ElementType() reflect.Type

func (DrtAccessRoleArnAssociationArray) ToDrtAccessRoleArnAssociationArrayOutput added in v6.1.0 

func (i DrtAccessRoleArnAssociationArray) ToDrtAccessRoleArnAssociationArrayOutput() DrtAccessRoleArnAssociationArrayOutput

func (DrtAccessRoleArnAssociationArray) ToDrtAccessRoleArnAssociationArrayOutputWithContext added in v6.1.0 

func (i DrtAccessRoleArnAssociationArray) ToDrtAccessRoleArnAssociationArrayOutputWithContext(ctx context.Context) DrtAccessRoleArnAssociationArrayOutput

type DrtAccessRoleArnAssociationArrayInput added in v6.1.0 

type DrtAccessRoleArnAssociationArrayInput interface {
	pulumi.Input

	ToDrtAccessRoleArnAssociationArrayOutput() DrtAccessRoleArnAssociationArrayOutput
	ToDrtAccessRoleArnAssociationArrayOutputWithContext(context.Context) DrtAccessRoleArnAssociationArrayOutput
}

DrtAccessRoleArnAssociationArrayInput is an input type that accepts DrtAccessRoleArnAssociationArray and DrtAccessRoleArnAssociationArrayOutput values. You can construct a concrete instance of `DrtAccessRoleArnAssociationArrayInput` via: 

DrtAccessRoleArnAssociationArray{ DrtAccessRoleArnAssociationArgs{...} }

type DrtAccessRoleArnAssociationArrayOutput added in v6.1.0 

type DrtAccessRoleArnAssociationArrayOutput struct{ *pulumi.OutputState }

func (DrtAccessRoleArnAssociationArrayOutput) ElementType added in v6.1.0 

func (DrtAccessRoleArnAssociationArrayOutput) ElementType() reflect.Type

func (DrtAccessRoleArnAssociationArrayOutput) Index added in v6.1.0 

func (o DrtAccessRoleArnAssociationArrayOutput) Index(i pulumi.IntInput) DrtAccessRoleArnAssociationOutput

func (DrtAccessRoleArnAssociationArrayOutput) ToDrtAccessRoleArnAssociationArrayOutput added in v6.1.0 

func (o DrtAccessRoleArnAssociationArrayOutput) ToDrtAccessRoleArnAssociationArrayOutput() DrtAccessRoleArnAssociationArrayOutput

func (DrtAccessRoleArnAssociationArrayOutput) ToDrtAccessRoleArnAssociationArrayOutputWithContext added in v6.1.0 

func (o DrtAccessRoleArnAssociationArrayOutput) ToDrtAccessRoleArnAssociationArrayOutputWithContext(ctx context.Context) DrtAccessRoleArnAssociationArrayOutput

type DrtAccessRoleArnAssociationInput added in v6.1.0 

type DrtAccessRoleArnAssociationInput interface {
	pulumi.Input

	ToDrtAccessRoleArnAssociationOutput() DrtAccessRoleArnAssociationOutput
	ToDrtAccessRoleArnAssociationOutputWithContext(ctx context.Context) DrtAccessRoleArnAssociationOutput
}

type DrtAccessRoleArnAssociationMap added in v6.1.0 

type DrtAccessRoleArnAssociationMap map[string]DrtAccessRoleArnAssociationInput

func (DrtAccessRoleArnAssociationMap) ElementType added in v6.1.0 

func (DrtAccessRoleArnAssociationMap) ElementType() reflect.Type

func (DrtAccessRoleArnAssociationMap) ToDrtAccessRoleArnAssociationMapOutput added in v6.1.0 

func (i DrtAccessRoleArnAssociationMap) ToDrtAccessRoleArnAssociationMapOutput() DrtAccessRoleArnAssociationMapOutput

func (DrtAccessRoleArnAssociationMap) ToDrtAccessRoleArnAssociationMapOutputWithContext added in v6.1.0 

func (i DrtAccessRoleArnAssociationMap) ToDrtAccessRoleArnAssociationMapOutputWithContext(ctx context.Context) DrtAccessRoleArnAssociationMapOutput

type DrtAccessRoleArnAssociationMapInput added in v6.1.0 

type DrtAccessRoleArnAssociationMapInput interface {
	pulumi.Input

	ToDrtAccessRoleArnAssociationMapOutput() DrtAccessRoleArnAssociationMapOutput
	ToDrtAccessRoleArnAssociationMapOutputWithContext(context.Context) DrtAccessRoleArnAssociationMapOutput
}

DrtAccessRoleArnAssociationMapInput is an input type that accepts DrtAccessRoleArnAssociationMap and DrtAccessRoleArnAssociationMapOutput values. You can construct a concrete instance of `DrtAccessRoleArnAssociationMapInput` via: 

DrtAccessRoleArnAssociationMap{ "key": DrtAccessRoleArnAssociationArgs{...} }

type DrtAccessRoleArnAssociationMapOutput added in v6.1.0 

type DrtAccessRoleArnAssociationMapOutput struct{ *pulumi.OutputState }

func (DrtAccessRoleArnAssociationMapOutput) ElementType added in v6.1.0 

func (DrtAccessRoleArnAssociationMapOutput) ElementType() reflect.Type

func (DrtAccessRoleArnAssociationMapOutput) MapIndex added in v6.1.0 

func (o DrtAccessRoleArnAssociationMapOutput) MapIndex(k pulumi.StringInput) DrtAccessRoleArnAssociationOutput

func (DrtAccessRoleArnAssociationMapOutput) ToDrtAccessRoleArnAssociationMapOutput added in v6.1.0 

func (o DrtAccessRoleArnAssociationMapOutput) ToDrtAccessRoleArnAssociationMapOutput() DrtAccessRoleArnAssociationMapOutput

func (DrtAccessRoleArnAssociationMapOutput) ToDrtAccessRoleArnAssociationMapOutputWithContext added in v6.1.0 

func (o DrtAccessRoleArnAssociationMapOutput) ToDrtAccessRoleArnAssociationMapOutputWithContext(ctx context.Context) DrtAccessRoleArnAssociationMapOutput

type DrtAccessRoleArnAssociationOutput added in v6.1.0 

type DrtAccessRoleArnAssociationOutput struct{ *pulumi.OutputState }

func (DrtAccessRoleArnAssociationOutput) ElementType added in v6.1.0 

func (DrtAccessRoleArnAssociationOutput) ElementType() reflect.Type

func (DrtAccessRoleArnAssociationOutput) RoleArn added in v6.1.0 

func (o DrtAccessRoleArnAssociationOutput) RoleArn() pulumi.StringOutput

The Amazon Resource Name (ARN) of the role the SRT will use to access your AWS account. Prior to making the AssociateDRTRole request, you must attach the `AWSShieldDRTAccessPolicy` managed policy to this role.

func (DrtAccessRoleArnAssociationOutput) Timeouts added in v6.1.0 

func (o DrtAccessRoleArnAssociationOutput) Timeouts() DrtAccessRoleArnAssociationTimeoutsPtrOutput

func (DrtAccessRoleArnAssociationOutput) ToDrtAccessRoleArnAssociationOutput added in v6.1.0 

func (o DrtAccessRoleArnAssociationOutput) ToDrtAccessRoleArnAssociationOutput() DrtAccessRoleArnAssociationOutput

func (DrtAccessRoleArnAssociationOutput) ToDrtAccessRoleArnAssociationOutputWithContext added in v6.1.0 

func (o DrtAccessRoleArnAssociationOutput) ToDrtAccessRoleArnAssociationOutputWithContext(ctx context.Context) DrtAccessRoleArnAssociationOutput

type DrtAccessRoleArnAssociationState added in v6.1.0 

type DrtAccessRoleArnAssociationState struct {
	// The Amazon Resource Name (ARN) of the role the SRT will use to access your AWS account. Prior to making the AssociateDRTRole request, you must attach the `AWSShieldDRTAccessPolicy` managed policy to this role.
	RoleArn  pulumi.StringPtrInput
	Timeouts DrtAccessRoleArnAssociationTimeoutsPtrInput
}

func (DrtAccessRoleArnAssociationState) ElementType added in v6.1.0 

func (DrtAccessRoleArnAssociationState) ElementType() reflect.Type

type DrtAccessRoleArnAssociationTimeouts added in v6.1.0 

type DrtAccessRoleArnAssociationTimeouts struct {
	// A string that can be [parsed as a duration](https://pkg.go.dev/time#ParseDuration) consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).
	Create *string `pulumi:"create"`
	// A string that can be [parsed as a duration](https://pkg.go.dev/time#ParseDuration) consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours). Setting a timeout for a Delete operation is only applicable if changes are saved into state before the destroy operation occurs.
	Delete *string `pulumi:"delete"`
	// A string that can be [parsed as a duration](https://pkg.go.dev/time#ParseDuration) consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).
	Update *string `pulumi:"update"`
}

type DrtAccessRoleArnAssociationTimeoutsArgs added in v6.1.0 

type DrtAccessRoleArnAssociationTimeoutsArgs struct {
	// A string that can be [parsed as a duration](https://pkg.go.dev/time#ParseDuration) consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).
	Create pulumi.StringPtrInput `pulumi:"create"`
	// A string that can be [parsed as a duration](https://pkg.go.dev/time#ParseDuration) consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours). Setting a timeout for a Delete operation is only applicable if changes are saved into state before the destroy operation occurs.
	Delete pulumi.StringPtrInput `pulumi:"delete"`
	// A string that can be [parsed as a duration](https://pkg.go.dev/time#ParseDuration) consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).
	Update pulumi.StringPtrInput `pulumi:"update"`
}

func (DrtAccessRoleArnAssociationTimeoutsArgs) ElementType added in v6.1.0 

func (DrtAccessRoleArnAssociationTimeoutsArgs) ElementType() reflect.Type

func (DrtAccessRoleArnAssociationTimeoutsArgs) ToDrtAccessRoleArnAssociationTimeoutsOutput added in v6.1.0 

func (i DrtAccessRoleArnAssociationTimeoutsArgs) ToDrtAccessRoleArnAssociationTimeoutsOutput() DrtAccessRoleArnAssociationTimeoutsOutput

func (DrtAccessRoleArnAssociationTimeoutsArgs) ToDrtAccessRoleArnAssociationTimeoutsOutputWithContext added in v6.1.0 

func (i DrtAccessRoleArnAssociationTimeoutsArgs) ToDrtAccessRoleArnAssociationTimeoutsOutputWithContext(ctx context.Context) DrtAccessRoleArnAssociationTimeoutsOutput

func (DrtAccessRoleArnAssociationTimeoutsArgs) ToDrtAccessRoleArnAssociationTimeoutsPtrOutput added in v6.1.0 

func (i DrtAccessRoleArnAssociationTimeoutsArgs) ToDrtAccessRoleArnAssociationTimeoutsPtrOutput() DrtAccessRoleArnAssociationTimeoutsPtrOutput

func (DrtAccessRoleArnAssociationTimeoutsArgs) ToDrtAccessRoleArnAssociationTimeoutsPtrOutputWithContext added in v6.1.0 

func (i DrtAccessRoleArnAssociationTimeoutsArgs) ToDrtAccessRoleArnAssociationTimeoutsPtrOutputWithContext(ctx context.Context) DrtAccessRoleArnAssociationTimeoutsPtrOutput

type DrtAccessRoleArnAssociationTimeoutsInput added in v6.1.0 

type DrtAccessRoleArnAssociationTimeoutsInput interface {
	pulumi.Input

	ToDrtAccessRoleArnAssociationTimeoutsOutput() DrtAccessRoleArnAssociationTimeoutsOutput
	ToDrtAccessRoleArnAssociationTimeoutsOutputWithContext(context.Context) DrtAccessRoleArnAssociationTimeoutsOutput
}

DrtAccessRoleArnAssociationTimeoutsInput is an input type that accepts DrtAccessRoleArnAssociationTimeoutsArgs and DrtAccessRoleArnAssociationTimeoutsOutput values. You can construct a concrete instance of `DrtAccessRoleArnAssociationTimeoutsInput` via: 

DrtAccessRoleArnAssociationTimeoutsArgs{...}

type DrtAccessRoleArnAssociationTimeoutsOutput added in v6.1.0 

type DrtAccessRoleArnAssociationTimeoutsOutput struct{ *pulumi.OutputState }

func (DrtAccessRoleArnAssociationTimeoutsOutput) Create added in v6.1.0 

func (o DrtAccessRoleArnAssociationTimeoutsOutput) Create() pulumi.StringPtrOutput

A string that can be [parsed as a duration](https://pkg.go.dev/time#ParseDuration) consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).

func (DrtAccessRoleArnAssociationTimeoutsOutput) Delete added in v6.1.0 

func (o DrtAccessRoleArnAssociationTimeoutsOutput) Delete() pulumi.StringPtrOutput

A string that can be [parsed as a duration](https://pkg.go.dev/time#ParseDuration) consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours). Setting a timeout for a Delete operation is only applicable if changes are saved into state before the destroy operation occurs.

func (DrtAccessRoleArnAssociationTimeoutsOutput) ElementType added in v6.1.0 

func (DrtAccessRoleArnAssociationTimeoutsOutput) ElementType() reflect.Type

func (DrtAccessRoleArnAssociationTimeoutsOutput) ToDrtAccessRoleArnAssociationTimeoutsOutput added in v6.1.0 

func (o DrtAccessRoleArnAssociationTimeoutsOutput) ToDrtAccessRoleArnAssociationTimeoutsOutput() DrtAccessRoleArnAssociationTimeoutsOutput

func (DrtAccessRoleArnAssociationTimeoutsOutput) ToDrtAccessRoleArnAssociationTimeoutsOutputWithContext added in v6.1.0 

func (o DrtAccessRoleArnAssociationTimeoutsOutput) ToDrtAccessRoleArnAssociationTimeoutsOutputWithContext(ctx context.Context) DrtAccessRoleArnAssociationTimeoutsOutput

func (DrtAccessRoleArnAssociationTimeoutsOutput) ToDrtAccessRoleArnAssociationTimeoutsPtrOutput added in v6.1.0 

func (o DrtAccessRoleArnAssociationTimeoutsOutput) ToDrtAccessRoleArnAssociationTimeoutsPtrOutput() DrtAccessRoleArnAssociationTimeoutsPtrOutput

func (DrtAccessRoleArnAssociationTimeoutsOutput) ToDrtAccessRoleArnAssociationTimeoutsPtrOutputWithContext added in v6.1.0 

func (o DrtAccessRoleArnAssociationTimeoutsOutput) ToDrtAccessRoleArnAssociationTimeoutsPtrOutputWithContext(ctx context.Context) DrtAccessRoleArnAssociationTimeoutsPtrOutput

func (DrtAccessRoleArnAssociationTimeoutsOutput) Update added in v6.25.0 

func (o DrtAccessRoleArnAssociationTimeoutsOutput) Update() pulumi.StringPtrOutput

A string that can be [parsed as a duration](https://pkg.go.dev/time#ParseDuration) consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).

type DrtAccessRoleArnAssociationTimeoutsPtrInput added in v6.1.0 

type DrtAccessRoleArnAssociationTimeoutsPtrInput interface {
	pulumi.Input

	ToDrtAccessRoleArnAssociationTimeoutsPtrOutput() DrtAccessRoleArnAssociationTimeoutsPtrOutput
	ToDrtAccessRoleArnAssociationTimeoutsPtrOutputWithContext(context.Context) DrtAccessRoleArnAssociationTimeoutsPtrOutput
}

DrtAccessRoleArnAssociationTimeoutsPtrInput is an input type that accepts DrtAccessRoleArnAssociationTimeoutsArgs, DrtAccessRoleArnAssociationTimeoutsPtr and DrtAccessRoleArnAssociationTimeoutsPtrOutput values. You can construct a concrete instance of `DrtAccessRoleArnAssociationTimeoutsPtrInput` via: 

        DrtAccessRoleArnAssociationTimeoutsArgs{...}

or:

        nil

func DrtAccessRoleArnAssociationTimeoutsPtr added in v6.1.0 

func DrtAccessRoleArnAssociationTimeoutsPtr(v *DrtAccessRoleArnAssociationTimeoutsArgs) DrtAccessRoleArnAssociationTimeoutsPtrInput

type DrtAccessRoleArnAssociationTimeoutsPtrOutput added in v6.1.0 

type DrtAccessRoleArnAssociationTimeoutsPtrOutput struct{ *pulumi.OutputState }

func (DrtAccessRoleArnAssociationTimeoutsPtrOutput) Create added in v6.1.0 

func (o DrtAccessRoleArnAssociationTimeoutsPtrOutput) Create() pulumi.StringPtrOutput

A string that can be [parsed as a duration](https://pkg.go.dev/time#ParseDuration) consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).

func (DrtAccessRoleArnAssociationTimeoutsPtrOutput) Delete added in v6.1.0 

func (o DrtAccessRoleArnAssociationTimeoutsPtrOutput) Delete() pulumi.StringPtrOutput

A string that can be [parsed as a duration](https://pkg.go.dev/time#ParseDuration) consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours). Setting a timeout for a Delete operation is only applicable if changes are saved into state before the destroy operation occurs.

func (DrtAccessRoleArnAssociationTimeoutsPtrOutput) Elem added in v6.1.0 

func (o DrtAccessRoleArnAssociationTimeoutsPtrOutput) Elem() DrtAccessRoleArnAssociationTimeoutsOutput

func (DrtAccessRoleArnAssociationTimeoutsPtrOutput) ElementType added in v6.1.0 

func (DrtAccessRoleArnAssociationTimeoutsPtrOutput) ElementType() reflect.Type

func (DrtAccessRoleArnAssociationTimeoutsPtrOutput) ToDrtAccessRoleArnAssociationTimeoutsPtrOutput added in v6.1.0 

func (o DrtAccessRoleArnAssociationTimeoutsPtrOutput) ToDrtAccessRoleArnAssociationTimeoutsPtrOutput() DrtAccessRoleArnAssociationTimeoutsPtrOutput

func (DrtAccessRoleArnAssociationTimeoutsPtrOutput) ToDrtAccessRoleArnAssociationTimeoutsPtrOutputWithContext added in v6.1.0 

func (o DrtAccessRoleArnAssociationTimeoutsPtrOutput) ToDrtAccessRoleArnAssociationTimeoutsPtrOutputWithContext(ctx context.Context) DrtAccessRoleArnAssociationTimeoutsPtrOutput

func (DrtAccessRoleArnAssociationTimeoutsPtrOutput) Update added in v6.25.0 

func (o DrtAccessRoleArnAssociationTimeoutsPtrOutput) Update() pulumi.StringPtrOutput

A string that can be [parsed as a duration](https://pkg.go.dev/time#ParseDuration) consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).

type LookupProtectionArgs added in v6.51.0 

type LookupProtectionArgs struct {
	// Unique identifier for the protection.
	ProtectionId *string `pulumi:"protectionId"`
	// ARN (Amazon Resource Name) of the resource being protected.
	ResourceArn *string `pulumi:"resourceArn"`
}

A collection of arguments for invoking getProtection.

type LookupProtectionOutputArgs added in v6.51.0 

type LookupProtectionOutputArgs struct {
	// Unique identifier for the protection.
	ProtectionId pulumi.StringPtrInput `pulumi:"protectionId"`
	// ARN (Amazon Resource Name) of the resource being protected.
	ResourceArn pulumi.StringPtrInput `pulumi:"resourceArn"`
}

A collection of arguments for invoking getProtection.

func (LookupProtectionOutputArgs) ElementType added in v6.51.0 

func (LookupProtectionOutputArgs) ElementType() reflect.Type

type LookupProtectionResult added in v6.51.0 

type LookupProtectionResult struct {
	Id string `pulumi:"id"`
	// Name of the protection.
	Name string `pulumi:"name"`
	// ARN of the protection.
	ProtectionArn string `pulumi:"protectionArn"`
	ProtectionId  string `pulumi:"protectionId"`
	ResourceArn   string `pulumi:"resourceArn"`
}

A collection of values returned by getProtection.

func LookupProtection added in v6.51.0 

func LookupProtection(ctx *pulumi.Context, args *LookupProtectionArgs, opts ...pulumi.InvokeOption) (*LookupProtectionResult, error)

Data source for managing an AWS Shield Protection.

## Example Usage

### Basic Usage

```go package main

import ( 

"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/shield"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"

) 

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := shield.LookupProtection(ctx, &shield.LookupProtectionArgs{
			ProtectionId: pulumi.StringRef("abc123"),
		}, nil)
		if err != nil {
			return err
		}
		return nil
	})
}

```

### By Resource ARN

```go package main

import ( 

"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/shield"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"

) 

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := shield.LookupProtection(ctx, &shield.LookupProtectionArgs{
			ResourceArn: pulumi.StringRef("arn:aws:globalaccelerator::123456789012:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh"),
		}, nil)
		if err != nil {
			return err
		}
		return nil
	})
}

```

type LookupProtectionResultOutput added in v6.51.0 

type LookupProtectionResultOutput struct{ *pulumi.OutputState }

A collection of values returned by getProtection.

func LookupProtectionOutput added in v6.51.0 

func LookupProtectionOutput(ctx *pulumi.Context, args LookupProtectionOutputArgs, opts ...pulumi.InvokeOption) LookupProtectionResultOutput

func (LookupProtectionResultOutput) ElementType added in v6.51.0 

func (LookupProtectionResultOutput) ElementType() reflect.Type

func (LookupProtectionResultOutput) Id added in v6.51.0 

func (o LookupProtectionResultOutput) Id() pulumi.StringOutput

func (LookupProtectionResultOutput) Name added in v6.51.0 

func (o LookupProtectionResultOutput) Name() pulumi.StringOutput

Name of the protection.

func (LookupProtectionResultOutput) ProtectionArn added in v6.51.0 

func (o LookupProtectionResultOutput) ProtectionArn() pulumi.StringOutput

ARN of the protection.

func (LookupProtectionResultOutput) ProtectionId added in v6.51.0 

func (o LookupProtectionResultOutput) ProtectionId() pulumi.StringOutput

func (LookupProtectionResultOutput) ResourceArn added in v6.51.0 

func (o LookupProtectionResultOutput) ResourceArn() pulumi.StringOutput

func (LookupProtectionResultOutput) ToLookupProtectionResultOutput added in v6.51.0 

func (o LookupProtectionResultOutput) ToLookupProtectionResultOutput() LookupProtectionResultOutput

func (LookupProtectionResultOutput) ToLookupProtectionResultOutputWithContext added in v6.51.0 

func (o LookupProtectionResultOutput) ToLookupProtectionResultOutputWithContext(ctx context.Context) LookupProtectionResultOutput

type ProactiveEngagement added in v6.25.0 

type ProactiveEngagement struct {
	pulumi.CustomResourceState

	// One or more emergency contacts. You must provide at least one phone number in the emergency contact list. See `emergencyContacts`.
	EmergencyContacts ProactiveEngagementEmergencyContactArrayOutput `pulumi:"emergencyContacts"`
	// Boolean value indicating if Proactive Engagement should be enabled or not.
	Enabled pulumi.BoolOutput `pulumi:"enabled"`
}

Resource for managing a AWS Shield Proactive Engagement. Proactive engagement authorizes the Shield Response Team (SRT) to use email and phone to notify contacts about escalations to the SRT and to initiate proactive customer support.

## Example Usage

### Basic Usage

```go package main

import ( 

"encoding/json"

"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/iam"
"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/shield"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"

) 

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		tmpJSON0, err := json.Marshal(map[string]interface{}{
			"Version": "2012-10-17",
			"Statement": []map[string]interface{}{
				map[string]interface{}{
					"Sid":    "",
					"Effect": "Allow",
					"Principal": map[string]interface{}{
						"Service": "drt.shield.amazonaws.com",
					},
					"Action": "sts:AssumeRole",
				},
			},
		})
		if err != nil {
			return err
		}
		json0 := string(tmpJSON0)
		exampleRole, err := iam.NewRole(ctx, "example", &iam.RoleArgs{
			Name:             pulumi.String("example-role"),
			AssumeRolePolicy: pulumi.String(json0),
		})
		if err != nil {
			return err
		}
		exampleDrtAccessRoleArnAssociation, err := shield.NewDrtAccessRoleArnAssociation(ctx, "example", &shield.DrtAccessRoleArnAssociationArgs{
			RoleArn: exampleRole.Arn,
		})
		if err != nil {
			return err
		}
		_, err = shield.NewProactiveEngagement(ctx, "example", &shield.ProactiveEngagementArgs{
			Enabled: pulumi.Bool(true),
			EmergencyContacts: shield.ProactiveEngagementEmergencyContactArray{
				&shield.ProactiveEngagementEmergencyContactArgs{
					ContactNotes: pulumi.String("Notes"),
					EmailAddress: pulumi.String("contact1@example.com"),
					PhoneNumber:  pulumi.String("+12358132134"),
				},
				&shield.ProactiveEngagementEmergencyContactArgs{
					ContactNotes: pulumi.String("Notes 2"),
					EmailAddress: pulumi.String("contact2@example.com"),
					PhoneNumber:  pulumi.String("+12358132134"),
				},
			},
		}, pulumi.DependsOn([]pulumi.Resource{
			exampleDrtAccessRoleArnAssociation,
		}))
		if err != nil {
			return err
		}
		_, err = iam.NewRolePolicyAttachment(ctx, "example", &iam.RolePolicyAttachmentArgs{
			Role:      exampleRole.Name,
			PolicyArn: pulumi.String("arn:aws:iam::aws:policy/service-role/AWSShieldDRTAccessPolicy"),
		})
		if err != nil {
			return err
		}
		_, err = shield.NewProtectionGroup(ctx, "example", &shield.ProtectionGroupArgs{
			ProtectionGroupId: pulumi.String("example"),
			Aggregation:       pulumi.String("MAX"),
			Pattern:           pulumi.String("ALL"),
		})
		if err != nil {
			return err
		}
		return nil
	})
}

```

## Import

Using `pulumi import`, import Shield proactive engagement using the AWS account ID. For example:

```sh $ pulumi import aws:shield/proactiveEngagement:ProactiveEngagement example 123456789012 ```

func GetProactiveEngagement added in v6.25.0 

func GetProactiveEngagement(ctx *pulumi.Context,
	name string, id pulumi.IDInput, state *ProactiveEngagementState, opts ...pulumi.ResourceOption) (*ProactiveEngagement, error)

GetProactiveEngagement gets an existing ProactiveEngagement resource's state with the given name, ID, and optional state properties that are used to uniquely qualify the lookup (nil if not required).

func NewProactiveEngagement added in v6.25.0 

func NewProactiveEngagement(ctx *pulumi.Context,
	name string, args *ProactiveEngagementArgs, opts ...pulumi.ResourceOption) (*ProactiveEngagement, error)

NewProactiveEngagement registers a new resource with the given unique name, arguments, and options.

func (*ProactiveEngagement) ElementType added in v6.25.0 

func (*ProactiveEngagement) ElementType() reflect.Type

func (*ProactiveEngagement) ToProactiveEngagementOutput added in v6.25.0 

func (i *ProactiveEngagement) ToProactiveEngagementOutput() ProactiveEngagementOutput

func (*ProactiveEngagement) ToProactiveEngagementOutputWithContext added in v6.25.0 

func (i *ProactiveEngagement) ToProactiveEngagementOutputWithContext(ctx context.Context) ProactiveEngagementOutput

type ProactiveEngagementArgs added in v6.25.0 

type ProactiveEngagementArgs struct {
	// One or more emergency contacts. You must provide at least one phone number in the emergency contact list. See `emergencyContacts`.
	EmergencyContacts ProactiveEngagementEmergencyContactArrayInput
	// Boolean value indicating if Proactive Engagement should be enabled or not.
	Enabled pulumi.BoolInput
}

The set of arguments for constructing a ProactiveEngagement resource.

func (ProactiveEngagementArgs) ElementType added in v6.25.0 

func (ProactiveEngagementArgs) ElementType() reflect.Type

type ProactiveEngagementArray added in v6.25.0 

type ProactiveEngagementArray []ProactiveEngagementInput

func (ProactiveEngagementArray) ElementType added in v6.25.0 

func (ProactiveEngagementArray) ElementType() reflect.Type

func (ProactiveEngagementArray) ToProactiveEngagementArrayOutput added in v6.25.0 

func (i ProactiveEngagementArray) ToProactiveEngagementArrayOutput() ProactiveEngagementArrayOutput

func (ProactiveEngagementArray) ToProactiveEngagementArrayOutputWithContext added in v6.25.0 

func (i ProactiveEngagementArray) ToProactiveEngagementArrayOutputWithContext(ctx context.Context) ProactiveEngagementArrayOutput

type ProactiveEngagementArrayInput added in v6.25.0 

type ProactiveEngagementArrayInput interface {
	pulumi.Input

	ToProactiveEngagementArrayOutput() ProactiveEngagementArrayOutput
	ToProactiveEngagementArrayOutputWithContext(context.Context) ProactiveEngagementArrayOutput
}

ProactiveEngagementArrayInput is an input type that accepts ProactiveEngagementArray and ProactiveEngagementArrayOutput values. You can construct a concrete instance of `ProactiveEngagementArrayInput` via: 

ProactiveEngagementArray{ ProactiveEngagementArgs{...} }

type ProactiveEngagementArrayOutput added in v6.25.0 

type ProactiveEngagementArrayOutput struct{ *pulumi.OutputState }

func (ProactiveEngagementArrayOutput) ElementType added in v6.25.0 

func (ProactiveEngagementArrayOutput) ElementType() reflect.Type

func (ProactiveEngagementArrayOutput) Index added in v6.25.0 

func (o ProactiveEngagementArrayOutput) Index(i pulumi.IntInput) ProactiveEngagementOutput

func (ProactiveEngagementArrayOutput) ToProactiveEngagementArrayOutput added in v6.25.0 

func (o ProactiveEngagementArrayOutput) ToProactiveEngagementArrayOutput() ProactiveEngagementArrayOutput

func (ProactiveEngagementArrayOutput) ToProactiveEngagementArrayOutputWithContext added in v6.25.0 

func (o ProactiveEngagementArrayOutput) ToProactiveEngagementArrayOutputWithContext(ctx context.Context) ProactiveEngagementArrayOutput

type ProactiveEngagementEmergencyContact added in v6.25.0 

type ProactiveEngagementEmergencyContact struct {
	// Additional notes regarding the contact.
	ContactNotes *string `pulumi:"contactNotes"`
	// A valid email address that will be used for this contact.
	EmailAddress string `pulumi:"emailAddress"`
	// A phone number, starting with `+` and up to 15 digits that will be used for this contact.
	PhoneNumber *string `pulumi:"phoneNumber"`
}

type ProactiveEngagementEmergencyContactArgs added in v6.25.0 

type ProactiveEngagementEmergencyContactArgs struct {
	// Additional notes regarding the contact.
	ContactNotes pulumi.StringPtrInput `pulumi:"contactNotes"`
	// A valid email address that will be used for this contact.
	EmailAddress pulumi.StringInput `pulumi:"emailAddress"`
	// A phone number, starting with `+` and up to 15 digits that will be used for this contact.
	PhoneNumber pulumi.StringPtrInput `pulumi:"phoneNumber"`
}

func (ProactiveEngagementEmergencyContactArgs) ElementType added in v6.25.0 

func (ProactiveEngagementEmergencyContactArgs) ElementType() reflect.Type

func (ProactiveEngagementEmergencyContactArgs) ToProactiveEngagementEmergencyContactOutput added in v6.25.0 

func (i ProactiveEngagementEmergencyContactArgs) ToProactiveEngagementEmergencyContactOutput() ProactiveEngagementEmergencyContactOutput

func (ProactiveEngagementEmergencyContactArgs) ToProactiveEngagementEmergencyContactOutputWithContext added in v6.25.0 

func (i ProactiveEngagementEmergencyContactArgs) ToProactiveEngagementEmergencyContactOutputWithContext(ctx context.Context) ProactiveEngagementEmergencyContactOutput

type ProactiveEngagementEmergencyContactArray added in v6.25.0 

type ProactiveEngagementEmergencyContactArray []ProactiveEngagementEmergencyContactInput

func (ProactiveEngagementEmergencyContactArray) ElementType added in v6.25.0 

func (ProactiveEngagementEmergencyContactArray) ElementType() reflect.Type

func (ProactiveEngagementEmergencyContactArray) ToProactiveEngagementEmergencyContactArrayOutput added in v6.25.0 

func (i ProactiveEngagementEmergencyContactArray) ToProactiveEngagementEmergencyContactArrayOutput() ProactiveEngagementEmergencyContactArrayOutput

func (ProactiveEngagementEmergencyContactArray) ToProactiveEngagementEmergencyContactArrayOutputWithContext added in v6.25.0 

func (i ProactiveEngagementEmergencyContactArray) ToProactiveEngagementEmergencyContactArrayOutputWithContext(ctx context.Context) ProactiveEngagementEmergencyContactArrayOutput

type ProactiveEngagementEmergencyContactArrayInput added in v6.25.0 

type ProactiveEngagementEmergencyContactArrayInput interface {
	pulumi.Input

	ToProactiveEngagementEmergencyContactArrayOutput() ProactiveEngagementEmergencyContactArrayOutput
	ToProactiveEngagementEmergencyContactArrayOutputWithContext(context.Context) ProactiveEngagementEmergencyContactArrayOutput
}

ProactiveEngagementEmergencyContactArrayInput is an input type that accepts ProactiveEngagementEmergencyContactArray and ProactiveEngagementEmergencyContactArrayOutput values. You can construct a concrete instance of `ProactiveEngagementEmergencyContactArrayInput` via: 

ProactiveEngagementEmergencyContactArray{ ProactiveEngagementEmergencyContactArgs{...} }

type ProactiveEngagementEmergencyContactArrayOutput added in v6.25.0 

type ProactiveEngagementEmergencyContactArrayOutput struct{ *pulumi.OutputState }

func (ProactiveEngagementEmergencyContactArrayOutput) ElementType added in v6.25.0 

func (ProactiveEngagementEmergencyContactArrayOutput) ElementType() reflect.Type

func (ProactiveEngagementEmergencyContactArrayOutput) Index added in v6.25.0 

func (o ProactiveEngagementEmergencyContactArrayOutput) Index(i pulumi.IntInput) ProactiveEngagementEmergencyContactOutput

func (ProactiveEngagementEmergencyContactArrayOutput) ToProactiveEngagementEmergencyContactArrayOutput added in v6.25.0 

func (o ProactiveEngagementEmergencyContactArrayOutput) ToProactiveEngagementEmergencyContactArrayOutput() ProactiveEngagementEmergencyContactArrayOutput

func (ProactiveEngagementEmergencyContactArrayOutput) ToProactiveEngagementEmergencyContactArrayOutputWithContext added in v6.25.0 

func (o ProactiveEngagementEmergencyContactArrayOutput) ToProactiveEngagementEmergencyContactArrayOutputWithContext(ctx context.Context) ProactiveEngagementEmergencyContactArrayOutput

type ProactiveEngagementEmergencyContactInput added in v6.25.0 

type ProactiveEngagementEmergencyContactInput interface {
	pulumi.Input

	ToProactiveEngagementEmergencyContactOutput() ProactiveEngagementEmergencyContactOutput
	ToProactiveEngagementEmergencyContactOutputWithContext(context.Context) ProactiveEngagementEmergencyContactOutput
}

ProactiveEngagementEmergencyContactInput is an input type that accepts ProactiveEngagementEmergencyContactArgs and ProactiveEngagementEmergencyContactOutput values. You can construct a concrete instance of `ProactiveEngagementEmergencyContactInput` via: 

ProactiveEngagementEmergencyContactArgs{...}

type ProactiveEngagementEmergencyContactOutput added in v6.25.0 

type ProactiveEngagementEmergencyContactOutput struct{ *pulumi.OutputState }

func (ProactiveEngagementEmergencyContactOutput) ContactNotes added in v6.25.0 

func (o ProactiveEngagementEmergencyContactOutput) ContactNotes() pulumi.StringPtrOutput

Additional notes regarding the contact.

func (ProactiveEngagementEmergencyContactOutput) ElementType added in v6.25.0 

func (ProactiveEngagementEmergencyContactOutput) ElementType() reflect.Type

func (ProactiveEngagementEmergencyContactOutput) EmailAddress added in v6.25.0 

func (o ProactiveEngagementEmergencyContactOutput) EmailAddress() pulumi.StringOutput

A valid email address that will be used for this contact.

func (ProactiveEngagementEmergencyContactOutput) PhoneNumber added in v6.25.0 

func (o ProactiveEngagementEmergencyContactOutput) PhoneNumber() pulumi.StringPtrOutput

A phone number, starting with `+` and up to 15 digits that will be used for this contact.

func (ProactiveEngagementEmergencyContactOutput) ToProactiveEngagementEmergencyContactOutput added in v6.25.0 

func (o ProactiveEngagementEmergencyContactOutput) ToProactiveEngagementEmergencyContactOutput() ProactiveEngagementEmergencyContactOutput

func (ProactiveEngagementEmergencyContactOutput) ToProactiveEngagementEmergencyContactOutputWithContext added in v6.25.0 

func (o ProactiveEngagementEmergencyContactOutput) ToProactiveEngagementEmergencyContactOutputWithContext(ctx context.Context) ProactiveEngagementEmergencyContactOutput

type ProactiveEngagementInput added in v6.25.0 

type ProactiveEngagementInput interface {
	pulumi.Input

	ToProactiveEngagementOutput() ProactiveEngagementOutput
	ToProactiveEngagementOutputWithContext(ctx context.Context) ProactiveEngagementOutput
}

type ProactiveEngagementMap added in v6.25.0 

type ProactiveEngagementMap map[string]ProactiveEngagementInput

func (ProactiveEngagementMap) ElementType added in v6.25.0 

func (ProactiveEngagementMap) ElementType() reflect.Type

func (ProactiveEngagementMap) ToProactiveEngagementMapOutput added in v6.25.0 

func (i ProactiveEngagementMap) ToProactiveEngagementMapOutput() ProactiveEngagementMapOutput

func (ProactiveEngagementMap) ToProactiveEngagementMapOutputWithContext added in v6.25.0 

func (i ProactiveEngagementMap) ToProactiveEngagementMapOutputWithContext(ctx context.Context) ProactiveEngagementMapOutput

type ProactiveEngagementMapInput added in v6.25.0 

type ProactiveEngagementMapInput interface {
	pulumi.Input

	ToProactiveEngagementMapOutput() ProactiveEngagementMapOutput
	ToProactiveEngagementMapOutputWithContext(context.Context) ProactiveEngagementMapOutput
}

ProactiveEngagementMapInput is an input type that accepts ProactiveEngagementMap and ProactiveEngagementMapOutput values. You can construct a concrete instance of `ProactiveEngagementMapInput` via: 

ProactiveEngagementMap{ "key": ProactiveEngagementArgs{...} }

type ProactiveEngagementMapOutput added in v6.25.0 

type ProactiveEngagementMapOutput struct{ *pulumi.OutputState }

func (ProactiveEngagementMapOutput) ElementType added in v6.25.0 

func (ProactiveEngagementMapOutput) ElementType() reflect.Type

func (ProactiveEngagementMapOutput) MapIndex added in v6.25.0 

func (o ProactiveEngagementMapOutput) MapIndex(k pulumi.StringInput) ProactiveEngagementOutput

func (ProactiveEngagementMapOutput) ToProactiveEngagementMapOutput added in v6.25.0 

func (o ProactiveEngagementMapOutput) ToProactiveEngagementMapOutput() ProactiveEngagementMapOutput

func (ProactiveEngagementMapOutput) ToProactiveEngagementMapOutputWithContext added in v6.25.0 

func (o ProactiveEngagementMapOutput) ToProactiveEngagementMapOutputWithContext(ctx context.Context) ProactiveEngagementMapOutput

type ProactiveEngagementOutput added in v6.25.0 

type ProactiveEngagementOutput struct{ *pulumi.OutputState }

func (ProactiveEngagementOutput) ElementType added in v6.25.0 

func (ProactiveEngagementOutput) ElementType() reflect.Type

func (ProactiveEngagementOutput) EmergencyContacts added in v6.25.0 

func (o ProactiveEngagementOutput) EmergencyContacts() ProactiveEngagementEmergencyContactArrayOutput

One or more emergency contacts. You must provide at least one phone number in the emergency contact list. See `emergencyContacts`.

func (ProactiveEngagementOutput) Enabled added in v6.25.0 

func (o ProactiveEngagementOutput) Enabled() pulumi.BoolOutput

Boolean value indicating if Proactive Engagement should be enabled or not.

func (ProactiveEngagementOutput) ToProactiveEngagementOutput added in v6.25.0 

func (o ProactiveEngagementOutput) ToProactiveEngagementOutput() ProactiveEngagementOutput

func (ProactiveEngagementOutput) ToProactiveEngagementOutputWithContext added in v6.25.0 

func (o ProactiveEngagementOutput) ToProactiveEngagementOutputWithContext(ctx context.Context) ProactiveEngagementOutput

type ProactiveEngagementState added in v6.25.0 

type ProactiveEngagementState struct {
	// One or more emergency contacts. You must provide at least one phone number in the emergency contact list. See `emergencyContacts`.
	EmergencyContacts ProactiveEngagementEmergencyContactArrayInput
	// Boolean value indicating if Proactive Engagement should be enabled or not.
	Enabled pulumi.BoolPtrInput
}

func (ProactiveEngagementState) ElementType added in v6.25.0 

func (ProactiveEngagementState) ElementType() reflect.Type

type Protection 

type Protection struct {
	pulumi.CustomResourceState

	// The ARN of the Protection.
	Arn pulumi.StringOutput `pulumi:"arn"`
	// A friendly name for the Protection you are creating.
	Name pulumi.StringOutput `pulumi:"name"`
	// The ARN (Amazon Resource Name) of the resource to be protected.
	ResourceArn pulumi.StringOutput `pulumi:"resourceArn"`
	// Key-value map of resource tags. .If configured with a provider `defaultTags` configuration block present, tags with matching keys will overwrite those defined at the provider-level.
	Tags pulumi.StringMapOutput `pulumi:"tags"`
	// A map of tags assigned to the resource, including those inherited from the provider `defaultTags` configuration block.
	//
	// Deprecated: Please use `tags` instead.
	TagsAll pulumi.StringMapOutput `pulumi:"tagsAll"`
}

Enables AWS Shield Advanced for a specific AWS resource. The resource can be an Amazon CloudFront distribution, Elastic Load Balancing load balancer, AWS Global Accelerator accelerator, Elastic IP Address, or an Amazon Route 53 hosted zone.

## Example Usage

### Create protection

```go package main

import ( 

"fmt"

"github.com/pulumi/pulumi-aws/sdk/v6/go/aws"
"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/ec2"
"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/shield"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"

) 

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := aws.GetAvailabilityZones(ctx, &aws.GetAvailabilityZonesArgs{}, nil)
		if err != nil {
			return err
		}
		current, err := aws.GetRegion(ctx, &aws.GetRegionArgs{}, nil)
		if err != nil {
			return err
		}
		currentGetCallerIdentity, err := aws.GetCallerIdentity(ctx, &aws.GetCallerIdentityArgs{}, nil)
		if err != nil {
			return err
		}
		example, err := ec2.NewEip(ctx, "example", &ec2.EipArgs{
			Domain: pulumi.String("vpc"),
		})
		if err != nil {
			return err
		}
		_, err = shield.NewProtection(ctx, "example", &shield.ProtectionArgs{
			Name: pulumi.String("example"),
			ResourceArn: example.ID().ApplyT(func(id string) (string, error) {
				return fmt.Sprintf("arn:aws:ec2:%v:%v:eip-allocation/%v", current.Name, currentGetCallerIdentity.AccountId, id), nil
			}).(pulumi.StringOutput),
			Tags: pulumi.StringMap{
				"Environment": pulumi.String("Dev"),
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}

```

## Import

Using `pulumi import`, import Shield protection resources using specifying their ID. For example:

```sh $ pulumi import aws:shield/protection:Protection example ff9592dc-22f3-4e88-afa1-7b29fde9669a ```

func GetProtection 

func GetProtection(ctx *pulumi.Context,
	name string, id pulumi.IDInput, state *ProtectionState, opts ...pulumi.ResourceOption) (*Protection, error)

GetProtection gets an existing Protection resource's state with the given name, ID, and optional state properties that are used to uniquely qualify the lookup (nil if not required).

func NewProtection 

func NewProtection(ctx *pulumi.Context,
	name string, args *ProtectionArgs, opts ...pulumi.ResourceOption) (*Protection, error)

NewProtection registers a new resource with the given unique name, arguments, and options.

func (*Protection) ElementType 

func (*Protection) ElementType() reflect.Type

func (*Protection) ToProtectionOutput 

func (i *Protection) ToProtectionOutput() ProtectionOutput

func (*Protection) ToProtectionOutputWithContext 

func (i *Protection) ToProtectionOutputWithContext(ctx context.Context) ProtectionOutput

type ProtectionArgs 

type ProtectionArgs struct {
	// A friendly name for the Protection you are creating.
	Name pulumi.StringPtrInput
	// The ARN (Amazon Resource Name) of the resource to be protected.
	ResourceArn pulumi.StringInput
	// Key-value map of resource tags. .If configured with a provider `defaultTags` configuration block present, tags with matching keys will overwrite those defined at the provider-level.
	Tags pulumi.StringMapInput
}

The set of arguments for constructing a Protection resource.

func (ProtectionArgs) ElementType 

func (ProtectionArgs) ElementType() reflect.Type

type ProtectionArray 

type ProtectionArray []ProtectionInput

func (ProtectionArray) ElementType 

func (ProtectionArray) ElementType() reflect.Type

func (ProtectionArray) ToProtectionArrayOutput 

func (i ProtectionArray) ToProtectionArrayOutput() ProtectionArrayOutput

func (ProtectionArray) ToProtectionArrayOutputWithContext 

func (i ProtectionArray) ToProtectionArrayOutputWithContext(ctx context.Context) ProtectionArrayOutput

type ProtectionArrayInput 

type ProtectionArrayInput interface {
	pulumi.Input

	ToProtectionArrayOutput() ProtectionArrayOutput
	ToProtectionArrayOutputWithContext(context.Context) ProtectionArrayOutput
}

ProtectionArrayInput is an input type that accepts ProtectionArray and ProtectionArrayOutput values. You can construct a concrete instance of `ProtectionArrayInput` via: 

ProtectionArray{ ProtectionArgs{...} }

type ProtectionArrayOutput 

type ProtectionArrayOutput struct{ *pulumi.OutputState }

func (ProtectionArrayOutput) ElementType 

func (ProtectionArrayOutput) ElementType() reflect.Type

func (ProtectionArrayOutput) Index 

func (o ProtectionArrayOutput) Index(i pulumi.IntInput) ProtectionOutput

func (ProtectionArrayOutput) ToProtectionArrayOutput 

func (o ProtectionArrayOutput) ToProtectionArrayOutput() ProtectionArrayOutput

func (ProtectionArrayOutput) ToProtectionArrayOutputWithContext 

func (o ProtectionArrayOutput) ToProtectionArrayOutputWithContext(ctx context.Context) ProtectionArrayOutput

type ProtectionGroup 

type ProtectionGroup struct {
	pulumi.CustomResourceState

	// Defines how AWS Shield combines resource data for the group in order to detect, mitigate, and report events.
	Aggregation pulumi.StringOutput `pulumi:"aggregation"`
	// The Amazon Resource Names (ARNs) of the resources to include in the protection group. You must set this when you set `pattern` to ARBITRARY and you must not set it for any other `pattern` setting.
	Members pulumi.StringArrayOutput `pulumi:"members"`
	// The criteria to use to choose the protected resources for inclusion in the group.
	Pattern pulumi.StringOutput `pulumi:"pattern"`
	// The ARN (Amazon Resource Name) of the protection group.
	ProtectionGroupArn pulumi.StringOutput `pulumi:"protectionGroupArn"`
	// The name of the protection group.
	ProtectionGroupId pulumi.StringOutput `pulumi:"protectionGroupId"`
	// The resource type to include in the protection group. You must set this when you set `pattern` to BY_RESOURCE_TYPE and you must not set it for any other `pattern` setting.
	ResourceType pulumi.StringPtrOutput `pulumi:"resourceType"`
	// Key-value map of resource tags. If configured with a provider `defaultTags` configuration block present, tags with matching keys will overwrite those defined at the provider-level.
	Tags pulumi.StringMapOutput `pulumi:"tags"`
	// A map of tags assigned to the resource, including those inherited from the provider `defaultTags` configuration block.
	//
	// Deprecated: Please use `tags` instead.
	TagsAll pulumi.StringMapOutput `pulumi:"tagsAll"`
}

Creates a grouping of protected resources so they can be handled as a collective. This resource grouping improves the accuracy of detection and reduces false positives. For more information see [Managing AWS Shield Advanced protection groups](https://docs.aws.amazon.com/waf/latest/developerguide/manage-protection-group.html)

## Example Usage

### Create protection group for all resources

```go package main

import ( 

"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/shield"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"

) 

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := shield.NewProtectionGroup(ctx, "example", &shield.ProtectionGroupArgs{
			ProtectionGroupId: pulumi.String("example"),
			Aggregation:       pulumi.String("MAX"),
			Pattern:           pulumi.String("ALL"),
		})
		if err != nil {
			return err
		}
		return nil
	})
}

```

### Create protection group for arbitrary number of resources

```go package main

import ( 

"fmt"

"github.com/pulumi/pulumi-aws/sdk/v6/go/aws"
"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/ec2"
"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/shield"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"

) 

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		current, err := aws.GetRegion(ctx, &aws.GetRegionArgs{}, nil)
		if err != nil {
			return err
		}
		currentGetCallerIdentity, err := aws.GetCallerIdentity(ctx, &aws.GetCallerIdentityArgs{}, nil)
		if err != nil {
			return err
		}
		example, err := ec2.NewEip(ctx, "example", &ec2.EipArgs{
			Domain: pulumi.String("vpc"),
		})
		if err != nil {
			return err
		}
		exampleProtection, err := shield.NewProtection(ctx, "example", &shield.ProtectionArgs{
			Name: pulumi.String("example"),
			ResourceArn: example.ID().ApplyT(func(id string) (string, error) {
				return fmt.Sprintf("arn:aws:ec2:%v:%v:eip-allocation/%v", current.Name, currentGetCallerIdentity.AccountId, id), nil
			}).(pulumi.StringOutput),
		})
		if err != nil {
			return err
		}
		_, err = shield.NewProtectionGroup(ctx, "example", &shield.ProtectionGroupArgs{
			ProtectionGroupId: pulumi.String("example"),
			Aggregation:       pulumi.String("MEAN"),
			Pattern:           pulumi.String("ARBITRARY"),
			Members: pulumi.StringArray{
				example.ID().ApplyT(func(id string) (string, error) {
					return fmt.Sprintf("arn:aws:ec2:%v:%v:eip-allocation/%v", current.Name, currentGetCallerIdentity.AccountId, id), nil
				}).(pulumi.StringOutput),
			},
		}, pulumi.DependsOn([]pulumi.Resource{
			exampleProtection,
		}))
		if err != nil {
			return err
		}
		return nil
	})
}

```

### Create protection group for a type of resource

```go package main

import ( 

"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/shield"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"

) 

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := shield.NewProtectionGroup(ctx, "example", &shield.ProtectionGroupArgs{
			ProtectionGroupId: pulumi.String("example"),
			Aggregation:       pulumi.String("SUM"),
			Pattern:           pulumi.String("BY_RESOURCE_TYPE"),
			ResourceType:      pulumi.String("ELASTIC_IP_ALLOCATION"),
		})
		if err != nil {
			return err
		}
		return nil
	})
}

```

## Import

Using `pulumi import`, import Shield protection group resources using their protection group id. For example:

```sh $ pulumi import aws:shield/protectionGroup:ProtectionGroup example example ```

func GetProtectionGroup 

func GetProtectionGroup(ctx *pulumi.Context,
	name string, id pulumi.IDInput, state *ProtectionGroupState, opts ...pulumi.ResourceOption) (*ProtectionGroup, error)

GetProtectionGroup gets an existing ProtectionGroup resource's state with the given name, ID, and optional state properties that are used to uniquely qualify the lookup (nil if not required).

func NewProtectionGroup 

func NewProtectionGroup(ctx *pulumi.Context,
	name string, args *ProtectionGroupArgs, opts ...pulumi.ResourceOption) (*ProtectionGroup, error)

NewProtectionGroup registers a new resource with the given unique name, arguments, and options.

func (*ProtectionGroup) ElementType 

func (*ProtectionGroup) ElementType() reflect.Type

func (*ProtectionGroup) ToProtectionGroupOutput 

func (i *ProtectionGroup) ToProtectionGroupOutput() ProtectionGroupOutput

func (*ProtectionGroup) ToProtectionGroupOutputWithContext 

func (i *ProtectionGroup) ToProtectionGroupOutputWithContext(ctx context.Context) ProtectionGroupOutput

type ProtectionGroupArgs 

type ProtectionGroupArgs struct {
	// Defines how AWS Shield combines resource data for the group in order to detect, mitigate, and report events.
	Aggregation pulumi.StringInput
	// The Amazon Resource Names (ARNs) of the resources to include in the protection group. You must set this when you set `pattern` to ARBITRARY and you must not set it for any other `pattern` setting.
	Members pulumi.StringArrayInput
	// The criteria to use to choose the protected resources for inclusion in the group.
	Pattern pulumi.StringInput
	// The name of the protection group.
	ProtectionGroupId pulumi.StringInput
	// The resource type to include in the protection group. You must set this when you set `pattern` to BY_RESOURCE_TYPE and you must not set it for any other `pattern` setting.
	ResourceType pulumi.StringPtrInput
	// Key-value map of resource tags. If configured with a provider `defaultTags` configuration block present, tags with matching keys will overwrite those defined at the provider-level.
	Tags pulumi.StringMapInput
}

The set of arguments for constructing a ProtectionGroup resource.

func (ProtectionGroupArgs) ElementType 

func (ProtectionGroupArgs) ElementType() reflect.Type

type ProtectionGroupArray 

type ProtectionGroupArray []ProtectionGroupInput

func (ProtectionGroupArray) ElementType 

func (ProtectionGroupArray) ElementType() reflect.Type

func (ProtectionGroupArray) ToProtectionGroupArrayOutput 

func (i ProtectionGroupArray) ToProtectionGroupArrayOutput() ProtectionGroupArrayOutput

func (ProtectionGroupArray) ToProtectionGroupArrayOutputWithContext 

func (i ProtectionGroupArray) ToProtectionGroupArrayOutputWithContext(ctx context.Context) ProtectionGroupArrayOutput

type ProtectionGroupArrayInput 

type ProtectionGroupArrayInput interface {
	pulumi.Input

	ToProtectionGroupArrayOutput() ProtectionGroupArrayOutput
	ToProtectionGroupArrayOutputWithContext(context.Context) ProtectionGroupArrayOutput
}

ProtectionGroupArrayInput is an input type that accepts ProtectionGroupArray and ProtectionGroupArrayOutput values. You can construct a concrete instance of `ProtectionGroupArrayInput` via: 

ProtectionGroupArray{ ProtectionGroupArgs{...} }

type ProtectionGroupArrayOutput 

type ProtectionGroupArrayOutput struct{ *pulumi.OutputState }

func (ProtectionGroupArrayOutput) ElementType 

func (ProtectionGroupArrayOutput) ElementType() reflect.Type

func (ProtectionGroupArrayOutput) Index 

func (o ProtectionGroupArrayOutput) Index(i pulumi.IntInput) ProtectionGroupOutput

func (ProtectionGroupArrayOutput) ToProtectionGroupArrayOutput 

func (o ProtectionGroupArrayOutput) ToProtectionGroupArrayOutput() ProtectionGroupArrayOutput

func (ProtectionGroupArrayOutput) ToProtectionGroupArrayOutputWithContext 

func (o ProtectionGroupArrayOutput) ToProtectionGroupArrayOutputWithContext(ctx context.Context) ProtectionGroupArrayOutput

type ProtectionGroupInput 

type ProtectionGroupInput interface {
	pulumi.Input

	ToProtectionGroupOutput() ProtectionGroupOutput
	ToProtectionGroupOutputWithContext(ctx context.Context) ProtectionGroupOutput
}

type ProtectionGroupMap 

type ProtectionGroupMap map[string]ProtectionGroupInput

func (ProtectionGroupMap) ElementType 

func (ProtectionGroupMap) ElementType() reflect.Type

func (ProtectionGroupMap) ToProtectionGroupMapOutput 

func (i ProtectionGroupMap) ToProtectionGroupMapOutput() ProtectionGroupMapOutput

func (ProtectionGroupMap) ToProtectionGroupMapOutputWithContext 

func (i ProtectionGroupMap) ToProtectionGroupMapOutputWithContext(ctx context.Context) ProtectionGroupMapOutput

type ProtectionGroupMapInput 

type ProtectionGroupMapInput interface {
	pulumi.Input

	ToProtectionGroupMapOutput() ProtectionGroupMapOutput
	ToProtectionGroupMapOutputWithContext(context.Context) ProtectionGroupMapOutput
}

ProtectionGroupMapInput is an input type that accepts ProtectionGroupMap and ProtectionGroupMapOutput values. You can construct a concrete instance of `ProtectionGroupMapInput` via: 

ProtectionGroupMap{ "key": ProtectionGroupArgs{...} }

type ProtectionGroupMapOutput 

type ProtectionGroupMapOutput struct{ *pulumi.OutputState }

func (ProtectionGroupMapOutput) ElementType 

func (ProtectionGroupMapOutput) ElementType() reflect.Type

func (ProtectionGroupMapOutput) MapIndex 

func (o ProtectionGroupMapOutput) MapIndex(k pulumi.StringInput) ProtectionGroupOutput

func (ProtectionGroupMapOutput) ToProtectionGroupMapOutput 

func (o ProtectionGroupMapOutput) ToProtectionGroupMapOutput() ProtectionGroupMapOutput

func (ProtectionGroupMapOutput) ToProtectionGroupMapOutputWithContext 

func (o ProtectionGroupMapOutput) ToProtectionGroupMapOutputWithContext(ctx context.Context) ProtectionGroupMapOutput

type ProtectionGroupOutput 

type ProtectionGroupOutput struct{ *pulumi.OutputState }

func (ProtectionGroupOutput) Aggregation 

func (o ProtectionGroupOutput) Aggregation() pulumi.StringOutput

Defines how AWS Shield combines resource data for the group in order to detect, mitigate, and report events.

func (ProtectionGroupOutput) ElementType 

func (ProtectionGroupOutput) ElementType() reflect.Type

func (ProtectionGroupOutput) Members 

func (o ProtectionGroupOutput) Members() pulumi.StringArrayOutput

The Amazon Resource Names (ARNs) of the resources to include in the protection group. You must set this when you set `pattern` to ARBITRARY and you must not set it for any other `pattern` setting.

func (ProtectionGroupOutput) Pattern 

func (o ProtectionGroupOutput) Pattern() pulumi.StringOutput

The criteria to use to choose the protected resources for inclusion in the group.

func (ProtectionGroupOutput) ProtectionGroupArn 

func (o ProtectionGroupOutput) ProtectionGroupArn() pulumi.StringOutput

The ARN (Amazon Resource Name) of the protection group.

func (ProtectionGroupOutput) ProtectionGroupId 

func (o ProtectionGroupOutput) ProtectionGroupId() pulumi.StringOutput

The name of the protection group.

func (ProtectionGroupOutput) ResourceType 

func (o ProtectionGroupOutput) ResourceType() pulumi.StringPtrOutput

The resource type to include in the protection group. You must set this when you set `pattern` to BY_RESOURCE_TYPE and you must not set it for any other `pattern` setting.

func (ProtectionGroupOutput) Tags 

func (o ProtectionGroupOutput) Tags() pulumi.StringMapOutput

Key-value map of resource tags. If configured with a provider `defaultTags` configuration block present, tags with matching keys will overwrite those defined at the provider-level.

func (ProtectionGroupOutput) TagsAll deprecated 

func (o ProtectionGroupOutput) TagsAll() pulumi.StringMapOutput

A map of tags assigned to the resource, including those inherited from the provider `defaultTags` configuration block.

Deprecated: Please use `tags` instead.

func (ProtectionGroupOutput) ToProtectionGroupOutput 

func (o ProtectionGroupOutput) ToProtectionGroupOutput() ProtectionGroupOutput

func (ProtectionGroupOutput) ToProtectionGroupOutputWithContext 

func (o ProtectionGroupOutput) ToProtectionGroupOutputWithContext(ctx context.Context) ProtectionGroupOutput

type ProtectionGroupState 

type ProtectionGroupState struct {
	// Defines how AWS Shield combines resource data for the group in order to detect, mitigate, and report events.
	Aggregation pulumi.StringPtrInput
	// The Amazon Resource Names (ARNs) of the resources to include in the protection group. You must set this when you set `pattern` to ARBITRARY and you must not set it for any other `pattern` setting.
	Members pulumi.StringArrayInput
	// The criteria to use to choose the protected resources for inclusion in the group.
	Pattern pulumi.StringPtrInput
	// The ARN (Amazon Resource Name) of the protection group.
	ProtectionGroupArn pulumi.StringPtrInput
	// The name of the protection group.
	ProtectionGroupId pulumi.StringPtrInput
	// The resource type to include in the protection group. You must set this when you set `pattern` to BY_RESOURCE_TYPE and you must not set it for any other `pattern` setting.
	ResourceType pulumi.StringPtrInput
	// Key-value map of resource tags. If configured with a provider `defaultTags` configuration block present, tags with matching keys will overwrite those defined at the provider-level.
	Tags pulumi.StringMapInput
	// A map of tags assigned to the resource, including those inherited from the provider `defaultTags` configuration block.
	//
	// Deprecated: Please use `tags` instead.
	TagsAll pulumi.StringMapInput
}

func (ProtectionGroupState) ElementType 

func (ProtectionGroupState) ElementType() reflect.Type

type ProtectionHealthCheckAssociation 

type ProtectionHealthCheckAssociation struct {
	pulumi.CustomResourceState

	// The ARN (Amazon Resource Name) of the Route53 Health Check resource which will be associated to the protected resource.
	HealthCheckArn pulumi.StringOutput `pulumi:"healthCheckArn"`
	// The ID of the protected resource.
	ShieldProtectionId pulumi.StringOutput `pulumi:"shieldProtectionId"`
}

Creates an association between a Route53 Health Check and a Shield Advanced protected resource. This association uses the health of your applications to improve responsiveness and accuracy in attack detection and mitigation.

Blog post: [AWS Shield Advanced now supports Health Based Detection](https://aws.amazon.com/about-aws/whats-new/2020/02/aws-shield-advanced-now-supports-health-based-detection/)

## Example Usage

### Create an association between a protected EIP and a Route53 Health Check

```go package main

import ( 

"fmt"

"github.com/pulumi/pulumi-aws/sdk/v6/go/aws"
"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/ec2"
"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/route53"
"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/shield"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"

) 

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		current, err := aws.GetRegion(ctx, &aws.GetRegionArgs{}, nil)
		if err != nil {
			return err
		}
		currentGetCallerIdentity, err := aws.GetCallerIdentity(ctx, &aws.GetCallerIdentityArgs{}, nil)
		if err != nil {
			return err
		}
		currentGetPartition, err := aws.GetPartition(ctx, &aws.GetPartitionArgs{}, nil)
		if err != nil {
			return err
		}
		example, err := ec2.NewEip(ctx, "example", &ec2.EipArgs{
			Domain: pulumi.String("vpc"),
			Tags: pulumi.StringMap{
				"Name": pulumi.String("example"),
			},
		})
		if err != nil {
			return err
		}
		exampleProtection, err := shield.NewProtection(ctx, "example", &shield.ProtectionArgs{
			Name: pulumi.String("example-protection"),
			ResourceArn: example.ID().ApplyT(func(id string) (string, error) {
				return fmt.Sprintf("arn:%v:ec2:%v:%v:eip-allocation/%v", currentGetPartition.Partition, current.Name, currentGetCallerIdentity.AccountId, id), nil
			}).(pulumi.StringOutput),
		})
		if err != nil {
			return err
		}
		exampleHealthCheck, err := route53.NewHealthCheck(ctx, "example", &route53.HealthCheckArgs{
			IpAddress:        example.PublicIp,
			Port:             pulumi.Int(80),
			Type:             pulumi.String("HTTP"),
			ResourcePath:     pulumi.String("/ready"),
			FailureThreshold: pulumi.Int(3),
			RequestInterval:  pulumi.Int(30),
			Tags: pulumi.StringMap{
				"Name": pulumi.String("tf-example-health-check"),
			},
		})
		if err != nil {
			return err
		}
		_, err = shield.NewProtectionHealthCheckAssociation(ctx, "example", &shield.ProtectionHealthCheckAssociationArgs{
			HealthCheckArn:     exampleHealthCheck.Arn,
			ShieldProtectionId: exampleProtection.ID(),
		})
		if err != nil {
			return err
		}
		return nil
	})
}

```

## Import

Using `pulumi import`, import Shield protection health check association resources using the `shield_protection_id` and `health_check_arn`. For example:

```sh $ pulumi import aws:shield/protectionHealthCheckAssociation:ProtectionHealthCheckAssociation example ff9592dc-22f3-4e88-afa1-7b29fde9669a+arn:aws:route53:::healthcheck/3742b175-edb9-46bc-9359-f53e3b794b1b ```

func GetProtectionHealthCheckAssociation 

func GetProtectionHealthCheckAssociation(ctx *pulumi.Context,
	name string, id pulumi.IDInput, state *ProtectionHealthCheckAssociationState, opts ...pulumi.ResourceOption) (*ProtectionHealthCheckAssociation, error)

GetProtectionHealthCheckAssociation gets an existing ProtectionHealthCheckAssociation resource's state with the given name, ID, and optional state properties that are used to uniquely qualify the lookup (nil if not required).

func NewProtectionHealthCheckAssociation 

func NewProtectionHealthCheckAssociation(ctx *pulumi.Context,
	name string, args *ProtectionHealthCheckAssociationArgs, opts ...pulumi.ResourceOption) (*ProtectionHealthCheckAssociation, error)

NewProtectionHealthCheckAssociation registers a new resource with the given unique name, arguments, and options.

func (*ProtectionHealthCheckAssociation) ElementType 

func (*ProtectionHealthCheckAssociation) ElementType() reflect.Type

func (*ProtectionHealthCheckAssociation) ToProtectionHealthCheckAssociationOutput 

func (i *ProtectionHealthCheckAssociation) ToProtectionHealthCheckAssociationOutput() ProtectionHealthCheckAssociationOutput

func (*ProtectionHealthCheckAssociation) ToProtectionHealthCheckAssociationOutputWithContext 

func (i *ProtectionHealthCheckAssociation) ToProtectionHealthCheckAssociationOutputWithContext(ctx context.Context) ProtectionHealthCheckAssociationOutput

type ProtectionHealthCheckAssociationArgs 

type ProtectionHealthCheckAssociationArgs struct {
	// The ARN (Amazon Resource Name) of the Route53 Health Check resource which will be associated to the protected resource.
	HealthCheckArn pulumi.StringInput
	// The ID of the protected resource.
	ShieldProtectionId pulumi.StringInput
}

The set of arguments for constructing a ProtectionHealthCheckAssociation resource.

func (ProtectionHealthCheckAssociationArgs) ElementType 

func (ProtectionHealthCheckAssociationArgs) ElementType() reflect.Type

type ProtectionHealthCheckAssociationArray 

type ProtectionHealthCheckAssociationArray []ProtectionHealthCheckAssociationInput

func (ProtectionHealthCheckAssociationArray) ElementType 

func (ProtectionHealthCheckAssociationArray) ElementType() reflect.Type

func (ProtectionHealthCheckAssociationArray) ToProtectionHealthCheckAssociationArrayOutput 

func (i ProtectionHealthCheckAssociationArray) ToProtectionHealthCheckAssociationArrayOutput() ProtectionHealthCheckAssociationArrayOutput

func (ProtectionHealthCheckAssociationArray) ToProtectionHealthCheckAssociationArrayOutputWithContext 

func (i ProtectionHealthCheckAssociationArray) ToProtectionHealthCheckAssociationArrayOutputWithContext(ctx context.Context) ProtectionHealthCheckAssociationArrayOutput

type ProtectionHealthCheckAssociationArrayInput 

type ProtectionHealthCheckAssociationArrayInput interface {
	pulumi.Input

	ToProtectionHealthCheckAssociationArrayOutput() ProtectionHealthCheckAssociationArrayOutput
	ToProtectionHealthCheckAssociationArrayOutputWithContext(context.Context) ProtectionHealthCheckAssociationArrayOutput
}

ProtectionHealthCheckAssociationArrayInput is an input type that accepts ProtectionHealthCheckAssociationArray and ProtectionHealthCheckAssociationArrayOutput values. You can construct a concrete instance of `ProtectionHealthCheckAssociationArrayInput` via: 

ProtectionHealthCheckAssociationArray{ ProtectionHealthCheckAssociationArgs{...} }

type ProtectionHealthCheckAssociationArrayOutput 

type ProtectionHealthCheckAssociationArrayOutput struct{ *pulumi.OutputState }

func (ProtectionHealthCheckAssociationArrayOutput) ElementType 

func (ProtectionHealthCheckAssociationArrayOutput) ElementType() reflect.Type

func (ProtectionHealthCheckAssociationArrayOutput) Index 

func (o ProtectionHealthCheckAssociationArrayOutput) Index(i pulumi.IntInput) ProtectionHealthCheckAssociationOutput

func (ProtectionHealthCheckAssociationArrayOutput) ToProtectionHealthCheckAssociationArrayOutput 

func (o ProtectionHealthCheckAssociationArrayOutput) ToProtectionHealthCheckAssociationArrayOutput() ProtectionHealthCheckAssociationArrayOutput

func (ProtectionHealthCheckAssociationArrayOutput) ToProtectionHealthCheckAssociationArrayOutputWithContext 

func (o ProtectionHealthCheckAssociationArrayOutput) ToProtectionHealthCheckAssociationArrayOutputWithContext(ctx context.Context) ProtectionHealthCheckAssociationArrayOutput

type ProtectionHealthCheckAssociationInput 

type ProtectionHealthCheckAssociationInput interface {
	pulumi.Input

	ToProtectionHealthCheckAssociationOutput() ProtectionHealthCheckAssociationOutput
	ToProtectionHealthCheckAssociationOutputWithContext(ctx context.Context) ProtectionHealthCheckAssociationOutput
}

type ProtectionHealthCheckAssociationMap 

type ProtectionHealthCheckAssociationMap map[string]ProtectionHealthCheckAssociationInput

func (ProtectionHealthCheckAssociationMap) ElementType 

func (ProtectionHealthCheckAssociationMap) ElementType() reflect.Type

func (ProtectionHealthCheckAssociationMap) ToProtectionHealthCheckAssociationMapOutput 

func (i ProtectionHealthCheckAssociationMap) ToProtectionHealthCheckAssociationMapOutput() ProtectionHealthCheckAssociationMapOutput

func (ProtectionHealthCheckAssociationMap) ToProtectionHealthCheckAssociationMapOutputWithContext 

func (i ProtectionHealthCheckAssociationMap) ToProtectionHealthCheckAssociationMapOutputWithContext(ctx context.Context) ProtectionHealthCheckAssociationMapOutput

type ProtectionHealthCheckAssociationMapInput 

type ProtectionHealthCheckAssociationMapInput interface {
	pulumi.Input

	ToProtectionHealthCheckAssociationMapOutput() ProtectionHealthCheckAssociationMapOutput
	ToProtectionHealthCheckAssociationMapOutputWithContext(context.Context) ProtectionHealthCheckAssociationMapOutput
}

ProtectionHealthCheckAssociationMapInput is an input type that accepts ProtectionHealthCheckAssociationMap and ProtectionHealthCheckAssociationMapOutput values. You can construct a concrete instance of `ProtectionHealthCheckAssociationMapInput` via: 

ProtectionHealthCheckAssociationMap{ "key": ProtectionHealthCheckAssociationArgs{...} }

type ProtectionHealthCheckAssociationMapOutput 

type ProtectionHealthCheckAssociationMapOutput struct{ *pulumi.OutputState }

func (ProtectionHealthCheckAssociationMapOutput) ElementType 

func (ProtectionHealthCheckAssociationMapOutput) ElementType() reflect.Type

func (ProtectionHealthCheckAssociationMapOutput) MapIndex 

func (o ProtectionHealthCheckAssociationMapOutput) MapIndex(k pulumi.StringInput) ProtectionHealthCheckAssociationOutput

func (ProtectionHealthCheckAssociationMapOutput) ToProtectionHealthCheckAssociationMapOutput 

func (o ProtectionHealthCheckAssociationMapOutput) ToProtectionHealthCheckAssociationMapOutput() ProtectionHealthCheckAssociationMapOutput

func (ProtectionHealthCheckAssociationMapOutput) ToProtectionHealthCheckAssociationMapOutputWithContext 

func (o ProtectionHealthCheckAssociationMapOutput) ToProtectionHealthCheckAssociationMapOutputWithContext(ctx context.Context) ProtectionHealthCheckAssociationMapOutput

type ProtectionHealthCheckAssociationOutput 

type ProtectionHealthCheckAssociationOutput struct{ *pulumi.OutputState }

func (ProtectionHealthCheckAssociationOutput) ElementType 

func (ProtectionHealthCheckAssociationOutput) ElementType() reflect.Type

func (ProtectionHealthCheckAssociationOutput) HealthCheckArn 

func (o ProtectionHealthCheckAssociationOutput) HealthCheckArn() pulumi.StringOutput

The ARN (Amazon Resource Name) of the Route53 Health Check resource which will be associated to the protected resource.

func (ProtectionHealthCheckAssociationOutput) ShieldProtectionId 

func (o ProtectionHealthCheckAssociationOutput) ShieldProtectionId() pulumi.StringOutput

The ID of the protected resource.

func (ProtectionHealthCheckAssociationOutput) ToProtectionHealthCheckAssociationOutput 

func (o ProtectionHealthCheckAssociationOutput) ToProtectionHealthCheckAssociationOutput() ProtectionHealthCheckAssociationOutput

func (ProtectionHealthCheckAssociationOutput) ToProtectionHealthCheckAssociationOutputWithContext 

func (o ProtectionHealthCheckAssociationOutput) ToProtectionHealthCheckAssociationOutputWithContext(ctx context.Context) ProtectionHealthCheckAssociationOutput

type ProtectionHealthCheckAssociationState 

type ProtectionHealthCheckAssociationState struct {
	// The ARN (Amazon Resource Name) of the Route53 Health Check resource which will be associated to the protected resource.
	HealthCheckArn pulumi.StringPtrInput
	// The ID of the protected resource.
	ShieldProtectionId pulumi.StringPtrInput
}

func (ProtectionHealthCheckAssociationState) ElementType 

func (ProtectionHealthCheckAssociationState) ElementType() reflect.Type

type ProtectionInput 

type ProtectionInput interface {
	pulumi.Input

	ToProtectionOutput() ProtectionOutput
	ToProtectionOutputWithContext(ctx context.Context) ProtectionOutput
}

type ProtectionMap 

type ProtectionMap map[string]ProtectionInput

func (ProtectionMap) ElementType 

func (ProtectionMap) ElementType() reflect.Type

func (ProtectionMap) ToProtectionMapOutput 

func (i ProtectionMap) ToProtectionMapOutput() ProtectionMapOutput

func (ProtectionMap) ToProtectionMapOutputWithContext 

func (i ProtectionMap) ToProtectionMapOutputWithContext(ctx context.Context) ProtectionMapOutput

type ProtectionMapInput 

type ProtectionMapInput interface {
	pulumi.Input

	ToProtectionMapOutput() ProtectionMapOutput
	ToProtectionMapOutputWithContext(context.Context) ProtectionMapOutput
}

ProtectionMapInput is an input type that accepts ProtectionMap and ProtectionMapOutput values. You can construct a concrete instance of `ProtectionMapInput` via: 

ProtectionMap{ "key": ProtectionArgs{...} }

type ProtectionMapOutput 

type ProtectionMapOutput struct{ *pulumi.OutputState }

func (ProtectionMapOutput) ElementType 

func (ProtectionMapOutput) ElementType() reflect.Type

func (ProtectionMapOutput) MapIndex 

func (o ProtectionMapOutput) MapIndex(k pulumi.StringInput) ProtectionOutput

func (ProtectionMapOutput) ToProtectionMapOutput 

func (o ProtectionMapOutput) ToProtectionMapOutput() ProtectionMapOutput

func (ProtectionMapOutput) ToProtectionMapOutputWithContext 

func (o ProtectionMapOutput) ToProtectionMapOutputWithContext(ctx context.Context) ProtectionMapOutput

type ProtectionOutput 

type ProtectionOutput struct{ *pulumi.OutputState }

func (ProtectionOutput) Arn 

func (o ProtectionOutput) Arn() pulumi.StringOutput

The ARN of the Protection.

func (ProtectionOutput) ElementType 

func (ProtectionOutput) ElementType() reflect.Type

func (ProtectionOutput) Name 

func (o ProtectionOutput) Name() pulumi.StringOutput

A friendly name for the Protection you are creating.

func (ProtectionOutput) ResourceArn 

func (o ProtectionOutput) ResourceArn() pulumi.StringOutput

The ARN (Amazon Resource Name) of the resource to be protected.

func (ProtectionOutput) Tags 

func (o ProtectionOutput) Tags() pulumi.StringMapOutput

Key-value map of resource tags. .If configured with a provider `defaultTags` configuration block present, tags with matching keys will overwrite those defined at the provider-level.

func (ProtectionOutput) TagsAll deprecated 

func (o ProtectionOutput) TagsAll() pulumi.StringMapOutput

A map of tags assigned to the resource, including those inherited from the provider `defaultTags` configuration block.

Deprecated: Please use `tags` instead.

func (ProtectionOutput) ToProtectionOutput 

func (o ProtectionOutput) ToProtectionOutput() ProtectionOutput

func (ProtectionOutput) ToProtectionOutputWithContext 

func (o ProtectionOutput) ToProtectionOutputWithContext(ctx context.Context) ProtectionOutput

type ProtectionState 

type ProtectionState struct {
	// The ARN of the Protection.
	Arn pulumi.StringPtrInput
	// A friendly name for the Protection you are creating.
	Name pulumi.StringPtrInput
	// The ARN (Amazon Resource Name) of the resource to be protected.
	ResourceArn pulumi.StringPtrInput
	// Key-value map of resource tags. .If configured with a provider `defaultTags` configuration block present, tags with matching keys will overwrite those defined at the provider-level.
	Tags pulumi.StringMapInput
	// A map of tags assigned to the resource, including those inherited from the provider `defaultTags` configuration block.
	//
	// Deprecated: Please use `tags` instead.
	TagsAll pulumi.StringMapInput
}

func (ProtectionState) ElementType 

func (ProtectionState) ElementType() reflect.Type

type Subscription added in v6.47.0 

type Subscription struct {
	pulumi.CustomResourceState

	// Toggle for automated renewal of the subscription. Valid values are `ENABLED` or `DISABLED`. Default is `ENABLED`.
	AutoRenew pulumi.StringOutput `pulumi:"autoRenew"`
	// Skip attempting to disable automated renewal upon destruction. If set to `true`, the `autoRenew` value will be left as-is and the resource will simply be removed from state.
	SkipDestroy pulumi.BoolPtrOutput `pulumi:"skipDestroy"`
}

Resource for managing an AWS Shield Subscription.

> This resource creates a subscription to AWS Shield Advanced, which requires a 1 year subscription commitment with a monthly fee. Refer to the [AWS Shield Pricing](https://aws.amazon.com/shield/pricing/) page for more details.

> Destruction of this resource will set `autoRenew` to `DISABLED`. Automatic renewal can only be disabled during the last 30 days of a subscription. To unsubscribe outside of this window, you must contact AWS Support. Set `skipDestroy` to `true` to skip modifying the `autoRenew` argument during destruction.

## Example Usage

### Basic Usage

```go package main

import ( 

"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/shield"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"

) 

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := shield.NewSubscription(ctx, "example", &shield.SubscriptionArgs{
			AutoRenew: pulumi.String("ENABLED"),
		})
		if err != nil {
			return err
		}
		return nil
	})
}

```

## Import

Using `pulumi import`, import Shield Subscription using the `id`. For example:

```sh $ pulumi import aws:shield/subscription:Subscription example 123456789012 ```

func GetSubscription added in v6.47.0 

func GetSubscription(ctx *pulumi.Context,
	name string, id pulumi.IDInput, state *SubscriptionState, opts ...pulumi.ResourceOption) (*Subscription, error)

GetSubscription gets an existing Subscription resource's state with the given name, ID, and optional state properties that are used to uniquely qualify the lookup (nil if not required).

func NewSubscription added in v6.47.0 

func NewSubscription(ctx *pulumi.Context,
	name string, args *SubscriptionArgs, opts ...pulumi.ResourceOption) (*Subscription, error)

NewSubscription registers a new resource with the given unique name, arguments, and options.

func (*Subscription) ElementType added in v6.47.0 

func (*Subscription) ElementType() reflect.Type

func (*Subscription) ToSubscriptionOutput added in v6.47.0 

func (i *Subscription) ToSubscriptionOutput() SubscriptionOutput

func (*Subscription) ToSubscriptionOutputWithContext added in v6.47.0 

func (i *Subscription) ToSubscriptionOutputWithContext(ctx context.Context) SubscriptionOutput

type SubscriptionArgs added in v6.47.0 

type SubscriptionArgs struct {
	// Toggle for automated renewal of the subscription. Valid values are `ENABLED` or `DISABLED`. Default is `ENABLED`.
	AutoRenew pulumi.StringPtrInput
	// Skip attempting to disable automated renewal upon destruction. If set to `true`, the `autoRenew` value will be left as-is and the resource will simply be removed from state.
	SkipDestroy pulumi.BoolPtrInput
}

The set of arguments for constructing a Subscription resource.

func (SubscriptionArgs) ElementType added in v6.47.0 

func (SubscriptionArgs) ElementType() reflect.Type

type SubscriptionArray added in v6.47.0 

type SubscriptionArray []SubscriptionInput

func (SubscriptionArray) ElementType added in v6.47.0 

func (SubscriptionArray) ElementType() reflect.Type

func (SubscriptionArray) ToSubscriptionArrayOutput added in v6.47.0 

func (i SubscriptionArray) ToSubscriptionArrayOutput() SubscriptionArrayOutput

func (SubscriptionArray) ToSubscriptionArrayOutputWithContext added in v6.47.0 

func (i SubscriptionArray) ToSubscriptionArrayOutputWithContext(ctx context.Context) SubscriptionArrayOutput

type SubscriptionArrayInput added in v6.47.0 

type SubscriptionArrayInput interface {
	pulumi.Input

	ToSubscriptionArrayOutput() SubscriptionArrayOutput
	ToSubscriptionArrayOutputWithContext(context.Context) SubscriptionArrayOutput
}

SubscriptionArrayInput is an input type that accepts SubscriptionArray and SubscriptionArrayOutput values. You can construct a concrete instance of `SubscriptionArrayInput` via: 

SubscriptionArray{ SubscriptionArgs{...} }

type SubscriptionArrayOutput added in v6.47.0 

type SubscriptionArrayOutput struct{ *pulumi.OutputState }

func (SubscriptionArrayOutput) ElementType added in v6.47.0 

func (SubscriptionArrayOutput) ElementType() reflect.Type

func (SubscriptionArrayOutput) Index added in v6.47.0 

func (o SubscriptionArrayOutput) Index(i pulumi.IntInput) SubscriptionOutput

func (SubscriptionArrayOutput) ToSubscriptionArrayOutput added in v6.47.0 

func (o SubscriptionArrayOutput) ToSubscriptionArrayOutput() SubscriptionArrayOutput

func (SubscriptionArrayOutput) ToSubscriptionArrayOutputWithContext added in v6.47.0 

func (o SubscriptionArrayOutput) ToSubscriptionArrayOutputWithContext(ctx context.Context) SubscriptionArrayOutput

type SubscriptionInput added in v6.47.0 

type SubscriptionInput interface {
	pulumi.Input

	ToSubscriptionOutput() SubscriptionOutput
	ToSubscriptionOutputWithContext(ctx context.Context) SubscriptionOutput
}

type SubscriptionMap added in v6.47.0 

type SubscriptionMap map[string]SubscriptionInput

func (SubscriptionMap) ElementType added in v6.47.0 

func (SubscriptionMap) ElementType() reflect.Type

func (SubscriptionMap) ToSubscriptionMapOutput added in v6.47.0 

func (i SubscriptionMap) ToSubscriptionMapOutput() SubscriptionMapOutput

func (SubscriptionMap) ToSubscriptionMapOutputWithContext added in v6.47.0 

func (i SubscriptionMap) ToSubscriptionMapOutputWithContext(ctx context.Context) SubscriptionMapOutput

type SubscriptionMapInput added in v6.47.0 

type SubscriptionMapInput interface {
	pulumi.Input

	ToSubscriptionMapOutput() SubscriptionMapOutput
	ToSubscriptionMapOutputWithContext(context.Context) SubscriptionMapOutput
}

SubscriptionMapInput is an input type that accepts SubscriptionMap and SubscriptionMapOutput values. You can construct a concrete instance of `SubscriptionMapInput` via: 

SubscriptionMap{ "key": SubscriptionArgs{...} }

type SubscriptionMapOutput added in v6.47.0 

type SubscriptionMapOutput struct{ *pulumi.OutputState }

func (SubscriptionMapOutput) ElementType added in v6.47.0 

func (SubscriptionMapOutput) ElementType() reflect.Type

func (SubscriptionMapOutput) MapIndex added in v6.47.0 

func (o SubscriptionMapOutput) MapIndex(k pulumi.StringInput) SubscriptionOutput

func (SubscriptionMapOutput) ToSubscriptionMapOutput added in v6.47.0 

func (o SubscriptionMapOutput) ToSubscriptionMapOutput() SubscriptionMapOutput

func (SubscriptionMapOutput) ToSubscriptionMapOutputWithContext added in v6.47.0 

func (o SubscriptionMapOutput) ToSubscriptionMapOutputWithContext(ctx context.Context) SubscriptionMapOutput

type SubscriptionOutput added in v6.47.0 

type SubscriptionOutput struct{ *pulumi.OutputState }

func (SubscriptionOutput) AutoRenew added in v6.47.0 

func (o SubscriptionOutput) AutoRenew() pulumi.StringOutput

Toggle for automated renewal of the subscription. Valid values are `ENABLED` or `DISABLED`. Default is `ENABLED`.

func (SubscriptionOutput) ElementType added in v6.47.0 

func (SubscriptionOutput) ElementType() reflect.Type

func (SubscriptionOutput) SkipDestroy added in v6.47.0 

func (o SubscriptionOutput) SkipDestroy() pulumi.BoolPtrOutput

Skip attempting to disable automated renewal upon destruction. If set to `true`, the `autoRenew` value will be left as-is and the resource will simply be removed from state.

func (SubscriptionOutput) ToSubscriptionOutput added in v6.47.0 

func (o SubscriptionOutput) ToSubscriptionOutput() SubscriptionOutput

func (SubscriptionOutput) ToSubscriptionOutputWithContext added in v6.47.0 

func (o SubscriptionOutput) ToSubscriptionOutputWithContext(ctx context.Context) SubscriptionOutput

type SubscriptionState added in v6.47.0 

type SubscriptionState struct {
	// Toggle for automated renewal of the subscription. Valid values are `ENABLED` or `DISABLED`. Default is `ENABLED`.
	AutoRenew pulumi.StringPtrInput
	// Skip attempting to disable automated renewal upon destruction. If set to `true`, the `autoRenew` value will be left as-is and the resource will simply be removed from state.
	SkipDestroy pulumi.BoolPtrInput
}

func (SubscriptionState) ElementType added in v6.47.0 

func (SubscriptionState) ElementType() reflect.Type

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.