Cluster

memorydb.services.k8s.aws/v1alpha1

TypeLink
GoDocmemorydb-controller/apis/v1alpha1#Cluster

Metadata

PropertyValue
ScopeNamespaced
KindCluster
ListKindClusterList
Pluralclusters
Singularcluster

Contains all of the attributes of a specific cluster.

Spec

aclName: string
aclRef: 
  from: 
    name: string
    namespace: string
autoMinorVersionUpgrade: boolean
description: string
engineVersion: string
kmsKeyID: string
maintenanceWindow: string
name: string
nodeType: string
numReplicasPerShard: integer
numShards: integer
parameterGroupName: string
parameterGroupRef: 
  from: 
    name: string
    namespace: string
port: integer
securityGroupIDs:
- string
securityGroupRefs:
  from: 
    name: string
    namespace: string
snapshotARNs:
- string
snapshotName: string
snapshotRef: 
  from: 
    name: string
    namespace: string
snapshotRetentionLimit: integer
snapshotWindow: string
snsTopicARN: string
snsTopicRef: 
  from: 
    name: string
    namespace: string
subnetGroupName: string
subnetGroupRef: 
  from: 
    name: string
    namespace: string
tags:
- key: string
  value: string
tlsEnabled: boolean
FieldDescription
aclName
Optional
string
The name of the Access Control List to associate with the cluster.
aclRef
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
aclRef.from
Optional
object
AWSResourceReference provides all the values necessary to reference another
k8s resource for finding the identifier(Id/ARN/Name)
aclRef.from.name
Optional
string
aclRef.from.namespace
Optional
string
autoMinorVersionUpgrade
Optional
boolean
When set to true, the cluster will automatically receive minor engine version
upgrades after launch.
description
Optional
string
An optional description of the cluster.
engineVersion
Optional
string
The version number of the Redis engine to be used for the cluster.
kmsKeyID
Optional
string
The ID of the KMS key used to encrypt the cluster.
maintenanceWindow
Optional
string
Specifies the weekly time range during which maintenance on the cluster is
performed. It is specified as a range in the format ddd:hh24:mi-ddd:hh24:mi
(24H Clock UTC). The minimum maintenance window is a 60 minute period.
name
Required
string
The name of the cluster. This value must be unique as it also serves as the
cluster identifier.
nodeType
Required
string
The compute and memory capacity of the nodes in the cluster.
numReplicasPerShard
Optional
integer
The number of replicas to apply to each shard. The default value is 1. The
maximum is 5.
numShards
Optional
integer
The number of shards the cluster will contain. The default value is 1.
parameterGroupName
Optional
string
The name of the parameter group associated with the cluster.
parameterGroupRef
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
parameterGroupRef.from
Optional
object
AWSResourceReference provides all the values necessary to reference another
k8s resource for finding the identifier(Id/ARN/Name)
parameterGroupRef.from.name
Optional
string
parameterGroupRef.from.namespace
Optional
string
port
Optional
integer
The port number on which each of the nodes accepts connections.
securityGroupIDs
Optional
array
A list of security group names to associate with this cluster.
securityGroupIDs.[]
Required
string
securityGroupRefs.[]
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 || **securityGroupRefs.[].from**<br/>Optional | **object**<br/>AWSResourceReference provides all the values necessary to reference another<br/>k8s resource for finding the identifier(Id/ARN/Name) |

| securityGroupRefs.[].from.name
Optional | string
| | securityGroupRefs.[].from.namespace
Optional | string
| | snapshotARNs
Optional | array
A list of Amazon Resource Names (ARN) that uniquely identify the RDB snapshot
files stored in Amazon S3. The snapshot files are used to populate the new
cluster. The Amazon S3 object name in the ARN cannot contain any commas. | | snapshotARNs.[]
Required | string
|| snapshotName
Optional | string
The name of a snapshot from which to restore data into the new cluster. The
snapshot status changes to restoring while the new cluster is being created. | | snapshotRef
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 | | snapshotRef.from
Optional | object
AWSResourceReference provides all the values necessary to reference another
k8s resource for finding the identifier(Id/ARN/Name) | | snapshotRef.from.name
Optional | string
| | snapshotRef.from.namespace
Optional | string
| | snapshotRetentionLimit
Optional | integer
The number of days for which MemoryDB retains automatic snapshots before
deleting them. For example, if you set SnapshotRetentionLimit to 5, a snapshot
that was taken today is retained for 5 days before being deleted. | | snapshotWindow
Optional | string
The daily time range (in UTC) during which MemoryDB begins taking a daily
snapshot of your shard.

Example: 05:00-09:00

