Welcome to Pulumi Registry, your window into the cloud. Read the announcement.

Google Native

v0.9.0 published on Wednesday, Nov 24, 2021 by Pulumi

Trigger

Create a new trigger in a particular project and location.

Create a Trigger Resource

new Trigger(name: string, args: TriggerArgs, opts?: CustomResourceOptions);
@overload
def Trigger(resource_name: str,
            opts: Optional[ResourceOptions] = None,
            destination: Optional[DestinationArgs] = None,
            event_filters: Optional[Sequence[EventFilterArgs]] = None,
            labels: Optional[Mapping[str, str]] = None,
            location: Optional[str] = None,
            name: Optional[str] = None,
            project: Optional[str] = None,
            service_account: Optional[str] = None,
            transport: Optional[TransportArgs] = None,
            trigger_id: Optional[str] = None,
            validate_only: Optional[str] = None)
@overload
def Trigger(resource_name: str,
            args: TriggerArgs,
            opts: Optional[ResourceOptions] = None)
func NewTrigger(ctx *Context, name string, args TriggerArgs, opts ...ResourceOption) (*Trigger, error)
public Trigger(string name, TriggerArgs args, CustomResourceOptions? opts = null)
name string
The unique name of the resource.
args TriggerArgs
The arguments to resource properties.
opts CustomResourceOptions
Bag of options to control resource's behavior.
resource_name str
The unique name of the resource.
args TriggerArgs
The arguments to resource properties.
opts ResourceOptions
Bag of options to control resource's behavior.
ctx Context
Context object for the current deployment.
name string
The unique name of the resource.
args TriggerArgs
The arguments to resource properties.
opts ResourceOption
Bag of options to control resource's behavior.
name string
The unique name of the resource.
args TriggerArgs
The arguments to resource properties.
opts CustomResourceOptions
Bag of options to control resource's behavior.

Trigger Resource Properties

To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

Inputs

The Trigger resource accepts the following input properties:

