.TH "GCLOUD_ALPHA_CLOUDLOCATIONFINDER_CLOUD\-LOCATIONS_SEARCH" 1



.SH "NAME"
.HP
gcloud alpha cloudlocationfinder cloud\-locations search \- search cloudLocations



.SH "SYNOPSIS"
.HP
\f5gcloud alpha cloudlocationfinder cloud\-locations search\fR \fB\-\-source\-cloud\-location\fR=\fISOURCE_CLOUD_LOCATION\fR [\fB\-\-limit\fR=\fILIMIT\fR] [\fB\-\-location\fR=\fILOCATION\fR] [\fB\-\-page\-size\fR=\fIPAGE_SIZE\fR] [\fB\-\-query\fR=\fIQUERY\fR] [\fIGCLOUD_WIDE_FLAG\ ...\fR]



.SH "DESCRIPTION"

\fB(ALPHA)\fR Search Cloudlocations.



.SH "EXAMPLES"

To search CloudLocations, run:

.RS 2m
$ gcloud alpha cloudlocationfinder cloud\-locations search \e
  \-\-source\-cloud\-location=aws\-us\-east\-1 \e
  \-\-query=display_name="us\-east4"
.RE



.SH "REQUIRED FLAGS"

.RS 2m
.TP 2m

Source cloud location resource \- The source Cloud location. This represents a
Cloud 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 \f5\-\-source\-cloud\-location\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

To set the \f5location\fR attribute:
.RS 2m
.IP "\(em" 2m
provide the argument \f5\-\-source\-cloud\-location\fR on the command line with
a fully specified name;
.IP "\(em" 2m
provide the argument \f5\-\-location\fR on the command line;
.IP "\(em" 2m
location is always global.
.RE
.sp

This must be specified.


.RS 2m
.TP 2m
\fB\-\-source\-cloud\-location\fR=\fISOURCE_CLOUD_LOCATION\fR

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

To set the \f5cloud_location\fR attribute:
.RS 2m
.IP "\(bu" 2m
provide the argument \f5\-\-source\-cloud\-location\fR on the command line.
.RE
.sp


.RE
.RE
.sp

.SH "OPTIONAL FLAGS"

.RS 2m
.TP 2m
\fB\-\-limit\fR=\fILIMIT\fR

Maximum number of resources to return.

.TP 2m

Location resource \- The resource location. This represents a Cloud 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 \f5\-\-location\fR on the command line with a fully
specified name;
.IP "\(em" 2m
location is always global 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


.RS 2m
.TP 2m
\fB\-\-location\fR=\fILOCATION\fR

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

To set the \f5location\fR attribute:
.RS 2m
.IP "\(bu" 2m
provide the argument \f5\-\-location\fR on the command line;
.IP "\(bu" 2m
location is always global.
.RE
.sp

.RE
.sp
.TP 2m
\fB\-\-page\-size\fR=\fIPAGE_SIZE\fR

Maximum number of resources per page.

.TP 2m
\fB\-\-query\fR=\fIQUERY\fR

Query to use for searching Cloudlocations.


.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 "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. This variant is also available:

.RS 2m
$ gcloud cloudlocationfinder cloud\-locations search
.RE