google-cloud-eventarc-v1 0.1.3 → 0.2.1

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

@@ -47,16 +47,16 @@ module Google
         #     the call that provided the page token.
         # @!attribute [rw] order_by
         #   @return [::String]
-        #     The sorting order of the resources returned. Value should be a comma
-        #     separated list of fields. The default sorting oder is ascending. To specify
-        #     descending order for a field, append a ` desc` suffix; for example:
+        #     The sorting order of the resources returned. Value should be a
+        #     comma-separated list of fields. The default sorting order is ascending. To
+        #     specify descending order for a field, append a `desc` suffix; for example:
         #     `name desc, trigger_id`.
         class ListTriggersRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
-        # The response message for the ListTriggers method.
+        # The response message for the `ListTriggers` method.
         # @!attribute [rw] triggers
         #   @return [::Array<::Google::Cloud::Eventarc::V1::Trigger>]
         #     The requested triggers, up to the number specified in `page_size`.
@@ -84,7 +84,7 @@ module Google
         #     Required. The user-provided ID to be assigned to the trigger.
         # @!attribute [rw] validate_only
         #   @return [::Boolean]
-        #     Required. If set, validate the request and preview the review, but do not actually
+        #     Required. If set, validate the request and preview the review, but do not
         #     post it.
         class CreateTriggerRequest
           include ::Google::Protobuf::MessageExts
@@ -97,8 +97,8 @@ module Google
         #     The trigger to be updated.
         # @!attribute [rw] update_mask
         #   @return [::Google::Protobuf::FieldMask]
-        #     The fields to be updated; only fields explicitly provided will be updated.
-        #     If no field mask is provided, all provided fields in the request will be
+        #     The fields to be updated; only fields explicitly provided are updated.
+        #     If no field mask is provided, all provided fields in the request are
         #     updated. To update all fields, provide a field mask of "*".
         # @!attribute [rw] allow_missing
         #   @return [::Boolean]
@@ -106,7 +106,7 @@ module Google
         #     created. In this situation, `update_mask` is ignored.
         # @!attribute [rw] validate_only
         #   @return [::Boolean]
-        #     Required. If set, validate the request and preview the review, but do not actually
+        #     Required. If set, validate the request and preview the review, but do not
         #     post it.
         class UpdateTriggerRequest
           include ::Google::Protobuf::MessageExts
@@ -127,13 +127,185 @@ module Google
         #     but no action will be taken on the server.
         # @!attribute [rw] validate_only
         #   @return [::Boolean]
-        #     Required. If set, validate the request and preview the review, but do not actually
+        #     Required. If set, validate the request and preview the review, but do not
         #     post it.
         class DeleteTriggerRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
