UNPKG

@pulumi/aws

Version:

A Pulumi package for creating and managing Amazon Web Services (AWS) cloud resources.

142 lines 6.82 kB
"use strict"; // *** WARNING: this file was generated by pulumi-language-nodejs. *** // *** Do not edit by hand unless you're certain you know what you are doing! *** Object.defineProperty(exports, "__esModule", { value: true }); exports.TrafficMirrorFilterRule = void 0; const pulumi = require("@pulumi/pulumi"); const utilities = require("../utilities"); /** * Provides an Traffic mirror filter rule.\ * Read [limits and considerations](https://docs.aws.amazon.com/vpc/latest/mirroring/traffic-mirroring-considerations.html) for traffic mirroring * * ## Example Usage * * To create a basic traffic mirror session * * ```typescript * import * as pulumi from "@pulumi/pulumi"; * import * as aws from "@pulumi/aws"; * * const filter = new aws.ec2.TrafficMirrorFilter("filter", { * description: "traffic mirror filter - example", * networkServices: ["amazon-dns"], * }); * const ruleout = new aws.ec2.TrafficMirrorFilterRule("ruleout", { * description: "test rule", * trafficMirrorFilterId: filter.id, * destinationCidrBlock: "10.0.0.0/8", * sourceCidrBlock: "10.0.0.0/8", * ruleNumber: 1, * ruleAction: "accept", * trafficDirection: "egress", * }); * const rulein = new aws.ec2.TrafficMirrorFilterRule("rulein", { * description: "test rule", * trafficMirrorFilterId: filter.id, * destinationCidrBlock: "10.0.0.0/8", * sourceCidrBlock: "10.0.0.0/8", * ruleNumber: 1, * ruleAction: "accept", * trafficDirection: "ingress", * protocol: 6, * destinationPortRange: { * fromPort: 22, * toPort: 53, * }, * sourcePortRange: { * fromPort: 0, * toPort: 10, * }, * }); * ``` * * ## Import * * Using `pulumi import`, import traffic mirror rules using the `traffic_mirror_filter_id` and `id` separated by `:`. For example: * * ```sh * $ pulumi import aws:ec2/trafficMirrorFilterRule:TrafficMirrorFilterRule rule tmf-0fbb93ddf38198f64:tmfr-05a458f06445d0aee * ``` */ class TrafficMirrorFilterRule extends pulumi.CustomResource { /** * Get an existing TrafficMirrorFilterRule resource's state with the given name, ID, and optional extra * properties used to qualify the lookup. * * @param name The _unique_ name of the resulting resource. * @param id The _unique_ provider ID of the resource to lookup. * @param state Any extra arguments used during the lookup. * @param opts Optional settings to control the behavior of the CustomResource. */ static get(name, id, state, opts) { return new TrafficMirrorFilterRule(name, state, Object.assign(Object.assign({}, opts), { id: id })); } /** * Returns true if the given object is an instance of TrafficMirrorFilterRule. This is designed to work even * when multiple copies of the Pulumi SDK have been loaded into the same process. */ static isInstance(obj) { if (obj === undefined || obj === null) { return false; } return obj['__pulumiType'] === TrafficMirrorFilterRule.__pulumiType; } constructor(name, argsOrState, opts) { let resourceInputs = {}; opts = opts || {}; if (opts.id) { const state = argsOrState; resourceInputs["arn"] = state ? state.arn : undefined; resourceInputs["description"] = state ? state.description : undefined; resourceInputs["destinationCidrBlock"] = state ? state.destinationCidrBlock : undefined; resourceInputs["destinationPortRange"] = state ? state.destinationPortRange : undefined; resourceInputs["protocol"] = state ? state.protocol : undefined; resourceInputs["region"] = state ? state.region : undefined; resourceInputs["ruleAction"] = state ? state.ruleAction : undefined; resourceInputs["ruleNumber"] = state ? state.ruleNumber : undefined; resourceInputs["sourceCidrBlock"] = state ? state.sourceCidrBlock : undefined; resourceInputs["sourcePortRange"] = state ? state.sourcePortRange : undefined; resourceInputs["trafficDirection"] = state ? state.trafficDirection : undefined; resourceInputs["trafficMirrorFilterId"] = state ? state.trafficMirrorFilterId : undefined; } else { const args = argsOrState; if ((!args || args.destinationCidrBlock === undefined) && !opts.urn) { throw new Error("Missing required property 'destinationCidrBlock'"); } if ((!args || args.ruleAction === undefined) && !opts.urn) { throw new Error("Missing required property 'ruleAction'"); } if ((!args || args.ruleNumber === undefined) && !opts.urn) { throw new Error("Missing required property 'ruleNumber'"); } if ((!args || args.sourceCidrBlock === undefined) && !opts.urn) { throw new Error("Missing required property 'sourceCidrBlock'"); } if ((!args || args.trafficDirection === undefined) && !opts.urn) { throw new Error("Missing required property 'trafficDirection'"); } if ((!args || args.trafficMirrorFilterId === undefined) && !opts.urn) { throw new Error("Missing required property 'trafficMirrorFilterId'"); } resourceInputs["description"] = args ? args.description : undefined; resourceInputs["destinationCidrBlock"] = args ? args.destinationCidrBlock : undefined; resourceInputs["destinationPortRange"] = args ? args.destinationPortRange : undefined; resourceInputs["protocol"] = args ? args.protocol : undefined; resourceInputs["region"] = args ? args.region : undefined; resourceInputs["ruleAction"] = args ? args.ruleAction : undefined; resourceInputs["ruleNumber"] = args ? args.ruleNumber : undefined; resourceInputs["sourceCidrBlock"] = args ? args.sourceCidrBlock : undefined; resourceInputs["sourcePortRange"] = args ? args.sourcePortRange : undefined; resourceInputs["trafficDirection"] = args ? args.trafficDirection : undefined; resourceInputs["trafficMirrorFilterId"] = args ? args.trafficMirrorFilterId : undefined; resourceInputs["arn"] = undefined /*out*/; } opts = pulumi.mergeOptions(utilities.resourceOptsDefaults(), opts); super(TrafficMirrorFilterRule.__pulumiType, name, resourceInputs, opts); } } exports.TrafficMirrorFilterRule = TrafficMirrorFilterRule; /** @internal */ TrafficMirrorFilterRule.__pulumiType = 'aws:ec2/trafficMirrorFilterRule:TrafficMirrorFilterRule'; //# sourceMappingURL=trafficMirrorFilterRule.js.map