Method: feeds.patch

Updates an asset feed configuration.

HTTP request

PATCH https://cloudasset.googleapis.com/v1/{feed.name=*/*/feeds/*}

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
feed.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.

Request body

The request body contains data with the following structure:

JSON representation
{
  "feed": {
    "name": string,
    "assetNames": [
      string
    ],
    "assetTypes": [
      string
    ],
    "contentType": enum (ContentType),
    "feedOutputConfig": {

      // Union field destination can be only one of the following:
      "pubsubDestination": {
        object (PubsubDestination)
      }
      // End of list of possible types for union field destination.
    },
    "condition": {
      "expression": string,
      "title": string,
      "description": string,
      "location": string
    },
    "relationshipTypes": [
      string
    ]
  },
  "updateMask": string
}
Fields
feed.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.

feed.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.

feed.contentType

enum (ContentType)

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

feed.feedOutputConfig

object (FeedOutputConfig)

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

feed.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.

See our user guide for detailed instructions.

feed.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 for all supported asset types and relationship types.

updateMask

string (FieldMask format)

Required. Only updates the feed fields indicated by this mask. The field mask must not be empty, and it must not contain fields that are immutable or only set by the server.

This is a comma-separated list of fully qualified names of fields. Example: "user.displayName,photo".

Response body

If successful, the response body contains an instance of Feed.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform

For more information, see the Authentication Overview.