google-cloud-notebooks-v1beta1 0.5.0 → 0.6.1

data/proto_docs/google/api/launch_stage.rb

@@ -0,0 +1,71 @@
+# 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 Api
+    # The launch stage as defined by [Google Cloud Platform
+    # Launch Stages](https://cloud.google.com/terms/launch-stages).
+    module LaunchStage
+      # Do not use this default value.
+      LAUNCH_STAGE_UNSPECIFIED = 0
+
+      # The feature is not yet implemented. Users can not use it.
+      UNIMPLEMENTED = 6
+
+      # Prelaunch features are hidden from users and are only visible internally.
+      PRELAUNCH = 7
+
+      # Early Access features are limited to a closed group of testers. To use
+      # these features, you must sign up in advance and sign a Trusted Tester
+      # agreement (which includes confidentiality provisions). These features may
+      # be unstable, changed in backward-incompatible ways, and are not
+      # guaranteed to be released.
+      EARLY_ACCESS = 1
+
+      # Alpha is a limited availability test for releases before they are cleared
+      # for widespread use. By Alpha, all significant design issues are resolved
+      # and we are in the process of verifying functionality. Alpha customers
+      # need to apply for access, agree to applicable terms, and have their
+      # projects allowlisted. Alpha releases don't have to be feature complete,
+      # no SLAs are provided, and there are no technical support obligations, but
+      # they will be far enough along that customers can actually use them in
+      # test environments or for limited-use tests -- just like they would in
+      # normal production cases.
+      ALPHA = 2
+
+      # Beta is the point at which we are ready to open a release for any
+      # customer to use. There are no SLA or technical support obligations in a
+      # Beta release. Products will be complete from a feature perspective, but
+      # may have some open outstanding issues. Beta releases are suitable for
+      # limited production use cases.
+      BETA = 3
+
+      # GA features are open to all developers and are considered stable and
+      # fully qualified for production use.
+      GA = 4
+
+      # Deprecated features are scheduled to be shut down and removed. For more
+      # information, see the "Deprecation Policy" section of our [Terms of
+      # Service](https://cloud.google.com/terms/)
+      # and the [Google Cloud Platform Subject to the Deprecation
+      # Policy](https://cloud.google.com/terms/deprecation) documentation.
+      DEPRECATED = 5
+    end
+  end
+end

data/proto_docs/google/cloud/notebooks/v1beta1/instance.rb

@@ -21,6 +21,37 @@ module Google
   module Cloud
     module Notebooks
       module V1beta1
+        # Reservation Affinity for consuming Zonal reservation.
+        # @!attribute [rw] consume_reservation_type
+        #   @return [::Google::Cloud::Notebooks::V1beta1::ReservationAffinity::Type]
+        #     Optional. Type of reservation to consume
+        # @!attribute [rw] key
+        #   @return [::String]
+        #     Optional. Corresponds to the label key of reservation resource.
+        # @!attribute [rw] values
+        #   @return [::Array<::String>]
+        #     Optional. Corresponds to the label values of reservation resource.
+        class ReservationAffinity
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # Indicates whether to consume capacity from an reservation or not.
+          module Type
+            # Default type.
+            TYPE_UNSPECIFIED = 0
+
+            # Do not consume from any allocated capacity.
+            NO_RESERVATION = 1
+
+            # Consume any reservation available.
+            ANY_RESERVATION = 2
+
+            # Must consume from a specific reservation. Must specify key value fields
+            # for specifying the reservations.
+            SPECIFIC_RESERVATION = 3
+          end
+        end
+
         # The definition of a notebook instance.
         # @!attribute [r] name
         #   @return [::String]
@@ -39,12 +70,10 @@ module Google
         #     Cloud Storage path (`gs://path-to-file/file-name`).
         # @!attribute [r] proxy_uri
         #   @return [::String]
-        #     Output only. The proxy endpoint that is used to access the Jupyter
-        #     notebook.
+        #     Output only. The proxy endpoint that is used to access the Jupyter notebook.
         # @!attribute [rw] instance_owners
         #   @return [::Array<::String>]
-        #     Input only. The owner of this instance after creation. Format:
-        #     `alias@example.com`
+        #     Input only. The owner of this instance after creation. Format: `alias@example.com`
         #
         #     Currently supports one owner only. If not specified, all of the service
         #     account users of your VM instance's service account can use
