drs / Client / create_replication_configuration_template

create_replication_configuration_template

drs.Client.create_replication_configuration_template(**kwargs)

Creates a new ReplicationConfigurationTemplate.

See also: AWS API Documentation

Request Syntax

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

Parameters:

• associateDefaultSecurityGroup (boolean) –

  [REQUIRED]

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

• autoReplicateNewDisks (boolean) – Whether to allow the AWS replication agent to automatically replicate newly added disks.

• bandwidthThrottling (integer) –

  [REQUIRED]

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

• createPublicIP (boolean) –

  [REQUIRED]

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

• dataPlaneRouting (string) –

  [REQUIRED]

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

• defaultLargeStagingDiskType (string) –

  [REQUIRED]

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

• ebsEncryption (string) –

  [REQUIRED]

  The type of EBS encryption to be used during replication.

• ebsEncryptionKeyArn (string) – The ARN of the EBS encryption key to be used during replication.

• pitPolicy (list) –

  [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.

    • enabled (boolean) –

      Whether this rule is enabled or not.

    • 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.

    • ruleID (integer) –

      The ID of the rule.

    • units (string) – [REQUIRED]

      The units used to measure the interval and retentionDuration.

• replicationServerInstanceType (string) –

  [REQUIRED]

  The instance type to be used for the replication server.

• replicationServersSecurityGroupsIDs (list) –

  [REQUIRED]

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

  • (string) –

• stagingAreaSubnetId (string) –

  [REQUIRED]

  The subnet to be used by the replication staging area.

• stagingAreaTags (dict) –

  [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) –

• tags (dict) –

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

  • (string) –

    • (string) –

• useDedicatedReplicationServer (boolean) –

  [REQUIRED]

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

Return type:

dict

Returns:

Response Syntax

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

Response Structure

• (dict) –

  • arn (string) –

    The Replication Configuration Template ARN.

  • associateDefaultSecurityGroup (boolean) –

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

  • autoReplicateNewDisks (boolean) –

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

  • bandwidthThrottling (integer) –

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

  • createPublicIP (boolean) –

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

  • dataPlaneRouting (string) –

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

  • 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.

  • 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.

      • enabled (boolean) –

        Whether this rule is enabled or not.

      • 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.

      • ruleID (integer) –

        The ID of the rule.

      • units (string) –

        The units used to measure the interval and retentionDuration.

  • replicationConfigurationTemplateID (string) –

    The Replication Configuration Template ID.

  • replicationServerInstanceType (string) –

    The instance type to be used for the replication server.

  • replicationServersSecurityGroupsIDs (list) –

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

    • (string) –

  • stagingAreaSubnetId (string) –

    The subnet to be used by the replication staging area.

  • 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) –

  • useDedicatedReplicationServer (boolean) –

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

Exceptions

• drs.Client.exceptions.InternalServerException

• drs.Client.exceptions.ServiceQuotaExceededException

• drs.Client.exceptions.ThrottlingException

• drs.Client.exceptions.AccessDeniedException

• drs.Client.exceptions.ValidationException

• drs.Client.exceptions.UninitializedAccountException