Elastic Disaster Recovery Service

2026/04/08 - Elastic Disaster Recovery Service - 8 updated api methods

Changes  This changes adds support for modifying the replication configuration to support data replication using IPv6.

CreateReplicationConfigurationTemplate (updated) Link ¶
Changes (both) 
{'internetProtocol': 'IPV4 | IPV6'}

Creates a new ReplicationConfigurationTemplate.

See also: AWS API Documentation

Request Syntax

client.create_replication_configuration_template(
    stagingAreaSubnetId='string',
    associateDefaultSecurityGroup=True|False,
    replicationServersSecurityGroupsIDs=[
        'string',
    ],
    replicationServerInstanceType='string',
    useDedicatedReplicationServer=True|False,
    defaultLargeStagingDiskType='GP2'|'GP3'|'ST1'|'AUTO',
    ebsEncryption='DEFAULT'|'CUSTOM'|'NONE',
    ebsEncryptionKeyArn='string',
    bandwidthThrottling=123,
    dataPlaneRouting='PRIVATE_IP'|'PUBLIC_IP',
    createPublicIP=True|False,
    stagingAreaTags={
        'string': 'string'
    },
    pitPolicy=[
        {
            'ruleID': 123,
            'units': 'MINUTE'|'HOUR'|'DAY',
            'interval': 123,
            'retentionDuration': 123,
            'enabled': True|False
        },
    ],
    tags={
        'string': 'string'
    },
    autoReplicateNewDisks=True|False,
    internetProtocol='IPV4'|'IPV6'
)
type stagingAreaSubnetId:

string

param stagingAreaSubnetId:

[REQUIRED]

The subnet to be used by the replication staging area.

type associateDefaultSecurityGroup:

boolean

param associateDefaultSecurityGroup:

Whether to associate the default Elastic Disaster Recovery Security group with the Replication Configuration Template.

type replicationServersSecurityGroupsIDs:

list

param replicationServersSecurityGroupsIDs:

[REQUIRED]

The security group IDs that will be used by the replication server.

  • (string) --

type replicationServerInstanceType:

string

param replicationServerInstanceType:

The instance type to be used for the replication server.

type useDedicatedReplicationServer:

boolean

param useDedicatedReplicationServer:

Whether to use a dedicated Replication Server in the replication staging area.

type defaultLargeStagingDiskType:

string

param defaultLargeStagingDiskType:

The Staging Disk EBS volume type to be used during replication.

type ebsEncryption:

string

param ebsEncryption:

[REQUIRED]

The type of EBS encryption to be used during replication.

type ebsEncryptionKeyArn:

string

param ebsEncryptionKeyArn:

The ARN of the EBS encryption key to be used during replication.

type bandwidthThrottling:

integer

param bandwidthThrottling:

[REQUIRED]

Configure bandwidth throttling for the outbound data transfer rate of the Source Server in Mbps.

type dataPlaneRouting:

string

param dataPlaneRouting:

The data plane routing mechanism that will be used for replication.

type createPublicIP:

boolean

param createPublicIP:

Whether to create a Public IP for the Recovery Instance by default.

type stagingAreaTags:

dict

param stagingAreaTags:

[REQUIRED]

A set of tags to be associated with all resources created in the replication staging area: EC2 replication server, EBS volumes, EBS snapshots, etc.

  • (string) --

    • (string) --

type pitPolicy:

list

param pitPolicy:

[REQUIRED]

The Point in time (PIT) policy to manage snapshots taken during replication.

  • (dict) --

    A rule in the Point in Time (PIT) policy representing when to take snapshots and how long to retain them for.

    • ruleID (integer) --

      The ID of the rule.

    • units (string) -- [REQUIRED]

      The units used to measure the interval and retentionDuration.

    • interval (integer) -- [REQUIRED]

      How often, in the chosen units, a snapshot should be taken.

    • retentionDuration (integer) -- [REQUIRED]

      The duration to retain a snapshot for, in the chosen units.

    • enabled (boolean) --

      Whether this rule is enabled or not.

type tags:

dict

param tags:

A set of tags to be associated with the Replication Configuration Template resource.

  • (string) --

    • (string) --

type autoReplicateNewDisks:

boolean

param autoReplicateNewDisks:

Whether to allow the AWS replication agent to automatically replicate newly added disks.

type internetProtocol:

string

param internetProtocol:

Which version of the Internet Protocol to use for replication of data. (IPv4 or IPv6)

rtype:

dict

returns:

Response Syntax

{
    'replicationConfigurationTemplateID': 'string',
    'arn': 'string',
    'stagingAreaSubnetId': 'string',
    'associateDefaultSecurityGroup': True|False,
    'replicationServersSecurityGroupsIDs': [
        'string',
    ],
    'replicationServerInstanceType': 'string',
    'useDedicatedReplicationServer': True|False,
    'defaultLargeStagingDiskType': 'GP2'|'GP3'|'ST1'|'AUTO',
    'ebsEncryption': 'DEFAULT'|'CUSTOM'|'NONE',
    'ebsEncryptionKeyArn': 'string',
    'bandwidthThrottling': 123,
    'dataPlaneRouting': 'PRIVATE_IP'|'PUBLIC_IP',
    'createPublicIP': True|False,
    'stagingAreaTags': {
        'string': 'string'
    },
    'tags': {
        'string': 'string'
    },
    'pitPolicy': [
        {
            'ruleID': 123,
            'units': 'MINUTE'|'HOUR'|'DAY',
            'interval': 123,
            'retentionDuration': 123,
            'enabled': True|False
        },
    ],
    'autoReplicateNewDisks': True|False,
    'internetProtocol': 'IPV4'|'IPV6'
}

