NetworkInsightsAccessScope class

Provides a Network Insights Access Scope resource. Part of the "Network Access Analyzer" service in the AWS VPC console.

Example Usage

Basic Usage

import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";

const example = new aws.ec2.NetworkInsightsAccessScope("example", {matchPaths: [{
    source: {
        resourceStatement: {
            resourceTypes: ["AWS::EC2::NetworkInterface"],
        },
    },
    destination: {
        resourceStatement: {
            resourceTypes: ["AWS::EC2::InternetGateway"],
        },
    },
}]});
import pulumi
import pulumi_aws as aws

example = aws.ec2.NetworkInsightsAccessScope("example", match_paths=[{
    "source": {
        "resource_statement": {
            "resource_types": ["AWS::EC2::NetworkInterface"],
        },
    },
    "destination": {
        "resource_statement": {
            "resource_types": ["AWS::EC2::InternetGateway"],
        },
    },
}])
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;

return await Deployment.RunAsync(() =>
{
    var example = new Aws.Ec2.NetworkInsightsAccessScope("example", new()
    {
        MatchPaths = new[]
        {
            new Aws.Ec2.Inputs.NetworkInsightsAccessScopeMatchPathArgs
            {
                Source = new Aws.Ec2.Inputs.NetworkInsightsAccessScopeMatchPathSourceArgs
                {
                    ResourceStatement = new Aws.Ec2.Inputs.NetworkInsightsAccessScopeMatchPathSourceResourceStatementArgs
                    {
                        ResourceTypes = new[]
                        {
                            "AWS::EC2::NetworkInterface",
                        },
                    },
                },
                Destination = new Aws.Ec2.Inputs.NetworkInsightsAccessScopeMatchPathDestinationArgs
                {
                    ResourceStatement = new Aws.Ec2.Inputs.NetworkInsightsAccessScopeMatchPathDestinationResourceStatementArgs
                    {
                        ResourceTypes = new[]
                        {
                            "AWS::EC2::InternetGateway",
                        },
                    },
                },
            },
        },
    });

});
package main

