GetFeed parity mapping

Supported in:

This guide details the request and response mapping specifications and property parity analysis for migrating from the legacy Backstory Feed Management API (GetFeed) to the modern Chronicle API (GetFeed).

Protocol and mapping overview

Feature Legacy API (GetFeed) Modern Chronicle API (GetFeed)
HTTP method GET GET
Permissions Partner token or legacy API keys chronicle.googleapis.com/feeds.get

Request payload field-by-field parity

The modern Chronicle API GetFeedRequest targets resources using Google Cloud resource name paths.

Legacy field (GetFeedRequest) Modern field (GetFeedRequest) Field type Parity and migration notes
name name (in HTTP path) string Google Cloud scoping context: The legacy request used path format feeds/<id>. The modern API routes this using the standard Google Cloud resource tree structure: projects/{project}/locations/{region}/instances/{instance}/feeds/{id}.

Response payload field-by-field parity

Both the legacy Backstory Feed Management API (GetFeed) and the modern Chronicle API (GetFeed) return the retrieved Feed message representation.

Legacy field (Feed message) Modern field (Feed message) Field type Parity and migration notes
name name string Parity mapped: Contains the standard canonical resource path: projects/{project}/locations/{location}/instances/{instances}/feeds/{feed_id}.
display_name display_name string Rename to displayName in JSON responses.
details details FeedDetails Contains dynamic source-specific configuration properties.
feed_state state enum Renamed / value alignment: Renamed from feed_state to state. Note enum value changes:
• ACTIVE → ACTIVE
• INACTIVE → INACTIVE
• IN_PROGRESS → RUNNING
• COMPLETED → SUCCEEDED
• FAILED → FAILED.
uid uid string Unique UUID4 identifier for the feed.
reference_id reference_id string Reference identifier containing legacy ID references.
read_only read_only bool Rename to readOnly in JSON.
failure_msg failure_msg string Rename to failureMsg in JSON.
failure_details failure_details FeedFailureDetails Structured error details (error_code, http_error_code, error_cause, error_action). Rename to failureDetails in JSON.
last_feed_initiation_time last_feed_initiation_time Timestamp Rename to lastFeedInitiationTime in JSON.

Key differences between the Backstory and Chronicle APIs

  • Google Cloud project scoping integration:
    • Scoped natively under parent project instance folder bindings.
  • Resource path renaming:
    • Legacy path formats feeds/<id> are migrated to standard Google Cloud path parameters projects/*/locations/*/instances/*/feeds/<id>.
  • State naming and enum shifts:
    • The status enum field is renamed from feed_state to state. Ingestion progress stages changed names from IN_PROGRESS to RUNNING, and from COMPLETED to SUCCEEDED.