Amazon RDS · Schema

DBInstance

Describes an Amazon RDS DB instance

Cloud DatabasesDatabase ServiceDBaaSManaged DatabasesRelational Databases

Properties

Name Type Description
dBInstanceIdentifier string The user-supplied unique key that identifies the DB instance
dBInstanceClass string The name of the compute and memory capacity class of the DB instance
engine string The database engine for this DB instance
engineVersion string The version of the database engine
dBInstanceStatus string The current state of the DB instance
masterUsername string The master username for the DB instance
dBName string The name of the initial database provided during creation
endpoint object The connection endpoint for the DB instance
allocatedStorage integer The allocated storage size in gibibytes (GiB)
instanceCreateTime string The date and time the DB instance was created
preferredBackupWindow string The daily time range during which automated backups are created
backupRetentionPeriod integer The number of days for which automatic DB snapshots are retained
vpcSecurityGroups array The VPC security groups associated with the DB instance
availabilityZone string The Availability Zone where the DB instance is located
dBSubnetGroup object Information about the subnet group associated with the DB instance
multiAZ boolean Whether the DB instance is a Multi-AZ deployment
autoMinorVersionUpgrade boolean Whether minor version patches are applied automatically
storageType string The storage type associated with the DB instance
storageEncrypted boolean Whether the DB instance is encrypted
publiclyAccessible boolean Whether the DB instance is publicly accessible
dBInstanceArn string The Amazon Resource Name (ARN) for the DB instance
tags array Tags assigned to the DB instance
View JSON Schema on GitHub

JSON Schema

amazon-rds-openapi-db-instance-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/amazon-rds/refs/heads/main/json-schema/amazon-rds-openapi-db-instance-schema.json",
  "title": "DBInstance",
  "description": "Describes an Amazon RDS DB instance",
  "type": "object",
  "properties": {
    "dBInstanceIdentifier": {
      "type": "string",
      "description": "The user-supplied unique key that identifies the DB instance"
    },
    "dBInstanceClass": {
      "type": "string",
      "description": "The name of the compute and memory capacity class of the DB instance"
    },
    "engine": {
      "type": "string",
      "description": "The database engine for this DB instance"
    },
    "engineVersion": {
      "type": "string",
      "description": "The version of the database engine"
    },
    "dBInstanceStatus": {
      "type": "string",
      "description": "The current state of the DB instance",
      "enum": [
        "available",
        "backing-up",
        "configuring-enhanced-monitoring",
        "configuring-iam-database-auth",
        "configuring-log-exports",
        "creating",
        "delete-precheck",
        "deleting",
        "failed",
        "inaccessible-encryption-credentials",
        "incompatible-network",
        "incompatible-option-group",
        "incompatible-parameters",
        "incompatible-restore",
        "maintenance",
        "modifying",
        "moving-to-vpc",
        "rebooting",
        "renaming",
        "resetting-master-credentials",
        "restore-error",
        "starting",
        "stopped",
        "stopping",
        "storage-full",
        "storage-optimization",
        "upgrading"
      ]
    },
    "masterUsername": {
      "type": "string",
      "description": "The master username for the DB instance"
    },
    "dBName": {
      "type": "string",
      "description": "The name of the initial database provided during creation"
    },
    "endpoint": {
      "type": "object",
      "description": "The connection endpoint for the DB instance",
      "properties": {
        "address": {
          "type": "string",
          "description": "The DNS address of the DB instance"
        },
        "port": {
          "type": "integer",
          "description": "The port that the DB instance listens on"
        },
        "hostedZoneId": {
          "type": "string",
          "description": "The ID of the hosted zone for the DB instance"
        }
      }
    },
    "allocatedStorage": {
      "type": "integer",
      "description": "The allocated storage size in gibibytes (GiB)"
    },
    "instanceCreateTime": {
      "type": "string",
      "format": "date-time",
      "description": "The date and time the DB instance was created"
    },
    "preferredBackupWindow": {
      "type": "string",
      "description": "The daily time range during which automated backups are created"
    },
    "backupRetentionPeriod": {
      "type": "integer",
      "description": "The number of days for which automatic DB snapshots are retained"
    },
    "vpcSecurityGroups": {
      "type": "array",
      "description": "The VPC security groups associated with the DB instance",
      "items": {
        "type": "object",
        "properties": {
          "vpcSecurityGroupId": {
            "type": "string",
            "description": "The ID of the VPC security group"
          },
          "status": {
            "type": "string",
            "description": "The membership status of the VPC security group"
          }
        }
      }
    },
    "availabilityZone": {
      "type": "string",
      "description": "The Availability Zone where the DB instance is located"
    },
    "dBSubnetGroup": {
      "type": "object",
      "description": "Information about the subnet group associated with the DB instance",
      "properties": {
        "dBSubnetGroupName": {
          "type": "string",
          "description": "The name of the DB subnet group"
        },
        "dBSubnetGroupDescription": {
          "type": "string",
          "description": "The description of the DB subnet group"
        },
        "vpcId": {
          "type": "string",
          "description": "The VPC ID of the DB subnet group"
        }
      }
    },
    "multiAZ": {
      "type": "boolean",
      "description": "Whether the DB instance is a Multi-AZ deployment"
    },
    "autoMinorVersionUpgrade": {
      "type": "boolean",
      "description": "Whether minor version patches are applied automatically"
    },
    "storageType": {
      "type": "string",
      "description": "The storage type associated with the DB instance"
    },
    "storageEncrypted": {
      "type": "boolean",
      "description": "Whether the DB instance is encrypted"
    },
    "publiclyAccessible": {
      "type": "boolean",
      "description": "Whether the DB instance is publicly accessible"
    },
    "dBInstanceArn": {
      "type": "string",
      "description": "The Amazon Resource Name (ARN) for the DB instance"
    },
    "tags": {
      "type": "array",
      "description": "Tags assigned to the DB instance",
      "items": {
        "$ref": "#/components/schemas/Tag"
      }
    }
  }
}