Environment class
Resource for managing an AWS Mainframe Modernization Environment.
Example Usage
Basic Usage
import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";
const test = new aws.m2.Environment("test", {
name: "test-env",
engineType: "bluage",
instanceType: "M2.m5.large",
securityGroups: ["sg-01234567890abcdef"],
subnetIds: [
"subnet-01234567890abcdef",
"subnet-01234567890abcdea",
],
});
import pulumi
import pulumi_aws as aws
test = aws.m2.Environment("test",
name="test-env",
engine_type="bluage",
instance_type="M2.m5.large",
security_groups=["sg-01234567890abcdef"],
subnet_ids=[
"subnet-01234567890abcdef",
"subnet-01234567890abcdea",
])
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;
return await Deployment.RunAsync(() =>
{
var test = new Aws.M2.Environment("test", new()
{
Name = "test-env",
EngineType = "bluage",
InstanceType = "M2.m5.large",
SecurityGroups = new[]
{
"sg-01234567890abcdef",
},
SubnetIds = new[]
{
"subnet-01234567890abcdef",
"subnet-01234567890abcdea",
},
});
});
package main
import (
"github.com/pulumi/pulumi-aws/sdk/v7/go/aws/m2"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := m2.NewEnvironment(ctx, "test", &m2.EnvironmentArgs{
Name: pulumi.String("test-env"),
EngineType: pulumi.String("bluage"),
InstanceType: pulumi.String("M2.m5.large"),
SecurityGroups: []string{
"sg-01234567890abcdef",
},
SubnetIds: pulumi.StringArray{
pulumi.String("subnet-01234567890abcdef"),
pulumi.String("subnet-01234567890abcdea"),
},
})
if err != nil {
return err
}
return nil
})
}
pulumi {
required_providers {
aws = {
source = "pulumi/aws"
}
}
}
resource "aws_m2_environment" "test" {
name = "test-env"
engine_type = "bluage"
instance_type = "M2.m5.large"
security_groups = ["sg-01234567890abcdef"]
subnet_ids = ["subnet-01234567890abcdef", "subnet-01234567890abcdea"]
}
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.m2.Environment;
import com.pulumi.aws.m2.EnvironmentArgs;
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 test = new Environment("test", EnvironmentArgs.builder()
.name("test-env")
.engineType("bluage")
.instanceType("M2.m5.large")
.securityGroups(Arrays.asList("sg-01234567890abcdef"))
.subnetIds(
"subnet-01234567890abcdef",
"subnet-01234567890abcdea")
.build());
}
}
resources:
test:
type: aws:m2:Environment
properties:
name: test-env
engineType: bluage
instanceType: M2.m5.large
securityGroups:
- sg-01234567890abcdef
subnetIds:
- subnet-01234567890abcdef
- subnet-01234567890abcdea
High Availability
import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";
const test = new aws.m2.Environment("test", {
highAvailabilityConfig: {
desiredCapacity: 2,
},
name: "test-env",
engineType: "bluage",
instanceType: "M2.m5.large",
securityGroups: ["sg-01234567890abcdef"],
subnetIds: [
"subnet-01234567890abcdef",
"subnet-01234567890abcdea",
],
});
import pulumi
import pulumi_aws as aws
test = aws.m2.Environment("test",
high_availability_config={
"desired_capacity": 2,
},
name="test-env",
engine_type="bluage",
instance_type="M2.m5.large",
security_groups=["sg-01234567890abcdef"],
subnet_ids=[
"subnet-01234567890abcdef",
"subnet-01234567890abcdea",
])
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;
return await Deployment.RunAsync(() =>
{
var test = new Aws.M2.Environment("test", new()
{
HighAvailabilityConfig = new Aws.M2.Inputs.EnvironmentHighAvailabilityConfigArgs
{
DesiredCapacity = 2,
},
Name = "test-env",
EngineType = "bluage",
InstanceType = "M2.m5.large",
SecurityGroups = new[]
{
"sg-01234567890abcdef",
},
SubnetIds = new[]
{
"subnet-01234567890abcdef",
"subnet-01234567890abcdea",
},
});
});
package main
import (
"github.com/pulumi/pulumi-aws/sdk/v7/go/aws/m2"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := m2.NewEnvironment(ctx, "test", &m2.EnvironmentArgs{
HighAvailabilityConfig: &m2.EnvironmentHighAvailabilityConfigArgs{
DesiredCapacity: pulumi.Int(2),
},
Name: pulumi.String("test-env"),
EngineType: pulumi.String("bluage"),
InstanceType: pulumi.String("M2.m5.large"),
SecurityGroups: []string{
"sg-01234567890abcdef",
},
SubnetIds: pulumi.StringArray{
pulumi.String("subnet-01234567890abcdef"),
pulumi.String("subnet-01234567890abcdea"),
},
})
if err != nil {
return err
}
return nil
})
}
pulumi {
required_providers {
aws = {
source = "pulumi/aws"
}
}
}
resource "aws_m2_environment" "test" {
high_availability_config = {
desired_capacity = 2
}
name = "test-env"
engine_type = "bluage"
instance_type = "M2.m5.large"
security_groups = ["sg-01234567890abcdef"]
subnet_ids = ["subnet-01234567890abcdef", "subnet-01234567890abcdea"]
}
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.m2.Environment;
import com.pulumi.aws.m2.EnvironmentArgs;
import com.pulumi.aws.m2.inputs.EnvironmentHighAvailabilityConfigArgs;
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 test = new Environment("test", EnvironmentArgs.builder()
.highAvailabilityConfig(EnvironmentHighAvailabilityConfigArgs.builder()
.desiredCapacity(2)
.build())
.name("test-env")
.engineType("bluage")
.instanceType("M2.m5.large")
.securityGroups(Arrays.asList("sg-01234567890abcdef"))
.subnetIds(
"subnet-01234567890abcdef",
"subnet-01234567890abcdea")
.build());
}
}
resources:
test:
type: aws:m2:Environment
properties:
highAvailabilityConfig:
desiredCapacity: 2
name: test-env
engineType: bluage
instanceType: M2.m5.large
securityGroups:
- sg-01234567890abcdef
subnetIds:
- subnet-01234567890abcdef
- subnet-01234567890abcdea
EFS Filesystem
import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";
const test = new aws.m2.Environment("test", {
storageConfiguration: {
efs: {
fileSystemId: "fs-01234567890abcdef",
mountPoint: "/m2/mount/example",
},
},
name: "test-env",
engineType: "bluage",
instanceType: "M2.m5.large",
securityGroups: ["sg-01234567890abcdef"],
subnetIds: [
"subnet-01234567890abcdef",
"subnet-01234567890abcdea",
],
});
import pulumi
import pulumi_aws as aws
test = aws.m2.Environment("test",
storage_configuration={
"efs": {
"file_system_id": "fs-01234567890abcdef",
"mount_point": "/m2/mount/example",
},
},
name="test-env",
engine_type="bluage",
instance_type="M2.m5.large",
security_groups=["sg-01234567890abcdef"],
subnet_ids=[
"subnet-01234567890abcdef",
"subnet-01234567890abcdea",
])
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;
return await Deployment.RunAsync(() =>
{
var test = new Aws.M2.Environment("test", new()
{
StorageConfiguration = new Aws.M2.Inputs.EnvironmentStorageConfigurationArgs
{
Efs = new Aws.M2.Inputs.EnvironmentStorageConfigurationEfsArgs
{
FileSystemId = "fs-01234567890abcdef",
MountPoint = "/m2/mount/example",
},
},
Name = "test-env",
EngineType = "bluage",
InstanceType = "M2.m5.large",
SecurityGroups = new[]
{
"sg-01234567890abcdef",
},
SubnetIds = new[]
{
"subnet-01234567890abcdef",
"subnet-01234567890abcdea",
},
});
});
package main
import (
"github.com/pulumi/pulumi-aws/sdk/v7/go/aws/m2"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := m2.NewEnvironment(ctx, "test", &m2.EnvironmentArgs{
StorageConfiguration: &m2.EnvironmentStorageConfigurationArgs{
Efs: &m2.EnvironmentStorageConfigurationEfsArgs{
FileSystemId: pulumi.String("fs-01234567890abcdef"),
MountPoint: pulumi.String("/m2/mount/example"),
},
},
Name: pulumi.String("test-env"),
EngineType: pulumi.String("bluage"),
InstanceType: pulumi.String("M2.m5.large"),
SecurityGroups: []string{
"sg-01234567890abcdef",
},
SubnetIds: pulumi.StringArray{
pulumi.String("subnet-01234567890abcdef"),
pulumi.String("subnet-01234567890abcdea"),
},
})
if err != nil {
return err
}
return nil
})
}
pulumi {
required_providers {
aws = {
source = "pulumi/aws"
}
}
}
resource "aws_m2_environment" "test" {
storage_configuration = {
efs = {
file_system_id = "fs-01234567890abcdef"
mount_point = "/m2/mount/example"
}
}
name = "test-env"
engine_type = "bluage"
instance_type = "M2.m5.large"
security_groups = ["sg-01234567890abcdef"]
subnet_ids = ["subnet-01234567890abcdef", "subnet-01234567890abcdea"]
}
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.m2.Environment;
import com.pulumi.aws.m2.EnvironmentArgs;
import com.pulumi.aws.m2.inputs.EnvironmentStorageConfigurationArgs;
import com.pulumi.aws.m2.inputs.EnvironmentStorageConfigurationEfsArgs;
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 test = new Environment("test", EnvironmentArgs.builder()
.storageConfiguration(EnvironmentStorageConfigurationArgs.builder()
.efs(EnvironmentStorageConfigurationEfsArgs.builder()
.fileSystemId("fs-01234567890abcdef")
.mountPoint("/m2/mount/example")
.build())
.build())
.name("test-env")
.engineType("bluage")
.instanceType("M2.m5.large")
.securityGroups(Arrays.asList("sg-01234567890abcdef"))
.subnetIds(
"subnet-01234567890abcdef",
"subnet-01234567890abcdea")
.build());
}
}
resources:
test:
type: aws:m2:Environment
properties:
storageConfiguration:
efs:
fileSystemId: fs-01234567890abcdef
mountPoint: /m2/mount/example
name: test-env
engineType: bluage
instanceType: M2.m5.large
securityGroups:
- sg-01234567890abcdef
subnetIds:
- subnet-01234567890abcdef
- subnet-01234567890abcdea
FSX Filesystem
import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";
const test = new aws.m2.Environment("test", {
storageConfiguration: {
fsx: {
fileSystemId: "fs-01234567890abcdef",
mountPoint: "/m2/mount/example",
},
},
name: "test-env",
engineType: "bluage",
instanceType: "M2.m5.large",
securityGroups: ["sg-01234567890abcdef"],
subnetIds: [
"subnet-01234567890abcdef",
"subnet-01234567890abcdea",
],
});
import pulumi
import pulumi_aws as aws
test = aws.m2.Environment("test",
storage_configuration={
"fsx": {
"file_system_id": "fs-01234567890abcdef",
"mount_point": "/m2/mount/example",
},
},
name="test-env",
engine_type="bluage",
instance_type="M2.m5.large",
security_groups=["sg-01234567890abcdef"],
subnet_ids=[
"subnet-01234567890abcdef",
"subnet-01234567890abcdea",
])
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;
return await Deployment.RunAsync(() =>
{
var test = new Aws.M2.Environment("test", new()
{
StorageConfiguration = new Aws.M2.Inputs.EnvironmentStorageConfigurationArgs
{
Fsx = new Aws.M2.Inputs.EnvironmentStorageConfigurationFsxArgs
{
FileSystemId = "fs-01234567890abcdef",
MountPoint = "/m2/mount/example",
},
},
Name = "test-env",
EngineType = "bluage",
InstanceType = "M2.m5.large",
SecurityGroups = new[]
{
"sg-01234567890abcdef",
},
SubnetIds = new[]
{
"subnet-01234567890abcdef",
"subnet-01234567890abcdea",
},
});
});
package main
import (
"github.com/pulumi/pulumi-aws/sdk/v7/go/aws/m2"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := m2.NewEnvironment(ctx, "test", &m2.EnvironmentArgs{
StorageConfiguration: &m2.EnvironmentStorageConfigurationArgs{
Fsx: &m2.EnvironmentStorageConfigurationFsxArgs{
FileSystemId: pulumi.String("fs-01234567890abcdef"),
MountPoint: pulumi.String("/m2/mount/example"),
},
},
Name: pulumi.String("test-env"),
EngineType: pulumi.String("bluage"),
InstanceType: pulumi.String("M2.m5.large"),
SecurityGroups: []string{
"sg-01234567890abcdef",
},
SubnetIds: pulumi.StringArray{
pulumi.String("subnet-01234567890abcdef"),
pulumi.String("subnet-01234567890abcdea"),
},
})
if err != nil {
return err
}
return nil
})
}
pulumi {
required_providers {
aws = {
source = "pulumi/aws"
}
}
}
resource "aws_m2_environment" "test" {
storage_configuration = {
fsx = {
file_system_id = "fs-01234567890abcdef"
mount_point = "/m2/mount/example"
}
}
name = "test-env"
engine_type = "bluage"
instance_type = "M2.m5.large"
security_groups = ["sg-01234567890abcdef"]
subnet_ids = ["subnet-01234567890abcdef", "subnet-01234567890abcdea"]
}
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.m2.Environment;
import com.pulumi.aws.m2.EnvironmentArgs;
import com.pulumi.aws.m2.inputs.EnvironmentStorageConfigurationArgs;
import com.pulumi.aws.m2.inputs.EnvironmentStorageConfigurationFsxArgs;
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 test = new Environment("test", EnvironmentArgs.builder()
.storageConfiguration(EnvironmentStorageConfigurationArgs.builder()
.fsx(EnvironmentStorageConfigurationFsxArgs.builder()
.fileSystemId("fs-01234567890abcdef")
.mountPoint("/m2/mount/example")
.build())
.build())
.name("test-env")
.engineType("bluage")
.instanceType("M2.m5.large")
.securityGroups(Arrays.asList("sg-01234567890abcdef"))
.subnetIds(
"subnet-01234567890abcdef",
"subnet-01234567890abcdea")
.build());
}
}
resources:
test:
type: aws:m2:Environment
properties:
storageConfiguration:
fsx:
fileSystemId: fs-01234567890abcdef
mountPoint: /m2/mount/example
name: test-env
engineType: bluage
instanceType: M2.m5.large
securityGroups:
- sg-01234567890abcdef
subnetIds:
- subnet-01234567890abcdef
- subnet-01234567890abcdea
Import
Using pulumi import, import Mainframe Modernization Environment using the 01234567890abcdef012345678. For example:
$ pulumi import aws:m2/environment:Environment example 01234567890abcdef012345678
Constructors
- Environment(String name, {EnvironmentArgs? args, CustomResourceOptions? options})
-
Creates a new Environment.
nameThe Pulumi resource name.argsArguments used to configure this Environment. The set of arguments for Environment.optionsResource options controlling this resource's behavior. - Environment.reference(String urn)
- Creates a typed reference to an existing Environment resource.
Properties
-
applyChangesDuringMaintenanceWindow
↔ Output<
bool?> -
latefinal
-
arn
↔ Output<
String> -
ARN of the Environment.
latefinal
-
childResources
→ Set<
Resource> -
finalinherited
-
completionSources
↔ Map<
String, IOutputCompletionSource> -
latefinalinherited
-
description
↔ Output<
String?> -
latefinal
-
engineType
↔ Output<
String> -
Engine type must be
microfocusorbluage.latefinal -
engineVersion
↔ Output<
String> -
The specific version of the engine for the Environment.
latefinal
-
environmentId
↔ Output<
String> -
The id of the Environment.
latefinal
-
forceUpdate
↔ Output<
bool?> -
Force update the environment even if applications are running.
latefinal
- hashCode → int
-
The hash code for this object.
no setterinherited
-
highAvailabilityConfig
↔ Output<
EnvironmentHighAvailabilityConfig?> -
latefinal
-
id
↔ Output<
String> -
getter/setter pairinherited
-
instanceType
↔ Output<
String> -
M2 Instance Type.
latefinal
- 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
-
kmsKeyId
↔ Output<
String?> -
ARN of the KMS key to use for the Environment.
latefinal
-
loadBalancerArn
↔ Output<
String> -
ARN of the load balancer created by the Environment.
latefinal
-
name
↔ Output<
String> -
Name of the runtime environment. Must be unique within the account.
latefinal
-
preferredMaintenanceWindow
↔ Output<
String> -
Configures the maintenance window that you want for the runtime environment. The maintenance window must have the format
ddd:hh24:mi-ddd:hh24:miand must be less than 24 hours. If not provided a random value will be used.latefinal -
publiclyAccessible
↔ Output<
bool> -
Allow applications deployed to this environment to be publicly accessible.
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
-
securityGroupIds
↔ Output<
List< String> > -
List of security group ids.
latefinal
-
storageConfiguration
↔ Output<
EnvironmentStorageConfiguration?> -
latefinal
-
subnetIds
↔ Output<
List< String> > -
List of subnet ids to deploy environment to.
latefinal
-
Key-value tags for the place index. If configured with a provider
defaultTagsconfiguration block present, tags with matching keys will overwrite those defined at the provider-level.latefinal -
latefinal
-
timeouts
↔ Output<
EnvironmentTimeouts?> -
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, {EnvironmentState? state, CustomResourceOptions? options}) → Environment -
Gets an existing Environment resource's state with the given
nameandid.