.TH "GCLOUD_ALPHA_REDIS_INSTANCES_CREATE" 1



.SH "NAME"
.HP
gcloud alpha redis instances create \- create a Memorystore Redis instance



.SH "SYNOPSIS"
.HP
\f5gcloud alpha redis instances create\fR (\fIINSTANCE\fR\ :\ \fB\-\-region\fR=\fIREGION\fR) [\fB\-\-alternative\-zone\fR=\fIALTERNATIVE_ZONE\fR] [\fB\-\-async\fR] [\fB\-\-connect\-mode\fR=\fICONNECT_MODE\fR] [\fB\-\-customer\-managed\-key\fR=\fICUSTOMER_MANAGED_KEY\fR] [\fB\-\-display\-name\fR=\fIDISPLAY_NAME\fR] [\fB\-\-enable\-auth\fR] [\fB\-\-labels\fR=[\fIKEY\fR=\fIVALUE\fR,...]] [\fB\-\-maintenance\-window\-day\fR=\fIMAINTENANCE_WINDOW_DAY\fR] [\fB\-\-maintenance\-window\-hour\fR=\fIMAINTENANCE_WINDOW_HOUR\fR] [\fB\-\-network\fR=\fINETWORK\fR;\ default="default"] [\fB\-\-persistence\-mode\fR=\fIPERSISTENCE_MODE\fR] [\fB\-\-rdb\-snapshot\-period\fR=\fIRDB_SNAPSHOT_PERIOD\fR] [\fB\-\-rdb\-snapshot\-start\-time\fR=\fIRDB_SNAPSHOT_START_TIME\fR] [\fB\-\-read\-replicas\-mode\fR=\fIREAD_REPLICAS_MODE\fR] [\fB\-\-redis\-config\fR=[\fIKEY\fR=\fIVALUE\fR,...]] [\fB\-\-redis\-version\fR=\fIVERSION\fR] [\fB\-\-replica\-count\fR=\fIREPLICA_COUNT\fR] [\fB\-\-reserved\-ip\-range\fR=\fIRESERVED_IP_RANGE\fR] [\fB\-\-size\fR=\fISIZE\fR;\ default=1] [\fB\-\-tier\fR=\fITIER\fR;\ default="basic"] [\fB\-\-transit\-encryption\-mode\fR=\fITRANSIT_ENCRYPTION_MODE\fR] [\fB\-\-zone\fR=\fIZONE\fR] [\fIGCLOUD_WIDE_FLAG\ ...\fR]



.SH "DESCRIPTION"

\fB(ALPHA)\fR Create a new Redis instance.

This command can fail for the following reasons:
.RS 2m
.IP "\(bu" 2m
An instance with the same name already exists.
.IP "\(bu" 2m
The active account does not have permission to create instances.
.RE
.sp



.SH "EXAMPLES"

To create a basic tier instance with the name \f5my\-redis\-instance\fR in
region \f5us\-central\-1\fR with memory size of 5 GiB, run:

.RS 2m
$ gcloud alpha redis instances create my\-redis\-instance \e
    \-\-region=us\-central1 \-\-size=5
.RE



.SH "POSITIONAL ARGUMENTS"

.RS 2m
.TP 2m

Instance resource \- Arguments and flags that specify the Memorystore Redis
instance you want to create. 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 \f5project\fR attribute:
.RS 2m
.IP "\(em" 2m
provide the argument \f5instance\fR on the command line with a fully specified
name;
.IP "\(em" 2m
provide the argument \f5\-\-project\fR on the command line;
.IP "\(em" 2m
set the property \f5core/project\fR.
.RE
.sp

This must be specified.


.RS 2m
.TP 2m
\fIINSTANCE\fR

ID of the instance or fully qualified identifier for the instance.

To set the \f5instance\fR attribute:
.RS 2m
.IP "\(bu" 2m
provide the argument \f5instance\fR on the command line.
.RE
.sp

This positional argument must be specified if any of the other arguments in this
group are specified.

.TP 2m
\fB\-\-region\fR=\fIREGION\fR

The name of the Redis region of the instance. Overrides the default redis/region
property value for this command invocation.


To set the \f5region\fR attribute:
.RS 2m
.IP "\(bu" 2m
provide the argument \f5instance\fR on the command line with a fully specified
name;
.IP "\(bu" 2m
provide the argument \f5\-\-region\fR on the command line;
.IP "\(bu" 2m
set the property \f5redis/region\fR.
.RE
.sp


