globalaccelerator

package
v5.43.0 Latest Latest
Warning

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

 Go to latest Published: Nov 21, 2023 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 Accelerator 

type Accelerator struct {
	pulumi.CustomResourceState

	// The attributes of the accelerator. Fields documented below.
	Attributes AcceleratorAttributesPtrOutput `pulumi:"attributes"`
	// The DNS name of the accelerator. For example, `a5d53ff5ee6bca4ce.awsglobalaccelerator.com`.
	DnsName pulumi.StringOutput `pulumi:"dnsName"`
	// The Domain Name System (DNS) name that Global Accelerator creates that points to a dual-stack accelerator's four static IP addresses: two IPv4 addresses and two IPv6 addresses. For example, `a1234567890abcdef.dualstack.awsglobalaccelerator.com`.
	DualStackDnsName pulumi.StringOutput `pulumi:"dualStackDnsName"`
	// Indicates whether the accelerator is enabled. Defaults to `true`. Valid values: `true`, `false`.
	Enabled pulumi.BoolPtrOutput `pulumi:"enabled"`
	// -  The Global Accelerator Route 53 zone ID that can be used to
	//    route an [Alias Resource Record Set](https://docs.aws.amazon.com/Route53/latest/APIReference/API_AliasTarget.html) to the Global Accelerator. This attribute
	//    is simply an alias for the zone ID `Z2BJ6XQ5FK7U4H`.
	HostedZoneId pulumi.StringOutput `pulumi:"hostedZoneId"`
	// The value for the address type. Defaults to `IPV4`. Valid values: `IPV4`, `DUAL_STACK`.
	IpAddressType pulumi.StringPtrOutput `pulumi:"ipAddressType"`
	// The IP addresses to use for BYOIP accelerators. If not specified, the service assigns IP addresses. Valid values: 1 or 2 IPv4 addresses.
	IpAddresses pulumi.StringArrayOutput `pulumi:"ipAddresses"`
	// IP address set associated with the accelerator.
	IpSets AcceleratorIpSetArrayOutput `pulumi:"ipSets"`
	// The name of the accelerator.
	Name pulumi.StringOutput `pulumi:"name"`
	// A map of tags to assign to the resource. .If configured with a provider `defaultTags` configuration block present, tags with matching keys will overwrite those defined at the provider-level.
	//
	// **attributes** supports the following attributes:
	Tags pulumi.StringMapOutput `pulumi:"tags"`
	// A map of tags assigned to the resource, including those inherited from the provider `defaultTags` configuration block.
	TagsAll pulumi.StringMapOutput `pulumi:"tagsAll"`
}

Creates a Global Accelerator accelerator.

## Example Usage

```go package main

import ( 

"github.com/pulumi/pulumi-aws/sdk/v5/go/aws/globalaccelerator"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"

) 

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := globalaccelerator.NewAccelerator(ctx, "example", &globalaccelerator.AcceleratorArgs{
			Attributes: &globalaccelerator.AcceleratorAttributesArgs{
				FlowLogsEnabled:  pulumi.Bool(true),
				FlowLogsS3Bucket: pulumi.String("example-bucket"),
				FlowLogsS3Prefix: pulumi.String("flow-logs/"),
			},
			Enabled:       pulumi.Bool(true),
			IpAddressType: pulumi.String("IPV4"),
			IpAddresses: pulumi.StringArray{
				pulumi.String("1.2.3.4"),
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}

```

## Import

Global Accelerator accelerators can be imported using the `arn`, e.g.,

```sh 

$ pulumi import aws:globalaccelerator/accelerator:Accelerator example arn:aws:globalaccelerator::111111111111:accelerator/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

```

func GetAccelerator 

func GetAccelerator(ctx *pulumi.Context,
	name string, id pulumi.IDInput, state *AcceleratorState, opts ...pulumi.ResourceOption) (*Accelerator, error)

GetAccelerator gets an existing Accelerator 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 NewAccelerator 

func NewAccelerator(ctx *pulumi.Context,
	name string, args *AcceleratorArgs, opts ...pulumi.ResourceOption) (*Accelerator, error)

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

func (*Accelerator) ElementType 

func (*Accelerator) ElementType() reflect.Type

func (*Accelerator) ToAcceleratorOutput 

func (i *Accelerator) ToAcceleratorOutput() AcceleratorOutput

func (*Accelerator) ToAcceleratorOutputWithContext 

func (i *Accelerator) ToAcceleratorOutputWithContext(ctx context.Context) AcceleratorOutput

type AcceleratorArgs 

type AcceleratorArgs struct {
	// The attributes of the accelerator. Fields documented below.
	Attributes AcceleratorAttributesPtrInput
	// Indicates whether the accelerator is enabled. Defaults to `true`. Valid values: `true`, `false`.
	Enabled pulumi.BoolPtrInput
	// The value for the address type. Defaults to `IPV4`. Valid values: `IPV4`, `DUAL_STACK`.
	IpAddressType pulumi.StringPtrInput
	// The IP addresses to use for BYOIP accelerators. If not specified, the service assigns IP addresses. Valid values: 1 or 2 IPv4 addresses.
	IpAddresses pulumi.StringArrayInput
	// The name of the accelerator.
	Name pulumi.StringPtrInput
	// A map of tags to assign to the resource. .If configured with a provider `defaultTags` configuration block present, tags with matching keys will overwrite those defined at the provider-level.
	//
	// **attributes** supports the following attributes:
	Tags pulumi.StringMapInput
}

The set of arguments for constructing a Accelerator resource.

func (AcceleratorArgs) ElementType 

func (AcceleratorArgs) ElementType() reflect.Type

type AcceleratorArray 

type AcceleratorArray []AcceleratorInput

func (AcceleratorArray) ElementType 

func (AcceleratorArray) ElementType() reflect.Type

func (AcceleratorArray) ToAcceleratorArrayOutput 

func (i AcceleratorArray) ToAcceleratorArrayOutput() AcceleratorArrayOutput

func (AcceleratorArray) ToAcceleratorArrayOutputWithContext 

func (i AcceleratorArray) ToAcceleratorArrayOutputWithContext(ctx context.Context) AcceleratorArrayOutput

type AcceleratorArrayInput 

type AcceleratorArrayInput interface {
	pulumi.Input

	ToAcceleratorArrayOutput() AcceleratorArrayOutput
	ToAcceleratorArrayOutputWithContext(context.Context) AcceleratorArrayOutput
}

AcceleratorArrayInput is an input type that accepts AcceleratorArray and AcceleratorArrayOutput values. You can construct a concrete instance of `AcceleratorArrayInput` via: 

AcceleratorArray{ AcceleratorArgs{...} }

type AcceleratorArrayOutput 

type AcceleratorArrayOutput struct{ *pulumi.OutputState }

func (AcceleratorArrayOutput) ElementType 

func (AcceleratorArrayOutput) ElementType() reflect.Type

func (AcceleratorArrayOutput) Index 

func (o AcceleratorArrayOutput) Index(i pulumi.IntInput) AcceleratorOutput

func (AcceleratorArrayOutput) ToAcceleratorArrayOutput 

func (o AcceleratorArrayOutput) ToAcceleratorArrayOutput() AcceleratorArrayOutput

func (AcceleratorArrayOutput) ToAcceleratorArrayOutputWithContext 

func (o AcceleratorArrayOutput) ToAcceleratorArrayOutputWithContext(ctx context.Context) AcceleratorArrayOutput

type AcceleratorAttributes 

type AcceleratorAttributes struct {
	// Indicates whether flow logs are enabled. Defaults to `false`. Valid values: `true`, `false`.
	FlowLogsEnabled *bool `pulumi:"flowLogsEnabled"`
	// The name of the Amazon S3 bucket for the flow logs. Required if `flowLogsEnabled` is `true`.
	FlowLogsS3Bucket *string `pulumi:"flowLogsS3Bucket"`
	// The prefix for the location in the Amazon S3 bucket for the flow logs. Required if `flowLogsEnabled` is `true`.
	FlowLogsS3Prefix *string `pulumi:"flowLogsS3Prefix"`
}

type AcceleratorAttributesArgs 

type AcceleratorAttributesArgs struct {
	// Indicates whether flow logs are enabled. Defaults to `false`. Valid values: `true`, `false`.
	FlowLogsEnabled pulumi.BoolPtrInput `pulumi:"flowLogsEnabled"`
	// The name of the Amazon S3 bucket for the flow logs. Required if `flowLogsEnabled` is `true`.
	FlowLogsS3Bucket pulumi.StringPtrInput `pulumi:"flowLogsS3Bucket"`
	// The prefix for the location in the Amazon S3 bucket for the flow logs. Required if `flowLogsEnabled` is `true`.
	FlowLogsS3Prefix pulumi.StringPtrInput `pulumi:"flowLogsS3Prefix"`
}

func (AcceleratorAttributesArgs) ElementType 

func (AcceleratorAttributesArgs) ElementType() reflect.Type

func (AcceleratorAttributesArgs) ToAcceleratorAttributesOutput 

func (i AcceleratorAttributesArgs) ToAcceleratorAttributesOutput() AcceleratorAttributesOutput

func (AcceleratorAttributesArgs) ToAcceleratorAttributesOutputWithContext 

func (i AcceleratorAttributesArgs) ToAcceleratorAttributesOutputWithContext(ctx context.Context) AcceleratorAttributesOutput

func (AcceleratorAttributesArgs) ToAcceleratorAttributesPtrOutput 

func (i AcceleratorAttributesArgs) ToAcceleratorAttributesPtrOutput() AcceleratorAttributesPtrOutput

func (AcceleratorAttributesArgs) ToAcceleratorAttributesPtrOutputWithContext 

func (i AcceleratorAttributesArgs) ToAcceleratorAttributesPtrOutputWithContext(ctx context.Context) AcceleratorAttributesPtrOutput

type AcceleratorAttributesInput 

type AcceleratorAttributesInput interface {
	pulumi.Input

	ToAcceleratorAttributesOutput() AcceleratorAttributesOutput
	ToAcceleratorAttributesOutputWithContext(context.Context) AcceleratorAttributesOutput
}

AcceleratorAttributesInput is an input type that accepts AcceleratorAttributesArgs and AcceleratorAttributesOutput values. You can construct a concrete instance of `AcceleratorAttributesInput` via: 

AcceleratorAttributesArgs{...}

type AcceleratorAttributesOutput 

type AcceleratorAttributesOutput struct{ *pulumi.OutputState }

func (AcceleratorAttributesOutput) ElementType 

func (AcceleratorAttributesOutput) ElementType() reflect.Type

func (AcceleratorAttributesOutput) FlowLogsEnabled 

func (o AcceleratorAttributesOutput) FlowLogsEnabled() pulumi.BoolPtrOutput

Indicates whether flow logs are enabled. Defaults to `false`. Valid values: `true`, `false`.

func (AcceleratorAttributesOutput) FlowLogsS3Bucket 

func (o AcceleratorAttributesOutput) FlowLogsS3Bucket() pulumi.StringPtrOutput

The name of the Amazon S3 bucket for the flow logs. Required if `flowLogsEnabled` is `true`.

func (AcceleratorAttributesOutput) FlowLogsS3Prefix 

func (o AcceleratorAttributesOutput) FlowLogsS3Prefix() pulumi.StringPtrOutput