Destination Pulumi.GoogleNative.Eventarc.V1.Inputs.DestinationArgs
Destination specifies where the events should be sent to.
EventFilters List<Pulumi.GoogleNative.Eventarc.V1.Inputs.EventFilterArgs>
null The list of filters that applies to event attributes. Only events that match all the provided filters will be sent to the destination.
TriggerId string
ValidateOnly string
Labels Dictionary<string, string>
Optional. User labels attached to the triggers that can be used to group resources.
Location string
Name string
The resource name of the trigger. Must be unique within the location on the project and must be in projects/{project}/locations/{location}/triggers/{trigger} format.
Project string
ServiceAccount string
Optional. The IAM service account email associated with the trigger. The service account represents the identity of the trigger. The principal who calls this API must have iam.serviceAccounts.actAs permission in the service account. See https://cloud.google.com/iam/docs/understanding-service-accounts?hl=en#sa_common for more information. For Cloud Run destinations, this service account is used to generate identity tokens when invoking the service. See https://cloud.google.com/run/docs/triggering/pubsub-push#create-service-account for information on how to invoke authenticated Cloud Run services. In order to create Audit Log triggers, the service account should also have roles/eventarc.eventReceiver IAM role.
Transport Pulumi.GoogleNative.Eventarc.V1.Inputs.TransportArgs
Optional. In order to deliver messages, Eventarc may use other GCP products as transport intermediary. This field contains a reference to that transport intermediary. This information can be used for debugging purposes.
Destination DestinationArgs
Destination specifies where the events should be sent to.
EventFilters []EventFilterArgs
null The list of filters that applies to event attributes. Only events that match all the provided filters will be sent to the destination.
TriggerId string
ValidateOnly string
Labels map[string]string
Optional. User labels attached to the triggers that can be used to group resources.
Location string
Name string
The resource name of the trigger. Must be unique within the location on the project and must be in projects/{project}/locations/{location}/triggers/{trigger} format.
Project string
ServiceAccount string
Optional. The IAM service account email associated with the trigger. The service account represents the identity of the trigger. The principal who calls this API must have iam.serviceAccounts.actAs permission in the service account. See https://cloud.google.com/iam/docs/understanding-service-accounts?hl=en#sa_common for more information. For Cloud Run destinations, this service account is used to generate identity tokens when invoking the service. See https://cloud.google.com/run/docs/triggering/pubsub-push#create-service-account for information on how to invoke authenticated Cloud Run services. In order to create Audit Log triggers, the service account should also have roles/eventarc.eventReceiver IAM role.
Transport TransportArgs
Optional. In order to deliver messages, Eventarc may use other GCP products as transport intermediary. This field contains a reference to that transport intermediary. This information can be used for debugging purposes.
destination DestinationArgs
Destination specifies where the events should be sent to.
eventFilters EventFilterArgs[]
null The list of filters that applies to event attributes. Only events that match all the provided filters will be sent to the destination.
triggerId string
validateOnly string
labels {[key: string]: string}
Optional. User labels attached to the triggers that can be used to group resources.
location string
name string
The resource name of the trigger. Must be unique within the location on the project and must be in projects/{project}/locations/{location}/triggers/{trigger} format.
project string
serviceAccount string
Optional. The IAM service account email associated with the trigger. The service account represents the identity of the trigger. The principal who calls this API must have iam.serviceAccounts.actAs permission in the service account. See https://cloud.google.com/iam/docs/understanding-service-accounts?hl=en#sa_common for more information. For Cloud Run destinations, this service account is used to generate identity tokens when invoking the service. See https://cloud.google.com/run/docs/triggering/pubsub-push#create-service-account for information on how to invoke authenticated Cloud Run services. In order to create Audit Log triggers, the service account should also have roles/eventarc.eventReceiver IAM role.
transport TransportArgs
Optional. In order to deliver messages, Eventarc may use other GCP products as transport intermediary. This field contains a reference to that transport intermediary. This information can be used for debugging purposes.
destination DestinationArgs
Destination specifies where the events should be sent to.
event_filters Sequence[EventFilterArgs]
null The list of filters that applies to event attributes. Only events that match all the provided filters will be sent to the destination.
trigger_id str
validate_only str
labels Mapping[str, str]
Optional. User labels attached to the triggers that can be used to group resources.
location str
name str
The resource name of the trigger. Must be unique within the location on the project and must be in projects/{project}/locations/{location}/triggers/{trigger} format.
project str
service_account str
Optional. The IAM service account email associated with the trigger. The service account represents the identity of the trigger. The principal who calls this API must have iam.serviceAccounts.actAs permission in the service account. See https://cloud.google.com/iam/docs/understanding-service-accounts?hl=en#sa_common for more information. For Cloud Run destinations, this service account is used to generate identity tokens when invoking the service. See https://cloud.google.com/run/docs/triggering/pubsub-push#create-service-account for information on how to invoke authenticated Cloud Run services. In order to create Audit Log triggers, the service account should also have roles/eventarc.eventReceiver IAM role.
transport TransportArgs
Optional. In order to deliver messages, Eventarc may use other GCP products as transport intermediary. This field contains a reference to that transport intermediary. This information can be used for debugging purposes.

Outputs

All input properties are implicitly available as output properties. Additionally, the Trigger resource produces the following output properties:

CreateTime string
The creation time.
Etag string
This checksum is computed by the server based on the value of other fields, and may be sent only on create requests to ensure the client has an up-to-date value before proceeding.
Id string
The provider-assigned unique ID for this managed resource.
Uid string
Server assigned unique identifier for the trigger. The value is a UUID4 string and guaranteed to remain unchanged until the resource is deleted.
UpdateTime string
The last-modified time.
CreateTime string
The creation time.
Etag string
This checksum is computed by the server based on the value of other fields, and may be sent only on create requests to ensure the client has an up-to-date value before proceeding.
Id string
The provider-assigned unique ID for this managed resource.
Uid string
Server assigned unique identifier for the trigger. The value is a UUID4 string and guaranteed to remain unchanged until the resource is deleted.
UpdateTime string
The last-modified time.
createTime string
The creation time.
etag string
This checksum is computed by the server based on the value of other fields, and may be sent only on create requests to ensure the client has an up-to-date value before proceeding.
id string
The provider-assigned unique ID for this managed resource.
uid string
Server assigned unique identifier for the trigger. The value is a UUID4 string and guaranteed to remain unchanged until the resource is deleted.
updateTime string
The last-modified time.
create_time str
The creation time.
etag str
This checksum is computed by the server based on the value of other fields, and may be sent only on create requests to ensure the client has an up-to-date value before proceeding.
id str
The provider-assigned unique ID for this managed resource.
uid str
Server assigned unique identifier for the trigger. The value is a UUID4 string and guaranteed to remain unchanged until the resource is deleted.
update_time str
The last-modified time.

