You are viewing documentation for version 2 of the AWS SDK for Ruby. Version 3 documentation can be found here.

Class: Aws::DocDB::Types::CreateDBInstanceMessage

Inherits:
Struct
  • Object
show all
Defined in:
(unknown)

Overview

Note:

When passing CreateDBInstanceMessage as input to an Aws::Client method, you can use a vanilla Hash:

{
  db_instance_identifier: "String", # required
  db_instance_class: "String", # required
  engine: "String", # required
  availability_zone: "String",
  preferred_maintenance_window: "String",
  auto_minor_version_upgrade: false,
  tags: [
    {
      key: "String",
      value: "String",
    },
  ],
  db_cluster_identifier: "String", # required
  promotion_tier: 1,
}

Represents the input to CreateDBInstance.

Instance Attribute Summary collapse

Instance Attribute Details

#auto_minor_version_upgradeBoolean

Indicates that minor engine upgrades are applied automatically to the instance during the maintenance window.

Default: true

Returns:

  • (Boolean)

    Indicates that minor engine upgrades are applied automatically to the instance during the maintenance window.

#availability_zoneString

The Amazon EC2 Availability Zone that the instance is created in.

Default: A random, system-chosen Availability Zone in the endpoint\'s AWS Region.

Example: us-east-1d

Returns:

  • (String)

    The Amazon EC2 Availability Zone that the instance is created in.

#db_cluster_identifierString

The identifier of the cluster that the instance will belong to.

Returns:

  • (String)

    The identifier of the cluster that the instance will belong to.

#db_instance_classString

The compute and memory capacity of the instance; for example, db.r5.large.

Returns:

  • (String)

    The compute and memory capacity of the instance; for example, db.r5.large.

#db_instance_identifierString

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

Constraints:

  • Must contain from 1 to 63 letters, numbers, or hyphens.

  • The first character must be a letter.

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

Example: mydbinstance

Returns:

  • (String)

    The instance identifier.

#engineString

The name of the database engine to be used for this instance.

Valid value: docdb

Returns:

  • (String)

    The name of the database engine to be used for this instance.

#preferred_maintenance_windowString

The time range each week during which system maintenance can occur, in Universal Coordinated Time (UTC).

Format: ddd:hh24:mi-ddd:hh24:mi

The default is a 30-minute window selected at random from an 8-hour block of time for each AWS Region, occurring on a random day of the week.

Valid days: Mon, Tue, Wed, Thu, Fri, Sat, Sun

Constraints: Minimum 30-minute window.

Returns:

  • (String)

    The time range each week during which system maintenance can occur, in Universal Coordinated Time (UTC).

#promotion_tierInteger

A value that specifies the order in which an Amazon DocumentDB replica is promoted to the primary instance after a failure of the existing primary instance.

Default: 1

Valid values: 0-15

Returns:

  • (Integer)

    A value that specifies the order in which an Amazon DocumentDB replica is promoted to the primary instance after a failure of the existing primary instance.

#tagsArray<Types::Tag>

The tags to be assigned to the instance. You can assign up to 10 tags to an instance.

Returns:

  • (Array<Types::Tag>)

    The tags to be assigned to the instance.