DBCluster

rds.services.k8s.aws/v1alpha1

TypeLink
GoDocrds-controller/apis/v1alpha1#DBCluster

Metadata

PropertyValue
ScopeNamespaced
KindDBCluster
ListKindDBClusterList
Pluraldbclusters
Singulardbcluster

Contains the details of an Amazon Aurora DB cluster or Multi-AZ DB cluster.

For an Amazon Aurora DB cluster, this data type is used as a response element in the operations CreateDBCluster, DeleteDBCluster, DescribeDBClusters, FailoverDBCluster, ModifyDBCluster, PromoteReadReplicaDBCluster, RestoreDBClusterFromS3, RestoreDBClusterFromSnapshot, RestoreDBClusterToPointInTime, StartDBCluster, and StopDBCluster.

For a Multi-AZ DB cluster, this data type is used as a response element in the operations CreateDBCluster, DeleteDBCluster, DescribeDBClusters, FailoverDBCluster, ModifyDBCluster, RebootDBCluster, RestoreDBClusterFromSnapshot, and RestoreDBClusterToPointInTime.

For more information on Amazon Aurora DB clusters, see What is Amazon Aurora? (https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_AuroraOverview.html) in the Amazon Aurora User Guide.

For more information on Multi-AZ DB clusters, see Multi-AZ deployments with two readable standby DB instances (https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/multi-az-db-clusters-concepts.html) in the Amazon RDS User Guide.

Spec

allocatedStorage: integer
autoMinorVersionUpgrade: boolean
availabilityZones:
- string
backtrackWindow: integer
backupRetentionPeriod: integer
characterSetName: string
copyTagsToSnapshot: boolean
databaseName: string
dbClusterIdentifier: string
dbClusterInstanceClass: string
dbClusterParameterGroupName: string
dbClusterParameterGroupRef: 
  from: 
    name: string
    namespace: string
dbSubnetGroupName: string
dbSubnetGroupRef: 
  from: 
    name: string
    namespace: string
dbSystemID: string
deletionProtection: boolean
destinationRegion: string
domain: string
domainIAMRoleName: string
enableCloudwatchLogsExports:
- string
enableGlobalWriteForwarding: boolean
enableHTTPEndpoint: boolean
enableIAMDatabaseAuthentication: boolean
enablePerformanceInsights: boolean
engine: string
engineMode: string
engineVersion: string
globalClusterIdentifier: string
iops: integer
kmsKeyID: string
kmsKeyRef: 
  from: 
    name: string
    namespace: string
manageMasterUserPassword: boolean
masterUserPassword: 
  key: string
  name: string
  namespace: string
masterUserSecretKMSKeyID: string
masterUserSecretKMSKeyRef: 
  from: 
    name: string
    namespace: string
masterUsername: string
monitoringInterval: integer
monitoringRoleARN: string
networkType: string
optionGroupName: string
performanceInsightsKMSKeyID: string
performanceInsightsRetentionPeriod: integer
port: integer
preSignedURL: string
preferredBackupWindow: string
preferredMaintenanceWindow: string
publiclyAccessible: boolean
replicationSourceIdentifier: string
restoreToTime: string
restoreType: string
scalingConfiguration: 
  autoPause: boolean
  maxCapacity: integer
  minCapacity: integer
  secondsBeforeTimeout: integer
  secondsUntilAutoPause: integer
  timeoutAction: string
serverlessV2ScalingConfiguration: 
  maxCapacity: number
  minCapacity: number
  secondsUntilAutoPause: integer
snapshotIdentifier: string
sourceDBClusterIdentifier: string
sourceRegion: string
storageEncrypted: boolean
storageType: string
tags:
- key: string
  value: string
useLatestRestorableTime: boolean
vpcSecurityGroupIDs:
- string
vpcSecurityGroupRefs:
  from: 
    name: string
    namespace: string
FieldDescription
allocatedStorage
Optional
integer
autoMinorVersionUpgrade
Optional
boolean
availabilityZones
Optional
array
availabilityZones.[]
Required
string
backupRetentionPeriod
Optional
integer
characterSetName
Optional
string
copyTagsToSnapshot
Optional
boolean
databaseName
Optional
string
dbClusterIdentifier
Required
string
dbClusterInstanceClass
Optional
string
dbClusterParameterGroupName
Optional
string
dbClusterParameterGroupRef
Optional
object
AWSResourceReferenceWrapper provides a wrapper around *AWSResourceReference
type to provide more user friendly syntax for references using ‘from’ field
Ex:
APIIDRef:

from:
name: my-api
dbClusterParameterGroupRef.from
Optional
object
AWSResourceReference provides all the values necessary to reference another
k8s resource for finding the identifier(Id/ARN/Name)
dbClusterParameterGroupRef.from.name
Optional
string
dbClusterParameterGroupRef.from.namespace
Optional
string
dbSubnetGroupName
Optional
string
dbSubnetGroupRef
Optional
object
AWSResourceReferenceWrapper provides a wrapper around *AWSResourceReference
type to provide more user friendly syntax for references using ‘from’ field
Ex:
APIIDRef:

from:
name: my-api
dbSubnetGroupRef.from
Optional
object
AWSResourceReference provides all the values necessary to reference another
k8s resource for finding the identifier(Id/ARN/Name)
dbSubnetGroupRef.from.name
Optional
string
dbSubnetGroupRef.from.namespace
Optional
string
dbSystemID
Optional
string
deletionProtection
Optional
boolean
destinationRegion
Optional
string
domain
Optional
string
domainIAMRoleName
Optional
string
enableCloudwatchLogsExports
Optional
array
enableCloudwatchLogsExports.[]
Required
string
enableHTTPEndpoint
Optional
boolean
enableIAMDatabaseAuthentication
Optional
boolean
enablePerformanceInsights
Optional
boolean
engine
Required
string
engineMode
Optional
string
engineVersion
Optional
string
globalClusterIdentifier
Optional
string
iops
Optional
integer
kmsKeyID
Optional
string
kmsKeyRef
Optional
object
AWSResourceReferenceWrapper provides a wrapper around *AWSResourceReference
type to provide more user friendly syntax for references using ‘from’ field
Ex:
APIIDRef:

from:
name: my-api
kmsKeyRef.from
Optional
object
AWSResourceReference provides all the values necessary to reference another
k8s resource for finding the identifier(Id/ARN/Name)
kmsKeyRef.from.name
Optional
string
kmsKeyRef.from.namespace
Optional
string
manageMasterUserPassword
Optional
boolean
masterUserPassword
Optional
object
SecretKeyReference combines a k8s corev1.SecretReference with a
specific key within the referred-to Secret
masterUserPassword.key
Required
string
Key is the key within the secret
masterUserPassword.name
Optional
string
name is unique within a namespace to reference a secret resource.
masterUserPassword.namespace
Optional
string
namespace defines the space within which the secret name must be unique.
masterUserSecretKMSKeyID
Optional
string
masterUserSecretKMSKeyRef
Optional
object
AWSResourceReferenceWrapper provides a wrapper around *AWSResourceReference
type to provide more user friendly syntax for references using ‘from’ field
Ex:
APIIDRef:

from:
name: my-api
masterUserSecretKMSKeyRef.from
Optional
object
AWSResourceReference provides all the values necessary to reference another
k8s resource for finding the identifier(Id/ARN/Name)
masterUserSecretKMSKeyRef.from.name
Optional
string
masterUserSecretKMSKeyRef.from.namespace
Optional
string
masterUsername
Optional
string
monitoringInterval
Optional
integer
monitoringRoleARN
Optional
string
networkType
Optional
string
optionGroupName
Optional
string
performanceInsightsKMSKeyID
Optional
string
performanceInsightsRetentionPeriod
Optional
integer
port
Optional
integer
preSignedURL
Optional
string
preferredBackupWindow
Optional
string
preferredMaintenanceWindow
Optional
string
publiclyAccessible
Optional
boolean
replicationSourceIdentifier
Optional
string
restoreToTime
Optional
string
restoreType
Optional
string
scalingConfiguration
Optional
object
Contains the scaling configuration of an Aurora Serverless v1 DB cluster.

For more information, see Using Amazon Aurora Serverless v1 (https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-serverless.html)
in the Amazon Aurora User Guide.
scalingConfiguration.autoPause
Optional
boolean
scalingConfiguration.maxCapacity
Optional
integer
scalingConfiguration.minCapacity
Optional
integer
scalingConfiguration.secondsBeforeTimeout
Optional
integer
scalingConfiguration.secondsUntilAutoPause
Optional
integer
scalingConfiguration.timeoutAction
Optional
string
serverlessV2ScalingConfiguration
Optional
object
Contains the scaling configuration of an Aurora Serverless v2 DB cluster.