Supporting Types

CloudRun

Region string
The region the Cloud Run service is deployed in.
Service string
The name of the Cloud Run service being addressed. See https://cloud.google.com/run/docs/reference/rest/v1/namespaces.services. Only services located in the same project of the trigger object can be addressed.
Path string
Optional. The relative path on the Cloud Run service the events should be sent to. The value must conform to the definition of URI path segment (section 3.3 of RFC2396). Examples: “/route”, “route”, “route/subroute”.
Region string
The region the Cloud Run service is deployed in.
Service string
The name of the Cloud Run service being addressed. See https://cloud.google.com/run/docs/reference/rest/v1/namespaces.services. Only services located in the same project of the trigger object can be addressed.
Path string
Optional. The relative path on the Cloud Run service the events should be sent to. The value must conform to the definition of URI path segment (section 3.3 of RFC2396). Examples: “/route”, “route”, “route/subroute”.
region string
The region the Cloud Run service is deployed in.
service string
The name of the Cloud Run service being addressed. See https://cloud.google.com/run/docs/reference/rest/v1/namespaces.services. Only services located in the same project of the trigger object can be addressed.
path string
Optional. The relative path on the Cloud Run service the events should be sent to. The value must conform to the definition of URI path segment (section 3.3 of RFC2396). Examples: “/route”, “route”, “route/subroute”.
region str
The region the Cloud Run service is deployed in.
service str
The name of the Cloud Run service being addressed. See https://cloud.google.com/run/docs/reference/rest/v1/namespaces.services. Only services located in the same project of the trigger object can be addressed.
path str
Optional. The relative path on the Cloud Run service the events should be sent to. The value must conform to the definition of URI path segment (section 3.3 of RFC2396). Examples: “/route”, “route”, “route/subroute”.

CloudRunResponse

Path string
Optional. The relative path on the Cloud Run service the events should be sent to. The value must conform to the definition of URI path segment (section 3.3 of RFC2396). Examples: “/route”, “route”, “route/subroute”.
Region string
The region the Cloud Run service is deployed in.
Service string
The name of the Cloud Run service being addressed. See https://cloud.google.com/run/docs/reference/rest/v1/namespaces.services. Only services located in the same project of the trigger object can be addressed.
Path string
Optional. The relative path on the Cloud Run service the events should be sent to. The value must conform to the definition of URI path segment (section 3.3 of RFC2396). Examples: “/route”, “route”, “route/subroute”.
Region string
The region the Cloud Run service is deployed in.
Service string
The name of the Cloud Run service being addressed. See https://cloud.google.com/run/docs/reference/rest/v1/namespaces.services. Only services located in the same project of the trigger object can be addressed.
path string
Optional. The relative path on the Cloud Run service the events should be sent to. The value must conform to the definition of URI path segment (section 3.3 of RFC2396). Examples: “/route”, “route”, “route/subroute”.
region string
The region the Cloud Run service is deployed in.
service string
The name of the Cloud Run service being addressed. See https://cloud.google.com/run/docs/reference/rest/v1/namespaces.services. Only services located in the same project of the trigger object can be addressed.
path str
Optional. The relative path on the Cloud Run service the events should be sent to. The value must conform to the definition of URI path segment (section 3.3 of RFC2396). Examples: “/route”, “route”, “route/subroute”.
region str
The region the Cloud Run service is deployed in.
service str
The name of the Cloud Run service being addressed. See https://cloud.google.com/run/docs/reference/rest/v1/namespaces.services. Only services located in the same project of the trigger object can be addressed.

Destination

