gcloud alpha scc posture-deployments update

NAME
gcloud alpha scc posture-deployments update - update the given Cloud Security Command Center posture deployment
SYNOPSIS
gcloud alpha scc posture-deployments update (POSTURE_DEPLOYMENT : --location=LOCATION --organization=ORGANIZATION) [--async] [--description=DESCRIPTION] [--etag=ETAG] [--update-mask=UPDATE_MASK] [--posture-id=POSTURE_ID --posture-revision-id=POSTURE_REVISION_ID] [GCLOUD_WIDE_FLAG]
DESCRIPTION
(ALPHA) 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 "" 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.

EXAMPLES
Update the description of the posture deployment named foo-posture-deployment in the organization organizations/123/locations/global:
gcloud alpha scc posture-deployments update organizations/123/locations/global/postureDeployments/foo-posture-deployment --update-mask=description --description="updated-description"

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 alpha scc posture-deployments update organizations/123/locations/global/postureDeployments/foo-posture-deployment --update-mask=posture_id,posture_revision-id --posture-id=foo-posture --posture-revision-id=abcdefgh
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 alpha scc posture-deployments update organizations/123/locations/global/postureDeployments/foo-posture-deployment --posture-id=foo-posture --posture-revision-id=abcdefgh
POSITIONAL ARGUMENTS
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.

POSTURE_DEPLOYMENT
ID of the posture_deployment or fully qualified identifier for the posture_deployment.

To set the posture_deployment attribute:

  • provide the argument posture_deployment on the command line.

This positional argument must be specified if any of the other arguments in this group are specified.

--location=LOCATION
ID of the location where the resource exists (for example, global). To set the location attribute:
  • provide the argument posture_deployment on the command line with a fully specified name;
  • provide the argument --location on the command line.
--organization=ORGANIZATION
ID of the organization which is the parent of the resource. To set the organization attribute:
  • provide the argument posture_deployment on the command line with a fully specified name;
  • provide the argument --organization on the command line.
FLAGS
--async
Return immediately, without waiting for the operation in progress to complete.
--description=DESCRIPTION
Updated description of posture deployment.
--etag=ETAG
Etag is an optional flag. If the provided Etag doesn't match the server generated Etag, the update operation won't proceed.
--update-mask=UPDATE_MASK
Comma-separated string containing list of fields to be updated.
--posture-id=POSTURE_ID
Relative name of the posture to be updated, like organizations/<organizationID>/locations/<location>/postures/<postureID>.
--posture-revision-id=POSTURE_REVISION_ID
Revision ID of the posture to be updated.
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 $ gcloud help for details.

API REFERENCE
This command uses the securityposture/v1alpha API. The full documentation for this API can be found at: https://cloud.google.com/security-command-center
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:
gcloud scc posture-deployments update