GetReplicationConfigurationCommand

Gets a ReplicationConfiguration, filtered by Source Server ID.

Example Syntax

Use a bare-bones client and the command you need to make an API call.

import { DrsClient, GetReplicationConfigurationCommand } from "@aws-sdk/client-drs"; // ES Modules import
// const { DrsClient, GetReplicationConfigurationCommand } = require("@aws-sdk/client-drs"); // CommonJS import
const client = new DrsClient(config);
const input = { // GetReplicationConfigurationRequest
  sourceServerID: "STRING_VALUE", // required
};
const command = new GetReplicationConfigurationCommand(input);
const response = await client.send(command);
// { // ReplicationConfiguration
//   sourceServerID: "STRING_VALUE",
//   name: "STRING_VALUE",
//   stagingAreaSubnetId: "STRING_VALUE",
//   associateDefaultSecurityGroup: true || false,
//   replicationServersSecurityGroupsIDs: [ // ReplicationServersSecurityGroupsIDs
//     "STRING_VALUE",
//   ],
//   replicationServerInstanceType: "STRING_VALUE",
//   useDedicatedReplicationServer: true || false,
//   defaultLargeStagingDiskType: "STRING_VALUE",
//   replicatedDisks: [ // ReplicationConfigurationReplicatedDisks
//     { // ReplicationConfigurationReplicatedDisk
//       deviceName: "STRING_VALUE",
//       isBootDisk: true || false,
//       stagingDiskType: "STRING_VALUE",
//       iops: Number("long"),
//       throughput: Number("long"),
//       optimizedStagingDiskType: "STRING_VALUE",
//     },
//   ],
//   ebsEncryption: "STRING_VALUE",
//   ebsEncryptionKeyArn: "STRING_VALUE",
//   bandwidthThrottling: Number("long"),
//   dataPlaneRouting: "STRING_VALUE",
//   createPublicIP: true || false,
//   stagingAreaTags: { // TagsMap
//     "<keys>": "STRING_VALUE",
//   },
//   pitPolicy: [ // PITPolicy
//     { // PITPolicyRule
//       ruleID: Number("long"),
//       units: "STRING_VALUE", // required
//       interval: Number("int"), // required
//       retentionDuration: Number("int"), // required
//       enabled: true || false,
//     },
//   ],
//   autoReplicateNewDisks: true || false,
// };

GetReplicationConfigurationCommand Input

Parameter
Type
Description
sourceServerID
Required
string | undefined

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

GetReplicationConfigurationCommand Output

Parameter
Type
Description
$metadata
Required
ResponseMetadata
Metadata pertaining to this request.
associateDefaultSecurityGroup
boolean | undefined

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

autoReplicateNewDisks
boolean | undefined

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

bandwidthThrottling
number | undefined

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

createPublicIP
boolean | undefined

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

dataPlaneRouting
ReplicationConfigurationDataPlaneRouting | undefined

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

defaultLargeStagingDiskType
ReplicationConfigurationDefaultLargeStagingDiskType | undefined

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

ebsEncryption
ReplicationConfigurationEbsEncryption | undefined

The type of EBS encryption to be used during replication.

ebsEncryptionKeyArn
string | undefined

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

name
string | undefined

The name of the Replication Configuration.

pitPolicy
PITPolicyRule[] | undefined

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

replicatedDisks
ReplicationConfigurationReplicatedDisk[] | undefined

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

replicationServerInstanceType
string | undefined

The instance type to be used for the replication server.

replicationServersSecurityGroupsIDs
string[] | undefined

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

sourceServerID
string | undefined

The ID of the Source Server for this Replication Configuration.

stagingAreaSubnetId
string | undefined

The subnet to be used by the replication staging area.

stagingAreaTags
Record<string, string> | undefined

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

useDedicatedReplicationServer
boolean | undefined

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

Throws

Name
Fault
Details
AccessDeniedException
client

You do not have sufficient access to perform this action.

InternalServerException
server

The request processing has failed because of an unknown error, exception or failure.

ResourceNotFoundException
client

The resource for this operation was not found.

ThrottlingException
client

The request was denied due to request throttling.

UninitializedAccountException
client

The account performing the request has not been initialized.

DrsServiceException
Base exception class for all service exceptions from Drs service.