Response Structure

  • (dict) --

    • replicationConfigurationTemplateID (string) --

      The Replication Configuration Template ID.

    • arn (string) --

      The Replication Configuration Template ARN.

    • stagingAreaSubnetId (string) --

      The subnet to be used by the replication staging area.

    • associateDefaultSecurityGroup (boolean) --

      Whether to associate the default Elastic Disaster Recovery Security group with the Replication Configuration Template.

    • replicationServersSecurityGroupsIDs (list) --

      The security group IDs that will be used by the replication server.

      • (string) --

    • replicationServerInstanceType (string) --

      The instance type to be used for the replication server.

    • useDedicatedReplicationServer (boolean) --

      Whether to use a dedicated Replication Server in the replication staging area.

    • defaultLargeStagingDiskType (string) --

      The Staging Disk EBS volume type to be used during replication.

    • ebsEncryption (string) --

      The type of EBS encryption to be used during replication.

    • ebsEncryptionKeyArn (string) --

      The ARN of the EBS encryption key to be used during replication.

    • bandwidthThrottling (integer) --

      Configure bandwidth throttling for the outbound data transfer rate of the Source Server in Mbps.

    • dataPlaneRouting (string) --

      The data plane routing mechanism that will be used for replication.

    • createPublicIP (boolean) --

      Whether to create a Public IP for the Recovery Instance by default.

    • stagingAreaTags (dict) --

      A set of tags to be associated with all resources created in the replication staging area: EC2 replication server, EBS volumes, EBS snapshots, etc.

      • (string) --

        • (string) --

    • tags (dict) --

      A set of tags to be associated with the Replication Configuration Template resource.

      • (string) --

        • (string) --

    • pitPolicy (list) --

      The Point in time (PIT) policy to manage snapshots taken during replication.

      • (dict) --

        A rule in the Point in Time (PIT) policy representing when to take snapshots and how long to retain them for.

        • ruleID (integer) --

          The ID of the rule.

        • units (string) --

          The units used to measure the interval and retentionDuration.

        • interval (integer) --

          How often, in the chosen units, a snapshot should be taken.

        • retentionDuration (integer) --

          The duration to retain a snapshot for, in the chosen units.

        • enabled (boolean) --

          Whether this rule is enabled or not.

    • autoReplicateNewDisks (boolean) --

      Whether to allow the AWS replication agent to automatically replicate newly added disks.

    • internetProtocol (string) --

      Which version of the Internet Protocol to use for replication of data. (IPv4 or IPv6)

DescribeJobLogItems (updated) Link ¶
Changes (response) 
{'items': {'eventData': {'attemptCount': 'long', 'maxAttemptsCount': 'long'}}}

Retrieves a detailed Job log with pagination.

See also: AWS API Documentation

Request Syntax

client.describe_job_log_items(
    jobID='string',
    maxResults=123,
    nextToken='string'
)
type jobID:

string

param jobID:

[REQUIRED]

The ID of the Job for which Job log items will be retrieved.

type maxResults:

integer

param maxResults:

Maximum number of Job log items to retrieve.

type nextToken:

string

param nextToken:

The token of the next Job log items to retrieve.

rtype:

dict

returns:

Response Syntax

{
    'items': [
        {
            'logDateTime': 'string',
            'event': 'JOB_START'|'SERVER_SKIPPED'|'CLEANUP_START'|'CLEANUP_END'|'CLEANUP_FAIL'|'SNAPSHOT_START'|'SNAPSHOT_END'|'SNAPSHOT_FAIL'|'USING_PREVIOUS_SNAPSHOT'|'USING_PREVIOUS_SNAPSHOT_FAILED'|'CONVERSION_START'|'CONVERSION_END'|'CONVERSION_FAIL'|'LAUNCH_START'|'LAUNCH_FAILED'|'JOB_CANCEL'|'JOB_END'|'DEPLOY_NETWORK_CONFIGURATION_START'|'DEPLOY_NETWORK_CONFIGURATION_END'|'DEPLOY_NETWORK_CONFIGURATION_FAILED'|'UPDATE_NETWORK_CONFIGURATION_START'|'UPDATE_NETWORK_CONFIGURATION_END'|'UPDATE_NETWORK_CONFIGURATION_FAILED'|'UPDATE_LAUNCH_TEMPLATE_START'|'UPDATE_LAUNCH_TEMPLATE_END'|'UPDATE_LAUNCH_TEMPLATE_FAILED'|'NETWORK_RECOVERY_FAIL',
            'eventData': {
                'sourceServerID': 'string',
                'conversionServerID': 'string',
                'targetInstanceID': 'string',
                'rawError': 'string',
                'conversionProperties': {
                    'volumeToConversionMap': {
                        'string': {
                            'string': 'string'
                        }
                    },
                    'rootVolumeName': 'string',
                    'forceUefi': True|False,
                    'dataTimestamp': 'string',
                    'volumeToVolumeSize': {
                        'string': 123
                    },
                    'volumeToProductCodes': {
                        'string': [
                            {
                                'productCodeId': 'string',
                                'productCodeMode': 'ENABLED'|'DISABLED'
                            },
                        ]
                    }
                },
                'eventResourceData': {
                    'sourceNetworkData': {
                        'sourceNetworkID': 'string',
                        'sourceVpc': 'string',
                        'targetVpc': 'string',
                        'stackName': 'string'
                    }
                },
                'attemptCount': 123,
                'maxAttemptsCount': 123
            }
        },
    ],
    'nextToken': 'string'
}

