1
0
Fork 0
mirror of https://github.com/imjasonh/gcloud-help synced 2026-07-08 10:35:03 +00:00
gcloud-help/gcloud/asset/feeds/create
2022-03-01 21:43:54 +00:00

117 lines
4.9 KiB
Text

NAME
gcloud asset feeds create - create a Cloud Asset Inventory Feed
SYNOPSIS
gcloud asset feeds create FEED_ID --pubsub-topic=PUBSUB_TOPIC
(--asset-names=[ASSET_NAMES,...] --asset-types=[ASSET_TYPES,...]
--relationship-types=[RELATIONSHIP_TYPES,...])
(--folder=FOLDER_ID | --organization=ORGANIZATION_ID
| --project=PROJECT_ID)
[--condition-description=CONDITION_DESCRIPTION]
[--condition-expression=CONDITION_EXPRESSION]
[--condition-title=CONDITION_TITLE] [--content-type=CONTENT_TYPE]
[GCLOUD_WIDE_FLAG ...]
DESCRIPTION
Create a new Cloud Asset Inventory Feed for updates on assets.
EXAMPLES
To create a new feed 'feed1' in project 'p1' which alerts on compute disks
and network resources types, run:
$ gcloud asset feeds create feed1 --project=p1 \
--asset-types=compute.googleapis.com/Network,\
compute.googleapis.com/Disk --content-type=resource \
--pubsub-topic=projects/project1/topics/feed-topic
POSITIONAL ARGUMENTS
FEED_ID
Asset feed identifier being created, it must be unique under the
specified parent resource project/folder/organization.
REQUIRED FLAGS
--pubsub-topic=PUBSUB_TOPIC
Name of the Cloud Pub/Sub topic to publish to, of the form
projects/PROJECT_ID/topics/TOPIC_ID. You can list existing topics with
gcloud pubsub topics list --format="text(name)"
At least one of these must be specified:
--asset-names=[ASSET_NAMES,...]
A comma-separated list of the full names of the assets to receive
updates. For example:
//compute.googleapis.com/projects/my_project_123/zones/zone1/instances/instance1.
For more information, see:
https://cloud.google.com/apis/design/resource_names#full_resource_name
--asset-types=[ASSET_TYPES,...]
A comma-separated list of types of the assets types to receive
updates. For example:
compute.googleapis.com/Disk,compute.googleapis.com/Network. Regular
expressions (https://github.com/google/re2/wiki/Syntax) are also
supported. For more information, see:
https://cloud.google.com/resource-manager/docs/cloud-asset-inventory/overview
--relationship-types=[RELATIONSHIP_TYPES,...]
A comma-separated list of the relationship types (i.e.,
"INSTANCE_TO_INSTANCEGROUP") to receive updates. This argument will
only be honoured if content_type=RELATIONSHIP.See
http://cloud.google.com/asset-inventory/docs/supported-asset-types
for supported relationship types.
Exactly one of these must be specified:
--folder=FOLDER_ID
Folder of the feed.
--organization=ORGANIZATION_ID
Organization of the feed.
--project=PROJECT_ID
project of the feed.
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
--condition-description=CONDITION_DESCRIPTION
Description of the feed condition. For reference only.
--condition-expression=CONDITION_EXPRESSION
Feed condition expression. If not specified, no condition will be
applied to feed. For more information, see:
https://cloud.google.com/asset-inventory/docs/monitoring-asset-changes#feed_with_condition
--condition-title=CONDITION_TITLE
Title of the feed condition. For reference only.
--content-type=CONTENT_TYPE
Asset content type. If not specified, no content but the asset name and
type will be returned in the feed. For more information, see
https://cloud.google.com/resource-manager/docs/cloud-asset-inventory/overview#asset_content_type.
CONTENT_TYPE must be one of: resource, iam-policy, org-policy,
access-policy, os-inventory, relationship.
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 feeds create
$ gcloud beta asset feeds create