pulumi-gcp 8.20.0a1739946722__py3-none-any.whl → 8.21.0a1740551699__py3-none-any.whl

pulumi_gcp/eventarc/outputs.py

@@ -59,11 +59,16 @@ class TriggerDestination(dict):
                  network_config: Optional['outputs.TriggerDestinationNetworkConfig'] = None,
                  workflow: Optional[str] = None):
         """
-        :param str cloud_function: The Cloud Function resource name. Only Cloud Functions V2 is supported. Format projects/{project}/locations/{location}/functions/{function} This is a read-only field. [WARNING] Creating Cloud Functions V2 triggers is only supported via the Cloud Functions product. An error will be returned if the user sets this value.
+        :param str cloud_function: (Output)
+               The Cloud Function resource name. Only Cloud Functions V2 is supported. Format projects/{project}/locations/{location}/functions/{function} This is a read-only field. [WARNING] Creating Cloud Functions V2 triggers is only supported via the Cloud Functions product. An error will be returned if the user sets this value.
         :param 'TriggerDestinationCloudRunServiceArgs' cloud_run_service: Cloud Run fully-managed service that receives the events. The service should be running in the same project of the trigger.
+               Structure is documented below.
         :param 'TriggerDestinationGkeArgs' gke: A GKE service capable of receiving events. The service should be running in the same project as the trigger.
+               Structure is documented below.
         :param 'TriggerDestinationHttpEndpointArgs' http_endpoint: An HTTP endpoint destination described by an URI.
+               Structure is documented below.
         :param 'TriggerDestinationNetworkConfigArgs' network_config: Optional. Network config is used to configure how Eventarc resolves and connect to a destination. This should only be used with HttpEndpoint destination type.
+               Structure is documented below.
         :param str workflow: The resource name of the Workflow whose Executions are triggered by the events. The Workflow resource should be deployed in the same project as the trigger. Format: `projects/{project}/locations/{location}/workflows/{workflow}`
         """
         if cloud_function is not None:
@@ -83,6 +88,7 @@ class TriggerDestination(dict):
     @pulumi.getter(name="cloudFunction")
     def cloud_function(self) -> Optional[str]:
         """
+        (Output)
         The Cloud Function resource name. Only Cloud Functions V2 is supported. Format projects/{project}/locations/{location}/functions/{function} This is a read-only field. [WARNING] Creating Cloud Functions V2 triggers is only supported via the Cloud Functions product. An error will be returned if the user sets this value.
         """
         return pulumi.get(self, "cloud_function")
@@ -92,6 +98,7 @@ class TriggerDestination(dict):
     def cloud_run_service(self) -> Optional['outputs.TriggerDestinationCloudRunService']:
         """
         Cloud Run fully-managed service that receives the events. The service should be running in the same project of the trigger.
+        Structure is documented below.
         """
         return pulumi.get(self, "cloud_run_service")
 
@@ -100,6 +107,7 @@ class TriggerDestination(dict):
     def gke(self) -> Optional['outputs.TriggerDestinationGke']:
         """
         A GKE service capable of receiving events. The service should be running in the same project as the trigger.
+        Structure is documented below.
         """
         return pulumi.get(self, "gke")
 
@@ -108,6 +116,7 @@ class TriggerDestination(dict):
     def http_endpoint(self) -> Optional['outputs.TriggerDestinationHttpEndpoint']:
         """
         An HTTP endpoint destination described by an URI.
+        Structure is documented below.
         """
         return pulumi.get(self, "http_endpoint")
 
@@ -116,6 +125,7 @@ class TriggerDestination(dict):
     def network_config(self) -> Optional['outputs.TriggerDestinationNetworkConfig']:
         """
         Optional. Network config is used to configure how Eventarc resolves and connect to a destination. This should only be used with HttpEndpoint destination type.
+        Structure is documented below.
         """
         return pulumi.get(self, "network_config")
 
@@ -274,6 +284,8 @@ class TriggerDestinationNetworkConfig(dict):
                  network_attachment: str):
         """
         :param str network_attachment: Required. Name of the NetworkAttachment that allows access to the destination VPC. Format: `projects/{PROJECT_ID}/regions/{REGION}/networkAttachments/{NETWORK_ATTACHMENT_NAME}`
+               
+               - - -
         """
         pulumi.set(__self__, "network_attachment", network_attachment)
 
