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

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

package aws

import (
	"context"
	"reflect"

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

// Use this data source to get the IP ranges of various AWS products and services. For more information about the contents of this data source and required JSON syntax if referencing a custom URL, see the [AWS IP Address Ranges documentation](https://docs.aws.amazon.com/general/latest/gr/aws-ip-ranges.html).
//
// ## Example Usage
//
// <!--Start PulumiCodeChooser -->
// ```go
// package main
//
// import (
//
//	"github.com/pulumi/pulumi-aws/sdk/v6/go/aws"
//	"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/ec2"
//	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
//
// )
//
//	func main() {
//		pulumi.Run(func(ctx *pulumi.Context) error {
//			europeanEc2, err := aws.GetIpRanges(ctx, &aws.GetIpRangesArgs{
//				Regions: []string{
//					"eu-west-1",
//					"eu-central-1",
//				},
//				Services: []string{
//					"ec2",
//				},
//			}, nil)
//			if err != nil {
//				return err
//			}
//			_, err = ec2.NewSecurityGroup(ctx, "from_europe", &ec2.SecurityGroupArgs{
//				Name: pulumi.String("from_europe"),
//				Ingress: ec2.SecurityGroupIngressArray{
//					&ec2.SecurityGroupIngressArgs{
//						FromPort:       pulumi.Int(443),
//						ToPort:         pulumi.Int(443),
//						Protocol:       pulumi.String("tcp"),
//						CidrBlocks:     interface{}(europeanEc2.CidrBlocks),
//						Ipv6CidrBlocks: interface{}(europeanEc2.Ipv6CidrBlocks),
//					},
//				},
//				Tags: pulumi.StringMap{
//					"CreateDate": pulumi.String(europeanEc2.CreateDate),
//					"SyncToken":  pulumi.Int(europeanEc2.SyncToken),
//				},
//			})
//			if err != nil {
//				return err
//			}
//			return nil
//		})
//	}
//
// ```
// <!--End PulumiCodeChooser -->
func GetIpRanges(ctx *pulumi.Context, args *GetIpRangesArgs, opts ...pulumi.InvokeOption) (*GetIpRangesResult, error) {
	opts = internal.PkgInvokeDefaultOpts(opts)
	var rv GetIpRangesResult
	err := ctx.Invoke("aws:index/getIpRanges:getIpRanges", args, &rv, opts...)
	if err != nil {
		return nil, err
	}
	return &rv, nil
}

// A collection of arguments for invoking getIpRanges.
type GetIpRangesArgs struct {
	Id *string `pulumi:"id"`
	// Filter IP ranges by regions (or include all regions, if
	// omitted). Valid items are `global` (for `cloudfront`) as well as all AWS regions
	// (e.g., `eu-central-1`)
	Regions []string `pulumi:"regions"`
	// Filter IP ranges by services. Valid items are `amazon`
	// (for amazon.com), `amazonConnect`, `apiGateway`, `cloud9`, `cloudfront`,
	// `codebuild`, `dynamodb`, `ec2`, `ec2InstanceConnect`, `globalaccelerator`,
	// `route53`, `route53Healthchecks`, `s3` and `workspacesGateways`. See the
	// [`service` attribute][2] documentation for other possible values.
	//
	// > **NOTE:** If the specified combination of regions and services does not yield any
	// CIDR blocks, this call will fail.
	Services []string `pulumi:"services"`
	// Custom URL for source JSON file. Syntax must match [AWS IP Address Ranges documentation](https://docs.aws.amazon.com/general/latest/gr/aws-ip-ranges.html). Defaults to `https://ip-ranges.amazonaws.com/ip-ranges.json`.
	Url *string `pulumi:"url"`
}

// A collection of values returned by getIpRanges.
type GetIpRangesResult struct {
	// Lexically ordered list of CIDR blocks.
	CidrBlocks []string `pulumi:"cidrBlocks"`
	// Publication time of the IP ranges (e.g., `2016-08-03-23-46-05`).
	CreateDate string `pulumi:"createDate"`
	Id         string `pulumi:"id"`
	// Lexically ordered list of IPv6 CIDR blocks.
	Ipv6CidrBlocks []string `pulumi:"ipv6CidrBlocks"`
	Regions        []string `pulumi:"regions"`
	Services       []string `pulumi:"services"`
	// Publication time of the IP ranges, in Unix epoch time format
	// (e.g., `1470267965`).
	SyncToken int     `pulumi:"syncToken"`
	Url       *string `pulumi:"url"`
}

func GetIpRangesOutput(ctx *pulumi.Context, args GetIpRangesOutputArgs, opts ...pulumi.InvokeOption) GetIpRangesResultOutput {
	return pulumi.ToOutputWithContext(context.Background(), args).
		ApplyT(func(v interface{}) (GetIpRangesResult, error) {
			args := v.(GetIpRangesArgs)
			r, err := GetIpRanges(ctx, &args, opts...)
			var s GetIpRangesResult
			if r != nil {
				s = *r
			}
			return s, err
		}).(GetIpRangesResultOutput)
}

// A collection of arguments for invoking getIpRanges.
type GetIpRangesOutputArgs struct {
	Id pulumi.StringPtrInput `pulumi:"id"`
	// Filter IP ranges by regions (or include all regions, if
	// omitted). Valid items are `global` (for `cloudfront`) as well as all AWS regions
	// (e.g., `eu-central-1`)
	Regions pulumi.StringArrayInput `pulumi:"regions"`
	// Filter IP ranges by services. Valid items are `amazon`
	// (for amazon.com), `amazonConnect`, `apiGateway`, `cloud9`, `cloudfront`,
	// `codebuild`, `dynamodb`, `ec2`, `ec2InstanceConnect`, `globalaccelerator`,
	// `route53`, `route53Healthchecks`, `s3` and `workspacesGateways`. See the
	// [`service` attribute][2] documentation for other possible values.
	//
	// > **NOTE:** If the specified combination of regions and services does not yield any
	// CIDR blocks, this call will fail.
	Services pulumi.StringArrayInput `pulumi:"services"`
	// Custom URL for source JSON file. Syntax must match [AWS IP Address Ranges documentation](https://docs.aws.amazon.com/general/latest/gr/aws-ip-ranges.html). Defaults to `https://ip-ranges.amazonaws.com/ip-ranges.json`.
	Url pulumi.StringPtrInput `pulumi:"url"`
}

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

// A collection of values returned by getIpRanges.
type GetIpRangesResultOutput struct{ *pulumi.OutputState }

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

func (o GetIpRangesResultOutput) ToGetIpRangesResultOutput() GetIpRangesResultOutput {
	return o
}

func (o GetIpRangesResultOutput) ToGetIpRangesResultOutputWithContext(ctx context.Context) GetIpRangesResultOutput {
	return o
}

// Lexically ordered list of CIDR blocks.
func (o GetIpRangesResultOutput) CidrBlocks() pulumi.StringArrayOutput {
	return o.ApplyT(func(v GetIpRangesResult) []string { return v.CidrBlocks }).(pulumi.StringArrayOutput)
}

// Publication time of the IP ranges (e.g., `2016-08-03-23-46-05`).
func (o GetIpRangesResultOutput) CreateDate() pulumi.StringOutput {
	return o.ApplyT(func(v GetIpRangesResult) string { return v.CreateDate }).(pulumi.StringOutput)
}

func (o GetIpRangesResultOutput) Id() pulumi.StringOutput {
	return o.ApplyT(func(v GetIpRangesResult) string { return v.Id }).(pulumi.StringOutput)
}

// Lexically ordered list of IPv6 CIDR blocks.
func (o GetIpRangesResultOutput) Ipv6CidrBlocks() pulumi.StringArrayOutput {
	return o.ApplyT(func(v GetIpRangesResult) []string { return v.Ipv6CidrBlocks }).(pulumi.StringArrayOutput)
}

func (o GetIpRangesResultOutput) Regions() pulumi.StringArrayOutput {
	return o.ApplyT(func(v GetIpRangesResult) []string { return v.Regions }).(pulumi.StringArrayOutput)
}

func (o GetIpRangesResultOutput) Services() pulumi.StringArrayOutput {
	return o.ApplyT(func(v GetIpRangesResult) []string { return v.Services }).(pulumi.StringArrayOutput)
}

// Publication time of the IP ranges, in Unix epoch time format
// (e.g., `1470267965`).
func (o GetIpRangesResultOutput) SyncToken() pulumi.IntOutput {
	return o.ApplyT(func(v GetIpRangesResult) int { return v.SyncToken }).(pulumi.IntOutput)
}

func (o GetIpRangesResultOutput) Url() pulumi.StringPtrOutput {
	return o.ApplyT(func(v GetIpRangesResult) *string { return v.Url }).(pulumi.StringPtrOutput)
}

func init() {
	pulumi.RegisterOutputType(GetIpRangesResultOutput{})
}