For more information, see Using Amazon Aurora Serverless v2 (https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-serverless-v2.html)
in the Amazon Aurora User Guide.
serverlessV2ScalingConfiguration.maxCapacity
Optional
number
serverlessV2ScalingConfiguration.minCapacity
Optional
number
serverlessV2ScalingConfiguration.secondsUntilAutoPause
Optional
integer
snapshotIdentifier
Optional
string
sourceDBClusterIdentifier
Optional
string
sourceRegion
Optional
string
storageEncrypted
Optional
boolean
storageType
Optional
string
tags
Optional
array
tags.[]
Required
object
Metadata assigned to an Amazon RDS resource consisting of a key-value pair.

For more information, see Tagging Amazon RDS resources (https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Tagging.html) in the Amazon RDS User Guide or Tagging Amazon Aurora and Amazon RDS resources (https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_Tagging.html) in the Amazon Aurora User Guide. || tags.[].key
Optional | string
| | tags.[].value
Optional | string
| | useLatestRestorableTime
Optional | boolean
| | vpcSecurityGroupIDs
Optional | array
| | vpcSecurityGroupIDs.[]
Required | string
|| vpcSecurityGroupRefs
Optional | array
| | vpcSecurityGroupRefs.[]
Required | object
AWSResourceReferenceWrapper provides a wrapper around *AWSResourceReference type to provide more user friendly syntax for references using ‘from’ field Ex: APIIDRef:

from:
  name: my-api || **vpcSecurityGroupRefs.[].from**<br/>Optional | **object**<br/>AWSResourceReference provides all the values necessary to reference another<br/>k8s resource for finding the identifier(Id/ARN/Name) |

| vpcSecurityGroupRefs.[].from.name
Optional | string
| | vpcSecurityGroupRefs.[].from.namespace
Optional | string
|

Status

ackResourceMetadata: 
  arn: string
  ownerAccountID: string
  region: string
activityStreamKMSKeyID: string
activityStreamKinesisStreamName: string
activityStreamMode: string
activityStreamStatus: string
associatedRoles:
- featureName: string
  roleARN: string
  status: string
automaticRestartTime: string
backtrackConsumedChangeRecords: integer
capacity: integer
cloneGroupID: string
clusterCreateTime: string
conditions:
- lastTransitionTime: string
  message: string
  reason: string
  status: string
  type: string
crossAccountClone: boolean
customEndpoints:
- string
dbClusterMembers:
- dbClusterParameterGroupStatus: string
  dbInstanceIdentifier: string
  isClusterWriter: boolean
  promotionTier: integer
dbClusterOptionGroupMemberships:
- dbClusterOptionGroupName: string
  status: string
dbClusterParameterGroup: string
dbClusterResourceID: string
dbSubnetGroup: string
domainMemberships:
- domain: string
  fQDN: string
  iamRoleName: string
  status: string
earliestBacktrackTime: string
earliestRestorableTime: string
enabledCloudwatchLogsExports:
- string
endpoint: string
globalWriteForwardingRequested: boolean
globalWriteForwardingStatus: string
hostedZoneID: string
httpEndpointEnabled: boolean
iamDatabaseAuthenticationEnabled: boolean
latestRestorableTime: string
masterUserSecret: 
  kmsKeyID: string
  secretARN: string
  secretStatus: string
multiAZ: boolean
pendingModifiedValues: 
  allocatedStorage: integer
  backupRetentionPeriod: integer
  dbClusterIdentifier: string
  engineVersion: string
  iamDatabaseAuthenticationEnabled: boolean
  iops: integer
  masterUserPassword: string
  pendingCloudwatchLogsExports: 
    logTypesToDisable:
    - string
    logTypesToEnable:
    - string
percentProgress: string
performanceInsightsEnabled: boolean
readReplicaIdentifiers:
- string
readerEndpoint: string
status: string
tagList:
- key: string
  value: string
vpcSecurityGroups:
- status: string
  vpcSecurityGroupID: string
FieldDescription
ackResourceMetadata
Optional
object
All CRs managed by ACK have a common Status.ACKResourceMetadata member
that is used to contain resource sync state, account ownership,
constructed ARN for the resource
ackResourceMetadata.arn
Optional
string
ARN is the Amazon Resource Name for the resource. This is a
globally-unique identifier and is set only by the ACK service controller
once the controller has orchestrated the creation of the resource OR
when it has verified that an “adopted” resource (a resource where the
ARN annotation was set by the Kubernetes user on the CR) exists and
matches the supplied CR’s Spec field values.
https://github.com/aws/aws-controllers-k8s/issues/270
ackResourceMetadata.ownerAccountID
Required
string
OwnerAccountID is the AWS Account ID of the account that owns the
backend AWS service API resource.
ackResourceMetadata.region
Required
string
Region is the AWS region in which the resource exists or will exist.
activityStreamKMSKeyID
Optional
string
The Amazon Web Services KMS key identifier used for encrypting messages in
the database activity stream.

