Amazon DocumentDB · Schema

Amazon DocumentDB DBCluster

Schema representing an Amazon DocumentDB database cluster, which is a managed MongoDB-compatible document database cluster consisting of one or more instances connected to a shared storage volume.

Amazon Web ServicesDatabaseDocument DatabaseDocumentDBManaged DatabaseMongoDBNoSQL

Properties

Name Type Description
DBClusterIdentifier string The user-supplied DB cluster identifier. This identifier is the unique key that identifies a DB cluster.
DBClusterArn string The Amazon Resource Name (ARN) for the DB cluster.
Status string Specifies the current state of this DB cluster.
Engine string The name of the database engine to be used for this DB cluster.
EngineVersion string Indicates the database engine version.
Endpoint string The connection endpoint for the primary instance of the DB cluster.
ReaderEndpoint string The reader endpoint for the DB cluster. The reader endpoint load-balances connections across the read replicas.
Port integer Specifies the port that the database engine is listening on.
MasterUsername string Contains the master username for the DB cluster.
DBSubnetGroup string Specifies information on the subnet group associated with the DB cluster.
StorageEncrypted boolean Specifies whether the DB cluster is encrypted.
KmsKeyId string If StorageEncrypted is true, the AWS KMS key identifier for the encrypted DB cluster.
BackupRetentionPeriod integer Specifies the number of days for which automatic DB snapshots are retained.
PreferredBackupWindow string Specifies the daily time range during which automated backups are created.
PreferredMaintenanceWindow string Specifies the weekly time range during which system maintenance can occur.
ClusterCreateTime string Specifies the time when the DB cluster was created, in Universal Coordinated Time (UTC).
DBClusterMembers array Provides the list of instances that make up the DB cluster.
VpcSecurityGroups array Provides a list of VPC security groups that the DB cluster belongs to.
DeletionProtection boolean Specifies whether this cluster can be deleted. If DeletionProtection is enabled, the cluster cannot be deleted unless it is modified and DeletionProtection is disabled.
EnabledCloudwatchLogsExports array A list of log types that this DB cluster is configured to export to Amazon CloudWatch Logs.
View JSON Schema on GitHub

JSON Schema

amazon-documentdb-dbcluster-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://api.apis.io/schemas/amazon-documentdb-dbcluster.json",
  "title": "Amazon DocumentDB DBCluster",
  "description": "Schema representing an Amazon DocumentDB database cluster, which is a managed MongoDB-compatible document database cluster consisting of one or more instances connected to a shared storage volume.",
  "type": "object",
  "required": [
    "DBClusterIdentifier",
    "Engine"
  ],
  "properties": {
    "DBClusterIdentifier": {
      "type": "string",
      "description": "The user-supplied DB cluster identifier. This identifier is the unique key that identifies a DB cluster.",
      "minLength": 1,
      "maxLength": 63,
      "pattern": "^[a-zA-Z][a-zA-Z0-9-]*$"
    },
    "DBClusterArn": {
      "type": "string",
      "description": "The Amazon Resource Name (ARN) for the DB cluster.",
      "pattern": "^arn:aws[a-zA-Z-]*:rds:[a-z0-9-]+:[0-9]{12}:cluster:.+$"
    },
    "Status": {
      "type": "string",
      "description": "Specifies the current state of this DB cluster.",
      "enum": [
        "available",
        "backing-up",
        "creating",
        "deleting",
        "failing-over",
        "maintenance",
        "migrating",
        "modifying",
        "renaming",
        "resetting-master-credentials",
        "upgrading"
      ]
    },
    "Engine": {
      "type": "string",
      "description": "The name of the database engine to be used for this DB cluster.",
      "const": "docdb"
    },
    "EngineVersion": {
      "type": "string",
      "description": "Indicates the database engine version."
    },
    "Endpoint": {
      "type": "string",
      "description": "The connection endpoint for the primary instance of the DB cluster.",
      "format": "hostname"
    },
    "ReaderEndpoint": {
      "type": "string",
      "description": "The reader endpoint for the DB cluster. The reader endpoint load-balances connections across the read replicas.",
      "format": "hostname"
    },
    "Port": {
      "type": "integer",
      "description": "Specifies the port that the database engine is listening on.",
      "default": 27017
    },
    "MasterUsername": {
      "type": "string",
      "description": "Contains the master username for the DB cluster."
    },
    "DBSubnetGroup": {
      "type": "string",
      "description": "Specifies information on the subnet group associated with the DB cluster."
    },
    "StorageEncrypted": {
      "type": "boolean",
      "description": "Specifies whether the DB cluster is encrypted.",
      "default": false
    },
    "KmsKeyId": {
      "type": "string",
      "description": "If StorageEncrypted is true, the AWS KMS key identifier for the encrypted DB cluster."
    },
    "BackupRetentionPeriod": {
      "type": "integer",
      "description": "Specifies the number of days for which automatic DB snapshots are retained.",
      "minimum": 1,
      "maximum": 35,
      "default": 1
    },
    "PreferredBackupWindow": {
      "type": "string",
      "description": "Specifies the daily time range during which automated backups are created.",
      "pattern": "^([01]\\d|2[0-3]):[0-5]\\d-([01]\\d|2[0-3]):[0-5]\\d$"
    },
    "PreferredMaintenanceWindow": {
      "type": "string",
      "description": "Specifies the weekly time range during which system maintenance can occur."
    },
    "ClusterCreateTime": {
      "type": "string",
      "format": "date-time",
      "description": "Specifies the time when the DB cluster was created, in Universal Coordinated Time (UTC)."
    },
    "DBClusterMembers": {
      "type": "array",
      "description": "Provides the list of instances that make up the DB cluster.",
      "items": {
        "type": "object",
        "properties": {
          "DBInstanceIdentifier": {
            "type": "string",
            "description": "Specifies the instance identifier for this member of the DB cluster."
          },
          "IsClusterWriter": {
            "type": "boolean",
            "description": "A value that is true if the cluster member is the primary instance for the DB cluster."
          },
          "DBClusterParameterGroupStatus": {
            "type": "string",
            "description": "Specifies the status of the DB cluster parameter group for this member."
          },
          "PromotionTier": {
            "type": "integer",
            "description": "A value that specifies the order in which a read replica is promoted to the primary instance.",
            "minimum": 0,
            "maximum": 15
          }
        }
      }
    },
    "VpcSecurityGroups": {
      "type": "array",
      "description": "Provides a list of VPC security groups that the DB cluster belongs to.",
      "items": {
        "type": "object",
        "properties": {
          "VpcSecurityGroupId": {
            "type": "string"
          },
          "Status": {
            "type": "string"
          }
        }
      }
    },
    "DeletionProtection": {
      "type": "boolean",
      "description": "Specifies whether this cluster can be deleted. If DeletionProtection is enabled, the cluster cannot be deleted unless it is modified and DeletionProtection is disabled.",
      "default": false
    },
    "EnabledCloudwatchLogsExports": {
      "type": "array",
      "description": "A list of log types that this DB cluster is configured to export to Amazon CloudWatch Logs.",
      "items": {
        "type": "string",
        "enum": [
          "audit",
          "profiler"
        ]
      }
    }
  }
}