import * as pulumi from "@pulumi/pulumi"; import * as inputs from "../types/input"; import * as enums from "../types/enums"; import * as pulumiAws from "@pulumi/aws"; export declare namespace awsx { /** * The set of arguments for constructing a Bucket resource. */ interface BucketArgs { /** * Sets the accelerate configuration of an existing bucket. Can be `Enabled` or `Suspended`. Cannot be used in `cn-north-1` or `us-gov-west-1`. This provider will only perform drift detection if a configuration value is provided. * Use the resource `aws.s3.BucketAccelerateConfiguration` instead. * * @deprecated acceleration_status is deprecated. Use the aws.s3.BucketAccelerateConfiguration resource instead. */ accelerationStatus?: pulumi.Input; /** * The [canned ACL](https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#canned-acl) to apply. Valid values are `private`, `public-read`, `public-read-write`, `aws-exec-read`, `authenticated-read`, and `log-delivery-write`. Defaults to `private`. Conflicts with `grant`. The provider will only perform drift detection if a configuration value is provided. Use the resource `aws.s3.BucketAcl` instead. */ acl?: pulumi.Input; /** * Name of the bucket. If omitted, the provider will assign a random, unique name. Must be lowercase and less than or equal to 63 characters in length. A full list of bucket naming rules [may be found here](https://docs.aws.amazon.com/AmazonS3/latest/userguide/bucketnamingrules.html). The name must not be in the format `[bucketName]--[azid]--x-s3`. Use the `aws.s3.DirectoryBucket` resource to manage S3 Express buckets. */ bucket?: pulumi.Input; /** * Namespace for the bucket. Determines bucket naming scope. Valid values: `account-regional`, `global`. Defaults to `global` (AWS). */ bucketNamespace?: pulumi.Input; /** * Creates a unique bucket name beginning with the specified prefix. Conflicts with `bucket`. Must be lowercase and less than or equal to 37 characters in length. A full list of bucket naming rules [may be found here](https://docs.aws.amazon.com/AmazonS3/latest/userguide/bucketnamingrules.html). */ bucketPrefix?: pulumi.Input; /** * Rule of [Cross-Origin Resource Sharing](https://docs.aws.amazon.com/AmazonS3/latest/dev/cors.html). See CORS rule below for details. This provider will only perform drift detection if a configuration value is provided. Use the resource `aws.s3.BucketCorsConfiguration` instead. * * @deprecated cors_rule is deprecated. Use the aws.s3.BucketCorsConfiguration resource instead. */ corsRules?: pulumi.Input[] | undefined>; /** * Boolean that indicates all objects (including any [locked objects](https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lock-overview.html)) should be deleted from the bucket *when the bucket is destroyed* so that the bucket can be destroyed without error. These objects are *not* recoverable. This only deletes objects when the bucket is destroyed, *not* when setting this parameter to `true`. Once this parameter is set to `true`, there must be a successful `pulumi up` run before a destroy is required to update this value in the resource state. Without a successful `pulumi up` after this parameter is set, this flag will have no effect. If setting this field in the same operation that would require replacing the bucket or destroying the bucket, this flag will not work. Additionally when importing a bucket, a successful `pulumi up` is required to set this value in state before it will take effect on a destroy operation. */ forceDestroy?: pulumi.Input; /** * An [ACL policy grant](https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#sample-acl). See Grant below for details. Conflicts with `acl`. The provider will only perform drift detection if a configuration value is provided. Use the resource `aws.s3.BucketAcl` instead. * * @deprecated grant is deprecated. Use the aws.s3.BucketAcl resource instead. */ grants?: pulumi.Input[] | undefined>; /** * Configuration of [object lifecycle management](http://docs.aws.amazon.com/AmazonS3/latest/dev/object-lifecycle-mgmt.html). See Lifecycle Rule below for details. The provider will only perform drift detection if a configuration value is provided. * Use the resource `aws.s3.BucketLifecycleConfiguration` instead. * * @deprecated lifecycle_rule is deprecated. Use the aws.s3.BucketLifecycleConfiguration resource instead. */ lifecycleRules?: pulumi.Input[] | undefined>; /** * Configuration of [S3 bucket logging](https://docs.aws.amazon.com/AmazonS3/latest/UG/ManagingBucketLogging.html) parameters. See Logging below for details. The provider will only perform drift detection if a configuration value is provided. * Use the resource `aws.s3.BucketLogging` instead. * * @deprecated logging is deprecated. Use the aws.s3.BucketLogging resource instead. */ logging?: pulumi.Input; /** * Configuration of [S3 object locking](https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lock.html). See Object Lock Configuration below for details. * The provider wil only perform drift detection if a configuration value is provided. * Use the `objectLockEnabled` parameter and the resource `aws.s3.BucketObjectLockConfiguration` instead. * * @deprecated object_lock_configuration is deprecated. Use the top-level parameter objectLockEnabled and the aws.s3.BucketObjectLockConfiguration resource instead. */ objectLockConfiguration?: pulumi.Input; /** * Indicates whether this bucket has an Object Lock configuration enabled. Valid values are `true` or `false`. This argument is not supported in all regions or partitions. */ objectLockEnabled?: pulumi.Input; /** * Valid [bucket policy](https://docs.aws.amazon.com/AmazonS3/latest/dev/example-bucket-policies.html) JSON document. Note that if the policy document is not specific enough (but still valid), this provider may view the policy as constantly changing. In this case, please make sure you use the verbose/specific version of the policy. For more information about building AWS IAM policy documents with this provider, see the AWS IAM Policy Document Guide. * The provider will only perform drift detection if a configuration value is provided. * Use the resource `aws.s3.BucketPolicy` instead. */ policy?: pulumi.Input; /** * Region where this resource will be [managed](https://docs.aws.amazon.com/general/latest/gr/rande.html#regional-endpoints). Defaults to the Region set in the provider configuration. */ region?: pulumi.Input; /** * Configuration of [replication configuration](http://docs.aws.amazon.com/AmazonS3/latest/dev/crr.html). See Replication Configuration below for details. The provider will only perform drift detection if a configuration value is provided. * Use the resource `aws.s3.BucketReplicationConfig` instead. * * @deprecated replication_configuration is deprecated. Use the aws.s3.BucketReplicationConfig resource instead. */ replicationConfiguration?: pulumi.Input; /** * Specifies who should bear the cost of Amazon S3 data transfer. * Can be either `BucketOwner` or `Requester`. By default, the owner of the S3 bucket would incur the costs of any data transfer. * See [Requester Pays Buckets](http://docs.aws.amazon.com/AmazonS3/latest/dev/RequesterPaysBuckets.html) developer guide for more information. * The provider will only perform drift detection if a configuration value is provided. * Use the resource `aws.s3.BucketRequestPaymentConfiguration` instead. * * @deprecated request_payer is deprecated. Use the aws.s3.BucketRequestPaymentConfiguration resource instead. */ requestPayer?: pulumi.Input; /** * Configuration of [server-side encryption configuration](http://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-encryption.html). See Server Side Encryption Configuration below for details. * The provider will only perform drift detection if a configuration value is provided. * Use the resource `aws.s3.BucketServerSideEncryptionConfiguration` instead. * * @deprecated server_side_encryption_configuration is deprecated. Use the aws.s3.BucketServerSideEncryptionConfiguration resource instead. */ serverSideEncryptionConfiguration?: pulumi.Input; /** * Map of tags to assign to the bucket. If configured with a provider `defaultTags` configuration block present, tags with matching keys will overwrite those defined at the provider-level. * * The following arguments are deprecated, and will be removed in a future major version: */ tags?: pulumi.Input<{ [key: string]: pulumi.Input; } | undefined>; /** * Configuration of the [S3 bucket versioning state](https://docs.aws.amazon.com/AmazonS3/latest/dev/Versioning.html). See Versioning below for details. The provider will only perform drift detection if a configuration value is provided. Use the resource `aws.s3.BucketVersioning` instead. * * @deprecated versioning is deprecated. Use the aws.s3.BucketVersioning resource instead. */ versioning?: pulumi.Input; /** * Configuration of the [S3 bucket website](https://docs.aws.amazon.com/AmazonS3/latest/userguide/WebsiteHosting.html). See Website below for details. The provider will only perform drift detection if a configuration value is provided. * Use the resource `aws.s3.BucketWebsiteConfiguration` instead. * * @deprecated website is deprecated. Use the aws.s3.BucketWebsiteConfiguration resource instead. */ website?: pulumi.Input; } /** * Log group with default setup unless explicitly skipped. */ interface DefaultLogGroupArgs { /** * Arguments to use instead of the default values during creation. */ args?: inputs.awsx.LogGroupArgs; /** * Identity of an existing log group to use. Cannot be used in combination with `args` or `opts`. */ existing?: inputs.awsx.ExistingLogGroupArgs; /** * Skip creation of the log group. */ skip?: boolean; } /** * Role and policy attachments with default setup unless explicitly skipped or an existing role ARN provided. */ interface DefaultRoleWithPolicyArgs { /** * Args to use when creating the role and policies. Can't be specified if `roleArn` is used. */ args?: inputs.awsx.RoleWithPolicyArgs; /** * ARN of existing role to use instead of creating a new role. Cannot be used in combination with `args` or `opts`. */ roleArn?: pulumi.Input; /** * Skips creation of the role if set to `true`. */ skip?: boolean; } /** * Security Group with default setup unless explicitly skipped or an existing security group id provided. */ interface DefaultSecurityGroupArgs { /** * Args to use when creating the security group. Can't be specified if `securityGroupId` is used. */ args?: inputs.awsx.SecurityGroupArgs; /** * Id of existing security group to use instead of creating a new security group. Cannot be used in combination with `args` or `opts`. */ securityGroupId?: pulumi.Input; /** * Skips creation of the security group if set to `true`. */ skip?: boolean; } /** * defaultSecurityGroupArgsProvideDefaults sets the appropriate defaults for DefaultSecurityGroupArgs */ function defaultSecurityGroupArgsProvideDefaults(val: DefaultSecurityGroupArgs): DefaultSecurityGroupArgs; /** * Reference to an existing bucket. */ interface ExistingBucketArgs { /** * Arn of the bucket. Only one of [arn] or [name] can be specified. */ arn?: pulumi.Input; /** * Name of the bucket. Only one of [arn] or [name] can be specified. */ name?: pulumi.Input; } /** * Reference to an existing log group. */ interface ExistingLogGroupArgs { /** * Arn of the log group. Only one of [arn] or [name] can be specified. */ arn?: pulumi.Input; /** * Name of the log group. Only one of [arn] or [name] can be specified. */ name?: pulumi.Input; /** * Region of the log group. If not specified, the provider region will be used. */ region?: pulumi.Input; } /** * The set of arguments for constructing a LogGroup resource. */ interface LogGroupArgs { /** * Boolean to indicate whether deletion protection is enabled. Defaults to `false`. Once set, switching to `false` requires explicitly specifying `false` rather than removing this argument. */ deletionProtectionEnabled?: pulumi.Input; /** * The ARN of the KMS Key to use when encrypting log data. Please note, after the AWS KMS CMK is disassociated from the log group, * AWS CloudWatch Logs stops encrypting newly ingested data for the log group. All previously ingested data remains encrypted, and AWS CloudWatch Logs requires * permissions for the CMK whenever the encrypted data is requested. */ kmsKeyId?: pulumi.Input; /** * Specified the log class of the log group. Possible values are: `STANDARD`, `INFREQUENT_ACCESS`, or `DELIVERY`. */ logGroupClass?: pulumi.Input; /** * The name of the log group. If omitted, this provider will assign a random, unique name. */ name?: pulumi.Input; /** * Creates a unique name beginning with the specified prefix. Conflicts with `name`. */ namePrefix?: pulumi.Input; /** * Region where this resource will be [managed](https://docs.aws.amazon.com/general/latest/gr/rande.html#regional-endpoints). Defaults to the Region set in the provider configuration. */ region?: pulumi.Input; /** * Specifies the number of days * you want to retain log events in the specified log group. Possible values are: 1, 3, 5, 7, 14, 30, 60, 90, 120, 150, 180, 365, 400, 545, 731, 1096, 1827, 2192, 2557, 2922, 3288, 3653, and 0. * If you select 0, the events in the log group are always retained and never expire. If `logGroupClass` is set to `DELIVERY`, this argument is ignored and `retentionInDays` is forcibly set to 2. */ retentionInDays?: pulumi.Input; /** * Set to true if you do not wish the log group (and any logs it may contain) to be deleted at destroy time, and instead just remove the log group from the state. */ skipDestroy?: pulumi.Input; /** * 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.Input<{ [key: string]: pulumi.Input; } | undefined>; } /** * Log group which is only created if enabled. */ interface OptionalLogGroupArgs { /** * Arguments to use instead of the default values during creation. */ args?: inputs.awsx.LogGroupArgs; /** * Enable creation of the log group. */ enable?: boolean; /** * Identity of an existing log group to use. Cannot be used in combination with `args` or `opts`. */ existing?: inputs.awsx.ExistingLogGroupArgs; } /** * Bucket with default setup. */ interface RequiredBucketArgs { /** * Arguments to use instead of the default values during creation. */ args?: inputs.awsx.BucketArgs; /** * Identity of an existing bucket to use. Cannot be used in combination with `args`. */ existing?: inputs.awsx.ExistingBucketArgs; } /** * The set of arguments for constructing a Role resource and Policy attachments. */ interface RoleWithPolicyArgs { /** * Description of the role. */ description?: pulumi.Input; /** * Whether to force detaching any policies the role has before destroying it. Defaults to `false`. */ forceDetachPolicies?: pulumi.Input; /** * Configuration block defining an exclusive set of IAM inline policies associated with the IAM role. See below. If no blocks are configured, Pulumi will not manage any inline policies in this resource. Configuring one empty block (i.e., `inlinePolicy {}`) will cause Pulumi to remove _all_ inline policies added out of band on `apply`. */ inlinePolicies?: pulumi.Input[] | undefined>; /** * Set of exclusive IAM managed policy ARNs to attach to the IAM role. If this attribute is not configured, Pulumi will ignore policy attachments to this resource. When configured, Pulumi will align the role's managed policy attachments with this set by attaching or detaching managed policies. Configuring an empty set (i.e., `managedPolicyArns = []`) will cause Pulumi to remove _all_ managed policy attachments. */ managedPolicyArns?: pulumi.Input[] | undefined>; /** * Maximum session duration (in seconds) that you want to set for the specified role. If you do not specify a value for this setting, the default maximum of one hour is applied. This setting can have a value from 1 hour to 12 hours. */ maxSessionDuration?: pulumi.Input; /** * Friendly name of the role. If omitted, the provider will assign a random, unique name. See [IAM Identifiers](https://docs.aws.amazon.com/IAM/latest/UserGuide/Using_Identifiers.html) for more information. */ name?: pulumi.Input; /** * Creates a unique friendly name beginning with the specified prefix. Conflicts with `name`. */ namePrefix?: pulumi.Input; /** * Path to the role. See [IAM Identifiers](https://docs.aws.amazon.com/IAM/latest/UserGuide/Using_Identifiers.html) for more information. */ path?: pulumi.Input; /** * ARN of the policy that is used to set the permissions boundary for the role. */ permissionsBoundary?: pulumi.Input; /** * ARNs of the policies to attach to the created role. */ policyArns?: string[]; /** * Key-value mapping of tags for the IAM role. If configured with a provider `defaultTags` configuration block present, tags with matching keys will overwrite those defined at the provider-level. */ tags?: pulumi.Input<{ [key: string]: pulumi.Input; } | undefined>; } /** * The set of arguments for constructing a Security Group resource. */ interface SecurityGroupArgs { /** * Security group description. Defaults to `Managed by Pulumi`. Cannot be `""`. **NOTE**: This field maps to the AWS `GroupDescription` attribute, for which there is no Update API. If you'd like to classify your security groups in a way that can be updated, use `tags`. */ description?: pulumi.Input; /** * Configuration block for egress rules. Can be specified multiple times for each egress rule. Each egress block supports fields documented below. This argument is processed in attribute-as-blocks mode. */ egress?: pulumi.Input[] | undefined>; /** * Configuration block for ingress rules. Can be specified multiple times for each ingress rule. Each ingress block supports fields documented below. This argument is processed in attribute-as-blocks mode. */ ingress?: pulumi.Input[] | undefined>; /** * Name of the security group. If omitted, the provider will assign a random, unique name. */ name?: pulumi.Input; /** * Creates a unique name beginning with the specified prefix. Conflicts with `name`. */ namePrefix?: pulumi.Input; /** * Region where this resource will be [managed](https://docs.aws.amazon.com/general/latest/gr/rande.html#regional-endpoints). Defaults to the Region set in the provider configuration. */ region?: pulumi.Input; /** * Instruct the provider to revoke all of the Security Groups attached ingress and egress rules before deleting the rule itself. This is normally not needed, however certain AWS services such as Elastic Map Reduce may automatically add required rules to security groups used with the service, and those rules may contain a cyclic dependency that prevent the security groups from being destroyed without removing the dependency first. Default `false`. */ revokeRulesOnDelete?: pulumi.Input; /** * 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.Input<{ [key: string]: pulumi.Input; } | undefined>; /** * VPC ID. Defaults to the region's default VPC. */ vpcId?: pulumi.Input; } /** * securityGroupArgsProvideDefaults sets the appropriate defaults for SecurityGroupArgs */ function securityGroupArgsProvideDefaults(val: SecurityGroupArgs): SecurityGroupArgs; } export declare namespace cloudtrail { } export declare namespace ec2 { /** * Configuration for NAT Gateways. */ interface NatGatewayConfigurationArgs { /** * A list of EIP allocation IDs to assign to the NAT Gateways. Optional. If specified, the number of supplied values must match the chosen strategy (either one, or the number of availability zones). */ elasticIpAllocationIds?: pulumi.Input[]; /** * The strategy for deploying NAT Gateways. */ strategy: enums.ec2.NatGatewayStrategy; } /** * Configuration for a VPC subnet. */ interface SubnetSpecArgs { /** * Indicates whether a network interface created in this subnet receives an IPv6 address. */ assignIpv6AddressOnCreation?: boolean; /** * An optional list of CIDR blocks to assign to the subnet spec for each AZ. If specified, the count must match the number of AZs being used for the VPC, and must also be specified for all other subnet specs. */ cidrBlocks?: string[]; /** * The netmask for the subnet's CIDR block. This is optional, the default value is inferred from the `cidrMask`, `cidrBlocks` or based on an even distribution of available space from the VPC's CIDR block after being divided evenly by availability zone. */ cidrMask?: number; /** * The subnet's name. Will be templated upon creation. */ name?: string; /** * Optional size of the subnet's CIDR block - the number of hosts. This value must be a power of 2 (e.g. 256, 512, 1024, etc.). This is optional, the default value is inferred from the `cidrMask`, `cidrBlocks` or based on an even distribution of available space from the VPC's CIDR block after being divided evenly by availability zone. */ size?: number; /** * A map of tags to assign to the resource. */ tags?: pulumi.Input<{ [key: string]: pulumi.Input; } | undefined>; /** * The type of subnet. */ type: enums.ec2.SubnetType; } /** * Provides a VPC Endpoint resource. * * > **NOTE on VPC Endpoints and VPC Endpoint Associations:** The provider provides both standalone VPC Endpoint Associations for * Route Tables - (an association between a VPC endpoint and a single `routeTableId`), * Security Groups - (an association between a VPC endpoint and a single `securityGroupId`), * and Subnets - (an association between a VPC endpoint and a single `subnetId`) and * a VPC Endpoint resource with `routeTableIds` and `subnetIds` attributes. * Do not use the same resource ID in both a VPC Endpoint resource and a VPC Endpoint Association resource. * Doing so will cause a conflict of associations and will overwrite the association. * * ## Example Usage * * ### Basic * * ```typescript * import * as pulumi from "@pulumi/pulumi"; * import * as aws from "@pulumi/aws"; * * const s3 = new aws.ec2.VpcEndpoint("s3", { * vpcId: main.id, * serviceName: "com.amazonaws.us-west-2.s3", * }); * ``` * * ### Basic w/ Tags * * ```typescript * import * as pulumi from "@pulumi/pulumi"; * import * as aws from "@pulumi/aws"; * * const s3 = new aws.ec2.VpcEndpoint("s3", { * vpcId: main.id, * serviceName: "com.amazonaws.us-west-2.s3", * tags: { * Environment: "test", * }, * }); * ``` * * ### Cross-region enabled AWS services * * ```typescript * import * as pulumi from "@pulumi/pulumi"; * import * as aws from "@pulumi/aws"; * * const s3 = new aws.ec2.VpcEndpoint("s3", { * region: "us-west-2", * vpcId: main.id, * serviceName: "com.amazonaws.us-east-2.s3", * serviceRegion: "us-east-2", * tags: { * Environment: "test", * }, * }); * ``` * * ### Interface Endpoint Type * * ```typescript * import * as pulumi from "@pulumi/pulumi"; * import * as aws from "@pulumi/aws"; * * const ec2 = new aws.ec2.VpcEndpoint("ec2", { * vpcId: main.id, * serviceName: "com.amazonaws.us-west-2.ec2", * vpcEndpointType: "Interface", * securityGroupIds: [sg1.id], * privateDnsEnabled: true, * }); * ``` * * ### Interface Endpoint Type with User-Defined IP Address * * ```typescript * import * as pulumi from "@pulumi/pulumi"; * import * as aws from "@pulumi/aws"; * * const ec2 = new aws.ec2.VpcEndpoint("ec2", { * vpcId: example.id, * serviceName: "com.amazonaws.us-west-2.ec2", * vpcEndpointType: "Interface", * subnetConfigurations: [ * { * ipv4: "10.0.1.10", * subnetId: example1.id, * }, * { * ipv4: "10.0.2.10", * subnetId: example2.id, * }, * ], * subnetIds: [ * example1.id, * example2.id, * ], * }); * ``` * * ### Gateway Load Balancer Endpoint Type * * ```typescript * import * as pulumi from "@pulumi/pulumi"; * import * as aws from "@pulumi/aws"; * * const current = aws.getCallerIdentity({}); * const example = new aws.ec2.VpcEndpointService("example", { * acceptanceRequired: false, * allowedPrincipals: [current.then(current => current.arn)], * gatewayLoadBalancerArns: [exampleAwsLb.arn], * }); * const exampleVpcEndpoint = new aws.ec2.VpcEndpoint("example", { * serviceName: example.serviceName, * subnetIds: [exampleAwsSubnet.id], * vpcEndpointType: example.serviceType, * vpcId: exampleAwsVpc.id, * }); * ``` * * ### VPC Lattice Resource Configuration Endpoint Type * * ```typescript * import * as pulumi from "@pulumi/pulumi"; * import * as aws from "@pulumi/aws"; * * const example = new aws.ec2.VpcEndpoint("example", { * resourceConfigurationArn: exampleAwsVpclatticeResourceConfiguration.arn, * subnetIds: [exampleAwsSubnet.id], * vpcEndpointType: "Resource", * vpcId: exampleAwsVpc.id, * }); * ``` * * ### VPC Lattice Service Network Endpoint Type * * ```typescript * import * as pulumi from "@pulumi/pulumi"; * import * as aws from "@pulumi/aws"; * * const example = new aws.ec2.VpcEndpoint("example", { * serviceNetworkArn: exampleAwsVpclatticeServiceNetwork.arn, * subnetIds: [exampleAwsSubnet.id], * vpcEndpointType: "ServiceNetwork", * vpcId: exampleAwsVpc.id, * }); * ``` * * ### Non-AWS Service * * ```typescript * import * as pulumi from "@pulumi/pulumi"; * import * as aws from "@pulumi/aws"; * * const ptfeService = new aws.ec2.VpcEndpoint("ptfe_service", { * vpcId: vpcId, * serviceName: ptfeServiceConfig, * vpcEndpointType: "Interface", * securityGroupIds: [ptfeServiceAwsSecurityGroup.id], * subnetIds: [subnetIds], * privateDnsEnabled: false, * }); * const internal = aws.route53.getZone({ * name: "vpc.internal.", * privateZone: true, * vpcId: vpcId, * }); * const ptfeServiceRecord = new aws.route53.Record("ptfe_service", { * zoneId: internal.then(internal => internal.zoneId), * name: internal.then(internal => `ptfe.${internal.name}`), * type: aws.route53.RecordType.CNAME, * ttl: 300, * records: [ptfeService.dnsEntries[0].dns_name], * }); * ``` * * > **NOTE The `dnsEntry` output is a list of maps:** This provider interpolation support for lists of maps requires the `lookup` and `[]` until full support of lists of maps is available * * ## Import * * ### Identity Schema * * #### Required * * * `id` - (String) ID of the VPC endpoint. * * #### Optional * * * `accountId` (String) AWS Account where this resource is managed. * * `region` (String) Region where this resource is managed. * * Using `pulumi import`, import VPC Endpoints using the VPC endpoint `id`. For example: * * ```sh * $ pulumi import aws:ec2/vpcEndpoint:VpcEndpoint example vpce-3ecf2a57 * ``` */ interface VpcEndpointSpecArgs { /** * Accept the VPC endpoint (the VPC endpoint and service need to be in the same AWS account). */ autoAccept?: boolean; /** * The DNS options for the endpoint. See dnsOptions below. */ dnsOptions?: pulumi.Input; /** * The IP address type for the endpoint. Valid values are `ipv4`, `dualstack`, and `ipv6`. */ ipAddressType?: pulumi.Input; /** * A policy to attach to the endpoint that controls access to the service. This is a JSON formatted string. Defaults to full access. All `Gateway` and some `Interface` endpoints support policies - see the [relevant AWS documentation](https://docs.aws.amazon.com/vpc/latest/userguide/vpc-endpoints-access.html) for more details. */ policy?: pulumi.Input; /** * Whether or not to associate a private hosted zone with the specified VPC. Applicable for endpoints of type Interface. Defaults to `false`. */ privateDnsEnabled?: boolean; /** * Region where this resource will be [managed](https://docs.aws.amazon.com/general/latest/gr/rande.html#regional-endpoints). Defaults to the Region set in the provider configuration. */ region?: pulumi.Input; /** * The ARN of a Resource Configuration to connect this VPC Endpoint to. Exactly one of `resourceConfigurationArn`, `serviceName` or `serviceNetworkArn` is required. */ resourceConfigurationArn?: pulumi.Input; /** * One or more route table IDs. Applicable for endpoints of type `Gateway`. */ routeTableIds?: pulumi.Input[] | undefined>; /** * The ID of one or more security groups to associate with the network interface. Applicable for endpoints of type `Interface`. * If no security groups are specified, the VPC's [default security group](https://docs.aws.amazon.com/vpc/latest/userguide/VPC_SecurityGroups.html#DefaultSecurityGroup) is associated with the endpoint. */ securityGroupIds?: pulumi.Input[] | undefined>; /** * The service name. For AWS services the service name is usually in the form `com.amazonaws..` (the SageMaker Notebook service is an exception to this rule, the service name is in the form `aws.sagemaker..notebook`). */ serviceName: string; /** * The ARN of a Service Network to connect this VPC Endpoint to. Exactly one of `resourceConfigurationArn`, `serviceName` or `serviceNetworkArn` is required. */ serviceNetworkArn?: pulumi.Input; /** * The AWS region of the VPC Endpoint Service. If specified, the VPC endpoint will connect to the service in the provided region. Applicable for endpoints of type `Interface`. */ serviceRegion?: pulumi.Input; /** * Subnet configuration for the endpoint, used to select specific IPv4 and/or IPv6 addresses to the endpoint. See subnetConfiguration below. */ subnetConfigurations?: pulumi.Input[] | undefined>; /** * The ID of one or more subnets in which to create a network interface for the endpoint. Applicable for endpoints of type `GatewayLoadBalancer` and `Interface`. Interface type endpoints cannot function without being assigned to a subnet. */ subnetIds?: pulumi.Input[] | undefined>; /** * 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.Input<{ [key: string]: pulumi.Input; } | undefined>; /** * The VPC endpoint type, `Gateway`, `GatewayLoadBalancer`,`Interface`, `Resource` or `ServiceNetwork`. Defaults to `Gateway`. */ vpcEndpointType?: pulumi.Input; } } export declare namespace ecr { /** * Simplified lifecycle policy model consisting of one or more rules that determine which images in a repository should be expired. See https://docs.aws.amazon.com/AmazonECR/latest/userguide/lifecycle_policy_examples.html for more details. */ interface LifecyclePolicyArgs { /** * Specifies the rules to determine how images should be retired from this repository. Rules are ordered from lowest priority to highest. If there is a rule with a `selection` value of `any`, then it will have the highest priority. */ rules?: pulumi.Input[] | undefined>; /** * Skips creation of the policy if set to `true`. */ skip?: boolean; } /** * A lifecycle policy rule that determine which images in a repository should be expired. */ interface LifecyclePolicyRuleArgs { /** * Describes the purpose of a rule within a lifecycle policy. */ description?: pulumi.Input; /** * The maximum age limit (in days) for your images. Either [maximumNumberOfImages] or [maximumAgeLimit] must be provided. */ maximumAgeLimit?: pulumi.Input; /** * The maximum number of images that you want to retain in your repository. Either [maximumNumberOfImages] or [maximumAgeLimit] must be provided. */ maximumNumberOfImages?: pulumi.Input; /** * A list of image tag prefixes on which to take action with your lifecycle policy. Only used if you specified "tagStatus": "tagged". For example, if your images are tagged as prod, prod1, prod2, and so on, you would use the tag prefix prod to specify all of them. If you specify multiple tags, only the images with all specified tags are selected. */ tagPrefixList?: pulumi.Input[] | undefined>; /** * Determines whether the lifecycle policy rule that you are adding specifies a tag for an image. Acceptable options are tagged, untagged, or any. If you specify any, then all images have the rule evaluated against them. If you specify tagged, then you must also specify a tagPrefixList value. If you specify untagged, then you must omit tagPrefixList. */ tagStatus: pulumi.Input; } } export declare namespace ecs { /** * Create a TaskDefinition resource with the given unique name, arguments, and options. * Creates required log-group and task & execution roles. * Presents required Service load balancers if target group included in port mappings. */ interface EC2ServiceTaskDefinitionArgs { /** * Single container to make a TaskDefinition from. Useful for simple cases where there aren't * multiple containers, especially when creating a TaskDefinition to call [run] on. * * Either [container] or [containers] must be provided. */ container?: inputs.ecs.TaskDefinitionContainerDefinitionArgs; /** * All the containers to make a TaskDefinition from. Useful when creating a Service that will * contain many containers within. * * Either [container] or [containers] must be provided. */ containers?: { [key: string]: inputs.ecs.TaskDefinitionContainerDefinitionArgs; }; /** * The number of cpu units used by the task. If not provided, a default will be computed based on the cumulative needs specified by [containerDefinitions] */ cpu?: pulumi.Input; /** * Enables fault injection and allows for fault injection requests to be accepted from the task's containers. Default is `false`. */ enableFaultInjection?: pulumi.Input; /** * The amount of ephemeral storage to allocate for the task. This parameter is used to expand the total amount of ephemeral storage available, beyond the default amount, for tasks hosted on AWS Fargate. See Ephemeral Storage. */ ephemeralStorage?: pulumi.Input; /** * The execution role that the Amazon ECS container agent and the Docker daemon can assume. * Will be created automatically if not defined. */ executionRole?: inputs.awsx.DefaultRoleWithPolicyArgs; /** * An optional unique name for your task definition. If not specified, then a default will be created. */ family?: pulumi.Input; /** * IPC resource namespace to be used for the containers in the task. Valid values: `host`, `task`, `none`. */ ipcMode?: pulumi.Input; /** * A set of volume blocks that containers in your task may use. */ logGroup?: inputs.awsx.DefaultLogGroupArgs; /** * The amount (in MiB) of memory used by the task. If not provided, a default will be computed * based on the cumulative needs specified by [containerDefinitions] */ memory?: pulumi.Input; /** * Docker networking mode to use for the containers in the task. Valid values: `awsvpc`, `bridge`, `host`, and `none`. */ networkMode?: pulumi.Input; /** * Process namespace to use for the containers in the task. Valid values: host` , `task`. */ pidMode?: pulumi.Input; /** * Configuration block for rules that are taken into consideration during task placement. Maximum number of `placementConstraints` is `10`. Detailed below. */ placementConstraints?: pulumi.Input[] | undefined>; /** * Configuration block for the App Mesh proxy. Detailed below. */ proxyConfiguration?: pulumi.Input; /** * Region where this resource will be [managed](https://docs.aws.amazon.com/general/latest/gr/rande.html#regional-endpoints). Defaults to the Region set in the provider configuration. */ region?: pulumi.Input; /** * Configuration block for runtimePlatform that containers in your task may use. */ runtimePlatform?: pulumi.Input; /** * Whether to retain the old revision when the resource is destroyed or replacement is necessary. Default is `false`. */ skipDestroy?: pulumi.Input; /** * Key-value map of resource tags. If configured with a provider `defaultTags` configuration block present, tags with matching keys will overwrite those defined at the provider-level. */ tags?: pulumi.Input<{ [key: string]: pulumi.Input; } | undefined>; /** * IAM role that allows your Amazon ECS container task to make calls to other AWS services. * Will be created automatically if not defined. */ taskRole?: inputs.awsx.DefaultRoleWithPolicyArgs; /** * Whether should track latest `ACTIVE` task definition on AWS or the one created with the resource stored in state. Default is `false`. Useful in the event the task definition is modified outside of this resource. */ trackLatest?: pulumi.Input; /** * Repeatable configuration block for volumes that containers in your task may use. Detailed below. * * > **NOTE:** Proper escaping is required for JSON field values containing quotes (`"`) such as `environment` values. If directly setting the JSON, they should be escaped as `\"` in the JSON, e.g., `"value": "I \"love\" escaped quotes"`. If using a variable value, they should be escaped as `\\\"` in the variable, e.g., `value = "I \\\"love\\\" escaped quotes"` in the variable and `"value": "${var.myvariable}"` in the JSON. * * > **Note:** Fault injection only works with tasks using the `awsvpc` or `host` network modes. Fault injection isn't available on Windows. */ volumes?: pulumi.Input[] | undefined>; } /** * Create a TaskDefinition resource with the given unique name, arguments, and options. * Creates required log-group and task & execution roles. * Presents required Service load balancers if target group included in port mappings. */ interface FargateServiceTaskDefinitionArgs { /** * Single container to make a TaskDefinition from. Useful for simple cases where there aren't * multiple containers, especially when creating a TaskDefinition to call [run] on. * * Either [container] or [containers] must be provided. */ container?: inputs.ecs.TaskDefinitionContainerDefinitionArgs; /** * All the containers to make a TaskDefinition from. Useful when creating a Service that will * contain many containers within. * * Either [container] or [containers] must be provided. */ containers?: { [key: string]: inputs.ecs.TaskDefinitionContainerDefinitionArgs; }; /** * The number of cpu units used by the task. If not provided, a default will be computed based on the cumulative needs specified by [containerDefinitions] */ cpu?: pulumi.Input; /** * Enables fault injection and allows for fault injection requests to be accepted from the task's containers. Default is `false`. */ enableFaultInjection?: pulumi.Input; /** * The amount of ephemeral storage to allocate for the task. This parameter is used to expand the total amount of ephemeral storage available, beyond the default amount, for tasks hosted on AWS Fargate. See Ephemeral Storage. */ ephemeralStorage?: pulumi.Input; /** * The execution role that the Amazon ECS container agent and the Docker daemon can assume. * Will be created automatically if not defined. */ executionRole?: inputs.awsx.DefaultRoleWithPolicyArgs; /** * An optional unique name for your task definition. If not specified, then a default will be created. */ family?: pulumi.Input; /** * IPC resource namespace to be used for the containers in the task. Valid values: `host`, `task`, `none`. */ ipcMode?: pulumi.Input; /** * A set of volume blocks that containers in your task may use. */ logGroup?: inputs.awsx.DefaultLogGroupArgs; /** * The amount (in MiB) of memory used by the task. If not provided, a default will be computed * based on the cumulative needs specified by [containerDefinitions] */ memory?: pulumi.Input; /** * Process namespace to use for the containers in the task. Valid values: host` , `task`. */ pidMode?: pulumi.Input; /** * Configuration block for rules that are taken into consideration during task placement. Maximum number of `placementConstraints` is `10`. Detailed below. */ placementConstraints?: pulumi.Input[] | undefined>; /** * Configuration block for the App Mesh proxy. Detailed below. */ proxyConfiguration?: pulumi.Input; /** * Region where this resource will be [managed](https://docs.aws.amazon.com/general/latest/gr/rande.html#regional-endpoints). Defaults to the Region set in the provider configuration. */ region?: pulumi.Input; /** * Configuration block for runtimePlatform that containers in your task may use. */ runtimePlatform?: pulumi.Input; /** * Whether to retain the old revision when the resource is destroyed or replacement is necessary. Default is `false`. */ skipDestroy?: pulumi.Input; /** * Key-value map of resource tags. If configured with a provider `defaultTags` configuration block present, tags with matching keys will overwrite those defined at the provider-level. */ tags?: pulumi.Input<{ [key: string]: pulumi.Input; } | undefined>; /** * IAM role that allows your Amazon ECS container task to make calls to other AWS services. * Will be created automatically if not defined. */ taskRole?: inputs.awsx.DefaultRoleWithPolicyArgs; /** * Whether should track latest `ACTIVE` task definition on AWS or the one created with the resource stored in state. Default is `false`. Useful in the event the task definition is modified outside of this resource. */ trackLatest?: pulumi.Input; /** * Repeatable configuration block for volumes that containers in your task may use. Detailed below. * * > **NOTE:** Proper escaping is required for JSON field values containing quotes (`"`) such as `environment` values. If directly setting the JSON, they should be escaped as `\"` in the JSON, e.g., `"value": "I \"love\" escaped quotes"`. If using a variable value, they should be escaped as `\\\"` in the variable, e.g., `value = "I \\\"love\\\" escaped quotes"` in the variable and `"value": "${var.myvariable}"` in the JSON. * * > **Note:** Fault injection only works with tasks using the `awsvpc` or `host` network modes. Fault injection isn't available on Windows. */ volumes?: pulumi.Input[] | undefined>; } /** * List of container definitions that are passed to the Docker daemon on a container instance */ interface TaskDefinitionContainerDefinitionArgs { command?: pulumi.Input[] | undefined>; cpu?: pulumi.Input; dependsOn?: pulumi.Input[] | undefined>; disableNetworking?: pulumi.Input; dnsSearchDomains?: pulumi.Input[] | undefined>; dnsServers?: pulumi.Input[] | undefined>; dockerLabels?: any | undefined; dockerSecurityOptions?: pulumi.Input[] | undefined>; entryPoint?: pulumi.Input[] | undefined>; /** * The environment variables to pass to a container */ environment?: pulumi.Input[] | undefined>; /** * The list of one or more files that contain the environment variables to pass to a container */ environmentFiles?: pulumi.Input[] | undefined>; essential?: pulumi.Input; extraHosts?: pulumi.Input[] | undefined>; firelensConfiguration?: pulumi.Input; healthCheck?: pulumi.Input; hostname?: pulumi.Input; /** * The image used to start a container. This string is passed directly to the Docker daemon. */ image: pulumi.Input; interactive?: pulumi.Input; links?: pulumi.Input[] | undefined>; linuxParameters?: pulumi.Input; logConfiguration?: pulumi.Input; /** * The amount (in MiB) of memory to present to the container. If your container attempts to exceed the memory specified here, the container is killed. */ memory?: pulumi.Input; memoryReservation?: pulumi.Input; mountPoints?: pulumi.Input[] | undefined>; /** * The name of a container. Up to 255 letters (uppercase and lowercase), numbers, hyphens, and underscores are allowed */ name: pulumi.Input; /** * Port mappings allow containers to access ports on the host container instance to send or receive traffic. */ portMappings?: pulumi.Input[] | undefined>; privileged?: pulumi.Input; pseudoTerminal?: pulumi.Input; readonlyRootFilesystem?: pulumi.Input; repositoryCredentials?: pulumi.Input; resourceRequirements?: pulumi.Input[] | undefined>; secrets?: pulumi.Input[] | undefined>; startTimeout?: pulumi.Input; stopTimeout?: pulumi.Input; systemControls?: pulumi.Input[] | undefined>; ulimits?: pulumi.Input[] | undefined>; user?: pulumi.Input; volumesFrom?: pulumi.Input[] | undefined>; workingDirectory?: pulumi.Input; } interface TaskDefinitionContainerDependencyArgs { condition?: pulumi.Input; containerName?: pulumi.Input; } interface TaskDefinitionDeviceArgs { containerPath?: pulumi.Input; hostPath?: pulumi.Input; permissions?: pulumi.Input[] | undefined>; } interface TaskDefinitionEnvironmentFileArgs { type?: pulumi.Input; value?: pulumi.Input; } interface TaskDefinitionFirelensConfigurationArgs { options?: any | undefined; type?: pulumi.Input; } /** * The health check command and associated configuration parameters for the container. */ interface TaskDefinitionHealthCheckArgs { /** * A string array representing the command that the container runs to determine if it is healthy. */ command?: pulumi.Input[] | undefined>; /** * The time period in seconds between each health check execution. You may specify between 5 and 300 seconds. The default value is 30 seconds. */ interval?: pulumi.Input; /** * The number of times to retry a failed health check before the container is considered unhealthy. You may specify between 1 and 10 retries. The default value is three retries. */ retries?: pulumi.Input; /** * The optional grace period within which to provide containers time to bootstrap before failed health checks count towards the maximum number of retries. You may specify between 0 and 300 seconds. The startPeriod is disabled by default. */ startPeriod?: pulumi.Input; /** * The time period in seconds to wait for a health check to succeed before it is considered a failure. You may specify between 2 and 60 seconds. The default value is 5 seconds. */ timeout?: pulumi.Input; } interface TaskDefinitionHostEntryArgs { hostname?: pulumi.Input; ipAddress?: pulumi.Input; } interface TaskDefinitionKernelCapabilitiesArgs { add?: pulumi.Input[] | undefined>; drop?: pulumi.Input[] | undefined>; } interface TaskDefinitionKeyValuePairArgs { name?: pulumi.Input; value?: pulumi.Input; } interface TaskDefinitionLinuxParametersArgs { capabilities?: pulumi.Input; devices?: pulumi.Input[] | undefined>; initProcessEnabled?: pulumi.Input; maxSwap?: pulumi.Input; sharedMemorySize?: pulumi.Input; swappiness?: pulumi.Input; tmpfs?: pulumi.Input[] | undefined>; } interface TaskDefinitionLogConfigurationArgs { logDriver: pulumi.Input; options?: any | undefined; secretOptions?: pulumi.Input[] | undefined>; } interface TaskDefinitionMountPointArgs { containerPath?: pulumi.Input; readOnly?: pulumi.Input; sourceVolume?: pulumi.Input; } interface TaskDefinitionPortMappingArgs { appProtocol?: pulumi.Input; containerPort?: pulumi.Input; containerPortRange?: pulumi.Input; hostPort?: pulumi.Input; name?: pulumi.Input; protocol?: pulumi.Input; targetGroup?: pulumi.Input; } interface TaskDefinitionRepositoryCredentialsArgs { credentialsParameter?: pulumi.Input; } interface TaskDefinitionResourceRequirementArgs { type: pulumi.Input; value: pulumi.Input; } interface TaskDefinitionSecretArgs { name: pulumi.Input; valueFrom: pulumi.Input; } interface TaskDefinitionSystemControlArgs { namespace?: pulumi.Input; value?: pulumi.Input; } interface TaskDefinitionTmpfsArgs { containerPath?: pulumi.Input; mountOptions?: pulumi.Input[] | undefined>; size: pulumi.Input; } interface TaskDefinitionUlimitArgs { hardLimit: pulumi.Input; name: pulumi.Input; softLimit: pulumi.Input; } interface TaskDefinitionVolumeFromArgs { readOnly?: pulumi.Input; sourceContainer?: pulumi.Input; } } export declare namespace lb { /** * Provides a Load Balancer Listener resource. * * > **Note:** `aws.alb.Listener` is known as `aws.lb.Listener`. The functionality is identical. * * ## Example Usage * * ### Forward Action * * ```typescript * import * as pulumi from "@pulumi/pulumi"; * import * as aws from "@pulumi/aws"; * * const frontEnd = new aws.lb.LoadBalancer("front_end", {}); * const frontEndTargetGroup = new aws.lb.TargetGroup("front_end", {}); * const frontEndListener = new aws.lb.Listener("front_end", { * loadBalancerArn: frontEnd.arn, * port: 443, * protocol: "HTTPS", * sslPolicy: "ELBSecurityPolicy-2016-08", * certificateArn: "arn:aws:iam::187416307283:server-certificate/test_cert_rab3wuqwgja25ct3n4jdj2tzu4", * defaultActions: [{ * type: "forward", * targetGroupArn: frontEndTargetGroup.arn, * }], * }); * ``` * * With weighted target groups: * * ```typescript * import * as pulumi from "@pulumi/pulumi"; * import * as aws from "@pulumi/aws"; * * const frontEnd = new aws.lb.LoadBalancer("front_end", {}); * const frontEndBlue = new aws.lb.TargetGroup("front_end_blue", {}); * const frontEndGreen = new aws.lb.TargetGroup("front_end_green", {}); * const frontEndListener = new aws.lb.Listener("front_end", { * loadBalancerArn: frontEnd.arn, * port: 443, * protocol: "HTTPS", * sslPolicy: "ELBSecurityPolicy-2016-08", * certificateArn: "arn:aws:iam::187416307283:server-certificate/test_cert_rab3wuqwgja25ct3n4jdj2tzu4", * defaultActions: [{ * type: "forward", * forward: { * targetGroups: [ * { * arn: frontEndBlue.arn, * weight: 100, * }, * { * arn: frontEndGreen.arn, * weight: 0, * }, * ], * }, * }], * }); * ``` * * To a NLB: * * ```typescript * import * as pulumi from "@pulumi/pulumi"; * import * as aws from "@pulumi/aws"; * * const frontEnd = new aws.lb.Listener("front_end", { * loadBalancerArn: frontEndAwsLb.arn, * port: 443, * protocol: "TLS", * sslPolicy: "ELBSecurityPolicy-2016-08", * certificateArn: "arn:aws:iam::187416307283:server-certificate/test_cert_rab3wuqwgja25ct3n4jdj2tzu4", * alpnPolicy: "HTTP2Preferred", * defaultActions: [{ * type: "forward", * targetGroupArn: frontEndAwsLbTargetGroup.arn, * }], * }); * ``` * * ### Redirect Action * * ```typescript * import * as pulumi from "@pulumi/pulumi"; * import * as aws from "@pulumi/aws"; * * const frontEnd = new aws.lb.LoadBalancer("front_end", {}); * const frontEndListener = new aws.lb.Listener("front_end", { * loadBalancerArn: frontEnd.arn, * port: 80, * protocol: "HTTP", * defaultActions: [{ * type: "redirect", * redirect: { * port: "443", * protocol: "HTTPS", * statusCode: "HTTP_301", * }, * }], * }); * ``` * * ### Fixed-response Action * * ```typescript * import * as pulumi from "@pulumi/pulumi"; * import * as aws from "@pulumi/aws"; * * const frontEnd = new aws.lb.LoadBalancer("front_end", {}); * const frontEndListener = new aws.lb.Listener("front_end", { * loadBalancerArn: frontEnd.arn, * port: 80, * protocol: "HTTP", * defaultActions: [{ * type: "fixed-response", * fixedResponse: { * contentType: "text/plain", * messageBody: "Fixed response content", * statusCode: "200", * }, * }], * }); * ``` * * ### Authenticate-cognito Action * * ```typescript * import * as pulumi from "@pulumi/pulumi"; * import * as aws from "@pulumi/aws"; * * const frontEnd = new aws.lb.LoadBalancer("front_end", {}); * const frontEndTargetGroup = new aws.lb.TargetGroup("front_end", {}); * const pool = new aws.cognito.UserPool("pool", {}); * const client = new aws.cognito.UserPoolClient("client", {}); * const domain = new aws.cognito.UserPoolDomain("domain", {}); * const frontEndListener = new aws.lb.Listener("front_end", { * loadBalancerArn: frontEnd.arn, * port: 80, * protocol: "HTTP", * defaultActions: [ * { * type: "authenticate-cognito", * authenticateCognito: { * userPoolArn: pool.arn, * userPoolClientId: client.id, * userPoolDomain: domain.domain, * }, * }, * { * type: "forward", * targetGroupArn: frontEndTargetGroup.arn, * }, * ], * }); * ``` * * ### Authenticate-OIDC Action * * ```typescript * import * as pulumi from "@pulumi/pulumi"; * import * as aws from "@pulumi/aws"; * * const frontEnd = new aws.lb.LoadBalancer("front_end", {}); * const frontEndTargetGroup = new aws.lb.TargetGroup("front_end", {}); * const frontEndListener = new aws.lb.Listener("front_end", { * loadBalancerArn: frontEnd.arn, * port: 80, * protocol: "HTTP", * defaultActions: [ * { * type: "authenticate-oidc", * authenticateOidc: { * authorizationEndpoint: "https://example.com/authorization_endpoint", * clientId: "client_id", * clientSecret: "client_secret", * issuer: "https://example.com", * tokenEndpoint: "https://example.com/token_endpoint", * userInfoEndpoint: "https://example.com/user_info_endpoint", * }, * }, * { * type: "forward", * targetGroupArn: frontEndTargetGroup.arn, * }, * ], * }); * ``` * * ### JWT Validation Action * * ```typescript * import * as pulumi from "@pulumi/pulumi"; * import * as aws from "@pulumi/aws"; * * const test = new aws.lb.Listener("test", { * loadBalancerArn: testAwsLb.id, * protocol: "HTTPS", * port: 443, * sslPolicy: "ELBSecurityPolicy-2016-08", * certificateArn: testAwsIamServerCertificate.arn, * defaultActions: [ * { * type: "jwt-validation", * jwtValidation: { * issuer: "https://example.com", * jwksEndpoint: "https://example.com/.well-known/jwks.json", * additionalClaims: [ * { * format: "string-array", * name: "claim_name1", * values: [ * "value1", * "value2", * ], * }, * { * format: "single-string", * name: "claim_name2", * values: ["value1"], * }, * ], * }, * }, * { * targetGroupArn: testAwsLbTargetGroup.id, * type: "forward", * }, * ], * }); * ``` * * ### Gateway Load Balancer Listener * * ```typescript * import * as pulumi from "@pulumi/pulumi"; * import * as aws from "@pulumi/aws"; * * const example = new aws.lb.LoadBalancer("example", { * loadBalancerType: "gateway", * name: "example", * subnetMappings: [{ * subnetId: exampleAwsSubnet.id, * }], * }); * const exampleTargetGroup = new aws.lb.TargetGroup("example", { * name: "example", * port: 6081, * protocol: "GENEVE", * vpcId: exampleAwsVpc.id, * healthCheck: { * port: "80", * protocol: "HTTP", * }, * }); * const exampleListener = new aws.lb.Listener("example", { * loadBalancerArn: example.id, * defaultActions: [{ * targetGroupArn: exampleTargetGroup.id, * type: "forward", * }], * }); * ``` * * ### Mutual TLS Authentication * * ```typescript * import * as pulumi from "@pulumi/pulumi"; * import * as aws from "@pulumi/aws"; * * const example = new aws.lb.LoadBalancer("example", {loadBalancerType: "application"}); * const exampleTargetGroup = new aws.lb.TargetGroup("example", {}); * const exampleListener = new aws.lb.Listener("example", { * loadBalancerArn: example.id, * defaultActions: [{ * targetGroupArn: exampleTargetGroup.id, * type: "forward", * }], * mutualAuthentication: { * mode: "verify", * trustStoreArn: "...", * }, * }); * ``` * * ## Import * * ### Identity Schema * * #### Required * * - `arn` (String) Amazon Resource Name (ARN) of the load balancer listener. * * Using `pulumi import`, import listeners using their ARN. For example: * * ```sh * $ pulumi import aws:lb/listener:Listener front_end arn:aws:elasticloadbalancing:us-west-2:187416307283:listener/app/front-end-alb/8e4497da625e2d8a/9ab28ade35828f96 * ``` */ interface ListenerArgs { /** * Name of the Application-Layer Protocol Negotiation (ALPN) policy. Can be set if `protocol` is `TLS`. Valid values are `HTTP1Only`, `HTTP2Only`, `HTTP2Optional`, `HTTP2Preferred`, and `None`. */ alpnPolicy?: pulumi.Input; /** * ARN of the default SSL server certificate. Exactly one certificate is required if the protocol is HTTPS. For adding additional SSL certificates, see the `aws.lb.ListenerCertificate` resource. */ certificateArn?: pulumi.Input; /** * Configuration block for default actions. See below. */ defaultActions?: pulumi.Input[] | undefined>; /** * The mutual authentication configuration information. See below. */ mutualAuthentication?: pulumi.Input; /** * Port on which the load balancer is listening. Not valid for Gateway Load Balancers. */ port?: pulumi.Input; /** * Protocol for connections from clients to the load balancer. For Application Load Balancers, valid values are `HTTP` and `HTTPS`, with a default of `HTTP`. For Network Load Balancers, valid values are `TCP`, `TLS`, `UDP`, `TCP_UDP`, `QUIC`, and `TCP_QUIC`. Not valid to use `UDP` or `TCP_UDP` if dual-stack mode is enabled. Not valid to use `QUIC` or `TCP_QUIC` if security groups are configured or dual-stack mode is enabled. Not valid for Gateway Load Balancers. */ protocol?: pulumi.Input; /** * Region where this resource will be [managed](https://docs.aws.amazon.com/general/latest/gr/rande.html#regional-endpoints). Defaults to the Region set in the provider configuration. */ region?: pulumi.Input; /** * Enables you to modify the header name of the `X-Amzn-Mtls-Clientcert` HTTP request header. Can only be set if protocol is `HTTPS` for Application Load Balancers. */ routingHttpRequestXAmznMtlsClientcertHeaderName?: pulumi.Input; /** * Enables you to modify the header name of the `X-Amzn-Mtls-Clientcert-Issuer` HTTP request header. Can only be set if protocol is `HTTPS` for Application Load Balancers. */ routingHttpRequestXAmznMtlsClientcertIssuerHeaderName?: pulumi.Input; /** * Enables you to modify the header name of the `X-Amzn-Mtls-Clientcert-Leaf` HTTP request header. Can only be set if protocol is `HTTPS` for Application Load Balancers. */ routingHttpRequestXAmznMtlsClientcertLeafHeaderName?: pulumi.Input; /** * Enables you to modify the header name of the `X-Amzn-Mtls-Clientcert-Serial-Number` HTTP request header. Can only be set if protocol is `HTTPS` for Application Load Balancers. */ routingHttpRequestXAmznMtlsClientcertSerialNumberHeaderName?: pulumi.Input; /** * Enables you to modify the header name of the `X-Amzn-Mtls-Clientcert-Subject` HTTP request header. Can only be set if protocol is `HTTPS` for Application Load Balancers. */ routingHttpRequestXAmznMtlsClientcertSubjectHeaderName?: pulumi.Input; /** * Enables you to modify the header name of the `X-Amzn-Mtls-Clientcert-Validity` HTTP request header. Can only be set if protocol is `HTTPS` for Application Load Balancers. */ routingHttpRequestXAmznMtlsClientcertValidityHeaderName?: pulumi.Input; /** * Enables you to modify the header name of the `X-Amzn-Tls-Cipher-Suite` HTTP request header. Can only be set if protocol is `HTTPS` for Application Load Balancers. */ routingHttpRequestXAmznTlsCipherSuiteHeaderName?: pulumi.Input; /** * Enables you to modify the header name of the `X-Amzn-Tls-Version` HTTP request header. Can only be set if protocol is `HTTPS` for Application Load Balancers. */ routingHttpRequestXAmznTlsVersionHeaderName?: pulumi.Input; /** * Specifies which headers the browser can expose to the requesting client. Can only be set if protocol is `HTTP` or `HTTPS` for Application Load Balancers. Not supported for Network Load Balancer, or with a Gateway Load Balancer. The only valid value is `true`. */ routingHttpResponseAccessControlAllowCredentialsHeaderValue?: pulumi.Input; /** * Specifies which headers can be used during the request. Can only be set if protocol is `HTTP` or `HTTPS` for Application Load Balancers. Not supported for Network Load Balancer, or with a Gateway Load Balancer. Valid values are `*`, `Accept`, `Accept-Language`, `Cache-Control`, `Content-Language`, `Content-Length`, `Content-Type`, `Expires`, `Last-Modified`, `Pragma`. Dependent on your use-case other headers can be exposed and then set as a value consult the Access-Control-Allow-Headers documentation. */ routingHttpResponseAccessControlAllowHeadersHeaderValue?: pulumi.Input; /** * Set which HTTP methods are allowed when accessing the server from a different origin. Can only be set if protocol is `HTTP` or `HTTPS` for Application Load Balancers. Not supported for Network Load Balancer, or with a Gateway Load Balancer. Valid values are `GET`, `HEAD`, `POST`, `DELETE`, `CONNECT`, `OPTIONS`, `TRACE` or `PATCH`. */ routingHttpResponseAccessControlAllowMethodsHeaderValue?: pulumi.Input; /** * Specifies which origins are allowed to access the server. Can only be set if protocol is `HTTP` or `HTTPS` for Application Load Balancers. Not supported for Network Load Balancer, or with a Gateway Load Balancer. A valid value is a URI, eg: `https://example.com`. */ routingHttpResponseAccessControlAllowOriginHeaderValue?: pulumi.Input; /** * Specifies whether the browser should include credentials such as cookies or authentication when making requests. Can only be set if protocol is `HTTP` or `HTTPS` for Application Load Balancers. Not supported for Network Load Balancer, or with a Gateway Load Balancer. Valid values are `*`, `Cache-Control`, `Content-Language`, `Content-Length`, `Content-Type`, `Expires`, `Last-Modified`, or `Pragma`. Dependent on your use-case other headers can be exposed, consult the Access-Control-Expose-Headers documentation. */ routingHttpResponseAccessControlExposeHeadersHeaderValue?: pulumi.Input; /** * Specifies how long the results of a preflight request can be cached, in seconds. Can only be set if protocol is `HTTP` or `HTTPS` for Application Load Balancers. Not supported for Network Load Balancer, or with a Gateway Load Balancer. Valid values are between `0` and `86400`. This value is browser specific, consult the Access-Control-Max-Age documentation. */ routingHttpResponseAccessControlMaxAgeHeaderValue?: pulumi.Input; /** * Specifies restrictions enforced by the browser to help minimize the risk of certain types of security threats. Can only be set if protocol is `HTTP` or `HTTPS` for Application Load Balancers. Not supported for Network Load Balancer, or with a Gateway Load Balancer. Values for this are extensive, and can be impactful when set, consult Content-Security-Policy documentation. */ routingHttpResponseContentSecurityPolicyHeaderValue?: pulumi.Input; /** * Enables you to allow or remove the HTTP response server header. Can only be set if protocol is `HTTP` or `HTTPS` for Application Load Balancers. Not supported for Network Load Balancer, or with a Gateway Load Balancer. Valid values are `true` or `false`. */ routingHttpResponseServerEnabled?: pulumi.Input; /** * Informs browsers that the site should only be accessed using HTTPS, and that any future attempts to access it using HTTP should automatically be converted to HTTPS. Default values are `max-age=31536000; includeSubDomains; preload` consult the Strict-Transport-Security documentation for further details. */ routingHttpResponseStrictTransportSecurityHeaderValue?: pulumi.Input; /** * Indicates whether the MIME types advertised in the Content-Type headers should be followed and not be changed. Can only be set if protocol is `HTTP` or `HTTPS` for Application Load Balancers. Not supported for Network Load Balancer, or with a Gateway Load Balancer. The only valid value is `nosniff`. */ routingHttpResponseXContentTypeOptionsHeaderValue?: pulumi.Input; /** * Indicates whether the browser is allowed to render a page in a frame, iframe, embed or object. Can only be set if protocol is `HTTP` or `HTTPS` for Application Load Balancers. Not supported for Network Load Balancer, or with a Gateway Load Balancer. The only valid values are `DENY`, `SAMEORIGIN`, or `ALLOW-FROM https://example.com`. */ routingHttpResponseXFrameOptionsHeaderValue?: pulumi.Input; /** * Name of the SSL Policy for the listener. Required if `protocol` is `HTTPS` or `TLS`. Default is `ELBSecurityPolicy-2016-08`. */ sslPolicy?: pulumi.Input; /** * 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. * * > **Note::** When a `Name` key is specified in the map, the AWS Console maps the value to the `Name Tag` column value inside the `Listener Rules` table within a specific load balancer listener page. Otherwise, the value resolves to `Default`. */ tags?: pulumi.Input<{ [key: string]: pulumi.Input; } | undefined>; /** * TCP idle timeout value in seconds. Can only be set if protocol is `TCP` on Network Load Balancer, or with a Gateway Load Balancer. Not supported for Application Load Balancers. Valid values are between `60` and `6000` inclusive. Default: `350`. */ tcpIdleTimeoutSeconds?: pulumi.Input; } /** * Provides a Target Group resource for use with Load Balancer resources. * * > **Note:** `aws.alb.TargetGroup` is known as `aws.lb.TargetGroup`. The functionality is identical. * * ## Example Usage * * ### Instance Target Group * * ```typescript * import * as pulumi from "@pulumi/pulumi"; * import * as aws from "@pulumi/aws"; * * const main = new aws.ec2.Vpc("main", {cidrBlock: "10.0.0.0/16"}); * const test = new aws.lb.TargetGroup("test", { * name: "tf-example-lb-tg", * port: 80, * protocol: "HTTP", * vpcId: main.id, * }); * ``` * * ### IP Target Group * * ```typescript * import * as pulumi from "@pulumi/pulumi"; * import * as aws from "@pulumi/aws"; * * const main = new aws.ec2.Vpc("main", {cidrBlock: "10.0.0.0/16"}); * const ip_example = new aws.lb.TargetGroup("ip-example", { * name: "tf-example-lb-tg", * port: 80, * protocol: "HTTP", * targetType: "ip", * vpcId: main.id, * }); * ``` * * ### Lambda Target Group * * ```typescript * import * as pulumi from "@pulumi/pulumi"; * import * as aws from "@pulumi/aws"; * * const lambda_example = new aws.lb.TargetGroup("lambda-example", { * name: "tf-example-lb-tg", * targetType: "lambda", * }); * ``` * * ### ALB Target Group * * ```typescript * import * as pulumi from "@pulumi/pulumi"; * import * as aws from "@pulumi/aws"; * * const alb_example = new aws.lb.TargetGroup("alb-example", { * name: "tf-example-lb-alb-tg", * targetType: "alb", * port: 80, * protocol: "TCP", * vpcId: main.id, * }); * ``` * * ### Target group with unhealthy connection termination disabled * * ```typescript * import * as pulumi from "@pulumi/pulumi"; * import * as aws from "@pulumi/aws"; * * const tcp_example = new aws.lb.TargetGroup("tcp-example", { * name: "tf-example-lb-nlb-tg", * port: 25, * protocol: "TCP", * vpcId: main.id, * targetHealthStates: [{ * enableUnhealthyConnectionTermination: false, * }], * }); * ``` * * ### Target group with health requirements * * ```typescript * import * as pulumi from "@pulumi/pulumi"; * import * as aws from "@pulumi/aws"; * * const tcp_example = new aws.lb.TargetGroup("tcp-example", { * name: "tf-example-lb-nlb-tg", * port: 80, * protocol: "TCP", * vpcId: main.id, * targetGroupHealth: { * dnsFailover: { * minimumHealthyTargetsCount: "1", * minimumHealthyTargetsPercentage: "off", * }, * unhealthyStateRouting: { * minimumHealthyTargetsCount: 1, * minimumHealthyTargetsPercentage: "off", * }, * }, * }); * ``` * * ## Import * * ### Identity Schema * * #### Required * * - `arn` (String) Amazon Resource Name (ARN) of the target group. * * Using `pulumi import`, import Target Groups using their ARN. For example: * * ```sh * $ pulumi import aws:lb/targetGroup:TargetGroup app_front_end arn:aws:elasticloadbalancing:us-west-2:187416307283:targetgroup/app-front-end/20cfe21448b66314 * ``` */ interface TargetGroupArgs { /** * Whether to terminate connections at the end of the deregistration timeout on Network Load Balancers. See [doc](https://docs.aws.amazon.com/elasticloadbalancing/latest/network/load-balancer-target-groups.html#deregistration-delay) for more information. Default is `false`. */ connectionTermination?: pulumi.Input; /** * Amount time for Elastic Load Balancing to wait before changing the state of a deregistering target from draining to unused. The range is 0-3600 seconds. The default value is 300 seconds. */ deregistrationDelay?: pulumi.Input; /** * Health Check configuration block. Detailed below. */ healthCheck?: pulumi.Input; /** * The type of IP addresses used by the target group, only supported when target type is set to `ip`. Possible values are `ipv4` or `ipv6`. */ ipAddressType?: pulumi.Input; /** * Whether the request and response headers exchanged between the load balancer and the Lambda function include arrays of values or strings. Only applies when `targetType` is `lambda`. Default is `false`. */ lambdaMultiValueHeadersEnabled?: pulumi.Input; /** * Determines how the load balancer selects targets when routing requests. Only applicable for Application Load Balancer Target Groups. The value is `roundRobin`, `leastOutstandingRequests`, or `weightedRandom`. The default is `roundRobin`. */ loadBalancingAlgorithmType?: pulumi.Input; /** * Determines whether to enable target anomaly mitigation. Target anomaly mitigation is only supported by the `weightedRandom` load balancing algorithm type. See [doc](https://docs.aws.amazon.com/elasticloadbalancing/latest/application/load-balancer-target-groups.html#automatic-target-weights) for more information. The value is `"on"` or `"off"`. The default is `"off"`. */ loadBalancingAnomalyMitigation?: pulumi.Input; /** * Indicates whether cross zone load balancing is enabled. The value is `"true"`, `"false"` or `"useLoadBalancerConfiguration"`. The default is `"useLoadBalancerConfiguration"`. */ loadBalancingCrossZoneEnabled?: pulumi.Input; /** * Name of the target group. If omitted, this provider will assign a random, unique name. This name must be unique per region per account, can have a maximum of 32 characters, must contain only alphanumeric characters or hyphens, and must not begin or end with a hyphen. */ name?: pulumi.Input; /** * Creates a unique name beginning with the specified prefix. Conflicts with `name`. Cannot be longer than 6 characters. */ namePrefix?: pulumi.Input; /** * Port on which targets receive traffic, unless overridden when registering a specific target. Required when `targetType` is `instance`, `ip` or `alb`. Does not apply when `targetType` is `lambda`. */ port?: pulumi.Input; /** * Whether client IP preservation is enabled. See [doc](https://docs.aws.amazon.com/elasticloadbalancing/latest/network/load-balancer-target-groups.html#client-ip-preservation) for more information. */ preserveClientIp?: pulumi.Input; /** * Protocol to use for routing traffic to the targets. * Should be one of `GENEVE`, `HTTP`, `HTTPS`, `TCP`, `TCP_UDP`, `TLS`, `UDP`, `QUIC`, or `TCP_QUIC`. * Required when `targetType` is `instance`, `ip`, or `alb`. * Does not apply when `targetType` is `lambda`. */ protocol?: pulumi.Input; /** * Only applicable when `protocol` is `HTTP` or `HTTPS`. The protocol version. Specify `GRPC` to send requests to targets using gRPC. Specify `HTTP2` to send requests to targets using HTTP/2. The default is `HTTP1`, which sends requests to targets using HTTP/1.1 */ protocolVersion?: pulumi.Input; /** * Whether to enable support for proxy protocol v2 on Network Load Balancers. See [doc](https://docs.aws.amazon.com/elasticloadbalancing/latest/network/load-balancer-target-groups.html#proxy-protocol) for more information. Default is `false`. */ proxyProtocolV2?: pulumi.Input; /** * Region where this resource will be [managed](https://docs.aws.amazon.com/general/latest/gr/rande.html#regional-endpoints). Defaults to the Region set in the provider configuration. */ region?: pulumi.Input; /** * Amount time for targets to warm up before the load balancer sends them a full share of requests. The range is 30-900 seconds or 0 to disable. The default value is 0 seconds. */ slowStart?: pulumi.Input; /** * Stickiness configuration block. Detailed below. */ stickiness?: pulumi.Input; /** * 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.Input<{ [key: string]: pulumi.Input; } | undefined>; /** * Port on which the target control agent and application load balancer exchange management traffic for the target optimizer feature. Only applicable for Application Load Balancer target groups when `targetType` is `instance` or `ip`. */ targetControlPort?: pulumi.Input; /** * Target failover block. Only applicable for Gateway Load Balancer target groups. See targetFailover for more information. */ targetFailovers?: pulumi.Input[] | undefined>; /** * Target health requirements block. See targetGroupHealth for more information. */ targetGroupHealth?: pulumi.Input; /** * Target health state block. Only applicable for Network Load Balancer target groups when `protocol` is `TCP` or `TLS`. See targetHealthState for more information. */ targetHealthStates?: pulumi.Input[] | undefined>; /** * Type of target that you must specify when registering targets with this target group. * See [doc](https://docs.aws.amazon.com/elasticloadbalancing/latest/APIReference/API_CreateTargetGroup.html) for supported values. * The default is `instance`. * * Note that you can't specify targets for a target group using both instance IDs and IP addresses. * * If the target type is `ip`, specify IP addresses from the subnets of the virtual private cloud (VPC) for the target group, the RFC 1918 range (10.0.0.0/8, 172.16.0.0/12, and 192.168.0.0/16), and the RFC 6598 range (100.64.0.0/10). You can't specify publicly routable IP addresses. * * Network Load Balancers do not support the `lambda` target type. * * Application Load Balancers do not support the `alb` target type. */ targetType?: pulumi.Input; /** * Identifier of the VPC in which to create the target group. Required when `targetType` is `instance`, `ip` or `alb`. Does not apply when `targetType` is `lambda`. */ vpcId?: pulumi.Input; } } //# sourceMappingURL=input.d.ts.map