gcloud_redis_instances_create (1)
NAME
- gcloud redis instances create - create a Memorystore Redis instance
SYNOPSIS
-
gcloud redis instances create (INSTANCE : --region=REGION) [--alternative-zone=ALTERNATIVE_ZONE] [--async] [--display-name=DISPLAY_NAME] [--labels=KEY=VALUE] [--network=NETWORK; default="default"] [--redis-config=KEY=VALUE] [--reserved-ip-range=RESERVED_IP_RANGE] [--size=SIZE; default=1] [--tier=TIER; default="basic"] [--zone=ZONE] [GCLOUD_WIDE_FLAG ...]
DESCRIPTION
This command can fail for the following reasons:
-
- *
- An instance with the same name already exists.
- *
- The active account does not have permission to create instances.
POSITIONAL ARGUMENTS
-
-
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 [project] attribute:
provide the argument [instance] on the command line with a fully specified name;
provide the argument [--project] on the command line; set the property
[core/project]. This must be specified.
-
- INSTANCE
-
ID of the instance or fully qualified identifier for the instance. This
positional must be specified if any of the other arguments in this group are
specified.
- --region=REGION
-
The name of the Redis region of the instance. Overrides the default redis/region
property value for this command invocation.
-
-
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 [project] attribute:
provide the argument [instance] on the command line with a fully specified name;
provide the argument [--project] on the command line; set the property
[core/project]. This must be specified.
FLAGS
-
- --alternative-zone=ALTERNATIVE_ZONE
-
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 --zone.
- --async
-
Display information about the operation in progress, without waiting for the
operation to complete.
- --display-name=DISPLAY_NAME
-
A human-readable name for the instance.
- --labels=KEY=VALUE
-
A list of label KEY=VALUE pairs to add.
- --network=NETWORK; 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.
- --redis-config=KEY=VALUE
-
A list of Redis config KEY=VALUE pairs to set on the instance according to
redis.io/topics/config Currently, the only supported parameters are:
maxmemory-policy, notify-keyspace-events.
- --reserved-ip-range=RESERVED_IP_RANGE
-
The CIDR range of internal addresses that are reserved for this instance. For
example, 10.0.0.0/29 or 192.168.0.0/29. Range must be unique and
non-overlapping with existing ranges in the network. If left unspecified, the
service will automatically pick an available range.
- --size=SIZE; default=1
-
The memory size of the instance in GiB. If not provided, size of 1 GiB will be
used.
- --tier=TIER; default="basic"
-
The service tier of the instance. TIER must be one of:
-
- basic
- Basic Redis instance with no replication
- standard
- Standard high-availability Redis instance with replication
-
- --zone=ZONE
-
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.
GCLOUD WIDE FLAGS
These flags are available to all commands: --account, --configuration, --flags-file, --flatten, --format, --help, --log-http, --project, --quiet, --trace-token, --user-output-enabled, --verbosity. Run $ gcloud help for details.
API REFERENCE
This command uses the redis/v1 API. The full documentation for this API can be found at: cloud.google.com/memorystore/docs/redis
EXAMPLES
To create a basic tier instance with the name my-redis-instance in region us-central-1 with memory size of 5 GiB, run:
-
$ gcloud redis instances create my-redis-instance \
--region=us-central1 --size=5
NOTES
These variants are also available:
- $ gcloud alpha redis instances create $ gcloud beta redis instances create