REST Resource: projects.locations.connections.eventSubscriptions

Resource: EventSubscription

represents the Connector's EventSubscription resource

JSON representation
{
  "name": string,
  "createTime": string,
  "updateTime": string,
  "eventTypeId": string,
  "subscriber": string,
  "subscriberLink": string,
  "status": {
    object (EventSubscriptionStatus)
  },
  "destinations": {
    object (EventSubscriptionDestination)
  },

  // Union field source can be only one of the following:
  "jms": {
    object (JMS)
  }
  // End of list of possible types for union field source.
}
Fields
name

string

Required. Resource name of the EventSubscription. Format: projects/{project}/locations/{location}/connections/{connection}/eventSubscriptions/{eventSubscription}

createTime

string (Timestamp format)

Output only. Created time.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".

updateTime

string (Timestamp format)

Output only. Updated time.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".

eventTypeId

string

Optional. Event type id of the event of current EventSubscription.

subscriber

string

Optional. name of the Subscriber for the current EventSubscription.

status

object (EventSubscriptionStatus)

Optional. Status indicates the status of the event subscription resource

destinations

object (EventSubscriptionDestination)

Optional. The destination to hit when we receive an event

Union field source. The source of the event source can be only one of the following:
jms

object (JMS)

Optional. JMS is the source for the event listener.

EventSubscriptionStatus

EventSubscription Status denotes the status of the EventSubscription resource.

JSON representation
{
  "state": enum (State),
  "description": string
}
Fields
state

enum (State)

Output only. State of Event Subscription resource.

description

string

Output only. Description of the state.

State

All the possible EventSubscription statuses.

Enums
STATE_UNSPECIFIED Default state.
CREATING EventSubscription creation is in progress.
UPDATING EventSubscription is in Updating status.
ACTIVE EventSubscription is in Active state and is ready to receive events.
SUSPENDED EventSubscription is currently suspended.
ERROR EventSubscription is in Error state.

EventSubscriptionDestination

Message for EventSubscription Destination to act on receiving an event

JSON representation
{
  "type": enum (Type),
  "serviceAccount": string,

  // Union field destination can be only one of the following:
  "endpoint": {
    object (EndPoint)
  }
  // End of list of possible types for union field destination.
}
Fields
type

enum (Type)

type of the destination

serviceAccount

string

Service account needed for runtime plane to trigger IP workflow.

Union field destination.

destination can be only one of the following:

endpoint

object (EndPoint)

OPTION 1: Hit an endpoint when we receive an event.

Type

Types of the Destination in EventSubscription

Enums
TYPE_UNSPECIFIED Default state.
ENDPOINT Endpoint - Hit the value of endpoint when event is received

EndPoint

Endpoint message includes details of the Destination endpoint.

JSON representation
{
  "endpointUri": string,
  "headers": [
    {
      object (Header)
    }
  ]
}
Fields
endpointUri

string

The URI of the Endpoint.

headers[]

object (Header)

List of Header to be added to the Endpoint.

JMS

JMS message denotes the source of the event

JSON representation
{
  "type": enum (Type),
  "name": string
}
Fields
type

enum (Type)

Optional. Type of the JMS Source. i.e. Queue or Topic

name

string

Optional. Name of the JMS source. i.e. queueName or topicName

Type

Type of the JMS Source. i.e. Queue or Topic

Enums
TYPE_UNSPECIFIED Default state.
QUEUE JMS Queue.
TOPIC JMS Topic.

Methods

create

Creates a new EventSubscription in a given project,location and connection.

delete

Deletes a single EventSubscription.

get

Gets details of a single EventSubscription.

list

List EventSubscriptions in a given project,location and connection.

patch

Updates the parameters of a single EventSubscription.

retry

RetryEventSubscription retries the registration of Subscription.