Response Structure

  • (dict) --

    • items (list) --

      An array of Job log items.

      • (dict) --

        A log outputted by a Job.

        • logDateTime (string) --

          The date and time the log was taken.

        • event (string) --

          The event represents the type of a log.

        • eventData (dict) --

          Metadata associated with a Job log.

          • sourceServerID (string) --

            The ID of a Source Server.

          • conversionServerID (string) --

            The ID of a conversion server.

          • targetInstanceID (string) --

            The ID of a Recovery Instance.

          • rawError (string) --

            A string representing a job error.

          • conversionProperties (dict) --

            Properties of a conversion job

            • volumeToConversionMap (dict) --

              A mapping between the volumes being converted and the converted snapshot ids

              • (string) --

                • (dict) --

                  • (string) --

                    • (string) --

            • rootVolumeName (string) --

              The root volume name of a conversion job

            • forceUefi (boolean) --

              Whether the volume being converted uses UEFI or not

            • dataTimestamp (string) --

              The timestamp of when the snapshot being converted was taken

            • volumeToVolumeSize (dict) --

              A mapping between the volumes and their sizes

              • (string) --

                • (integer) --

            • volumeToProductCodes (dict) --

              A mapping between the volumes being converted and the product codes associated with them

              • (string) --

                • (list) --

                  • (dict) --

                    Properties of a product code associated with a volume.

                    • productCodeId (string) --

                      Id of a product code associated with a volume.

                    • productCodeMode (string) --

                      Mode of a product code associated with a volume.

          • eventResourceData (dict) --

            Properties of resource related to a job event.

            • sourceNetworkData (dict) --

              Source Network properties.

              • sourceNetworkID (string) --

                Source Network ID.

              • sourceVpc (string) --

                VPC ID protected by the Source Network.

              • targetVpc (string) --

                ID of the recovered VPC following Source Network recovery.

              • stackName (string) --

                CloudFormation stack name that was deployed for recovering the Source Network.

          • attemptCount (integer) --

            Retries for this operation.

          • maxAttemptsCount (integer) --

            The maximum number of retries that will be attempted if this operation failed.

    • nextToken (string) --

      The token of the next Job log items to retrieve.

DescribeReplicationConfigurationTemplates (updated) Link ¶
Changes (response) 
{'items': {'internetProtocol': 'IPV4 | IPV6'}}

Lists all ReplicationConfigurationTemplates, filtered by Source Server IDs.

See also: AWS API Documentation

Request Syntax

client.describe_replication_configuration_templates(
    replicationConfigurationTemplateIDs=[
        'string',
    ],
    maxResults=123,
    nextToken='string'
)
type replicationConfigurationTemplateIDs:

list

param replicationConfigurationTemplateIDs:

The IDs of the Replication Configuration Templates to retrieve. An empty list means all Replication Configuration Templates.

  • (string) --

type maxResults:

integer

param maxResults:

Maximum number of Replication Configuration Templates to retrieve.

type nextToken:

string

param nextToken:

The token of the next Replication Configuration Template to retrieve.

rtype:

dict

returns:

Response Syntax

{
    'items': [
        {
            'replicationConfigurationTemplateID': 'string',
            'arn': 'string',
            'stagingAreaSubnetId': 'string',
            'associateDefaultSecurityGroup': True|False,
            'replicationServersSecurityGroupsIDs': [
                'string',
            ],
            'replicationServerInstanceType': 'string',
            'useDedicatedReplicationServer': True|False,
            'defaultLargeStagingDiskType': 'GP2'|'GP3'|'ST1'|'AUTO',
            'ebsEncryption': 'DEFAULT'|'CUSTOM'|'NONE',
            'ebsEncryptionKeyArn': 'string',
            'bandwidthThrottling': 123,
            'dataPlaneRouting': 'PRIVATE_IP'|'PUBLIC_IP',
            'createPublicIP': True|False,
            'stagingAreaTags': {
                'string': 'string'
            },
            'tags': {
                'string': 'string'
            },
            'pitPolicy': [
                {
                    'ruleID': 123,
                    'units': 'MINUTE'|'HOUR'|'DAY',
                    'interval': 123,
                    'retentionDuration': 123,
                    'enabled': True|False
                },
            ],
            'autoReplicateNewDisks': True|False,
            'internetProtocol': 'IPV4'|'IPV6'
        },
    ],
    'nextToken': 'string'
}