CloudRun Pulumi.GoogleNative.Eventarc.V1.Inputs.CloudRun
Cloud Run fully-managed service that receives the events. The service should be running in the same project of the trigger.
Gke Pulumi.GoogleNative.Eventarc.V1.Inputs.GKE
A GKE service capable of receiving events. The service should be running in the same project of the trigger.
CloudRun CloudRun
Cloud Run fully-managed service that receives the events. The service should be running in the same project of the trigger.
Gke GKE
A GKE service capable of receiving events. The service should be running in the same project of the trigger.
cloudRun CloudRun
Cloud Run fully-managed service that receives the events. The service should be running in the same project of the trigger.
gke GKE
A GKE service capable of receiving events. The service should be running in the same project of the trigger.
cloud_run CloudRun
Cloud Run fully-managed service that receives the events. The service should be running in the same project of the trigger.
gke GKE
A GKE service capable of receiving events. The service should be running in the same project of the trigger.

DestinationResponse

CloudRun Pulumi.GoogleNative.Eventarc.V1.Inputs.CloudRunResponse
Cloud Run fully-managed service that receives the events. The service should be running in the same project of the trigger.
Gke Pulumi.GoogleNative.Eventarc.V1.Inputs.GKEResponse
A GKE service capable of receiving events. The service should be running in the same project of the trigger.
CloudRun CloudRunResponse
Cloud Run fully-managed service that receives the events. The service should be running in the same project of the trigger.
Gke GKEResponse
A GKE service capable of receiving events. The service should be running in the same project of the trigger.
cloudRun CloudRunResponse
Cloud Run fully-managed service that receives the events. The service should be running in the same project of the trigger.
gke GKEResponse
A GKE service capable of receiving events. The service should be running in the same project of the trigger.
cloud_run CloudRunResponse
Cloud Run fully-managed service that receives the events. The service should be running in the same project of the trigger.
gke GKEResponse
A GKE service capable of receiving events. The service should be running in the same project of the trigger.

EventFilter

Attribute string
The name of a CloudEvents attribute. Currently, only a subset of attributes are supported for filtering. All triggers MUST provide a filter for the ‘type’ attribute.
Value string
The value for the attribute.
Attribute string
The name of a CloudEvents attribute. Currently, only a subset of attributes are supported for filtering. All triggers MUST provide a filter for the ‘type’ attribute.
Value string
The value for the attribute.
attribute string
The name of a CloudEvents attribute. Currently, only a subset of attributes are supported for filtering. All triggers MUST provide a filter for the ‘type’ attribute.
value string
The value for the attribute.
attribute str
The name of a CloudEvents attribute. Currently, only a subset of attributes are supported for filtering. All triggers MUST provide a filter for the ‘type’ attribute.
value str
The value for the attribute.

EventFilterResponse

Attribute string
The name of a CloudEvents attribute. Currently, only a subset of attributes are supported for filtering. All triggers MUST provide a filter for the ‘type’ attribute.
Value string
The value for the attribute.
Attribute string
The name of a CloudEvents attribute. Currently, only a subset of attributes are supported for filtering. All triggers MUST provide a filter for the ‘type’ attribute.
Value string
The value for the attribute.
attribute string
The name of a CloudEvents attribute. Currently, only a subset of attributes are supported for filtering. All triggers MUST provide a filter for the ‘type’ attribute.
value string
The value for the attribute.
attribute str
The name of a CloudEvents attribute. Currently, only a subset of attributes are supported for filtering. All triggers MUST provide a filter for the ‘type’ attribute.
value str
The value for the attribute.

GKE

