DBCluster
rds.services.k8s.aws/v1alpha1
Type | Link |
---|---|
GoDoc | rds-controller/apis/v1alpha1#DBCluster |
Metadata
Property | Value |
---|---|
Scope | Namespaced |
Kind | DBCluster |
ListKind | DBClusterList |
Plural | dbclusters |
Singular | dbcluster |
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
Field | Description |
---|---|
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
Field | Description |
---|---|
ackResourceMetadata Optional | object All CRs managed by ACK have a common Status.ACKResourceMetadata memberthat 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 thatcontains a collection of ackv1alpha1.Condition objects that describethe 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
|