+        # The request message for the GetChannel method.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. The name of the channel to get.
+        class GetChannelRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # The request message for the ListChannels method.
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. The parent collection to list channels on.
+        # @!attribute [rw] page_size
+        #   @return [::Integer]
+        #     The maximum number of channels to return on each page.
+        #     Note: The service may send fewer.
+        # @!attribute [rw] page_token
+        #   @return [::String]
+        #     The page token; provide the value from the `next_page_token` field in a
+        #     previous `ListChannels` call to retrieve the subsequent page.
+        #
+        #     When paginating, all other parameters provided to `ListChannels` must
+        #     match the call that provided the page token.
+        # @!attribute [rw] order_by
+        #   @return [::String]
+        #     The sorting order of the resources returned. Value should be a
+        #     comma-separated list of fields. The default sorting order is ascending. To
+        #     specify descending order for a field, append a `desc` suffix; for example:
+        #     `name desc, channel_id`.
+        class ListChannelsRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # The response message for the `ListChannels` method.
+        # @!attribute [rw] channels
+        #   @return [::Array<::Google::Cloud::Eventarc::V1::Channel>]
+        #     The requested channels, up to the number specified in `page_size`.
+        # @!attribute [rw] next_page_token
+        #   @return [::String]
+        #     A page token that can be sent to ListChannels to request the next page.
+        #     If this is empty, then there are no more pages.
+        # @!attribute [rw] unreachable
+        #   @return [::Array<::String>]
+        #     Unreachable resources, if any.
+        class ListChannelsResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # The request message for the CreateChannel method.
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. The parent collection in which to add this channel.
+        # @!attribute [rw] channel
+        #   @return [::Google::Cloud::Eventarc::V1::Channel]
+        #     Required. The channel to create.
+        # @!attribute [rw] channel_id
+        #   @return [::String]
+        #     Required. The user-provided ID to be assigned to the channel.
+        # @!attribute [rw] validate_only
+        #   @return [::Boolean]
+        #     Required. If set, validate the request and preview the review, but do not
+        #     post it.
+        class CreateChannelRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # The request message for the UpdateChannel method.
+        # @!attribute [rw] channel
+        #   @return [::Google::Cloud::Eventarc::V1::Channel]
+        #     The channel to be updated.
+        # @!attribute [rw] update_mask
+        #   @return [::Google::Protobuf::FieldMask]
+        #     The fields to be updated; only fields explicitly provided are updated.
+        #     If no field mask is provided, all provided fields in the request are
+        #     updated. To update all fields, provide a field mask of "*".
+        # @!attribute [rw] validate_only
+        #   @return [::Boolean]
+        #     Required. If set, validate the request and preview the review, but do not
+        #     post it.
+        class UpdateChannelRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # The request message for the DeleteChannel method.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. The name of the channel to be deleted.
+        # @!attribute [rw] validate_only
+        #   @return [::Boolean]
+        #     Required. If set, validate the request and preview the review, but do not
+        #     post it.
+        class DeleteChannelRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # The request message for the GetChannelConnection method.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. The name of the channel connection to get.
+        class GetChannelConnectionRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # The request message for the ListChannelConnections method.
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. The parent collection from which to list channel connections.
+        # @!attribute [rw] page_size
+        #   @return [::Integer]
+        #     The maximum number of channel connections to return on each page.
+        #     Note: The service may send fewer responses.
+        # @!attribute [rw] page_token
+        #   @return [::String]
+        #     The page token; provide the value from the `next_page_token` field in a
+        #     previous `ListChannelConnections` call to retrieve the subsequent page.
+        #
+        #     When paginating, all other parameters provided to `ListChannelConnetions`
+        #     match the call that provided the page token.
+        class ListChannelConnectionsRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # The response message for the `ListChannelConnections` method.
+        # @!attribute [rw] channel_connections
+        #   @return [::Array<::Google::Cloud::Eventarc::V1::ChannelConnection>]
+        #     The requested channel connections, up to the number specified in
+        #     `page_size`.
+        # @!attribute [rw] next_page_token
+        #   @return [::String]
+        #     A page token that can be sent to ListChannelConnections to request the
+        #     next page.
+        #     If this is empty, then there are no more pages.
+        # @!attribute [rw] unreachable
+        #   @return [::Array<::String>]
+        #     Unreachable resources, if any.
+        class ListChannelConnectionsResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # The request message for the CreateChannelConnection method.
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. The parent collection in which to add this channel connection.
+        # @!attribute [rw] channel_connection
+        #   @return [::Google::Cloud::Eventarc::V1::ChannelConnection]
+        #     Required. Channel connection to create.
+        # @!attribute [rw] channel_connection_id
+        #   @return [::String]
+        #     Required. The user-provided ID to be assigned to the channel connection.
+        class CreateChannelConnectionRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # The request message for the DeleteChannelConnection method.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. The name of the channel connection to delete.
+        class DeleteChannelConnectionRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
         # Represents the metadata of the long-running operation.
         # @!attribute [r] create_time
         #   @return [::Google::Protobuf::Timestamp]

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

@@ -24,14 +24,13 @@ 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 on 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.
@@ -40,14 +39,14 @@ module Google
         #     Output only. The last-modified time.
         # @!attribute [rw] event_filters
         #   @return [::Array<::Google::Cloud::Eventarc::V1::EventFilter>]
-        #     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.
+        #     Required. null 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 `iam.serviceAccounts.actAs`
+        #     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.
@@ -56,26 +55,30 @@ module Google
         #     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.
+        #     To create Audit Log triggers, the service account should also
+        #     have the `roles/eventarc.eventReceiver` IAM role.
         # @!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. 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
+        #     Optional. To deliver messages, Eventarc might use other GCP
+        #     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
+        #     `projects/{project}/locations/{location}/channels/{channel}` format.
+        #     You must provide a channel to receive events from Eventarc SaaS partners.
         # @!attribute [r] etag
         #   @return [::String]
-        #     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.
+        #     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
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -93,13 +96,19 @@ 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.
         #
         #     All triggers MUST provide a filter for the 'type' attribute.
         # @!attribute [rw] value
         #   @return [::String]
         #     Required. The value for the attribute.