The Amazon Web Services KMS key identifier is the key ARN, key ID, alias
ARN, or alias name for the KMS key.
activityStreamKinesisStreamName
Optional
string
The name of the Amazon Kinesis data stream used for the database activity
stream.
activityStreamMode
Optional
string
The mode of the database activity stream. Database events such as a change
or access generate an activity stream event. The database session can handle
these events either synchronously or asynchronously.
activityStreamStatus
Optional
string
The status of the database activity stream.
associatedRoles
Optional
array
A list of the Amazon Web Services Identity and Access Management (IAM) roles
that are associated with the DB cluster. IAM roles that are associated with
a DB cluster grant permission for the DB cluster to access other Amazon Web
Services on your behalf.
associatedRoles.[]
Required
object
Describes an Amazon Web Services Identity and Access Management (IAM) role
that is associated with a DB cluster.
associatedRoles.[].roleARN
Optional
string
associatedRoles.[].status
Optional
string
automaticRestartTime
Optional
string
The time when a stopped DB cluster is restarted automatically.
backtrackConsumedChangeRecords
Optional
integer
The number of change records stored for Backtrack.
capacity
Optional
integer
The current capacity of an Aurora Serverless v1 DB cluster. The capacity
is 0 (zero) when the cluster is paused.

For more information about Aurora Serverless v1, see Using Amazon Aurora
Serverless v1 (https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-serverless.html)
in the Amazon Aurora User Guide.
cloneGroupID
Optional
string
The ID of the clone group with which the DB cluster is associated.
clusterCreateTime
Optional
string
The time when the DB cluster was created, in Universal Coordinated Time (UTC).
conditions
Optional
array
All CRs managed by ACK have a common Status.Conditions member that
contains a collection of ackv1alpha1.Condition objects that describe
the various terminal states of the CR and its backend AWS service API
resource
conditions.[]
Required
object
Condition is the common struct used by all CRDs managed by ACK service
controllers to indicate terminal states of the CR and its backend AWS
service API resource
conditions.[].message
Optional
string
A human readable message indicating details about the transition.
conditions.[].reason
Optional
string
The reason for the condition’s last transition.
conditions.[].status
Optional
string
Status of the condition, one of True, False, Unknown.
conditions.[].type
Optional
string
Type is the type of the Condition
crossAccountClone
Optional
boolean
Indicates whether the DB cluster is a clone of a DB cluster owned by a different
Amazon Web Services account.
customEndpoints
Optional
array
The custom endpoints associated with the DB cluster.
customEndpoints.[]
Required
string
dbClusterMembers.[]
Required
object
Contains information about an instance that is part of a DB cluster.
dbClusterMembers.[].dbInstanceIdentifier
Optional
string
dbClusterMembers.[].isClusterWriter
Optional
boolean
dbClusterMembers.[].promotionTier
Optional
integer
dbClusterOptionGroupMemberships
Optional
array
The list of option group memberships for this DB cluster.
dbClusterOptionGroupMemberships.[]
Required
object
Contains status information for a DB cluster option group.
dbClusterOptionGroupMemberships.[].status
Optional
string
dbClusterParameterGroup
Optional
string
The name of the DB cluster parameter group for the DB cluster.
dbClusterResourceID
Optional
string
The Amazon Web Services Region-unique, immutable identifier for the DB cluster.
This identifier is found in Amazon Web Services CloudTrail log entries whenever
the KMS key for the DB cluster is accessed.
dbSubnetGroup
Optional
string
Information about the subnet group associated with the DB cluster, including
the name, description, and subnets in the subnet group.
domainMemberships
Optional
array
The Active Directory Domain membership records associated with the DB cluster.
domainMemberships.[]
Required
object
An Active Directory Domain membership record associated with the DB instance
or cluster.
domainMemberships.[].fQDN
Optional
string
domainMemberships.[].iamRoleName
Optional
string
domainMemberships.[].status
Optional
string
earliestBacktrackTime
Optional
string
The earliest time to which a DB cluster can be backtracked.
earliestRestorableTime
Optional
string
The earliest time to which a database can be restored with point-in-time
restore.
enabledCloudwatchLogsExports
Optional
array
A list of log types that this DB cluster is configured to export to CloudWatch
Logs.

