google-cloud-eventarc-v1 1.0.1 → 1.2.0

data/proto_docs/google/cloud/eventarc/v1/trigger.rb

@@ -24,13 +24,14 @@ module Google
         # A representation of the trigger resource.
         # @!attribute [rw] name
         #   @return [::String]
-        #     Required. The resource name of the trigger. Must be unique within the location of the
-        #     project and must be in
+        #     Required. The resource name of the trigger. Must be unique within the
+        #     location of the project and must be in
         #     `projects/{project}/locations/{location}/triggers/{trigger}` format.
         # @!attribute [r] uid
         #   @return [::String]
-        #     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.
+        #     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.
         # @!attribute [r] create_time
         #   @return [::Google::Protobuf::Timestamp]
         #     Output only. The creation time.
@@ -39,36 +40,32 @@ module Google
         #     Output only. The last-modified time.
         # @!attribute [rw] event_filters
         #   @return [::Array<::Google::Cloud::Eventarc::V1::EventFilter>]
-        #     Required. Unordered list. The list of filters that applies to event attributes. Only events that
-        #     match all the provided filters are sent to the destination.
+        #     Required. Unordered list. The list of filters that applies to event
+        #     attributes. Only events that match all the provided filters are sent to the
+        #     destination.
         # @!attribute [rw] service_account
         #   @return [::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 the `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.
-        #     To create Audit Log triggers, the service account should also
-        #     have the `roles/eventarc.eventReceiver` IAM role.
+        #     The `iam.serviceAccounts.actAs` permission must be granted on the service
+        #     account to allow a principal to impersonate the service account. For more
+        #     information, see the
+        #     [Roles and permissions](/eventarc/docs/all-roles-permissions) page specific
+        #     to the trigger destination.
         # @!attribute [rw] destination
         #   @return [::Google::Cloud::Eventarc::V1::Destination]
         #     Required. Destination specifies where the events should be sent to.
         # @!attribute [rw] transport
         #   @return [::Google::Cloud::Eventarc::V1::Transport]
-        #     Optional. To deliver messages, Eventarc might use other GCP
+        #     Optional. To deliver messages, Eventarc might use other Google Cloud
         #     products as a transport intermediary. This field contains a reference to
         #     that transport intermediary. This information can be used for debugging
         #     purposes.
         # @!attribute [rw] labels
         #   @return [::Google::Protobuf::Map{::String => ::String}]
-        #     Optional. User labels attached to the triggers that can be used to group resources.
+        #     Optional. User labels attached to the triggers that can be used to group
+        #     resources.
         # @!attribute [rw] channel
         #   @return [::String]
         #     Optional. The name of the channel associated with the trigger in
@@ -77,10 +74,19 @@ module Google
         # @!attribute [r] conditions
         #   @return [::Google::Protobuf::Map{::String => ::Google::Cloud::Eventarc::V1::StateCondition}]
         #     Output only. The reason(s) why a trigger is in FAILED state.
+        # @!attribute [rw] event_data_content_type
+        #   @return [::String]
+        #     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.
+        # @!attribute [r] satisfies_pzs
+        #   @return [::Boolean]
+        #     Output only. Whether or not this Trigger satisfies the requirements of
+        #     physical zone separation
         # @!attribute [r] etag
         #   @return [::String]
-        #     Output only. This checksum is computed by the server based on the value of other
-        #     fields, and might be sent only on create requests to ensure that the
+        #     Output only. This checksum is computed by the server based on the value of
+        #     other fields, and might be sent only on create requests to ensure that the
         #     client has an up-to-date value before proceeding.
         class Trigger
           include ::Google::Protobuf::MessageExts
@@ -108,8 +114,10 @@ module Google
         # Filters events based on exact matches on the CloudEvents attributes.
         # @!attribute [rw] attribute
         #   @return [::String]