@@ -282,6 +294,8 @@ class TriggerDestinationNetworkConfig(dict):
     def network_attachment(self) -> str:
         """
         Required. Name of the NetworkAttachment that allows access to the destination VPC. Format: `projects/{PROJECT_ID}/regions/{REGION}/networkAttachments/{NETWORK_ATTACHMENT_NAME}`
+
+        - - -
         """
         return pulumi.get(self, "network_attachment")
 
@@ -295,8 +309,6 @@ class TriggerMatchingCriteria(dict):
         """
         :param str attribute: Required. 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.
         :param str value: Required. The value for the attribute. See https://cloud.google.com/eventarc/docs/creating-triggers#trigger-gcloud for available values.
-               
-               - - -
         :param str operator: Optional. The operator used for matching the events with the value of the filter. If not specified, only events that have an exact key-value pair specified in the filter are matched. The only allowed value is `match-path-pattern`.
         """
         pulumi.set(__self__, "attribute", attribute)
@@ -317,8 +329,6 @@ class TriggerMatchingCriteria(dict):
     def value(self) -> str:
         """
         Required. The value for the attribute. See https://cloud.google.com/eventarc/docs/creating-triggers#trigger-gcloud for available values.
-
-        - - -
         """
         return pulumi.get(self, "value")
 
@@ -337,6 +347,7 @@ class TriggerTransport(dict):
                  pubsub: Optional['outputs.TriggerTransportPubsub'] = None):
         """
         :param 'TriggerTransportPubsubArgs' pubsub: The Pub/Sub topic and subscription used by Eventarc as delivery intermediary.
+               Structure is documented below.
         """
         if pubsub is not None:
             pulumi.set(__self__, "pubsub", pubsub)
@@ -346,6 +357,7 @@ class TriggerTransport(dict):
     def pubsub(self) -> Optional['outputs.TriggerTransportPubsub']:
         """
         The Pub/Sub topic and subscription used by Eventarc as delivery intermediary.
+        Structure is documented below.
         """
         return pulumi.get(self, "pubsub")
 
@@ -356,7 +368,8 @@ class TriggerTransportPubsub(dict):
                  subscription: Optional[str] = None,
                  topic: Optional[str] = None):
         """
-        :param str subscription: Output only. 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}`.
+        :param str subscription: (Output)
+               Output only. 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}`.
         :param str topic: 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.
         """
         if subscription is not None:
@@ -368,6 +381,7 @@ class TriggerTransportPubsub(dict):
     @pulumi.getter
     def subscription(self) -> Optional[str]:
         """
+        (Output)
         Output only. 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}`.
         """
         return pulumi.get(self, "subscription")

pulumi_gcp/eventarc/trigger.py

@@ -34,25 +34,26 @@ class TriggerArgs:
         """
         The set of arguments for constructing a Trigger resource.
         :param pulumi.Input['TriggerDestinationArgs'] destination: Required. Destination specifies where the events should be sent to.
+               Structure is documented below.
         :param pulumi.Input[str] location: The location for the resource
         :param pulumi.Input[Sequence[pulumi.Input['TriggerMatchingCriteriaArgs']]] matching_criterias: Required. null The list of filters that applies to event attributes. Only events that match all the provided filters will be sent to the destination.
+               Structure is documented below.
         :param pulumi.Input[str] channel: Optional. The name of the channel associated with the trigger in
-               `projects/{project}/locations/{location}/channels/{channel}` format. You must provide a channel to receive events from
+               'projects/{project}/locations/{location}/channels/{channel}' format. You must provide a channel to receive events from
                Eventarc SaaS partners.
         :param pulumi.Input[str] event_data_content_type: Optional. EventDataContentType specifies the type of payload in MIME format that is expected from the CloudEvent data
-               field. This is set to `application/json` if the value is not defined.
+               field. This is set to 'application/json' if the value is not defined.
         :param pulumi.Input[Mapping[str, pulumi.Input[str]]] labels: Optional. User labels attached to the triggers that can be used to group resources. **Note**: This field is
                non-authoritative, and will only manage the labels present in your configuration. Please refer to the field
-               `effective_labels` for all of the labels present on the resource.
+               'effective_labels' for all of the labels present on the resource.
         :param pulumi.Input[str] name: Required. The resource name of the trigger. Must be unique within the location on the project.
-        :param pulumi.Input[str] project: The project for the resource
         :param pulumi.Input[str] service_account: 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
+               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#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.
+               'roles/eventarc.eventReceiver' IAM role.
         :param pulumi.Input['TriggerTransportArgs'] transport: 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.
         """
