File: //snap/google-cloud-cli/396/help/man/man1/gcloud_redis_clusters_add-cluster-endpoints.1
.TH "GCLOUD_REDIS_CLUSTERS_ADD\-CLUSTER\-ENDPOINTS" 1
.SH "NAME"
.HP
gcloud redis clusters add\-cluster\-endpoints \- add more cluster endpoints
.SH "SYNOPSIS"
.HP
\f5gcloud redis clusters add\-cluster\-endpoints\fR (\fICLUSTER\fR\ :\ \fB\-\-region\fR=\fIREGION\fR) \fB\-\-cluster\-endpoint\fR=[\fIpsc\-connection\fR=\fIPSC\-CONNECTION\fR] [\fB\-\-async\fR] [\fIGCLOUD_WIDE_FLAG\ ...\fR]
.SH "DESCRIPTION"
This is required to enable multi\-vpc for Redis cluster.
To add one cluster endpoint to an existing Redis cluster, two PSC connections
MUST be added as a pair: one for the Redis cluster's discovery service
attachment and the other for the additional service attachment.
Multiple cluster endpoints COULD be added simultaneously.
This command can fail for the following reasons:
.RS 2m
.IP "\(bu" 2m
The cluster specified does not exist.
.IP "\(bu" 2m
The number of connections provided to a cluster endpoint are not in pairs.
.IP "\(bu" 2m
One of the connections is not found.
.RE
.sp
.SH "EXAMPLES"
To connect redis cluster to one additional VPC, run:
.RS 2m
$ gcloud redis clusters add\-cluster\-endpoints my\-redis\-cluster \e
add\-cluster\-endpoints \e
\-\-cluster\-endpoint='["psc\-connection":[{"psc\-connection\-id":"$ID\e
","address":"$IP","network":"projects/$PROJECT/global/networks/$NETW\e
ORK","forwarding\-rule":"projects/$PROJECT/regions/us\-east1/forwardin\e
gRules/$FR_NAME","service\-attachment":"projects/$PROJECT/regions/$RE\e
GION/serviceAttachments/$SA_NAME"},{$ADDITIONAL_PSC_CONNECTION}]]' \e
\-\-cluster_endpoint=$ADDITIONAL_CLUSTER_ENDPOINT \e
$PSCConnectionID SHOULD be extracted from forwarding rules. \e
E.g. 75311697652483351
.RE
.SH "POSITIONAL ARGUMENTS"
.RS 2m
.TP 2m
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 \f5project\fR attribute:
.RS 2m
.IP "\(em" 2m
provide the argument \f5cluster\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
\fICLUSTER\fR
ID of the cluster or fully qualified identifier for the cluster.
To set the \f5cluster\fR attribute:
.RS 2m
.IP "\(bu" 2m
provide the argument \f5cluster\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 cluster. 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 \f5cluster\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 "REQUIRED FLAGS"
.RS 2m
.TP 2m
\fB\-\-cluster\-endpoint\fR=[\fIpsc\-connection\fR=\fIPSC\-CONNECTION\fR]
Required, Resource details of a redis cluster endpoint.
.RS 2m
.TP 2m
\fBpsc\-connection\fR
Sets \f5psc\-connection\fR value.
.RS 2m
.TP 2m
\fBaddress\fR
Sets \f5address\fR value.
.TP 2m
\fBforwarding\-rule\fR
Sets \f5forwarding\-rule\fR value.
.TP 2m
\fBnetwork\fR
Sets \f5network\fR value.
.TP 2m
\fBpsc\-connection\-id\fR
Sets \f5psc\-connection\-id\fR value.
.TP 2m
\fBservice\-attachment\fR
Sets \f5service\-attachment\fR value.
.RE
.RE
.sp
\fBShorthand Example:\fR
.RS 2m
\-\-cluster\-endpoint=psc\-connection=[{address=string,forwarding\-rule=string,network=string,psc\-connection\-id=string,service\-attachment=string}] \-\-cluster\-endpoint=psc\-connection=[{address=string,forwarding\-rule=string,network=string,psc\-connection\-id=string,service\-attachment=string}]
.RE
\fBJSON Example:\fR
.RS 2m
\-\-cluster\-endpoint='[{"psc\-connection": [{"address": "string", "forwarding\-rule": "string", "network": "string", "psc\-connection\-id": "string", "service\-attachment": "string"}]}]'
.RE
\fBFile Example:\fR
.RS 2m
\-\-cluster\-endpoint=path_to_file.(yaml|json)
.RE
.RE
.sp
.SH "OPTIONAL FLAGS"
.RS 2m
.TP 2m
\fB\-\-async\fR
Return immediately, without waiting for the operation in progress to complete.
.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/v1\fR API. The full documentation for this API
can be found at: https://cloud.google.com/memorystore/docs/redis/
.SH "NOTES"
These variants are also available:
.RS 2m
$ gcloud alpha redis clusters add\-cluster\-endpoints
.RE
.RS 2m
$ gcloud beta redis clusters add\-cluster\-endpoints
.RE