-        #     Required. The name of a CloudEvents attribute. Currently, only a subset of attributes
-        #     are supported for filtering.
+        #     Required. The name of a CloudEvents attribute. Currently, only a subset of
+        #     attributes are supported for filtering. You can [retrieve a specific
+        #     provider's supported event
+        #     types](/eventarc/docs/list-providers#describe-provider).
         #
         #     All triggers MUST provide a filter for the 'type' attribute.
         # @!attribute [rw] value
@@ -119,8 +127,9 @@ module Google
         #   @return [::String]
         #     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`.
+        #     specified in the filter are matched. The allowed values are `path_pattern`
+        #     and `match-path-pattern`. `path_pattern` is only allowed for GCFv1
+        #     triggers.
         class EventFilter
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -145,8 +154,13 @@ module Google
         #     should be in the same project as the trigger.
         # @!attribute [rw] cloud_function
         #   @return [::String]
-        #     The Cloud Function resource name. Only Cloud Functions V2 is supported.
+        #     The Cloud Function resource name. Cloud Functions V1 and V2 are
+        #     supported.
         #     Format: `projects/{project}/locations/{location}/functions/{function}`
+        #
+        #     This is a read-only field. Creating Cloud Functions V1/V2 triggers is
+        #     only supported via the Cloud Functions product. An error will be returned
+        #     if the user sets this value.
         # @!attribute [rw] gke
         #   @return [::Google::Cloud::Eventarc::V1::GKE]
         #     A GKE service capable of receiving events. The service should be running
@@ -157,6 +171,14 @@ module Google
         #     the events. The Workflow resource should be deployed in the same project
         #     as the trigger.
         #     Format: `projects/{project}/locations/{location}/workflows/{workflow}`
+        # @!attribute [rw] http_endpoint
+        #   @return [::Google::Cloud::Eventarc::V1::HttpEndpoint]
+        #     An HTTP endpoint destination described by an URI.
+        # @!attribute [rw] network_config
+        #   @return [::Google::Cloud::Eventarc::V1::NetworkConfig]
+        #     Optional. Network config is used to configure how Eventarc resolves and
+        #     connect to a destination.
+        #     This should only be used with HttpEndpoint destination type.
         class Destination
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -183,7 +205,8 @@ module Google
         #     can be addressed.
         # @!attribute [rw] path
         #   @return [::String]
-        #     Optional. The relative path on the Cloud Run service the events should be sent to.
+        #     Optional. The relative path on the Cloud Run service the events should be
+        #     sent to.
         #
         #     The value must conform to the definition of a URI path segment (section 3.3
         #     of RFC2396). Examples: "/route", "route", "route/subroute".
@@ -198,13 +221,14 @@ module Google
         # Represents a GKE destination.
         # @!attribute [rw] cluster
         #   @return [::String]
-        #     Required. 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.
+        #     Required. 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.
         # @!attribute [rw] location
         #   @return [::String]
-        #     Required. The name of the Google Compute Engine in which the cluster resides, which
-        #     can either be compute zone (for example, us-central1-a) for the zonal
-        #     clusters or region (for example, us-central1) for regional clusters.
+        #     Required. The name of the Google Compute Engine in which the cluster
+        #     resides, which can either be compute zone (for example, us-central1-a) for
+        #     the zonal clusters or region (for example, us-central1) for regional
+        #     clusters.
         # @!attribute [rw] namespace
         #   @return [::String]
         #     Required. The namespace the GKE service is running in.
@@ -213,7 +237,8 @@ module Google
         #     Required. Name of the GKE service.
         # @!attribute [rw] path
         #   @return [::String]
-        #     Optional. The relative path on the GKE service the events should be sent to.
+        #     Optional. The relative path on the GKE service the events should be sent
+        #     to.
         #
         #     The value must conform to the definition of a URI path segment (section 3.3
         #     of RFC2396). Examples: "/route", "route", "route/subroute".
@@ -234,13 +259,29 @@ module Google
         #     here is not deleted by Eventarc at trigger deletion.
         # @!attribute [r] subscription
         #   @return [::String]
