java.lang.Object
- com.pulumi.resources.Resource
- - com.pulumi.resources.CustomResource
  - - com.pulumi.aws.dms.ReplicationSubnetGroup

public class ReplicationSubnetGroup
extends com.pulumi.resources.CustomResource

Provides a DMS (Data Migration Service) replication subnet group resource. DMS replication subnet groups can be created, updated, deleted, and imported. > **Note:** AWS requires a special IAM role called `dms-vpc-role` when using this resource. See the example below to create it as part of your configuration. ## Example Usage ### Basic

 
 package generated_program;
 
 import com.pulumi.Context;
 import com.pulumi.Pulumi;
 import com.pulumi.core.Output;
 import com.pulumi.aws.dms.ReplicationSubnetGroup;
 import com.pulumi.aws.dms.ReplicationSubnetGroupArgs;
 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) {
         // Create a new replication subnet group
         var example = new ReplicationSubnetGroup("example", ReplicationSubnetGroupArgs.builder()
             .replicationSubnetGroupDescription("Example replication subnet group")
             .replicationSubnetGroupId("example-dms-replication-subnet-group-tf")
             .subnetIds(            
                 "subnet-12345678",
                 "subnet-12345679")
             .tags(Map.of("Name", "example"))
             .build());
 
     }
 }

### Creating special IAM role If your account does not already include the `dms-vpc-role` IAM role, you will need to create it to allow DMS to manage subnets in the VPC.

 
 package generated_program;
 
 import com.pulumi.Context;
 import com.pulumi.Pulumi;
 import com.pulumi.core.Output;
 import com.pulumi.aws.iam.Role;
 import com.pulumi.aws.iam.RoleArgs;
 import com.pulumi.aws.iam.RolePolicyAttachment;
 import com.pulumi.aws.iam.RolePolicyAttachmentArgs;
 import com.pulumi.aws.dms.ReplicationSubnetGroup;
 import com.pulumi.aws.dms.ReplicationSubnetGroupArgs;
 import static com.pulumi.codegen.internal.Serialization.*;
 import com.pulumi.resources.CustomResourceOptions;
 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 dms_vpc_role = new Role("dms-vpc-role", RoleArgs.builder()
             .name("dms-vpc-role")
             .description("Allows DMS to manage VPC")
             .assumeRolePolicy(serializeJson(
                 jsonObject(
                     jsonProperty("Version", "2012-10-17"),
                     jsonProperty("Statement", jsonArray(jsonObject(
                         jsonProperty("Effect", "Allow"),
                         jsonProperty("Principal", jsonObject(
                             jsonProperty("Service", "dms.amazonaws.com")
                         )),
                         jsonProperty("Action", "sts:AssumeRole")
                     )))
                 )))
             .build());
 
         var example = new RolePolicyAttachment("example", RolePolicyAttachmentArgs.builder()
             .role(dms_vpc_role.name())
             .policyArn("arn:aws:iam::aws:policy/service-role/AmazonDMSVPCManagementRole")
             .build());
 
         var exampleReplicationSubnetGroup = new ReplicationSubnetGroup("exampleReplicationSubnetGroup", ReplicationSubnetGroupArgs.builder()
             .replicationSubnetGroupDescription("Example")
             .replicationSubnetGroupId("example-id")
             .subnetIds(            
                 "subnet-12345678",
                 "subnet-12345679")
             .tags(Map.of("Name", "example-id"))
             .build(), CustomResourceOptions.builder()
                 .dependsOn(example)
                 .build());
 
     }
 }

## Import Using `pulumi import`, import replication subnet groups using the `replicationSubnetGroupId`. For example: ```sh $ pulumi import aws:dms/replicationSubnetGroup:ReplicationSubnetGroup test test-dms-replication-subnet-group-tf ```

Nested Class Summary
- Nested classes/interfaces inherited from class com.pulumi.resources.CustomResource
  com.pulumi.resources.CustomResource.CustomResourceInternal
- Nested classes/interfaces inherited from class com.pulumi.resources.Resource
  com.pulumi.resources.Resource.LazyField<T extends java.lang.Object>, com.pulumi.resources.Resource.LazyFields, com.pulumi.resources.Resource.ResourceInternal

Field Summary
- Fields inherited from class com.pulumi.resources.Resource
  childResources, remote

Constructor Summary