Response Structure

  • (dict) --

    • items (list) --

      An array of Replication Configuration Templates.

      • (dict) --

        • replicationConfigurationTemplateID (string) --

          The Replication Configuration Template ID.

        • arn (string) --

          The Replication Configuration Template ARN.

        • stagingAreaSubnetId (string) --

          The subnet to be used by the replication staging area.

        • associateDefaultSecurityGroup (boolean) --

          Whether to associate the default Elastic Disaster Recovery Security group with the Replication Configuration Template.

        • replicationServersSecurityGroupsIDs (list) --

          The security group IDs that will be used by the replication server.

          • (string) --

        • replicationServerInstanceType (string) --

          The instance type to be used for the replication server.

        • useDedicatedReplicationServer (boolean) --

          Whether to use a dedicated Replication Server in the replication staging area.

        • defaultLargeStagingDiskType (string) --

          The Staging Disk EBS volume type to be used during replication.

        • ebsEncryption (string) --

          The type of EBS encryption to be used during replication.

        • ebsEncryptionKeyArn (string) --

          The ARN of the EBS encryption key to be used during replication.

        • bandwidthThrottling (integer) --

          Configure bandwidth throttling for the outbound data transfer rate of the Source Server in Mbps.

        • dataPlaneRouting (string) --

          The data plane routing mechanism that will be used for replication.

        • createPublicIP (boolean) --

          Whether to create a Public IP for the Recovery Instance by default.

        • stagingAreaTags (dict) --

          A set of tags to be associated with all resources created in the replication staging area: EC2 replication server, EBS volumes, EBS snapshots, etc.

          • (string) --

            • (string) --

        • tags (dict) --

          A set of tags to be associated with the Replication Configuration Template resource.

          • (string) --

            • (string) --

        • pitPolicy (list) --

          The Point in time (PIT) policy to manage snapshots taken during replication.

          • (dict) --

            A rule in the Point in Time (PIT) policy representing when to take snapshots and how long to retain them for.

            • ruleID (integer) --

              The ID of the rule.

            • units (string) --

              The units used to measure the interval and retentionDuration.

            • interval (integer) --

              How often, in the chosen units, a snapshot should be taken.

            • retentionDuration (integer) --

              The duration to retain a snapshot for, in the chosen units.

            • enabled (boolean) --

              Whether this rule is enabled or not.

        • autoReplicateNewDisks (boolean) --

          Whether to allow the AWS replication agent to automatically replicate newly added disks.

        • internetProtocol (string) --

          Which version of the Internet Protocol to use for replication of data. (IPv4 or IPv6)

    • nextToken (string) --

      The token of the next Replication Configuration Template to retrieve.

GetFailbackReplicationConfiguration (updated) Link ¶
Changes (response) 
{'internetProtocol': 'IPV4 | IPV6'}

Lists all Failback ReplicationConfigurations, filtered by Recovery Instance ID.

See also: AWS API Documentation

Request Syntax

client.get_failback_replication_configuration(
    recoveryInstanceID='string'
)
type recoveryInstanceID:

string

param recoveryInstanceID:

[REQUIRED]

The ID of the Recovery Instance whose failback replication configuration should be returned.

rtype:

dict

returns:

Response Syntax

{
    'recoveryInstanceID': 'string',
    'name': 'string',
    'bandwidthThrottling': 123,
    'usePrivateIP': True|False,
    'internetProtocol': 'IPV4'|'IPV6'
}

Response Structure

  • (dict) --

    • recoveryInstanceID (string) --

      The ID of the Recovery Instance.

    • name (string) --

      The name of the Failback Replication Configuration.

    • bandwidthThrottling (integer) --

      Configure bandwidth throttling for the outbound data transfer rate of the Recovery Instance in Mbps.

    • usePrivateIP (boolean) --

      Whether to use Private IP for the failback replication of the Recovery Instance.

    • internetProtocol (string) --

      Which version of the Internet Protocol to use for replication of data. (IPv4 or IPv6)

GetReplicationConfiguration (updated) Link ¶
Changes (response) 
{'internetProtocol': 'IPV4 | IPV6'}

Gets a ReplicationConfiguration, filtered by Source Server ID.

See also: AWS API Documentation

Request Syntax

client.get_replication_configuration(
    sourceServerID='string'
)
type sourceServerID:

string

param sourceServerID:

[REQUIRED]

The ID of the Source Serve for this Replication Configuration.r

rtype:

dict

returns:

Response Syntax

{
    'sourceServerID': 'string',
    'name': 'string',
    'stagingAreaSubnetId': 'string',
    'associateDefaultSecurityGroup': True|False,
    'replicationServersSecurityGroupsIDs': [
        'string',
    ],
    'replicationServerInstanceType': 'string',
    'useDedicatedReplicationServer': True|False,
    'defaultLargeStagingDiskType': 'GP2'|'GP3'|'ST1'|'AUTO',
    'replicatedDisks': [
        {
            'deviceName': 'string',
            'isBootDisk': True|False,
            'stagingDiskType': 'AUTO'|'GP2'|'GP3'|'IO1'|'SC1'|'ST1'|'STANDARD',
            'iops': 123,
            'throughput': 123,
            'optimizedStagingDiskType': 'AUTO'|'GP2'|'GP3'|'IO1'|'SC1'|'ST1'|'STANDARD'
        },
    ],
    'ebsEncryption': 'DEFAULT'|'CUSTOM'|'NONE',
    'ebsEncryptionKeyArn': 'string',
    'bandwidthThrottling': 123,
    'dataPlaneRouting': 'PRIVATE_IP'|'PUBLIC_IP',
    'createPublicIP': True|False,
    'stagingAreaTags': {
        'string': 'string'
    },
    'pitPolicy': [
        {
            'ruleID': 123,
            'units': 'MINUTE'|'HOUR'|'DAY',
            'interval': 123,
            'retentionDuration': 123,
            'enabled': True|False
        },
    ],
    'autoReplicateNewDisks': True|False,
    'internetProtocol': 'IPV4'|'IPV6'
}