If you do not specify this parameter, MemoryDB automatically chooses an appropriate
time range. | | snsTopicARN
Optional | string
The Amazon Resource Name (ARN) of the Amazon Simple Notification Service
(SNS) topic to which notifications are sent. | | snsTopicRef
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 | | snsTopicRef.from
Optional | object
AWSResourceReference provides all the values necessary to reference another
k8s resource for finding the identifier(Id/ARN/Name) | | snsTopicRef.from.name
Optional | string
| | snsTopicRef.from.namespace
Optional | string
| | subnetGroupName
Optional | string
The name of the subnet group to be used for the cluster. | | subnetGroupRef
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 | | subnetGroupRef.from
Optional | object
AWSResourceReference provides all the values necessary to reference another
k8s resource for finding the identifier(Id/ARN/Name) | | subnetGroupRef.from.name
Optional | string
| | subnetGroupRef.from.namespace
Optional | string
| | tags
Optional | array
A list of tags to be added to this resource. Tags are comma-separated key,value
pairs (e.g. Key=myKey, Value=myKeyValue. You can include multiple tags as
shown following: Key=myKey, Value=myKeyValue Key=mySecondKey, Value=mySecondKeyValue. | | tags.[]
Required | object
A tag that can be added to an MemoryDB resource. Tags are composed of a Key/Value pair. You can use tags to categorize and track all your MemoryDB resources. When you add or remove tags on clusters, those actions will be replicated to all nodes in the cluster. A tag with a null Value is permitted. For more information, see Tagging your MemoryDB resources (https://docs.aws.amazon.com/MemoryDB/latest/devguide/tagging-resources.html) || tags.[].key
Optional | string
| | tags.[].value
Optional | string
| | tlsEnabled
Optional | boolean
A flag to enable in-transit encryption on the cluster. |

Status

ackResourceMetadata: 
  arn: string
  ownerAccountID: string
  region: string
allowedScaleDownNodeTypes:
- string
allowedScaleUpNodeTypes:
- string
availabilityMode: string
clusterEndpoint: 
  address: string
  port: integer
conditions:
- lastTransitionTime: string
  message: string
  reason: string
  status: string
  type: string
enginePatchVersion: string
events:
- date: string
  message: string
  sourceName: string
  sourceType: string
numberOfShards: integer
parameterGroupStatus: string
pendingUpdates: 
  acls: 
    aclToApply: string
  resharding: 
    slotMigration: 
      progressPercentage: number
  serviceUpdates:
  - serviceUpdateName: string
    status: string
securityGroups:
- securityGroupID: string
  status: string
shards:
- name: string
  nodes:
  - availabilityZone: string
    createTime: string
    endpoint: 
      address: string
      port: integer
    name: string
    status: string
  numberOfNodes: integer
  slots: string
  status: string
snsTopicStatus: string
status: 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.
allowedScaleDownNodeTypes
Optional
array
A list node types which you can use to scale down your cluster.
allowedScaleDownNodeTypes.[]
Required
string
allowedScaleUpNodeTypes.[]
Required
string
clusterEndpoint
Optional
object
The cluster’s configuration endpoint
clusterEndpoint.address
Optional
string
clusterEndpoint.port
Optional
integer
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
enginePatchVersion
Optional
string
The Redis engine patch version used by the cluster
events
Optional
array
A list of events. Each element in the list contains detailed information
about one event.
events.[]
Required
object
Represents a single occurrence of something interesting within the system.
Some examples of events are creating a cluster or adding or removing a node.
events.[].message
Optional
string
events.[].sourceName
Optional
string
events.[].sourceType
Optional
string
numberOfShards
Optional
integer
The number of shards in the cluster
parameterGroupStatus
Optional
string
The status of the parameter group used by the cluster, for example ‘active’
or ‘applying’.
pendingUpdates
Optional
object
A group of settings that are currently being applied.
pendingUpdates.acls
Optional
object
The status of the ACL update
pendingUpdates.acls.aclToApply
Optional
string
pendingUpdates.resharding
Optional
object
The status of the online resharding
pendingUpdates.resharding.slotMigration
Optional
object
Represents the progress of an online resharding operation.
pendingUpdates.resharding.slotMigration.progressPercentage
Optional
number
pendingUpdates.serviceUpdates
Optional
array
pendingUpdates.serviceUpdates.[]
Required
object
Update action that has yet to be processed for the corresponding apply/stop
request
pendingUpdates.serviceUpdates.[].status
Optional
string
securityGroups
Optional
array
A list of security groups used by the cluster
securityGroups.[]
Required
object
Represents a single security group and its status.
securityGroups.[].status
Optional
string
shards
Optional
array
A list of shards that are members of the cluster.
shards.[]
Required
object
Represents a collection of nodes in a cluster. One node in the node group
is the read/write primary node. All the other nodes are read-only Replica
nodes.
shards.[].nodes
Optional
array
shards.[].nodes.[]
Required
object
Represents an individual node within a cluster. Each node runs its own instance
of the cluster’s protocol-compliant caching software.
shards.[].nodes.[].createTime
Optional
string
shards.[].nodes.[].endpoint
Optional
object
Represents the information required for client programs to connect to the
cluster and its nodes.
shards.[].nodes.[].endpoint.address
Optional
string
shards.[].nodes.[].endpoint.port
Optional
integer
shards.[].nodes.[].name
Optional
string
shards.[].nodes.[].status
Optional
string
shards.[].numberOfNodes
Optional
integer
shards.[].slots
Optional
string
shards.[].status
Optional
string
snsTopicStatus
Optional
string
The SNS topic must be in Active status to receive notifications
status
Optional
string
The status of the cluster. For example, Available, Updating, Creating.