gcloud: Wed Aug 14 09:38:18 UTC 2024

gcloud/redis/clusters/create

@@ -4,12 +4,13 @@ NAME
 
 SYNOPSIS
     gcloud redis clusters create (CLUSTER : --region=REGION) --network=NETWORK
-        --shard-count=SHARD_COUNT [--aof-append-fsync=AOF_APPEND_FSYNC]
-        [--async] [--auth-mode=AUTH_MODE] [--deletion-protection]
-        [--node-type=NODE_TYPE] [--persistence-mode=PERSISTENCE_MODE]
+        [--aof-append-fsync=AOF_APPEND_FSYNC] [--async] [--auth-mode=AUTH_MODE]
+        [--deletion-protection] [--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]
+        [--shard-count=SHARD_COUNT]
         [--transit-encryption-mode=TRANSIT_ENCRYPTION_MODE] [--zone=ZONE]
         [--zone-distribution-mode=ZONE_DISTRIBUTION_MODE]
         [GCLOUD_WIDE_FLAG ...]
@@ -84,9 +85,6 @@ REQUIRED FLAGS
         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_FSYNC must be one of:
@@ -162,6 +160,9 @@ OPTIONAL FLAGS
      --replica-count=REPLICA_COUNT
         The replica count of each shard.
 
+     --shard-count=SHARD_COUNT
+        The shard count of the cluster.
+
      --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_MODE must be

gcloud/redis/clusters/detach

@@ -0,0 +1,80 @@
+NAME
+    gcloud redis clusters detach - detach a secondary cluster
+
+SYNOPSIS
+    gcloud redis clusters detach (CLUSTER : --region=REGION) [--async]
+        [GCLOUD_WIDE_FLAG ...]
+
+DESCRIPTION
+    Detach a secondary cluster from the primary cluster.
+
+    After detachment, the secondary cluster becomes an independent cluster,
+    i.e. it stops replicating from the primary cluster and it now accepts both
+    read and write requests.
+
+    This command is only supported on secondary clusters.
+
+EXAMPLES
+    To detach a secondary cluster with name my-secondary-cluster in region
+    us-central1, run:
+
+        $ gcloud redis clusters detach my-secondary-cluster \
+            --region=us-central1
+
+POSITIONAL ARGUMENTS
+     Cluster resource - Arguments and flags that specify the Memorystore Redis
+     cluster you want to update. 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 cluster 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.
+
+       CLUSTER
+          ID of the cluster or fully qualified identifier for the cluster.
+
+          To set the cluster attribute:
+          ▸ provide the argument cluster on the command line.
+
+          This positional argument must be specified if any of the other
+          arguments in this group are specified.
+
+       --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 region attribute:
+          ▸ provide the argument cluster on the command line with a fully
+            specified name;
+          ▸ provide the argument --region on the command line;
+          ▸ set the property redis/region.
+
+FLAGS
+     --async
+        Return immediately, without waiting for the operation in progress to
+        complete.
+
+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 clusters detach
+
+        $ gcloud beta redis clusters detach
+

gcloud/redis/clusters/detach-secondaries

