Amazon RDS · JSON Structure

Amazon Rds Openapi Db Cluster Structure

Describes an Amazon Aurora DB cluster

Type: object Properties: 18
Cloud DatabasesDatabase ServiceDBaaSManaged DatabasesRelational Databases

DBCluster is a JSON Structure definition published by Amazon RDS, describing 18 properties. It conforms to the https://json-structure.org/meta/core/v0/# meta-schema.

Properties

dBClusterIdentifier dBClusterArn status engine engineVersion databaseName masterUsername endpoint readerEndpoint port dBClusterMembers availabilityZones backupRetentionPeriod storageEncrypted multiAZ clusterCreateTime allocatedStorage tags

Meta-schema: https://json-structure.org/meta/core/v0/#

JSON Structure

Raw ↑
{
  "$schema": "https://json-structure.org/meta/core/v0/#",
  "$id": "https://raw.githubusercontent.com/api-evangelist/amazon-rds/refs/heads/main/json-structure/amazon-rds-openapi-db-cluster-structure.json",
  "description": "Describes an Amazon Aurora DB cluster",
  "type": "object",
  "properties": {
    "dBClusterIdentifier": {
      "type": "string",
      "description": "The user-supplied identifier for the DB cluster"
    },
    "dBClusterArn": {
      "type": "string",
      "description": "The Amazon Resource Name (ARN) for the DB cluster"
    },
    "status": {
      "type": "string",
      "description": "The current state of the DB cluster"
    },
    "engine": {
      "type": "string",
      "description": "The database engine for the DB cluster"
    },
    "engineVersion": {
      "type": "string",
      "description": "The version of the database engine"
    },
    "databaseName": {
      "type": "string",
      "description": "The name of the initial database"
    },
    "masterUsername": {
      "type": "string",
      "description": "The master username for the DB cluster"
    },
    "endpoint": {
      "type": "string",
      "description": "The DNS address of the primary instance of the DB cluster"
    },
    "readerEndpoint": {
      "type": "string",
      "description": "The reader endpoint for the DB cluster"
    },
    "port": {
      "type": "int32",
      "description": "The port that the database engine is listening on"
    },
    "dBClusterMembers": {
      "type": "array",
      "description": "The list of DB instances that are part of the cluster",
      "items": {
        "type": "object",
        "properties": {
          "dBInstanceIdentifier": {
            "type": "string",
            "description": "The instance identifier for the cluster member"
          },
          "isClusterWriter": {
            "type": "boolean",
            "description": "Whether the cluster member is the primary instance"
          },
          "dBClusterParameterGroupStatus": {
            "type": "string",
            "description": "The status of the parameter group for this member"
          }
        }
      }
    },
    "availabilityZones": {
      "type": "array",
      "description": "The Availability Zones the DB cluster is associated with",
      "items": {
        "type": "string"
      }
    },
    "backupRetentionPeriod": {
      "type": "int32",
      "description": "The number of days for which automatic DB snapshots are retained"
    },
    "storageEncrypted": {
      "type": "boolean",
      "description": "Whether the DB cluster is encrypted"
    },
    "multiAZ": {
      "type": "boolean",
      "description": "Whether the DB cluster has instances in multiple AZs"
    },
    "clusterCreateTime": {
      "type": "datetime",
      "description": "The time when the DB cluster was created"
    },
    "allocatedStorage": {
      "type": "int32",
      "description": "The current allocated storage size in GiB for the cluster"
    },
    "tags": {
      "type": "array",
      "description": "Tags assigned to the DB cluster",
      "items": {
        "$ref": "#/components/schemas/Tag"
      }
    }
  },
  "name": "DBCluster"
}