@@ -79,6 +80,7 @@ class TriggerArgs:
     def destination(self) -> pulumi.Input['TriggerDestinationArgs']:
         """
         Required. Destination specifies where the events should be sent to.
+        Structure is documented below.
         """
         return pulumi.get(self, "destination")
 
@@ -103,6 +105,7 @@ class TriggerArgs:
     def matching_criterias(self) -> pulumi.Input[Sequence[pulumi.Input['TriggerMatchingCriteriaArgs']]]:
         """
         Required. null The list of filters that applies to event attributes. Only events that match all the provided filters will be sent to the destination.
+        Structure is documented below.
         """
         return pulumi.get(self, "matching_criterias")
 
@@ -115,7 +118,7 @@ class TriggerArgs:
     def channel(self) -> Optional[pulumi.Input[str]]:
         """
         Optional. The name of the channel associated with the trigger in
-        `projects/{project}/locations/{location}/channels/{channel}` format. You must provide a channel to receive events from
+        'projects/{project}/locations/{location}/channels/{channel}' format. You must provide a channel to receive events from
         Eventarc SaaS partners.
         """
         return pulumi.get(self, "channel")
@@ -129,7 +132,7 @@ class TriggerArgs:
     def event_data_content_type(self) -> Optional[pulumi.Input[str]]:
         """
         Optional. EventDataContentType specifies the type of payload in MIME format that is expected from the CloudEvent data
-        field. This is set to `application/json` if the value is not defined.
+        field. This is set to 'application/json' if the value is not defined.
         """
         return pulumi.get(self, "event_data_content_type")
 
@@ -143,7 +146,7 @@ class TriggerArgs:
         """
         Optional. User labels attached to the triggers that can be used to group resources. **Note**: This field is
         non-authoritative, and will only manage the labels present in your configuration. Please refer to the field
-        `effective_labels` for all of the labels present on the resource.
+        'effective_labels' for all of the labels present on the resource.
         """
         return pulumi.get(self, "labels")
 
@@ -166,9 +169,6 @@ class TriggerArgs:
     @property
     @pulumi.getter
     def project(self) -> Optional[pulumi.Input[str]]:
-        """
-        The project for the resource
-        """
         return pulumi.get(self, "project")
 
     @project.setter
