AWS API Changes

2018/02/08 - AWS Database Migration Service - 2 new api methods

Changes This release includes the addition of two new APIs: describe replication instance task logs and reboot instance. The first allows user to see how much storage each log for a task on a given instance is occupying. The second gives users the option to reboot the application software on the instance and force a fail over for MAZ instances to test robustness of their integration with our service.

DescribeReplicationInstanceTaskLogs (new)

Link ¶

Returns information about the task logs for the specified task.

See also: AWS API Documentation

Request Syntax

client.describe_replication_instance_task_logs(
    ReplicationInstanceArn='string',
    MaxRecords=123,
    Marker='string'
)

type ReplicationInstanceArn

string

param ReplicationInstanceArn

[REQUIRED]

The Amazon Resource Name (ARN) of the replication instance.

type MaxRecords

integer

param MaxRecords

The maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a pagination token called a marker is included in the response so that the remaining results can be retrieved.

Default: 100

Constraints: Minimum 20, maximum 100.

type Marker

string

param Marker

An optional pagination token provided by a previous request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords .

rtype

dict

returns

Response Syntax

{
    'ReplicationInstanceArn': 'string',
    'ReplicationInstanceTaskLogs': [
        {
            'ReplicationTaskName': 'string',
            'ReplicationTaskArn': 'string',
            'ReplicationInstanceTaskLogSize': 123
        },
    ],
    'Marker': 'string'
}

Response Structure

(dict) --
- ReplicationInstanceArn (string) --
  
  The Amazon Resource Name (ARN) of the replication instance.
- ReplicationInstanceTaskLogs (list) --
  
  An array of replication task log metadata. Each member of the array contains the replication task name, ARN, and task log size (in bytes).
  - (dict) --
    
    Contains metadata for a replication instance task log.
    - ReplicationTaskName (string) --
      
      The name of the replication task.
    - ReplicationTaskArn (string) --
      
      The Amazon Resource Name (ARN) of the replication task.
    - ReplicationInstanceTaskLogSize (integer) --
      
      The size, in bytes, of the replication task log.
- Marker (string) --
  
  An optional pagination token provided by a previous request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords .

RebootReplicationInstance (new)

Link ¶

Reboots a replication instance. Rebooting results in a momentary outage, until the replication instance becomes available again.

See also: AWS API Documentation

Request Syntax

client.reboot_replication_instance(
    ReplicationInstanceArn='string',
    ForceFailover=True|False
)

type ReplicationInstanceArn

string

param ReplicationInstanceArn

[REQUIRED]

The Amazon Resource Name (ARN) of the replication instance.

type ForceFailover

boolean

param ForceFailover

If this parameter is true , the reboot is conducted through a Multi-AZ failover. (If the instance isn't configured for Multi-AZ, then you can't specify true .)

rtype

dict

returns

Response Syntax

{
    'ReplicationInstance': {
        'ReplicationInstanceIdentifier': 'string',
        'ReplicationInstanceClass': 'string',
        'ReplicationInstanceStatus': 'string',
        'AllocatedStorage': 123,
        'InstanceCreateTime': datetime(2015, 1, 1),
        'VpcSecurityGroups': [
            {
                'VpcSecurityGroupId': 'string',
                'Status': 'string'
            },
        ],
        'AvailabilityZone': 'string',
        'ReplicationSubnetGroup': {
            'ReplicationSubnetGroupIdentifier': 'string',
            'ReplicationSubnetGroupDescription': 'string',
            'VpcId': 'string',
            'SubnetGroupStatus': 'string',
            'Subnets': [
                {
                    'SubnetIdentifier': 'string',
                    'SubnetAvailabilityZone': {
                        'Name': 'string'
                    },
                    'SubnetStatus': 'string'
                },
            ]
        },
        'PreferredMaintenanceWindow': 'string',
        'PendingModifiedValues': {
            'ReplicationInstanceClass': 'string',
            'AllocatedStorage': 123,
            'MultiAZ': True|False,
            'EngineVersion': 'string'
        },
        'MultiAZ': True|False,
        'EngineVersion': 'string',
        'AutoMinorVersionUpgrade': True|False,
        'KmsKeyId': 'string',
        'ReplicationInstanceArn': 'string',
        'ReplicationInstancePublicIpAddress': 'string',
        'ReplicationInstancePrivateIpAddress': 'string',
        'ReplicationInstancePublicIpAddresses': [
            'string',
        ],
        'ReplicationInstancePrivateIpAddresses': [
            'string',
        ],
        'PubliclyAccessible': True|False,
        'SecondaryAvailabilityZone': 'string'
    }
}

