Package software.amazon.awssdk.services.databasemigration.model

Class ReplicationInstance

java.lang.Object
software.amazon.awssdk.services.databasemigration.model.ReplicationInstance
All Implemented Interfaces:
Serializable, SdkPojo, ToCopyableBuilder<ReplicationInstance.Builder,ReplicationInstance>
@Generated("software.amazon.awssdk:codegen") public final class ReplicationInstance extends Object implements SdkPojo, Serializable, ToCopyableBuilder<ReplicationInstance.Builder,ReplicationInstance>

Provides information that defines a replication instance.

See Also:

  • Method Details

    • replicationInstanceIdentifier

      public final String replicationInstanceIdentifier()

      The replication instance identifier is a required parameter. This parameter is stored as a lowercase string.

      Constraints:

      • Must contain 1-63 alphanumeric characters or hyphens.

      • First character must be a letter.

      • Cannot end with a hyphen or contain two consecutive hyphens.

      Example: myrepinstance

      Returns:
      The replication instance identifier is a required parameter. This parameter is stored as a lowercase string.

      Constraints:

      • Must contain 1-63 alphanumeric characters or hyphens.

      • First character must be a letter.

      • Cannot end with a hyphen or contain two consecutive hyphens.

      Example: myrepinstance

    • replicationInstanceClass

      public final String replicationInstanceClass()

      The compute and memory capacity of the replication instance as defined for the specified replication instance class. It is a required parameter, although a default value is pre-selected in the DMS console.

      For more information on the settings and capacities for the available replication instance classes, see Selecting the right DMS replication instance for your migration.

      Returns:
      The compute and memory capacity of the replication instance as defined for the specified replication instance class. It is a required parameter, although a default value is pre-selected in the DMS console.

      For more information on the settings and capacities for the available replication instance classes, see Selecting the right DMS replication instance for your migration.

    • replicationInstanceStatus

      public final String replicationInstanceStatus()

      The status of the replication instance. The possible return values include:

      • "available"

      • "creating"

      • "deleted"

      • "deleting"

      • "failed"

      • "modifying"

      • "upgrading"

      • "rebooting"

      • "resetting-master-credentials"

      • "storage-full"

      • "incompatible-credentials"

      • "incompatible-network"

      • "maintenance"

      Returns:
      The status of the replication instance. The possible return values include:

      • "available"

      • "creating"

      • "deleted"

      • "deleting"

      • "failed"

      • "modifying"

      • "upgrading"

      • "rebooting"

      • "resetting-master-credentials"

      • "storage-full"

      • "incompatible-credentials"

      • "incompatible-network"

      • "maintenance"

    • allocatedStorage

      public final Integer allocatedStorage()

      The amount of storage (in gigabytes) that is allocated for the replication instance.

      Returns:
      The amount of storage (in gigabytes) that is allocated for the replication instance.

    • instanceCreateTime

      public final Instant instanceCreateTime()

      The time the replication instance was created.

      Returns:
      The time the replication instance was created.

    • hasVpcSecurityGroups

      public final boolean hasVpcSecurityGroups()
      For responses, this returns true if the service returned a value for the VpcSecurityGroups property. This DOES NOT check that the value is non-empty (for which, you should check the isEmpty() method on the property). This is useful because the SDK will never return a null collection or map, but you may need to differentiate between the service returning nothing (or null) and the service returning an empty collection or map. For requests, this returns true if a value for the property was specified in the request builder, and false if a value was not specified.

    • vpcSecurityGroups

      public final List<VpcSecurityGroupMembership> vpcSecurityGroups()

      The VPC security group for the instance.

      Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.

      This method will never return null. If you would like to know whether the service returned this field (so that you can differentiate between null and empty), you can use the hasVpcSecurityGroups() method.

      Returns:
      The VPC security group for the instance.

    • availabilityZone

      public final String availabilityZone()

      The Availability Zone for the instance.

      Returns:
      The Availability Zone for the instance.

    • replicationSubnetGroup

      public final ReplicationSubnetGroup replicationSubnetGroup()

      The subnet group for the replication instance.

      Returns:
      The subnet group for the replication instance.

    • preferredMaintenanceWindow

      public final String preferredMaintenanceWindow()

      The maintenance window times for the replication instance. Any pending upgrades to the replication instance are performed during this time.

      Returns:
      The maintenance window times for the replication instance. Any pending upgrades to the replication instance are performed during this time.

    • pendingModifiedValues

      public final ReplicationPendingModifiedValues pendingModifiedValues()

      The pending modification values.

      Returns:
      The pending modification values.

    • multiAZ

      public final Boolean multiAZ()

      Specifies whether the replication instance is a Multi-AZ deployment. You can't set the AvailabilityZone parameter if the Multi-AZ parameter is set to true.

      Returns:
      Specifies whether the replication instance is a Multi-AZ deployment. You can't set the AvailabilityZone parameter if the Multi-AZ parameter is set to true.

    • engineVersion

      public final String engineVersion()

      The engine version number of the replication instance.

      If an engine version number is not specified when a replication instance is created, the default is the latest engine version available.

      When modifying a major engine version of an instance, also set AllowMajorVersionUpgrade to true.

      Returns:
      The engine version number of the replication instance.

      If an engine version number is not specified when a replication instance is created, the default is the latest engine version available.

      When modifying a major engine version of an instance, also set AllowMajorVersionUpgrade to true.

    • autoMinorVersionUpgrade

      public final Boolean autoMinorVersionUpgrade()

      Boolean value indicating if minor version upgrades will be automatically applied to the instance.

      Returns:
      Boolean value indicating if minor version upgrades will be automatically applied to the instance.

    • kmsKeyId

      public final String kmsKeyId()

      An KMS key identifier that is used to encrypt the data on the replication instance.

      If you don't specify a value for the KmsKeyId parameter, then DMS uses your default encryption key.

      KMS creates the default encryption key for your Amazon Web Services account. Your Amazon Web Services account has a different default encryption key for each Amazon Web Services Region.

      Returns:
      An KMS key identifier that is used to encrypt the data on the replication instance.

      If you don't specify a value for the KmsKeyId parameter, then DMS uses your default encryption key.

      KMS creates the default encryption key for your Amazon Web Services account. Your Amazon Web Services account has a different default encryption key for each Amazon Web Services Region.

    • replicationInstanceArn

      public final String replicationInstanceArn()

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

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

    • replicationInstancePublicIpAddress

      @Deprecated public final String replicationInstancePublicIpAddress()
      Deprecated.

      The public IP address of the replication instance.

      Returns:
      The public IP address of the replication instance.

    • replicationInstancePrivateIpAddress

      @Deprecated public final String replicationInstancePrivateIpAddress()
      Deprecated.

      The private IP address of the replication instance.

      Returns:
      The private IP address of the replication instance.

    • hasReplicationInstancePublicIpAddresses

      public final boolean hasReplicationInstancePublicIpAddresses()
      For responses, this returns true if the service returned a value for the ReplicationInstancePublicIpAddresses property. This DOES NOT check that the value is non-empty (for which, you should check the isEmpty() method on the property). This is useful because the SDK will never return a null collection or map, but you may need to differentiate between the service returning nothing (or null) and the service returning an empty collection or map. For requests, this returns true if a value for the property was specified in the request builder, and false if a value was not specified.

    • replicationInstancePublicIpAddresses

      public final List<String> replicationInstancePublicIpAddresses()

      One or more public IP addresses for the replication instance.

      Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.

      This method will never return null. If you would like to know whether the service returned this field (so that you can differentiate between null and empty), you can use the hasReplicationInstancePublicIpAddresses() method.

      Returns:
      One or more public IP addresses for the replication instance.

    • hasReplicationInstancePrivateIpAddresses

      public final boolean hasReplicationInstancePrivateIpAddresses()
      For responses, this returns true if the service returned a value for the ReplicationInstancePrivateIpAddresses property. This DOES NOT check that the value is non-empty (for which, you should check the isEmpty() method on the property). This is useful because the SDK will never return a null collection or map, but you may need to differentiate between the service returning nothing (or null) and the service returning an empty collection or map. For requests, this returns true if a value for the property was specified in the request builder, and false if a value was not specified.

    • replicationInstancePrivateIpAddresses

      public final List<String> replicationInstancePrivateIpAddresses()

      One or more private IP addresses for the replication instance.

      Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.

      This method will never return null. If you would like to know whether the service returned this field (so that you can differentiate between null and empty), you can use the hasReplicationInstancePrivateIpAddresses() method.

      Returns:
      One or more private IP addresses for the replication instance.

    • hasReplicationInstanceIpv6Addresses

      public final boolean hasReplicationInstanceIpv6Addresses()
      For responses, this returns true if the service returned a value for the ReplicationInstanceIpv6Addresses property. This DOES NOT check that the value is non-empty (for which, you should check the isEmpty() method on the property). This is useful because the SDK will never return a null collection or map, but you may need to differentiate between the service returning nothing (or null) and the service returning an empty collection or map. For requests, this returns true if a value for the property was specified in the request builder, and false if a value was not specified.

    • replicationInstanceIpv6Addresses

      public final List<String> replicationInstanceIpv6Addresses()

      One or more IPv6 addresses for the replication instance.

      Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.

      This method will never return null. If you would like to know whether the service returned this field (so that you can differentiate between null and empty), you can use the hasReplicationInstanceIpv6Addresses() method.

      Returns:
      One or more IPv6 addresses for the replication instance.

    • publiclyAccessible

      public final Boolean publiclyAccessible()

      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.

      Returns:
      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

      public final String secondaryAvailabilityZone()

      The Availability Zone of the standby replication instance in a Multi-AZ deployment.

      Returns:
      The Availability Zone of the standby replication instance in a Multi-AZ deployment.

    • freeUntil

      public final Instant freeUntil()

      The expiration date of the free replication instance that is part of the Free DMS program.

      Returns:
      The expiration date of the free replication instance that is part of the Free DMS program.

    • dnsNameServers

      public final String dnsNameServers()

      The DNS name servers supported for the replication instance to access your on-premise source or target database.

      Returns:
      The DNS name servers supported for the replication instance to access your on-premise source or target database.

    • networkType

      public final String networkType()

      The type of IP address protocol used by a replication instance, such as IPv4 only or Dual-stack that supports both IPv4 and IPv6 addressing. IPv6 only is not yet supported.

      Returns:
      The type of IP address protocol used by a replication instance, such as IPv4 only or Dual-stack that supports both IPv4 and IPv6 addressing. IPv6 only is not yet supported.

    • toBuilder

      public ReplicationInstance.Builder toBuilder()
      Description copied from interface: ToCopyableBuilder
      Take this object and create a builder that contains all of the current property values of this object.
      Specified by:
      toBuilder in interface ToCopyableBuilder<ReplicationInstance.Builder,ReplicationInstance>
      Returns:
      a builder for type T

    • builder

      public static ReplicationInstance.Builder builder()

    • serializableBuilderClass

      public static Class<? extends ReplicationInstance.Builder> serializableBuilderClass()

    • hashCode

      public final int hashCode()
      Overrides:
      hashCode in class Object

    • equals

      public final boolean equals(Object obj)
      Overrides:
      equals in class Object

    • equalsBySdkFields

      public final boolean equalsBySdkFields(Object obj)
      Description copied from interface: SdkPojo
      Indicates whether some other object is "equal to" this one by SDK fields. An SDK field is a modeled, non-inherited field in an SdkPojo class, and is generated based on a service model.

      If an SdkPojo class does not have any inherited fields, equalsBySdkFields and equals are essentially the same.

      Specified by:
      equalsBySdkFields in interface SdkPojo
      Parameters:
      obj - the object to be compared with
      Returns:
      true if the other object equals to this object by sdk fields, false otherwise.

    • toString

      public final String toString()
      Returns a string representation of this object. This is useful for testing and debugging. Sensitive data will be redacted from this string using a placeholder value.
      Overrides:
      toString in class Object

    • getValueForField

      public final <T> Optional<T> getValueForField(String fieldName, Class<T> clazz)

    • sdkFields

      public final List<SdkField<?>> sdkFields()
      Specified by:
      sdkFields in interface SdkPojo
      Returns:
      List of SdkField in this POJO. May be empty list but should never be null.