Log types vary by DB engine. For information about the log types for each
DB engine, see Amazon RDS Database Log Files (https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_LogAccess.html)
in the Amazon Aurora User Guide.
enabledCloudwatchLogsExports.[]
Required
string
globalWriteForwardingRequested
Optional
boolean
Indicates whether write forwarding is enabled for a secondary cluster in
an Aurora global database. Because write forwarding takes time to enable,
check the value of GlobalWriteForwardingStatus to confirm that the request
has completed before using the write forwarding feature for this cluster.
globalWriteForwardingStatus
Optional
string
The status of write forwarding for a secondary cluster in an Aurora global
database.
hostedZoneID
Optional
string
The ID that Amazon Route 53 assigns when you create a hosted zone.
httpEndpointEnabled
Optional
boolean
Indicates whether the HTTP endpoint is enabled for an Aurora DB cluster.

When enabled, the HTTP endpoint provides a connectionless web service API
(RDS Data API) for running SQL queries on the DB cluster. You can also query
your database from inside the RDS console with the RDS query editor.

For more information, see Using RDS Data API (https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/data-api.html)
in the Amazon Aurora User Guide.
iamDatabaseAuthenticationEnabled
Optional
boolean
Indicates whether the mapping of Amazon Web Services Identity and Access
Management (IAM) accounts to database accounts is enabled.
latestRestorableTime
Optional
string
The latest time to which a database can be restored with point-in-time restore.
masterUserSecret
Optional
object
The secret managed by RDS in Amazon Web Services Secrets Manager for the
master user password.

For more information, see Password management with Amazon Web Services Secrets
Manager (https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-secrets-manager.html)
in the Amazon RDS User Guide and Password management with Amazon Web Services
Secrets Manager (https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/rds-secrets-manager.html)
in the Amazon Aurora User Guide.
masterUserSecret.kmsKeyID
Optional
string
masterUserSecret.secretARN
Optional
string
masterUserSecret.secretStatus
Optional
string
multiAZ
Optional
boolean
Indicates whether the DB cluster has instances in multiple Availability Zones.
pendingModifiedValues
Optional
object
Information about pending changes to the DB cluster. This information is
returned only when there are pending changes. Specific changes are identified
by subelements.
pendingModifiedValues.allocatedStorage
Optional
integer
pendingModifiedValues.backupRetentionPeriod
Optional
integer
pendingModifiedValues.dbClusterIdentifier
Optional
string
pendingModifiedValues.engineVersion
Optional
string
pendingModifiedValues.iamDatabaseAuthenticationEnabled
Optional
boolean
pendingModifiedValues.iops
Optional
integer
pendingModifiedValues.masterUserPassword
Optional
string
pendingModifiedValues.pendingCloudwatchLogsExports
Optional
object
A list of the log types whose configuration is still pending. In other words,
these log types are in the process of being activated or deactivated.
pendingModifiedValues.pendingCloudwatchLogsExports.logTypesToDisable
Optional
array
pendingModifiedValues.pendingCloudwatchLogsExports.logTypesToDisable.[]
Required
string
pendingModifiedValues.pendingCloudwatchLogsExports.logTypesToEnable.[]
Required
string
performanceInsightsEnabled
Optional
boolean
Indicates whether Performance Insights is enabled for the DB cluster.

This setting is only for non-Aurora Multi-AZ DB clusters.
readReplicaIdentifiers
Optional
array
Contains one or more identifiers of the read replicas associated with this
DB cluster.
readReplicaIdentifiers.[]
Required
string
status
Optional
string
The current state of this DB cluster.
tagList
Optional
array
tagList.[]
Required
object
Metadata assigned to an Amazon RDS resource consisting of a key-value pair.

For more information, see Tagging Amazon RDS resources (https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Tagging.html) in the Amazon RDS User Guide or Tagging Amazon Aurora and Amazon RDS resources (https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_Tagging.html) in the Amazon Aurora User Guide. || tagList.[].key
Optional | string
| | tagList.[].value
Optional | string
| | vpcSecurityGroups
Optional | array
The list of VPC security groups that the DB cluster belongs to. | | vpcSecurityGroups.[]
Required | object
This data type is used as a response element for queries on VPC security group membership. || vpcSecurityGroups.[].status
Optional | string
| | vpcSecurityGroups.[].vpcSecurityGroupID
Optional | string
|