Constructors
Constructor	Description
`ReplicationSubnetGroup(java.lang.String name)`
`ReplicationSubnetGroup(java.lang.String name, ReplicationSubnetGroupArgs args)`
`ReplicationSubnetGroup(java.lang.String name, ReplicationSubnetGroupArgs args, com.pulumi.resources.CustomResourceOptions options)`

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method	Description
`static ReplicationSubnetGroup`	`get(java.lang.String name, com.pulumi.core.Output<java.lang.String> id, ReplicationSubnetGroupState state, com.pulumi.resources.CustomResourceOptions options)`	Get an existing Host resource's state with the given name, ID, and optional extra properties used to qualify the lookup.
`com.pulumi.core.Output<java.lang.String>`	`region()`
`com.pulumi.core.Output<java.lang.String>`	`replicationSubnetGroupArn()`
`com.pulumi.core.Output<java.lang.String>`	`replicationSubnetGroupDescription()`
`com.pulumi.core.Output<java.lang.String>`	`replicationSubnetGroupId()`
`com.pulumi.core.Output<java.util.List<java.lang.String>>`	`subnetIds()`
`com.pulumi.core.Output<java.util.Optional<java.util.Map<java.lang.String,java.lang.String>>>`	`tags()`
`com.pulumi.core.Output<java.util.Map<java.lang.String,java.lang.String>>`	`tagsAll()`
`com.pulumi.core.Output<java.lang.String>`	`vpcId()`

Methods inherited from class com.pulumi.resources.CustomResource
getId, id, idFuture

Methods inherited from class com.pulumi.resources.Resource
getChildResources, getResourceName, getResourceType, getUrn, pulumiChildResources, pulumiResourceName, pulumiResourceType, urn

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - ReplicationSubnetGroup
```
public ReplicationSubnetGroup(java.lang.String name)
```
    Parameters:
    
    name - The _unique_ name of the resulting resource.
  - ReplicationSubnetGroup
```
public ReplicationSubnetGroup(java.lang.String name,
                              ReplicationSubnetGroupArgs args)
```
    Parameters:
    
    name - The _unique_ name of the resulting resource.
    
    args - The arguments to use to populate this resource's properties.
  - ReplicationSubnetGroup
```
public ReplicationSubnetGroup(java.lang.String name,
                              ReplicationSubnetGroupArgs args,
                              @Nullable
                              com.pulumi.resources.CustomResourceOptions options)
```
    Parameters:
    
    name - The _unique_ name of the resulting resource.
    
    args - The arguments to use to populate this resource's properties.
    
    options - A bag of options that control this resource's behavior.
- Method Detail
  - region
```
public com.pulumi.core.Output<java.lang.String> region()
```
    Returns:
    
    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.
  - replicationSubnetGroupArn
```
public com.pulumi.core.Output<java.lang.String> replicationSubnetGroupArn()
```
  - replicationSubnetGroupDescription
```
public com.pulumi.core.Output<java.lang.String> replicationSubnetGroupDescription()
```
    Returns:
    
    Description for the subnet group.
  - replicationSubnetGroupId
```
public com.pulumi.core.Output<java.lang.String> replicationSubnetGroupId()
```
    Returns:
    
    Name for the replication subnet group. This value is stored as a lowercase string. It must contain no more than 255 alphanumeric characters, periods, spaces, underscores, or hyphens and cannot be `default`.
  - subnetIds
```
public com.pulumi.core.Output<java.util.List<java.lang.String>> subnetIds()
```
    Returns:
    
    List of at least 2 EC2 subnet IDs for the subnet group. The subnets must cover at least 2 availability zones.
  - tags
```
public com.pulumi.core.Output<java.util.Optional<java.util.Map<java.lang.String,java.lang.String>>> tags()
```
    Returns:
    
    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.
  - tagsAll
```
public com.pulumi.core.Output<java.util.Map<java.lang.String,java.lang.String>> tagsAll()
```
    Returns:
    
    A map of tags assigned to the resource, including those inherited from the provider `defaultTags` configuration block.
  - vpcId
```
public com.pulumi.core.Output<java.lang.String> vpcId()
```
    Returns:
    
    The ID of the VPC the subnet group is in.
  - get
```
public static ReplicationSubnetGroup get(java.lang.String name,
                                         com.pulumi.core.Output<java.lang.String> id,
                                         @Nullable
                                         ReplicationSubnetGroupState state,
                                         @Nullable
                                         com.pulumi.resources.CustomResourceOptions options)
```
    Get an existing Host resource's state with the given name, ID, and optional extra properties used to qualify the lookup.
    
    Parameters:
    
    name - The _unique_ name of the resulting resource.
    
    id - The _unique_ provider ID of the resource to lookup.
    
    state -
    
    options - Optional settings to control the behavior of the CustomResource.

Class ReplicationSubnetGroup

Nested Class Summary

Nested classes/interfaces inherited from class com.pulumi.resources.CustomResource

Nested classes/interfaces inherited from class com.pulumi.resources.Resource

Field Summary

Fields inherited from class com.pulumi.resources.Resource

Constructor Summary

Method Summary

Methods inherited from class com.pulumi.resources.CustomResource

Methods inherited from class com.pulumi.resources.Resource

Methods inherited from class java.lang.Object

Constructor Detail

ReplicationSubnetGroup

ReplicationSubnetGroup

ReplicationSubnetGroup

Method Detail

region

replicationSubnetGroupArn

replicationSubnetGroupDescription

replicationSubnetGroupId

subnetIds

tags

tagsAll

vpcId

get