Response Structure

(dict) --
- ReplicationInstance (dict) --
  
  The replication instance that is being rebooted.
  - ReplicationInstanceIdentifier (string) --
    
    The replication instance identifier. This parameter is stored as a lowercase string.
    
    Constraints:
    - Must contain from 1 to 63 alphanumeric characters or hyphens.
    - First character must be a letter.
    - Cannot end with a hyphen or contain two consecutive hyphens.
    Example: myrepinstance
  - ReplicationInstanceClass (string) --
    
    The compute and memory capacity of the replication instance.
    
    Valid Values: dms.t2.micro | dms.t2.small | dms.t2.medium | dms.t2.large | dms.c4.large | dms.c4.xlarge | dms.c4.2xlarge | dms.c4.4xlarge
  - ReplicationInstanceStatus (string) --
    
    The status of the replication instance.
  - AllocatedStorage (integer) --
    
    The amount of storage (in gigabytes) that is allocated for the replication instance.
  - InstanceCreateTime (datetime) --
    
    The time the replication instance was created.
  - VpcSecurityGroups (list) --
    
    The VPC security group for the instance.
    - (dict) --
      - VpcSecurityGroupId (string) --
        
        The VPC security group Id.
      - Status (string) --
        
        The status of the VPC security group.
  - AvailabilityZone (string) --
    
    The Availability Zone for the instance.
  - ReplicationSubnetGroup (dict) --
    
    The subnet group for the replication instance.
    - ReplicationSubnetGroupIdentifier (string) --
      
      The identifier of the replication instance subnet group.
    - ReplicationSubnetGroupDescription (string) --
      
      The description of the replication subnet group.
    - VpcId (string) --
      
      The ID of the VPC.
    - SubnetGroupStatus (string) --
      
      The status of the subnet group.
    - Subnets (list) --
      
      The subnets that are in the subnet group.
      - (dict) --
        
        SubnetIdentifier (string) --
        
        The subnet identifier.
        
        SubnetAvailabilityZone (dict) --
        
        The Availability Zone of the subnet.
        
        Name (string) --
        
        The name of the availability zone.
        
        SubnetStatus (string) --
        
        The status of the subnet.
  - PreferredMaintenanceWindow (string) --
    
    The maintenance window times for the replication instance.
  - PendingModifiedValues (dict) --
    
    The pending modification values.
    - ReplicationInstanceClass (string) --
      
      The compute and memory capacity of the replication instance.
      
      Valid Values: dms.t2.micro | dms.t2.small | dms.t2.medium | dms.t2.large | dms.c4.large | dms.c4.xlarge | dms.c4.2xlarge | dms.c4.4xlarge
    - AllocatedStorage (integer) --
      
      The amount of storage (in gigabytes) that is allocated for the replication instance.
    - MultiAZ (boolean) --
      
      Specifies if the replication instance is a Multi-AZ deployment. You cannot set the AvailabilityZone parameter if the Multi-AZ parameter is set to true .
    - EngineVersion (string) --
      
      The engine version number of the replication instance.
  - MultiAZ (boolean) --
    
    Specifies if the replication instance is a Multi-AZ deployment. You cannot set the AvailabilityZone parameter if the Multi-AZ parameter is set to true .
  - EngineVersion (string) --
    
    The engine version number of the replication instance.
  - AutoMinorVersionUpgrade (boolean) --
    
    Boolean value indicating if minor version upgrades will be automatically applied to the instance.
  - KmsKeyId (string) --
    
    The KMS key identifier that is used to encrypt the content on the replication instance. If you do not specify a value for the KmsKeyId parameter, then AWS DMS will use your default encryption key. AWS KMS creates the default encryption key for your AWS account. Your AWS account has a different default encryption key for each AWS region.
  - ReplicationInstanceArn (string) --
    
    The Amazon Resource Name (ARN) of the replication instance.
  - ReplicationInstancePublicIpAddress (string) --
    
    The public IP address of the replication instance.
  - ReplicationInstancePrivateIpAddress (string) --
    
    The private IP address of the replication instance.
  - ReplicationInstancePublicIpAddresses (list) --
    
    The public IP address of the replication instance.
    - (string) --
  - ReplicationInstancePrivateIpAddresses (list) --
    
    The private IP address of the replication instance.
    - (string) --
  - PubliclyAccessible (boolean) --
    
    Specifies the accessibility options for the replication instance. A value of true represents an instance with a public IP address. A value of false represents an instance with a private IP address. The default value is true .
  - SecondaryAvailabilityZone (string) --
    
    The availability zone of the standby replication instance in a Multi-AZ deployment.