The prefix for the location in the Amazon S3 bucket for the flow logs. Required if `flowLogsEnabled` is `true`.

func (AcceleratorAttributesOutput) ToAcceleratorAttributesOutput 

func (o AcceleratorAttributesOutput) ToAcceleratorAttributesOutput() AcceleratorAttributesOutput

func (AcceleratorAttributesOutput) ToAcceleratorAttributesOutputWithContext 

func (o AcceleratorAttributesOutput) ToAcceleratorAttributesOutputWithContext(ctx context.Context) AcceleratorAttributesOutput

func (AcceleratorAttributesOutput) ToAcceleratorAttributesPtrOutput 

func (o AcceleratorAttributesOutput) ToAcceleratorAttributesPtrOutput() AcceleratorAttributesPtrOutput

func (AcceleratorAttributesOutput) ToAcceleratorAttributesPtrOutputWithContext 

func (o AcceleratorAttributesOutput) ToAcceleratorAttributesPtrOutputWithContext(ctx context.Context) AcceleratorAttributesPtrOutput

type AcceleratorAttributesPtrInput 

type AcceleratorAttributesPtrInput interface {
	pulumi.Input

	ToAcceleratorAttributesPtrOutput() AcceleratorAttributesPtrOutput
	ToAcceleratorAttributesPtrOutputWithContext(context.Context) AcceleratorAttributesPtrOutput
}

AcceleratorAttributesPtrInput is an input type that accepts AcceleratorAttributesArgs, AcceleratorAttributesPtr and AcceleratorAttributesPtrOutput values. You can construct a concrete instance of `AcceleratorAttributesPtrInput` via: 

        AcceleratorAttributesArgs{...}

or:

        nil

func AcceleratorAttributesPtr 

func AcceleratorAttributesPtr(v *AcceleratorAttributesArgs) AcceleratorAttributesPtrInput

type AcceleratorAttributesPtrOutput 

type AcceleratorAttributesPtrOutput struct{ *pulumi.OutputState }

func (AcceleratorAttributesPtrOutput) Elem 

func (o AcceleratorAttributesPtrOutput) Elem() AcceleratorAttributesOutput

func (AcceleratorAttributesPtrOutput) ElementType 

func (AcceleratorAttributesPtrOutput) ElementType() reflect.Type

func (AcceleratorAttributesPtrOutput) FlowLogsEnabled 

func (o AcceleratorAttributesPtrOutput) FlowLogsEnabled() pulumi.BoolPtrOutput

Indicates whether flow logs are enabled. Defaults to `false`. Valid values: `true`, `false`.

func (AcceleratorAttributesPtrOutput) FlowLogsS3Bucket 

func (o AcceleratorAttributesPtrOutput) FlowLogsS3Bucket() pulumi.StringPtrOutput

The name of the Amazon S3 bucket for the flow logs. Required if `flowLogsEnabled` is `true`.

func (AcceleratorAttributesPtrOutput) FlowLogsS3Prefix 

func (o AcceleratorAttributesPtrOutput) FlowLogsS3Prefix() pulumi.StringPtrOutput

The prefix for the location in the Amazon S3 bucket for the flow logs. Required if `flowLogsEnabled` is `true`.

func (AcceleratorAttributesPtrOutput) ToAcceleratorAttributesPtrOutput 

func (o AcceleratorAttributesPtrOutput) ToAcceleratorAttributesPtrOutput() AcceleratorAttributesPtrOutput

func (AcceleratorAttributesPtrOutput) ToAcceleratorAttributesPtrOutputWithContext 

func (o AcceleratorAttributesPtrOutput) ToAcceleratorAttributesPtrOutputWithContext(ctx context.Context) AcceleratorAttributesPtrOutput

type AcceleratorInput 

type AcceleratorInput interface {
	pulumi.Input

	ToAcceleratorOutput() AcceleratorOutput
	ToAcceleratorOutputWithContext(ctx context.Context) AcceleratorOutput
}

type AcceleratorIpSet 

type AcceleratorIpSet struct {
	// The IP addresses to use for BYOIP accelerators. If not specified, the service assigns IP addresses. Valid values: 1 or 2 IPv4 addresses.
	IpAddresses []string `pulumi:"ipAddresses"`
	// The type of IP addresses included in this IP set.
	IpFamily *string `pulumi:"ipFamily"`
}

type AcceleratorIpSetArgs 

type AcceleratorIpSetArgs struct {
	// The IP addresses to use for BYOIP accelerators. If not specified, the service assigns IP addresses. Valid values: 1 or 2 IPv4 addresses.
	IpAddresses pulumi.StringArrayInput `pulumi:"ipAddresses"`
	// The type of IP addresses included in this IP set.
	IpFamily pulumi.StringPtrInput `pulumi:"ipFamily"`
}

func (AcceleratorIpSetArgs) ElementType 

func (AcceleratorIpSetArgs) ElementType() reflect.Type

func (AcceleratorIpSetArgs) ToAcceleratorIpSetOutput 

func (i AcceleratorIpSetArgs) ToAcceleratorIpSetOutput() AcceleratorIpSetOutput

func (AcceleratorIpSetArgs) ToAcceleratorIpSetOutputWithContext 

func (i AcceleratorIpSetArgs) ToAcceleratorIpSetOutputWithContext(ctx context.Context) AcceleratorIpSetOutput

type AcceleratorIpSetArray 

type AcceleratorIpSetArray []AcceleratorIpSetInput

func (AcceleratorIpSetArray) ElementType 

func (AcceleratorIpSetArray) ElementType() reflect.Type

func (AcceleratorIpSetArray) ToAcceleratorIpSetArrayOutput 

func (i AcceleratorIpSetArray) ToAcceleratorIpSetArrayOutput() AcceleratorIpSetArrayOutput

func (AcceleratorIpSetArray) ToAcceleratorIpSetArrayOutputWithContext 

func (i AcceleratorIpSetArray) ToAcceleratorIpSetArrayOutputWithContext(ctx context.Context) AcceleratorIpSetArrayOutput

type AcceleratorIpSetArrayInput 

type AcceleratorIpSetArrayInput interface {
	pulumi.Input

	ToAcceleratorIpSetArrayOutput() AcceleratorIpSetArrayOutput
	ToAcceleratorIpSetArrayOutputWithContext(context.Context) AcceleratorIpSetArrayOutput
}

AcceleratorIpSetArrayInput is an input type that accepts AcceleratorIpSetArray and AcceleratorIpSetArrayOutput values. You can construct a concrete instance of `AcceleratorIpSetArrayInput` via: 

AcceleratorIpSetArray{ AcceleratorIpSetArgs{...} }

type AcceleratorIpSetArrayOutput 

type AcceleratorIpSetArrayOutput struct{ *pulumi.OutputState }

func (AcceleratorIpSetArrayOutput) ElementType 

func (AcceleratorIpSetArrayOutput) ElementType() reflect.Type

func (AcceleratorIpSetArrayOutput) Index 

func (o AcceleratorIpSetArrayOutput) Index(i pulumi.IntInput) AcceleratorIpSetOutput

func (AcceleratorIpSetArrayOutput) ToAcceleratorIpSetArrayOutput 

func (o AcceleratorIpSetArrayOutput) ToAcceleratorIpSetArrayOutput() AcceleratorIpSetArrayOutput

func (AcceleratorIpSetArrayOutput) ToAcceleratorIpSetArrayOutputWithContext 

func (o AcceleratorIpSetArrayOutput) ToAcceleratorIpSetArrayOutputWithContext(ctx context.Context) AcceleratorIpSetArrayOutput

type AcceleratorIpSetInput 

type AcceleratorIpSetInput interface {
	pulumi.Input

	ToAcceleratorIpSetOutput() AcceleratorIpSetOutput
	ToAcceleratorIpSetOutputWithContext(context.Context) AcceleratorIpSetOutput
}

AcceleratorIpSetInput is an input type that accepts AcceleratorIpSetArgs and AcceleratorIpSetOutput values. You can construct a concrete instance of `AcceleratorIpSetInput` via: 

AcceleratorIpSetArgs{...}

type AcceleratorIpSetOutput 

type AcceleratorIpSetOutput struct{ *pulumi.OutputState }

func (AcceleratorIpSetOutput) ElementType 

func (AcceleratorIpSetOutput) ElementType() reflect.Type

func (AcceleratorIpSetOutput) IpAddresses 

func (o AcceleratorIpSetOutput) IpAddresses() pulumi.StringArrayOutput

The IP addresses to use for BYOIP accelerators. If not specified, the service assigns IP addresses. Valid values: 1 or 2 IPv4 addresses.

func (AcceleratorIpSetOutput) IpFamily 

func (o AcceleratorIpSetOutput) IpFamily() pulumi.StringPtrOutput

The type of IP addresses included in this IP set.

func (AcceleratorIpSetOutput) ToAcceleratorIpSetOutput 

func (o AcceleratorIpSetOutput) ToAcceleratorIpSetOutput() AcceleratorIpSetOutput

func (AcceleratorIpSetOutput) ToAcceleratorIpSetOutputWithContext 

func (o AcceleratorIpSetOutput) ToAcceleratorIpSetOutputWithContext(ctx context.Context) AcceleratorIpSetOutput

type AcceleratorMap 

type AcceleratorMap map[string]AcceleratorInput

func (AcceleratorMap) ElementType 

func (AcceleratorMap) ElementType() reflect.Type

func (AcceleratorMap) ToAcceleratorMapOutput 

func (i AcceleratorMap) ToAcceleratorMapOutput() AcceleratorMapOutput

func (AcceleratorMap) ToAcceleratorMapOutputWithContext 

func (i AcceleratorMap) ToAcceleratorMapOutputWithContext(ctx context.Context) AcceleratorMapOutput

type AcceleratorMapInput 

type AcceleratorMapInput interface {
	pulumi.Input

	ToAcceleratorMapOutput() AcceleratorMapOutput
	ToAcceleratorMapOutputWithContext(context.Context) AcceleratorMapOutput
}

AcceleratorMapInput is an input type that accepts AcceleratorMap and AcceleratorMapOutput values. You can construct a concrete instance of `AcceleratorMapInput` via: 

AcceleratorMap{ "key": AcceleratorArgs{...} }

type AcceleratorMapOutput 

type AcceleratorMapOutput struct{ *pulumi.OutputState }

func (AcceleratorMapOutput) ElementType 

func (AcceleratorMapOutput) ElementType() reflect.Type

func (AcceleratorMapOutput) MapIndex 

func (o AcceleratorMapOutput) MapIndex(k pulumi.StringInput) AcceleratorOutput

func (AcceleratorMapOutput) ToAcceleratorMapOutput 

func (o AcceleratorMapOutput) ToAcceleratorMapOutput() AcceleratorMapOutput

func (AcceleratorMapOutput) ToAcceleratorMapOutputWithContext 

func (o AcceleratorMapOutput) ToAcceleratorMapOutputWithContext(ctx context.Context) AcceleratorMapOutput

type AcceleratorOutput 

type AcceleratorOutput struct{ *pulumi.OutputState }

func (AcceleratorOutput) Attributes added in v5.4.0 

func (o AcceleratorOutput) Attributes() AcceleratorAttributesPtrOutput

The attributes of the accelerator. Fields documented below.

func (AcceleratorOutput) DnsName added in v5.4.0 