@@ -68,8 +97,8 @@ module Google
         #   @return [::Google::Cloud::Notebooks::V1beta1::Instance::AcceleratorConfig]
         #     The hardware accelerator used on this instance. If you use
         #     accelerators, make sure that your configuration has
-        #     [enough vCPUs and memory to support the `machine_type` you
-        #     have selected](https://cloud.google.com/compute/docs/gpus/#gpus-list).
+        #     [enough vCPUs and memory to support the `machine_type` you have
+        #     selected](https://cloud.google.com/compute/docs/gpus/#gpus-list).
         # @!attribute [r] state
         #   @return [::Google::Cloud::Notebooks::V1beta1::Instance::State]
         #     Output only. The state of this instance.
@@ -85,39 +114,37 @@ module Google
         #     If not specified, we'll automatically choose from official GPU drivers.
         # @!attribute [rw] boot_disk_type
         #   @return [::Google::Cloud::Notebooks::V1beta1::Instance::DiskType]
-        #     Input only. The type of the boot disk attached to this instance, defaults
-        #     to standard persistent disk (`PD_STANDARD`).
+        #     Input only. The type of the boot disk attached to this instance, defaults to
+        #     standard persistent disk (`PD_STANDARD`).
         # @!attribute [rw] boot_disk_size_gb
         #   @return [::Integer]
-        #     Input only. The size of the boot disk in GB attached to this instance, up
-        #     to a maximum of 64000&nbsp;GB (64&nbsp;TB). The minimum recommended value
-        #     is 100&nbsp;GB. If not specified, this defaults to 100.
+        #     Input only. The size of the boot disk in GB attached to this instance, up to a maximum
+        #     of 64000 GB (64 TB). The minimum recommended value is 100 GB. If not
+        #     specified, this defaults to 100.
         # @!attribute [rw] data_disk_type
         #   @return [::Google::Cloud::Notebooks::V1beta1::Instance::DiskType]
-        #     Input only. The type of the data disk attached to this instance, defaults
-        #     to standard persistent disk (`PD_STANDARD`).
+        #     Input only. The type of the data disk attached to this instance, defaults to
+        #     standard persistent disk (`PD_STANDARD`).
         # @!attribute [rw] data_disk_size_gb
         #   @return [::Integer]
-        #     Input only. The size of the data disk in GB attached to this instance, up
-        #     to a maximum of 64000&nbsp;GB (64&nbsp;TB). You can choose the size of the
-        #     data disk based on how big your notebooks and data are. If not specified,
-        #     this defaults to 100.
+        #     Input only. The size of the data disk in GB attached to this instance, up to a maximum
+        #     of 64000 GB (64 TB). You can choose the size of the data disk based on how
+        #     big your notebooks and data are. If not specified, this defaults to 100.
         # @!attribute [rw] no_remove_data_disk
         #   @return [::Boolean]
-        #     Input only. If true, the data disk will not be auto deleted when deleting
-        #     the instance.
+        #     Input only. If true, the data disk will not be auto deleted when deleting the instance.
         # @!attribute [rw] disk_encryption
         #   @return [::Google::Cloud::Notebooks::V1beta1::Instance::DiskEncryption]
-        #     Input only. Disk encryption method used on the boot and data disks,
-        #     defaults to GMEK.
+        #     Input only. Disk encryption method used on the boot and data disks, defaults to GMEK.
         # @!attribute [rw] kms_key
         #   @return [::String]
-        #     Input only. The KMS key used to encrypt the disks, only applicable if
-        #     disk_encryption is CMEK. Format:
+        #     Input only. The KMS key used to encrypt the disks, only applicable if disk_encryption
+        #     is CMEK.
+        #     Format:
         #     `projects/{project_id}/locations/{location}/keyRings/{key_ring_id}/cryptoKeys/{key_id}`
         #
-        #     Learn more about [using your own encryption keys](
-        #     https://cloud.google.com/kms/docs/quickstart).
+        #     Learn more about [using your own encryption
+        #     keys](https://cloud.google.com/kms/docs/quickstart).
         # @!attribute [rw] no_public_ip
         #   @return [::Boolean]
         #     If true, no public IP will be assigned to this instance.
@@ -141,6 +168,20 @@ module Google
         # @!attribute [rw] metadata
         #   @return [::Google::Protobuf::Map{::String => ::String}]
         #     Custom metadata to apply to this instance.
