github.com/pulumi/pulumi-aws/sdk/v6@v6.32.0/go/aws/cloudwatch/logDestinationPolicy.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 cloudwatch

import (
	"context"
	"reflect"

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

// Provides a CloudWatch Logs destination policy resource.
//
// ## Example Usage
//
// <!--Start PulumiCodeChooser -->
// ```go
// package main
//
// import (
//
//	"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/cloudwatch"
//	"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/iam"
//	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
//
// )
//
//	func main() {
//		pulumi.Run(func(ctx *pulumi.Context) error {
//			testDestination, err := cloudwatch.NewLogDestination(ctx, "test_destination", &cloudwatch.LogDestinationArgs{
//				Name:      pulumi.String("test_destination"),
//				RoleArn:   pulumi.Any(iamForCloudwatch.Arn),
//				TargetArn: pulumi.Any(kinesisForCloudwatch.Arn),
//			})
//			if err != nil {
//				return err
//			}
//			testDestinationPolicy := iam.GetPolicyDocumentOutput(ctx, iam.GetPolicyDocumentOutputArgs{
//				Statements: iam.GetPolicyDocumentStatementArray{
//					&iam.GetPolicyDocumentStatementArgs{
//						Effect: pulumi.String("Allow"),
//						Principals: iam.GetPolicyDocumentStatementPrincipalArray{
//							&iam.GetPolicyDocumentStatementPrincipalArgs{
//								Type: pulumi.String("AWS"),
//								Identifiers: pulumi.StringArray{
//									pulumi.String("123456789012"),
//								},
//							},
//						},
//						Actions: pulumi.StringArray{
//							pulumi.String("logs:PutSubscriptionFilter"),
//						},
//						Resources: pulumi.StringArray{
//							testDestination.Arn,
//						},
//					},
//				},
//			}, nil)
//			_, err = cloudwatch.NewLogDestinationPolicy(ctx, "test_destination_policy", &cloudwatch.LogDestinationPolicyArgs{
//				DestinationName: testDestination.Name,
//				AccessPolicy: testDestinationPolicy.ApplyT(func(testDestinationPolicy iam.GetPolicyDocumentResult) (*string, error) {
//					return &testDestinationPolicy.Json, nil
//				}).(pulumi.StringPtrOutput),
//			})
//			if err != nil {
//				return err
//			}
//			return nil
//		})
//	}
//
// ```
// <!--End PulumiCodeChooser -->
//
// ## Import
//
// Using `pulumi import`, import CloudWatch Logs destination policies using the `destination_name`. For example:
//
// ```sh
// $ pulumi import aws:cloudwatch/logDestinationPolicy:LogDestinationPolicy test_destination_policy test_destination
// ```
type LogDestinationPolicy struct {
	pulumi.CustomResourceState

	// The policy document. This is a JSON formatted string.
	AccessPolicy pulumi.StringOutput `pulumi:"accessPolicy"`
	// A name for the subscription filter
	DestinationName pulumi.StringOutput `pulumi:"destinationName"`
	// Specify true if you are updating an existing destination policy to grant permission to an organization ID instead of granting permission to individual AWS accounts.
	ForceUpdate pulumi.BoolPtrOutput `pulumi:"forceUpdate"`
}

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

	if args.AccessPolicy == nil {
		return nil, errors.New("invalid value for required argument 'AccessPolicy'")
	}
	if args.DestinationName == nil {
		return nil, errors.New("invalid value for required argument 'DestinationName'")
	}
	opts = internal.PkgResourceDefaultOpts(opts)
	var resource LogDestinationPolicy
	err := ctx.RegisterResource("aws:cloudwatch/logDestinationPolicy:LogDestinationPolicy", name, args, &resource, opts...)
	if err != nil {
		return nil, err
	}
	return &resource, nil
}

// GetLogDestinationPolicy gets an existing LogDestinationPolicy 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 GetLogDestinationPolicy(ctx *pulumi.Context,
	name string, id pulumi.IDInput, state *LogDestinationPolicyState, opts ...pulumi.ResourceOption) (*LogDestinationPolicy, error) {
	var resource LogDestinationPolicy
	err := ctx.ReadResource("aws:cloudwatch/logDestinationPolicy:LogDestinationPolicy", name, id, state, &resource, opts...)
	if err != nil {
		return nil, err
	}
	return &resource, nil
}

