google-cloud-eventarc-v1 0.4.0 → 0.6.0

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

@@ -27,13 +27,14 @@ module Google
         # channel. Note that a channel is associated with exactly one event provider.
         # @!attribute [rw] name
         #   @return [::String]
-        #     Required. The resource name of the channel. Must be unique within the location
-        #     on the project and must be in
+        #     Required. The resource name of the channel. Must be unique within the
+        #     location on the project and must be in
         #     `projects/{project}/locations/{location}/channels/{channel_id}` format.
         # @!attribute [r] uid
         #   @return [::String]
-        #     Output only. Server assigned unique identifier for the channel. The value is a UUID4
-        #     string and guaranteed to remain unchanged until the resource is deleted.
+        #     Output only. Server assigned unique identifier for the channel. 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.
@@ -42,22 +43,29 @@ module Google
         #     Output only. The last-modified time.
         # @!attribute [rw] provider
         #   @return [::String]
-        #     Required. The name of the event provider (e.g. Eventarc SaaS partner) associated
+        #     The name of the event provider (e.g. Eventarc SaaS partner) associated
         #     with the channel. This provider will be granted permissions to publish
         #     events to the channel. Format:
         #     `projects/{project}/locations/{location}/providers/{provider_id}`.
         # @!attribute [r] pubsub_topic
         #   @return [::String]
-        #     Output only. The name of the Pub/Sub topic created and managed by Eventarc system as
-        #     a transport for the event delivery. Format:
+        #     Output only. The name of the Pub/Sub topic created and managed by
+        #     Eventarc system as a transport for the event delivery. Format:
         #     `projects/{project}/topics/{topic_id}`.
         # @!attribute [r] state
         #   @return [::Google::Cloud::Eventarc::V1::Channel::State]
         #     Output only. The state of a Channel.
         # @!attribute [r] activation_token
         #   @return [::String]
-        #     Output only. The activation token for the channel. The token must be used by the
-        #     provider to register the channel for publishing.
+        #     Output only. The activation token for the channel. The token must be used
+        #     by the provider to register the channel for publishing.
+        # @!attribute [rw] crypto_key_name
+        #   @return [::String]
+        #     Optional. Resource name of a KMS crypto key (managed by the user) used to
+        #     encrypt/decrypt their event data.
+        #
+        #     It must match the pattern
+        #     `projects/*/locations/*/keyRings/*/cryptoKeys/*`.
         class Channel
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -78,11 +86,13 @@ module Google
             # event provider.
             ACTIVE = 2
 
-            # The INACTIVE state means that the Channel cannot receive events
+            # The INACTIVE state indicates that the Channel cannot receive events
             # permanently. There are two possible cases this state can happen:
+            #
             # 1. The SaaS provider disconnected from this Channel.
             # 2. The Channel activation token has expired but the SaaS provider
             #    wasn't connected.
+            #
             # To re-establish a Connection with a provider, the subscriber
             # should create a new Channel and give it to the provider.
             INACTIVE = 3

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

@@ -37,6 +37,7 @@ module Google
         # @!attribute [rw] page_size
         #   @return [::Integer]
         #     The maximum number of triggers to return on each page.
+        #
         #     Note: The service may send fewer.
         # @!attribute [rw] page_token
         #   @return [::String]
@@ -51,6 +52,11 @@ module Google
         #     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`.
+        # @!attribute [rw] filter
+        #   @return [::String]
+        #     Filter field. Used to filter the Triggers to be listed. Possible filters
+        #     are described in https://google.aip.dev/160. For example, using
+        #     "?filter=destination:gke" would list only Triggers with a gke destination.
         class ListTriggersRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -62,7 +68,7 @@ module Google
         #     The requested triggers, up to the number specified in `page_size`.
         # @!attribute [rw] next_page_token
         #   @return [::String]
-        #     A page token that can be sent to ListTriggers to request the next page.
+        #     A page token that can be sent to `ListTriggers` to request the next page.
         #     If this is empty, then there are no more pages.
         # @!attribute [rw] unreachable
         #   @return [::Array<::String>]
@@ -150,6 +156,7 @@ module Google
         # @!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]
@@ -175,7 +182,7 @@ module Google
         #     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.
+        #     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>]
@@ -278,7 +285,7 @@ module Google
         #     The requested providers, up to the number specified in `page_size`.
         # @!attribute [rw] next_page_token
         #   @return [::String]
-        #     A page token that can be sent to ListProviders to request the next page.
+        #     A page token that can be sent to `ListProviders` to request the next page.
         #     If this is empty, then there are no more pages.
         # @!attribute [rw] unreachable
         #   @return [::Array<::String>]
