gcloud-help/gcloud/redis/instances/create

NAME
    gcloud redis instances create - create a Memorystore Redis instance

SYNOPSIS
    gcloud redis instances create (INSTANCE : --region=REGION)
        [--alternative-zone=ALTERNATIVE_ZONE] [--async]
        [--connect-mode=CONNECT_MODE] [--display-name=DISPLAY_NAME]
        [--enable-auth] [--labels=[KEY=VALUE,...]]
        [--network=NETWORK; default="default"] [--redis-config=KEY=VALUE]
        [--redis-version=VERSION] [--reserved-ip-range=RESERVED_IP_RANGE]
        [--size=SIZE; default=1] [--tier=TIER; default="basic"]
        [--transit-encryption-mode=TRANSIT_ENCRYPTION_MODE] [--zone=ZONE]
        [GCLOUD_WIDE_FLAG ...]

DESCRIPTION
    Create a new Redis instance.

    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.

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

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. To
          set the instance attribute:
          ▸ provide the argument instance on the command line.

          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.

          To set the region attribute:
          ▸ provide the argument instance on the command line with a fully
            specified name;
          ▸ provide the argument --region on the command line;
          ▸ set the property redis/region.

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
        Return immediately, without waiting for the operation in progress to
        complete.

     --connect-mode=CONNECT_MODE
        Network connection mode used by instances. CONNECT_MODE must be one of:
        connect-mode-unspecified, direct-peering, private-service-access.

     --display-name=DISPLAY_NAME
        A human-readable name for the instance.

     --enable-auth
        Enables Redis AUTH for the instance. If omitted AUTH is disabled.

     --labels=[KEY=VALUE,...]
        List of label KEY=VALUE pairs to add.

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

     --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 http://redis.io/topics/config. Currently, the only supported
        parameters are:

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

        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.

     --redis-version=VERSION
        The version of Redis software. VERSION must be one of:

         redis_3_2
            Redis 3.2 compatibility
         redis_4_0
            Redis 4.0 compatibility
         redis_5_0
            Redis 5.0 compatibility
         redis_6_x
            Redis 6.x compatibility

     --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

     --transit-encryption-mode=TRANSIT_ENCRYPTION_MODE
        Transit encryption mode used by the instance. TRANSIT_ENCRYPTION_MODE
        must be one of:

         disabled
            Transit encryption is disabled for the instance.
         server-authentication
            Client to Server traffic encryption enabled with server
            authentication.

     --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: --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 help for details.

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

NOTES
    These variants are also available:

        $ gcloud alpha redis instances create

        $ gcloud beta redis instances create