// Input properties used for looking up and filtering LogDestinationPolicy resources.
type logDestinationPolicyState struct {
	// The policy document. This is a JSON formatted string.
	AccessPolicy *string `pulumi:"accessPolicy"`
	// A name for the subscription filter
	DestinationName *string `pulumi:"destinationName"`
	// Specify true if you are updating an existing destination policy to grant permission to an organization ID instead of granting permission to individual AWS accounts.
	ForceUpdate *bool `pulumi:"forceUpdate"`
}

type LogDestinationPolicyState struct {
	// The policy document. This is a JSON formatted string.
	AccessPolicy pulumi.StringPtrInput
	// A name for the subscription filter
	DestinationName pulumi.StringPtrInput
	// Specify true if you are updating an existing destination policy to grant permission to an organization ID instead of granting permission to individual AWS accounts.
	ForceUpdate pulumi.BoolPtrInput
}

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

type logDestinationPolicyArgs struct {
	// The policy document. This is a JSON formatted string.
	AccessPolicy string `pulumi:"accessPolicy"`
	// A name for the subscription filter
	DestinationName string `pulumi:"destinationName"`
	// Specify true if you are updating an existing destination policy to grant permission to an organization ID instead of granting permission to individual AWS accounts.
	ForceUpdate *bool `pulumi:"forceUpdate"`
}

// The set of arguments for constructing a LogDestinationPolicy resource.
type LogDestinationPolicyArgs struct {
	// The policy document. This is a JSON formatted string.
	AccessPolicy pulumi.StringInput
	// A name for the subscription filter
	DestinationName pulumi.StringInput
	// Specify true if you are updating an existing destination policy to grant permission to an organization ID instead of granting permission to individual AWS accounts.
	ForceUpdate pulumi.BoolPtrInput
}

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

type LogDestinationPolicyInput interface {
	pulumi.Input

	ToLogDestinationPolicyOutput() LogDestinationPolicyOutput
	ToLogDestinationPolicyOutputWithContext(ctx context.Context) LogDestinationPolicyOutput
}

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

func (i *LogDestinationPolicy) ToLogDestinationPolicyOutput() LogDestinationPolicyOutput {
	return i.ToLogDestinationPolicyOutputWithContext(context.Background())
}

func (i *LogDestinationPolicy) ToLogDestinationPolicyOutputWithContext(ctx context.Context) LogDestinationPolicyOutput {
	return pulumi.ToOutputWithContext(ctx, i).(LogDestinationPolicyOutput)
}

// LogDestinationPolicyArrayInput is an input type that accepts LogDestinationPolicyArray and LogDestinationPolicyArrayOutput values.
// You can construct a concrete instance of `LogDestinationPolicyArrayInput` via:
//
//	LogDestinationPolicyArray{ LogDestinationPolicyArgs{...} }
type LogDestinationPolicyArrayInput interface {
	pulumi.Input

	ToLogDestinationPolicyArrayOutput() LogDestinationPolicyArrayOutput
	ToLogDestinationPolicyArrayOutputWithContext(context.Context) LogDestinationPolicyArrayOutput
}

type LogDestinationPolicyArray []LogDestinationPolicyInput

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

func (i LogDestinationPolicyArray) ToLogDestinationPolicyArrayOutput() LogDestinationPolicyArrayOutput {
	return i.ToLogDestinationPolicyArrayOutputWithContext(context.Background())
}

func (i LogDestinationPolicyArray) ToLogDestinationPolicyArrayOutputWithContext(ctx context.Context) LogDestinationPolicyArrayOutput {
	return pulumi.ToOutputWithContext(ctx, i).(LogDestinationPolicyArrayOutput)
}

// LogDestinationPolicyMapInput is an input type that accepts LogDestinationPolicyMap and LogDestinationPolicyMapOutput values.
// You can construct a concrete instance of `LogDestinationPolicyMapInput` via:
//
//	LogDestinationPolicyMap{ "key": LogDestinationPolicyArgs{...} }
type LogDestinationPolicyMapInput interface {
	pulumi.Input

	ToLogDestinationPolicyMapOutput() LogDestinationPolicyMapOutput
	ToLogDestinationPolicyMapOutputWithContext(context.Context) LogDestinationPolicyMapOutput
}