Response Structure

  • (dict) --

    • sourceServerID (string) --

      The ID of the Source Server for this Replication Configuration.

    • name (string) --

      The name of the Replication Configuration.

    • stagingAreaSubnetId (string) --

      The subnet to be used by the replication staging area.

    • associateDefaultSecurityGroup (boolean) --

      Whether to associate the default Elastic Disaster Recovery Security group with the Replication Configuration.

    • replicationServersSecurityGroupsIDs (list) --

      The security group IDs that will be used by the replication server.

      • (string) --

    • replicationServerInstanceType (string) --

      The instance type to be used for the replication server.

    • useDedicatedReplicationServer (boolean) --

      Whether to use a dedicated Replication Server in the replication staging area.

    • defaultLargeStagingDiskType (string) --

      The Staging Disk EBS volume type to be used during replication.

    • replicatedDisks (list) --

      The configuration of the disks of the Source Server to be replicated.

      • (dict) --

        The configuration of a disk of the Source Server to be replicated.

        • deviceName (string) --

          The name of the device.

        • isBootDisk (boolean) --

          Whether to boot from this disk or not.

        • stagingDiskType (string) --

          The Staging Disk EBS volume type to be used during replication.

        • iops (integer) --

          The requested number of I/O operations per second (IOPS).

        • throughput (integer) --

          The throughput to use for the EBS volume in MiB/s. This parameter is valid only for gp3 volumes.

        • optimizedStagingDiskType (string) --

          The Staging Disk EBS volume type to be used during replication when stagingDiskType is set to Auto. This is a read-only field.

    • ebsEncryption (string) --

      The type of EBS encryption to be used during replication.

    • ebsEncryptionKeyArn (string) --

      The ARN of the EBS encryption key to be used during replication.

    • bandwidthThrottling (integer) --

      Configure bandwidth throttling for the outbound data transfer rate of the Source Server in Mbps.

    • dataPlaneRouting (string) --

      The data plane routing mechanism that will be used for replication.

    • createPublicIP (boolean) --

      Whether to create a Public IP for the Recovery Instance by default.

    • stagingAreaTags (dict) --

      A set of tags to be associated with all resources created in the replication staging area: EC2 replication server, EBS volumes, EBS snapshots, etc.

      • (string) --

        • (string) --

    • pitPolicy (list) --

      The Point in time (PIT) policy to manage snapshots taken during replication.

      • (dict) --

        A rule in the Point in Time (PIT) policy representing when to take snapshots and how long to retain them for.

        • ruleID (integer) --

          The ID of the rule.

        • units (string) --

          The units used to measure the interval and retentionDuration.

        • interval (integer) --

          How often, in the chosen units, a snapshot should be taken.

        • retentionDuration (integer) --

          The duration to retain a snapshot for, in the chosen units.

        • enabled (boolean) --

          Whether this rule is enabled or not.

    • autoReplicateNewDisks (boolean) --

      Whether to allow the AWS replication agent to automatically replicate newly added disks.

    • internetProtocol (string) --

      Which version of the Internet Protocol to use for replication of data. (IPv4 or IPv6)

UpdateFailbackReplicationConfiguration (updated) Link ¶
Changes (request) 
{'internetProtocol': 'IPV4 | IPV6'}

Allows you to update the failback replication configuration of a Recovery Instance by ID.

See also: AWS API Documentation

Request Syntax

client.update_failback_replication_configuration(
    recoveryInstanceID='string',
    name='string',
    bandwidthThrottling=123,
    usePrivateIP=True|False,
    internetProtocol='IPV4'|'IPV6'
)
type recoveryInstanceID:

string

param recoveryInstanceID:

[REQUIRED]

The ID of the Recovery Instance.

type name:

string

param name:

The name of the Failback Replication Configuration.

type bandwidthThrottling:

integer

param bandwidthThrottling:

Configure bandwidth throttling for the outbound data transfer rate of the Recovery Instance in Mbps.

type usePrivateIP:

boolean

param usePrivateIP:

Whether to use Private IP for the failback replication of the Recovery Instance.

type internetProtocol:

string

param internetProtocol:

Which version of the Internet Protocol to use for replication of data. (IPv4 or IPv6)

returns:

None

UpdateReplicationConfiguration (updated) Link ¶
Changes (both) 
{'internetProtocol': 'IPV4 | IPV6'}

Allows you to update a ReplicationConfiguration by Source Server ID.

See also: AWS API Documentation

Request Syntax

client.update_replication_configuration(
    sourceServerID='string',
    name='string',
    stagingAreaSubnetId='string',
    associateDefaultSecurityGroup=True|False,
    replicationServersSecurityGroupsIDs=[
        'string',
    ],
    replicationServerInstanceType='string',
    useDedicatedReplicationServer=True|False,
    defaultLargeStagingDiskType='GP2'|'GP3'|'ST1'|'AUTO',
    replicatedDisks=[
        {
            'deviceName': 'string',
            'isBootDisk': True|False,
            'stagingDiskType': 'AUTO'|'GP2'|'GP3'|'IO1'|'SC1'|'ST1'|'STANDARD',
            'iops': 123,
            'throughput': 123,
            'optimizedStagingDiskType': 'AUTO'|'GP2'|'GP3'|'IO1'|'SC1'|'ST1'|'STANDARD'
        },
    ],
    ebsEncryption='DEFAULT'|'CUSTOM'|'NONE',
    ebsEncryptionKeyArn='string',
    bandwidthThrottling=123,
    dataPlaneRouting='PRIVATE_IP'|'PUBLIC_IP',
    createPublicIP=True|False,
    stagingAreaTags={
        'string': 'string'
    },
    pitPolicy=[
        {
            'ruleID': 123,
            'units': 'MINUTE'|'HOUR'|'DAY',
            'interval': 123,
            'retentionDuration': 123,
            'enabled': True|False
        },
    ],
    autoReplicateNewDisks=True|False,
    internetProtocol='IPV4'|'IPV6'
)
type sourceServerID:

string

param sourceServerID:

[REQUIRED]

The ID of the Source Server for this Replication Configuration.

type name:

string

param name:

The name of the Replication Configuration.

type stagingAreaSubnetId:

string

param stagingAreaSubnetId:

The subnet to be used by the replication staging area.

type associateDefaultSecurityGroup:

boolean

param associateDefaultSecurityGroup:

Whether to associate the default Elastic Disaster Recovery Security group with the Replication Configuration.

type replicationServersSecurityGroupsIDs:

list

param replicationServersSecurityGroupsIDs:

The security group IDs that will be used by the replication server.

  • (string) --

type replicationServerInstanceType:

string

param replicationServerInstanceType:

The instance type to be used for the replication server.

type useDedicatedReplicationServer:

boolean

param useDedicatedReplicationServer:

Whether to use a dedicated Replication Server in the replication staging area.

type defaultLargeStagingDiskType:

string

param defaultLargeStagingDiskType:

The Staging Disk EBS volume type to be used during replication.

type replicatedDisks:

list

param replicatedDisks:

The configuration of the disks of the Source Server to be replicated.

  • (dict) --

    The configuration of a disk of the Source Server to be replicated.

    • deviceName (string) --

      The name of the device.

    • isBootDisk (boolean) --

      Whether to boot from this disk or not.

    • stagingDiskType (string) --

      The Staging Disk EBS volume type to be used during replication.

    • iops (integer) --

      The requested number of I/O operations per second (IOPS).

    • throughput (integer) --

      The throughput to use for the EBS volume in MiB/s. This parameter is valid only for gp3 volumes.

    • optimizedStagingDiskType (string) --

      The Staging Disk EBS volume type to be used during replication when stagingDiskType is set to Auto. This is a read-only field.

type ebsEncryption:

string

param ebsEncryption:

The type of EBS encryption to be used during replication.

type ebsEncryptionKeyArn:

string

param ebsEncryptionKeyArn:

The ARN of the EBS encryption key to be used during replication.

type bandwidthThrottling:

integer

param bandwidthThrottling:

Configure bandwidth throttling for the outbound data transfer rate of the Source Server in Mbps.

type dataPlaneRouting:

string

param dataPlaneRouting:

The data plane routing mechanism that will be used for replication.

type createPublicIP:

boolean

param createPublicIP:

Whether to create a Public IP for the Recovery Instance by default.

type stagingAreaTags:

dict

param stagingAreaTags:

A set of tags to be associated with all resources created in the replication staging area: EC2 replication server, EBS volumes, EBS snapshots, etc.

  • (string) --

    • (string) --

type pitPolicy:

list

param pitPolicy:

The Point in time (PIT) policy to manage snapshots taken during replication.

  • (dict) --

    A rule in the Point in Time (PIT) policy representing when to take snapshots and how long to retain them for.

    • ruleID (integer) --

      The ID of the rule.

    • units (string) -- [REQUIRED]

      The units used to measure the interval and retentionDuration.

    • interval (integer) -- [REQUIRED]

      How often, in the chosen units, a snapshot should be taken.

    • retentionDuration (integer) -- [REQUIRED]

      The duration to retain a snapshot for, in the chosen units.

    • enabled (boolean) --

      Whether this rule is enabled or not.

type autoReplicateNewDisks:

boolean

param autoReplicateNewDisks:

Whether to allow the AWS replication agent to automatically replicate newly added disks.

type internetProtocol:

string

param internetProtocol:

Which version of the Internet Protocol to use for replication of data. (IPv4 or IPv6)

rtype:

dict

returns:

Response Syntax

{
    'sourceServerID': 'string',
    'name': 'string',
    'stagingAreaSubnetId': 'string',
    'associateDefaultSecurityGroup': True|False,
    'replicationServersSecurityGroupsIDs': [
        'string',
    ],
    'replicationServerInstanceType': 'string',
    'useDedicatedReplicationServer': True|False,
    'defaultLargeStagingDiskType': 'GP2'|'GP3'|'ST1'|'AUTO',
    'replicatedDisks': [
        {
            'deviceName': 'string',
            'isBootDisk': True|False,
            'stagingDiskType': 'AUTO'|'GP2'|'GP3'|'IO1'|'SC1'|'ST1'|'STANDARD',
            'iops': 123,
            'throughput': 123,
            'optimizedStagingDiskType': 'AUTO'|'GP2'|'GP3'|'IO1'|'SC1'|'ST1'|'STANDARD'
        },
    ],
    'ebsEncryption': 'DEFAULT'|'CUSTOM'|'NONE',
    'ebsEncryptionKeyArn': 'string',
    'bandwidthThrottling': 123,
    'dataPlaneRouting': 'PRIVATE_IP'|'PUBLIC_IP',
    'createPublicIP': True|False,
    'stagingAreaTags': {
        'string': 'string'
    },
    'pitPolicy': [
        {
            'ruleID': 123,
            'units': 'MINUTE'|'HOUR'|'DAY',
            'interval': 123,
            'retentionDuration': 123,
            'enabled': True|False
        },
    ],
    'autoReplicateNewDisks': True|False,
    'internetProtocol': 'IPV4'|'IPV6'
}