+        # @!attribute [rw] operator
+        #   @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`.
         class EventFilter
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -108,18 +117,26 @@ module Google
         # Represents a target of an invocation over HTTP.
         # @!attribute [rw] cloud_run
         #   @return [::Google::Cloud::Eventarc::V1::CloudRun]
-        #     Cloud Run fully-managed service that receives the events. The service
-        #     should be running in the same project of the trigger.
+        #     Cloud Run fully-managed resource that receives the events. The resource
+        #     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.
+        #     Format: `projects/{project}/locations/{location}/functions/{function}`
+        # @!attribute [rw] gke
+        #   @return [::Google::Cloud::Eventarc::V1::GKE]
+        #     A GKE service capable of receiving events. The service should be running
+        #     in the same project as the trigger.
         class Destination
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
-        # Represents the transport intermediaries created for the trigger in order to
+        # Represents the transport intermediaries created for the trigger to
         # deliver events.
         # @!attribute [rw] pubsub
         #   @return [::Google::Cloud::Eventarc::V1::Pubsub]
-        #     The Pub/Sub topic and subscription used by Eventarc as delivery
+        #     The Pub/Sub topic and subscription used by Eventarc as a transport
         #     intermediary.
         class Transport
           include ::Google::Protobuf::MessageExts
@@ -132,14 +149,13 @@ module Google
         #     Required. 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
+        #     Only services located in the same project as the trigger object
         #     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 URI path segment (section 3.3
+        #     The value must conform to the definition of a URI path segment (section 3.3
         #     of RFC2396). Examples: "/route", "route", "route/subroute".
         # @!attribute [rw] region
         #   @return [::String]
@@ -149,20 +165,47 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
+        # 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.
+        # @!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.
+        # @!attribute [rw] namespace
+        #   @return [::String]
+        #     Required. The namespace the GKE service is running in.
+        # @!attribute [rw] service
+        #   @return [::String]
+        #     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.
+        #
+        #     The value must conform to the definition of a URI path segment (section 3.3
+        #     of RFC2396). Examples: "/route", "route", "route/subroute".
+        class GKE
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
         # Represents a Pub/Sub transport.
         # @!attribute [rw] topic
         #   @return [::String]
-        #     Optional. The name of the Pub/Sub topic created and managed by Eventarc
-        #     system as a transport for the event delivery. Format:
+        #     Optional. The name of the Pub/Sub topic created and managed by Eventarc 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.
+        #     You can set an existing topic for triggers of the type
+        #     `google.cloud.pubsub.topic.v1.messagePublished`. The topic you provide
+        #     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 system 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

data/proto_docs/google/protobuf/any.rb

@@ -44,7 +44,7 @@ module Google
     #       foo = any.unpack(Foo.class);
     #     }
     #
-    #  Example 3: Pack and unpack a message in Python.
+    # Example 3: Pack and unpack a message in Python.
     #
     #     foo = Foo(...)
     #     any = Any()
@@ -54,7 +54,7 @@ module Google
     #       any.Unpack(foo)
     #       ...
     #
-    #  Example 4: Pack and unpack a message in Go
+    # Example 4: Pack and unpack a message in Go
     #
     #      foo := &pb.Foo{...}
     #      any, err := anypb.New(foo)
@@ -75,7 +75,7 @@ module Google
     #
     #
     # JSON
-    # ====
+    #
     # The JSON representation of an `Any` value uses the regular
     # representation of the deserialized, embedded message, with an
     # additional field `@type` which contains the type URL. Example:

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-eventarc-v1
 version: !ruby/object:Gem::Version
-  version: 0.1.3
+  version: 0.2.1
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-11-08 00:00:00.000000000 Z
+date: 2022-05-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gapic-common
@@ -173,6 +173,8 @@ files:
 - README.md
 - lib/google-cloud-eventarc-v1.rb
 - lib/google/cloud/eventarc/v1.rb
+- lib/google/cloud/eventarc/v1/channel_connection_pb.rb
+- lib/google/cloud/eventarc/v1/channel_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
@@ -185,6 +187,8 @@ files:
 - proto_docs/README.md
 - proto_docs/google/api/field_behavior.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/eventarc.rb
 - proto_docs/google/cloud/eventarc/v1/trigger.rb
 - proto_docs/google/longrunning/operations.rb
@@ -213,7 +217,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.17
+rubygems_version: 3.3.5
 signing_key: 
 specification_version: 4
 summary: API Client library for the Eventarc V1 API