type LogDestinationPolicyMap map[string]LogDestinationPolicyInput

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

func (i LogDestinationPolicyMap) ToLogDestinationPolicyMapOutput() LogDestinationPolicyMapOutput {
	return i.ToLogDestinationPolicyMapOutputWithContext(context.Background())
}

func (i LogDestinationPolicyMap) ToLogDestinationPolicyMapOutputWithContext(ctx context.Context) LogDestinationPolicyMapOutput {
	return pulumi.ToOutputWithContext(ctx, i).(LogDestinationPolicyMapOutput)
}

type LogDestinationPolicyOutput struct{ *pulumi.OutputState }

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

func (o LogDestinationPolicyOutput) ToLogDestinationPolicyOutput() LogDestinationPolicyOutput {
	return o
}

func (o LogDestinationPolicyOutput) ToLogDestinationPolicyOutputWithContext(ctx context.Context) LogDestinationPolicyOutput {
	return o
}

// The policy document. This is a JSON formatted string.
func (o LogDestinationPolicyOutput) AccessPolicy() pulumi.StringOutput {
	return o.ApplyT(func(v *LogDestinationPolicy) pulumi.StringOutput { return v.AccessPolicy }).(pulumi.StringOutput)
}

// A name for the subscription filter
func (o LogDestinationPolicyOutput) DestinationName() pulumi.StringOutput {
	return o.ApplyT(func(v *LogDestinationPolicy) pulumi.StringOutput { return v.DestinationName }).(pulumi.StringOutput)
}

// Specify true if you are updating an existing destination policy to grant permission to an organization ID instead of granting permission to individual AWS accounts.
func (o LogDestinationPolicyOutput) ForceUpdate() pulumi.BoolPtrOutput {
	return o.ApplyT(func(v *LogDestinationPolicy) pulumi.BoolPtrOutput { return v.ForceUpdate }).(pulumi.BoolPtrOutput)
}

type LogDestinationPolicyArrayOutput struct{ *pulumi.OutputState }

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

func (o LogDestinationPolicyArrayOutput) ToLogDestinationPolicyArrayOutput() LogDestinationPolicyArrayOutput {
	return o
}

func (o LogDestinationPolicyArrayOutput) ToLogDestinationPolicyArrayOutputWithContext(ctx context.Context) LogDestinationPolicyArrayOutput {
	return o
}

func (o LogDestinationPolicyArrayOutput) Index(i pulumi.IntInput) LogDestinationPolicyOutput {
	return pulumi.All(o, i).ApplyT(func(vs []interface{}) *LogDestinationPolicy {
		return vs[0].([]*LogDestinationPolicy)[vs[1].(int)]
	}).(LogDestinationPolicyOutput)
}

type LogDestinationPolicyMapOutput struct{ *pulumi.OutputState }

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

func (o LogDestinationPolicyMapOutput) ToLogDestinationPolicyMapOutput() LogDestinationPolicyMapOutput {
	return o
}

func (o LogDestinationPolicyMapOutput) ToLogDestinationPolicyMapOutputWithContext(ctx context.Context) LogDestinationPolicyMapOutput {
	return o
}

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

func init() {
	pulumi.RegisterInputType(reflect.TypeOf((*LogDestinationPolicyInput)(nil)).Elem(), &LogDestinationPolicy{})
	pulumi.RegisterInputType(reflect.TypeOf((*LogDestinationPolicyArrayInput)(nil)).Elem(), LogDestinationPolicyArray{})
	pulumi.RegisterInputType(reflect.TypeOf((*LogDestinationPolicyMapInput)(nil)).Elem(), LogDestinationPolicyMap{})
	pulumi.RegisterOutputType(LogDestinationPolicyOutput{})
	pulumi.RegisterOutputType(LogDestinationPolicyArrayOutput{})
	pulumi.RegisterOutputType(LogDestinationPolicyMapOutput{})
}