Cluster string
The name of the cluster the GKE service is running in. The cluster must be running in the same project as the trigger being created.
Location string
The name of the Google Compute Engine in which the cluster resides, which can either be compute zone (e.g. us-central1-a) for the zonal clusters or region (e.g. us-central1) for regional clusters.
Namespace string
The namespace the GKE service is running in.
Service string
Name of the GKE service.
Path string
Optional. The relative path on the GKE service the events should be sent to. The value must conform to the definition of URI path segment (section 3.3 of RFC2396). Examples: “/route”, “route”, “route/subroute”.
Cluster string
The name of the cluster the GKE service is running in. The cluster must be running in the same project as the trigger being created.
Location string
The name of the Google Compute Engine in which the cluster resides, which can either be compute zone (e.g. us-central1-a) for the zonal clusters or region (e.g. us-central1) for regional clusters.
Namespace string
The namespace the GKE service is running in.
Service string
Name of the GKE service.
Path string
Optional. The relative path on the GKE service the events should be sent to. The value must conform to the definition of URI path segment (section 3.3 of RFC2396). Examples: “/route”, “route”, “route/subroute”.
cluster string
The name of the cluster the GKE service is running in. The cluster must be running in the same project as the trigger being created.
location string
The name of the Google Compute Engine in which the cluster resides, which can either be compute zone (e.g. us-central1-a) for the zonal clusters or region (e.g. us-central1) for regional clusters.
namespace string
The namespace the GKE service is running in.
service string
Name of the GKE service.
path string
Optional. The relative path on the GKE service the events should be sent to. The value must conform to the definition of URI path segment (section 3.3 of RFC2396). Examples: “/route”, “route”, “route/subroute”.
cluster str
The name of the cluster the GKE service is running in. The cluster must be running in the same project as the trigger being created.
location str
The name of the Google Compute Engine in which the cluster resides, which can either be compute zone (e.g. us-central1-a) for the zonal clusters or region (e.g. us-central1) for regional clusters.
namespace str
The namespace the GKE service is running in.
service str
Name of the GKE service.
path str
Optional. The relative path on the GKE service the events should be sent to. The value must conform to the definition of URI path segment (section 3.3 of RFC2396). Examples: “/route”, “route”, “route/subroute”.

GKEResponse

Cluster string
The name of the cluster the GKE service is running in. The cluster must be running in the same project as the trigger being created.
Location string
The name of the Google Compute Engine in which the cluster resides, which can either be compute zone (e.g. us-central1-a) for the zonal clusters or region (e.g. us-central1) for regional clusters.
Namespace string
The namespace the GKE service is running in.
Path string
Optional. The relative path on the GKE service the events should be sent to. The value must conform to the definition of URI path segment (section 3.3 of RFC2396). Examples: “/route”, “route”, “route/subroute”.
Service string
Name of the GKE service.
Cluster string
The name of the cluster the GKE service is running in. The cluster must be running in the same project as the trigger being created.
Location string
The name of the Google Compute Engine in which the cluster resides, which can either be compute zone (e.g. us-central1-a) for the zonal clusters or region (e.g. us-central1) for regional clusters.
Namespace string
The namespace the GKE service is running in.
Path string
Optional. The relative path on the GKE service the events should be sent to. The value must conform to the definition of URI path segment (section 3.3 of RFC2396). Examples: “/route”, “route”, “route/subroute”.
Service string
Name of the GKE service.
cluster string
The name of the cluster the GKE service is running in. The cluster must be running in the same project as the trigger being created.
location string
The name of the Google Compute Engine in which the cluster resides, which can either be compute zone (e.g. us-central1-a) for the zonal clusters or region (e.g. us-central1) for regional clusters.
namespace string
The namespace the GKE service is running in.
path string
Optional. The relative path on the GKE service the events should be sent to. The value must conform to the definition of URI path segment (section 3.3 of RFC2396). Examples: “/route”, “route”, “route/subroute”.
service string
Name of the GKE service.
cluster str
The name of the cluster the GKE service is running in. The cluster must be running in the same project as the trigger being created.
location str
The name of the Google Compute Engine in which the cluster resides, which can either be compute zone (e.g. us-central1-a) for the zonal clusters or region (e.g. us-central1) for regional clusters.
namespace str
The namespace the GKE service is running in.
path str
Optional. The relative path on the GKE service the events should be sent to. The value must conform to the definition of URI path segment (section 3.3 of RFC2396). Examples: “/route”, “route”, “route/subroute”.
service str
Name of the GKE service.

Pubsub

