drs / Client / update_replication_configuration

update_replication_configuration#

drs.Client.update_replication_configuration(**kwargs)#

Allows you to update a ReplicationConfiguration by Source Server ID.

See also: AWS API Documentation

Request Syntax

response = client.update_replication_configuration(
    associateDefaultSecurityGroup=True|False,
    autoReplicateNewDisks=True|False,
    bandwidthThrottling=123,
    createPublicIP=True|False,
    dataPlaneRouting='PRIVATE_IP'|'PUBLIC_IP',
    defaultLargeStagingDiskType='GP2'|'GP3'|'ST1'|'AUTO',
    ebsEncryption='DEFAULT'|'CUSTOM'|'NONE',
    ebsEncryptionKeyArn='string',
    name='string',
    pitPolicy=[
        {
            'enabled': True|False,
            'interval': 123,
            'retentionDuration': 123,
            'ruleID': 123,
            'units': 'MINUTE'|'HOUR'|'DAY'
        },
    ],
    replicatedDisks=[
        {
            'deviceName': 'string',
            'iops': 123,
            'isBootDisk': True|False,
            'optimizedStagingDiskType': 'AUTO'|'GP2'|'GP3'|'IO1'|'SC1'|'ST1'|'STANDARD',
            'stagingDiskType': 'AUTO'|'GP2'|'GP3'|'IO1'|'SC1'|'ST1'|'STANDARD',
            'throughput': 123
        },
    ],
    replicationServerInstanceType='string',
    replicationServersSecurityGroupsIDs=[
        'string',
    ],
    sourceServerID='string',
    stagingAreaSubnetId='string',
    stagingAreaTags={
        'string': 'string'
    },
    useDedicatedReplicationServer=True|False
)
Parameters:
  • associateDefaultSecurityGroup (boolean) – Whether to associate the default Elastic Disaster Recovery Security group with the Replication Configuration.

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

  • name (string) – The name of the Replication Configuration.

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

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

      • iops (integer) –

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

      • isBootDisk (boolean) –

        Whether to boot from this disk or not.

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

      • stagingDiskType (string) –

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

      • throughput (integer) –

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

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

  • sourceServerID (string) –

    [REQUIRED]

    The ID of the Source Server for this Replication Configuration.

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

  • useDedicatedReplicationServer (boolean) – Whether to use a dedicated Replication Server in the replication staging area.

Return type:

dict

Returns:

Response Syntax

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

Response Structure

  • (dict) –

    • associateDefaultSecurityGroup (boolean) –

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

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

    • name (string) –

      The name of the Replication Configuration.

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

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

        • iops (integer) –

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

        • isBootDisk (boolean) –

          Whether to boot from this disk or not.

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

        • stagingDiskType (string) –

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

        • throughput (integer) –

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

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

    • sourceServerID (string) –

      The ID of the Source Server for this Replication Configuration.

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

    • useDedicatedReplicationServer (boolean) –

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

Exceptions

  • drs.Client.exceptions.ResourceNotFoundException

  • drs.Client.exceptions.InternalServerException

  • drs.Client.exceptions.ConflictException

  • drs.Client.exceptions.ThrottlingException

  • drs.Client.exceptions.AccessDeniedException

  • drs.Client.exceptions.ValidationException

  • drs.Client.exceptions.UninitializedAccountException