1. Packages
  2. AWS Cloud Control
  3. API Docs
  4. m2
  5. Environment

We recommend new projects start with resources from the AWS provider.

AWS Cloud Control v1.26.0 published on Wednesday, Mar 12, 2025 by Pulumi

aws-native.m2.Environment

Explore with Pulumi AI

We recommend new projects start with resources from the AWS provider.

AWS Cloud Control v1.26.0 published on Wednesday, Mar 12, 2025 by Pulumi

Represents a runtime environment that can run migrated mainframe applications.

Create Environment Resource

Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.

Constructor syntax

new Environment(name: string, args: EnvironmentArgs, opts?: CustomResourceOptions);
@overload
def Environment(resource_name: str,
                args: EnvironmentArgs,
                opts: Optional[ResourceOptions] = None)

@overload
def Environment(resource_name: str,
                opts: Optional[ResourceOptions] = None,
                instance_type: Optional[str] = None,
                engine_type: Optional[EnvironmentEngineType] = None,
                name: Optional[str] = None,
                high_availability_config: Optional[EnvironmentHighAvailabilityConfigArgs] = None,
                engine_version: Optional[str] = None,
                kms_key_id: Optional[str] = None,
                description: Optional[str] = None,
                network_type: Optional[EnvironmentNetworkType] = None,
                preferred_maintenance_window: Optional[str] = None,
                publicly_accessible: Optional[bool] = None,
                security_group_ids: Optional[Sequence[str]] = None,
                storage_configurations: Optional[Sequence[EnvironmentStorageConfigurationArgs]] = None,
                subnet_ids: Optional[Sequence[str]] = None,
                tags: Optional[Mapping[str, str]] = None)
func NewEnvironment(ctx *Context, name string, args EnvironmentArgs, opts ...ResourceOption) (*Environment, error)
public Environment(string name, EnvironmentArgs args, CustomResourceOptions? opts = null)
public Environment(String name, EnvironmentArgs args)
public Environment(String name, EnvironmentArgs args, CustomResourceOptions options)
type: aws-native:m2:Environment
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.

Parameters

name This property is required. string
The unique name of the resource.
args This property is required. EnvironmentArgs
The arguments to resource properties.
opts CustomResourceOptions
Bag of options to control resource's behavior.
resource_name This property is required. str
The unique name of the resource.
args This property is required. EnvironmentArgs
The arguments to resource properties.
opts ResourceOptions
Bag of options to control resource's behavior.
ctx Context
Context object for the current deployment.
name This property is required. string
The unique name of the resource.
args This property is required. EnvironmentArgs
The arguments to resource properties.
opts ResourceOption
Bag of options to control resource's behavior.
name This property is required. string
The unique name of the resource.
args This property is required. EnvironmentArgs
The arguments to resource properties.
opts CustomResourceOptions
Bag of options to control resource's behavior.
name This property is required. String
The unique name of the resource.
args This property is required. EnvironmentArgs
The arguments to resource properties.
options CustomResourceOptions
Bag of options to control resource's behavior.

Environment Resource Properties

To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

Inputs

In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.

The Environment resource accepts the following input properties:

EngineType This property is required. Pulumi.AwsNative.M2.EnvironmentEngineType
The target platform for the runtime environment.
InstanceType This property is required. string
The type of instance underlying the environment.
Description string
The description of the environment.
EngineVersion string
The version of the runtime engine for the environment.
HighAvailabilityConfig Pulumi.AwsNative.M2.Inputs.EnvironmentHighAvailabilityConfig
Defines the details of a high availability configuration.
KmsKeyId string
The ID or the Amazon Resource Name (ARN) of the customer managed KMS Key used for encrypting environment-related resources.
Name string
The name of the environment.
NetworkType Pulumi.AwsNative.M2.EnvironmentNetworkType
The network type supported by the runtime environment.
PreferredMaintenanceWindow string
Configures a desired maintenance window for the environment. If you do not provide a value, a random system-generated value will be assigned.
PubliclyAccessible bool
Specifies whether the environment is publicly accessible.
SecurityGroupIds List<string>
The list of security groups for the VPC associated with this environment.
StorageConfigurations List<Pulumi.AwsNative.M2.Inputs.EnvironmentStorageConfiguration>
The storage configurations defined for the runtime environment.
SubnetIds List<string>
The unique identifiers of the subnets assigned to this runtime environment.
Tags Dictionary<string, string>
Tags associated to this environment.
EngineType This property is required. EnvironmentEngineType
The target platform for the runtime environment.
InstanceType This property is required. string
The type of instance underlying the environment.
Description string
The description of the environment.
EngineVersion string
The version of the runtime engine for the environment.
HighAvailabilityConfig EnvironmentHighAvailabilityConfigArgs
Defines the details of a high availability configuration.
KmsKeyId string
The ID or the Amazon Resource Name (ARN) of the customer managed KMS Key used for encrypting environment-related resources.
Name string
The name of the environment.
NetworkType EnvironmentNetworkType
The network type supported by the runtime environment.
PreferredMaintenanceWindow string
Configures a desired maintenance window for the environment. If you do not provide a value, a random system-generated value will be assigned.
PubliclyAccessible bool
Specifies whether the environment is publicly accessible.
SecurityGroupIds []string
The list of security groups for the VPC associated with this environment.
StorageConfigurations []EnvironmentStorageConfigurationArgs
The storage configurations defined for the runtime environment.
SubnetIds []string
The unique identifiers of the subnets assigned to this runtime environment.
Tags map[string]string
Tags associated to this environment.
engineType This property is required. EnvironmentEngineType
The target platform for the runtime environment.
instanceType This property is required. String
The type of instance underlying the environment.
description String
The description of the environment.
engineVersion String
The version of the runtime engine for the environment.
highAvailabilityConfig EnvironmentHighAvailabilityConfig
Defines the details of a high availability configuration.
kmsKeyId String
The ID or the Amazon Resource Name (ARN) of the customer managed KMS Key used for encrypting environment-related resources.
name String
The name of the environment.
networkType EnvironmentNetworkType
The network type supported by the runtime environment.
preferredMaintenanceWindow String
Configures a desired maintenance window for the environment. If you do not provide a value, a random system-generated value will be assigned.
publiclyAccessible Boolean
Specifies whether the environment is publicly accessible.
securityGroupIds List<String>
The list of security groups for the VPC associated with this environment.
storageConfigurations List<EnvironmentStorageConfiguration>
The storage configurations defined for the runtime environment.
subnetIds List<String>
The unique identifiers of the subnets assigned to this runtime environment.
tags Map<String,String>
Tags associated to this environment.
engineType This property is required. EnvironmentEngineType
The target platform for the runtime environment.
instanceType This property is required. string
The type of instance underlying the environment.
description string
The description of the environment.
engineVersion string
The version of the runtime engine for the environment.
highAvailabilityConfig EnvironmentHighAvailabilityConfig
Defines the details of a high availability configuration.
kmsKeyId string
The ID or the Amazon Resource Name (ARN) of the customer managed KMS Key used for encrypting environment-related resources.
name string
The name of the environment.
networkType EnvironmentNetworkType
The network type supported by the runtime environment.
preferredMaintenanceWindow string
Configures a desired maintenance window for the environment. If you do not provide a value, a random system-generated value will be assigned.
publiclyAccessible boolean
Specifies whether the environment is publicly accessible.
securityGroupIds string[]
The list of security groups for the VPC associated with this environment.
storageConfigurations EnvironmentStorageConfiguration[]
The storage configurations defined for the runtime environment.
subnetIds string[]
The unique identifiers of the subnets assigned to this runtime environment.
tags {[key: string]: string}
Tags associated to this environment.
engine_type This property is required. EnvironmentEngineType
The target platform for the runtime environment.
instance_type This property is required. str
The type of instance underlying the environment.
description str
The description of the environment.
engine_version str
The version of the runtime engine for the environment.
high_availability_config EnvironmentHighAvailabilityConfigArgs
Defines the details of a high availability configuration.
kms_key_id str
The ID or the Amazon Resource Name (ARN) of the customer managed KMS Key used for encrypting environment-related resources.
name str
The name of the environment.
network_type EnvironmentNetworkType
The network type supported by the runtime environment.
preferred_maintenance_window str
Configures a desired maintenance window for the environment. If you do not provide a value, a random system-generated value will be assigned.
publicly_accessible bool
Specifies whether the environment is publicly accessible.
security_group_ids Sequence[str]
The list of security groups for the VPC associated with this environment.
storage_configurations Sequence[EnvironmentStorageConfigurationArgs]
The storage configurations defined for the runtime environment.
subnet_ids Sequence[str]
The unique identifiers of the subnets assigned to this runtime environment.
tags Mapping[str, str]
Tags associated to this environment.
engineType This property is required. "microfocus" | "bluage"
The target platform for the runtime environment.
instanceType This property is required. String
The type of instance underlying the environment.
description String
The description of the environment.
engineVersion String
The version of the runtime engine for the environment.
highAvailabilityConfig Property Map
Defines the details of a high availability configuration.
kmsKeyId String
The ID or the Amazon Resource Name (ARN) of the customer managed KMS Key used for encrypting environment-related resources.
name String
The name of the environment.
networkType "ipv4" | "dual"
The network type supported by the runtime environment.
preferredMaintenanceWindow String
Configures a desired maintenance window for the environment. If you do not provide a value, a random system-generated value will be assigned.
publiclyAccessible Boolean
Specifies whether the environment is publicly accessible.
securityGroupIds List<String>
The list of security groups for the VPC associated with this environment.
storageConfigurations List<Property Map>
The storage configurations defined for the runtime environment.
subnetIds List<String>
The unique identifiers of the subnets assigned to this runtime environment.
tags Map<String>
Tags associated to this environment.