@@ -304,6 +311,7 @@ module Google
         # @!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]
@@ -324,7 +332,7 @@ module Google
         #     `page_size`.
         # @!attribute [rw] next_page_token
         #   @return [::String]
-        #     A page token that can be sent to ListChannelConnections to request the
+        #     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
@@ -359,6 +367,29 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
+        # The request message for the UpdateGoogleChannelConfig method.
+        # @!attribute [rw] google_channel_config
+        #   @return [::Google::Cloud::Eventarc::V1::GoogleChannelConfig]
+        #     Required. The config 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 "*".
+        class UpdateGoogleChannelConfigRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # The request message for the GetGoogleChannelConfig method.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. The name of the config to get.
+        class GetGoogleChannelConfigRequest
+          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/google_channel_config.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+# Copyright 2022 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Cloud
+    module Eventarc
+      module V1
+        # A GoogleChannelConfig is a resource that stores the custom settings
+        # respected by Eventarc first-party triggers in the matching region.
+        # Once configured, first-party event data will be protected
+        # using the specified custom managed encryption key instead of Google-managed
+        # encryption keys.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. The resource name of the config. Must be in the format of,
+        #     `projects/{project}/locations/{location}/googleChannelConfig`.
+        # @!attribute [r] update_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Output only. The last-modified time.
+        # @!attribute [rw] crypto_key_name
+        #   @return [::String]
+        #     Optional. Resource name of a KMS crypto key (managed by the user) used to
+        #     encrypt/decrypt their event data.
+        #
+        #     It must match the pattern
+        #     `projects/*/locations/*/keyRings/*/cryptoKeys/*`.
+        class GoogleChannelConfig
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+      end
+    end
+  end
+end

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

@@ -39,7 +39,7 @@ 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
+        #     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]
@@ -74,6 +74,9 @@ module Google
         #     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] conditions
+        #   @return [::Google::Protobuf::Map{::String => ::Google::Cloud::Eventarc::V1::StateCondition}]
+        #     Output only. The reason(s) why a trigger is in FAILED state.
         # @!attribute [r] etag
         #   @return [::String]
         #     Output only. This checksum is computed by the server based on the value of other
@@ -91,6 +94,15 @@ module Google
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
           end
+
+          # @!attribute [rw] key
+          #   @return [::String]
+          # @!attribute [rw] value
+          #   @return [::Google::Cloud::Eventarc::V1::StateCondition]
+          class ConditionsEntry
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
         end
 
         # Filters events based on exact matches on the CloudEvents attributes.
@@ -114,6 +126,18 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
+        # A condition that is part of the trigger state computation.
+        # @!attribute [rw] code
+        #   @return [::Google::Rpc::Code]
+        #     The canonical code of the condition.
+        # @!attribute [rw] message
+        #   @return [::String]
+        #     Human-readable message.
+        class StateCondition
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
         # Represents a target of an invocation over HTTP.
         # @!attribute [rw] cloud_run
         #   @return [::Google::Cloud::Eventarc::V1::CloudRun]
@@ -127,6 +151,12 @@ module Google
         #   @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.
+        # @!attribute [rw] workflow
+        #   @return [::String]
+        #     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}`
         class Destination
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/protobuf/empty.rb

@@ -26,8 +26,6 @@ module Google
     #     service Foo {
     #       rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
     #     }
-    #
-    # The JSON representation for `Empty` is empty JSON object `{}`.
     class Empty
       include ::Google::Protobuf::MessageExts
       extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/rpc/code.rb