.RE
.RE
.sp

.SH "FLAGS"

.RS 2m
.TP 2m
\fB\-\-alternative\-zone\fR=\fIALTERNATIVE_ZONE\fR

A secondary zone for the Redis instance. Only applicable to the standard tier.
This protects the instance against zonal failures by provisioning it across two
zones. If provided, alternative zone must be a different zone from the one
provided through \f5\-\-zone\fR.

.TP 2m
\fB\-\-async\fR

Return immediately, without waiting for the operation in progress to complete.

.TP 2m
\fB\-\-connect\-mode\fR=\fICONNECT_MODE\fR

Network connection mode used by instances. \fICONNECT_MODE\fR must be one of:
\fBconnect\-mode\-unspecified\fR, \fBdirect\-peering\fR,
\fBprivate\-service\-access\fR.

.TP 2m
\fB\-\-customer\-managed\-key\fR=\fICUSTOMER_MANAGED_KEY\fR

The KMS key reference that you want to use to encrypt the data at rest for this
Redis instance. If this is provided, CMEK is enabled.

.TP 2m
\fB\-\-display\-name\fR=\fIDISPLAY_NAME\fR

A human\-readable name for the instance.

.TP 2m
\fB\-\-enable\-auth\fR

Enables Redis AUTH for the instance. If omitted AUTH is disabled.

.TP 2m
\fB\-\-labels\fR=[\fIKEY\fR=\fIVALUE\fR,...]

List of label KEY=VALUE pairs to add.

Keys must start with a lowercase character and contain only hyphens (\f5\-\fR),
underscores (\f5_\fR), lowercase characters, and numbers. Values must contain
only hyphens (\f5\-\fR), underscores (\f5_\fR), lowercase characters, and
numbers.

.TP 2m
\fB\-\-maintenance\-window\-day\fR=\fIMAINTENANCE_WINDOW_DAY\fR

Day of week for maintenance window, in UTC time zone. MAINTENANCE_WINDOW_DAY
must be one of: SUNDAY, MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY.
\fIMAINTENANCE_WINDOW_DAY\fR must be one of: \fBday\-of\-week\-unspecified\fR,
\fBfriday\fR, \fBmonday\fR, \fBsaturday\fR, \fBsunday\fR, \fBthursday\fR,
\fBtuesday\fR, \fBwednesday\fR.

.TP 2m
\fB\-\-maintenance\-window\-hour\fR=\fIMAINTENANCE_WINDOW_HOUR\fR

Hour of day (0 to 23) for maintenance window, in UTC time zone.

.TP 2m
\fB\-\-network\fR=\fINETWORK\fR; default="default"

The name of the Google Compute Engine network to which the instance will be
connected. If left unspecified, the default network will be used.

.TP 2m
\fB\-\-persistence\-mode\fR=\fIPERSISTENCE_MODE\fR

Operation mode for automated persistence. \fIPERSISTENCE_MODE\fR must be one of:

.RS 2m
.TP 2m
\fBdisabled\fR
RDB mode is disabled
.TP 2m
\fBrdb\fR
Automatic RDB persistence
.RE
.sp


.TP 2m
\fB\-\-rdb\-snapshot\-period\fR=\fIRDB_SNAPSHOT_PERIOD\fR

Attempted period between RDB snapshots. \fIRDB_SNAPSHOT_PERIOD\fR must be one
of:

.RS 2m
.TP 2m
\fB12h\fR
12 hours
.TP 2m
\fB1h\fR
1 hour
.TP 2m
\fB24h\fR
24 hours
.TP 2m
\fB6h\fR
6 hours
.RE
.sp


.TP 2m
\fB\-\-rdb\-snapshot\-start\-time\fR=\fIRDB_SNAPSHOT_START_TIME\fR

Date and time of the first snapshot in the ISO 1801 format, and alignment time
for future snapshots. For example, 2022\-11\-02T03:00:00Z.

.TP 2m
\fB\-\-read\-replicas\-mode\fR=\fIREAD_REPLICAS_MODE\fR

Read replicas mode used by the instance. Only works against standard tier
instances with 5GB and above provisioned capacity. \fIREAD_REPLICAS_MODE\fR must
be one of:

