vpc

package
v6.59.1 Latest Latest
Warning

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

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

Documentation

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

This section is empty.

Types

type EndpointPrivateDns added in v6.38.0 

type EndpointPrivateDns struct {
	pulumi.CustomResourceState

	// Indicates whether a private hosted zone is associated with the VPC. Only applicable for `Interface` endpoints.
	PrivateDnsEnabled pulumi.BoolOutput `pulumi:"privateDnsEnabled"`
	// VPC endpoint identifier.
	VpcEndpointId pulumi.StringOutput `pulumi:"vpcEndpointId"`
}

Resource for enabling private DNS on an AWS VPC (Virtual Private Cloud) Endpoint.

> When using this resource, the `privateDnsEnabled` argument should be omitted on the parent `ec2.VpcEndpoint` resource. Setting the value both places can lead to unintended behavior and persistent differences.

## Example Usage

### Basic Usage

```go package main

import ( 

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

) 

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := vpc.NewEndpointPrivateDns(ctx, "example", &vpc.EndpointPrivateDnsArgs{
			VpcEndpointId:     pulumi.Any(exampleAwsVpcEndpoint.Id),
			PrivateDnsEnabled: pulumi.Bool(true),
		})
		if err != nil {
			return err
		}
		return nil
	})
}

```

## Import

Using `pulumi import`, import a VPC (Virtual Private Cloud) Endpoint Private DNS using the `vpc_endpoint_id`. For example:

```sh $ pulumi import aws:vpc/endpointPrivateDns:EndpointPrivateDns example vpce-abcd-1234 ```

func GetEndpointPrivateDns added in v6.38.0 

func GetEndpointPrivateDns(ctx *pulumi.Context,
	name string, id pulumi.IDInput, state *EndpointPrivateDnsState, opts ...pulumi.ResourceOption) (*EndpointPrivateDns, error)

GetEndpointPrivateDns gets an existing EndpointPrivateDns 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 NewEndpointPrivateDns added in v6.38.0 

func NewEndpointPrivateDns(ctx *pulumi.Context,
	name string, args *EndpointPrivateDnsArgs, opts ...pulumi.ResourceOption) (*EndpointPrivateDns, error)

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

func (*EndpointPrivateDns) ElementType added in v6.38.0 

func (*EndpointPrivateDns) ElementType() reflect.Type

func (*EndpointPrivateDns) ToEndpointPrivateDnsOutput added in v6.38.0 

func (i *EndpointPrivateDns) ToEndpointPrivateDnsOutput() EndpointPrivateDnsOutput

func (*EndpointPrivateDns) ToEndpointPrivateDnsOutputWithContext added in v6.38.0 

func (i *EndpointPrivateDns) ToEndpointPrivateDnsOutputWithContext(ctx context.Context) EndpointPrivateDnsOutput

type EndpointPrivateDnsArgs added in v6.38.0 

type EndpointPrivateDnsArgs struct {
	// Indicates whether a private hosted zone is associated with the VPC. Only applicable for `Interface` endpoints.
	PrivateDnsEnabled pulumi.BoolInput
	// VPC endpoint identifier.
	VpcEndpointId pulumi.StringInput
}

The set of arguments for constructing a EndpointPrivateDns resource.

func (EndpointPrivateDnsArgs) ElementType added in v6.38.0 

func (EndpointPrivateDnsArgs) ElementType() reflect.Type

type EndpointPrivateDnsArray added in v6.38.0 

type EndpointPrivateDnsArray []EndpointPrivateDnsInput

func (EndpointPrivateDnsArray) ElementType added in v6.38.0 

func (EndpointPrivateDnsArray) ElementType() reflect.Type

func (EndpointPrivateDnsArray) ToEndpointPrivateDnsArrayOutput added in v6.38.0 

func (i EndpointPrivateDnsArray) ToEndpointPrivateDnsArrayOutput() EndpointPrivateDnsArrayOutput

func (EndpointPrivateDnsArray) ToEndpointPrivateDnsArrayOutputWithContext added in v6.38.0 

func (i EndpointPrivateDnsArray) ToEndpointPrivateDnsArrayOutputWithContext(ctx context.Context) EndpointPrivateDnsArrayOutput

type EndpointPrivateDnsArrayInput added in v6.38.0 

type EndpointPrivateDnsArrayInput interface {
	pulumi.Input

	ToEndpointPrivateDnsArrayOutput() EndpointPrivateDnsArrayOutput
	ToEndpointPrivateDnsArrayOutputWithContext(context.Context) EndpointPrivateDnsArrayOutput
}

EndpointPrivateDnsArrayInput is an input type that accepts EndpointPrivateDnsArray and EndpointPrivateDnsArrayOutput values. You can construct a concrete instance of `EndpointPrivateDnsArrayInput` via: 

EndpointPrivateDnsArray{ EndpointPrivateDnsArgs{...} }

type EndpointPrivateDnsArrayOutput added in v6.38.0 

type EndpointPrivateDnsArrayOutput struct{ *pulumi.OutputState }

func (EndpointPrivateDnsArrayOutput) ElementType added in v6.38.0 

func (EndpointPrivateDnsArrayOutput) ElementType() reflect.Type

func (EndpointPrivateDnsArrayOutput) Index added in v6.38.0 

func (o EndpointPrivateDnsArrayOutput) Index(i pulumi.IntInput) EndpointPrivateDnsOutput

func (EndpointPrivateDnsArrayOutput) ToEndpointPrivateDnsArrayOutput added in v6.38.0 

func (o EndpointPrivateDnsArrayOutput) ToEndpointPrivateDnsArrayOutput() EndpointPrivateDnsArrayOutput

func (EndpointPrivateDnsArrayOutput) ToEndpointPrivateDnsArrayOutputWithContext added in v6.38.0 

func (o EndpointPrivateDnsArrayOutput) ToEndpointPrivateDnsArrayOutputWithContext(ctx context.Context) EndpointPrivateDnsArrayOutput

type EndpointPrivateDnsInput added in v6.38.0 

type EndpointPrivateDnsInput interface {
	pulumi.Input

	ToEndpointPrivateDnsOutput() EndpointPrivateDnsOutput
	ToEndpointPrivateDnsOutputWithContext(ctx context.Context) EndpointPrivateDnsOutput
}

type EndpointPrivateDnsMap added in v6.38.0 

type EndpointPrivateDnsMap map[string]EndpointPrivateDnsInput

func (EndpointPrivateDnsMap) ElementType added in v6.38.0 

func (EndpointPrivateDnsMap) ElementType() reflect.Type

func (EndpointPrivateDnsMap) ToEndpointPrivateDnsMapOutput added in v6.38.0 

func (i EndpointPrivateDnsMap) ToEndpointPrivateDnsMapOutput() EndpointPrivateDnsMapOutput

func (EndpointPrivateDnsMap) ToEndpointPrivateDnsMapOutputWithContext added in v6.38.0 

func (i EndpointPrivateDnsMap) ToEndpointPrivateDnsMapOutputWithContext(ctx context.Context) EndpointPrivateDnsMapOutput

type EndpointPrivateDnsMapInput added in v6.38.0 

type EndpointPrivateDnsMapInput interface {
	pulumi.Input

	ToEndpointPrivateDnsMapOutput() EndpointPrivateDnsMapOutput
	ToEndpointPrivateDnsMapOutputWithContext(context.Context) EndpointPrivateDnsMapOutput
}

EndpointPrivateDnsMapInput is an input type that accepts EndpointPrivateDnsMap and EndpointPrivateDnsMapOutput values. You can construct a concrete instance of `EndpointPrivateDnsMapInput` via: 

EndpointPrivateDnsMap{ "key": EndpointPrivateDnsArgs{...} }

type EndpointPrivateDnsMapOutput added in v6.38.0 

type EndpointPrivateDnsMapOutput struct{ *pulumi.OutputState }

func (EndpointPrivateDnsMapOutput) ElementType added in v6.38.0 

func (EndpointPrivateDnsMapOutput) ElementType() reflect.Type

func (EndpointPrivateDnsMapOutput) MapIndex added in v6.38.0 

func (o EndpointPrivateDnsMapOutput) MapIndex(k pulumi.StringInput) EndpointPrivateDnsOutput

func (EndpointPrivateDnsMapOutput) ToEndpointPrivateDnsMapOutput added in v6.38.0 

func (o EndpointPrivateDnsMapOutput) ToEndpointPrivateDnsMapOutput() EndpointPrivateDnsMapOutput

func (EndpointPrivateDnsMapOutput) ToEndpointPrivateDnsMapOutputWithContext added in v6.38.0 

func (o EndpointPrivateDnsMapOutput) ToEndpointPrivateDnsMapOutputWithContext(ctx context.Context) EndpointPrivateDnsMapOutput

type EndpointPrivateDnsOutput added in v6.38.0 

type EndpointPrivateDnsOutput struct{ *pulumi.OutputState }

func (EndpointPrivateDnsOutput) ElementType added in v6.38.0 

func (EndpointPrivateDnsOutput) ElementType() reflect.Type

func (EndpointPrivateDnsOutput) PrivateDnsEnabled added in v6.38.0 

func (o EndpointPrivateDnsOutput) PrivateDnsEnabled() pulumi.BoolOutput

Indicates whether a private hosted zone is associated with the VPC. Only applicable for `Interface` endpoints.

func (EndpointPrivateDnsOutput) ToEndpointPrivateDnsOutput added in v6.38.0 

func (o EndpointPrivateDnsOutput) ToEndpointPrivateDnsOutput() EndpointPrivateDnsOutput

func (EndpointPrivateDnsOutput) ToEndpointPrivateDnsOutputWithContext added in v6.38.0 

func (o EndpointPrivateDnsOutput) ToEndpointPrivateDnsOutputWithContext(ctx context.Context) EndpointPrivateDnsOutput

func (EndpointPrivateDnsOutput) VpcEndpointId added in v6.38.0 

func (o EndpointPrivateDnsOutput) VpcEndpointId() pulumi.StringOutput

VPC endpoint identifier.

type EndpointPrivateDnsState added in v6.38.0 

type EndpointPrivateDnsState struct {
	// Indicates whether a private hosted zone is associated with the VPC. Only applicable for `Interface` endpoints.
	PrivateDnsEnabled pulumi.BoolPtrInput
	// VPC endpoint identifier.
	VpcEndpointId pulumi.StringPtrInput
}

func (EndpointPrivateDnsState) ElementType added in v6.38.0 

func (EndpointPrivateDnsState) ElementType() reflect.Type

type EndpointServicePrivateDnsVerification added in v6.38.0 

type EndpointServicePrivateDnsVerification struct {
	pulumi.CustomResourceState

	// ID of the endpoint service.
	//
	// The following arguments are optional:
	ServiceId pulumi.StringOutput                                    `pulumi:"serviceId"`
	Timeouts  EndpointServicePrivateDnsVerificationTimeoutsPtrOutput `pulumi:"timeouts"`
	// Whether to wait until the endpoint service returns a `Verified` status for the configured private DNS name.
	WaitForVerification pulumi.BoolPtrOutput `pulumi:"waitForVerification"`
}

Resource for managing an AWS VPC (Virtual Private Cloud) Endpoint Service Private DNS Verification. This resource begins the verification process by calling the [`StartVpcEndpointServicePrivateDnsVerification`](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_StartVpcEndpointServicePrivateDnsVerification.html) API. The service provider should add a record to the DNS server _before_ creating this resource.