@@ -0,0 +1,185 @@
+# frozen_string_literal: true
+
+# Copyright 2022 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Rpc
+    # The canonical error codes for gRPC APIs.
+    #
+    #
+    # Sometimes multiple error codes may apply.  Services should return
+    # the most specific error code that applies.  For example, prefer
+    # `OUT_OF_RANGE` over `FAILED_PRECONDITION` if both codes apply.
+    # Similarly prefer `NOT_FOUND` or `ALREADY_EXISTS` over `FAILED_PRECONDITION`.
+    module Code
+      # Not an error; returned on success.
+      #
+      # HTTP Mapping: 200 OK
+      OK = 0
+
+      # The operation was cancelled, typically by the caller.
+      #
+      # HTTP Mapping: 499 Client Closed Request
+      CANCELLED = 1
+
+      # Unknown error.  For example, this error may be returned when
+      # a `Status` value received from another address space belongs to
+      # an error space that is not known in this address space.  Also
+      # errors raised by APIs that do not return enough error information
+      # may be converted to this error.
+      #
+      # HTTP Mapping: 500 Internal Server Error
+      UNKNOWN = 2
+
+      # The client specified an invalid argument.  Note that this differs
+      # from `FAILED_PRECONDITION`.  `INVALID_ARGUMENT` indicates arguments
+      # that are problematic regardless of the state of the system
+      # (e.g., a malformed file name).
+      #
+      # HTTP Mapping: 400 Bad Request
+      INVALID_ARGUMENT = 3
+
+      # The deadline expired before the operation could complete. For operations
+      # that change the state of the system, this error may be returned
+      # even if the operation has completed successfully.  For example, a
+      # successful response from a server could have been delayed long
+      # enough for the deadline to expire.
+      #
+      # HTTP Mapping: 504 Gateway Timeout
+      DEADLINE_EXCEEDED = 4
+
+      # Some requested entity (e.g., file or directory) was not found.
+      #
+      # Note to server developers: if a request is denied for an entire class
+      # of users, such as gradual feature rollout or undocumented allowlist,
+      # `NOT_FOUND` may be used. If a request is denied for some users within
+      # a class of users, such as user-based access control, `PERMISSION_DENIED`
+      # must be used.
+      #
+      # HTTP Mapping: 404 Not Found
+      NOT_FOUND = 5
+
+      # The entity that a client attempted to create (e.g., file or directory)
+      # already exists.
+      #
+      # HTTP Mapping: 409 Conflict
+      ALREADY_EXISTS = 6
+
+      # The caller does not have permission to execute the specified
+      # operation. `PERMISSION_DENIED` must not be used for rejections
+      # caused by exhausting some resource (use `RESOURCE_EXHAUSTED`
+      # instead for those errors). `PERMISSION_DENIED` must not be
+      # used if the caller can not be identified (use `UNAUTHENTICATED`
+      # instead for those errors). This error code does not imply the
+      # request is valid or the requested entity exists or satisfies
+      # other pre-conditions.
+      #
+      # HTTP Mapping: 403 Forbidden
+      PERMISSION_DENIED = 7
+
+      # The request does not have valid authentication credentials for the
+      # operation.
+      #
+      # HTTP Mapping: 401 Unauthorized
+      UNAUTHENTICATED = 16
+
+      # Some resource has been exhausted, perhaps a per-user quota, or
+      # perhaps the entire file system is out of space.
+      #
+      # HTTP Mapping: 429 Too Many Requests
+      RESOURCE_EXHAUSTED = 8
+
+      # The operation was rejected because the system is not in a state
+      # required for the operation's execution.  For example, the directory
+      # to be deleted is non-empty, an rmdir operation is applied to
+      # a non-directory, etc.
+      #
+      # Service implementors can use the following guidelines to decide
+      # between `FAILED_PRECONDITION`, `ABORTED`, and `UNAVAILABLE`:
+      #  (a) Use `UNAVAILABLE` if the client can retry just the failing call.
+      #  (b) Use `ABORTED` if the client should retry at a higher level. For
+      #      example, when a client-specified test-and-set fails, indicating the
+      #      client should restart a read-modify-write sequence.
+      #  (c) Use `FAILED_PRECONDITION` if the client should not retry until
+      #      the system state has been explicitly fixed. For example, if an "rmdir"
+      #      fails because the directory is non-empty, `FAILED_PRECONDITION`
+      #      should be returned since the client should not retry unless
+      #      the files are deleted from the directory.
+      #
+      # HTTP Mapping: 400 Bad Request
+      FAILED_PRECONDITION = 9
+
+      # The operation was aborted, typically due to a concurrency issue such as
+      # a sequencer check failure or transaction abort.
+      #
+      # See the guidelines above for deciding between `FAILED_PRECONDITION`,
+      # `ABORTED`, and `UNAVAILABLE`.
+      #
+      # HTTP Mapping: 409 Conflict
+      ABORTED = 10
+
+      # The operation was attempted past the valid range.  E.g., seeking or
+      # reading past end-of-file.
+      #
+      # Unlike `INVALID_ARGUMENT`, this error indicates a problem that may
+      # be fixed if the system state changes. For example, a 32-bit file
+      # system will generate `INVALID_ARGUMENT` if asked to read at an
+      # offset that is not in the range [0,2^32-1], but it will generate
+      # `OUT_OF_RANGE` if asked to read from an offset past the current
+      # file size.
+      #
+      # There is a fair bit of overlap between `FAILED_PRECONDITION` and
+      # `OUT_OF_RANGE`.  We recommend using `OUT_OF_RANGE` (the more specific
+      # error) when it applies so that callers who are iterating through
+      # a space can easily look for an `OUT_OF_RANGE` error to detect when
+      # they are done.
+      #
+      # HTTP Mapping: 400 Bad Request
+      OUT_OF_RANGE = 11
+
+      # The operation is not implemented or is not supported/enabled in this
+      # service.
+      #
+      # HTTP Mapping: 501 Not Implemented
+      UNIMPLEMENTED = 12
+
+      # Internal errors.  This means that some invariants expected by the
+      # underlying system have been broken.  This error code is reserved
+      # for serious errors.
+      #
+      # HTTP Mapping: 500 Internal Server Error
+      INTERNAL = 13
+
+      # The service is currently unavailable.  This is most likely a
+      # transient condition, which can be corrected by retrying with
+      # a backoff. Note that it is not always safe to retry
+      # non-idempotent operations.
+      #
+      # See the guidelines above for deciding between `FAILED_PRECONDITION`,
+      # `ABORTED`, and `UNAVAILABLE`.
+      #
+      # HTTP Mapping: 503 Service Unavailable
+      UNAVAILABLE = 14
+
+      # Unrecoverable data loss or corruption.
+      #
+      # HTTP Mapping: 500 Internal Server Error
+      DATA_LOSS = 15
+    end
+  end
+end