import (
	"github.com/pulumi/pulumi-aws/sdk/v7/go/aws/ec2"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := ec2.NewNetworkInsightsAccessScope(ctx, "example", &ec2.NetworkInsightsAccessScopeArgs{
			MatchPaths: ec2.NetworkInsightsAccessScopeMatchPathArray{
				&ec2.NetworkInsightsAccessScopeMatchPathArgs{
					Source: &ec2.NetworkInsightsAccessScopeMatchPathSourceArgs{
						ResourceStatement: &ec2.NetworkInsightsAccessScopeMatchPathSourceResourceStatementArgs{
							ResourceTypes: pulumi.StringArray{
								pulumi.String("AWS::EC2::NetworkInterface"),
							},
						},
					},
					Destination: &ec2.NetworkInsightsAccessScopeMatchPathDestinationArgs{
						ResourceStatement: &ec2.NetworkInsightsAccessScopeMatchPathDestinationResourceStatementArgs{
							ResourceTypes: pulumi.StringArray{
								pulumi.String("AWS::EC2::InternetGateway"),
							},
						},
					},
				},
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}
pulumi {
  required_providers {
    aws = {
      source = "pulumi/aws"
    }
  }
}

resource "aws_ec2_networkinsightsaccessscope" "example" {
  match_paths {
    source = {
      resource_statement = {
        resource_types = ["AWS::EC2::NetworkInterface"]
      }
    }
    destination = {
      resource_statement = {
        resource_types = ["AWS::EC2::InternetGateway"]
      }
    }
  }
}
package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.ec2.NetworkInsightsAccessScope;
import com.pulumi.aws.ec2.NetworkInsightsAccessScopeArgs;
import com.pulumi.aws.ec2.inputs.NetworkInsightsAccessScopeMatchPathArgs;
import com.pulumi.aws.ec2.inputs.NetworkInsightsAccessScopeMatchPathSourceArgs;
import com.pulumi.aws.ec2.inputs.NetworkInsightsAccessScopeMatchPathSourceResourceStatementArgs;
import com.pulumi.aws.ec2.inputs.NetworkInsightsAccessScopeMatchPathDestinationArgs;
import com.pulumi.aws.ec2.inputs.NetworkInsightsAccessScopeMatchPathDestinationResourceStatementArgs;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }

    public static void stack(Context ctx) {
        var example = new NetworkInsightsAccessScope("example", NetworkInsightsAccessScopeArgs.builder()
            .matchPaths(NetworkInsightsAccessScopeMatchPathArgs.builder()
                .source(NetworkInsightsAccessScopeMatchPathSourceArgs.builder()
                    .resourceStatement(NetworkInsightsAccessScopeMatchPathSourceResourceStatementArgs.builder()
                        .resourceTypes("AWS::EC2::NetworkInterface")
                        .build())
                    .build())
                .destination(NetworkInsightsAccessScopeMatchPathDestinationArgs.builder()
                    .resourceStatement(NetworkInsightsAccessScopeMatchPathDestinationResourceStatementArgs.builder()
                        .resourceTypes("AWS::EC2::InternetGateway")
                        .build())
                    .build())
                .build())
            .build());

    }
}
resources:
  example:
    type: aws:ec2:NetworkInsightsAccessScope
    properties:
      matchPaths:
        - source:
            resourceStatement:
              resourceTypes:
                - AWS::EC2::NetworkInterface
          destination:
            resourceStatement:
              resourceTypes:
                - AWS::EC2::InternetGateway

With Exclude Paths

import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";

const example = new aws.ec2.NetworkInsightsAccessScope("example", {
    excludePaths: [{
        source: {
            resourceStatement: {
                resourceTypes: ["AWS::EC2::InternetGateway"],
            },
        },
        throughResources: [{
            resourceStatement: {
                resourceTypes: ["AWS::EC2::NatGateway"],
            },
        }],
    }],
    matchPaths: [{
        source: {
            resourceStatement: {
                resourceTypes: ["AWS::EC2::NetworkInterface"],
            },
        },
    }],
});
import pulumi
import pulumi_aws as aws

example = aws.ec2.NetworkInsightsAccessScope("example",
    exclude_paths=[{
        "source": {
            "resource_statement": {
                "resource_types": ["AWS::EC2::InternetGateway"],
            },
        },
        "through_resources": [{
            "resource_statement": {
                "resource_types": ["AWS::EC2::NatGateway"],
            },
        }],
    }],
    match_paths=[{
        "source": {
            "resource_statement": {
                "resource_types": ["AWS::EC2::NetworkInterface"],
            },
        },
    }])
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;

return await Deployment.RunAsync(() =>
{
    var example = new Aws.Ec2.NetworkInsightsAccessScope("example", new()
    {
        ExcludePaths = new[]
        {
            new Aws.Ec2.Inputs.NetworkInsightsAccessScopeExcludePathArgs
            {
                Source = new Aws.Ec2.Inputs.NetworkInsightsAccessScopeExcludePathSourceArgs
                {
                    ResourceStatement = new Aws.Ec2.Inputs.NetworkInsightsAccessScopeExcludePathSourceResourceStatementArgs
                    {
                        ResourceTypes = new[]
                        {
                            "AWS::EC2::InternetGateway",
                        },
                    },
                },
                ThroughResources = new[]
                {
                    new Aws.Ec2.Inputs.NetworkInsightsAccessScopeExcludePathThroughResourceArgs
                    {
                        ResourceStatement = new Aws.Ec2.Inputs.NetworkInsightsAccessScopeExcludePathThroughResourceResourceStatementArgs
                        {
                            ResourceTypes = new[]
                            {
                                "AWS::EC2::NatGateway",
                            },
                        },
                    },
                },
            },
        },
        MatchPaths = new[]
        {
            new Aws.Ec2.Inputs.NetworkInsightsAccessScopeMatchPathArgs
            {
                Source = new Aws.Ec2.Inputs.NetworkInsightsAccessScopeMatchPathSourceArgs
                {
                    ResourceStatement = new Aws.Ec2.Inputs.NetworkInsightsAccessScopeMatchPathSourceResourceStatementArgs
                    {
                        ResourceTypes = new[]
                        {
                            "AWS::EC2::NetworkInterface",
                        },
                    },
                },
            },
        },
    });

});
package main

import (
	"github.com/pulumi/pulumi-aws/sdk/v7/go/aws/ec2"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := ec2.NewNetworkInsightsAccessScope(ctx, "example", &ec2.NetworkInsightsAccessScopeArgs{
			ExcludePaths: ec2.NetworkInsightsAccessScopeExcludePathArray{
				&ec2.NetworkInsightsAccessScopeExcludePathArgs{
					Source: &ec2.NetworkInsightsAccessScopeExcludePathSourceArgs{
						ResourceStatement: &ec2.NetworkInsightsAccessScopeExcludePathSourceResourceStatementArgs{
							ResourceTypes: pulumi.StringArray{
								pulumi.String("AWS::EC2::InternetGateway"),
							},
						},
					},
					ThroughResources: ec2.NetworkInsightsAccessScopeExcludePathThroughResourceArray{
						&ec2.NetworkInsightsAccessScopeExcludePathThroughResourceArgs{
							ResourceStatement: &ec2.NetworkInsightsAccessScopeExcludePathThroughResourceResourceStatementArgs{
								ResourceTypes: pulumi.StringArray{
									pulumi.String("AWS::EC2::NatGateway"),
								},
							},
						},
					},
				},
			},
			MatchPaths: ec2.NetworkInsightsAccessScopeMatchPathArray{
				&ec2.NetworkInsightsAccessScopeMatchPathArgs{
					Source: &ec2.NetworkInsightsAccessScopeMatchPathSourceArgs{
						ResourceStatement: &ec2.NetworkInsightsAccessScopeMatchPathSourceResourceStatementArgs{
							ResourceTypes: pulumi.StringArray{
								pulumi.String("AWS::EC2::NetworkInterface"),
							},
						},
					},
				},
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}
pulumi {
  required_providers {
    aws = {
      source = "pulumi/aws"
    }
  }
}

resource "aws_ec2_networkinsightsaccessscope" "example" {
  exclude_paths {
    source = {
      resource_statement = {
        resource_types = ["AWS::EC2::InternetGateway"]
      }
    }
    through_resources {
      resource_statement = {
        resource_types = ["AWS::EC2::NatGateway"]
      }
    }
  }
  match_paths {
    source = {
      resource_statement = {
        resource_types = ["AWS::EC2::NetworkInterface"]
      }
    }
  }
}
package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.ec2.NetworkInsightsAccessScope;
import com.pulumi.aws.ec2.NetworkInsightsAccessScopeArgs;
import com.pulumi.aws.ec2.inputs.NetworkInsightsAccessScopeExcludePathArgs;
import com.pulumi.aws.ec2.inputs.NetworkInsightsAccessScopeExcludePathSourceArgs;
import com.pulumi.aws.ec2.inputs.NetworkInsightsAccessScopeExcludePathSourceResourceStatementArgs;
import com.pulumi.aws.ec2.inputs.NetworkInsightsAccessScopeExcludePathThroughResourceArgs;
import com.pulumi.aws.ec2.inputs.NetworkInsightsAccessScopeExcludePathThroughResourceResourceStatementArgs;
import com.pulumi.aws.ec2.inputs.NetworkInsightsAccessScopeMatchPathArgs;
import com.pulumi.aws.ec2.inputs.NetworkInsightsAccessScopeMatchPathSourceArgs;
import com.pulumi.aws.ec2.inputs.NetworkInsightsAccessScopeMatchPathSourceResourceStatementArgs;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }

    public static void stack(Context ctx) {
        var example = new NetworkInsightsAccessScope("example", NetworkInsightsAccessScopeArgs.builder()
            .excludePaths(NetworkInsightsAccessScopeExcludePathArgs.builder()
                .source(NetworkInsightsAccessScopeExcludePathSourceArgs.builder()
                    .resourceStatement(NetworkInsightsAccessScopeExcludePathSourceResourceStatementArgs.builder()
                        .resourceTypes("AWS::EC2::InternetGateway")
                        .build())
                    .build())
                .throughResources(NetworkInsightsAccessScopeExcludePathThroughResourceArgs.builder()
                    .resourceStatement(NetworkInsightsAccessScopeExcludePathThroughResourceResourceStatementArgs.builder()
                        .resourceTypes("AWS::EC2::NatGateway")
                        .build())
                    .build())
                .build())
            .matchPaths(NetworkInsightsAccessScopeMatchPathArgs.builder()
                .source(NetworkInsightsAccessScopeMatchPathSourceArgs.builder()
                    .resourceStatement(NetworkInsightsAccessScopeMatchPathSourceResourceStatementArgs.builder()
                        .resourceTypes("AWS::EC2::NetworkInterface")
                        .build())
                    .build())
                .build())
            .build());

    }
}
resources:
  example:
    type: aws:ec2:NetworkInsightsAccessScope
    properties:
      excludePaths:
        - source:
            resourceStatement:
              resourceTypes:
                - AWS::EC2::InternetGateway
          throughResources:
            - resourceStatement:
                resourceTypes:
                  - AWS::EC2::NatGateway
      matchPaths:
        - source:
            resourceStatement:
              resourceTypes:
                - AWS::EC2::NetworkInterface

Import

Identity Schema

Required

  • id - (String) ID of the Network Insights Access Scope.

Optional

  • accountId (String) AWS Account where this resource is managed.
  • region (String) Region where this resource is managed.

Using pulumi import, import Network Insights Access Scopes using the id. For example:

$ pulumi import aws:ec2/networkInsightsAccessScope:NetworkInsightsAccessScope example nis-0a1b2c3d4e5f6g7h8

Constructors

NetworkInsightsAccessScope(String name, {NetworkInsightsAccessScopeArgs? args, CustomResourceOptions? options})
Creates a new NetworkInsightsAccessScope. name The Pulumi resource name. args Arguments used to configure this NetworkInsightsAccessScope. The set of arguments for NetworkInsightsAccessScope. options Resource options controlling this resource's behavior.
NetworkInsightsAccessScope.reference(String urn)
Creates a typed reference to an existing NetworkInsightsAccessScope resource.

Properties

arn ↔ Output<String>
ARN of the Network Insights Access Scope.
latefinal
childResources → Set<Resource>
finalinherited
completionSources ↔ Map<String, IOutputCompletionSource>
latefinalinherited
excludePaths ↔ Output<List<NetworkInsightsAccessScopeExcludePath>?>
Set of access scope path statements to exclude. See excludePaths below for details.
latefinal
hashCode → int
The hash code for this object.
no setterinherited
id ↔ Output<String>
getter/setter pairinherited
isCustom → bool
Returns whether this resource is provider-managed.
no setterinherited
isProtected → bool
Returns whether this resource is protected from deletion.
no setterinherited
isRemote → bool
Whether this resource is registered as remote.
no setterinherited
isResourceReference → bool
Whether this instance represents a resource value returned over RPC.
finalinherited
matchPaths ↔ Output<List<NetworkInsightsAccessScopeMatchPath>?>
Set of access scope path statements to match. At least one must be specified. See matchPaths below for details.
latefinal
region ↔ Output<String>
Region where this resource will be managed. Defaults to the Region set in the provider configuration.
latefinal
resourceTransforms → List<ResourceTransform>
Inherited/explicit async transforms.
no setterinherited
runtimeType → Type
A representation of the runtime type of the object.
no setterinherited
tags ↔ Output<Map<String, String>?>
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.
latefinal
tagsAll ↔ Output<Map<String, String>>
Map of tags assigned to the resource, including those inherited from the provider defaultTags configuration block.
latefinal
transformations → List<ResourceTransformation>
Inherited/explicit legacy transformations.
no setterinherited
urn ↔ Output<String>
latefinalinherited

Methods

failId(Object error) → void
Completes this resource ID with an error when registration fails.
inherited
failOutputs(Object error) → void
Completes all output properties with error.
inherited
failUrn(Object error) → void
Completes this resource URN with an error when registration fails.
inherited
getProvider(String moduleMember) → ProviderResource?
Returns provider for moduleMember's package, if configured.
inherited
getResourceName() → String
Returns this resource's logical name.
inherited
getResourceType() → String
Returns this resource's Pulumi type token.
inherited
noSuchMethod(Invocation invocation) → dynamic
Invoked when a nonexistent method or property is accessed.
inherited
registerOutput<T>(String propertyName, {Object? decoder(Object?)?, bool isSecret = false}) → Output<T>
Registers a dynamic output property for this resource.
inherited
resolveId(String? value, {required bool isKnown}) → void
Resolves the provider-assigned ID for this resource.
inherited
resolveOutputs(Struct outputs) → void
Resolves all output properties from a monitor response payload.
inherited
resolveUrn(String value) → void
Resolves this resource's URN once assigned by the engine.
inherited
serializeProperties(Map<String, dynamic> properties) → Future<Struct>
Serializes resource properties for RPC transmission.
inherited
toString() → String
A string representation of this object.
inherited

Operators

operator ==(Object other) → bool
The equality operator.
inherited

Static Methods

get(String name, Input<String> id, {NetworkInsightsAccessScopeState? state, CustomResourceOptions? options}) → NetworkInsightsAccessScope
Gets an existing NetworkInsightsAccessScope resource's state with the given name and id.