+        # @!attribute [rw] nic_type
+        #   @return [::Google::Cloud::Notebooks::V1beta1::Instance::NicType]
+        #     Optional. The type of vNIC to be used on this interface. This may be gVNIC or
+        #     VirtioNet.
+        # @!attribute [rw] reservation_affinity
+        #   @return [::Google::Cloud::Notebooks::V1beta1::ReservationAffinity]
+        #     Optional. The optional reservation affinity. Setting this field will apply
+        #     the specified [Zonal Compute
+        #     Reservation](https://cloud.google.com/compute/docs/instances/reserving-zonal-resources)
+        #     to this notebook instance.
+        # @!attribute [rw] can_ip_forward
+        #   @return [::Boolean]
+        #     Optional. Flag to enable ip forwarding or not, default false/off.
+        #     https://cloud.google.com/vpc/docs/using-routes#canipforward
         # @!attribute [r] create_time
         #   @return [::Google::Protobuf::Timestamp]
         #     Output only. Instance creation time.
@@ -152,9 +193,9 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
 
           # Definition of a hardware accelerator. Note that not all combinations
-          # of `type` and `core_count` are valid. Check [GPUs on
-          # Compute Engine](/compute/docs/gpus/#gpus-list) to find a valid
-          # combination. TPUs are not supported.
+          # of `type` and `core_count` are valid. Check [GPUs on Compute
+          # Engine](https://cloud.google.com/compute/docs/gpus/#gpus-list) to find a
+          # valid combination. TPUs are not supported.
           # @!attribute [rw] type
           #   @return [::Google::Cloud::Notebooks::V1beta1::Instance::AcceleratorType]
           #     Type of this accelerator.
@@ -199,7 +240,7 @@ module Google
             # Accelerator type is Nvidia Tesla V100.
             NVIDIA_TESLA_V100 = 3
 
-            # Accelerator type is Nvidia Tesla P_4.
+            # Accelerator type is Nvidia Tesla P4.
             NVIDIA_TESLA_P4 = 4
 
             # Accelerator type is Nvidia Tesla T4.
@@ -211,7 +252,7 @@ module Google
             # Accelerator type is NVIDIA Tesla P100 Virtual Workstations.
             NVIDIA_TESLA_P100_VWS = 9
 
-            # Accelerator type is NVIDIA Tesla P_4 Virtual Workstations.
+            # Accelerator type is NVIDIA Tesla P4 Virtual Workstations.
             NVIDIA_TESLA_P4_VWS = 10
 
             # (Coming soon) Accelerator type is TPU V2.
@@ -253,6 +294,12 @@ module Google
 
             # The instance is getting registered.
             REGISTERING = 9
+
+            # The instance is suspending.
+            SUSPENDING = 10
+
+            # The instance is suspended.
+            SUSPENDED = 11
           end
 
           # Possible disk types for notebook instances.
@@ -281,6 +328,19 @@ module Google
             # Use customer managed encryption keys to encrypt the boot disk.
             CMEK = 2
           end
+
+          # The type of vNIC driver.
+          module NicType
+            # No type specified. Default should be UNSPECIFIED_NIC_TYPE.
+            UNSPECIFIED_NIC_TYPE = 0
+
+            # VIRTIO. Default in Notebooks DLVM.
+            VIRTIO_NET = 1
+
+            # GVNIC. Alternative to VIRTIO.
+            # https://github.com/GoogleCloudPlatform/compute-virtual-ethernet-linux
+            GVNIC = 2
+          end
         end
       end
     end

data/proto_docs/google/cloud/notebooks/v1beta1/service.rb

@@ -42,8 +42,7 @@ module Google
         #     Identifies whether the user has requested cancellation
         #     of the operation. Operations that have successfully been cancelled
         #     have [Operation.error][] value with a
-        #     {::Google::Rpc::Status#code google.rpc.Status.code} of 1, corresponding to
-        #     `Code.CANCELLED`.
+        #     {::Google::Rpc::Status#code google.rpc.Status.code} of 1, corresponding to `Code.CANCELLED`.
         # @!attribute [rw] api_version
         #   @return [::String]
         #     API version used to start the operation.
@@ -83,7 +82,7 @@ module Google
         # @!attribute [rw] unreachable
         #   @return [::Array<::String>]
         #     Locations that could not be reached. For example,