-        #     Output only. The name of the Pub/Sub subscription created and managed by Eventarc
-        #     as a transport for the event delivery. Format:
+        #     Output only. The name of the Pub/Sub subscription created and managed by
+        #     Eventarc as a transport for the event delivery. Format:
         #     `projects/{PROJECT_ID}/subscriptions/{SUBSCRIPTION_NAME}`.
         class Pubsub
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
+
+        # Represents a HTTP endpoint destination.
+        # @!attribute [rw] uri
+        #   @return [::String]
+        #     Required. The URI of the HTTP enpdoint.
+        #
+        #     The value must be a RFC2396 URI string.
+        #     Examples: `http://10.10.10.8:80/route`,
+        #     `http://svc.us-central1.p.local:8080/`.
+        #     Only HTTP and HTTPS protocols are supported. The host can be either a
+        #     static IP addressable from the VPC specified by the network config, or
+        #     an internal DNS hostname of the service resolvable via Cloud DNS.
+        class HttpEndpoint
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
       end
     end
   end

data/proto_docs/google/longrunning/operations.rb

@@ -42,7 +42,7 @@ module Google
     #     The error result of the operation in case of failure or cancellation.
     # @!attribute [rw] response
     #   @return [::Google::Protobuf::Any]
-    #     The normal response of the operation in case of success.  If the original
+    #     The normal, successful response of the operation.  If the original
     #     method returns no data on success, such as `Delete`, the response is
     #     `google.protobuf.Empty`.  If the original method is standard
     #     `Get`/`Create`/`Update`, the response should be the resource.  For other
@@ -55,7 +55,8 @@ module Google
       extend ::Google::Protobuf::MessageExts::ClassMethods
     end
 
-    # The request message for Operations.GetOperation.
+    # The request message for
+    # Operations.GetOperation.
     # @!attribute [rw] name
     #   @return [::String]
     #     The name of the operation resource.
@@ -64,7 +65,8 @@ module Google
       extend ::Google::Protobuf::MessageExts::ClassMethods
     end
 
-    # The request message for Operations.ListOperations.
+    # The request message for
+    # Operations.ListOperations.
     # @!attribute [rw] name
     #   @return [::String]
     #     The name of the operation's parent resource.
@@ -82,7 +84,8 @@ module Google
       extend ::Google::Protobuf::MessageExts::ClassMethods
     end
 
-    # The response message for Operations.ListOperations.
+    # The response message for
+    # Operations.ListOperations.
     # @!attribute [rw] operations
     #   @return [::Array<::Google::Longrunning::Operation>]
     #     A list of operations that matches the specified filter in the request.
@@ -94,7 +97,8 @@ module Google
       extend ::Google::Protobuf::MessageExts::ClassMethods
     end
 
-    # The request message for Operations.CancelOperation.
+    # The request message for
+    # Operations.CancelOperation.
     # @!attribute [rw] name
     #   @return [::String]
     #     The name of the operation resource to be cancelled.
@@ -103,7 +107,8 @@ module Google
       extend ::Google::Protobuf::MessageExts::ClassMethods
     end
 
-    # The request message for Operations.DeleteOperation.
+    # The request message for
+    # Operations.DeleteOperation.
     # @!attribute [rw] name
     #   @return [::String]
     #     The name of the operation resource to be deleted.
@@ -112,7 +117,8 @@ module Google
       extend ::Google::Protobuf::MessageExts::ClassMethods
     end
 
-    # The request message for Operations.WaitOperation.
+    # The request message for
+    # Operations.WaitOperation.
     # @!attribute [rw] name
     #   @return [::String]
     #     The name of the operation resource to wait on.
@@ -130,13 +136,12 @@ module Google
     #
     # Example:
     #