Response Structure

  • (dict) --

    • sourceServerID (string) --

      The ID of the Source Server for this Replication Configuration.

    • name (string) --

      The name of the Replication Configuration.

    • stagingAreaSubnetId (string) --

      The subnet to be used by the replication staging area.

    • associateDefaultSecurityGroup (boolean) --

      Whether to associate the default Elastic Disaster Recovery Security group with the Replication Configuration.

    • replicationServersSecurityGroupsIDs (list) --

      The security group IDs that will be used by the replication server.

      • (string) --

    • replicationServerInstanceType (string) --

      The instance type to be used for the replication server.

    • useDedicatedReplicationServer (boolean) --

      Whether to use a dedicated Replication Server in the replication staging area.

    • defaultLargeStagingDiskType (string) --

      The Staging Disk EBS volume type to be used during replication.

    • replicatedDisks (list) --

      The configuration of the disks of the Source Server to be replicated.

      • (dict) --

        The configuration of a disk of the Source Server to be replicated.

        • deviceName (string) --

          The name of the device.

        • isBootDisk (boolean) --

          Whether to boot from this disk or not.

        • stagingDiskType (string) --

          The Staging Disk EBS volume type to be used during replication.

        • iops (integer) --

          The requested number of I/O operations per second (IOPS).

        • throughput (integer) --

          The throughput to use for the EBS volume in MiB/s. This parameter is valid only for gp3 volumes.

        • optimizedStagingDiskType (string) --

          The Staging Disk EBS volume type to be used during replication when stagingDiskType is set to Auto. This is a read-only field.

    • ebsEncryption (string) --

      The type of EBS encryption to be used during replication.

    • ebsEncryptionKeyArn (string) --

      The ARN of the EBS encryption key to be used during replication.

    • bandwidthThrottling (integer) --

      Configure bandwidth throttling for the outbound data transfer rate of the Source Server in Mbps.

    • dataPlaneRouting (string) --

      The data plane routing mechanism that will be used for replication.

    • createPublicIP (boolean) --

      Whether to create a Public IP for the Recovery Instance by default.

    • stagingAreaTags (dict) --

      A set of tags to be associated with all resources created in the replication staging area: EC2 replication server, EBS volumes, EBS snapshots, etc.

      • (string) --

        • (string) --

    • pitPolicy (list) --

      The Point in time (PIT) policy to manage snapshots taken during replication.

      • (dict) --

        A rule in the Point in Time (PIT) policy representing when to take snapshots and how long to retain them for.

        • ruleID (integer) --

          The ID of the rule.

        • units (string) --

          The units used to measure the interval and retentionDuration.

        • interval (integer) --

          How often, in the chosen units, a snapshot should be taken.

        • retentionDuration (integer) --

          The duration to retain a snapshot for, in the chosen units.

        • enabled (boolean) --

          Whether this rule is enabled or not.

    • autoReplicateNewDisks (boolean) --

      Whether to allow the AWS replication agent to automatically replicate newly added disks.

    • internetProtocol (string) --

      Which version of the Internet Protocol to use for replication of data. (IPv4 or IPv6)

UpdateReplicationConfigurationTemplate (updated) Link ¶
Changes (both) 
{'internetProtocol': 'IPV4 | IPV6'}

Updates a ReplicationConfigurationTemplate by ID.

See also: AWS API Documentation

Request Syntax

client.update_replication_configuration_template(
    replicationConfigurationTemplateID='string',
    arn='string',
    stagingAreaSubnetId='string',
    associateDefaultSecurityGroup=True|False,
    replicationServersSecurityGroupsIDs=[
        'string',
    ],
    replicationServerInstanceType='string',
    useDedicatedReplicationServer=True|False,
    defaultLargeStagingDiskType='GP2'|'GP3'|'ST1'|'AUTO',
    ebsEncryption='DEFAULT'|'CUSTOM'|'NONE',
    ebsEncryptionKeyArn='string',
    bandwidthThrottling=123,
    dataPlaneRouting='PRIVATE_IP'|'PUBLIC_IP',
    createPublicIP=True|False,
    stagingAreaTags={
        'string': 'string'
    },
    pitPolicy=[
        {
            'ruleID': 123,
            'units': 'MINUTE'|'HOUR'|'DAY',
            'interval': 123,
            'retentionDuration': 123,
            'enabled': True|False
        },
    ],
    autoReplicateNewDisks=True|False,
    internetProtocol='IPV4'|'IPV6'
)
type replicationConfigurationTemplateID:

string

param replicationConfigurationTemplateID:

[REQUIRED]

The Replication Configuration Template ID.

type arn:

string

param arn:

The Replication Configuration Template ARN.

type stagingAreaSubnetId:

string

param stagingAreaSubnetId:

The subnet to be used by the replication staging area.

type associateDefaultSecurityGroup:

boolean

param associateDefaultSecurityGroup:

Whether to associate the default Elastic Disaster Recovery Security group with the Replication Configuration Template.

type replicationServersSecurityGroupsIDs:

list

param replicationServersSecurityGroupsIDs:

The security group IDs that will be used by the replication server.

  • (string) --

type replicationServerInstanceType:

string

param replicationServerInstanceType:

The instance type to be used for the replication server.

type useDedicatedReplicationServer:

boolean

param useDedicatedReplicationServer:

Whether to use a dedicated Replication Server in the replication staging area.

type defaultLargeStagingDiskType:

string

param defaultLargeStagingDiskType:

The Staging Disk EBS volume type to be used during replication.

type ebsEncryption:

string

param ebsEncryption:

