# REST Resource: feeds

- [Resource: Feed](https://docs.cloud.google.com/asset-inventory/docs/reference/rest/v1/feeds#Feed)
  - [JSON representation](https://docs.cloud.google.com/asset-inventory/docs/reference/rest/v1/feeds#Feed.SCHEMA_REPRESENTATION)
- [ContentType](https://docs.cloud.google.com/asset-inventory/docs/reference/rest/v1/feeds#ContentType)
- [FeedOutputConfig](https://docs.cloud.google.com/asset-inventory/docs/reference/rest/v1/feeds#FeedOutputConfig)
  - [JSON representation](https://docs.cloud.google.com/asset-inventory/docs/reference/rest/v1/feeds#FeedOutputConfig.SCHEMA_REPRESENTATION)
- [PubsubDestination](https://docs.cloud.google.com/asset-inventory/docs/reference/rest/v1/feeds#PubsubDestination)
  - [JSON representation](https://docs.cloud.google.com/asset-inventory/docs/reference/rest/v1/feeds#PubsubDestination.SCHEMA_REPRESENTATION)
- [Methods](https://docs.cloud.google.com/asset-inventory/docs/reference/rest/v1/feeds#METHODS_SUMMARY)

## 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 (`https://docs.cloud.google.com/asset-inventory/docs/reference/rest/v1/feeds#ContentType`), "feedOutputConfig": { object (`https://docs.cloud.google.com/asset-inventory/docs/reference/rest/v1/feeds#FeedOutputConfig`) }, "condition": { object (`https://docs.cloud.google.com/asset-inventory/docs/reference/rest/Shared.Types/Binding#Expr`) }, "relationshipTypes": [ string ] } ``` |

| 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`. For a list of the full names for supported asset types, see [Resource name format](https://docs.cloud.google.com/asset-inventory/docs/resource-name-format). |
| `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"` For a list of all supported asset types, see [Supported asset types](https://docs.cloud.google.com/asset-inventory/docs/supported-asset-types). |
| `contentType` | ``enum (`https://docs.cloud.google.com/asset-inventory/docs/reference/rest/v1/feeds#ContentType`)`` Asset content type. If not specified, no content but the asset name and type will be returned. |
| `feedOutputConfig` | ``object (`https://docs.cloud.google.com/asset-inventory/docs/reference/rest/v1/feeds#FeedOutputConfig`)`` Required. Feed output configuration defining where the asset updates are published to. |
| `condition` | ``object (`https://docs.cloud.google.com/asset-inventory/docs/reference/rest/Shared.Types/Binding#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](https://github.com/google/cel-spec) 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. See our [user guide](https://cloud.google.com/asset-inventory/docs/monitoring-asset-changes-with-condition) for detailed instructions. |
| `relationshipTypes[]` | `string` A list of relationship types to output, for example: `INSTANCE_TO_INSTANCEGROUP`. This field should only be specified if contentType=RELATIONSHIP. \* If specified: it outputs specified relationship updates on the \[assetNames\] or the \[assetTypes\]. It returns an error if any of the \[relationshipTypes\] doesn't belong to the supported relationship types of the \[assetNames\] or \[assetTypes\], or any of the \[assetNames\] or the \[assetTypes\] doesn't belong to the source types of the \[relationshipTypes\]. \* Otherwise: it outputs the supported relationships of the types of \[assetNames\] and \[assetTypes\] or returns an error if any of the \[assetNames\] or the \[assetTypes\] has no replationship support. See [Introduction to Cloud Asset Inventory](https://cloud.google.com/asset-inventory/docs/overview) for all supported asset types and relationship types. |

## 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 organization policy set on an asset. |
| `ACCESS_POLICY` | The Access Context Manager policy set on an asset. |
| `OS_INVENTORY` | The runtime OS Inventory information. |
| `RELATIONSHIP` | The related resources. |

## FeedOutputConfig

Output configuration for asset feed destination.

| JSON representation |
|---|
| ``` { // Union field `destination` can be only one of the following: "pubsubDestination": { object (`https://docs.cloud.google.com/asset-inventory/docs/reference/rest/v1/feeds#PubsubDestination`) } // End of list of possible types for union field `destination`. } ``` |

| Fields ||
|---|---|
| Union field `destination`. Asset feed destination. `destination` can be only one of the following: ||
| `pubsubDestination` | ``object (`https://docs.cloud.google.com/asset-inventory/docs/reference/rest/v1/feeds#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 ||
|---|---|
| ### `https://docs.cloud.google.com/asset-inventory/docs/reference/rest/v1/feeds/create` | Creates a feed in a parent project/folder/organization to listen to its asset updates. |
| ### `https://docs.cloud.google.com/asset-inventory/docs/reference/rest/v1/feeds/delete` | Deletes an asset feed. |
| ### `https://docs.cloud.google.com/asset-inventory/docs/reference/rest/v1/feeds/get` | Gets details about an asset feed. |
| ### `https://docs.cloud.google.com/asset-inventory/docs/reference/rest/v1/feeds/list` | Lists all asset feeds in a parent project/folder/organization. |
| ### `https://docs.cloud.google.com/asset-inventory/docs/reference/rest/v1/feeds/patch` | Updates an asset feed configuration. |