Topic string
Optional. The name of the Pub/Sub topic created and managed by Eventarc system as a transport for the event delivery. Format: projects/{PROJECT_ID}/topics/{TOPIC_NAME}. You may set an existing topic for triggers of the type google.cloud.pubsub.topic.v1.messagePublished only. The topic you provide here will not be deleted by Eventarc at trigger deletion.
Topic string
Optional. The name of the Pub/Sub topic created and managed by Eventarc system as a transport for the event delivery. Format: projects/{PROJECT_ID}/topics/{TOPIC_NAME}. You may set an existing topic for triggers of the type google.cloud.pubsub.topic.v1.messagePublished only. The topic you provide here will not be deleted by Eventarc at trigger deletion.
topic string
Optional. The name of the Pub/Sub topic created and managed by Eventarc system as a transport for the event delivery. Format: projects/{PROJECT_ID}/topics/{TOPIC_NAME}. You may set an existing topic for triggers of the type google.cloud.pubsub.topic.v1.messagePublished only. The topic you provide here will not be deleted by Eventarc at trigger deletion.
topic str
Optional. The name of the Pub/Sub topic created and managed by Eventarc system as a transport for the event delivery. Format: projects/{PROJECT_ID}/topics/{TOPIC_NAME}. You may set an existing topic for triggers of the type google.cloud.pubsub.topic.v1.messagePublished only. The topic you provide here will not be deleted by Eventarc at trigger deletion.

PubsubResponse

Subscription string
The name of the Pub/Sub subscription created and managed by Eventarc system as a transport for the event delivery. Format: projects/{PROJECT_ID}/subscriptions/{SUBSCRIPTION_NAME}.
Topic string
Optional. The name of the Pub/Sub topic created and managed by Eventarc system as a transport for the event delivery. Format: projects/{PROJECT_ID}/topics/{TOPIC_NAME}. You may set an existing topic for triggers of the type google.cloud.pubsub.topic.v1.messagePublished only. The topic you provide here will not be deleted by Eventarc at trigger deletion.
Subscription string
The name of the Pub/Sub subscription created and managed by Eventarc system as a transport for the event delivery. Format: projects/{PROJECT_ID}/subscriptions/{SUBSCRIPTION_NAME}.
Topic string
Optional. The name of the Pub/Sub topic created and managed by Eventarc system as a transport for the event delivery. Format: projects/{PROJECT_ID}/topics/{TOPIC_NAME}. You may set an existing topic for triggers of the type google.cloud.pubsub.topic.v1.messagePublished only. The topic you provide here will not be deleted by Eventarc at trigger deletion.
subscription string
The name of the Pub/Sub subscription created and managed by Eventarc system as a transport for the event delivery. Format: projects/{PROJECT_ID}/subscriptions/{SUBSCRIPTION_NAME}.
topic string
Optional. The name of the Pub/Sub topic created and managed by Eventarc system as a transport for the event delivery. Format: projects/{PROJECT_ID}/topics/{TOPIC_NAME}. You may set an existing topic for triggers of the type google.cloud.pubsub.topic.v1.messagePublished only. The topic you provide here will not be deleted by Eventarc at trigger deletion.
subscription str
The name of the Pub/Sub subscription created and managed by Eventarc system as a transport for the event delivery. Format: projects/{PROJECT_ID}/subscriptions/{SUBSCRIPTION_NAME}.
topic str
Optional. The name of the Pub/Sub topic created and managed by Eventarc system as a transport for the event delivery. Format: projects/{PROJECT_ID}/topics/{TOPIC_NAME}. You may set an existing topic for triggers of the type google.cloud.pubsub.topic.v1.messagePublished only. The topic you provide here will not be deleted by Eventarc at trigger deletion.

Transport

Pubsub Pulumi.GoogleNative.Eventarc.V1.Inputs.Pubsub
The Pub/Sub topic and subscription used by Eventarc as delivery intermediary.
Pubsub Pubsub
The Pub/Sub topic and subscription used by Eventarc as delivery intermediary.
pubsub Pubsub
The Pub/Sub topic and subscription used by Eventarc as delivery intermediary.
pubsub Pubsub
The Pub/Sub topic and subscription used by Eventarc as delivery intermediary.

TransportResponse

Pubsub Pulumi.GoogleNative.Eventarc.V1.Inputs.PubsubResponse
The Pub/Sub topic and subscription used by Eventarc as delivery intermediary.
Pubsub PubsubResponse
The Pub/Sub topic and subscription used by Eventarc as delivery intermediary.
pubsub PubsubResponse
The Pub/Sub topic and subscription used by Eventarc as delivery intermediary.
pubsub PubsubResponse
The Pub/Sub topic and subscription used by Eventarc as delivery intermediary.

Package Details

Repository
https://github.com/pulumi/pulumi-google-native
License
Apache-2.0