For additional details, refer to the AWS documentation on [managing VPC endpoint service DNS names](https://docs.aws.amazon.com/vpc/latest/privatelink/manage-dns-names.html).

> Destruction of this resource will not stop the verification process, only remove the resource from state.

## Example Usage

### Basic Usage

```go package main

import ( 

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

) 

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := vpc.NewEndpointServicePrivateDnsVerification(ctx, "example", &vpc.EndpointServicePrivateDnsVerificationArgs{
			ServiceId: pulumi.Any(exampleAwsVpcEndpointService.Id),
		})
		if err != nil {
			return err
		}
		return nil
	})
}

```

## Import

You cannot import this resource.

func GetEndpointServicePrivateDnsVerification added in v6.38.0 

func GetEndpointServicePrivateDnsVerification(ctx *pulumi.Context,
	name string, id pulumi.IDInput, state *EndpointServicePrivateDnsVerificationState, opts ...pulumi.ResourceOption) (*EndpointServicePrivateDnsVerification, error)

GetEndpointServicePrivateDnsVerification gets an existing EndpointServicePrivateDnsVerification 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 NewEndpointServicePrivateDnsVerification added in v6.38.0 

func NewEndpointServicePrivateDnsVerification(ctx *pulumi.Context,
	name string, args *EndpointServicePrivateDnsVerificationArgs, opts ...pulumi.ResourceOption) (*EndpointServicePrivateDnsVerification, error)

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

func (*EndpointServicePrivateDnsVerification) ElementType added in v6.38.0 

func (*EndpointServicePrivateDnsVerification) ElementType() reflect.Type

func (*EndpointServicePrivateDnsVerification) ToEndpointServicePrivateDnsVerificationOutput added in v6.38.0 

func (i *EndpointServicePrivateDnsVerification) ToEndpointServicePrivateDnsVerificationOutput() EndpointServicePrivateDnsVerificationOutput

func (*EndpointServicePrivateDnsVerification) ToEndpointServicePrivateDnsVerificationOutputWithContext added in v6.38.0 

func (i *EndpointServicePrivateDnsVerification) ToEndpointServicePrivateDnsVerificationOutputWithContext(ctx context.Context) EndpointServicePrivateDnsVerificationOutput

type EndpointServicePrivateDnsVerificationArgs added in v6.38.0 

type EndpointServicePrivateDnsVerificationArgs struct {
	// ID of the endpoint service.
	//
	// The following arguments are optional:
	ServiceId pulumi.StringInput
	Timeouts  EndpointServicePrivateDnsVerificationTimeoutsPtrInput
	// Whether to wait until the endpoint service returns a `Verified` status for the configured private DNS name.
	WaitForVerification pulumi.BoolPtrInput
}

The set of arguments for constructing a EndpointServicePrivateDnsVerification resource.

func (EndpointServicePrivateDnsVerificationArgs) ElementType added in v6.38.0 

func (EndpointServicePrivateDnsVerificationArgs) ElementType() reflect.Type

type EndpointServicePrivateDnsVerificationArray added in v6.38.0 

type EndpointServicePrivateDnsVerificationArray []EndpointServicePrivateDnsVerificationInput

func (EndpointServicePrivateDnsVerificationArray) ElementType added in v6.38.0 

func (EndpointServicePrivateDnsVerificationArray) ElementType() reflect.Type

func (EndpointServicePrivateDnsVerificationArray) ToEndpointServicePrivateDnsVerificationArrayOutput added in v6.38.0 

func (i EndpointServicePrivateDnsVerificationArray) ToEndpointServicePrivateDnsVerificationArrayOutput() EndpointServicePrivateDnsVerificationArrayOutput

func (EndpointServicePrivateDnsVerificationArray) ToEndpointServicePrivateDnsVerificationArrayOutputWithContext added in v6.38.0 

func (i EndpointServicePrivateDnsVerificationArray) ToEndpointServicePrivateDnsVerificationArrayOutputWithContext(ctx context.Context) EndpointServicePrivateDnsVerificationArrayOutput

type EndpointServicePrivateDnsVerificationArrayInput added in v6.38.0 

type EndpointServicePrivateDnsVerificationArrayInput interface {
	pulumi.Input

	ToEndpointServicePrivateDnsVerificationArrayOutput() EndpointServicePrivateDnsVerificationArrayOutput
	ToEndpointServicePrivateDnsVerificationArrayOutputWithContext(context.Context) EndpointServicePrivateDnsVerificationArrayOutput
}

EndpointServicePrivateDnsVerificationArrayInput is an input type that accepts EndpointServicePrivateDnsVerificationArray and EndpointServicePrivateDnsVerificationArrayOutput values. You can construct a concrete instance of `EndpointServicePrivateDnsVerificationArrayInput` via: 

EndpointServicePrivateDnsVerificationArray{ EndpointServicePrivateDnsVerificationArgs{...} }

type EndpointServicePrivateDnsVerificationArrayOutput added in v6.38.0 

type EndpointServicePrivateDnsVerificationArrayOutput struct{ *pulumi.OutputState }

func (EndpointServicePrivateDnsVerificationArrayOutput) ElementType added in v6.38.0 

func (EndpointServicePrivateDnsVerificationArrayOutput) ElementType() reflect.Type

func (EndpointServicePrivateDnsVerificationArrayOutput) Index added in v6.38.0 

func (o EndpointServicePrivateDnsVerificationArrayOutput) Index(i pulumi.IntInput) EndpointServicePrivateDnsVerificationOutput

func (EndpointServicePrivateDnsVerificationArrayOutput) ToEndpointServicePrivateDnsVerificationArrayOutput added in v6.38.0 

func (o EndpointServicePrivateDnsVerificationArrayOutput) ToEndpointServicePrivateDnsVerificationArrayOutput() EndpointServicePrivateDnsVerificationArrayOutput

func (EndpointServicePrivateDnsVerificationArrayOutput) ToEndpointServicePrivateDnsVerificationArrayOutputWithContext added in v6.38.0 

func (o EndpointServicePrivateDnsVerificationArrayOutput) ToEndpointServicePrivateDnsVerificationArrayOutputWithContext(ctx context.Context) EndpointServicePrivateDnsVerificationArrayOutput

type EndpointServicePrivateDnsVerificationInput added in v6.38.0 

type EndpointServicePrivateDnsVerificationInput interface {
	pulumi.Input

	ToEndpointServicePrivateDnsVerificationOutput() EndpointServicePrivateDnsVerificationOutput
	ToEndpointServicePrivateDnsVerificationOutputWithContext(ctx context.Context) EndpointServicePrivateDnsVerificationOutput
}

type EndpointServicePrivateDnsVerificationMap added in v6.38.0 

type EndpointServicePrivateDnsVerificationMap map[string]EndpointServicePrivateDnsVerificationInput

func (EndpointServicePrivateDnsVerificationMap) ElementType added in v6.38.0 

func (EndpointServicePrivateDnsVerificationMap) ElementType() reflect.Type

func (EndpointServicePrivateDnsVerificationMap) ToEndpointServicePrivateDnsVerificationMapOutput added in v6.38.0 

func (i EndpointServicePrivateDnsVerificationMap) ToEndpointServicePrivateDnsVerificationMapOutput() EndpointServicePrivateDnsVerificationMapOutput

func (EndpointServicePrivateDnsVerificationMap) ToEndpointServicePrivateDnsVerificationMapOutputWithContext added in v6.38.0 

func (i EndpointServicePrivateDnsVerificationMap) ToEndpointServicePrivateDnsVerificationMapOutputWithContext(ctx context.Context) EndpointServicePrivateDnsVerificationMapOutput

type EndpointServicePrivateDnsVerificationMapInput added in v6.38.0 

type EndpointServicePrivateDnsVerificationMapInput interface {
	pulumi.Input

	ToEndpointServicePrivateDnsVerificationMapOutput() EndpointServicePrivateDnsVerificationMapOutput
	ToEndpointServicePrivateDnsVerificationMapOutputWithContext(context.Context) EndpointServicePrivateDnsVerificationMapOutput
}

EndpointServicePrivateDnsVerificationMapInput is an input type that accepts EndpointServicePrivateDnsVerificationMap and EndpointServicePrivateDnsVerificationMapOutput values. You can construct a concrete instance of `EndpointServicePrivateDnsVerificationMapInput` via: 

EndpointServicePrivateDnsVerificationMap{ "key": EndpointServicePrivateDnsVerificationArgs{...} }

type EndpointServicePrivateDnsVerificationMapOutput added in v6.38.0 

type EndpointServicePrivateDnsVerificationMapOutput struct{ *pulumi.OutputState }

func (EndpointServicePrivateDnsVerificationMapOutput) ElementType added in v6.38.0 

func (EndpointServicePrivateDnsVerificationMapOutput) ElementType() reflect.Type

func (EndpointServicePrivateDnsVerificationMapOutput) MapIndex added in v6.38.0 

func (o EndpointServicePrivateDnsVerificationMapOutput) MapIndex(k pulumi.StringInput) EndpointServicePrivateDnsVerificationOutput

func (EndpointServicePrivateDnsVerificationMapOutput) ToEndpointServicePrivateDnsVerificationMapOutput added in v6.38.0 

func (o EndpointServicePrivateDnsVerificationMapOutput) ToEndpointServicePrivateDnsVerificationMapOutput() EndpointServicePrivateDnsVerificationMapOutput

func (EndpointServicePrivateDnsVerificationMapOutput) ToEndpointServicePrivateDnsVerificationMapOutputWithContext added in v6.38.0 

func (o EndpointServicePrivateDnsVerificationMapOutput) ToEndpointServicePrivateDnsVerificationMapOutputWithContext(ctx context.Context) EndpointServicePrivateDnsVerificationMapOutput

type EndpointServicePrivateDnsVerificationOutput added in v6.38.0 

type EndpointServicePrivateDnsVerificationOutput struct{ *pulumi.OutputState }

func (EndpointServicePrivateDnsVerificationOutput) ElementType added in v6.38.0 

func (EndpointServicePrivateDnsVerificationOutput) ElementType() reflect.Type

func (EndpointServicePrivateDnsVerificationOutput) ServiceId added in v6.38.0 

func (o EndpointServicePrivateDnsVerificationOutput) ServiceId() pulumi.StringOutput

ID of the endpoint service.

The following arguments are optional:

func (EndpointServicePrivateDnsVerificationOutput) Timeouts added in v6.38.0 

func (o EndpointServicePrivateDnsVerificationOutput) Timeouts() EndpointServicePrivateDnsVerificationTimeoutsPtrOutput

func (EndpointServicePrivateDnsVerificationOutput) ToEndpointServicePrivateDnsVerificationOutput added in v6.38.0 

func (o EndpointServicePrivateDnsVerificationOutput) ToEndpointServicePrivateDnsVerificationOutput() EndpointServicePrivateDnsVerificationOutput

func (EndpointServicePrivateDnsVerificationOutput) ToEndpointServicePrivateDnsVerificationOutputWithContext added in v6.38.0 

func (o EndpointServicePrivateDnsVerificationOutput) ToEndpointServicePrivateDnsVerificationOutputWithContext(ctx context.Context) EndpointServicePrivateDnsVerificationOutput

func (EndpointServicePrivateDnsVerificationOutput) WaitForVerification added in v6.38.0 

func (o EndpointServicePrivateDnsVerificationOutput) WaitForVerification() pulumi.BoolPtrOutput

Whether to wait until the endpoint service returns a `Verified` status for the configured private DNS name.

type EndpointServicePrivateDnsVerificationState added in v6.38.0 

type EndpointServicePrivateDnsVerificationState struct {
	// ID of the endpoint service.
	//
	// The following arguments are optional:
	ServiceId pulumi.StringPtrInput
	Timeouts  EndpointServicePrivateDnsVerificationTimeoutsPtrInput
	// Whether to wait until the endpoint service returns a `Verified` status for the configured private DNS name.
	WaitForVerification pulumi.BoolPtrInput
}

func (EndpointServicePrivateDnsVerificationState) ElementType added in v6.38.0 

func (EndpointServicePrivateDnsVerificationState) ElementType() reflect.Type

type EndpointServicePrivateDnsVerificationTimeouts added in v6.38.0 

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

type EndpointServicePrivateDnsVerificationTimeoutsArgs added in v6.38.0 

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

func (EndpointServicePrivateDnsVerificationTimeoutsArgs) ElementType added in v6.38.0 

func (EndpointServicePrivateDnsVerificationTimeoutsArgs) ElementType() reflect.Type

func (EndpointServicePrivateDnsVerificationTimeoutsArgs) ToEndpointServicePrivateDnsVerificationTimeoutsOutput added in v6.38.0 

func (i EndpointServicePrivateDnsVerificationTimeoutsArgs) ToEndpointServicePrivateDnsVerificationTimeoutsOutput() EndpointServicePrivateDnsVerificationTimeoutsOutput

func (EndpointServicePrivateDnsVerificationTimeoutsArgs) ToEndpointServicePrivateDnsVerificationTimeoutsOutputWithContext added in v6.38.0 

func (i EndpointServicePrivateDnsVerificationTimeoutsArgs) ToEndpointServicePrivateDnsVerificationTimeoutsOutputWithContext(ctx context.Context) EndpointServicePrivateDnsVerificationTimeoutsOutput

func (EndpointServicePrivateDnsVerificationTimeoutsArgs) ToEndpointServicePrivateDnsVerificationTimeoutsPtrOutput added in v6.38.0 

func (i EndpointServicePrivateDnsVerificationTimeoutsArgs) ToEndpointServicePrivateDnsVerificationTimeoutsPtrOutput() EndpointServicePrivateDnsVerificationTimeoutsPtrOutput

func (EndpointServicePrivateDnsVerificationTimeoutsArgs) ToEndpointServicePrivateDnsVerificationTimeoutsPtrOutputWithContext added in v6.38.0 

func (i EndpointServicePrivateDnsVerificationTimeoutsArgs) ToEndpointServicePrivateDnsVerificationTimeoutsPtrOutputWithContext(ctx context.Context) EndpointServicePrivateDnsVerificationTimeoutsPtrOutput

type EndpointServicePrivateDnsVerificationTimeoutsInput added in v6.38.0 

type EndpointServicePrivateDnsVerificationTimeoutsInput interface {
	pulumi.Input

	ToEndpointServicePrivateDnsVerificationTimeoutsOutput() EndpointServicePrivateDnsVerificationTimeoutsOutput
	ToEndpointServicePrivateDnsVerificationTimeoutsOutputWithContext(context.Context) EndpointServicePrivateDnsVerificationTimeoutsOutput
}

EndpointServicePrivateDnsVerificationTimeoutsInput is an input type that accepts EndpointServicePrivateDnsVerificationTimeoutsArgs and EndpointServicePrivateDnsVerificationTimeoutsOutput values. You can construct a concrete instance of `EndpointServicePrivateDnsVerificationTimeoutsInput` via: 

EndpointServicePrivateDnsVerificationTimeoutsArgs{...}

type EndpointServicePrivateDnsVerificationTimeoutsOutput added in v6.38.0 

type EndpointServicePrivateDnsVerificationTimeoutsOutput struct{ *pulumi.OutputState }

func (EndpointServicePrivateDnsVerificationTimeoutsOutput) Create added in v6.38.0 

func (o EndpointServicePrivateDnsVerificationTimeoutsOutput) Create() pulumi.StringPtrOutput

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

func (EndpointServicePrivateDnsVerificationTimeoutsOutput) ElementType added in v6.38.0 

func (EndpointServicePrivateDnsVerificationTimeoutsOutput) ElementType() reflect.Type

func (EndpointServicePrivateDnsVerificationTimeoutsOutput) ToEndpointServicePrivateDnsVerificationTimeoutsOutput added in v6.38.0 

func (o EndpointServicePrivateDnsVerificationTimeoutsOutput) ToEndpointServicePrivateDnsVerificationTimeoutsOutput() EndpointServicePrivateDnsVerificationTimeoutsOutput

func (EndpointServicePrivateDnsVerificationTimeoutsOutput) ToEndpointServicePrivateDnsVerificationTimeoutsOutputWithContext added in v6.38.0 

func (o EndpointServicePrivateDnsVerificationTimeoutsOutput) ToEndpointServicePrivateDnsVerificationTimeoutsOutputWithContext(ctx context.Context) EndpointServicePrivateDnsVerificationTimeoutsOutput

func (EndpointServicePrivateDnsVerificationTimeoutsOutput) ToEndpointServicePrivateDnsVerificationTimeoutsPtrOutput added in v6.38.0 

func (o EndpointServicePrivateDnsVerificationTimeoutsOutput) ToEndpointServicePrivateDnsVerificationTimeoutsPtrOutput() EndpointServicePrivateDnsVerificationTimeoutsPtrOutput

func (EndpointServicePrivateDnsVerificationTimeoutsOutput) ToEndpointServicePrivateDnsVerificationTimeoutsPtrOutputWithContext added in v6.38.0 

func (o EndpointServicePrivateDnsVerificationTimeoutsOutput) ToEndpointServicePrivateDnsVerificationTimeoutsPtrOutputWithContext(ctx context.Context) EndpointServicePrivateDnsVerificationTimeoutsPtrOutput

type EndpointServicePrivateDnsVerificationTimeoutsPtrInput added in v6.38.0 

type EndpointServicePrivateDnsVerificationTimeoutsPtrInput interface {
	pulumi.Input

	ToEndpointServicePrivateDnsVerificationTimeoutsPtrOutput() EndpointServicePrivateDnsVerificationTimeoutsPtrOutput
	ToEndpointServicePrivateDnsVerificationTimeoutsPtrOutputWithContext(context.Context) EndpointServicePrivateDnsVerificationTimeoutsPtrOutput
}

EndpointServicePrivateDnsVerificationTimeoutsPtrInput is an input type that accepts EndpointServicePrivateDnsVerificationTimeoutsArgs, EndpointServicePrivateDnsVerificationTimeoutsPtr and EndpointServicePrivateDnsVerificationTimeoutsPtrOutput values. You can construct a concrete instance of `EndpointServicePrivateDnsVerificationTimeoutsPtrInput` via: 

        EndpointServicePrivateDnsVerificationTimeoutsArgs{...}

or:

        nil

func EndpointServicePrivateDnsVerificationTimeoutsPtr added in v6.38.0 

func EndpointServicePrivateDnsVerificationTimeoutsPtr(v *EndpointServicePrivateDnsVerificationTimeoutsArgs) EndpointServicePrivateDnsVerificationTimeoutsPtrInput

type EndpointServicePrivateDnsVerificationTimeoutsPtrOutput added in v6.38.0 

type EndpointServicePrivateDnsVerificationTimeoutsPtrOutput struct{ *pulumi.OutputState }

func (EndpointServicePrivateDnsVerificationTimeoutsPtrOutput) Create added in v6.38.0 

func (o EndpointServicePrivateDnsVerificationTimeoutsPtrOutput) Create() pulumi.StringPtrOutput

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

func (EndpointServicePrivateDnsVerificationTimeoutsPtrOutput) Elem added in v6.38.0 

func (o EndpointServicePrivateDnsVerificationTimeoutsPtrOutput) Elem() EndpointServicePrivateDnsVerificationTimeoutsOutput

func (EndpointServicePrivateDnsVerificationTimeoutsPtrOutput) ElementType added in v6.38.0 

func (EndpointServicePrivateDnsVerificationTimeoutsPtrOutput) ElementType() reflect.Type

func (EndpointServicePrivateDnsVerificationTimeoutsPtrOutput) ToEndpointServicePrivateDnsVerificationTimeoutsPtrOutput added in v6.38.0 

func (o EndpointServicePrivateDnsVerificationTimeoutsPtrOutput) ToEndpointServicePrivateDnsVerificationTimeoutsPtrOutput() EndpointServicePrivateDnsVerificationTimeoutsPtrOutput

func (EndpointServicePrivateDnsVerificationTimeoutsPtrOutput) ToEndpointServicePrivateDnsVerificationTimeoutsPtrOutputWithContext added in v6.38.0 

func (o EndpointServicePrivateDnsVerificationTimeoutsPtrOutput) ToEndpointServicePrivateDnsVerificationTimeoutsPtrOutputWithContext(ctx context.Context) EndpointServicePrivateDnsVerificationTimeoutsPtrOutput

type GetSecurityGroupRuleArgs 

type GetSecurityGroupRuleArgs struct {
	// Configuration block(s) for filtering. Detailed below.
	Filters []GetSecurityGroupRuleFilter `pulumi:"filters"`
	// ID of the security group rule to select.
	SecurityGroupRuleId *string `pulumi:"securityGroupRuleId"`
}

A collection of arguments for invoking getSecurityGroupRule.

type GetSecurityGroupRuleFilter 

type GetSecurityGroupRuleFilter struct {
	// Name of the filter field. Valid values can be found in the EC2 [`DescribeSecurityGroupRules`](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeSecurityGroupRules.html) API Reference.
	Name string `pulumi:"name"`
	// Set of values that are accepted for the given filter field. Results will be selected if any given value matches.
	Values []string `pulumi:"values"`
}

type GetSecurityGroupRuleFilterArgs 

type GetSecurityGroupRuleFilterArgs struct {
	// Name of the filter field. Valid values can be found in the EC2 [`DescribeSecurityGroupRules`](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeSecurityGroupRules.html) API Reference.
	Name pulumi.StringInput `pulumi:"name"`
	// Set of values that are accepted for the given filter field. Results will be selected if any given value matches.
	Values pulumi.StringArrayInput `pulumi:"values"`
}

func (GetSecurityGroupRuleFilterArgs) ElementType 

func (GetSecurityGroupRuleFilterArgs) ElementType() reflect.Type

func (GetSecurityGroupRuleFilterArgs) ToGetSecurityGroupRuleFilterOutput 

func (i GetSecurityGroupRuleFilterArgs) ToGetSecurityGroupRuleFilterOutput() GetSecurityGroupRuleFilterOutput

func (GetSecurityGroupRuleFilterArgs) ToGetSecurityGroupRuleFilterOutputWithContext 

func (i GetSecurityGroupRuleFilterArgs) ToGetSecurityGroupRuleFilterOutputWithContext(ctx context.Context) GetSecurityGroupRuleFilterOutput

type GetSecurityGroupRuleFilterArray 

type GetSecurityGroupRuleFilterArray []GetSecurityGroupRuleFilterInput

func (GetSecurityGroupRuleFilterArray) ElementType 

func (GetSecurityGroupRuleFilterArray) ElementType() reflect.Type

func (GetSecurityGroupRuleFilterArray) ToGetSecurityGroupRuleFilterArrayOutput 

func (i GetSecurityGroupRuleFilterArray) ToGetSecurityGroupRuleFilterArrayOutput() GetSecurityGroupRuleFilterArrayOutput

func (GetSecurityGroupRuleFilterArray) ToGetSecurityGroupRuleFilterArrayOutputWithContext 

func (i GetSecurityGroupRuleFilterArray) ToGetSecurityGroupRuleFilterArrayOutputWithContext(ctx context.Context) GetSecurityGroupRuleFilterArrayOutput

type GetSecurityGroupRuleFilterArrayInput 

type GetSecurityGroupRuleFilterArrayInput interface {
	pulumi.Input

	ToGetSecurityGroupRuleFilterArrayOutput() GetSecurityGroupRuleFilterArrayOutput
	ToGetSecurityGroupRuleFilterArrayOutputWithContext(context.Context) GetSecurityGroupRuleFilterArrayOutput
}

GetSecurityGroupRuleFilterArrayInput is an input type that accepts GetSecurityGroupRuleFilterArray and GetSecurityGroupRuleFilterArrayOutput values. You can construct a concrete instance of `GetSecurityGroupRuleFilterArrayInput` via: 

GetSecurityGroupRuleFilterArray{ GetSecurityGroupRuleFilterArgs{...} }

type GetSecurityGroupRuleFilterArrayOutput 

type GetSecurityGroupRuleFilterArrayOutput struct{ *pulumi.OutputState }

func (GetSecurityGroupRuleFilterArrayOutput) ElementType 

func (GetSecurityGroupRuleFilterArrayOutput) ElementType() reflect.Type

func (GetSecurityGroupRuleFilterArrayOutput) Index 

func (o GetSecurityGroupRuleFilterArrayOutput) Index(i pulumi.IntInput) GetSecurityGroupRuleFilterOutput

func (GetSecurityGroupRuleFilterArrayOutput) ToGetSecurityGroupRuleFilterArrayOutput 

func (o GetSecurityGroupRuleFilterArrayOutput) ToGetSecurityGroupRuleFilterArrayOutput() GetSecurityGroupRuleFilterArrayOutput

func (GetSecurityGroupRuleFilterArrayOutput) ToGetSecurityGroupRuleFilterArrayOutputWithContext 

func (o GetSecurityGroupRuleFilterArrayOutput) ToGetSecurityGroupRuleFilterArrayOutputWithContext(ctx context.Context) GetSecurityGroupRuleFilterArrayOutput

type GetSecurityGroupRuleFilterInput 

type GetSecurityGroupRuleFilterInput interface {
	pulumi.Input

	ToGetSecurityGroupRuleFilterOutput() GetSecurityGroupRuleFilterOutput
	ToGetSecurityGroupRuleFilterOutputWithContext(context.Context) GetSecurityGroupRuleFilterOutput
}

GetSecurityGroupRuleFilterInput is an input type that accepts GetSecurityGroupRuleFilterArgs and GetSecurityGroupRuleFilterOutput values. You can construct a concrete instance of `GetSecurityGroupRuleFilterInput` via: 

GetSecurityGroupRuleFilterArgs{...}

type GetSecurityGroupRuleFilterOutput 

type GetSecurityGroupRuleFilterOutput struct{ *pulumi.OutputState }

func (GetSecurityGroupRuleFilterOutput) ElementType 

func (GetSecurityGroupRuleFilterOutput) ElementType() reflect.Type

func (GetSecurityGroupRuleFilterOutput) Name 

func (o GetSecurityGroupRuleFilterOutput) Name() pulumi.StringOutput

Name of the filter field. Valid values can be found in the EC2 [`DescribeSecurityGroupRules`](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeSecurityGroupRules.html) API Reference.

func (GetSecurityGroupRuleFilterOutput) ToGetSecurityGroupRuleFilterOutput 

func (o GetSecurityGroupRuleFilterOutput) ToGetSecurityGroupRuleFilterOutput() GetSecurityGroupRuleFilterOutput

func (GetSecurityGroupRuleFilterOutput) ToGetSecurityGroupRuleFilterOutputWithContext 

func (o GetSecurityGroupRuleFilterOutput) ToGetSecurityGroupRuleFilterOutputWithContext(ctx context.Context) GetSecurityGroupRuleFilterOutput

func (GetSecurityGroupRuleFilterOutput) Values 

func (o GetSecurityGroupRuleFilterOutput) Values() pulumi.StringArrayOutput

Set of values that are accepted for the given filter field. Results will be selected if any given value matches.

type GetSecurityGroupRuleOutputArgs 

type GetSecurityGroupRuleOutputArgs struct {
	// Configuration block(s) for filtering. Detailed below.
	Filters GetSecurityGroupRuleFilterArrayInput `pulumi:"filters"`
	// ID of the security group rule to select.
	SecurityGroupRuleId pulumi.StringPtrInput `pulumi:"securityGroupRuleId"`
}

A collection of arguments for invoking getSecurityGroupRule.

func (GetSecurityGroupRuleOutputArgs) ElementType 

func (GetSecurityGroupRuleOutputArgs) ElementType() reflect.Type

type GetSecurityGroupRuleResult 

type GetSecurityGroupRuleResult struct {
	// The Amazon Resource Name (ARN) of the security group rule.
	Arn string `pulumi:"arn"`
	// The destination IPv4 CIDR range.
	CidrIpv4 string `pulumi:"cidrIpv4"`
	// The destination IPv6 CIDR range.
	CidrIpv6 string `pulumi:"cidrIpv6"`
	// The security group rule description.
	Description string                       `pulumi:"description"`
	Filters     []GetSecurityGroupRuleFilter `pulumi:"filters"`
	// The start of port range for the TCP and UDP protocols, or an ICMP/ICMPv6 type.
	FromPort int    `pulumi:"fromPort"`
	Id       string `pulumi:"id"`
	// The IP protocol name or number. Use `-1` to specify all protocols.
	IpProtocol string `pulumi:"ipProtocol"`
	// Indicates whether the security group rule is an outbound rule.
	IsEgress bool `pulumi:"isEgress"`
	// The ID of the destination prefix list.
	PrefixListId string `pulumi:"prefixListId"`
	// The destination security group that is referenced in the rule.
	ReferencedSecurityGroupId string `pulumi:"referencedSecurityGroupId"`
	// The ID of the security group.
	SecurityGroupId     string `pulumi:"securityGroupId"`
	SecurityGroupRuleId string `pulumi:"securityGroupRuleId"`
	// A map of tags assigned to the resource.
	Tags map[string]string `pulumi:"tags"`
	// (Optional) The end of port range for the TCP and UDP protocols, or an ICMP/ICMPv6 code.
	ToPort int `pulumi:"toPort"`
}

A collection of values returned by getSecurityGroupRule.

func GetSecurityGroupRule 

func GetSecurityGroupRule(ctx *pulumi.Context, args *GetSecurityGroupRuleArgs, opts ...pulumi.InvokeOption) (*GetSecurityGroupRuleResult, error)

`vpc.getSecurityGroupRule` provides details about a specific security group rule.

## Example Usage

```go package main

import ( 

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

) 

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := vpc.GetSecurityGroupRule(ctx, &vpc.GetSecurityGroupRuleArgs{
			SecurityGroupRuleId: pulumi.StringRef(securityGroupRuleId),
		}, nil)
		if err != nil {
			return err
		}
		return nil
	})
}

```

type GetSecurityGroupRuleResultOutput 

type GetSecurityGroupRuleResultOutput struct{ *pulumi.OutputState }

A collection of values returned by getSecurityGroupRule.

func GetSecurityGroupRuleOutput 

func GetSecurityGroupRuleOutput(ctx *pulumi.Context, args GetSecurityGroupRuleOutputArgs, opts ...pulumi.InvokeOption) GetSecurityGroupRuleResultOutput

func (GetSecurityGroupRuleResultOutput) Arn 

func (o GetSecurityGroupRuleResultOutput) Arn() pulumi.StringOutput

The Amazon Resource Name (ARN) of the security group rule.

func (GetSecurityGroupRuleResultOutput) CidrIpv4 

func (o GetSecurityGroupRuleResultOutput) CidrIpv4() pulumi.StringOutput

The destination IPv4 CIDR range.

func (GetSecurityGroupRuleResultOutput) CidrIpv6 

func (o GetSecurityGroupRuleResultOutput) CidrIpv6() pulumi.StringOutput

The destination IPv6 CIDR range.

func (GetSecurityGroupRuleResultOutput) Description 

func (o GetSecurityGroupRuleResultOutput) Description() pulumi.StringOutput

The security group rule description.

func (GetSecurityGroupRuleResultOutput) ElementType 

func (GetSecurityGroupRuleResultOutput) ElementType() reflect.Type

func (GetSecurityGroupRuleResultOutput) Filters 

func (o GetSecurityGroupRuleResultOutput) Filters() GetSecurityGroupRuleFilterArrayOutput

func (GetSecurityGroupRuleResultOutput) FromPort 

func (o GetSecurityGroupRuleResultOutput) FromPort() pulumi.IntOutput

The start of port range for the TCP and UDP protocols, or an ICMP/ICMPv6 type.

func (GetSecurityGroupRuleResultOutput) Id 

func (o GetSecurityGroupRuleResultOutput) Id() pulumi.StringOutput

func (GetSecurityGroupRuleResultOutput) IpProtocol 

func (o GetSecurityGroupRuleResultOutput) IpProtocol() pulumi.StringOutput

The IP protocol name or number. Use `-1` to specify all protocols.

func (GetSecurityGroupRuleResultOutput) IsEgress 

func (o GetSecurityGroupRuleResultOutput) IsEgress() pulumi.BoolOutput

Indicates whether the security group rule is an outbound rule.

func (GetSecurityGroupRuleResultOutput) PrefixListId 

func (o GetSecurityGroupRuleResultOutput) PrefixListId() pulumi.StringOutput

The ID of the destination prefix list.

func (GetSecurityGroupRuleResultOutput) ReferencedSecurityGroupId 

func (o GetSecurityGroupRuleResultOutput) ReferencedSecurityGroupId() pulumi.StringOutput

The destination security group that is referenced in the rule.

func (GetSecurityGroupRuleResultOutput) SecurityGroupId 

func (o GetSecurityGroupRuleResultOutput) SecurityGroupId() pulumi.StringOutput

The ID of the security group.

func (GetSecurityGroupRuleResultOutput) SecurityGroupRuleId 

func (o GetSecurityGroupRuleResultOutput) SecurityGroupRuleId() pulumi.StringOutput

func (GetSecurityGroupRuleResultOutput) Tags 

func (o GetSecurityGroupRuleResultOutput) Tags() pulumi.StringMapOutput

A map of tags assigned to the resource.

func (GetSecurityGroupRuleResultOutput) ToGetSecurityGroupRuleResultOutput 

func (o GetSecurityGroupRuleResultOutput) ToGetSecurityGroupRuleResultOutput() GetSecurityGroupRuleResultOutput

func (GetSecurityGroupRuleResultOutput) ToGetSecurityGroupRuleResultOutputWithContext 

func (o GetSecurityGroupRuleResultOutput) ToGetSecurityGroupRuleResultOutputWithContext(ctx context.Context) GetSecurityGroupRuleResultOutput

func (GetSecurityGroupRuleResultOutput) ToPort 

func (o GetSecurityGroupRuleResultOutput) ToPort() pulumi.IntOutput

(Optional) The end of port range for the TCP and UDP protocols, or an ICMP/ICMPv6 code.

type GetSecurityGroupRulesArgs 

type GetSecurityGroupRulesArgs struct {
	// Custom filter block as described below.
	Filters []GetSecurityGroupRulesFilter `pulumi:"filters"`
	// Map of tags, each pair of which must exactly match
	// a pair on the desired security group rule.
	//
	// More complex filters can be expressed using one or more `filter` sub-blocks,
	// which take the following arguments:
	Tags map[string]string `pulumi:"tags"`
}

A collection of arguments for invoking getSecurityGroupRules.

type GetSecurityGroupRulesFilter 

type GetSecurityGroupRulesFilter struct {
	// Name of the field to filter by, as defined by
	// [the underlying AWS API](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeSecurityGroupRules.html).
	Name string `pulumi:"name"`
	// Set of values that are accepted for the given field.
	// Security group rule IDs will be selected if any one of the given values match.
	Values []string `pulumi:"values"`
}

type GetSecurityGroupRulesFilterArgs 

type GetSecurityGroupRulesFilterArgs struct {
	// Name of the field to filter by, as defined by
	// [the underlying AWS API](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeSecurityGroupRules.html).
	Name pulumi.StringInput `pulumi:"name"`
	// Set of values that are accepted for the given field.
	// Security group rule IDs will be selected if any one of the given values match.
	Values pulumi.StringArrayInput `pulumi:"values"`
}

func (GetSecurityGroupRulesFilterArgs) ElementType 

func (GetSecurityGroupRulesFilterArgs) ElementType() reflect.Type

func (GetSecurityGroupRulesFilterArgs) ToGetSecurityGroupRulesFilterOutput 

func (i GetSecurityGroupRulesFilterArgs) ToGetSecurityGroupRulesFilterOutput() GetSecurityGroupRulesFilterOutput

func (GetSecurityGroupRulesFilterArgs) ToGetSecurityGroupRulesFilterOutputWithContext 

func (i GetSecurityGroupRulesFilterArgs) ToGetSecurityGroupRulesFilterOutputWithContext(ctx context.Context) GetSecurityGroupRulesFilterOutput

type GetSecurityGroupRulesFilterArray 

type GetSecurityGroupRulesFilterArray []GetSecurityGroupRulesFilterInput

func (GetSecurityGroupRulesFilterArray) ElementType 

func (GetSecurityGroupRulesFilterArray) ElementType() reflect.Type

func (GetSecurityGroupRulesFilterArray) ToGetSecurityGroupRulesFilterArrayOutput 

func (i GetSecurityGroupRulesFilterArray) ToGetSecurityGroupRulesFilterArrayOutput() GetSecurityGroupRulesFilterArrayOutput

func (GetSecurityGroupRulesFilterArray) ToGetSecurityGroupRulesFilterArrayOutputWithContext 

func (i GetSecurityGroupRulesFilterArray) ToGetSecurityGroupRulesFilterArrayOutputWithContext(ctx context.Context) GetSecurityGroupRulesFilterArrayOutput

type GetSecurityGroupRulesFilterArrayInput 

type GetSecurityGroupRulesFilterArrayInput interface {
	pulumi.Input

	ToGetSecurityGroupRulesFilterArrayOutput() GetSecurityGroupRulesFilterArrayOutput
	ToGetSecurityGroupRulesFilterArrayOutputWithContext(context.Context) GetSecurityGroupRulesFilterArrayOutput
}

GetSecurityGroupRulesFilterArrayInput is an input type that accepts GetSecurityGroupRulesFilterArray and GetSecurityGroupRulesFilterArrayOutput values. You can construct a concrete instance of `GetSecurityGroupRulesFilterArrayInput` via: 

GetSecurityGroupRulesFilterArray{ GetSecurityGroupRulesFilterArgs{...} }

type GetSecurityGroupRulesFilterArrayOutput 

type GetSecurityGroupRulesFilterArrayOutput struct{ *pulumi.OutputState }

func (GetSecurityGroupRulesFilterArrayOutput) ElementType 

func (GetSecurityGroupRulesFilterArrayOutput) ElementType() reflect.Type

func (GetSecurityGroupRulesFilterArrayOutput) Index 

func (o GetSecurityGroupRulesFilterArrayOutput) Index(i pulumi.IntInput) GetSecurityGroupRulesFilterOutput

func (GetSecurityGroupRulesFilterArrayOutput) ToGetSecurityGroupRulesFilterArrayOutput 

func (o GetSecurityGroupRulesFilterArrayOutput) ToGetSecurityGroupRulesFilterArrayOutput() GetSecurityGroupRulesFilterArrayOutput

func (GetSecurityGroupRulesFilterArrayOutput) ToGetSecurityGroupRulesFilterArrayOutputWithContext 

func (o GetSecurityGroupRulesFilterArrayOutput) ToGetSecurityGroupRulesFilterArrayOutputWithContext(ctx context.Context) GetSecurityGroupRulesFilterArrayOutput

type GetSecurityGroupRulesFilterInput 

type GetSecurityGroupRulesFilterInput interface {
	pulumi.Input

	ToGetSecurityGroupRulesFilterOutput() GetSecurityGroupRulesFilterOutput
	ToGetSecurityGroupRulesFilterOutputWithContext(context.Context) GetSecurityGroupRulesFilterOutput
}

GetSecurityGroupRulesFilterInput is an input type that accepts GetSecurityGroupRulesFilterArgs and GetSecurityGroupRulesFilterOutput values. You can construct a concrete instance of `GetSecurityGroupRulesFilterInput` via: 

GetSecurityGroupRulesFilterArgs{...}

type GetSecurityGroupRulesFilterOutput 

type GetSecurityGroupRulesFilterOutput struct{ *pulumi.OutputState }

func (GetSecurityGroupRulesFilterOutput) ElementType 

func (GetSecurityGroupRulesFilterOutput) ElementType() reflect.Type

func (GetSecurityGroupRulesFilterOutput) Name 

func (o GetSecurityGroupRulesFilterOutput) Name() pulumi.StringOutput

Name of the field to filter by, as defined by [the underlying AWS API](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeSecurityGroupRules.html).

func (GetSecurityGroupRulesFilterOutput) ToGetSecurityGroupRulesFilterOutput 

func (o GetSecurityGroupRulesFilterOutput) ToGetSecurityGroupRulesFilterOutput() GetSecurityGroupRulesFilterOutput

func (GetSecurityGroupRulesFilterOutput) ToGetSecurityGroupRulesFilterOutputWithContext 

func (o GetSecurityGroupRulesFilterOutput) ToGetSecurityGroupRulesFilterOutputWithContext(ctx context.Context) GetSecurityGroupRulesFilterOutput

func (GetSecurityGroupRulesFilterOutput) Values 

func (o GetSecurityGroupRulesFilterOutput) Values() pulumi.StringArrayOutput

Set of values that are accepted for the given field. Security group rule IDs will be selected if any one of the given values match.

type GetSecurityGroupRulesOutputArgs 

type GetSecurityGroupRulesOutputArgs struct {
	// Custom filter block as described below.
	Filters GetSecurityGroupRulesFilterArrayInput `pulumi:"filters"`
	// Map of tags, each pair of which must exactly match
	// a pair on the desired security group rule.
	//
	// More complex filters can be expressed using one or more `filter` sub-blocks,
	// which take the following arguments:
	Tags pulumi.StringMapInput `pulumi:"tags"`
}

A collection of arguments for invoking getSecurityGroupRules.

func (GetSecurityGroupRulesOutputArgs) ElementType 

func (GetSecurityGroupRulesOutputArgs) ElementType() reflect.Type

type GetSecurityGroupRulesResult 

type GetSecurityGroupRulesResult struct {
	Filters []GetSecurityGroupRulesFilter `pulumi:"filters"`
	Id      string                        `pulumi:"id"`
	// List of all the security group rule IDs found.
	Ids  []string          `pulumi:"ids"`
	Tags map[string]string `pulumi:"tags"`
}

A collection of values returned by getSecurityGroupRules.

func GetSecurityGroupRules 

func GetSecurityGroupRules(ctx *pulumi.Context, args *GetSecurityGroupRulesArgs, opts ...pulumi.InvokeOption) (*GetSecurityGroupRulesResult, error)

This resource can be useful for getting back a set of security group rule IDs.

## Example Usage

```go package main

import ( 

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

) func main() { pulumi.Run(func(ctx *pulumi.Context) error { _, err := vpc.GetSecurityGroupRules(ctx, &vpc.GetSecurityGroupRulesArgs{ Filters: []vpc.GetSecurityGroupRulesFilter{ { Name: "group-id", Values: interface{}{ securityGroupId, }, }, }, }, nil); if err != nil { return err } return nil }) } ```

type GetSecurityGroupRulesResultOutput 

type GetSecurityGroupRulesResultOutput struct{ *pulumi.OutputState }

A collection of values returned by getSecurityGroupRules.

func GetSecurityGroupRulesOutput 

func GetSecurityGroupRulesOutput(ctx *pulumi.Context, args GetSecurityGroupRulesOutputArgs, opts ...pulumi.InvokeOption) GetSecurityGroupRulesResultOutput

func (GetSecurityGroupRulesResultOutput) ElementType 

func (GetSecurityGroupRulesResultOutput) ElementType() reflect.Type

func (GetSecurityGroupRulesResultOutput) Filters 

func (o GetSecurityGroupRulesResultOutput) Filters() GetSecurityGroupRulesFilterArrayOutput

func (GetSecurityGroupRulesResultOutput) Id 

func (o GetSecurityGroupRulesResultOutput) Id() pulumi.StringOutput

func (GetSecurityGroupRulesResultOutput) Ids 

func (o GetSecurityGroupRulesResultOutput) Ids() pulumi.StringArrayOutput

List of all the security group rule IDs found.

func (GetSecurityGroupRulesResultOutput) Tags 

func (o GetSecurityGroupRulesResultOutput) Tags() pulumi.StringMapOutput

func (GetSecurityGroupRulesResultOutput) ToGetSecurityGroupRulesResultOutput 

func (o GetSecurityGroupRulesResultOutput) ToGetSecurityGroupRulesResultOutput() GetSecurityGroupRulesResultOutput

func (GetSecurityGroupRulesResultOutput) ToGetSecurityGroupRulesResultOutputWithContext 

func (o GetSecurityGroupRulesResultOutput) ToGetSecurityGroupRulesResultOutputWithContext(ctx context.Context) GetSecurityGroupRulesResultOutput

type SecurityGroupEgressRule 

type SecurityGroupEgressRule struct {
	pulumi.CustomResourceState

	// The Amazon Resource Name (ARN) of the security group rule.
	Arn pulumi.StringOutput `pulumi:"arn"`
	// The destination IPv4 CIDR range.
	CidrIpv4 pulumi.StringPtrOutput `pulumi:"cidrIpv4"`
	// The destination IPv6 CIDR range.
	CidrIpv6 pulumi.StringPtrOutput `pulumi:"cidrIpv6"`
	// The security group rule description.
	Description pulumi.StringPtrOutput `pulumi:"description"`
	// The start of port range for the TCP and UDP protocols, or an ICMP/ICMPv6 type.
	FromPort pulumi.IntPtrOutput `pulumi:"fromPort"`
	// The IP protocol name or number. Use `-1` to specify all protocols. Note that if `ipProtocol` is set to `-1`, it translates to all protocols, all port ranges, and `fromPort` and `toPort` values should not be defined.
	IpProtocol pulumi.StringOutput `pulumi:"ipProtocol"`
	// The ID of the destination prefix list.
	PrefixListId pulumi.StringPtrOutput `pulumi:"prefixListId"`
	// The destination security group that is referenced in the rule.
	ReferencedSecurityGroupId pulumi.StringPtrOutput `pulumi:"referencedSecurityGroupId"`
	// The ID of the security group.
	SecurityGroupId pulumi.StringOutput `pulumi:"securityGroupId"`
	// The ID of the security group rule.
	SecurityGroupRuleId pulumi.StringOutput `pulumi:"securityGroupRuleId"`
	// 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.
	Tags pulumi.StringMapOutput `pulumi:"tags"`
	// A map of tags assigned to the resource, including those inherited from the provider `defaultTags` configuration block.
	//
	// Deprecated: Please use `tags` instead.
	TagsAll pulumi.StringMapOutput `pulumi:"tagsAll"`
	// The end of port range for the TCP and UDP protocols, or an ICMP/ICMPv6 code.
	ToPort pulumi.IntPtrOutput `pulumi:"toPort"`
}

Manages an outbound (egress) rule for a security group.

When specifying an outbound rule for your security group in a VPC, the configuration must include a destination for the traffic.

> **NOTE:** Using `vpc.SecurityGroupEgressRule` and `vpc.SecurityGroupIngressRule` resources is the current best practice. Avoid using the `ec2.SecurityGroupRule` resource and the `ingress` and `egress` arguments of the `ec2.SecurityGroup` resource for configuring in-line rules, as they struggle with managing multiple CIDR blocks, and tags and descriptions due to the historical lack of unique IDs.

!> **WARNING:** You should not use the `vpc.SecurityGroupEgressRule` and `vpc.SecurityGroupIngressRule` resources in conjunction with the `ec2.SecurityGroup` resource with _in-line rules_ (using the `ingress` and `egress` arguments of `ec2.SecurityGroup`) or the `ec2.SecurityGroupRule` resource. Doing so may cause rule conflicts, perpetual differences, and result in rules being overwritten.

## Example Usage

```go package main

import ( 

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

) 

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := vpc.NewSecurityGroupEgressRule(ctx, "example", &vpc.SecurityGroupEgressRuleArgs{
			SecurityGroupId: pulumi.Any(exampleAwsSecurityGroup.Id),
			CidrIpv4:        pulumi.String("10.0.0.0/8"),
			FromPort:        pulumi.Int(80),
			IpProtocol:      pulumi.String("tcp"),
			ToPort:          pulumi.Int(80),
		})
		if err != nil {
			return err
		}
		return nil
	})
}

```

## Import

Using `pulumi import`, import security group egress rules using the `security_group_rule_id`. For example:

```sh $ pulumi import aws:vpc/securityGroupEgressRule:SecurityGroupEgressRule example sgr-02108b27edd666983 ```

func GetSecurityGroupEgressRule 

func GetSecurityGroupEgressRule(ctx *pulumi.Context,
	name string, id pulumi.IDInput, state *SecurityGroupEgressRuleState, opts ...pulumi.ResourceOption) (*SecurityGroupEgressRule, error)

GetSecurityGroupEgressRule gets an existing SecurityGroupEgressRule 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 NewSecurityGroupEgressRule 

func NewSecurityGroupEgressRule(ctx *pulumi.Context,
	name string, args *SecurityGroupEgressRuleArgs, opts ...pulumi.ResourceOption) (*SecurityGroupEgressRule, error)

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

func (*SecurityGroupEgressRule) ElementType 

func (*SecurityGroupEgressRule) ElementType() reflect.Type

func (*SecurityGroupEgressRule) ToSecurityGroupEgressRuleOutput 

func (i *SecurityGroupEgressRule) ToSecurityGroupEgressRuleOutput() SecurityGroupEgressRuleOutput

func (*SecurityGroupEgressRule) ToSecurityGroupEgressRuleOutputWithContext 

func (i *SecurityGroupEgressRule) ToSecurityGroupEgressRuleOutputWithContext(ctx context.Context) SecurityGroupEgressRuleOutput

type SecurityGroupEgressRuleArgs 

type SecurityGroupEgressRuleArgs struct {
	// The destination IPv4 CIDR range.
	CidrIpv4 pulumi.StringPtrInput
	// The destination IPv6 CIDR range.
	CidrIpv6 pulumi.StringPtrInput
	// The security group rule description.
	Description pulumi.StringPtrInput
	// The start of port range for the TCP and UDP protocols, or an ICMP/ICMPv6 type.
	FromPort pulumi.IntPtrInput
	// The IP protocol name or number. Use `-1` to specify all protocols. Note that if `ipProtocol` is set to `-1`, it translates to all protocols, all port ranges, and `fromPort` and `toPort` values should not be defined.
	IpProtocol pulumi.StringInput
	// The ID of the destination prefix list.
	PrefixListId pulumi.StringPtrInput
	// The destination security group that is referenced in the rule.
	ReferencedSecurityGroupId pulumi.StringPtrInput
	// The ID of the security group.
	SecurityGroupId pulumi.StringInput
	// 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.
	Tags pulumi.StringMapInput
	// The end of port range for the TCP and UDP protocols, or an ICMP/ICMPv6 code.
	ToPort pulumi.IntPtrInput
}

The set of arguments for constructing a SecurityGroupEgressRule resource.

func (SecurityGroupEgressRuleArgs) ElementType 

func (SecurityGroupEgressRuleArgs) ElementType() reflect.Type

type SecurityGroupEgressRuleArray 

type SecurityGroupEgressRuleArray []SecurityGroupEgressRuleInput

func (SecurityGroupEgressRuleArray) ElementType 

func (SecurityGroupEgressRuleArray) ElementType() reflect.Type

func (SecurityGroupEgressRuleArray) ToSecurityGroupEgressRuleArrayOutput 

func (i SecurityGroupEgressRuleArray) ToSecurityGroupEgressRuleArrayOutput() SecurityGroupEgressRuleArrayOutput

func (SecurityGroupEgressRuleArray) ToSecurityGroupEgressRuleArrayOutputWithContext 

func (i SecurityGroupEgressRuleArray) ToSecurityGroupEgressRuleArrayOutputWithContext(ctx context.Context) SecurityGroupEgressRuleArrayOutput

type SecurityGroupEgressRuleArrayInput 

type SecurityGroupEgressRuleArrayInput interface {
	pulumi.Input

	ToSecurityGroupEgressRuleArrayOutput() SecurityGroupEgressRuleArrayOutput
	ToSecurityGroupEgressRuleArrayOutputWithContext(context.Context) SecurityGroupEgressRuleArrayOutput
}

SecurityGroupEgressRuleArrayInput is an input type that accepts SecurityGroupEgressRuleArray and SecurityGroupEgressRuleArrayOutput values. You can construct a concrete instance of `SecurityGroupEgressRuleArrayInput` via: 

SecurityGroupEgressRuleArray{ SecurityGroupEgressRuleArgs{...} }

type SecurityGroupEgressRuleArrayOutput 

type SecurityGroupEgressRuleArrayOutput struct{ *pulumi.OutputState }

func (SecurityGroupEgressRuleArrayOutput) ElementType 

func (SecurityGroupEgressRuleArrayOutput) ElementType() reflect.Type

func (SecurityGroupEgressRuleArrayOutput) Index 

func (o SecurityGroupEgressRuleArrayOutput) Index(i pulumi.IntInput) SecurityGroupEgressRuleOutput

func (SecurityGroupEgressRuleArrayOutput) ToSecurityGroupEgressRuleArrayOutput 

func (o SecurityGroupEgressRuleArrayOutput) ToSecurityGroupEgressRuleArrayOutput() SecurityGroupEgressRuleArrayOutput

func (SecurityGroupEgressRuleArrayOutput) ToSecurityGroupEgressRuleArrayOutputWithContext 

func (o SecurityGroupEgressRuleArrayOutput) ToSecurityGroupEgressRuleArrayOutputWithContext(ctx context.Context) SecurityGroupEgressRuleArrayOutput

type SecurityGroupEgressRuleInput 

type SecurityGroupEgressRuleInput interface {
	pulumi.Input

	ToSecurityGroupEgressRuleOutput() SecurityGroupEgressRuleOutput
	ToSecurityGroupEgressRuleOutputWithContext(ctx context.Context) SecurityGroupEgressRuleOutput
}

type SecurityGroupEgressRuleMap 

type SecurityGroupEgressRuleMap map[string]SecurityGroupEgressRuleInput

func (SecurityGroupEgressRuleMap) ElementType 

func (SecurityGroupEgressRuleMap) ElementType() reflect.Type

func (SecurityGroupEgressRuleMap) ToSecurityGroupEgressRuleMapOutput 

func (i SecurityGroupEgressRuleMap) ToSecurityGroupEgressRuleMapOutput() SecurityGroupEgressRuleMapOutput

func (SecurityGroupEgressRuleMap) ToSecurityGroupEgressRuleMapOutputWithContext 

func (i SecurityGroupEgressRuleMap) ToSecurityGroupEgressRuleMapOutputWithContext(ctx context.Context) SecurityGroupEgressRuleMapOutput

type SecurityGroupEgressRuleMapInput 

type SecurityGroupEgressRuleMapInput interface {
	pulumi.Input

	ToSecurityGroupEgressRuleMapOutput() SecurityGroupEgressRuleMapOutput
	ToSecurityGroupEgressRuleMapOutputWithContext(context.Context) SecurityGroupEgressRuleMapOutput
}

SecurityGroupEgressRuleMapInput is an input type that accepts SecurityGroupEgressRuleMap and SecurityGroupEgressRuleMapOutput values. You can construct a concrete instance of `SecurityGroupEgressRuleMapInput` via: 

SecurityGroupEgressRuleMap{ "key": SecurityGroupEgressRuleArgs{...} }

type SecurityGroupEgressRuleMapOutput 

type SecurityGroupEgressRuleMapOutput struct{ *pulumi.OutputState }

func (SecurityGroupEgressRuleMapOutput) ElementType 

func (SecurityGroupEgressRuleMapOutput) ElementType() reflect.Type

func (SecurityGroupEgressRuleMapOutput) MapIndex 

func (o SecurityGroupEgressRuleMapOutput) MapIndex(k pulumi.StringInput) SecurityGroupEgressRuleOutput

func (SecurityGroupEgressRuleMapOutput) ToSecurityGroupEgressRuleMapOutput 

func (o SecurityGroupEgressRuleMapOutput) ToSecurityGroupEgressRuleMapOutput() SecurityGroupEgressRuleMapOutput

func (SecurityGroupEgressRuleMapOutput) ToSecurityGroupEgressRuleMapOutputWithContext 

func (o SecurityGroupEgressRuleMapOutput) ToSecurityGroupEgressRuleMapOutputWithContext(ctx context.Context) SecurityGroupEgressRuleMapOutput

type SecurityGroupEgressRuleOutput 

type SecurityGroupEgressRuleOutput struct{ *pulumi.OutputState }

func (SecurityGroupEgressRuleOutput) Arn 

func (o SecurityGroupEgressRuleOutput) Arn() pulumi.StringOutput

The Amazon Resource Name (ARN) of the security group rule.

func (SecurityGroupEgressRuleOutput) CidrIpv4 

func (o SecurityGroupEgressRuleOutput) CidrIpv4() pulumi.StringPtrOutput

The destination IPv4 CIDR range.

func (SecurityGroupEgressRuleOutput) CidrIpv6 

func (o SecurityGroupEgressRuleOutput) CidrIpv6() pulumi.StringPtrOutput

The destination IPv6 CIDR range.

func (SecurityGroupEgressRuleOutput) Description 

func (o SecurityGroupEgressRuleOutput) Description() pulumi.StringPtrOutput

The security group rule description.

func (SecurityGroupEgressRuleOutput) ElementType 

func (SecurityGroupEgressRuleOutput) ElementType() reflect.Type

func (SecurityGroupEgressRuleOutput) FromPort 

func (o SecurityGroupEgressRuleOutput) FromPort() pulumi.IntPtrOutput

The start of port range for the TCP and UDP protocols, or an ICMP/ICMPv6 type.

func (SecurityGroupEgressRuleOutput) IpProtocol 

func (o SecurityGroupEgressRuleOutput) IpProtocol() pulumi.StringOutput

The IP protocol name or number. Use `-1` to specify all protocols. Note that if `ipProtocol` is set to `-1`, it translates to all protocols, all port ranges, and `fromPort` and `toPort` values should not be defined.

func (SecurityGroupEgressRuleOutput) PrefixListId 

func (o SecurityGroupEgressRuleOutput) PrefixListId() pulumi.StringPtrOutput

The ID of the destination prefix list.

func (SecurityGroupEgressRuleOutput) ReferencedSecurityGroupId 

func (o SecurityGroupEgressRuleOutput) ReferencedSecurityGroupId() pulumi.StringPtrOutput

The destination security group that is referenced in the rule.

func (SecurityGroupEgressRuleOutput) SecurityGroupId 

func (o SecurityGroupEgressRuleOutput) SecurityGroupId() pulumi.StringOutput

The ID of the security group.

func (SecurityGroupEgressRuleOutput) SecurityGroupRuleId 

func (o SecurityGroupEgressRuleOutput) SecurityGroupRuleId() pulumi.StringOutput

The ID of the security group rule.

func (SecurityGroupEgressRuleOutput) Tags 

func (o SecurityGroupEgressRuleOutput) 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.

func (SecurityGroupEgressRuleOutput) TagsAll deprecated 

func (o SecurityGroupEgressRuleOutput) TagsAll() pulumi.StringMapOutput

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

Deprecated: Please use `tags` instead.

func (SecurityGroupEgressRuleOutput) ToPort 

func (o SecurityGroupEgressRuleOutput) ToPort() pulumi.IntPtrOutput

The end of port range for the TCP and UDP protocols, or an ICMP/ICMPv6 code.

func (SecurityGroupEgressRuleOutput) ToSecurityGroupEgressRuleOutput 

func (o SecurityGroupEgressRuleOutput) ToSecurityGroupEgressRuleOutput() SecurityGroupEgressRuleOutput

func (SecurityGroupEgressRuleOutput) ToSecurityGroupEgressRuleOutputWithContext 

func (o SecurityGroupEgressRuleOutput) ToSecurityGroupEgressRuleOutputWithContext(ctx context.Context) SecurityGroupEgressRuleOutput

type SecurityGroupEgressRuleState 

type SecurityGroupEgressRuleState struct {
	// The Amazon Resource Name (ARN) of the security group rule.
	Arn pulumi.StringPtrInput
	// The destination IPv4 CIDR range.
	CidrIpv4 pulumi.StringPtrInput
	// The destination IPv6 CIDR range.
	CidrIpv6 pulumi.StringPtrInput
	// The security group rule description.
	Description pulumi.StringPtrInput
	// The start of port range for the TCP and UDP protocols, or an ICMP/ICMPv6 type.
	FromPort pulumi.IntPtrInput
	// The IP protocol name or number. Use `-1` to specify all protocols. Note that if `ipProtocol` is set to `-1`, it translates to all protocols, all port ranges, and `fromPort` and `toPort` values should not be defined.
	IpProtocol pulumi.StringPtrInput
	// The ID of the destination prefix list.
	PrefixListId pulumi.StringPtrInput
	// The destination security group that is referenced in the rule.
	ReferencedSecurityGroupId pulumi.StringPtrInput
	// The ID of the security group.
	SecurityGroupId pulumi.StringPtrInput
	// The ID of the security group rule.
	SecurityGroupRuleId 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.
	Tags pulumi.StringMapInput
	// A map of tags assigned to the resource, including those inherited from the provider `defaultTags` configuration block.
	//
	// Deprecated: Please use `tags` instead.
	TagsAll pulumi.StringMapInput
	// The end of port range for the TCP and UDP protocols, or an ICMP/ICMPv6 code.
	ToPort pulumi.IntPtrInput
}

func (SecurityGroupEgressRuleState) ElementType 

func (SecurityGroupEgressRuleState) ElementType() reflect.Type

type SecurityGroupIngressRule 

type SecurityGroupIngressRule struct {
	pulumi.CustomResourceState

	// The Amazon Resource Name (ARN) of the security group rule.
	Arn pulumi.StringOutput `pulumi:"arn"`
	// The source IPv4 CIDR range.
	CidrIpv4 pulumi.StringPtrOutput `pulumi:"cidrIpv4"`
	// The source IPv6 CIDR range.
	CidrIpv6 pulumi.StringPtrOutput `pulumi:"cidrIpv6"`
	// The security group rule description.
	Description pulumi.StringPtrOutput `pulumi:"description"`
	// The start of port range for the TCP and UDP protocols, or an ICMP/ICMPv6 type.
	FromPort pulumi.IntPtrOutput `pulumi:"fromPort"`
	// The IP protocol name or number. Use `-1` to specify all protocols. Note that if `ipProtocol` is set to `-1`, it translates to all protocols, all port ranges, and `fromPort` and `toPort` values should not be defined.
	IpProtocol pulumi.StringOutput `pulumi:"ipProtocol"`
	// The ID of the source prefix list.
	PrefixListId pulumi.StringPtrOutput `pulumi:"prefixListId"`
	// The source security group that is referenced in the rule.
	ReferencedSecurityGroupId pulumi.StringPtrOutput `pulumi:"referencedSecurityGroupId"`
	// The ID of the security group.
	SecurityGroupId pulumi.StringOutput `pulumi:"securityGroupId"`
	// The ID of the security group rule.
	SecurityGroupRuleId pulumi.StringOutput `pulumi:"securityGroupRuleId"`
	// 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.
	Tags pulumi.StringMapOutput `pulumi:"tags"`
	// A map of tags assigned to the resource, including those inherited from the provider `defaultTags` configuration block.
	//
	// Deprecated: Please use `tags` instead.
	TagsAll pulumi.StringMapOutput `pulumi:"tagsAll"`
	// The end of port range for the TCP and UDP protocols, or an ICMP/ICMPv6 code.
	ToPort pulumi.IntPtrOutput `pulumi:"toPort"`
}

Manages an inbound (ingress) rule for a security group.

When specifying an inbound rule for your security group in a VPC, the configuration must include a source for the traffic.

> **NOTE:** Using `vpc.SecurityGroupEgressRule` and `vpc.SecurityGroupIngressRule` resources is the current best practice. Avoid using the `ec2.SecurityGroupRule` resource and the `ingress` and `egress` arguments of the `ec2.SecurityGroup` resource for configuring in-line rules, as they struggle with managing multiple CIDR blocks, and tags and descriptions due to the historical lack of unique IDs.

!> **WARNING:** You should not use the `vpc.SecurityGroupEgressRule` and `vpc.SecurityGroupIngressRule` resources in conjunction with the `ec2.SecurityGroup` resource with _in-line rules_ (using the `ingress` and `egress` arguments of `ec2.SecurityGroup`) or the `ec2.SecurityGroupRule` resource. Doing so may cause rule conflicts, perpetual differences, and result in rules being overwritten.

## Example Usage

```go package main

import ( 

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

) 

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		example, err := ec2.NewSecurityGroup(ctx, "example", &ec2.SecurityGroupArgs{
			Name:        pulumi.String("example"),
			Description: pulumi.String("example"),
			VpcId:       pulumi.Any(main.Id),
			Tags: pulumi.StringMap{
				"Name": pulumi.String("example"),
			},
		})
		if err != nil {
			return err
		}
		_, err = vpc.NewSecurityGroupIngressRule(ctx, "example", &vpc.SecurityGroupIngressRuleArgs{
			SecurityGroupId: example.ID(),
			CidrIpv4:        pulumi.String("10.0.0.0/8"),
			FromPort:        pulumi.Int(80),
			IpProtocol:      pulumi.String("tcp"),
			ToPort:          pulumi.Int(80),
		})
		if err != nil {
			return err
		}
		return nil
	})
}

```

## Import

Using `pulumi import`, import security group ingress rules using the `security_group_rule_id`. For example:

```sh $ pulumi import aws:vpc/securityGroupIngressRule:SecurityGroupIngressRule example sgr-02108b27edd666983 ```

func GetSecurityGroupIngressRule 

func GetSecurityGroupIngressRule(ctx *pulumi.Context,
	name string, id pulumi.IDInput, state *SecurityGroupIngressRuleState, opts ...pulumi.ResourceOption) (*SecurityGroupIngressRule, error)

GetSecurityGroupIngressRule gets an existing SecurityGroupIngressRule 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 NewSecurityGroupIngressRule 

func NewSecurityGroupIngressRule(ctx *pulumi.Context,
	name string, args *SecurityGroupIngressRuleArgs, opts ...pulumi.ResourceOption) (*SecurityGroupIngressRule, error)

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

func (*SecurityGroupIngressRule) ElementType 

func (*SecurityGroupIngressRule) ElementType() reflect.Type

func (*SecurityGroupIngressRule) ToSecurityGroupIngressRuleOutput 

func (i *SecurityGroupIngressRule) ToSecurityGroupIngressRuleOutput() SecurityGroupIngressRuleOutput

func (*SecurityGroupIngressRule) ToSecurityGroupIngressRuleOutputWithContext 

func (i *SecurityGroupIngressRule) ToSecurityGroupIngressRuleOutputWithContext(ctx context.Context) SecurityGroupIngressRuleOutput

type SecurityGroupIngressRuleArgs 

type SecurityGroupIngressRuleArgs struct {
	// The source IPv4 CIDR range.
	CidrIpv4 pulumi.StringPtrInput
	// The source IPv6 CIDR range.
	CidrIpv6 pulumi.StringPtrInput
	// The security group rule description.
	Description pulumi.StringPtrInput
	// The start of port range for the TCP and UDP protocols, or an ICMP/ICMPv6 type.
	FromPort pulumi.IntPtrInput
	// The IP protocol name or number. Use `-1` to specify all protocols. Note that if `ipProtocol` is set to `-1`, it translates to all protocols, all port ranges, and `fromPort` and `toPort` values should not be defined.
	IpProtocol pulumi.StringInput
	// The ID of the source prefix list.
	PrefixListId pulumi.StringPtrInput
	// The source security group that is referenced in the rule.
	ReferencedSecurityGroupId pulumi.StringPtrInput
	// The ID of the security group.
	SecurityGroupId pulumi.StringInput
	// 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.
	Tags pulumi.StringMapInput
	// The end of port range for the TCP and UDP protocols, or an ICMP/ICMPv6 code.
	ToPort pulumi.IntPtrInput
}

The set of arguments for constructing a SecurityGroupIngressRule resource.

func (SecurityGroupIngressRuleArgs) ElementType 

func (SecurityGroupIngressRuleArgs) ElementType() reflect.Type

type SecurityGroupIngressRuleArray 

type SecurityGroupIngressRuleArray []SecurityGroupIngressRuleInput

func (SecurityGroupIngressRuleArray) ElementType 

func (SecurityGroupIngressRuleArray) ElementType() reflect.Type

func (SecurityGroupIngressRuleArray) ToSecurityGroupIngressRuleArrayOutput 

func (i SecurityGroupIngressRuleArray) ToSecurityGroupIngressRuleArrayOutput() SecurityGroupIngressRuleArrayOutput

func (SecurityGroupIngressRuleArray) ToSecurityGroupIngressRuleArrayOutputWithContext 

func (i SecurityGroupIngressRuleArray) ToSecurityGroupIngressRuleArrayOutputWithContext(ctx context.Context) SecurityGroupIngressRuleArrayOutput

type SecurityGroupIngressRuleArrayInput 

type SecurityGroupIngressRuleArrayInput interface {
	pulumi.Input

	ToSecurityGroupIngressRuleArrayOutput() SecurityGroupIngressRuleArrayOutput
	ToSecurityGroupIngressRuleArrayOutputWithContext(context.Context) SecurityGroupIngressRuleArrayOutput
}

SecurityGroupIngressRuleArrayInput is an input type that accepts SecurityGroupIngressRuleArray and SecurityGroupIngressRuleArrayOutput values. You can construct a concrete instance of `SecurityGroupIngressRuleArrayInput` via: 

SecurityGroupIngressRuleArray{ SecurityGroupIngressRuleArgs{...} }

type SecurityGroupIngressRuleArrayOutput 

type SecurityGroupIngressRuleArrayOutput struct{ *pulumi.OutputState }

func (SecurityGroupIngressRuleArrayOutput) ElementType 

func (SecurityGroupIngressRuleArrayOutput) ElementType() reflect.Type

func (SecurityGroupIngressRuleArrayOutput) Index 

func (o SecurityGroupIngressRuleArrayOutput) Index(i pulumi.IntInput) SecurityGroupIngressRuleOutput

func (SecurityGroupIngressRuleArrayOutput) ToSecurityGroupIngressRuleArrayOutput 

func (o SecurityGroupIngressRuleArrayOutput) ToSecurityGroupIngressRuleArrayOutput() SecurityGroupIngressRuleArrayOutput

func (SecurityGroupIngressRuleArrayOutput) ToSecurityGroupIngressRuleArrayOutputWithContext 

func (o SecurityGroupIngressRuleArrayOutput) ToSecurityGroupIngressRuleArrayOutputWithContext(ctx context.Context) SecurityGroupIngressRuleArrayOutput

type SecurityGroupIngressRuleInput 

type SecurityGroupIngressRuleInput interface {
	pulumi.Input

	ToSecurityGroupIngressRuleOutput() SecurityGroupIngressRuleOutput
	ToSecurityGroupIngressRuleOutputWithContext(ctx context.Context) SecurityGroupIngressRuleOutput
}

type SecurityGroupIngressRuleMap 

type SecurityGroupIngressRuleMap map[string]SecurityGroupIngressRuleInput

func (SecurityGroupIngressRuleMap) ElementType 

func (SecurityGroupIngressRuleMap) ElementType() reflect.Type

func (SecurityGroupIngressRuleMap) ToSecurityGroupIngressRuleMapOutput 

func (i SecurityGroupIngressRuleMap) ToSecurityGroupIngressRuleMapOutput() SecurityGroupIngressRuleMapOutput

func (SecurityGroupIngressRuleMap) ToSecurityGroupIngressRuleMapOutputWithContext 

func (i SecurityGroupIngressRuleMap) ToSecurityGroupIngressRuleMapOutputWithContext(ctx context.Context) SecurityGroupIngressRuleMapOutput

type SecurityGroupIngressRuleMapInput 

type SecurityGroupIngressRuleMapInput interface {
	pulumi.Input

	ToSecurityGroupIngressRuleMapOutput() SecurityGroupIngressRuleMapOutput
	ToSecurityGroupIngressRuleMapOutputWithContext(context.Context) SecurityGroupIngressRuleMapOutput
}

SecurityGroupIngressRuleMapInput is an input type that accepts SecurityGroupIngressRuleMap and SecurityGroupIngressRuleMapOutput values. You can construct a concrete instance of `SecurityGroupIngressRuleMapInput` via: 

SecurityGroupIngressRuleMap{ "key": SecurityGroupIngressRuleArgs{...} }

type SecurityGroupIngressRuleMapOutput 

type SecurityGroupIngressRuleMapOutput struct{ *pulumi.OutputState }

func (SecurityGroupIngressRuleMapOutput) ElementType 

func (SecurityGroupIngressRuleMapOutput) ElementType() reflect.Type

func (SecurityGroupIngressRuleMapOutput) MapIndex 

func (o SecurityGroupIngressRuleMapOutput) MapIndex(k pulumi.StringInput) SecurityGroupIngressRuleOutput

func (SecurityGroupIngressRuleMapOutput) ToSecurityGroupIngressRuleMapOutput 

func (o SecurityGroupIngressRuleMapOutput) ToSecurityGroupIngressRuleMapOutput() SecurityGroupIngressRuleMapOutput

func (SecurityGroupIngressRuleMapOutput) ToSecurityGroupIngressRuleMapOutputWithContext 

func (o SecurityGroupIngressRuleMapOutput) ToSecurityGroupIngressRuleMapOutputWithContext(ctx context.Context) SecurityGroupIngressRuleMapOutput

type SecurityGroupIngressRuleOutput 

type SecurityGroupIngressRuleOutput struct{ *pulumi.OutputState }

func (SecurityGroupIngressRuleOutput) Arn 

func (o SecurityGroupIngressRuleOutput) Arn() pulumi.StringOutput

The Amazon Resource Name (ARN) of the security group rule.

func (SecurityGroupIngressRuleOutput) CidrIpv4 

func (o SecurityGroupIngressRuleOutput) CidrIpv4() pulumi.StringPtrOutput

The source IPv4 CIDR range.

func (SecurityGroupIngressRuleOutput) CidrIpv6 

func (o SecurityGroupIngressRuleOutput) CidrIpv6() pulumi.StringPtrOutput

The source IPv6 CIDR range.

func (SecurityGroupIngressRuleOutput) Description 

func (o SecurityGroupIngressRuleOutput) Description() pulumi.StringPtrOutput

The security group rule description.

func (SecurityGroupIngressRuleOutput) ElementType 

func (SecurityGroupIngressRuleOutput) ElementType() reflect.Type

func (SecurityGroupIngressRuleOutput) FromPort 

func (o SecurityGroupIngressRuleOutput) FromPort() pulumi.IntPtrOutput

The start of port range for the TCP and UDP protocols, or an ICMP/ICMPv6 type.

func (SecurityGroupIngressRuleOutput) IpProtocol 

func (o SecurityGroupIngressRuleOutput) IpProtocol() pulumi.StringOutput

The IP protocol name or number. Use `-1` to specify all protocols. Note that if `ipProtocol` is set to `-1`, it translates to all protocols, all port ranges, and `fromPort` and `toPort` values should not be defined.

func (SecurityGroupIngressRuleOutput) PrefixListId 

func (o SecurityGroupIngressRuleOutput) PrefixListId() pulumi.StringPtrOutput

The ID of the source prefix list.

func (SecurityGroupIngressRuleOutput) ReferencedSecurityGroupId 

func (o SecurityGroupIngressRuleOutput) ReferencedSecurityGroupId() pulumi.StringPtrOutput

The source security group that is referenced in the rule.

func (SecurityGroupIngressRuleOutput) SecurityGroupId 

func (o SecurityGroupIngressRuleOutput) SecurityGroupId() pulumi.StringOutput

The ID of the security group.

func (SecurityGroupIngressRuleOutput) SecurityGroupRuleId 

func (o SecurityGroupIngressRuleOutput) SecurityGroupRuleId() pulumi.StringOutput

The ID of the security group rule.

func (SecurityGroupIngressRuleOutput) Tags 

func (o SecurityGroupIngressRuleOutput) 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.

func (SecurityGroupIngressRuleOutput) TagsAll deprecated 

func (o SecurityGroupIngressRuleOutput) TagsAll() pulumi.StringMapOutput

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

Deprecated: Please use `tags` instead.

func (SecurityGroupIngressRuleOutput) ToPort 

func (o SecurityGroupIngressRuleOutput) ToPort() pulumi.IntPtrOutput

The end of port range for the TCP and UDP protocols, or an ICMP/ICMPv6 code.

func (SecurityGroupIngressRuleOutput) ToSecurityGroupIngressRuleOutput 

func (o SecurityGroupIngressRuleOutput) ToSecurityGroupIngressRuleOutput() SecurityGroupIngressRuleOutput

func (SecurityGroupIngressRuleOutput) ToSecurityGroupIngressRuleOutputWithContext 

func (o SecurityGroupIngressRuleOutput) ToSecurityGroupIngressRuleOutputWithContext(ctx context.Context) SecurityGroupIngressRuleOutput

type SecurityGroupIngressRuleState 

type SecurityGroupIngressRuleState struct {
	// The Amazon Resource Name (ARN) of the security group rule.
	Arn pulumi.StringPtrInput
	// The source IPv4 CIDR range.
	CidrIpv4 pulumi.StringPtrInput
	// The source IPv6 CIDR range.
	CidrIpv6 pulumi.StringPtrInput
	// The security group rule description.
	Description pulumi.StringPtrInput
	// The start of port range for the TCP and UDP protocols, or an ICMP/ICMPv6 type.
	FromPort pulumi.IntPtrInput
	// The IP protocol name or number. Use `-1` to specify all protocols. Note that if `ipProtocol` is set to `-1`, it translates to all protocols, all port ranges, and `fromPort` and `toPort` values should not be defined.
	IpProtocol pulumi.StringPtrInput
	// The ID of the source prefix list.
	PrefixListId pulumi.StringPtrInput
	// The source security group that is referenced in the rule.
	ReferencedSecurityGroupId pulumi.StringPtrInput
	// The ID of the security group.
	SecurityGroupId pulumi.StringPtrInput
	// The ID of the security group rule.
	SecurityGroupRuleId 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.
	Tags pulumi.StringMapInput
	// A map of tags assigned to the resource, including those inherited from the provider `defaultTags` configuration block.
	//
	// Deprecated: Please use `tags` instead.
	TagsAll pulumi.StringMapInput
	// The end of port range for the TCP and UDP protocols, or an ICMP/ICMPv6 code.
	ToPort pulumi.IntPtrInput
}

func (SecurityGroupIngressRuleState) ElementType 

func (SecurityGroupIngressRuleState) ElementType() reflect.Type

Source Files

View all Source files

Jump to

Keyboard shortcuts

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