REST Resource: feeds

Resource: Feed

An asset feed used to export asset updates to a destinations. An asset feed filter controls what updates are exported. The asset feed must be created within a project, organization, or folder. Supported destinations are: Pub/Sub topics.

JSON representation
{
  "name": string,
  "assetNames": [
    string
  ],
  "assetTypes": [
    string
  ],
  "contentType": enum (ContentType),
  "feedOutputConfig": {
    object (FeedOutputConfig)
  },
  "condition": {
    object (Expr)
  }
}
Fields
name

string

Required. The format will be projects/{projectNumber}/feeds/{client-assigned_feed_identifier} or folders/{folder_number}/feeds/{client-assigned_feed_identifier} or organizations/{organization_number}/feeds/{client-assigned_feed_identifier}

The client-assigned feed identifier must be unique within the parent project/folder/organization.

assetNames[]

string

A list of the full names of the assets to receive updates. You must specify either or both of assetNames and assetTypes. Only asset updates matching specified assetNames or assetTypes are exported to the feed. Example: //compute.googleapis.com/projects/my_project_123/zones/zone1/instances/instance1. See Resource Names for more info.

assetTypes[]

string

A list of types of the assets to receive updates. You must specify either or both of assetNames and assetTypes. Only asset updates matching specified assetNames or assetTypes are exported to the feed. Example: "compute.googleapis.com/Disk"

See this topic for a list of all supported asset types.

contentType

enum (ContentType)

Asset content type. If not specified, no content but the asset name and type will be returned.

feedOutputConfig

object (FeedOutputConfig)

Required. Feed output configuration defining where the asset updates are published to.

condition

object (Expr)

A condition which determines whether an asset update should be published. If specified, an asset will be returned only when the expression evaluates to true. When set, expression field in the Expr must be a valid CEL expression on a TemporalAsset with name temporal_asset. Example: a Feed with expression ("temporal_asset.deleted == true") will only publish Asset deletions. Other fields of Expr are optional.

ContentType

Asset content type.

Enums
CONTENT_TYPE_UNSPECIFIED Unspecified content type.
RESOURCE Resource metadata.
IAM_POLICY The actual IAM policy set on a resource.
ORG_POLICY The Cloud Organization Policy set on an asset.
ACCESS_POLICY The Cloud Access context mananger Policy set on an asset.

FeedOutputConfig

Output configuration for asset feed destination.

JSON representation
{
  "pubsubDestination": {
    object (PubsubDestination)
  }
}
Fields
pubsubDestination

object (PubsubDestination)

Destination on Pub/Sub.

PubsubDestination

A Pub/Sub destination.

JSON representation
{
  "topic": string
}
Fields
topic

string

The name of the Pub/Sub topic to publish to. Example: projects/PROJECT_ID/topics/TOPIC_ID.

Methods

create

Creates a feed in a parent project/folder/organization to listen to its asset updates.

delete

Deletes an asset feed.

get

Gets details about an asset feed.

list

Lists all asset feeds in a parent project/folder/organization.

patch

Updates an asset feed configuration.