Application Migration Service

2026/04/27 - Application Migration Service - 3 updated api methods

Changes  Added network modernization support, enabling customers to edit, resize, merge, and split VPCs and subnets during migration while retaining functional, non-conflicting IP addresses.

GetNetworkMigrationMapperSegmentConstruct (updated) Link ¶
Changes (response)
{'construct': {'excluded': 'boolean'}}

Retrieves detailed information about a specific construct within a mapper segment, including its properties and configuration data.

See also: AWS API Documentation

Request Syntax

client.get_network_migration_mapper_segment_construct(
    networkMigrationDefinitionID='string',
    networkMigrationExecutionID='string',
    segmentID='string',
    constructID='string'
)
type networkMigrationDefinitionID:

string

param networkMigrationDefinitionID:

[REQUIRED]

The unique identifier of the network migration definition.

type networkMigrationExecutionID:

string

param networkMigrationExecutionID:

[REQUIRED]

The unique identifier of the network migration execution.

type segmentID:

string

param segmentID:

[REQUIRED]

The unique identifier of the mapper segment.

type constructID:

string

param constructID:

[REQUIRED]

The unique identifier of the construct within the segment.

rtype:

dict

returns:

Response Syntax

{
    'construct': {
        'constructID': 'string',
        'constructType': 'string',
        'name': 'string',
        'description': 'string',
        'logicalID': 'string',
        'excluded': True|False,
        'createdAt': datetime(2015, 1, 1),
        'updatedAt': datetime(2015, 1, 1),
        'properties': {
            'string': 'string'
        }
    }
}

Response Structure

  • (dict) --

    • construct (dict) --

      The construct metadata including type, name, and configuration.

      • constructID (string) --

        The unique identifier of the construct.

      • constructType (string) --

        The type of the construct, such as VPC, subnet, security group, or route table.

      • name (string) --

        The name of the construct.

      • description (string) --

        A description of the construct.

      • logicalID (string) --

        The logical identifier for the construct in the infrastructure code.

      • excluded (boolean) --

        Whether this construct is excluded from the migration.

      • createdAt (datetime) --

        The timestamp when the construct was created.

      • updatedAt (datetime) --

        The timestamp when the construct was last updated.

      • properties (dict) --

        The properties and configuration of the construct.

        • (string) --

          • (string) --

ListNetworkMigrationMapperSegmentConstructs (updated) Link ¶
Changes (response)
{'items': {'excluded': 'boolean'}}

Lists constructs within a mapper segment, representing individual infrastructure components like VPCs, subnets, or security groups.

See also: AWS API Documentation

Request Syntax

client.list_network_migration_mapper_segment_constructs(
    networkMigrationExecutionID='string',
    networkMigrationDefinitionID='string',
    segmentID='string',
    filters={
        'constructIDs': [
            'string',
        ],
        'constructTypes': [
            'string',
        ]
    },
    maxResults=123,
    nextToken='string'
)
type networkMigrationExecutionID:

string

param networkMigrationExecutionID:

[REQUIRED]

The unique identifier of the network migration execution.

type networkMigrationDefinitionID:

string

param networkMigrationDefinitionID:

[REQUIRED]

The unique identifier of the network migration definition.

type segmentID:

string

param segmentID:

[REQUIRED]

The unique identifier of the segment to list constructs for.

type filters:

dict

param filters:

Filters to apply when listing constructs, such as construct type or ID.

  • constructIDs (list) --

    A list of construct IDs to filter by.

    • (string) --

  • constructTypes (list) --

    A list of construct types to filter by.

    • (string) --

type maxResults:

integer

param maxResults:

The maximum number of results to return in a single call.

type nextToken:

string

param nextToken:

The token for the next page of results.

rtype:

dict

returns:

Response Syntax

{
    'items': [
        {
            'constructID': 'string',
            'constructType': 'string',
            'name': 'string',
            'description': 'string',
            'logicalID': 'string',
            'excluded': True|False,
            'createdAt': datetime(2015, 1, 1),
            'updatedAt': datetime(2015, 1, 1),
            'properties': {
                'string': 'string'
            }
        },
    ],
    'nextToken': 'string'
}

