.TH "GCLOUD_BETA_RECOMMENDER_RECOMMENDATIONS_MARK\-CLAIMED" 1



.SH "NAME"
.HP
gcloud beta recommender recommendations mark\-claimed \- mark a recommendation's state as CLAIMED



.SH "SYNOPSIS"
.HP
\f5gcloud beta recommender recommendations mark\-claimed\fR \fIRECOMMENDATION\fR \fB\-\-etag\fR=\fIETAG\fR \fB\-\-location\fR=\fILOCATION\fR \fB\-\-recommender\fR=\fIRECOMMENDER\fR (\fB\-\-billing\-account\fR=\fIBILLING_ACCOUNT\fR\ |\ \fB\-\-folder\fR=\fIFOLDER_ID\fR\ |\ \fB\-\-organization\fR=\fIORGANIZATION_ID\fR\ |\ \fB\-\-project\fR=\fIPROJECT_ID\fR) [\fB\-\-state\-metadata\fR=\fIKEY\fR=\fIVALUE\fR,[\fIKEY\fR=\fIVALUE\fR,...]] [\fIGCLOUD_WIDE_FLAG\ ...\fR]



.SH "DESCRIPTION"

\fB(BETA)\fR Mark a recommendation's state as CLAIMED. Can be applied to
recommendations in CLAIMED, SUCCEEDED, FAILED, or ACTIVE state. Users can use
this method to indicate to the Recommender API that they are starting to apply
the recommendation themselves. This stops the recommendation content from being
updated.



.SH "EXAMPLES"

To mark a recommendation as CLAIMED:

.RS 2m
$ gcloud beta recommender recommendations mark\-claimed abcd\-1234 \e
    \-\-project=project\-id \-\-location=global \e
    \-\-recommender=google.compute.instance.MachineTypeRecommender \e
    \-\-etag=abc123 \-\-state\-metadata=key1=value1,key2=value2
.RE



.SH "POSITIONAL ARGUMENTS"

.RS 2m
.TP 2m
\fIRECOMMENDATION\fR

Recommendation id which will be marked as claimed


.RE
.sp

.SH "REQUIRED FLAGS"

.RS 2m
.TP 2m
\fB\-\-etag\fR=\fIETAG\fR

Etag of a recommendation

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

Location

.TP 2m
\fB\-\-recommender\fR=\fIRECOMMENDER\fR

Recommender of recommendation

.TP 2m

Resource that is associated with cloud entity type. Currently four mutually
exclusive flags are supported, \-\-project, \-\-billing\-account, \-\-folder,
\-\-organization.

Exactly one of these must be specified:


.RS 2m
.TP 2m
\fB\-\-billing\-account\fR=\fIBILLING_ACCOUNT\fR

The Google Cloud Platform billing account ID to use for this invocation.

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

The Google Cloud Platform folder ID to use for this invocation.

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

The Google Cloud Platform organization ID to use for this invocation.

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

The Google Cloud Platform project ID. Overrides the default \fBcore/project\fR
property value for this command invocation.


.RE
.RE
.sp

.SH "OPTIONAL FLAGS"

.RS 2m
.TP 2m
\fB\-\-state\-metadata\fR=\fIKEY\fR=\fIVALUE\fR,[\fIKEY\fR=\fIVALUE\fR,...]

State metadata for recommendation, in format of
\-\-state\-metadata=key1=value1,key2=value2


.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 beta and might change without notice. These
variants are also available:

.RS 2m
$ gcloud recommender recommendations mark\-claimed
.RE

.RS 2m
$ gcloud alpha recommender recommendations mark\-claimed
.RE