github.com/pulumi/pulumi-aws/sdk/v6@v6.32.0/go/aws/shield/protectionHealthCheckAssociation.go

// Code generated by the Pulumi Terraform Bridge (tfgen) Tool DO NOT EDIT.
// *** WARNING: Do not edit by hand unless you're certain you know what you are doing! ***

package shield

import (
	"context"
	"reflect"

	"errors"
	"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/internal"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

// 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
//
// <!--Start PulumiCodeChooser -->
// ```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, nil, nil)
//			if err != nil {
//				return err
//			}
//			currentGetCallerIdentity, err := aws.GetCallerIdentity(ctx, nil, nil)
//			if err != nil {
//				return err
//			}
//			currentGetPartition, err := aws.GetPartition(ctx, nil, 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
//		})
//	}
//
// ```
// <!--End PulumiCodeChooser -->
//
// ## 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
// ```
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"`
}

// NewProtectionHealthCheckAssociation registers a new resource with the given unique name, arguments, and options.
func NewProtectionHealthCheckAssociation(ctx *pulumi.Context,
	name string, args *ProtectionHealthCheckAssociationArgs, opts ...pulumi.ResourceOption) (*ProtectionHealthCheckAssociation, error) {
	if args == nil {
		return nil, errors.New("missing one or more required arguments")
	}

	if args.HealthCheckArn == nil {
		return nil, errors.New("invalid value for required argument 'HealthCheckArn'")
	}
	if args.ShieldProtectionId == nil {
		return nil, errors.New("invalid value for required argument 'ShieldProtectionId'")
	}
	opts = internal.PkgResourceDefaultOpts(opts)
	var resource ProtectionHealthCheckAssociation
	err := ctx.RegisterResource("aws:shield/protectionHealthCheckAssociation:ProtectionHealthCheckAssociation", name, args, &resource, opts...)
	if err != nil {
		return nil, err
	}
	return &resource, nil
}

// 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 GetProtectionHealthCheckAssociation(ctx *pulumi.Context,
	name string, id pulumi.IDInput, state *ProtectionHealthCheckAssociationState, opts ...pulumi.ResourceOption) (*ProtectionHealthCheckAssociation, error) {
	var resource ProtectionHealthCheckAssociation
	err := ctx.ReadResource("aws:shield/protectionHealthCheckAssociation:ProtectionHealthCheckAssociation", name, id, state, &resource, opts...)
	if err != nil {
		return nil, err
	}
	return &resource, nil
}

// Input properties used for looking up and filtering ProtectionHealthCheckAssociation resources.
type protectionHealthCheckAssociationState struct {
	// The ARN (Amazon Resource Name) of the Route53 Health Check resource which will be associated to the protected resource.
	HealthCheckArn *string `pulumi:"healthCheckArn"`
	// The ID of the protected resource.
	ShieldProtectionId *string `pulumi:"shieldProtectionId"`
}

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() reflect.Type {
	return reflect.TypeOf((*protectionHealthCheckAssociationState)(nil)).Elem()
}

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

// The set of arguments for constructing a ProtectionHealthCheckAssociation resource.
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
}

func (ProtectionHealthCheckAssociationArgs) ElementType() reflect.Type {
	return reflect.TypeOf((*protectionHealthCheckAssociationArgs)(nil)).Elem()
}