data/proto_docs/google/rpc/status.rb

@@ -28,12 +28,14 @@ module Google
     # [API Design Guide](https://cloud.google.com/apis/design/errors).
     # @!attribute [rw] code
     #   @return [::Integer]
-    #     The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code].
+    #     The status code, which should be an enum value of
+    #     {::Google::Rpc::Code google.rpc.Code}.
     # @!attribute [rw] message
     #   @return [::String]
     #     A developer-facing error message, which should be in English. Any
     #     user-facing error message should be localized and sent in the
-    #     {::Google::Rpc::Status#details google.rpc.Status.details} field, or localized by the client.
+    #     {::Google::Rpc::Status#details google.rpc.Status.details} field, or localized
+    #     by the client.
     # @!attribute [rw] details
     #   @return [::Array<::Google::Protobuf::Any>]
     #     A list of messages that carry the error details.  There is a common set of

data/proto_docs/google/type/expr.rb

@@ -0,0 +1,75 @@
+# frozen_string_literal: true
+
+# Copyright 2022 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Type
+    # Represents a textual expression in the Common Expression Language (CEL)
+    # syntax. CEL is a C-like expression language. The syntax and semantics of CEL
+    # are documented at https://github.com/google/cel-spec.
+    #
+    # Example (Comparison):
+    #
+    #     title: "Summary size limit"
+    #     description: "Determines if a summary is less than 100 chars"
+    #     expression: "document.summary.size() < 100"
+    #
+    # Example (Equality):
+    #
+    #     title: "Requestor is owner"
+    #     description: "Determines if requestor is the document owner"
+    #     expression: "document.owner == request.auth.claims.email"
+    #
+    # Example (Logic):
+    #
+    #     title: "Public documents"
+    #     description: "Determine whether the document should be publicly visible"
+    #     expression: "document.type != 'private' && document.type != 'internal'"
+    #
+    # Example (Data Manipulation):
+    #
+    #     title: "Notification string"
+    #     description: "Create a notification string with a timestamp."
+    #     expression: "'New message received at ' + string(document.create_time)"
+    #
+    # The exact variables and functions that may be referenced within an expression
+    # are determined by the service that evaluates it. See the service
+    # documentation for additional information.
+    # @!attribute [rw] expression
+    #   @return [::String]
+    #     Textual representation of an expression in Common Expression Language
+    #     syntax.
+    # @!attribute [rw] title
+    #   @return [::String]
+    #     Optional. Title for the expression, i.e. a short string describing
+    #     its purpose. This can be used e.g. in UIs which allow to enter the
+    #     expression.
+    # @!attribute [rw] description
+    #   @return [::String]
+    #     Optional. Description of the expression. This is a longer text which
+    #     describes the expression, e.g. when hovered over it in a UI.
+    # @!attribute [rw] location
+    #   @return [::String]
+    #     Optional. String indicating the location of the expression for error
+    #     reporting, e.g. a file name and a position in the file.
+    class Expr
+      include ::Google::Protobuf::MessageExts
+      extend ::Google::Protobuf::MessageExts::ClassMethods
+    end
+  end
+end