mirror of
https://github.com/imjasonh/gcloud-help
synced 2026-07-08 02:25:19 +00:00
105 lines
4.6 KiB
Text
105 lines
4.6 KiB
Text
NAME
|
|
gcloud asset get-history - get the update history of assets that overlaps a
|
|
time window
|
|
|
|
SYNOPSIS
|
|
gcloud asset get-history --asset-names=[ASSET_NAMES,...]
|
|
--content-type=CONTENT_TYPE --start-time=START_TIME
|
|
(--organization=ORGANIZATION_ID | --project=PROJECT_ID)
|
|
[--end-time=END_TIME] [--relationship-types=[RELATIONSHIP_TYPES,...]]
|
|
[GCLOUD_WIDE_FLAG ...]
|
|
|
|
DESCRIPTION
|
|
Get the update history of assets that overlaps a time window.
|
|
|
|
EXAMPLES
|
|
To get the history of asset metadata for
|
|
'//compute.googleapis.com/projects/test-project/zones/us-central1-f/instances/instance1'
|
|
between '2018-10-02T15:01:23.045Z' and '2018-12-05T13:01:21.045Z', run:
|
|
|
|
$ gcloud asset get-history --project='test-project' \
|
|
--asset-names='//compute.googleapis.com/projects/test-project/zo\
|
|
nes/us-central1-f/instances/instance1' \
|
|
--start-time='2018-10-02T15:01:23.045Z' \
|
|
--end-time='2018-12-05T13:01:21.045Z' --content-type='resource'
|
|
|
|
To get the history of asset iam policy for
|
|
'//cloudresourcemanager.googleapis.com/projects/10179387634' between
|
|
'2018-10-02T15:01:23.045Z' and '2018-12-05T13:01:21.045Z', and project
|
|
'10179387634' is in organization '1060499660910', run:
|
|
|
|
$ gcloud asset get-history --organization='1060499660910' \
|
|
--asset-names='//cloudresourcemanager.googleapis.com/projects/10\
|
|
179387634' --start-time='2018-10-02T15:01:23.045Z' \
|
|
--end-time='2018-12-05T13:01:21.045Z' \
|
|
--content-type='iam-policy'
|
|
|
|
REQUIRED FLAGS
|
|
--asset-names=[ASSET_NAMES,...]
|
|
A list of full names of the assets to get the history for. For more
|
|
information, see:
|
|
https://cloud.google.com/apis/design/resource_names#full_resource_name
|
|
|
|
--content-type=CONTENT_TYPE
|
|
Asset content type. Specifying resource will export resource metadata,
|
|
specifying iam-policy will export the IAM policy for each child asset,
|
|
specifying org-policy will export the Org Policy set on child assets,
|
|
specifying access-policy will export the Access Policy set on child
|
|
assets, specifying os-inventory will export the OS inventory of VM
|
|
instances, and specifying relationship will export relationships of the
|
|
assets. CONTENT_TYPE must be one of: resource, iam-policy, org-policy,
|
|
access-policy, os-inventory, relationship.
|
|
|
|
--start-time=START_TIME
|
|
Start time of the time window (inclusive) for the asset history. Must
|
|
be after the current time minus 35 days. See $ gcloud topic datetimes
|
|
for information on time formats.
|
|
|
|
Exactly one of these must be specified:
|
|
|
|
--organization=ORGANIZATION_ID
|
|
The ID of the organization which is the root asset.
|
|
|
|
--project=PROJECT_ID
|
|
The project which is the root asset.
|
|
|
|
The Google Cloud project ID to use for this invocation. If omitted,
|
|
then the current project is assumed; the current project can be
|
|
listed using gcloud config list --format='text(core.project)' and can
|
|
be set using gcloud config set project PROJECTID.
|
|
|
|
--project and its fallback core/project property play two roles in
|
|
the invocation. It specifies the project of the resource to operate
|
|
on. It also specifies the project for API enablement check, quota,
|
|
and billing. To specify a different project for quota and billing,
|
|
use --billing-project or billing/quota_project property.
|
|
|
|
OPTIONAL FLAGS
|
|
--end-time=END_TIME
|
|
End time of the time window (exclusive) for the asset history. Defaults
|
|
to current time if not specified. See $ gcloud topic datetimes for
|
|
information on time formats.
|
|
|
|
--relationship-types=[RELATIONSHIP_TYPES,...]
|
|
A list of relationship types (i.e., "INSTANCE_TO_INSTANCEGROUP") to
|
|
take a snapshot. This argument will only be honoured if
|
|
content_type=RELATIONSHIP. If specified and non-empty, only
|
|
relationships matching the specified types will be returned. See
|
|
http://cloud.google.com/asset-inventory/docs/supported-asset-types for
|
|
supported relationship types.
|
|
|
|
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.
|
|
|
|
NOTES
|
|
These variants are also available:
|
|
|
|
$ gcloud alpha asset get-history
|
|
|
|
$ gcloud beta asset get-history
|
|
|