.TH "GCLOUD_BETA_RECOMMENDER_RECOMMENDATIONS_MARK\-FAILED" 1



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



.SH "SYNOPSIS"
.HP
\f5gcloud beta recommender recommendations mark\-failed\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 FAILED. Can be applied to
recommendations in ACTIVE, CLAIMED, SUCCEEDED, or FAILED state.



.SH "EXAMPLES"

To mark a recommendation as FAILED:

.RS 2m
$ gcloud beta recommender recommendations mark\-failed 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 FAILED.


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

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