Outputs

All input properties are implicitly available as output properties. Additionally, the Environment resource produces the following output properties:

EnvironmentArn string
The Amazon Resource Name (ARN) of the runtime environment.
EnvironmentId string
The unique identifier of the environment.
Id string
The provider-assigned unique ID for this managed resource.
EnvironmentArn string
The Amazon Resource Name (ARN) of the runtime environment.
EnvironmentId string
The unique identifier of the environment.
Id string
The provider-assigned unique ID for this managed resource.
environmentArn String
The Amazon Resource Name (ARN) of the runtime environment.
environmentId String
The unique identifier of the environment.
id String
The provider-assigned unique ID for this managed resource.
environmentArn string
The Amazon Resource Name (ARN) of the runtime environment.
environmentId string
The unique identifier of the environment.
id string
The provider-assigned unique ID for this managed resource.
environment_arn str
The Amazon Resource Name (ARN) of the runtime environment.
environment_id str
The unique identifier of the environment.
id str
The provider-assigned unique ID for this managed resource.
environmentArn String
The Amazon Resource Name (ARN) of the runtime environment.
environmentId String
The unique identifier of the environment.
id String
The provider-assigned unique ID for this managed resource.

Supporting Types

EnvironmentEngineType
, EnvironmentEngineTypeArgs

Microfocus
microfocus
Bluage
bluage
EnvironmentEngineTypeMicrofocus
microfocus
EnvironmentEngineTypeBluage
bluage
Microfocus
microfocus
Bluage
bluage
Microfocus
microfocus
Bluage
bluage
MICROFOCUS
microfocus
BLUAGE
bluage
"microfocus"
microfocus
"bluage"
bluage

EnvironmentHighAvailabilityConfig
, EnvironmentHighAvailabilityConfigArgs

DesiredCapacity This property is required. int
The number of instances in a high availability configuration. The minimum possible value is 1 and the maximum is 100.
DesiredCapacity This property is required. int
The number of instances in a high availability configuration. The minimum possible value is 1 and the maximum is 100.
desiredCapacity This property is required. Integer
The number of instances in a high availability configuration. The minimum possible value is 1 and the maximum is 100.
desiredCapacity This property is required. number
The number of instances in a high availability configuration. The minimum possible value is 1 and the maximum is 100.
desired_capacity This property is required. int
The number of instances in a high availability configuration. The minimum possible value is 1 and the maximum is 100.
desiredCapacity This property is required. Number
The number of instances in a high availability configuration. The minimum possible value is 1 and the maximum is 100.

EnvironmentNetworkType
, EnvironmentNetworkTypeArgs

Ipv4
ipv4
Dual
dual
EnvironmentNetworkTypeIpv4
ipv4
EnvironmentNetworkTypeDual
dual
Ipv4
ipv4
Dual
dual
Ipv4
ipv4
Dual
dual
IPV4
ipv4
DUAL
dual
"ipv4"
ipv4
"dual"
dual

Package Details

Repository
AWS Native pulumi/pulumi-aws-native
License
Apache-2.0

We recommend new projects start with resources from the AWS provider.

AWS Cloud Control v1.26.0 published on Wednesday, Mar 12, 2025 by Pulumi