func (o AcceleratorOutput) DnsName() pulumi.StringOutput

The DNS name of the accelerator. For example, `a5d53ff5ee6bca4ce.awsglobalaccelerator.com`.

func (AcceleratorOutput) DualStackDnsName added in v5.35.0 

func (o AcceleratorOutput) DualStackDnsName() pulumi.StringOutput

The Domain Name System (DNS) name that Global Accelerator creates that points to a dual-stack accelerator's four static IP addresses: two IPv4 addresses and two IPv6 addresses. For example, `a1234567890abcdef.dualstack.awsglobalaccelerator.com`.

func (AcceleratorOutput) ElementType 

func (AcceleratorOutput) ElementType() reflect.Type

func (AcceleratorOutput) Enabled added in v5.4.0 

func (o AcceleratorOutput) Enabled() pulumi.BoolPtrOutput

Indicates whether the accelerator is enabled. Defaults to `true`. Valid values: `true`, `false`.

func (AcceleratorOutput) HostedZoneId added in v5.4.0 

func (o AcceleratorOutput) HostedZoneId() pulumi.StringOutput

func (AcceleratorOutput) IpAddressType added in v5.4.0 

func (o AcceleratorOutput) IpAddressType() pulumi.StringPtrOutput

The value for the address type. Defaults to `IPV4`. Valid values: `IPV4`, `DUAL_STACK`.

func (AcceleratorOutput) IpAddresses added in v5.18.0 

func (o AcceleratorOutput) IpAddresses() pulumi.StringArrayOutput

The IP addresses to use for BYOIP accelerators. If not specified, the service assigns IP addresses. Valid values: 1 or 2 IPv4 addresses.

func (AcceleratorOutput) IpSets added in v5.4.0 

func (o AcceleratorOutput) IpSets() AcceleratorIpSetArrayOutput

IP address set associated with the accelerator.

func (AcceleratorOutput) Name added in v5.4.0 

func (o AcceleratorOutput) Name() pulumi.StringOutput

The name of the accelerator.

func (AcceleratorOutput) Tags added in v5.4.0 

func (o AcceleratorOutput) Tags() pulumi.StringMapOutput

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

**attributes** supports the following attributes:

func (AcceleratorOutput) TagsAll added in v5.4.0 

func (o AcceleratorOutput) TagsAll() pulumi.StringMapOutput

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

func (AcceleratorOutput) ToAcceleratorOutput 

func (o AcceleratorOutput) ToAcceleratorOutput() AcceleratorOutput

func (AcceleratorOutput) ToAcceleratorOutputWithContext 

func (o AcceleratorOutput) ToAcceleratorOutputWithContext(ctx context.Context) AcceleratorOutput

type AcceleratorState 

type AcceleratorState struct {
	// The attributes of the accelerator. Fields documented below.
	Attributes AcceleratorAttributesPtrInput
	// The DNS name of the accelerator. For example, `a5d53ff5ee6bca4ce.awsglobalaccelerator.com`.
	DnsName pulumi.StringPtrInput
	// The Domain Name System (DNS) name that Global Accelerator creates that points to a dual-stack accelerator's four static IP addresses: two IPv4 addresses and two IPv6 addresses. For example, `a1234567890abcdef.dualstack.awsglobalaccelerator.com`.
	DualStackDnsName pulumi.StringPtrInput
	// Indicates whether the accelerator is enabled. Defaults to `true`. Valid values: `true`, `false`.
	Enabled pulumi.BoolPtrInput
	// -  The Global Accelerator Route 53 zone ID that can be used to
	//    route an [Alias Resource Record Set](https://docs.aws.amazon.com/Route53/latest/APIReference/API_AliasTarget.html) to the Global Accelerator. This attribute
	//    is simply an alias for the zone ID `Z2BJ6XQ5FK7U4H`.
	HostedZoneId pulumi.StringPtrInput
	// The value for the address type. Defaults to `IPV4`. Valid values: `IPV4`, `DUAL_STACK`.
	IpAddressType pulumi.StringPtrInput
	// The IP addresses to use for BYOIP accelerators. If not specified, the service assigns IP addresses. Valid values: 1 or 2 IPv4 addresses.
	IpAddresses pulumi.StringArrayInput
	// IP address set associated with the accelerator.
	IpSets AcceleratorIpSetArrayInput
	// The name of the accelerator.
	Name pulumi.StringPtrInput
	// A map of tags to assign to the resource. .If configured with a provider `defaultTags` configuration block present, tags with matching keys will overwrite those defined at the provider-level.
	//
	// **attributes** supports the following attributes:
	Tags pulumi.StringMapInput
	// A map of tags assigned to the resource, including those inherited from the provider `defaultTags` configuration block.
	TagsAll pulumi.StringMapInput
}

func (AcceleratorState) ElementType 

func (AcceleratorState) ElementType() reflect.Type

type EndpointGroup 

type EndpointGroup struct {
	pulumi.CustomResourceState

	// The Amazon Resource Name (ARN) of the endpoint group.
	Arn pulumi.StringOutput `pulumi:"arn"`
	// The list of endpoint objects. Fields documented below.
	EndpointConfigurations EndpointGroupEndpointConfigurationArrayOutput `pulumi:"endpointConfigurations"`
	// The name of the AWS Region where the endpoint group is located.
	EndpointGroupRegion pulumi.StringOutput `pulumi:"endpointGroupRegion"`
	// The time—10 seconds or 30 seconds—between each health check for an endpoint. The default value is 30.
	HealthCheckIntervalSeconds pulumi.IntPtrOutput `pulumi:"healthCheckIntervalSeconds"`
	// If the protocol is HTTP/S, then this specifies the path that is the destination for health check targets. The default value is slash (`/`). the provider will only perform drift detection of its value when present in a configuration.
	HealthCheckPath pulumi.StringOutput `pulumi:"healthCheckPath"`
	// The port that AWS Global Accelerator uses to check the health of endpoints that are part of this endpoint group. The default port is the listener port that this endpoint group is associated with. If listener port is a list of ports, Global Accelerator uses the first port in the list.
	// the provider will only perform drift detection of its value when present in a configuration.
	HealthCheckPort pulumi.IntOutput `pulumi:"healthCheckPort"`
	// The protocol that AWS Global Accelerator uses to check the health of endpoints that are part of this endpoint group. The default value is TCP.
	HealthCheckProtocol pulumi.StringPtrOutput `pulumi:"healthCheckProtocol"`
	// The Amazon Resource Name (ARN) of the listener.
	ListenerArn pulumi.StringOutput `pulumi:"listenerArn"`
	// Override specific listener ports used to route traffic to endpoints that are part of this endpoint group. Fields documented below.
	//
	// **endpoint_configuration** supports the following attributes:
	PortOverrides EndpointGroupPortOverrideArrayOutput `pulumi:"portOverrides"`
	// The number of consecutive health checks required to set the state of a healthy endpoint to unhealthy, or to set an unhealthy endpoint to healthy. The default value is 3.
	ThresholdCount pulumi.IntPtrOutput `pulumi:"thresholdCount"`
	// The percentage of traffic to send to an AWS Region. Additional traffic is distributed to other endpoint groups for this listener. The default value is 100.
	TrafficDialPercentage pulumi.Float64PtrOutput `pulumi:"trafficDialPercentage"`
}

Provides a Global Accelerator endpoint group.

## Example Usage

```go package main

import ( 

"github.com/pulumi/pulumi-aws/sdk/v5/go/aws/globalaccelerator"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"

) 

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := globalaccelerator.NewEndpointGroup(ctx, "example", &globalaccelerator.EndpointGroupArgs{
			ListenerArn: pulumi.Any(aws_globalaccelerator_listener.Example.Id),
			EndpointConfigurations: globalaccelerator.EndpointGroupEndpointConfigurationArray{
				&globalaccelerator.EndpointGroupEndpointConfigurationArgs{
					EndpointId: pulumi.Any(aws_lb.Example.Arn),
					Weight:     pulumi.Int(100),
				},
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}

```

## Import

Global Accelerator endpoint groups can be imported using the `id`, e.g.,

```sh 

$ pulumi import aws:globalaccelerator/endpointGroup:EndpointGroup example arn:aws:globalaccelerator::111111111111:accelerator/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/listener/xxxxxxx/endpoint-group/xxxxxxxx

```

func GetEndpointGroup 

func GetEndpointGroup(ctx *pulumi.Context,
	name string, id pulumi.IDInput, state *EndpointGroupState, opts ...pulumi.ResourceOption) (*EndpointGroup, error)

GetEndpointGroup gets an existing EndpointGroup 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 NewEndpointGroup 

func NewEndpointGroup(ctx *pulumi.Context,
	name string, args *EndpointGroupArgs, opts ...pulumi.ResourceOption) (*EndpointGroup, error)

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

func (*EndpointGroup) ElementType 

func (*EndpointGroup) ElementType() reflect.Type

func (*EndpointGroup) ToEndpointGroupOutput 

func (i *EndpointGroup) ToEndpointGroupOutput() EndpointGroupOutput

func (*EndpointGroup) ToEndpointGroupOutputWithContext 

func (i *EndpointGroup) ToEndpointGroupOutputWithContext(ctx context.Context) EndpointGroupOutput

type EndpointGroupArgs 

type EndpointGroupArgs struct {
	// The list of endpoint objects. Fields documented below.
	EndpointConfigurations EndpointGroupEndpointConfigurationArrayInput
	// The name of the AWS Region where the endpoint group is located.
	EndpointGroupRegion pulumi.StringPtrInput
	// The time—10 seconds or 30 seconds—between each health check for an endpoint. The default value is 30.
	HealthCheckIntervalSeconds pulumi.IntPtrInput
	// If the protocol is HTTP/S, then this specifies the path that is the destination for health check targets. The default value is slash (`/`). the provider will only perform drift detection of its value when present in a configuration.
	HealthCheckPath pulumi.StringPtrInput
	// The port that AWS Global Accelerator uses to check the health of endpoints that are part of this endpoint group. The default port is the listener port that this endpoint group is associated with. If listener port is a list of ports, Global Accelerator uses the first port in the list.
	// the provider will only perform drift detection of its value when present in a configuration.
	HealthCheckPort pulumi.IntPtrInput
	// The protocol that AWS Global Accelerator uses to check the health of endpoints that are part of this endpoint group. The default value is TCP.
	HealthCheckProtocol pulumi.StringPtrInput
	// The Amazon Resource Name (ARN) of the listener.
	ListenerArn pulumi.StringInput
	// Override specific listener ports used to route traffic to endpoints that are part of this endpoint group. Fields documented below.
	//
	// **endpoint_configuration** supports the following attributes:
	PortOverrides EndpointGroupPortOverrideArrayInput
	// The number of consecutive health checks required to set the state of a healthy endpoint to unhealthy, or to set an unhealthy endpoint to healthy. The default value is 3.
	ThresholdCount pulumi.IntPtrInput
	// The percentage of traffic to send to an AWS Region. Additional traffic is distributed to other endpoint groups for this listener. The default value is 100.
	TrafficDialPercentage pulumi.Float64PtrInput
}

The set of arguments for constructing a EndpointGroup resource.

func (EndpointGroupArgs) ElementType 

func (EndpointGroupArgs) ElementType() reflect.Type

type EndpointGroupArray 

type EndpointGroupArray []EndpointGroupInput

