1
0
Fork 0
mirror of https://github.com/imjasonh/gcloud-help synced 2026-07-08 10:35:03 +00:00
gcloud-help/gcloud/alpha/scc/assets/describe
2023-07-20 11:47:25 +00:00

96 lines
3.8 KiB
Text

NAME
gcloud alpha scc assets describe - describe an asset given its resource
name or asset id
SYNOPSIS
gcloud alpha scc assets describe [PARENT]
(--asset=ASSET | --resource-name=RESOURCE_NAME) [GCLOUD_WIDE_FLAG ...]
DESCRIPTION
(ALPHA) (DEPRECATED) Security Command Center Asset APIs are deprecated and
will be removed on or after June 26, 2024. Use Cloud Asset Inventory
instead (gcloud asset)
(https://cloud.google.com/sdk/gcloud/reference/asset). For more
information, see the deprecation notice at Assets Page
(https://cloud.google.com/security-command-center/docs/how-to-use-security-command-center#assets_page).
Describe an asset given its resource name or asset id.
EXAMPLES
Describe an asset under organization 123456, given its full resource name
(https://cloud.google.com/apis/design/resource_names#full_resource_name)
e.g. //storage.googleapis.com/my-bucket:
$ gcloud alpha scc assets describe 123456 \
--resource-name="//storage.googleapis.com/my-bucket"
Describe an asset under organization 123456, given its Cloud SCC asset id
5678
$ gcloud alpha scc assets describe 123456 --asset=5678
Describe an asset under project example-project, given its Cloud SCC asset
id 5678
$ gcloud alpha scc assets describe \
projects/example-project/assets/5678
Describe an asset under folder 456, given its Cloud SCC asset id 5678
$ gcloud alpha scc assets describe folders/456/assets/5678
POSITIONAL ARGUMENTS
Parent resource - parent organization, folder, or project in the Google
Cloud resource hierarchy to be used for the gcloud scc command. Specify
the argument as either [RESOURCE_TYPE/RESOURCE_ID] or [RESOURCE_ID], as
shown in the preceding examples. This represents a Cloud resource.
[PARENT]
ID of the parent or fully qualified identifier for the parent.
To set the parent attribute:
▸ provide the argument parent on the command line;
▸ Set the parent property in configuration using gcloud config set
scc/parent if it is not specified in command line.
REQUIRED FLAGS
Exactly one of these must be specified:
--asset=ASSET
Cloud SCC specific asset. It's derived from the the asset's relative
resource name. See:
https://cloud.google.com/apis/design/resource_names#relative_resource_name.
For Example, for the given asset name:
"organizations/123/assets/456", 456 represents asset id.
--resource-name=RESOURCE_NAME
Asset's resource name. Full resource name of the Google Cloud
Platform resource this asset represents. This field is immutable
after create time. See:
https://cloud.google.com/apis/design/resource_names#full_resource_name.
For Example:
"//cloudresourcemanager.googleapis.com/projects/1234567890123" could
be the resource-name for a project.
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 securitycenter/v1 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. These variants are also available:
$ gcloud scc assets describe
$ gcloud beta scc assets describe