.RS 2m
.TP 2m
\fBread\-replicas\-disabled\fR
Read replica is disabled for the instance. Read endpoint will not be provided
and the instance cannot scale up or down the number of replicas.

.TP 2m
\fBread\-replicas\-enabled\fR
Read replica is enabled for the instance. Read endpoint will be provided and the
instance can scale up and down the number of replicas.

.RE
.sp


.TP 2m
\fB\-\-redis\-config\fR=[\fIKEY\fR=\fIVALUE\fR,...]

A list of Redis config KEY=VALUE pairs to set on the instance according to
http://redis.io/topics/config. Currently, the only supported parameters are:

Redis version 3.2 and newer: maxmemory\-policy, notify\-keyspace\-events,
timeout, databases.

Redis version 4.0 and newer: activedefrag, lfu\-decay\-time, lfu\-log\-factor,
maxmemory\-gb.

Redis version 5.0 and newer: stream\-node\-max\-bytes,
stream\-node\-max\-entries.

.TP 2m
\fB\-\-redis\-version\fR=\fIVERSION\fR

The version of Redis software. \fIVERSION\fR must be one of:

.RS 2m
.TP 2m
\fBredis_3_2\fR
Redis 3.2 compatibility
.TP 2m
\fBredis_4_0\fR
Redis 4.0 compatibility
.TP 2m
\fBredis_5_0\fR
Redis 5.0 compatibility
.TP 2m
\fBredis_6_x\fR
Redis 6.x compatibility
.TP 2m
\fBredis_7_0\fR
Redis 7.0 compatibility
.TP 2m
\fBredis_7_2\fR
Redis 7.2 compatibility
.RE
.sp


.TP 2m
\fB\-\-replica\-count\fR=\fIREPLICA_COUNT\fR

The replica count of the instance.

.TP 2m
\fB\-\-reserved\-ip\-range\fR=\fIRESERVED_IP_RANGE\fR

For DIRECT_PEERING mode, the CIDR range of internal addresses that are reserved
for this instance. Range must be unique and non\-overlapping with existing
subnets in an authorized network. For PRIVATE_SERVICE_ACCESS mode, the name of
an IP address range allocated for the private service access connection. If not
provided, the service will choose an unused /29 block, for example, 10.0.0.0/29
or 192.168.0.0/29. If READ_REPLICAS_ENABLED is used for the
\-\-read\-replicas\-mode flag, then the block size required for this flag is
/28.

.TP 2m
\fB\-\-size\fR=\fISIZE\fR; default=1

The memory size of the instance in GiB. If not provided, size of 1 GiB will be
used.

.TP 2m
\fB\-\-tier\fR=\fITIER\fR; default="basic"

The service tier of the instance. \fITIER\fR must be one of:

.RS 2m
.TP 2m
\fBbasic\fR
Basic Redis instance with no replication
.TP 2m
\fBstandard\fR
Standard high\-availability Redis instance with replication
.RE
.sp


.TP 2m
\fB\-\-transit\-encryption\-mode\fR=\fITRANSIT_ENCRYPTION_MODE\fR

Transit encryption mode used by the instance. \fITRANSIT_ENCRYPTION_MODE\fR must
be one of:

.RS 2m
.TP 2m
\fBdisabled\fR
Transit encryption is disabled for the instance.
.TP 2m
\fBserver\-authentication\fR
Client to Server traffic encryption enabled with server authentication.
.RE
.sp


.TP 2m
\fB\-\-zone\fR=\fIZONE\fR

The zone of the Redis instance. If not provided the service will pick a random
zone in the region. For the standard tier, instances will be created across two
zones for protection against zonal failures. So if \-\-alternative\-zone is also
provided, it must be different from \-\-zone.


.RE
.sp

.SH "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 \fB$ gcloud help\fR for details.



.SH "API REFERENCE"

This command uses the \fBredis/v1alpha1\fR API. The full documentation for this
API can be found at: https://cloud.google.com/memorystore/docs/redis/



.SH "NOTES"

This command is currently in alpha and might change without notice. If this
command fails with API permission errors despite specifying the correct project,
you might be trying to access an API with an invitation\-only early access
allowlist. These variants are also available:

.RS 2m
$ gcloud redis instances create
.RE

.RS 2m
$ gcloud beta redis instances create
.RE