func (EndpointGroupArray) ElementType 

func (EndpointGroupArray) ElementType() reflect.Type

func (EndpointGroupArray) ToEndpointGroupArrayOutput 

func (i EndpointGroupArray) ToEndpointGroupArrayOutput() EndpointGroupArrayOutput

func (EndpointGroupArray) ToEndpointGroupArrayOutputWithContext 

func (i EndpointGroupArray) ToEndpointGroupArrayOutputWithContext(ctx context.Context) EndpointGroupArrayOutput

type EndpointGroupArrayInput 

type EndpointGroupArrayInput interface {
	pulumi.Input

	ToEndpointGroupArrayOutput() EndpointGroupArrayOutput
	ToEndpointGroupArrayOutputWithContext(context.Context) EndpointGroupArrayOutput
}

EndpointGroupArrayInput is an input type that accepts EndpointGroupArray and EndpointGroupArrayOutput values. You can construct a concrete instance of `EndpointGroupArrayInput` via: 

EndpointGroupArray{ EndpointGroupArgs{...} }

type EndpointGroupArrayOutput 

type EndpointGroupArrayOutput struct{ *pulumi.OutputState }

func (EndpointGroupArrayOutput) ElementType 

func (EndpointGroupArrayOutput) ElementType() reflect.Type

func (EndpointGroupArrayOutput) Index 

func (o EndpointGroupArrayOutput) Index(i pulumi.IntInput) EndpointGroupOutput

func (EndpointGroupArrayOutput) ToEndpointGroupArrayOutput 

func (o EndpointGroupArrayOutput) ToEndpointGroupArrayOutput() EndpointGroupArrayOutput

func (EndpointGroupArrayOutput) ToEndpointGroupArrayOutputWithContext 

func (o EndpointGroupArrayOutput) ToEndpointGroupArrayOutputWithContext(ctx context.Context) EndpointGroupArrayOutput

type EndpointGroupEndpointConfiguration 

type EndpointGroupEndpointConfiguration struct {
	// Indicates whether client IP address preservation is enabled for an Application Load Balancer endpoint. See the [AWS documentation](https://docs.aws.amazon.com/global-accelerator/latest/dg/preserve-client-ip-address.html) for more details. The default value is `false`.
	// **Note:** When client IP address preservation is enabled, the Global Accelerator service creates an EC2 Security Group in the VPC named `GlobalAccelerator` that must be deleted (potentially outside of the provider) before the VPC will successfully delete. If this EC2 Security Group is not deleted, the provider will retry the VPC deletion for a few minutes before reporting a `DependencyViolation` error. This cannot be resolved by re-running the provider.
	ClientIpPreservationEnabled *bool `pulumi:"clientIpPreservationEnabled"`
	// An ID for the endpoint. If the endpoint is a Network Load Balancer or Application Load Balancer, this is the Amazon Resource Name (ARN) of the resource. If the endpoint is an Elastic IP address, this is the Elastic IP address allocation ID.
	EndpointId *string `pulumi:"endpointId"`
	// The weight associated with the endpoint. When you add weights to endpoints, you configure AWS Global Accelerator to route traffic based on proportions that you specify.
	//
	// **port_override** supports the following attributes:
	Weight *int `pulumi:"weight"`
}

type EndpointGroupEndpointConfigurationArgs 

type EndpointGroupEndpointConfigurationArgs struct {
	// Indicates whether client IP address preservation is enabled for an Application Load Balancer endpoint. See the [AWS documentation](https://docs.aws.amazon.com/global-accelerator/latest/dg/preserve-client-ip-address.html) for more details. The default value is `false`.
	// **Note:** When client IP address preservation is enabled, the Global Accelerator service creates an EC2 Security Group in the VPC named `GlobalAccelerator` that must be deleted (potentially outside of the provider) before the VPC will successfully delete. If this EC2 Security Group is not deleted, the provider will retry the VPC deletion for a few minutes before reporting a `DependencyViolation` error. This cannot be resolved by re-running the provider.
	ClientIpPreservationEnabled pulumi.BoolPtrInput `pulumi:"clientIpPreservationEnabled"`
	// An ID for the endpoint. If the endpoint is a Network Load Balancer or Application Load Balancer, this is the Amazon Resource Name (ARN) of the resource. If the endpoint is an Elastic IP address, this is the Elastic IP address allocation ID.
	EndpointId pulumi.StringPtrInput `pulumi:"endpointId"`
	// The weight associated with the endpoint. When you add weights to endpoints, you configure AWS Global Accelerator to route traffic based on proportions that you specify.
	//
	// **port_override** supports the following attributes:
	Weight pulumi.IntPtrInput `pulumi:"weight"`
}

func (EndpointGroupEndpointConfigurationArgs) ElementType 

func (EndpointGroupEndpointConfigurationArgs) ElementType() reflect.Type

func (EndpointGroupEndpointConfigurationArgs) ToEndpointGroupEndpointConfigurationOutput 

func (i EndpointGroupEndpointConfigurationArgs) ToEndpointGroupEndpointConfigurationOutput() EndpointGroupEndpointConfigurationOutput

func (EndpointGroupEndpointConfigurationArgs) ToEndpointGroupEndpointConfigurationOutputWithContext 

func (i EndpointGroupEndpointConfigurationArgs) ToEndpointGroupEndpointConfigurationOutputWithContext(ctx context.Context) EndpointGroupEndpointConfigurationOutput

type EndpointGroupEndpointConfigurationArray 

type EndpointGroupEndpointConfigurationArray []EndpointGroupEndpointConfigurationInput

func (EndpointGroupEndpointConfigurationArray) ElementType 

func (EndpointGroupEndpointConfigurationArray) ElementType() reflect.Type

func (EndpointGroupEndpointConfigurationArray) ToEndpointGroupEndpointConfigurationArrayOutput 

func (i EndpointGroupEndpointConfigurationArray) ToEndpointGroupEndpointConfigurationArrayOutput() EndpointGroupEndpointConfigurationArrayOutput

func (EndpointGroupEndpointConfigurationArray) ToEndpointGroupEndpointConfigurationArrayOutputWithContext 

func (i EndpointGroupEndpointConfigurationArray) ToEndpointGroupEndpointConfigurationArrayOutputWithContext(ctx context.Context) EndpointGroupEndpointConfigurationArrayOutput

type EndpointGroupEndpointConfigurationArrayInput 

type EndpointGroupEndpointConfigurationArrayInput interface {
	pulumi.Input

	ToEndpointGroupEndpointConfigurationArrayOutput() EndpointGroupEndpointConfigurationArrayOutput
	ToEndpointGroupEndpointConfigurationArrayOutputWithContext(context.Context) EndpointGroupEndpointConfigurationArrayOutput
}

EndpointGroupEndpointConfigurationArrayInput is an input type that accepts EndpointGroupEndpointConfigurationArray and EndpointGroupEndpointConfigurationArrayOutput values. You can construct a concrete instance of `EndpointGroupEndpointConfigurationArrayInput` via: 

EndpointGroupEndpointConfigurationArray{ EndpointGroupEndpointConfigurationArgs{...} }

type EndpointGroupEndpointConfigurationArrayOutput 

type EndpointGroupEndpointConfigurationArrayOutput struct{ *pulumi.OutputState }

func (EndpointGroupEndpointConfigurationArrayOutput) ElementType 

func (EndpointGroupEndpointConfigurationArrayOutput) ElementType() reflect.Type

func (EndpointGroupEndpointConfigurationArrayOutput) Index 

func (o EndpointGroupEndpointConfigurationArrayOutput) Index(i pulumi.IntInput) EndpointGroupEndpointConfigurationOutput

func (EndpointGroupEndpointConfigurationArrayOutput) ToEndpointGroupEndpointConfigurationArrayOutput 

func (o EndpointGroupEndpointConfigurationArrayOutput) ToEndpointGroupEndpointConfigurationArrayOutput() EndpointGroupEndpointConfigurationArrayOutput

func (EndpointGroupEndpointConfigurationArrayOutput) ToEndpointGroupEndpointConfigurationArrayOutputWithContext 

func (o EndpointGroupEndpointConfigurationArrayOutput) ToEndpointGroupEndpointConfigurationArrayOutputWithContext(ctx context.Context) EndpointGroupEndpointConfigurationArrayOutput

type EndpointGroupEndpointConfigurationInput 

type EndpointGroupEndpointConfigurationInput interface {
	pulumi.Input

	ToEndpointGroupEndpointConfigurationOutput() EndpointGroupEndpointConfigurationOutput
	ToEndpointGroupEndpointConfigurationOutputWithContext(context.Context) EndpointGroupEndpointConfigurationOutput
}

EndpointGroupEndpointConfigurationInput is an input type that accepts EndpointGroupEndpointConfigurationArgs and EndpointGroupEndpointConfigurationOutput values. You can construct a concrete instance of `EndpointGroupEndpointConfigurationInput` via: 

EndpointGroupEndpointConfigurationArgs{...}

type EndpointGroupEndpointConfigurationOutput 

type EndpointGroupEndpointConfigurationOutput struct{ *pulumi.OutputState }

func (EndpointGroupEndpointConfigurationOutput) ClientIpPreservationEnabled 

func (o EndpointGroupEndpointConfigurationOutput) ClientIpPreservationEnabled() pulumi.BoolPtrOutput