Response Structure

  • (dict) --

    • items (list) --

      A list of mapper segment constructs.

      • (dict) --

        Represents a construct within a mapper segment. A construct is an individual infrastructure component such as a VPC, subnet, security group, route table, or other network resource that is part of the network migration.

        • constructID (string) --

          The unique identifier of the construct.

        • constructType (string) --

          The type of the construct, such as VPC, subnet, security group, or route table.

        • name (string) --

          The name of the construct.

        • description (string) --

          A description of the construct.

        • logicalID (string) --

          The logical identifier for the construct in the infrastructure code.

        • excluded (boolean) --

          Whether this construct is excluded from the migration.

        • createdAt (datetime) --

          The timestamp when the construct was created.

        • updatedAt (datetime) --

          The timestamp when the construct was last updated.

        • properties (dict) --

          The properties and configuration of the construct.

          • (string) --

            • (string) --

    • nextToken (string) --

      The token to use to retrieve the next page of results. This value is null when there are no more results to return.

StartNetworkMigrationMappingUpdate (updated) Link ¶
Changes (request)
{'constructs': {'operation': {'delete': {},
                              'merge': {'mergeConstructs': [{'constructID': 'string',
                                                             'segmentID': 'string'}]},
                              'split': {'splitConstructs': [{'cidrBlock': 'string'}]},
                              'update': {'excluded': 'boolean',
                                         'name': 'string'}}}}

Starts a job to apply customer modifications to network migration mappings, such as changing properties.

See also: AWS API Documentation

Request Syntax

client.start_network_migration_mapping_update(
    networkMigrationExecutionID='string',
    networkMigrationDefinitionID='string',
    constructs=[
        {
            'segmentID': 'string',
            'constructID': 'string',
            'constructType': 'string',
            'operation': {
                'merge': {
                    'mergeConstructs': [
                        {
                            'segmentID': 'string',
                            'constructID': 'string'
                        },
                    ]
                },
                'split': {
                    'splitConstructs': [
                        {
                            'cidrBlock': 'string'
                        },
                    ]
                },
                'delete': {}
                ,
                'update': {
                    'name': 'string',
                    'excluded': True|False,
                    'properties': {
                        'string': 'string'
                    }
                }
            }
        },
    ],
    segments=[
        {
            'segmentID': 'string',
            'targetAccount': 'string',
            'scopeTags': {
                'string': 'string'
            }
        },
    ]
)
type networkMigrationExecutionID:

string

param networkMigrationExecutionID:

[REQUIRED]

The unique identifier of the network migration execution.

type networkMigrationDefinitionID:

string

param networkMigrationDefinitionID:

[REQUIRED]

The unique identifier of the network migration definition.

type constructs:

list

param constructs:

A list of construct updates to apply.

  • (dict) --

    A construct update to apply during a mapping update operation.

    • segmentID (string) -- [REQUIRED]

      The ID of the segment containing the construct.

    • constructID (string) -- [REQUIRED]

      The ID of the construct to update.

    • constructType (string) -- [REQUIRED]

      The type of the construct.

    • operation (dict) --

      The operation to perform on the construct.

      • merge (dict) --

        A merge operation to combine constructs from different segments.

        • mergeConstructs (list) --

          The list of constructs to merge into the target.

          • (dict) --

            A construct reference specifying the source segment and construct to merge.

            • segmentID (string) --

              The segment ID of the construct to merge.

            • constructID (string) --

              The construct ID to merge.

      • split (dict) --

        A split operation to divide a construct into multiple constructs with specified CIDR blocks.

        • splitConstructs (list) --

          The list of split targets with their CIDR blocks.

          • (dict) --

            A split target specifying the CIDR block for the new construct.

            • cidrBlock (string) --

              The CIDR block for the split construct.

      • delete (dict) --

        A delete operation to remove a construct from the mapping.

      • update (dict) --

        An update operation to modify construct properties.

        • name (string) --

          The updated name for the construct.

        • excluded (boolean) --

          Whether to exclude this construct from the migration.

        • properties (dict) --

          The properties to update on the construct.

          • (string) --

            • (string) --

type segments:

list

param segments:

A list of segment updates to apply.

  • (dict) --

    A segment update to apply during a mapping update operation.

    • segmentID (string) -- [REQUIRED]

      The ID of the segment to update.

    • targetAccount (string) --

      The updated target AWS account for the segment.

    • scopeTags (dict) --

      The updated scope tags for the segment.

      • (string) --

        • (string) --

rtype:

dict

returns:

Response Syntax

{
    'jobID': 'string'
}

Response Structure

  • (dict) --

    • jobID (string) --

      The unique identifier of the mapping update job that was started.