@@ -180,12 +180,12 @@ class TriggerArgs:
     def service_account(self) -> Optional[pulumi.Input[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
+        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#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.
+        'roles/eventarc.eventReceiver' IAM role.
         """
         return pulumi.get(self, "service_account")
 
@@ -230,30 +230,32 @@ class _TriggerState:
         """
         Input properties used for looking up and filtering Trigger resources.
         :param pulumi.Input[str] channel: Optional. The name of the channel associated with the trigger in
-               `projects/{project}/locations/{location}/channels/{channel}` format. You must provide a channel to receive events from
+               'projects/{project}/locations/{location}/channels/{channel}' format. You must provide a channel to receive events from
                Eventarc SaaS partners.
         :param pulumi.Input[Mapping[str, pulumi.Input[str]]] conditions: Output only. The reason(s) why a trigger is in FAILED state.
         :param pulumi.Input[str] create_time: Output only. The creation time.
         :param pulumi.Input['TriggerDestinationArgs'] destination: Required. Destination specifies where the events should be sent to.
+               Structure is documented below.
         :param pulumi.Input[Mapping[str, pulumi.Input[str]]] effective_labels: All of labels (key/value pairs) present on the resource in GCP, including the labels configured through Pulumi, other clients and services.
         :param pulumi.Input[str] etag: Output only. 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.
         :param pulumi.Input[str] event_data_content_type: Optional. EventDataContentType specifies the type of payload in MIME format that is expected from the CloudEvent data
-               field. This is set to `application/json` if the value is not defined.
+               field. This is set to 'application/json' if the value is not defined.
         :param pulumi.Input[Mapping[str, pulumi.Input[str]]] labels: Optional. User labels attached to the triggers that can be used to group resources. **Note**: This field is
                non-authoritative, and will only manage the labels present in your configuration. Please refer to the field
-               `effective_labels` for all of the labels present on the resource.
+               'effective_labels' for all of the labels present on the resource.
         :param pulumi.Input[str] location: The location for the resource
         :param pulumi.Input[Sequence[pulumi.Input['TriggerMatchingCriteriaArgs']]] matching_criterias: Required. null The list of filters that applies to event attributes. Only events that match all the provided filters will be sent to the destination.
+               Structure is documented below.
         :param pulumi.Input[str] name: Required. The resource name of the trigger. Must be unique within the location on the project.
-        :param pulumi.Input[str] project: The project for the resource
-        :param pulumi.Input[Mapping[str, pulumi.Input[str]]] pulumi_labels: The combination of labels configured directly on the resource and default labels configured on the provider.
+        :param pulumi.Input[Mapping[str, pulumi.Input[str]]] pulumi_labels: The combination of labels configured directly on the resource
+               and default labels configured on the provider.
         :param pulumi.Input[str] service_account: 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
+               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#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.
+               'roles/eventarc.eventReceiver' IAM role.
         :param pulumi.Input['TriggerTransportArgs'] transport: 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.
         :param pulumi.Input[str] uid: Output only. Server assigned unique identifier for the trigger. The value is a UUID4 string and guaranteed to remain unchanged until the resource is deleted.
@@ -299,7 +301,7 @@ class _TriggerState:
     def channel(self) -> Optional[pulumi.Input[str]]:
         """
         Optional. The name of the channel associated with the trigger in
-        `projects/{project}/locations/{location}/channels/{channel}` format. You must provide a channel to receive events from
+        'projects/{project}/locations/{location}/channels/{channel}' format. You must provide a channel to receive events from
         Eventarc SaaS partners.
         """
         return pulumi.get(self, "channel")
@@ -337,6 +339,7 @@ class _TriggerState:
     def destination(self) -> Optional[pulumi.Input['TriggerDestinationArgs']]:
         """
         Required. Destination specifies where the events should be sent to.
+        Structure is documented below.
         """
         return pulumi.get(self, "destination")
 
@@ -373,7 +376,7 @@ class _TriggerState:
     def event_data_content_type(self) -> Optional[pulumi.Input[str]]:
         """
         Optional. EventDataContentType specifies the type of payload in MIME format that is expected from the CloudEvent data
-        field. This is set to `application/json` if the value is not defined.
+        field. This is set to 'application/json' if the value is not defined.
         """
         return pulumi.get(self, "event_data_content_type")
 
@@ -387,7 +390,7 @@ class _TriggerState:
         """
         Optional. User labels attached to the triggers that can be used to group resources. **Note**: This field is
         non-authoritative, and will only manage the labels present in your configuration. Please refer to the field
-        `effective_labels` for all of the labels present on the resource.
+        'effective_labels' for all of the labels present on the resource.
         """
         return pulumi.get(self, "labels")
 
@@ -412,6 +415,7 @@ class _TriggerState:
     def matching_criterias(self) -> Optional[pulumi.Input[Sequence[pulumi.Input['TriggerMatchingCriteriaArgs']]]]:
         """
         Required. null The list of filters that applies to event attributes. Only events that match all the provided filters will be sent to the destination.
+        Structure is documented below.
         """
         return pulumi.get(self, "matching_criterias")
 
@@ -434,9 +438,6 @@ class _TriggerState:
     @property
     @pulumi.getter
     def project(self) -> Optional[pulumi.Input[str]]:
-        """
-        The project for the resource
-        """
         return pulumi.get(self, "project")
 
     @project.setter
@@ -447,7 +448,8 @@ class _TriggerState:
     @pulumi.getter(name="pulumiLabels")
     def pulumi_labels(self) -> Optional[pulumi.Input[Mapping[str, pulumi.Input[str]]]]:
         """
-        The combination of labels configured directly on the resource and default labels configured on the provider.
+        The combination of labels configured directly on the resource
+        and default labels configured on the provider.
         """
         return pulumi.get(self, "pulumi_labels")
 
@@ -460,12 +462,12 @@ class _TriggerState:
     def service_account(self) -> Optional[pulumi.Input[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
+        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#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.
+        'roles/eventarc.eventReceiver' IAM role.
         """
         return pulumi.get(self, "service_account")
 
@@ -530,19 +532,24 @@ class Trigger(pulumi.CustomResource):
         """
         The Eventarc Trigger resource
 
+        To get more information about Trigger, see:
+
+        * [API documentation](https://cloud.google.com/eventarc/docs/reference/rest/v1/projects.locations.triggers)
+        * How-to Guides
+            * [Official Documentation](https://cloud.google.com/eventarc/standard/docs/overview#eventarc-triggers)
+
         ## Example Usage
 
-        ### Basic
+        ### Eventarc Trigger With Cloud Run Destination
+
         ```python
         import pulumi
         import pulumi_gcp as gcp
 
+        foo = gcp.pubsub.Topic("foo", name="some-topic")
         default = gcp.cloudrun.Service("default",
-            name="eventarc-service",
-            location="europe-west1",
-            metadata={
-                "namespace": "my-project-name",
-            },
+            name="some-service",
+            location="us-central1",
             template={
                 "spec": {
                     "containers": [{
@@ -560,8 +567,8 @@ class Trigger(pulumi.CustomResource):
                 "latest_revision": True,
             }])
         primary = gcp.eventarc.Trigger("primary",
-            name="name",
-            location="europe-west1",
+            name="some-trigger",
+            location="us-central1",
             matching_criterias=[{
                 "attribute": "type",
                 "value": "google.cloud.pubsub.topic.v1.messagePublished",
@@ -569,13 +576,17 @@ class Trigger(pulumi.CustomResource):
             destination={
                 "cloud_run_service": {
                     "service": default.name,
-                    "region": "europe-west1",
+                    "region": "us-central1",
                 },
             },
             labels={
                 "foo": "bar",
+            },
+            transport={
+                "pubsub": {
+                    "topic": foo.id,
+                },
             })
-        foo = gcp.pubsub.Topic("foo", name="topic")
         ```
 
         ## Import
@@ -605,25 +616,26 @@ class Trigger(pulumi.CustomResource):
         :param str resource_name: The name of the resource.
         :param pulumi.ResourceOptions opts: Options for the resource.
         :param pulumi.Input[str] channel: Optional. The name of the channel associated with the trigger in
-               `projects/{project}/locations/{location}/channels/{channel}` format. You must provide a channel to receive events from
+               'projects/{project}/locations/{location}/channels/{channel}' format. You must provide a channel to receive events from
                Eventarc SaaS partners.
         :param pulumi.Input[Union['TriggerDestinationArgs', 'TriggerDestinationArgsDict']] destination: Required. Destination specifies where the events should be sent to.
+               Structure is documented below.
         :param pulumi.Input[str] event_data_content_type: Optional. EventDataContentType specifies the type of payload in MIME format that is expected from the CloudEvent data
-               field. This is set to `application/json` if the value is not defined.
+               field. This is set to 'application/json' if the value is not defined.
         :param pulumi.Input[Mapping[str, pulumi.Input[str]]] labels: Optional. User labels attached to the triggers that can be used to group resources. **Note**: This field is
                non-authoritative, and will only manage the labels present in your configuration. Please refer to the field
-               `effective_labels` for all of the labels present on the resource.
+               'effective_labels' for all of the labels present on the resource.
         :param pulumi.Input[str] location: The location for the resource
         :param pulumi.Input[Sequence[pulumi.Input[Union['TriggerMatchingCriteriaArgs', 'TriggerMatchingCriteriaArgsDict']]]] matching_criterias: Required. null The list of filters that applies to event attributes. Only events that match all the provided filters will be sent to the destination.
+               Structure is documented below.
         :param pulumi.Input[str] name: Required. The resource name of the trigger. Must be unique within the location on the project.
-        :param pulumi.Input[str] project: The project for the resource
         :param pulumi.Input[str] service_account: 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
+               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#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.
+               'roles/eventarc.eventReceiver' IAM role.
         :param pulumi.Input[Union['TriggerTransportArgs', 'TriggerTransportArgsDict']] transport: 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.
         """
@@ -636,19 +648,24 @@ class Trigger(pulumi.CustomResource):
         """
         The Eventarc Trigger resource
 
+        To get more information about Trigger, see:
+
+        * [API documentation](https://cloud.google.com/eventarc/docs/reference/rest/v1/projects.locations.triggers)
+        * How-to Guides
+            * [Official Documentation](https://cloud.google.com/eventarc/standard/docs/overview#eventarc-triggers)
+
         ## Example Usage
 
-        ### Basic
+        ### Eventarc Trigger With Cloud Run Destination
+
         ```python
         import pulumi
         import pulumi_gcp as gcp
 
+        foo = gcp.pubsub.Topic("foo", name="some-topic")
         default = gcp.cloudrun.Service("default",
-            name="eventarc-service",
-            location="europe-west1",
-            metadata={
-                "namespace": "my-project-name",
-            },
+            name="some-service",
+            location="us-central1",
             template={
                 "spec": {
                     "containers": [{
@@ -666,8 +683,8 @@ class Trigger(pulumi.CustomResource):
                 "latest_revision": True,
             }])
         primary = gcp.eventarc.Trigger("primary",
-            name="name",
-            location="europe-west1",
+            name="some-trigger",
+            location="us-central1",
             matching_criterias=[{
                 "attribute": "type",
                 "value": "google.cloud.pubsub.topic.v1.messagePublished",
@@ -675,13 +692,17 @@ class Trigger(pulumi.CustomResource):
             destination={
                 "cloud_run_service": {
                     "service": default.name,
-                    "region": "europe-west1",
+                    "region": "us-central1",
                 },
             },
             labels={
                 "foo": "bar",
+            },
+            transport={
+                "pubsub": {
+                    "topic": foo.id,
+                },
             })
-        foo = gcp.pubsub.Topic("foo", name="topic")
         ```
 
         ## Import
@@ -802,30 +823,32 @@ class Trigger(pulumi.CustomResource):
         :param pulumi.Input[str] id: The unique provider ID of the resource to lookup.
         :param pulumi.ResourceOptions opts: Options for the resource.
         :param pulumi.Input[str] channel: Optional. The name of the channel associated with the trigger in
-               `projects/{project}/locations/{location}/channels/{channel}` format. You must provide a channel to receive events from
+               'projects/{project}/locations/{location}/channels/{channel}' format. You must provide a channel to receive events from
                Eventarc SaaS partners.
         :param pulumi.Input[Mapping[str, pulumi.Input[str]]] conditions: Output only. The reason(s) why a trigger is in FAILED state.
         :param pulumi.Input[str] create_time: Output only. The creation time.
         :param pulumi.Input[Union['TriggerDestinationArgs', 'TriggerDestinationArgsDict']] destination: Required. Destination specifies where the events should be sent to.
+               Structure is documented below.
         :param pulumi.Input[Mapping[str, pulumi.Input[str]]] effective_labels: All of labels (key/value pairs) present on the resource in GCP, including the labels configured through Pulumi, other clients and services.
         :param pulumi.Input[str] etag: Output only. 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.
         :param pulumi.Input[str] event_data_content_type: Optional. EventDataContentType specifies the type of payload in MIME format that is expected from the CloudEvent data
-               field. This is set to `application/json` if the value is not defined.
+               field. This is set to 'application/json' if the value is not defined.
         :param pulumi.Input[Mapping[str, pulumi.Input[str]]] labels: Optional. User labels attached to the triggers that can be used to group resources. **Note**: This field is
                non-authoritative, and will only manage the labels present in your configuration. Please refer to the field
-               `effective_labels` for all of the labels present on the resource.
+               'effective_labels' for all of the labels present on the resource.
         :param pulumi.Input[str] location: The location for the resource
         :param pulumi.Input[Sequence[pulumi.Input[Union['TriggerMatchingCriteriaArgs', 'TriggerMatchingCriteriaArgsDict']]]] matching_criterias: Required. null The list of filters that applies to event attributes. Only events that match all the provided filters will be sent to the destination.
+               Structure is documented below.
         :param pulumi.Input[str] name: Required. The resource name of the trigger. Must be unique within the location on the project.
-        :param pulumi.Input[str] project: The project for the resource
-        :param pulumi.Input[Mapping[str, pulumi.Input[str]]] pulumi_labels: The combination of labels configured directly on the resource and default labels configured on the provider.
+        :param pulumi.Input[Mapping[str, pulumi.Input[str]]] pulumi_labels: The combination of labels configured directly on the resource
+               and default labels configured on the provider.
         :param pulumi.Input[str] service_account: 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
+               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#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.
+               'roles/eventarc.eventReceiver' IAM role.
         :param pulumi.Input[Union['TriggerTransportArgs', 'TriggerTransportArgsDict']] transport: 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.
         :param pulumi.Input[str] uid: Output only. Server assigned unique identifier for the trigger. The value is a UUID4 string and guaranteed to remain unchanged until the resource is deleted.
@@ -859,7 +882,7 @@ class Trigger(pulumi.CustomResource):
     def channel(self) -> pulumi.Output[Optional[str]]:
         """
         Optional. The name of the channel associated with the trigger in
-        `projects/{project}/locations/{location}/channels/{channel}` format. You must provide a channel to receive events from
+        'projects/{project}/locations/{location}/channels/{channel}' format. You must provide a channel to receive events from
         Eventarc SaaS partners.
         """
         return pulumi.get(self, "channel")
@@ -885,6 +908,7 @@ class Trigger(pulumi.CustomResource):
     def destination(self) -> pulumi.Output['outputs.TriggerDestination']:
         """
         Required. Destination specifies where the events should be sent to.
+        Structure is documented below.
         """
         return pulumi.get(self, "destination")
 
@@ -909,7 +933,7 @@ class Trigger(pulumi.CustomResource):
     def event_data_content_type(self) -> pulumi.Output[str]:
         """
         Optional. EventDataContentType specifies the type of payload in MIME format that is expected from the CloudEvent data
-        field. This is set to `application/json` if the value is not defined.
+        field. This is set to 'application/json' if the value is not defined.
         """
         return pulumi.get(self, "event_data_content_type")
 
@@ -919,7 +943,7 @@ class Trigger(pulumi.CustomResource):
         """
         Optional. User labels attached to the triggers that can be used to group resources. **Note**: This field is
         non-authoritative, and will only manage the labels present in your configuration. Please refer to the field
-        `effective_labels` for all of the labels present on the resource.
+        'effective_labels' for all of the labels present on the resource.
         """
         return pulumi.get(self, "labels")
 
@@ -936,6 +960,7 @@ class Trigger(pulumi.CustomResource):
     def matching_criterias(self) -> pulumi.Output[Sequence['outputs.TriggerMatchingCriteria']]:
         """
         Required. null The list of filters that applies to event attributes. Only events that match all the provided filters will be sent to the destination.
+        Structure is documented below.
         """
         return pulumi.get(self, "matching_criterias")
 
@@ -950,16 +975,14 @@ class Trigger(pulumi.CustomResource):
     @property
     @pulumi.getter
     def project(self) -> pulumi.Output[str]:
-        """
-        The project for the resource
-        """
         return pulumi.get(self, "project")
 
     @property
     @pulumi.getter(name="pulumiLabels")
     def pulumi_labels(self) -> pulumi.Output[Mapping[str, str]]:
         """
-        The combination of labels configured directly on the resource and default labels configured on the provider.
+        The combination of labels configured directly on the resource
+        and default labels configured on the provider.
         """
         return pulumi.get(self, "pulumi_labels")
 
@@ -968,12 +991,12 @@ class Trigger(pulumi.CustomResource):
     def service_account(self) -> pulumi.Output[Optional[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
+        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#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.
+        'roles/eventarc.eventReceiver' IAM role.
         """
         return pulumi.get(self, "service_account")