The type of EBS encryption to be used during replication.

type ebsEncryptionKeyArn:

string

param ebsEncryptionKeyArn:

The ARN of the EBS encryption key to be used during replication.

type bandwidthThrottling:

integer

param bandwidthThrottling:

Configure bandwidth throttling for the outbound data transfer rate of the Source Server in Mbps.

type dataPlaneRouting:

string

param dataPlaneRouting:

The data plane routing mechanism that will be used for replication.

type createPublicIP:

boolean

param createPublicIP:

Whether to create a Public IP for the Recovery Instance by default.

type stagingAreaTags:

dict

param stagingAreaTags:

A set of tags to be associated with all resources created in the replication staging area: EC2 replication server, EBS volumes, EBS snapshots, etc.

  • (string) --

    • (string) --

type pitPolicy:

list

param pitPolicy:

The Point in time (PIT) policy to manage snapshots taken during replication.

  • (dict) --

    A rule in the Point in Time (PIT) policy representing when to take snapshots and how long to retain them for.

    • ruleID (integer) --

      The ID of the rule.

    • units (string) -- [REQUIRED]

      The units used to measure the interval and retentionDuration.

    • interval (integer) -- [REQUIRED]

      How often, in the chosen units, a snapshot should be taken.

    • retentionDuration (integer) -- [REQUIRED]

      The duration to retain a snapshot for, in the chosen units.

    • enabled (boolean) --

      Whether this rule is enabled or not.

type autoReplicateNewDisks:

boolean

param autoReplicateNewDisks:

Whether to allow the AWS replication agent to automatically replicate newly added disks.

type internetProtocol:

string

param internetProtocol:

Which version of the Internet Protocol to use for replication of data. (IPv4 or IPv6)

rtype:

dict

returns:

Response Syntax

{
    'replicationConfigurationTemplateID': 'string',
    'arn': 'string',
    'stagingAreaSubnetId': 'string',
    'associateDefaultSecurityGroup': True|False,
    'replicationServersSecurityGroupsIDs': [
        'string',
    ],
    'replicationServerInstanceType': 'string',
    'useDedicatedReplicationServer': True|False,
    'defaultLargeStagingDiskType': 'GP2'|'GP3'|'ST1'|'AUTO',
    'ebsEncryption': 'DEFAULT'|'CUSTOM'|'NONE',
    'ebsEncryptionKeyArn': 'string',
    'bandwidthThrottling': 123,
    'dataPlaneRouting': 'PRIVATE_IP'|'PUBLIC_IP',
    'createPublicIP': True|False,
    'stagingAreaTags': {
        'string': 'string'
    },
    'tags': {
        'string': 'string'
    },
    'pitPolicy': [
        {
            'ruleID': 123,
            'units': 'MINUTE'|'HOUR'|'DAY',
            'interval': 123,
            'retentionDuration': 123,
            'enabled': True|False
        },
    ],
    'autoReplicateNewDisks': True|False,
    'internetProtocol': 'IPV4'|'IPV6'
}

Response Structure

  • (dict) --

    • replicationConfigurationTemplateID (string) --

      The Replication Configuration Template ID.

    • arn (string) --

      The Replication Configuration Template ARN.

    • stagingAreaSubnetId (string) --

      The subnet to be used by the replication staging area.

    • associateDefaultSecurityGroup (boolean) --

      Whether to associate the default Elastic Disaster Recovery Security group with the Replication Configuration Template.

    • replicationServersSecurityGroupsIDs (list) --

      The security group IDs that will be used by the replication server.

      • (string) --

    • replicationServerInstanceType (string) --

      The instance type to be used for the replication server.

    • useDedicatedReplicationServer (boolean) --

      Whether to use a dedicated Replication Server in the replication staging area.

    • defaultLargeStagingDiskType (string) --

      The Staging Disk EBS volume type to be used during replication.

    • ebsEncryption (string) --

      The type of EBS encryption to be used during replication.

    • ebsEncryptionKeyArn (string) --

      The ARN of the EBS encryption key to be used during replication.

    • bandwidthThrottling (integer) --

      Configure bandwidth throttling for the outbound data transfer rate of the Source Server in Mbps.

    • dataPlaneRouting (string) --

      The data plane routing mechanism that will be used for replication.

    • createPublicIP (boolean) --

      Whether to create a Public IP for the Recovery Instance by default.

    • stagingAreaTags (dict) --

      A set of tags to be associated with all resources created in the replication staging area: EC2 replication server, EBS volumes, EBS snapshots, etc.

      • (string) --

        • (string) --

    • tags (dict) --

      A set of tags to be associated with the Replication Configuration Template resource.

      • (string) --

        • (string) --

    • pitPolicy (list) --

      The Point in time (PIT) policy to manage snapshots taken during replication.

      • (dict) --

        A rule in the Point in Time (PIT) policy representing when to take snapshots and how long to retain them for.

        • ruleID (integer) --

          The ID of the rule.

        • units (string) --

          The units used to measure the interval and retentionDuration.

        • interval (integer) --

          How often, in the chosen units, a snapshot should be taken.

        • retentionDuration (integer) --

          The duration to retain a snapshot for, in the chosen units.

        • enabled (boolean) --

          Whether this rule is enabled or not.

    • autoReplicateNewDisks (boolean) --

      Whether to allow the AWS replication agent to automatically replicate newly added disks.

    • internetProtocol (string) --

      Which version of the Internet Protocol to use for replication of data. (IPv4 or IPv6)