.TH "GCLOUD_LOGGING_SCOPES_CREATE" 1



.SH "NAME"
.HP
gcloud logging scopes create \- create a log scope



.SH "SYNOPSIS"
.HP
\f5gcloud logging scopes create\fR \fILOG_SCOPE_ID\fR \fB\-\-resource\-names\fR=[\fIRESOURCE_NAMES\fR,...] [\fB\-\-description\fR=\fIDESCRIPTION\fR] [\fB\-\-folder\fR=\fIFOLDER_ID\fR\ |\ \fB\-\-organization\fR=\fIORGANIZATION_ID\fR\ |\ \fB\-\-project\fR=\fIPROJECT_ID\fR] [\fIGCLOUD_WIDE_FLAG\ ...\fR]



.SH "DESCRIPTION"

After creating a log scope, you can use it to view logs in 1 or more resources.



.SH "EXAMPLES"

To create a log scope in a project, run:

.RS 2m
$ gcloud logging scopes create my\-scope \e
    \-\-resource\-names=projects/my\-project
.RE

To create a log scope in a project with a description, run:

.RS 2m
$ gcloud logging scopes create my\-scope \e
    \-\-resource\-names=projects/my\-project \-\-description="my
custom log scope"
.RE

To create a log scope that contains more than 1 resource, such as projects and
views, run:

.RS 2m
$ gcloud logging scopes create my\-scope \e
    \-\-resource\-names=projects/my\-project,projects/my\-project2, \e
    projects/my\-project/locations/global/buckets/my\-bucket/views/\e
my\-view1, \e
    projects/my\-project/locations/global/buckets/my\-bucket/views/\e
my\-view2,
.RE



.SH "POSITIONAL ARGUMENTS"

.RS 2m
.TP 2m
\fILOG_SCOPE_ID\fR

ID of the log scope to create.


.RE
.sp

.SH "REQUIRED FLAGS"

.RS 2m
.TP 2m
\fB\-\-resource\-names\fR=[\fIRESOURCE_NAMES\fR,...]

Comma\-separated list of resource names in this log scope. It could be one or
more parent resources or one or more views. A log scope can include a maximum of
50 projects and a maximum of 100 resources in total. For example,
projects/[PROJECT_ID],
projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]\f5


\fR
.RE
.sp

.SH "OPTIONAL FLAGS"

.RS 2m
.TP 2m
\fB\-\-description\fR=\fIDESCRIPTION\fR

A textual description for the log scope.

.TP 2m

At most one of these can be specified:


.RS 2m
.TP 2m
\fB\-\-folder\fR=\fIFOLDER_ID\fR

Folder of the log scope to create.

.TP 2m
\fB\-\-organization\fR=\fIORGANIZATION_ID\fR

Organization of the log scope to create.

.TP 2m
\fB\-\-project\fR=\fIPROJECT_ID\fR

Project of the log scope to create.

The Google Cloud project ID to use for this invocation. If omitted, then the
current project is assumed; the current project can be listed using \f5gcloud
config list \-\-format='text(core.project)'\fR and can be set using \f5gcloud
config set project PROJECTID\fR.

\f5\-\-project\fR and its fallback \f5core/project\fR property play two roles in
the invocation. It specifies the project of the resource to operate on. It also
specifies the project for API enablement check, quota, and billing. To specify a
different project for quota and billing, use \f5\-\-billing\-project\fR or
\f5billing/quota_project\fR property.


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