@@ -0,0 +1,93 @@
+NAME
+    gcloud redis clusters detach-secondaries - detach one or more secondary
+        clusters from the primary cluster
+
+SYNOPSIS
+    gcloud redis clusters detach-secondaries (CLUSTER : --region=REGION)
+        --clusters-to-detach=CLUSTERS_TO_DETACH [--async]
+        [GCLOUD_WIDE_FLAG ...]
+
+DESCRIPTION
+    Detach one or more secondary clusters from the primary cluster.
+
+    After detachment, the secondary clusters become independent clusters, i.e.
+    they stop replicating from the primary cluster and will now accept both
+    read and write requests.
+
+    This command is only supported on primary clusters.
+
+EXAMPLES
+    To detach the secondary clusters my-secondary-cluster1 and
+    my-secondary-cluster2 from the primary cluster my-primary-cluster, run:
+
+        $ gcloud redis clusters detach-secondaries my-primary-cluster \
+            --region=us-central1 \
+            --clusters-to-detach=projects/my-project/locations/us-east1/\
+        clusters/my-secondary-cluster1,projects/my-project/locations/\
+        asia-east1/clusters/my-secondary-cluster2
+
+POSITIONAL ARGUMENTS
+     Cluster resource - Arguments and flags that specify the Memorystore Redis
+     cluster you want to update. 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 cluster 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.
+
+       CLUSTER
+          ID of the cluster or fully qualified identifier for the cluster.
+
+          To set the cluster attribute:
+          ▸ provide the argument cluster on the command line.
+
+          This positional argument must be specified if any of the other
+          arguments in this group are specified.
+
+       --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 region attribute:
+          ▸ provide the argument cluster on the command line with a fully
+            specified name;
+          ▸ provide the argument --region on the command line;
+          ▸ set the property redis/region.
+
+REQUIRED FLAGS
+     --clusters-to-detach=CLUSTERS_TO_DETACH
+        Comma separated list of secondary clusters to detach from the primary
+        cluster.
+
+        Each element in the list should be in the format:
+        projects/PROJECT_ID/locations/REGION/clusters/CLUSTER_ID.
+
+OPTIONAL FLAGS
+     --async
+        Return immediately, without waiting for the operation in progress to
+        complete.
+
+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 clusters detach-secondaries
+
+        $ gcloud beta redis clusters detach-secondaries
+

gcloud/redis/clusters/help

@@ -24,6 +24,12 @@ COMMANDS
      describe
         Show metadata for a Memorystore for Redis Cluster instance.
 
+     detach
+        Detach a secondary cluster.
+
+     detach-secondaries
+        Detach one or more secondary clusters from the primary cluster.
+
      get-cluster-certificate-authority
         Get the certificate authority information for a Memorystore for Redis
         Cluster instance.
@@ -31,6 +37,9 @@ COMMANDS
      list
         List Memorystore for Redis Cluster instances.
 
+     switchover
+        Switchover to a secondary cluster.
+
      update
         Update Memorystore Cluster for Redis instance.
 

gcloud/redis/clusters/switchover

@@ -0,0 +1,81 @@
+NAME
+    gcloud redis clusters switchover - switchover to a secondary cluster
+
+SYNOPSIS
+    gcloud redis clusters switchover (CLUSTER : --region=REGION) [--async]
+        [GCLOUD_WIDE_FLAG ...]
+
+DESCRIPTION
+    This command promotes the secondary cluster to become the new primary
+    cluster. The old primary and other secondary clusters will automatically
+    become the secondary clusters of this cluster.
+
+    After the successful completion of this operation, the new primary cluster
+    will accept both read and write requests.
+
+    This command is only supported on secondary clusters.
+
+EXAMPLES
+    To switchover to a secondary cluster with name my-secondary-cluster in
+    region us-central1, run:
+
+        $ gcloud redis clusters switchover my-secondary-cluster \
+            --region=us-central1
+
+POSITIONAL ARGUMENTS
+     Cluster resource - Arguments and flags that specify the Memorystore Redis
+     cluster you want to update. 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 cluster 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.
+
+       CLUSTER
+          ID of the cluster or fully qualified identifier for the cluster.
+
+          To set the cluster attribute:
+          ▸ provide the argument cluster on the command line.
+
+          This positional argument must be specified if any of the other
+          arguments in this group are specified.
+
+       --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 region attribute:
+          ▸ provide the argument cluster on the command line with a fully
+            specified name;
+          ▸ provide the argument --region on the command line;
+          ▸ set the property redis/region.
+
+FLAGS
+     --async
+        Return immediately, without waiting for the operation in progress to
+        complete.
+
+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 clusters switchover
+
+        $ gcloud beta redis clusters switchover
+