- Resource: Cluster
- GcsBackupSource
- ManagedBackupSource
- State
- AuthorizationMode
- TransitEncryptionMode
- PscConfig
- DiscoveryEndpoint
- PscConnection
- PscConnectionStatus
- ConnectionType
- StateInfo
- UpdateInfo
- ClusterPersistenceConfig
- PersistenceMode
- RDBConfig
- SnapshotPeriod
- AOFConfig
- AppendFsync
- ZoneDistributionConfig
- ZoneDistributionMode
- CrossClusterReplicationConfig
- ClusterRole
- RemoteCluster
- Membership
- ClusterMaintenancePolicy
- ClusterWeeklyMaintenanceWindow
- ClusterMaintenanceSchedule
- PscServiceAttachment
- ClusterEndpoint
- ConnectionDetail
- PscAutoConnection
- AutomatedBackupConfig
- FixedFrequencySchedule
- AutomatedBackupMode
- Methods
Resource: Cluster
A cluster instance.
JSON representation |
---|
{ "name": string, "createTime": string, "state": enum ( |
Fields | |
---|---|
name |
Required. Identifier. Unique name of the resource in this scope including project and location using the form: |
create |
Output only. The timestamp associated with the cluster creation request. Uses RFC 3339, where generated output will always be Z-normalized and uses 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: |
state |
Output only. The current state of this cluster. Can be CREATING, READY, UPDATING, DELETING and SUSPENDED |
uid |
Output only. System assigned, unique identifier for the cluster. |
authorization |
Optional. The authorization mode of the Redis cluster. If not provided, auth feature is disabled for the cluster. |
transit |
Optional. The in-transit encryption for the Redis cluster. If not provided, encryption is disabled for the cluster. |
psc |
Optional. Each PscConfig configures the consumer network where IPs will be designated to the cluster for client access through Private Service Connect Automation. Currently, only one PscConfig is supported. |
discovery |
Output only. Endpoints created on each given network, for Redis clients to connect to the cluster. Currently only one discovery endpoint is supported. |
psc |
Output only. The list of PSC connections that are auto-created through service connectivity automation. |
state |
Output only. Additional information about the current state of the cluster. |
node |
Optional. The type of a redis node in the cluster. NodeType determines the underlying machine-type of a redis node. |
persistence |
Optional. Persistence config (RDB, AOF) for the cluster. |
redis |
Optional. Key/Value pairs of customer overrides for mutable Redis Configs An object containing a list of |
zone |
Optional. This config will be used to determine how the customer wants us to distribute cluster resources within the region. |
cross |
Optional. Cross cluster replication config. |
psc |
Output only. Service attachment details to configure Psc connections |
cluster |
Optional. A list of cluster enpoints. |
automated |
Optional. The automated backup config for the cluster. |
encryption |
Output only. Encryption information of the data at rest of the cluster. |
Union field import_sources . The source to import from. import_sources can be only one of the following: |
|
gcs |
Optional. Backups stored in Cloud Storage buckets. The Cloud Storage buckets need to be the same region as the clusters. Read permission is required to import from the provided Cloud Storage objects. |
managed |
Optional. Backups generated and managed by memorystore service. |
replica |
Optional. The number of replica nodes per shard. |
size |
Output only. Redis memory size in GB for the entire cluster rounded up to the next integer. |
shard |
Optional. Number of shards for the Redis cluster. |
precise |
Output only. Precise value of redis memory size in GB for the entire cluster. |
deletion |
Optional. The delete operation will fail when the value is set to true. |
maintenance |
Optional. ClusterMaintenancePolicy determines when to allow or deny updates. |
maintenance |
Output only. ClusterMaintenanceSchedule Output only Published maintenance schedule. |
backup |
Optional. Output only. The backup collection full resource name. Example: projects/{project}/locations/{location}/backupCollections/{collection} |
kms |
Optional. The KMS key used to encrypt the at-rest data of the cluster. |
async |
Optional. If true, cluster endpoints that are created and registered by customers can be deleted asynchronously. That is, such a cluster endpoint can be de-registered before the forwarding rules in the cluster endpoint are deleted. |
GcsBackupSource
Backups stored in Cloud Storage buckets. The Cloud Storage buckets need to be the same region as the clusters.
JSON representation |
---|
{ "uris": [ string ] } |
Fields | |
---|---|
uris[] |
Optional. URIs of the GCS objects to import. Example: gs://bucket1/object1, gs://bucket2/folder2/object2 |
ManagedBackupSource
Backups that generated and managed by memorystore.
JSON representation |
---|
{ "backup": string } |
Fields | |
---|---|
backup |
Optional. Example: //redis.googleapis.com/projects/{project}/locations/{location}/backupCollections/{collection}/backups/{backup} A shorter version (without the prefix) of the backup name is also supported, like projects/{project}/locations/{location}/backupCollections/{collection}/backups/{backupId} In this case, it assumes the backup is under redis.googleapis.com. |
State
Represents the different states of a Redis cluster.
Enums | |
---|---|
STATE_UNSPECIFIED |
Not set. |
CREATING |
Redis cluster is being created. |
ACTIVE |
Redis cluster has been created and is fully usable. |
UPDATING |
Redis cluster configuration is being updated. |
DELETING |
Redis cluster is being deleted. |
AuthorizationMode
Available authorization mode of a Redis cluster.
Enums | |
---|---|
AUTH_MODE_UNSPECIFIED |
Not set. |
AUTH_MODE_IAM_AUTH |
IAM basic authorization mode |
AUTH_MODE_DISABLED |
Authorization disabled mode |
TransitEncryptionMode
Available mode of in-transit encryption.
Enums | |
---|---|
TRANSIT_ENCRYPTION_MODE_UNSPECIFIED |
In-transit encryption not set. |
TRANSIT_ENCRYPTION_MODE_DISABLED |
In-transit encryption disabled. |
TRANSIT_ENCRYPTION_MODE_SERVER_AUTHENTICATION |
Use server managed encryption for in-transit encryption. |
PscConfig
JSON representation |
---|
{ "network": string } |
Fields | |
---|---|
network |
Required. The network where the IP address of the discovery endpoint will be reserved, in the form of projects/{networkProject}/global/networks/{network_id}. |
DiscoveryEndpoint
Endpoints on each network, for Redis clients to connect to the cluster.
JSON representation |
---|
{
"address": string,
"port": integer,
"pscConfig": {
object ( |
Fields | |
---|---|
address |
Output only. Address of the exposed Redis endpoint used by clients to connect to the service. The address could be either IP or hostname. |
port |
Output only. The port number of the exposed Redis endpoint. |
psc |
Output only. Customer configuration for where the endpoint is created and accessed from. |
PscConnection
Details of consumer resources in a PSC connection.
JSON representation |
---|
{ "pscConnectionId": string, "address": string, "forwardingRule": string, "projectId": string, "network": string, "serviceAttachment": string, "pscConnectionStatus": enum ( |
Fields | |
---|---|
psc |
Required. The PSC connection id of the forwarding rule connected to the service attachment. |
address |
Required. The IP allocated on the consumer network for the PSC forwarding rule. |
forwarding |
Required. The URI of the consumer side forwarding rule. Example: projects/{projectNumOrId}/regions/us-east1/forwardingRules/{resourceId}. |
project |
Optional. Project ID of the consumer project where the forwarding rule is created in. |
network |
Required. The consumer network where the IP address resides, in the form of projects/{projectId}/global/networks/{network_id}. |
service |
Required. The service attachment which is the target of the PSC connection, in the form of projects/{project-id}/regions/{region}/serviceAttachments/{service-attachment-id}. |
psc |
Output only. The status of the PSC connection. Please note that this value is updated periodically. To get the latest status of a PSC connection, follow https://cloud.google.com/vpc/docs/configure-private-service-connect-services#endpoint-details. |
connection |
Output only. Type of the PSC connection. |
PscConnectionStatus
Status of the PSC connection.
Enums | |
---|---|
PSC_CONNECTION_STATUS_UNSPECIFIED |
PSC connection status is not specified. |
PSC_CONNECTION_STATUS_ACTIVE |
The connection is active |
PSC_CONNECTION_STATUS_NOT_FOUND |
Connection not found |
ConnectionType
Type of a PSC connection, for cluster access purpose.
Enums | |
---|---|
CONNECTION_TYPE_UNSPECIFIED |
Cluster endpoint Type is not set |
CONNECTION_TYPE_DISCOVERY |
Cluster endpoint that will be used as for cluster topology discovery. |
CONNECTION_TYPE_PRIMARY |
Cluster endpoint that will be used as primary endpoint to access primary. |
CONNECTION_TYPE_READER |
Cluster endpoint that will be used as reader endpoint to access replicas. |
StateInfo
Represents additional information about the state of the cluster.
JSON representation |
---|
{ // Union field |
Fields | |
---|---|
Union field
|
|
update |
Describes ongoing update on the cluster when cluster state is UPDATING. |
UpdateInfo
Represents information about an updating cluster.
JSON representation |
---|
{
"targetShardCount": integer,
"targetReplicaCount": integer,
"targetNodeType": enum ( |
Fields | |
---|---|
target |
Target number of shards for redis cluster |
target |
Target number of replica nodes per shard. |
target |
Target node type for redis cluster. |
ClusterPersistenceConfig
Configuration of the persistence functionality.
JSON representation |
---|
{ "mode": enum ( |
Fields | |
---|---|
mode |
Optional. The mode of persistence. |
rdb |
Optional. RDB configuration. This field will be ignored if mode is not RDB. |
aof |
Optional. AOF configuration. This field will be ignored if mode is not AOF. |
PersistenceMode
Available persistence modes.
Enums | |
---|---|
PERSISTENCE_MODE_UNSPECIFIED |
Not set. |
DISABLED |
Persistence is disabled, and any snapshot data is deleted. |
RDB |
RDB based persistence is enabled. |
AOF |
AOF based persistence is enabled. |
RDBConfig
Configuration of the RDB based persistence.
JSON representation |
---|
{
"rdbSnapshotPeriod": enum ( |
Fields | |
---|---|
rdb |
Optional. Period between RDB snapshots. |
rdb |
Optional. The time that the first snapshot was/will be attempted, and to which future snapshots will be aligned. If not provided, the current time will be used. Uses RFC 3339, where generated output will always be Z-normalized and uses 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: |
SnapshotPeriod
Available snapshot periods.
Enums | |
---|---|
SNAPSHOT_PERIOD_UNSPECIFIED |
Not set. |
ONE_HOUR |
One hour. |
SIX_HOURS |
Six hours. |
TWELVE_HOURS |
Twelve hours. |
TWENTY_FOUR_HOURS |
Twenty four hours. |
AOFConfig
Configuration of the AOF based persistence.
JSON representation |
---|
{
"appendFsync": enum ( |
Fields | |
---|---|
append |
Optional. fsync configuration. |
AppendFsync
Available fsync modes.
Enums | |
---|---|
APPEND_FSYNC_UNSPECIFIED |
Not set. Default: EVERYSEC |
NO |
Never fsync. Normally Linux will flush data every 30 seconds with this configuration, but it's up to the kernel's exact tuning. |
EVERYSEC |
fsync every second. Fast enough, and you may lose 1 second of data if there is a disaster |
ALWAYS |
fsync every time new write commands are appended to the AOF. It has the best data loss protection at the cost of performance |
ZoneDistributionConfig
Zone distribution config for allocation of cluster resources.
JSON representation |
---|
{
"mode": enum ( |
Fields | |
---|---|
mode |
Optional. The mode of zone distribution. Defaults to MULTI_ZONE, when not specified. |
zone |
Optional. When SINGLE ZONE distribution is selected, zone field would be used to allocate all resources in that zone. This is not applicable to MULTI_ZONE, and would be ignored for MULTI_ZONE clusters. |
ZoneDistributionMode
Defines various modes of zone distribution.
Enums | |
---|---|
ZONE_DISTRIBUTION_MODE_UNSPECIFIED |
Not Set. Default: MULTI_ZONE |
MULTI_ZONE |
Distribute all resources across 3 zones picked at random, within the region. |
SINGLE_ZONE |
Distribute all resources in a single zone. The zone field must be specified, when this mode is selected. |
CrossClusterReplicationConfig
Cross cluster replication config.
JSON representation |
---|
{ "clusterRole": enum ( |
Fields | |
---|---|
cluster |
The role of the cluster in cross cluster replication. |
primary |
Details of the primary cluster that is used as the replication source for this secondary cluster. This field is only set for a secondary cluster. |
secondary |
List of secondary clusters that are replicating from this primary cluster. This field is only set for a primary cluster. |
update |
Output only. The last time cross cluster replication config was updated. Uses RFC 3339, where generated output will always be Z-normalized and uses 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: |
membership |
Output only. An output only view of all the member clusters participating in the cross cluster replication. This view will be provided by every member cluster irrespective of its cluster role(primary or secondary). A primary cluster can provide information about all the secondary clusters replicating from it. However, a secondary cluster only knows about the primary cluster from which it is replicating. However, for scenarios, where the primary cluster is unavailable(e.g. regional outage), a clusters.get request can be sent to any other member cluster and this field will list all the member clusters participating in cross cluster replication. |
ClusterRole
The role of the cluster in cross cluster replication.
Enums | |
---|---|
CLUSTER_ROLE_UNSPECIFIED |
Cluster role is not set. The behavior is equivalent to NONE. |
NONE |
This cluster does not participate in cross cluster replication. It is an independent cluster and does not replicate to or from any other clusters. |
PRIMARY |
A cluster that allows both reads and writes. Any data written to this cluster is also replicated to the attached secondary clusters. |
SECONDARY |
A cluster that allows only reads and replicates data from a primary cluster. |
RemoteCluster
Details of the remote cluster associated with this cluster in a cross cluster replication setup.
JSON representation |
---|
{ "cluster": string, "uid": string } |
Fields | |
---|---|
cluster |
The full resource path of the remote cluster in the format: projects/ |
uid |
Output only. The unique identifier of the remote cluster. |
Membership
An output only view of all the member clusters participating in the cross cluster replication.
JSON representation |
---|
{ "primaryCluster": { object ( |
Fields | |
---|---|
primary |
Output only. The primary cluster that acts as the source of replication for the secondary clusters. |
secondary |
Output only. The list of secondary clusters replicating from the primary cluster. |
ClusterMaintenancePolicy
Maintenance policy per cluster.
JSON representation |
---|
{
"createTime": string,
"updateTime": string,
"weeklyMaintenanceWindow": [
{
object ( |
Fields | |
---|---|
create |
Output only. The time when the policy was created i.e. Maintenance Window or Deny Period was assigned. Uses RFC 3339, where generated output will always be Z-normalized and uses 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: |
update |
Output only. The time when the policy was updated i.e. Maintenance Window or Deny Period was updated. Uses RFC 3339, where generated output will always be Z-normalized and uses 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: |
weekly |
Optional. Maintenance window that is applied to resources covered by this policy. Minimum 1. For the current version, the maximum number of weeklyMaintenanceWindow is expected to be one. |
ClusterWeeklyMaintenanceWindow
Time window specified for weekly operations.
JSON representation |
---|
{ "day": enum ( |
Fields | |
---|---|
day |
Allows to define schedule that runs specified day of the week. |
start |
Start time of the window in UTC. |
ClusterMaintenanceSchedule
Upcoming maitenance schedule.
JSON representation |
---|
{ "startTime": string, "endTime": string } |
Fields | |
---|---|
start |
Output only. The start time of any upcoming scheduled maintenance for this instance. Uses RFC 3339, where generated output will always be Z-normalized and uses 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: |
end |
Output only. The end time of any upcoming scheduled maintenance for this instance. Uses RFC 3339, where generated output will always be Z-normalized and uses 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: |
PscServiceAttachment
Configuration of a service attachment of the cluster, for creating PSC connections.
JSON representation |
---|
{
"serviceAttachment": string,
"connectionType": enum ( |
Fields | |
---|---|
service |
Output only. Service attachment URI which your self-created PscConnection should use as target |
connection |
Output only. Type of a PSC connection targeting this service attachment. |
ClusterEndpoint
ClusterEndpoint consists of PSC connections that are created as a group in each VPC network for accessing the cluster. In each group, there shall be one connection for each service attachment in the cluster.
JSON representation |
---|
{
"connections": [
{
object ( |
Fields | |
---|---|
connections[] |
A group of PSC connections. They are created in the same VPC network, one for each service attachment in the cluster. |
ConnectionDetail
Detailed information of each PSC connection.
JSON representation |
---|
{ // Union field |
Fields | |
---|---|
Union field connection . A PSC connection to a cluster could either be created through Service Connectivity Automation (auto-registered connection) during the cluster creation, or it could be created by customer themselves (user-registered connection). connection can be only one of the following: |
|
psc |
Detailed information of a PSC connection that is created through service connectivity automation. |
psc |
Detailed information of a PSC connection that is created by the customer who owns the cluster. |
PscAutoConnection
Details of consumer resources in a PSC connection that is created through Service Connectivity Automation.
JSON representation |
---|
{ "pscConnectionId": string, "address": string, "forwardingRule": string, "projectId": string, "network": string, "serviceAttachment": string, "pscConnectionStatus": enum ( |
Fields | |
---|---|
psc |
Output only. The PSC connection id of the forwarding rule connected to the service attachment. |
address |
Output only. The IP allocated on the consumer network for the PSC forwarding rule. |
forwarding |
Output only. The URI of the consumer side forwarding rule. Example: projects/{projectNumOrId}/regions/us-east1/forwardingRules/{resourceId}. |
project |
Required. The consumer projectId where the forwarding rule is created from. |
network |
Required. The consumer network where the IP address resides, in the form of projects/{projectId}/global/networks/{network_id}. |
service |
Output only. The service attachment which is the target of the PSC connection, in the form of projects/{project-id}/regions/{region}/serviceAttachments/{service-attachment-id}. |
psc |
Output only. The status of the PSC connection. Please note that this value is updated periodically. Please use Private Service Connect APIs for the latest status. |
connection |
Output only. Type of the PSC connection. |
AutomatedBackupConfig
The automated backup config for a cluster.
JSON representation |
---|
{ "automatedBackupMode": enum ( |
Fields | |
---|---|
automated |
Optional. The automated backup mode. If the mode is disabled, the other fields will be ignored. |
Union field schedule . The schedule of automated backups. schedule can be only one of the following: |
|
fixed |
Optional. Trigger automated backups at a fixed frequency. |
retention |
Optional. How long to keep automated backups before the backups are deleted. The value should be between 1 day and 365 days. If not specified, the default value is 35 days. A duration in seconds with up to nine fractional digits, ending with ' |
FixedFrequencySchedule
This schedule allows the backup to be triggered at a fixed frequency (currently only daily is supported).
JSON representation |
---|
{
"startTime": {
object ( |
Fields | |
---|---|
start |
Required. The start time of every automated backup in UTC. It must be set to the start of an hour. This field is required. |
AutomatedBackupMode
The automated backup mode.
Enums | |
---|---|
AUTOMATED_BACKUP_MODE_UNSPECIFIED |
Default value. Automated backup config is not specified. |
DISABLED |
Automated backup config disabled. |
ENABLED |
Automated backup config enabled. |
Methods |
|
---|---|
|
Backup Redis Cluster. |
|
Creates a Redis cluster based on the specified properties. |
|
Deletes a specific Redis cluster. |
|
Gets the details of a specific Redis cluster. |
|
Gets the details of certificate authority information for Redis cluster. |
|
Lists all Redis clusters owned by a project in either the specified location (region) or all locations. |
|
Updates the metadata and configuration of a specific Redis cluster. |
|
Reschedules upcoming maintenance event. |