File: //snap/google-cloud-cli/current/help/man/man1/gcloud_scc_posture-deployments_update.1
.TH "GCLOUD_SCC_POSTURE\-DEPLOYMENTS_UPDATE" 1
.SH "NAME"
.HP
gcloud scc posture\-deployments update \- update the given Cloud Security Command Center posture deployment
.SH "SYNOPSIS"
.HP
\f5gcloud scc posture\-deployments update\fR (\fIPOSTURE_DEPLOYMENT\fR\ :\ \fB\-\-location\fR=\fILOCATION\fR\ \fB\-\-organization\fR=\fIORGANIZATION\fR) [\fB\-\-async\fR] [\fB\-\-description\fR=\fIDESCRIPTION\fR] [\fB\-\-etag\fR=\fIETAG\fR] [\fB\-\-update\-mask\fR=\fIUPDATE_MASK\fR] [\fB\-\-posture\-id\fR=\fIPOSTURE_ID\fR\ \fB\-\-posture\-revision\-id\fR=\fIPOSTURE_REVISION_ID\fR] [\fIGCLOUD_WIDE_FLAG\ ...\fR]
.SH "DESCRIPTION"
Update a Cloud Security Command Center (SCC) posture deployment.
Fields specified in update\-mask flag are updated. Updatable fields are
description and posture_name with posture_revision\-id. The target_resource for
a posture deployment cannot be updated. The posture deployment to be updated
should be in ACTIVE State. An empty or "\fB" update\-mask implies that
posture\-id and posture\-revision\-id are to be updated. If posture details of
posture deployment need to be updated, then the desired posture needs to be in
ACTIVE state. LRO operation ID is returned as the response of the command.
\fR
.SH "EXAMPLES"
Update the description of the posture deployment named
\f5foo\-posture\-deployment\fR in the organization
\f5organizations/123/locations/global\fR:.RS 2m
$ gcloud scc posture\-deployments update \e
organizations/123/locations/global/postureDeployments/\e
foo\-posture\-deployment \-\-update\-mask=description \e
\-\-description="updated\-description"
.RE
Update posture deployment named \f5foo\-posture\-deployment\fR with the posture
named \f5foo\-posture\fR and revision_id \f5abcdefgh\fR in the organization
\f5organizations/123/locations/global\fR:.RS 2m
$ gcloud scc posture\-deployments update \e
organizations/123/locations/global/postureDeployments/\e
foo\-posture\-deployment \e
\-\-update\-mask=posture_id,posture_revision\-id \e
\-\-posture\-id=foo\-posture \-\-posture\-revision\-id=abcdefgh
.RE
.RS 2m
Update posture deployment named `foo\-posture\-deployment` with the posture named `foo\-posture` and revision_id `abcdefgh` in the organization `organizations/123/locations/global`:
$ gcloud scc posture\-deployments update \e
organizations/123/locations/global/postureDeployments/\e
foo\-posture\-deployment \-\-posture\-id=foo\-posture \e
\-\-posture\-revision\-id=abcdefgh
.RE
.SH "POSITIONAL ARGUMENTS"
.RS 2m
.TP 2m
Posture deployment resource \- The posture deployment to update. For example
organizations/<organizationID>/locations/<location>/postureDeployments/<postureDeploymentID>.
The arguments in this group can be used to specify the attributes of this
resource.
This must be specified.
.RS 2m
.TP 2m
\fIPOSTURE_DEPLOYMENT\fR
ID of the posture_deployment or fully qualified identifier for the
posture_deployment.
To set the \f5posture_deployment\fR attribute:
.RS 2m
.IP "\(bu" 2m
provide the argument \f5posture_deployment\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\-\-location\fR=\fILOCATION\fR
ID of the location where the resource exists (for example, global).
To set the \f5location\fR attribute:
.RS 2m
.IP "\(bu" 2m
provide the argument \f5posture_deployment\fR on the command line with a fully
specified name;
.IP "\(bu" 2m
provide the argument \f5\-\-location\fR on the command line.
.RE
.sp
.TP 2m
\fB\-\-organization\fR=\fIORGANIZATION\fR
ID of the organization which is the parent of the resource.
To set the \f5organization\fR attribute:
.RS 2m
.IP "\(bu" 2m
provide the argument \f5posture_deployment\fR on the command line with a fully
specified name;
.IP "\(bu" 2m
provide the argument \f5\-\-organization\fR on the command line.
.RE
.sp
.RE
.RE
.sp
.SH "FLAGS"
.RS 2m
.TP 2m
\fB\-\-async\fR
Return immediately, without waiting for the operation in progress to complete.
.TP 2m
\fB\-\-description\fR=\fIDESCRIPTION\fR
Updated description of posture deployment.
.TP 2m
\fB\-\-etag\fR=\fIETAG\fR
Etag is an optional flag. If the provided Etag doesn't match the server
generated Etag, the update operation won't proceed.
.TP 2m
\fB\-\-update\-mask\fR=\fIUPDATE_MASK\fR
Comma\-separated string containing list of fields to be updated.
.TP 2m
\fB\-\-posture\-id\fR=\fIPOSTURE_ID\fR
Relative name of the posture to be updated, like
\f5organizations/<organizationID>/locations/<location>/postures/<postureID>\fR.
.TP 2m
\fB\-\-posture\-revision\-id\fR=\fIPOSTURE_REVISION_ID\fR
Revision ID of the posture to be updated.
.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 \fBsecurityposture/v1\fR API. The full documentation for
this API can be found at: https://cloud.google.com/security\-command\-center
.SH "NOTES"
This variant is also available:
.RS 2m
$ gcloud alpha scc posture\-deployments update
.RE