-        #     ['us-west1-a', 'us-central1-b'].
+        #     `['us-west1-a', 'us-central1-b']`.
         #     A ListInstancesResponse will only contain either instances or unreachables,
         class ListInstancesResponse
           include ::Google::Protobuf::MessageExts
@@ -142,10 +141,10 @@ module Google
         #     Required. Type of this accelerator.
         # @!attribute [rw] core_count
         #   @return [::Integer]
-        #     Required. Count of cores of this accelerator. Note that not all
-        #     combinations of `type` and `core_count` are valid. Check [GPUs on Compute
-        #     Engine](https://cloud.google.com/compute/docs/gpus/#gpus-list) to find a
-        #     valid combination. TPUs are not supported.
+        #     Required. Count of cores of this accelerator. Note that not all combinations
+        #     of `type` and `core_count` are valid. Check [GPUs on
+        #     Compute Engine](https://cloud.google.com/compute/docs/gpus/#gpus-list) to
+        #     find a valid combination. TPUs are not supported.
         class SetInstanceAcceleratorRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -276,6 +275,11 @@ module Google
         # @!attribute [rw] upgrade_info
         #   @return [::String]
         #     Additional information about upgrade.
+        # @!attribute [rw] upgrade_image
+        #   @return [::String]
+        #     The new image self link this instance will be upgraded to if calling the
+        #     upgrade endpoint. This field will only be populated if field upgradeable
+        #     is true.
         class IsInstanceUpgradeableResponse
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -353,10 +357,10 @@ module Google
         #     Required. Format: `projects/{project_id}/locations/{location}`
         # @!attribute [rw] environment_id
         #   @return [::String]
-        #     Required. User-defined unique ID of this environment. The `environment_id`
-        #     must be 1 to 63 characters long and contain only lowercase letters, numeric
-        #     characters, and dashes. The first character must be a lowercase letter and
-        #     the last character cannot be a dash.
+        #     Required. User-defined unique ID of this environment. The `environment_id` must
+        #     be 1 to 63 characters long and contain only lowercase letters,
+        #     numeric characters, and dashes. The first character must be a lowercase
+        #     letter and the last character cannot be a dash.
         # @!attribute [rw] environment
         #   @return [::Google::Cloud::Notebooks::V1beta1::Environment]
         #     Required. The environment to be created.

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/protobuf/field_mask.rb

