AWS Database Migration Service

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

Changes  Update dms client to latest version

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.