type ProtectionHealthCheckAssociationInput interface {
	pulumi.Input

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

func (*ProtectionHealthCheckAssociation) ElementType() reflect.Type {
	return reflect.TypeOf((**ProtectionHealthCheckAssociation)(nil)).Elem()
}

func (i *ProtectionHealthCheckAssociation) ToProtectionHealthCheckAssociationOutput() ProtectionHealthCheckAssociationOutput {
	return i.ToProtectionHealthCheckAssociationOutputWithContext(context.Background())
}

func (i *ProtectionHealthCheckAssociation) ToProtectionHealthCheckAssociationOutputWithContext(ctx context.Context) ProtectionHealthCheckAssociationOutput {
	return pulumi.ToOutputWithContext(ctx, i).(ProtectionHealthCheckAssociationOutput)
}

// ProtectionHealthCheckAssociationArrayInput is an input type that accepts ProtectionHealthCheckAssociationArray and ProtectionHealthCheckAssociationArrayOutput values.
// You can construct a concrete instance of `ProtectionHealthCheckAssociationArrayInput` via:
//
//	ProtectionHealthCheckAssociationArray{ ProtectionHealthCheckAssociationArgs{...} }
type ProtectionHealthCheckAssociationArrayInput interface {
	pulumi.Input

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

type ProtectionHealthCheckAssociationArray []ProtectionHealthCheckAssociationInput

func (ProtectionHealthCheckAssociationArray) ElementType() reflect.Type {
	return reflect.TypeOf((*[]*ProtectionHealthCheckAssociation)(nil)).Elem()
}

func (i ProtectionHealthCheckAssociationArray) ToProtectionHealthCheckAssociationArrayOutput() ProtectionHealthCheckAssociationArrayOutput {
	return i.ToProtectionHealthCheckAssociationArrayOutputWithContext(context.Background())
}

func (i ProtectionHealthCheckAssociationArray) ToProtectionHealthCheckAssociationArrayOutputWithContext(ctx context.Context) ProtectionHealthCheckAssociationArrayOutput {
	return pulumi.ToOutputWithContext(ctx, i).(ProtectionHealthCheckAssociationArrayOutput)
}

// ProtectionHealthCheckAssociationMapInput is an input type that accepts ProtectionHealthCheckAssociationMap and ProtectionHealthCheckAssociationMapOutput values.
// You can construct a concrete instance of `ProtectionHealthCheckAssociationMapInput` via:
//
//	ProtectionHealthCheckAssociationMap{ "key": ProtectionHealthCheckAssociationArgs{...} }
type ProtectionHealthCheckAssociationMapInput interface {
	pulumi.Input

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

type ProtectionHealthCheckAssociationMap map[string]ProtectionHealthCheckAssociationInput

func (ProtectionHealthCheckAssociationMap) ElementType() reflect.Type {
	return reflect.TypeOf((*map[string]*ProtectionHealthCheckAssociation)(nil)).Elem()
}

func (i ProtectionHealthCheckAssociationMap) ToProtectionHealthCheckAssociationMapOutput() ProtectionHealthCheckAssociationMapOutput {
	return i.ToProtectionHealthCheckAssociationMapOutputWithContext(context.Background())
}

func (i ProtectionHealthCheckAssociationMap) ToProtectionHealthCheckAssociationMapOutputWithContext(ctx context.Context) ProtectionHealthCheckAssociationMapOutput {
	return pulumi.ToOutputWithContext(ctx, i).(ProtectionHealthCheckAssociationMapOutput)
}

type ProtectionHealthCheckAssociationOutput struct{ *pulumi.OutputState }

func (ProtectionHealthCheckAssociationOutput) ElementType() reflect.Type {
	return reflect.TypeOf((**ProtectionHealthCheckAssociation)(nil)).Elem()
}

func (o ProtectionHealthCheckAssociationOutput) ToProtectionHealthCheckAssociationOutput() ProtectionHealthCheckAssociationOutput {
	return o
}

func (o ProtectionHealthCheckAssociationOutput) ToProtectionHealthCheckAssociationOutputWithContext(ctx context.Context) ProtectionHealthCheckAssociationOutput {
	return o
}

// The ARN (Amazon Resource Name) of the Route53 Health Check resource which will be associated to the protected resource.
func (o ProtectionHealthCheckAssociationOutput) HealthCheckArn() pulumi.StringOutput {
	return o.ApplyT(func(v *ProtectionHealthCheckAssociation) pulumi.StringOutput { return v.HealthCheckArn }).(pulumi.StringOutput)
}

// The ID of the protected resource.
func (o ProtectionHealthCheckAssociationOutput) ShieldProtectionId() pulumi.StringOutput {
	return o.ApplyT(func(v *ProtectionHealthCheckAssociation) pulumi.StringOutput { return v.ShieldProtectionId }).(pulumi.StringOutput)
}

type ProtectionHealthCheckAssociationArrayOutput struct{ *pulumi.OutputState }

func (ProtectionHealthCheckAssociationArrayOutput) ElementType() reflect.Type {
	return reflect.TypeOf((*[]*ProtectionHealthCheckAssociation)(nil)).Elem()
}

func (o ProtectionHealthCheckAssociationArrayOutput) ToProtectionHealthCheckAssociationArrayOutput() ProtectionHealthCheckAssociationArrayOutput {
	return o
}

func (o ProtectionHealthCheckAssociationArrayOutput) ToProtectionHealthCheckAssociationArrayOutputWithContext(ctx context.Context) ProtectionHealthCheckAssociationArrayOutput {
	return o
}

func (o ProtectionHealthCheckAssociationArrayOutput) Index(i pulumi.IntInput) ProtectionHealthCheckAssociationOutput {
	return pulumi.All(o, i).ApplyT(func(vs []interface{}) *ProtectionHealthCheckAssociation {
		return vs[0].([]*ProtectionHealthCheckAssociation)[vs[1].(int)]
	}).(ProtectionHealthCheckAssociationOutput)
}

type ProtectionHealthCheckAssociationMapOutput struct{ *pulumi.OutputState }

func (ProtectionHealthCheckAssociationMapOutput) ElementType() reflect.Type {
	return reflect.TypeOf((*map[string]*ProtectionHealthCheckAssociation)(nil)).Elem()
}

func (o ProtectionHealthCheckAssociationMapOutput) ToProtectionHealthCheckAssociationMapOutput() ProtectionHealthCheckAssociationMapOutput {
	return o
}

func (o ProtectionHealthCheckAssociationMapOutput) ToProtectionHealthCheckAssociationMapOutputWithContext(ctx context.Context) ProtectionHealthCheckAssociationMapOutput {
	return o
}

func (o ProtectionHealthCheckAssociationMapOutput) MapIndex(k pulumi.StringInput) ProtectionHealthCheckAssociationOutput {
	return pulumi.All(o, k).ApplyT(func(vs []interface{}) *ProtectionHealthCheckAssociation {
		return vs[0].(map[string]*ProtectionHealthCheckAssociation)[vs[1].(string)]
	}).(ProtectionHealthCheckAssociationOutput)
}

func init() {
	pulumi.RegisterInputType(reflect.TypeOf((*ProtectionHealthCheckAssociationInput)(nil)).Elem(), &ProtectionHealthCheckAssociation{})
	pulumi.RegisterInputType(reflect.TypeOf((*ProtectionHealthCheckAssociationArrayInput)(nil)).Elem(), ProtectionHealthCheckAssociationArray{})
	pulumi.RegisterInputType(reflect.TypeOf((*ProtectionHealthCheckAssociationMapInput)(nil)).Elem(), ProtectionHealthCheckAssociationMap{})
	pulumi.RegisterOutputType(ProtectionHealthCheckAssociationOutput{})
	pulumi.RegisterOutputType(ProtectionHealthCheckAssociationArrayOutput{})
	pulumi.RegisterOutputType(ProtectionHealthCheckAssociationMapOutput{})
}