@@ -0,0 +1,229 @@
+# 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 Protobuf
+    # `FieldMask` represents a set of symbolic field paths, for example:
+    #
+    #     paths: "f.a"
+    #     paths: "f.b.d"
+    #
+    # Here `f` represents a field in some root message, `a` and `b`
+    # fields in the message found in `f`, and `d` a field found in the
+    # message in `f.b`.
+    #
+    # Field masks are used to specify a subset of fields that should be
+    # returned by a get operation or modified by an update operation.
+    # Field masks also have a custom JSON encoding (see below).
+    #
+    # # Field Masks in Projections
+    #
+    # When used in the context of a projection, a response message or
+    # sub-message is filtered by the API to only contain those fields as
+    # specified in the mask. For example, if the mask in the previous
+    # example is applied to a response message as follows:
+    #
+    #     f {
+    #       a : 22
+    #       b {
+    #         d : 1
+    #         x : 2
+    #       }
+    #       y : 13
+    #     }
+    #     z: 8
+    #
+    # The result will not contain specific values for fields x,y and z
+    # (their value will be set to the default, and omitted in proto text
+    # output):
+    #
+    #
+    #     f {
+    #       a : 22
+    #       b {
+    #         d : 1
+    #       }
+    #     }
+    #
+    # A repeated field is not allowed except at the last position of a
+    # paths string.
+    #
+    # If a FieldMask object is not present in a get operation, the
+    # operation applies to all fields (as if a FieldMask of all fields
+    # had been specified).
+    #
+    # Note that a field mask does not necessarily apply to the
+    # top-level response message. In case of a REST get operation, the
+    # field mask applies directly to the response, but in case of a REST
+    # list operation, the mask instead applies to each individual message
+    # in the returned resource list. In case of a REST custom method,
+    # other definitions may be used. Where the mask applies will be
+    # clearly documented together with its declaration in the API.  In
+    # any case, the effect on the returned resource/resources is required
+    # behavior for APIs.
+    #
+    # # Field Masks in Update Operations
+    #
+    # A field mask in update operations specifies which fields of the
+    # targeted resource are going to be updated. The API is required
+    # to only change the values of the fields as specified in the mask
+    # and leave the others untouched. If a resource is passed in to
+    # describe the updated values, the API ignores the values of all
+    # fields not covered by the mask.
+    #
+    # If a repeated field is specified for an update operation, new values will
+    # be appended to the existing repeated field in the target resource. Note that
+    # a repeated field is only allowed in the last position of a `paths` string.
+    #
+    # If a sub-message is specified in the last position of the field mask for an
+    # update operation, then new value will be merged into the existing sub-message
+    # in the target resource.
+    #
+    # For example, given the target message:
+    #
+    #     f {
+    #       b {
+    #         d: 1
+    #         x: 2
+    #       }
+    #       c: [1]
+    #     }
+    #
+    # And an update message:
+    #
+    #     f {
+    #       b {
+    #         d: 10
+    #       }
+    #       c: [2]
+    #     }
+    #
+    # then if the field mask is:
+    #
+    #  paths: ["f.b", "f.c"]
+    #
+    # then the result will be:
+    #
+    #     f {
+    #       b {
+    #         d: 10
+    #         x: 2
+    #       }
+    #       c: [1, 2]
+    #     }
+    #
+    # An implementation may provide options to override this default behavior for
+    # repeated and message fields.
+    #
+    # In order to reset a field's value to the default, the field must
+    # be in the mask and set to the default value in the provided resource.
+    # Hence, in order to reset all fields of a resource, provide a default
+    # instance of the resource and set all fields in the mask, or do
+    # not provide a mask as described below.
+    #
+    # If a field mask is not present on update, the operation applies to
+    # all fields (as if a field mask of all fields has been specified).
+    # Note that in the presence of schema evolution, this may mean that
+    # fields the client does not know and has therefore not filled into
+    # the request will be reset to their default. If this is unwanted
+    # behavior, a specific service may require a client to always specify
+    # a field mask, producing an error if not.
+    #
+    # As with get operations, the location of the resource which
+    # describes the updated values in the request message depends on the
+    # operation kind. In any case, the effect of the field mask is
+    # required to be honored by the API.
+    #
+    # ## Considerations for HTTP REST
+    #
+    # The HTTP kind of an update operation which uses a field mask must
+    # be set to PATCH instead of PUT in order to satisfy HTTP semantics
+    # (PUT must only be used for full updates).
+    #
+    # # JSON Encoding of Field Masks
+    #
+    # In JSON, a field mask is encoded as a single string where paths are
+    # separated by a comma. Fields name in each path are converted
+    # to/from lower-camel naming conventions.
+    #
+    # As an example, consider the following message declarations:
+    #
+    #     message Profile {
+    #       User user = 1;
+    #       Photo photo = 2;
+    #     }
+    #     message User {
+    #       string display_name = 1;
+    #       string address = 2;
+    #     }
+    #
+    # In proto a field mask for `Profile` may look as such:
+    #
+    #     mask {
+    #       paths: "user.display_name"
+    #       paths: "photo"
+    #     }
+    #
+    # In JSON, the same mask is represented as below:
+    #
+    #     {
+    #       mask: "user.displayName,photo"
+    #     }
+    #
+    # # Field Masks and Oneof Fields
+    #
+    # Field masks treat fields in oneofs just as regular fields. Consider the
+    # following message:
+    #
+    #     message SampleMessage {
+    #       oneof test_oneof {
+    #         string name = 4;
+    #         SubMessage sub_message = 9;
+    #       }
+    #     }
+    #
+    # The field mask can be:
+    #
+    #     mask {
+    #       paths: "name"
+    #     }
+    #
+    # Or:
+    #
+    #     mask {
+    #       paths: "sub_message"
+    #     }
+    #
+    # Note that oneof type names ("test_oneof" in this case) cannot be used in
+    # paths.
+    #
+    # ## Field Mask Verification
+    #
+    # The implementation of any API method which has a FieldMask type field in the
+    # request should verify the included field paths, and return an
+    # `INVALID_ARGUMENT` error if any path is unmappable.
+    # @!attribute [rw] paths
+    #   @return [::Array<::String>]
+    #     The set of field mask paths.
+    class FieldMask
+      include ::Google::Protobuf::MessageExts
+      extend ::Google::Protobuf::MessageExts::ClassMethods
+    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