- NAME
-
- gcloud beta redis clusters create - create a new Memorystore for Redis Cluster instance
- SYNOPSIS
-
-
gcloud beta redis clusters create(CLUSTER:--region=REGION)--network=NETWORK--shard-count=SHARD_COUNT[--aof-append-fsync=AOF_APPEND_FSYNC] [--async] [--auth-mode=AUTH_MODE] [--node-type=NODE_TYPE] [--persistence-mode=PERSISTENCE_MODE] [--rdb-snapshot-period=RDB_SNAPSHOT_PERIOD] [--rdb-snapshot-start-time=RDB_SNAPSHOT_START_TIME] [--redis-config=[KEY=VALUE,…]] [--replica-count=REPLICA_COUNT] [--transit-encryption-mode=TRANSIT_ENCRYPTION_MODE] [--zone=ZONE] [--zone-distribution-mode=ZONE_DISTRIBUTION_MODE] [GCLOUD_WIDE_FLAG …]
-
- DESCRIPTION
-
(BETA)Create a new Memorystore for Redis Cluster instance, and uses Private Service Connect service connectivity automation to automate connectivity for instances.This command can fail for the following reasons:
- A cluster with the same name already exists.
- The active account does not have permission to create clusters.
- Some required APIs not enabled yet.
- No connection policy defined yet on the network and in the region a cluster will be created.
- Miss the steps for creating and configuring a service account (to grant permissions) in both host project and service project, if a shared VPC network is used.
Refer to https://cloud.google.com/memorystore/docs/cluster/networking#prerequisites_required_before_creating_a_cluster for prerequisites.
- EXAMPLES
-
To create a cluster with name
my-redis-clusterin regionus-central1with 3 shards and with a discovery endpoint created on network "default", run:gcloud beta redis clusters create my-redis-cluster --region=us-central1 --shard-count=3 --network=projects/NETWORK_PROJECT_ID/global/networks/default - POSITIONAL ARGUMENTS
-
-
Cluster resource - Arguments and flags that specify the cluster you want to
create. Your cluster ID must be 1 to 63 characters and use only lowercase
letters, numbers, or hyphens. It must start with a lowercase letter and end with
a lowercase letter or number. The arguments in this group can be used to specify
the attributes of this resource. (NOTE) Some attributes are not given arguments
in this group but can be set in other ways.
To set the
projectattribute:-
provide the argument
clusteron the command line with a fully specified name; -
provide the argument
--projecton the command line; -
set the property
core/project.
This must be specified.
CLUSTER-
ID of the cluster or fully qualified identifier for the cluster.
To set the
clusterattribute:-
provide the argument
clusteron the command line.
This positional argument must be specified if any of the other arguments in this group are specified.
-
provide the argument
--region=REGION-
The name of the Redis region of the cluster. Overrides the default redis/region
property value for this command invocation.
To set the
regionattribute:-
provide the argument
clusteron the command line with a fully specified name; -
provide the argument
--regionon the command line; -
set the property
redis/region.
-
provide the argument
-
provide the argument
-
Cluster resource - Arguments and flags that specify the cluster you want to
create. Your cluster ID must be 1 to 63 characters and use only lowercase
letters, numbers, or hyphens. It must start with a lowercase letter and end with
a lowercase letter or number. The arguments in this group can be used to specify
the attributes of this resource. (NOTE) Some attributes are not given arguments
in this group but can be set in other ways.
- REQUIRED FLAGS
-
--network=NETWORK- The network used to create your instance. It must use the format: projects/NETWORK_PROJECT_ID/global/networks/NETWORK_ID. The network ID used here must match the network ID used by the service connection policy. Otherwise, the create operation fails
--shard-count=SHARD_COUNT- The shard count of the cluster.
- OPTIONAL FLAGS
-
--aof-append-fsync=AOF_APPEND_FSYNC-
Fsync configuration.
AOF_APPEND_FSYNCmust be one of:always- Redis explicitly calls fsync for every write command.
everysec- (default) Redis explicitly calls fsync every second.
no- Redis will not explicitly call fsync.
--async- Return immediately, without waiting for the operation in progress to complete.
--auth-mode=AUTH_MODE-
Available authorization mode of a Redis cluster.
AUTH_MODEmust be one of:disabled- Authorization is disabled for the cluster.
iam-auth- IAM basic authorization is enabled for the cluster.
--node-type=NODE_TYPE-
Node Type of the redis cluster Node.
NODE_TYPEmust be one of:redis-highmem-medium,redis-highmem-xlarge,redis-shared-core-nano,redis-standard-small. --persistence-mode=PERSISTENCE_MODE-
Operation mode for persistence.
PERSISTENCE_MODEmust be one of:aof- AOF-based persistence
disabled- Persistence mode is disabled
rdb- RDB-based persistence
--rdb-snapshot-period=RDB_SNAPSHOT_PERIOD-
Attempted period between RDB snapshots.
RDB_SNAPSHOT_PERIODmust be one of:12h- 12 hours
1h- 1 hour
24h- (default) 24 hours
6h- 6 hours
--rdb-snapshot-start-time=RDB_SNAPSHOT_START_TIME- Date and time of the first snapshot in the ISO 1801 format, and alignment time for future snapshots. For example, 2024-01-01T01:00:00Z. If not specified, the current time will be used.
--redis-config=[KEY=VALUE,…]-
A list of Redis config KEY=VALUE pairs to set on the Redis Cluster according to
http://redis.io/topics/config.
Currently the supported Redis configs are:
maxmemory-clients, maxmemory, maxmemory-policy, notify-keyspace-events, slowlog-log-slower-than, maxclients.
--replica-count=REPLICA_COUNT- The replica count of each shard.
--transit-encryption-mode=TRANSIT_ENCRYPTION_MODE-
Transit encryption mode used for the Redis cluster. If not provided, encryption
is disabled for the cluster.
TRANSIT_ENCRYPTION_MODEmust be one of:disabled- In-transit encryption is disabled for the cluster.
server-authentication- The cluster uses server managed encryption for in-transit encryption.
--zone=ZONE- The zone used to allocate the cluster nodes. Applicable only if the zone-distribution-mode is set to single-zone.
--zone-distribution-mode=ZONE_DISTRIBUTION_MODE-
Determines how the cluster nodes are distributed across zones.
ZONE_DISTRIBUTION_MODEmust be one of:multi-zone- Allocate cluster nodes across multiple zones.
single-zone- Allocate cluster nodes in a single zone.
- GCLOUD WIDE FLAGS
-
These flags are available to all commands:
--access-token-file,--account,--billing-project,--configuration,--flags-file,--flatten,--format,--help,--impersonate-service-account,--log-http,--project,--quiet,--trace-token,--user-output-enabled,--verbosity.Run
$ gcloud helpfor details. - API REFERENCE
-
This command uses the
redis/v1beta1API. The full documentation for this API can be found at: https://cloud.google.com/memorystore/docs/redis/ - NOTES
-
This command is currently in beta and might change without notice. These
variants are also available:
gcloud redis clusters creategcloud alpha redis clusters create
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-04-02 UTC.
[{
"type": "thumb-down",
"id": "hardToUnderstand",
"label":"Hard to understand"
},{
"type": "thumb-down",
"id": "incorrectInformationOrSampleCode",
"label":"Incorrect information or sample code"
},{
"type": "thumb-down",
"id": "missingTheInformationSamplesINeed",
"label":"Missing the information/samples I need"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"Other"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"Easy to understand"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"Solved my problem"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"Other"
}]