Indicates whether client IP address preservation is enabled for an Application Load Balancer endpoint. See the [AWS documentation](https://docs.aws.amazon.com/global-accelerator/latest/dg/preserve-client-ip-address.html) for more details. The default value is `false`. **Note:** When client IP address preservation is enabled, the Global Accelerator service creates an EC2 Security Group in the VPC named `GlobalAccelerator` that must be deleted (potentially outside of the provider) before the VPC will successfully delete. If this EC2 Security Group is not deleted, the provider will retry the VPC deletion for a few minutes before reporting a `DependencyViolation` error. This cannot be resolved by re-running the provider.

func (EndpointGroupEndpointConfigurationOutput) ElementType 

func (EndpointGroupEndpointConfigurationOutput) ElementType() reflect.Type

func (EndpointGroupEndpointConfigurationOutput) EndpointId 

func (o EndpointGroupEndpointConfigurationOutput) EndpointId() pulumi.StringPtrOutput

An ID for the endpoint. If the endpoint is a Network Load Balancer or Application Load Balancer, this is the Amazon Resource Name (ARN) of the resource. If the endpoint is an Elastic IP address, this is the Elastic IP address allocation ID.

func (EndpointGroupEndpointConfigurationOutput) ToEndpointGroupEndpointConfigurationOutput 

func (o EndpointGroupEndpointConfigurationOutput) ToEndpointGroupEndpointConfigurationOutput() EndpointGroupEndpointConfigurationOutput

func (EndpointGroupEndpointConfigurationOutput) ToEndpointGroupEndpointConfigurationOutputWithContext 

func (o EndpointGroupEndpointConfigurationOutput) ToEndpointGroupEndpointConfigurationOutputWithContext(ctx context.Context) EndpointGroupEndpointConfigurationOutput

func (EndpointGroupEndpointConfigurationOutput) Weight 

func (o EndpointGroupEndpointConfigurationOutput) Weight() pulumi.IntPtrOutput

The weight associated with the endpoint. When you add weights to endpoints, you configure AWS Global Accelerator to route traffic based on proportions that you specify.

**port_override** supports the following attributes:

type EndpointGroupInput 

type EndpointGroupInput interface {
	pulumi.Input

	ToEndpointGroupOutput() EndpointGroupOutput
	ToEndpointGroupOutputWithContext(ctx context.Context) EndpointGroupOutput
}

type EndpointGroupMap 

type EndpointGroupMap map[string]EndpointGroupInput

func (EndpointGroupMap) ElementType 

func (EndpointGroupMap) ElementType() reflect.Type

func (EndpointGroupMap) ToEndpointGroupMapOutput 

func (i EndpointGroupMap) ToEndpointGroupMapOutput() EndpointGroupMapOutput

func (EndpointGroupMap) ToEndpointGroupMapOutputWithContext 

func (i EndpointGroupMap) ToEndpointGroupMapOutputWithContext(ctx context.Context) EndpointGroupMapOutput

type EndpointGroupMapInput 

type EndpointGroupMapInput interface {
	pulumi.Input

	ToEndpointGroupMapOutput() EndpointGroupMapOutput
	ToEndpointGroupMapOutputWithContext(context.Context) EndpointGroupMapOutput
}

EndpointGroupMapInput is an input type that accepts EndpointGroupMap and EndpointGroupMapOutput values. You can construct a concrete instance of `EndpointGroupMapInput` via: 

EndpointGroupMap{ "key": EndpointGroupArgs{...} }

type EndpointGroupMapOutput 

type EndpointGroupMapOutput struct{ *pulumi.OutputState }

func (EndpointGroupMapOutput) ElementType 

func (EndpointGroupMapOutput) ElementType() reflect.Type

func (EndpointGroupMapOutput) MapIndex 

func (o EndpointGroupMapOutput) MapIndex(k pulumi.StringInput) EndpointGroupOutput

func (EndpointGroupMapOutput) ToEndpointGroupMapOutput 

func (o EndpointGroupMapOutput) ToEndpointGroupMapOutput() EndpointGroupMapOutput

func (EndpointGroupMapOutput) ToEndpointGroupMapOutputWithContext 

func (o EndpointGroupMapOutput) ToEndpointGroupMapOutputWithContext(ctx context.Context) EndpointGroupMapOutput

type EndpointGroupOutput 

type EndpointGroupOutput struct{ *pulumi.OutputState }

func (EndpointGroupOutput) Arn added in v5.4.0 

func (o EndpointGroupOutput) Arn() pulumi.StringOutput

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

func (EndpointGroupOutput) ElementType 

func (EndpointGroupOutput) ElementType() reflect.Type

func (EndpointGroupOutput) EndpointConfigurations added in v5.4.0 

func (o EndpointGroupOutput) EndpointConfigurations() EndpointGroupEndpointConfigurationArrayOutput

The list of endpoint objects. Fields documented below.

func (EndpointGroupOutput) EndpointGroupRegion added in v5.4.0 

func (o EndpointGroupOutput) EndpointGroupRegion() pulumi.StringOutput

The name of the AWS Region where the endpoint group is located.

func (EndpointGroupOutput) HealthCheckIntervalSeconds added in v5.4.0 

func (o EndpointGroupOutput) HealthCheckIntervalSeconds() pulumi.IntPtrOutput

The time—10 seconds or 30 seconds—between each health check for an endpoint. The default value is 30.

func (EndpointGroupOutput) HealthCheckPath added in v5.4.0 

func (o EndpointGroupOutput) HealthCheckPath() pulumi.StringOutput

If the protocol is HTTP/S, then this specifies the path that is the destination for health check targets. The default value is slash (`/`). the provider will only perform drift detection of its value when present in a configuration.

func (EndpointGroupOutput) HealthCheckPort added in v5.4.0 

func (o EndpointGroupOutput) HealthCheckPort() pulumi.IntOutput

The port that AWS Global Accelerator uses to check the health of endpoints that are part of this endpoint group. The default port is the listener port that this endpoint group is associated with. If listener port is a list of ports, Global Accelerator uses the first port in the list. the provider will only perform drift detection of its value when present in a configuration.

func (EndpointGroupOutput) HealthCheckProtocol added in v5.4.0 

func (o EndpointGroupOutput) HealthCheckProtocol() pulumi.StringPtrOutput

The protocol that AWS Global Accelerator uses to check the health of endpoints that are part of this endpoint group. The default value is TCP.

func (EndpointGroupOutput) ListenerArn added in v5.4.0 

func (o EndpointGroupOutput) ListenerArn() pulumi.StringOutput

The Amazon Resource Name (ARN) of the listener.

func (EndpointGroupOutput) PortOverrides added in v5.4.0 

func (o EndpointGroupOutput) PortOverrides() EndpointGroupPortOverrideArrayOutput

Override specific listener ports used to route traffic to endpoints that are part of this endpoint group. Fields documented below.

**endpoint_configuration** supports the following attributes:

func (EndpointGroupOutput) ThresholdCount added in v5.4.0 

func (o EndpointGroupOutput) ThresholdCount() pulumi.IntPtrOutput

The number of consecutive health checks required to set the state of a healthy endpoint to unhealthy, or to set an unhealthy endpoint to healthy. The default value is 3.

func (EndpointGroupOutput) ToEndpointGroupOutput 

func (o EndpointGroupOutput) ToEndpointGroupOutput() EndpointGroupOutput

func (EndpointGroupOutput) ToEndpointGroupOutputWithContext 

func (o EndpointGroupOutput) ToEndpointGroupOutputWithContext(ctx context.Context) EndpointGroupOutput

func (EndpointGroupOutput) TrafficDialPercentage added in v5.4.0 

func (o EndpointGroupOutput) TrafficDialPercentage() pulumi.Float64PtrOutput

The percentage of traffic to send to an AWS Region. Additional traffic is distributed to other endpoint groups for this listener. The default value is 100.

type EndpointGroupPortOverride 

type EndpointGroupPortOverride struct {
	// The endpoint port that you want a listener port to be mapped to. This is the port on the endpoint, such as the Application Load Balancer or Amazon EC2 instance.
	EndpointPort int `pulumi:"endpointPort"`
	// The listener port that you want to map to a specific endpoint port. This is the port that user traffic arrives to the Global Accelerator on.
	ListenerPort int `pulumi:"listenerPort"`
}

type EndpointGroupPortOverrideArgs 

type EndpointGroupPortOverrideArgs struct {
	// The endpoint port that you want a listener port to be mapped to. This is the port on the endpoint, such as the Application Load Balancer or Amazon EC2 instance.
	EndpointPort pulumi.IntInput `pulumi:"endpointPort"`
	// The listener port that you want to map to a specific endpoint port. This is the port that user traffic arrives to the Global Accelerator on.
	ListenerPort pulumi.IntInput `pulumi:"listenerPort"`
}

func (EndpointGroupPortOverrideArgs) ElementType 

func (EndpointGroupPortOverrideArgs) ElementType() reflect.Type

func (EndpointGroupPortOverrideArgs) ToEndpointGroupPortOverrideOutput 

func (i EndpointGroupPortOverrideArgs) ToEndpointGroupPortOverrideOutput() EndpointGroupPortOverrideOutput

func (EndpointGroupPortOverrideArgs) ToEndpointGroupPortOverrideOutputWithContext 

func (i EndpointGroupPortOverrideArgs) ToEndpointGroupPortOverrideOutputWithContext(ctx context.Context) EndpointGroupPortOverrideOutput

type EndpointGroupPortOverrideArray 

type EndpointGroupPortOverrideArray []EndpointGroupPortOverrideInput

func (EndpointGroupPortOverrideArray) ElementType 

func (EndpointGroupPortOverrideArray) ElementType() reflect.Type

func (EndpointGroupPortOverrideArray) ToEndpointGroupPortOverrideArrayOutput 

func (i EndpointGroupPortOverrideArray) ToEndpointGroupPortOverrideArrayOutput() EndpointGroupPortOverrideArrayOutput

func (EndpointGroupPortOverrideArray) ToEndpointGroupPortOverrideArrayOutputWithContext 

func (i EndpointGroupPortOverrideArray) ToEndpointGroupPortOverrideArrayOutputWithContext(ctx context.Context) EndpointGroupPortOverrideArrayOutput

type EndpointGroupPortOverrideArrayInput 

type EndpointGroupPortOverrideArrayInput interface {
	pulumi.Input

	ToEndpointGroupPortOverrideArrayOutput() EndpointGroupPortOverrideArrayOutput
	ToEndpointGroupPortOverrideArrayOutputWithContext(context.Context) EndpointGroupPortOverrideArrayOutput
}

EndpointGroupPortOverrideArrayInput is an input type that accepts EndpointGroupPortOverrideArray and EndpointGroupPortOverrideArrayOutput values. You can construct a concrete instance of `EndpointGroupPortOverrideArrayInput` via: 

EndpointGroupPortOverrideArray{ EndpointGroupPortOverrideArgs{...} }

type EndpointGroupPortOverrideArrayOutput 

type EndpointGroupPortOverrideArrayOutput struct{ *pulumi.OutputState }

func (EndpointGroupPortOverrideArrayOutput) ElementType 

func (EndpointGroupPortOverrideArrayOutput) ElementType() reflect.Type

func (EndpointGroupPortOverrideArrayOutput) Index 

func (o EndpointGroupPortOverrideArrayOutput) Index(i pulumi.IntInput) EndpointGroupPortOverrideOutput

func (EndpointGroupPortOverrideArrayOutput) ToEndpointGroupPortOverrideArrayOutput 

func (o EndpointGroupPortOverrideArrayOutput) ToEndpointGroupPortOverrideArrayOutput() EndpointGroupPortOverrideArrayOutput

func (EndpointGroupPortOverrideArrayOutput) ToEndpointGroupPortOverrideArrayOutputWithContext 

func (o EndpointGroupPortOverrideArrayOutput) ToEndpointGroupPortOverrideArrayOutputWithContext(ctx context.Context) EndpointGroupPortOverrideArrayOutput

type EndpointGroupPortOverrideInput 

type EndpointGroupPortOverrideInput interface {
	pulumi.Input

	ToEndpointGroupPortOverrideOutput() EndpointGroupPortOverrideOutput
	ToEndpointGroupPortOverrideOutputWithContext(context.Context) EndpointGroupPortOverrideOutput
}

EndpointGroupPortOverrideInput is an input type that accepts EndpointGroupPortOverrideArgs and EndpointGroupPortOverrideOutput values. You can construct a concrete instance of `EndpointGroupPortOverrideInput` via: 

EndpointGroupPortOverrideArgs{...}

type EndpointGroupPortOverrideOutput 

type EndpointGroupPortOverrideOutput struct{ *pulumi.OutputState }

func (EndpointGroupPortOverrideOutput) ElementType 

func (EndpointGroupPortOverrideOutput) ElementType() reflect.Type

func (EndpointGroupPortOverrideOutput) EndpointPort 

func (o EndpointGroupPortOverrideOutput) EndpointPort() pulumi.IntOutput

The endpoint port that you want a listener port to be mapped to. This is the port on the endpoint, such as the Application Load Balancer or Amazon EC2 instance.

func (EndpointGroupPortOverrideOutput) ListenerPort 

func (o EndpointGroupPortOverrideOutput) ListenerPort() pulumi.IntOutput

The listener port that you want to map to a specific endpoint port. This is the port that user traffic arrives to the Global Accelerator on.

func (EndpointGroupPortOverrideOutput) ToEndpointGroupPortOverrideOutput 

func (o EndpointGroupPortOverrideOutput) ToEndpointGroupPortOverrideOutput() EndpointGroupPortOverrideOutput

func (EndpointGroupPortOverrideOutput) ToEndpointGroupPortOverrideOutputWithContext 

func (o EndpointGroupPortOverrideOutput) ToEndpointGroupPortOverrideOutputWithContext(ctx context.Context) EndpointGroupPortOverrideOutput

type EndpointGroupState 

type EndpointGroupState struct {
	// The Amazon Resource Name (ARN) of the endpoint group.
	Arn pulumi.StringPtrInput
	// The list of endpoint objects. Fields documented below.
	EndpointConfigurations EndpointGroupEndpointConfigurationArrayInput
	// The name of the AWS Region where the endpoint group is located.
	EndpointGroupRegion pulumi.StringPtrInput
	// The time—10 seconds or 30 seconds—between each health check for an endpoint. The default value is 30.
	HealthCheckIntervalSeconds pulumi.IntPtrInput
	// If the protocol is HTTP/S, then this specifies the path that is the destination for health check targets. The default value is slash (`/`). the provider will only perform drift detection of its value when present in a configuration.
	HealthCheckPath pulumi.StringPtrInput
	// The port that AWS Global Accelerator uses to check the health of endpoints that are part of this endpoint group. The default port is the listener port that this endpoint group is associated with. If listener port is a list of ports, Global Accelerator uses the first port in the list.
	// the provider will only perform drift detection of its value when present in a configuration.
	HealthCheckPort pulumi.IntPtrInput
	// The protocol that AWS Global Accelerator uses to check the health of endpoints that are part of this endpoint group. The default value is TCP.
	HealthCheckProtocol pulumi.StringPtrInput
	// The Amazon Resource Name (ARN) of the listener.
	ListenerArn pulumi.StringPtrInput
	// Override specific listener ports used to route traffic to endpoints that are part of this endpoint group. Fields documented below.
	//
	// **endpoint_configuration** supports the following attributes:
	PortOverrides EndpointGroupPortOverrideArrayInput
	// The number of consecutive health checks required to set the state of a healthy endpoint to unhealthy, or to set an unhealthy endpoint to healthy. The default value is 3.
	ThresholdCount pulumi.IntPtrInput
	// The percentage of traffic to send to an AWS Region. Additional traffic is distributed to other endpoint groups for this listener. The default value is 100.
	TrafficDialPercentage pulumi.Float64PtrInput
}

func (EndpointGroupState) ElementType 

func (EndpointGroupState) ElementType() reflect.Type

type GetAcceleratorAttribute 

type GetAcceleratorAttribute struct {
	FlowLogsEnabled  bool   `pulumi:"flowLogsEnabled"`
	FlowLogsS3Bucket string `pulumi:"flowLogsS3Bucket"`
	FlowLogsS3Prefix string `pulumi:"flowLogsS3Prefix"`
}

type GetAcceleratorAttributeArgs 

type GetAcceleratorAttributeArgs struct {
	FlowLogsEnabled  pulumi.BoolInput   `pulumi:"flowLogsEnabled"`
	FlowLogsS3Bucket pulumi.StringInput `pulumi:"flowLogsS3Bucket"`
	FlowLogsS3Prefix pulumi.StringInput `pulumi:"flowLogsS3Prefix"`
}

func (GetAcceleratorAttributeArgs) ElementType 

func (GetAcceleratorAttributeArgs) ElementType() reflect.Type

func (GetAcceleratorAttributeArgs) ToGetAcceleratorAttributeOutput 

func (i GetAcceleratorAttributeArgs) ToGetAcceleratorAttributeOutput() GetAcceleratorAttributeOutput

func (GetAcceleratorAttributeArgs) ToGetAcceleratorAttributeOutputWithContext 

func (i GetAcceleratorAttributeArgs) ToGetAcceleratorAttributeOutputWithContext(ctx context.Context) GetAcceleratorAttributeOutput

type GetAcceleratorAttributeArray 

type GetAcceleratorAttributeArray []GetAcceleratorAttributeInput

func (GetAcceleratorAttributeArray) ElementType 

func (GetAcceleratorAttributeArray) ElementType() reflect.Type

func (GetAcceleratorAttributeArray) ToGetAcceleratorAttributeArrayOutput 

func (i GetAcceleratorAttributeArray) ToGetAcceleratorAttributeArrayOutput() GetAcceleratorAttributeArrayOutput

func (GetAcceleratorAttributeArray) ToGetAcceleratorAttributeArrayOutputWithContext 

func (i GetAcceleratorAttributeArray) ToGetAcceleratorAttributeArrayOutputWithContext(ctx context.Context) GetAcceleratorAttributeArrayOutput

type GetAcceleratorAttributeArrayInput 

type GetAcceleratorAttributeArrayInput interface {
	pulumi.Input

	ToGetAcceleratorAttributeArrayOutput() GetAcceleratorAttributeArrayOutput
	ToGetAcceleratorAttributeArrayOutputWithContext(context.Context) GetAcceleratorAttributeArrayOutput
}

GetAcceleratorAttributeArrayInput is an input type that accepts GetAcceleratorAttributeArray and GetAcceleratorAttributeArrayOutput values. You can construct a concrete instance of `GetAcceleratorAttributeArrayInput` via: 

GetAcceleratorAttributeArray{ GetAcceleratorAttributeArgs{...} }

type GetAcceleratorAttributeArrayOutput 

type GetAcceleratorAttributeArrayOutput struct{ *pulumi.OutputState }

func (GetAcceleratorAttributeArrayOutput) ElementType 

func (GetAcceleratorAttributeArrayOutput) ElementType() reflect.Type

func (GetAcceleratorAttributeArrayOutput) Index 

func (o GetAcceleratorAttributeArrayOutput) Index(i pulumi.IntInput) GetAcceleratorAttributeOutput

func (GetAcceleratorAttributeArrayOutput) ToGetAcceleratorAttributeArrayOutput 

func (o GetAcceleratorAttributeArrayOutput) ToGetAcceleratorAttributeArrayOutput() GetAcceleratorAttributeArrayOutput

func (GetAcceleratorAttributeArrayOutput) ToGetAcceleratorAttributeArrayOutputWithContext 

func (o GetAcceleratorAttributeArrayOutput) ToGetAcceleratorAttributeArrayOutputWithContext(ctx context.Context) GetAcceleratorAttributeArrayOutput

type GetAcceleratorAttributeInput 

type GetAcceleratorAttributeInput interface {
	pulumi.Input

	ToGetAcceleratorAttributeOutput() GetAcceleratorAttributeOutput
	ToGetAcceleratorAttributeOutputWithContext(context.Context) GetAcceleratorAttributeOutput
}

GetAcceleratorAttributeInput is an input type that accepts GetAcceleratorAttributeArgs and GetAcceleratorAttributeOutput values. You can construct a concrete instance of `GetAcceleratorAttributeInput` via: 

GetAcceleratorAttributeArgs{...}

type GetAcceleratorAttributeOutput 

type GetAcceleratorAttributeOutput struct{ *pulumi.OutputState }

func (GetAcceleratorAttributeOutput) ElementType 

func (GetAcceleratorAttributeOutput) ElementType() reflect.Type

func (GetAcceleratorAttributeOutput) FlowLogsEnabled 

func (o GetAcceleratorAttributeOutput) FlowLogsEnabled() pulumi.BoolOutput

func (GetAcceleratorAttributeOutput) FlowLogsS3Bucket 

func (o GetAcceleratorAttributeOutput) FlowLogsS3Bucket() pulumi.StringOutput

func (GetAcceleratorAttributeOutput) FlowLogsS3Prefix 

func (o GetAcceleratorAttributeOutput) FlowLogsS3Prefix() pulumi.StringOutput

func (GetAcceleratorAttributeOutput) ToGetAcceleratorAttributeOutput 

func (o GetAcceleratorAttributeOutput) ToGetAcceleratorAttributeOutput() GetAcceleratorAttributeOutput

func (GetAcceleratorAttributeOutput) ToGetAcceleratorAttributeOutputWithContext 

func (o GetAcceleratorAttributeOutput) ToGetAcceleratorAttributeOutputWithContext(ctx context.Context) GetAcceleratorAttributeOutput

type GetAcceleratorIpSet 

type GetAcceleratorIpSet struct {
	IpAddresses []string `pulumi:"ipAddresses"`
	IpFamily    string   `pulumi:"ipFamily"`
}

type GetAcceleratorIpSetArgs 

type GetAcceleratorIpSetArgs struct {
	IpAddresses pulumi.StringArrayInput `pulumi:"ipAddresses"`
	IpFamily    pulumi.StringInput      `pulumi:"ipFamily"`
}

func (GetAcceleratorIpSetArgs) ElementType 

func (GetAcceleratorIpSetArgs) ElementType() reflect.Type

func (GetAcceleratorIpSetArgs) ToGetAcceleratorIpSetOutput 

func (i GetAcceleratorIpSetArgs) ToGetAcceleratorIpSetOutput() GetAcceleratorIpSetOutput

func (GetAcceleratorIpSetArgs) ToGetAcceleratorIpSetOutputWithContext 

func (i GetAcceleratorIpSetArgs) ToGetAcceleratorIpSetOutputWithContext(ctx context.Context) GetAcceleratorIpSetOutput

type GetAcceleratorIpSetArray 

type GetAcceleratorIpSetArray []GetAcceleratorIpSetInput

func (GetAcceleratorIpSetArray) ElementType 

func (GetAcceleratorIpSetArray) ElementType() reflect.Type

func (GetAcceleratorIpSetArray) ToGetAcceleratorIpSetArrayOutput 

func (i GetAcceleratorIpSetArray) ToGetAcceleratorIpSetArrayOutput() GetAcceleratorIpSetArrayOutput

func (GetAcceleratorIpSetArray) ToGetAcceleratorIpSetArrayOutputWithContext 

func (i GetAcceleratorIpSetArray) ToGetAcceleratorIpSetArrayOutputWithContext(ctx context.Context) GetAcceleratorIpSetArrayOutput

type GetAcceleratorIpSetArrayInput 

type GetAcceleratorIpSetArrayInput interface {
	pulumi.Input

	ToGetAcceleratorIpSetArrayOutput() GetAcceleratorIpSetArrayOutput
	ToGetAcceleratorIpSetArrayOutputWithContext(context.Context) GetAcceleratorIpSetArrayOutput
}

GetAcceleratorIpSetArrayInput is an input type that accepts GetAcceleratorIpSetArray and GetAcceleratorIpSetArrayOutput values. You can construct a concrete instance of `GetAcceleratorIpSetArrayInput` via: 

GetAcceleratorIpSetArray{ GetAcceleratorIpSetArgs{...} }

type GetAcceleratorIpSetArrayOutput 

type GetAcceleratorIpSetArrayOutput struct{ *pulumi.OutputState }

func (GetAcceleratorIpSetArrayOutput) ElementType 

func (GetAcceleratorIpSetArrayOutput) ElementType() reflect.Type

func (GetAcceleratorIpSetArrayOutput) Index 

func (o GetAcceleratorIpSetArrayOutput) Index(i pulumi.IntInput) GetAcceleratorIpSetOutput

func (GetAcceleratorIpSetArrayOutput) ToGetAcceleratorIpSetArrayOutput 

func (o GetAcceleratorIpSetArrayOutput) ToGetAcceleratorIpSetArrayOutput() GetAcceleratorIpSetArrayOutput

func (GetAcceleratorIpSetArrayOutput) ToGetAcceleratorIpSetArrayOutputWithContext 

func (o GetAcceleratorIpSetArrayOutput) ToGetAcceleratorIpSetArrayOutputWithContext(ctx context.Context) GetAcceleratorIpSetArrayOutput

type GetAcceleratorIpSetInput 

type GetAcceleratorIpSetInput interface {
	pulumi.Input

	ToGetAcceleratorIpSetOutput() GetAcceleratorIpSetOutput
	ToGetAcceleratorIpSetOutputWithContext(context.Context) GetAcceleratorIpSetOutput
}

GetAcceleratorIpSetInput is an input type that accepts GetAcceleratorIpSetArgs and GetAcceleratorIpSetOutput values. You can construct a concrete instance of `GetAcceleratorIpSetInput` via: 

GetAcceleratorIpSetArgs{...}

type GetAcceleratorIpSetOutput 

type GetAcceleratorIpSetOutput struct{ *pulumi.OutputState }

func (GetAcceleratorIpSetOutput) ElementType 

func (GetAcceleratorIpSetOutput) ElementType() reflect.Type

func (GetAcceleratorIpSetOutput) IpAddresses 

func (o GetAcceleratorIpSetOutput) IpAddresses() pulumi.StringArrayOutput

func (GetAcceleratorIpSetOutput) IpFamily 

func (o GetAcceleratorIpSetOutput) IpFamily() pulumi.StringOutput

func (GetAcceleratorIpSetOutput) ToGetAcceleratorIpSetOutput 

func (o GetAcceleratorIpSetOutput) ToGetAcceleratorIpSetOutput() GetAcceleratorIpSetOutput

func (GetAcceleratorIpSetOutput) ToGetAcceleratorIpSetOutputWithContext 

func (o GetAcceleratorIpSetOutput) ToGetAcceleratorIpSetOutputWithContext(ctx context.Context) GetAcceleratorIpSetOutput

type Listener 

type Listener struct {
	pulumi.CustomResourceState

	// The Amazon Resource Name (ARN) of your accelerator.
	AcceleratorArn pulumi.StringOutput `pulumi:"acceleratorArn"`
	// Direct all requests from a user to the same endpoint. Valid values are `NONE`, `SOURCE_IP`. Default: `NONE`. If `NONE`, Global Accelerator uses the "five-tuple" properties of source IP address, source port, destination IP address, destination port, and protocol to select the hash value. If `SOURCE_IP`, Global Accelerator uses the "two-tuple" properties of source (client) IP address and destination IP address to select the hash value.
	ClientAffinity pulumi.StringPtrOutput `pulumi:"clientAffinity"`
	// The list of port ranges for the connections from clients to the accelerator. Fields documented below.
	//
	// **port_range** supports the following attributes:
	PortRanges ListenerPortRangeArrayOutput `pulumi:"portRanges"`
	// The protocol for the connections from clients to the accelerator. Valid values are `TCP`, `UDP`.
	Protocol pulumi.StringOutput `pulumi:"protocol"`
}

Provides a Global Accelerator listener.

## Example Usage

```go package main

import ( 

"github.com/pulumi/pulumi-aws/sdk/v5/go/aws/globalaccelerator"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"

) 

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		exampleAccelerator, err := globalaccelerator.NewAccelerator(ctx, "exampleAccelerator", &globalaccelerator.AcceleratorArgs{
			IpAddressType: pulumi.String("IPV4"),
			Enabled:       pulumi.Bool(true),
			Attributes: &globalaccelerator.AcceleratorAttributesArgs{
				FlowLogsEnabled:  pulumi.Bool(true),
				FlowLogsS3Bucket: pulumi.String("example-bucket"),
				FlowLogsS3Prefix: pulumi.String("flow-logs/"),
			},
		})
		if err != nil {
			return err
		}
		_, err = globalaccelerator.NewListener(ctx, "exampleListener", &globalaccelerator.ListenerArgs{
			AcceleratorArn: exampleAccelerator.ID(),
			ClientAffinity: pulumi.String("SOURCE_IP"),
			Protocol:       pulumi.String("TCP"),
			PortRanges: globalaccelerator.ListenerPortRangeArray{
				&globalaccelerator.ListenerPortRangeArgs{
					FromPort: pulumi.Int(80),
					ToPort:   pulumi.Int(80),
				},
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}

```

## Import

Global Accelerator listeners can be imported using the `id`, e.g.,

```sh 

$ pulumi import aws:globalaccelerator/listener:Listener example arn:aws:globalaccelerator::111111111111:accelerator/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/listener/xxxxxxxx

```

func GetListener 

func GetListener(ctx *pulumi.Context,
	name string, id pulumi.IDInput, state *ListenerState, opts ...pulumi.ResourceOption) (*Listener, error)

GetListener gets an existing Listener 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 NewListener 

func NewListener(ctx *pulumi.Context,
	name string, args *ListenerArgs, opts ...pulumi.ResourceOption) (*Listener, error)

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

func (*Listener) ElementType 

func (*Listener) ElementType() reflect.Type

func (*Listener) ToListenerOutput 

func (i *Listener) ToListenerOutput() ListenerOutput

func (*Listener) ToListenerOutputWithContext 

func (i *Listener) ToListenerOutputWithContext(ctx context.Context) ListenerOutput

type ListenerArgs 

type ListenerArgs struct {
	// The Amazon Resource Name (ARN) of your accelerator.
	AcceleratorArn pulumi.StringInput
	// Direct all requests from a user to the same endpoint. Valid values are `NONE`, `SOURCE_IP`. Default: `NONE`. If `NONE`, Global Accelerator uses the "five-tuple" properties of source IP address, source port, destination IP address, destination port, and protocol to select the hash value. If `SOURCE_IP`, Global Accelerator uses the "two-tuple" properties of source (client) IP address and destination IP address to select the hash value.
	ClientAffinity pulumi.StringPtrInput
	// The list of port ranges for the connections from clients to the accelerator. Fields documented below.
	//
	// **port_range** supports the following attributes:
	PortRanges ListenerPortRangeArrayInput
	// The protocol for the connections from clients to the accelerator. Valid values are `TCP`, `UDP`.
	Protocol pulumi.StringInput
}

The set of arguments for constructing a Listener resource.

func (ListenerArgs) ElementType 

func (ListenerArgs) ElementType() reflect.Type

type ListenerArray 

type ListenerArray []ListenerInput

func (ListenerArray) ElementType 

func (ListenerArray) ElementType() reflect.Type

func (ListenerArray) ToListenerArrayOutput 

func (i ListenerArray) ToListenerArrayOutput() ListenerArrayOutput

func (ListenerArray) ToListenerArrayOutputWithContext 

func (i ListenerArray) ToListenerArrayOutputWithContext(ctx context.Context) ListenerArrayOutput

type ListenerArrayInput 

type ListenerArrayInput interface {
	pulumi.Input

	ToListenerArrayOutput() ListenerArrayOutput
	ToListenerArrayOutputWithContext(context.Context) ListenerArrayOutput
}

ListenerArrayInput is an input type that accepts ListenerArray and ListenerArrayOutput values. You can construct a concrete instance of `ListenerArrayInput` via: 

ListenerArray{ ListenerArgs{...} }

type ListenerArrayOutput 

type ListenerArrayOutput struct{ *pulumi.OutputState }

func (ListenerArrayOutput) ElementType 

func (ListenerArrayOutput) ElementType() reflect.Type

func (ListenerArrayOutput) Index 

func (o ListenerArrayOutput) Index(i pulumi.IntInput) ListenerOutput

func (ListenerArrayOutput) ToListenerArrayOutput 

func (o ListenerArrayOutput) ToListenerArrayOutput() ListenerArrayOutput

func (ListenerArrayOutput) ToListenerArrayOutputWithContext 

func (o ListenerArrayOutput) ToListenerArrayOutputWithContext(ctx context.Context) ListenerArrayOutput

type ListenerInput 

type ListenerInput interface {
	pulumi.Input

	ToListenerOutput() ListenerOutput
	ToListenerOutputWithContext(ctx context.Context) ListenerOutput
}

type ListenerMap 

type ListenerMap map[string]ListenerInput

func (ListenerMap) ElementType 

func (ListenerMap) ElementType() reflect.Type

func (ListenerMap) ToListenerMapOutput 

func (i ListenerMap) ToListenerMapOutput() ListenerMapOutput

func (ListenerMap) ToListenerMapOutputWithContext 

func (i ListenerMap) ToListenerMapOutputWithContext(ctx context.Context) ListenerMapOutput

type ListenerMapInput 

type ListenerMapInput interface {
	pulumi.Input

	ToListenerMapOutput() ListenerMapOutput
	ToListenerMapOutputWithContext(context.Context) ListenerMapOutput
}

ListenerMapInput is an input type that accepts ListenerMap and ListenerMapOutput values. You can construct a concrete instance of `ListenerMapInput` via: 

ListenerMap{ "key": ListenerArgs{...} }

type ListenerMapOutput 

type ListenerMapOutput struct{ *pulumi.OutputState }

func (ListenerMapOutput) ElementType 

func (ListenerMapOutput) ElementType() reflect.Type

func (ListenerMapOutput) MapIndex 

func (o ListenerMapOutput) MapIndex(k pulumi.StringInput) ListenerOutput

func (ListenerMapOutput) ToListenerMapOutput 

func (o ListenerMapOutput) ToListenerMapOutput() ListenerMapOutput

func (ListenerMapOutput) ToListenerMapOutputWithContext 

func (o ListenerMapOutput) ToListenerMapOutputWithContext(ctx context.Context) ListenerMapOutput

type ListenerOutput 

type ListenerOutput struct{ *pulumi.OutputState }

func (ListenerOutput) AcceleratorArn added in v5.4.0 

func (o ListenerOutput) AcceleratorArn() pulumi.StringOutput

The Amazon Resource Name (ARN) of your accelerator.

func (ListenerOutput) ClientAffinity added in v5.4.0 

func (o ListenerOutput) ClientAffinity() pulumi.StringPtrOutput

Direct all requests from a user to the same endpoint. Valid values are `NONE`, `SOURCE_IP`. Default: `NONE`. If `NONE`, Global Accelerator uses the "five-tuple" properties of source IP address, source port, destination IP address, destination port, and protocol to select the hash value. If `SOURCE_IP`, Global Accelerator uses the "two-tuple" properties of source (client) IP address and destination IP address to select the hash value.

func (ListenerOutput) ElementType 

func (ListenerOutput) ElementType() reflect.Type

func (ListenerOutput) PortRanges added in v5.4.0 

func (o ListenerOutput) PortRanges() ListenerPortRangeArrayOutput

The list of port ranges for the connections from clients to the accelerator. Fields documented below.

**port_range** supports the following attributes:

func (ListenerOutput) Protocol added in v5.4.0 

func (o ListenerOutput) Protocol() pulumi.StringOutput

The protocol for the connections from clients to the accelerator. Valid values are `TCP`, `UDP`.

func (ListenerOutput) ToListenerOutput 

func (o ListenerOutput) ToListenerOutput() ListenerOutput

func (ListenerOutput) ToListenerOutputWithContext 

func (o ListenerOutput) ToListenerOutputWithContext(ctx context.Context) ListenerOutput

type ListenerPortRange 

type ListenerPortRange struct {
	// The first port in the range of ports, inclusive.
	FromPort *int `pulumi:"fromPort"`
	// The last port in the range of ports, inclusive.
	ToPort *int `pulumi:"toPort"`
}

type ListenerPortRangeArgs 

type ListenerPortRangeArgs struct {
	// The first port in the range of ports, inclusive.
	FromPort pulumi.IntPtrInput `pulumi:"fromPort"`
	// The last port in the range of ports, inclusive.
	ToPort pulumi.IntPtrInput `pulumi:"toPort"`
}

func (ListenerPortRangeArgs) ElementType 

func (ListenerPortRangeArgs) ElementType() reflect.Type

func (ListenerPortRangeArgs) ToListenerPortRangeOutput 

func (i ListenerPortRangeArgs) ToListenerPortRangeOutput() ListenerPortRangeOutput

func (ListenerPortRangeArgs) ToListenerPortRangeOutputWithContext 

func (i ListenerPortRangeArgs) ToListenerPortRangeOutputWithContext(ctx context.Context) ListenerPortRangeOutput

type ListenerPortRangeArray 

type ListenerPortRangeArray []ListenerPortRangeInput

func (ListenerPortRangeArray) ElementType 

func (ListenerPortRangeArray) ElementType() reflect.Type

func (ListenerPortRangeArray) ToListenerPortRangeArrayOutput 

func (i ListenerPortRangeArray) ToListenerPortRangeArrayOutput() ListenerPortRangeArrayOutput

func (ListenerPortRangeArray) ToListenerPortRangeArrayOutputWithContext 

func (i ListenerPortRangeArray) ToListenerPortRangeArrayOutputWithContext(ctx context.Context) ListenerPortRangeArrayOutput

type ListenerPortRangeArrayInput 

type ListenerPortRangeArrayInput interface {
	pulumi.Input

	ToListenerPortRangeArrayOutput() ListenerPortRangeArrayOutput
	ToListenerPortRangeArrayOutputWithContext(context.Context) ListenerPortRangeArrayOutput
}

ListenerPortRangeArrayInput is an input type that accepts ListenerPortRangeArray and ListenerPortRangeArrayOutput values. You can construct a concrete instance of `ListenerPortRangeArrayInput` via: 

ListenerPortRangeArray{ ListenerPortRangeArgs{...} }

type ListenerPortRangeArrayOutput 

type ListenerPortRangeArrayOutput struct{ *pulumi.OutputState }

func (ListenerPortRangeArrayOutput) ElementType 

func (ListenerPortRangeArrayOutput) ElementType() reflect.Type

func (ListenerPortRangeArrayOutput) Index 

func (o ListenerPortRangeArrayOutput) Index(i pulumi.IntInput) ListenerPortRangeOutput

func (ListenerPortRangeArrayOutput) ToListenerPortRangeArrayOutput 

func (o ListenerPortRangeArrayOutput) ToListenerPortRangeArrayOutput() ListenerPortRangeArrayOutput

func (ListenerPortRangeArrayOutput) ToListenerPortRangeArrayOutputWithContext 

func (o ListenerPortRangeArrayOutput) ToListenerPortRangeArrayOutputWithContext(ctx context.Context) ListenerPortRangeArrayOutput

type ListenerPortRangeInput 

type ListenerPortRangeInput interface {
	pulumi.Input

	ToListenerPortRangeOutput() ListenerPortRangeOutput
	ToListenerPortRangeOutputWithContext(context.Context) ListenerPortRangeOutput
}

ListenerPortRangeInput is an input type that accepts ListenerPortRangeArgs and ListenerPortRangeOutput values. You can construct a concrete instance of `ListenerPortRangeInput` via: 

ListenerPortRangeArgs{...}

type ListenerPortRangeOutput 

type ListenerPortRangeOutput struct{ *pulumi.OutputState }

func (ListenerPortRangeOutput) ElementType 

func (ListenerPortRangeOutput) ElementType() reflect.Type

func (ListenerPortRangeOutput) FromPort 

func (o ListenerPortRangeOutput) FromPort() pulumi.IntPtrOutput

The first port in the range of ports, inclusive.

func (ListenerPortRangeOutput) ToListenerPortRangeOutput 

func (o ListenerPortRangeOutput) ToListenerPortRangeOutput() ListenerPortRangeOutput

func (ListenerPortRangeOutput) ToListenerPortRangeOutputWithContext 

func (o ListenerPortRangeOutput) ToListenerPortRangeOutputWithContext(ctx context.Context) ListenerPortRangeOutput

func (ListenerPortRangeOutput) ToPort 

func (o ListenerPortRangeOutput) ToPort() pulumi.IntPtrOutput

The last port in the range of ports, inclusive.

type ListenerState 

type ListenerState struct {
	// The Amazon Resource Name (ARN) of your accelerator.
	AcceleratorArn pulumi.StringPtrInput
	// Direct all requests from a user to the same endpoint. Valid values are `NONE`, `SOURCE_IP`. Default: `NONE`. If `NONE`, Global Accelerator uses the "five-tuple" properties of source IP address, source port, destination IP address, destination port, and protocol to select the hash value. If `SOURCE_IP`, Global Accelerator uses the "two-tuple" properties of source (client) IP address and destination IP address to select the hash value.
	ClientAffinity pulumi.StringPtrInput
	// The list of port ranges for the connections from clients to the accelerator. Fields documented below.
	//
	// **port_range** supports the following attributes:
	PortRanges ListenerPortRangeArrayInput
	// The protocol for the connections from clients to the accelerator. Valid values are `TCP`, `UDP`.
	Protocol pulumi.StringPtrInput
}

func (ListenerState) ElementType 

func (ListenerState) ElementType() reflect.Type

type LookupAcceleratorArgs 

type LookupAcceleratorArgs struct {
	// Full ARN of the Global Accelerator.
	Arn *string `pulumi:"arn"`
	// Unique name of the Global Accelerator.
	//
	// > **NOTE:** When both `arn` and `name` are specified, `arn` takes precedence.
	Name *string           `pulumi:"name"`
	Tags map[string]string `pulumi:"tags"`
}

A collection of arguments for invoking getAccelerator.

type LookupAcceleratorOutputArgs 

type LookupAcceleratorOutputArgs struct {
	// Full ARN of the Global Accelerator.
	Arn pulumi.StringPtrInput `pulumi:"arn"`
	// Unique name of the Global Accelerator.
	//
	// > **NOTE:** When both `arn` and `name` are specified, `arn` takes precedence.
	Name pulumi.StringPtrInput `pulumi:"name"`
	Tags pulumi.StringMapInput `pulumi:"tags"`
}

A collection of arguments for invoking getAccelerator.

func (LookupAcceleratorOutputArgs) ElementType 

func (LookupAcceleratorOutputArgs) ElementType() reflect.Type

type LookupAcceleratorResult 

type LookupAcceleratorResult struct {
	Arn          string                    `pulumi:"arn"`
	Attributes   []GetAcceleratorAttribute `pulumi:"attributes"`
	DnsName      string                    `pulumi:"dnsName"`
	Enabled      bool                      `pulumi:"enabled"`
	HostedZoneId string                    `pulumi:"hostedZoneId"`
	// The provider-assigned unique ID for this managed resource.
	Id            string                `pulumi:"id"`
	IpAddressType string                `pulumi:"ipAddressType"`
	IpSets        []GetAcceleratorIpSet `pulumi:"ipSets"`
	Name          string                `pulumi:"name"`
	Tags          map[string]string     `pulumi:"tags"`
}

A collection of values returned by getAccelerator.

func LookupAccelerator 

func LookupAccelerator(ctx *pulumi.Context, args *LookupAcceleratorArgs, opts ...pulumi.InvokeOption) (*LookupAcceleratorResult, error)

Provides information about a Global Accelerator accelerator.

## Example Usage

```go package main

import ( 

"github.com/pulumi/pulumi-aws/sdk/v5/go/aws/globalaccelerator"
"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 {
		cfg := config.New(ctx, "")
		acceleratorArn := ""
		if param := cfg.Get("acceleratorArn"); param != "" {
			acceleratorArn = param
		}
		acceleratorName := ""
		if param := cfg.Get("acceleratorName"); param != "" {
			acceleratorName = param
		}
		_, err := globalaccelerator.LookupAccelerator(ctx, &globalaccelerator.LookupAcceleratorArgs{
			Arn:  pulumi.StringRef(acceleratorArn),
			Name: pulumi.StringRef(acceleratorName),
		}, nil)
		if err != nil {
			return err
		}
		return nil
	})
}

```

type LookupAcceleratorResultOutput 

type LookupAcceleratorResultOutput struct{ *pulumi.OutputState }

A collection of values returned by getAccelerator.

func LookupAcceleratorOutput 

func LookupAcceleratorOutput(ctx *pulumi.Context, args LookupAcceleratorOutputArgs, opts ...pulumi.InvokeOption) LookupAcceleratorResultOutput

func (LookupAcceleratorResultOutput) Arn 

func (o LookupAcceleratorResultOutput) Arn() pulumi.StringOutput

func (LookupAcceleratorResultOutput) Attributes 

func (o LookupAcceleratorResultOutput) Attributes() GetAcceleratorAttributeArrayOutput

func (LookupAcceleratorResultOutput) DnsName 

func (o LookupAcceleratorResultOutput) DnsName() pulumi.StringOutput

func (LookupAcceleratorResultOutput) ElementType 

func (LookupAcceleratorResultOutput) ElementType() reflect.Type

func (LookupAcceleratorResultOutput) Enabled 

func (o LookupAcceleratorResultOutput) Enabled() pulumi.BoolOutput

func (LookupAcceleratorResultOutput) HostedZoneId 

func (o LookupAcceleratorResultOutput) HostedZoneId() pulumi.StringOutput

func (LookupAcceleratorResultOutput) Id 

func (o LookupAcceleratorResultOutput) Id() pulumi.StringOutput

The provider-assigned unique ID for this managed resource.

func (LookupAcceleratorResultOutput) IpAddressType 

func (o LookupAcceleratorResultOutput) IpAddressType() pulumi.StringOutput

func (LookupAcceleratorResultOutput) IpSets 

func (o LookupAcceleratorResultOutput) IpSets() GetAcceleratorIpSetArrayOutput

func (LookupAcceleratorResultOutput) Name 

func (o LookupAcceleratorResultOutput) Name() pulumi.StringOutput

func (LookupAcceleratorResultOutput) Tags 

func (o LookupAcceleratorResultOutput) Tags() pulumi.StringMapOutput

func (LookupAcceleratorResultOutput) ToLookupAcceleratorResultOutput 

func (o LookupAcceleratorResultOutput) ToLookupAcceleratorResultOutput() LookupAcceleratorResultOutput

func (LookupAcceleratorResultOutput) ToLookupAcceleratorResultOutputWithContext 

func (o LookupAcceleratorResultOutput) ToLookupAcceleratorResultOutputWithContext(ctx context.Context) LookupAcceleratorResultOutput

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.