-    #   rpc LongRunningRecognize(LongRunningRecognizeRequest)
-    #       returns (google.longrunning.Operation) {
-    #     option (google.longrunning.operation_info) = {
-    #       response_type: "LongRunningRecognizeResponse"
-    #       metadata_type: "LongRunningRecognizeMetadata"
-    #     };
-    #   }
+    #     rpc Export(ExportRequest) returns (google.longrunning.Operation) {
+    #       option (google.longrunning.operation_info) = {
+    #         response_type: "ExportResponse"
+    #         metadata_type: "ExportMetadata"
+    #       };
+    #     }
     # @!attribute [rw] response_type
     #   @return [::String]
     #     Required. The message name of the primary return type for this

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-eventarc-v1
 version: !ruby/object:Gem::Version
-  version: 1.0.1
+  version: 1.2.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2024-08-30 00:00:00.000000000 Z
+date: 2024-12-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gapic-common
@@ -16,7 +16,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.21.1
+        version: 0.24.0
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a
@@ -26,7 +26,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.21.1
+        version: 0.24.0
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a
@@ -105,6 +105,7 @@ files:
 - lib/google/cloud/eventarc/v1/channel_connection_pb.rb
 - lib/google/cloud/eventarc/v1/channel_pb.rb
 - lib/google/cloud/eventarc/v1/discovery_pb.rb
+- lib/google/cloud/eventarc/v1/enrollment_pb.rb
 - lib/google/cloud/eventarc/v1/eventarc.rb
 - lib/google/cloud/eventarc/v1/eventarc/client.rb
 - lib/google/cloud/eventarc/v1/eventarc/credentials.rb
@@ -116,20 +117,32 @@ files:
 - lib/google/cloud/eventarc/v1/eventarc/rest/service_stub.rb
 - lib/google/cloud/eventarc/v1/eventarc_pb.rb
 - lib/google/cloud/eventarc/v1/eventarc_services_pb.rb
+- lib/google/cloud/eventarc/v1/google_api_source_pb.rb
 - lib/google/cloud/eventarc/v1/google_channel_config_pb.rb
+- lib/google/cloud/eventarc/v1/logging_config_pb.rb
+- lib/google/cloud/eventarc/v1/message_bus_pb.rb
+- lib/google/cloud/eventarc/v1/network_config_pb.rb
+- lib/google/cloud/eventarc/v1/pipeline_pb.rb
 - lib/google/cloud/eventarc/v1/rest.rb
 - lib/google/cloud/eventarc/v1/trigger_pb.rb
 - lib/google/cloud/eventarc/v1/version.rb
 - proto_docs/README.md
 - proto_docs/google/api/client.rb
 - proto_docs/google/api/field_behavior.rb
+- proto_docs/google/api/field_info.rb
 - proto_docs/google/api/launch_stage.rb
 - proto_docs/google/api/resource.rb
 - proto_docs/google/cloud/eventarc/v1/channel.rb
 - proto_docs/google/cloud/eventarc/v1/channel_connection.rb
 - proto_docs/google/cloud/eventarc/v1/discovery.rb
+- proto_docs/google/cloud/eventarc/v1/enrollment.rb
 - proto_docs/google/cloud/eventarc/v1/eventarc.rb
+- proto_docs/google/cloud/eventarc/v1/google_api_source.rb
 - proto_docs/google/cloud/eventarc/v1/google_channel_config.rb
+- proto_docs/google/cloud/eventarc/v1/logging_config.rb
+- proto_docs/google/cloud/eventarc/v1/message_bus.rb
+- proto_docs/google/cloud/eventarc/v1/network_config.rb
+- proto_docs/google/cloud/eventarc/v1/pipeline.rb
 - proto_docs/google/cloud/eventarc/v1/trigger.rb
 - proto_docs/google/longrunning/operations.rb
 - proto_docs/google/protobuf/any.rb
@@ -159,7 +172,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.6
+rubygems_version: 3.5.23
 signing_key: 
 specification_version: 4
 summary: Build event-driven applications on Google Cloud Platform.