google-cloud-network_connectivity-v1 0.6.1 → 0.8.0

data/proto_docs/google/cloud/networkconnectivity/v1/policy_based_routing.rb

@@ -0,0 +1,312 @@
+# frozen_string_literal: true
+
+# Copyright 2023 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 NetworkConnectivity
+      module V1
+        # Policy Based Routes (PBR) are more powerful routes that allows GCP customers
+        # to route their L4 network traffic based on not just destination IP, but also
+        # source IP, protocol and more. A PBR always take precedence when it conflicts
+        # with other types of routes.
+        # Next id: 22
+        # @!attribute [rw] virtual_machine
+        #   @return [::Google::Cloud::NetworkConnectivity::V1::PolicyBasedRoute::VirtualMachine]
+        #     Optional. VM instances to which this policy based route applies to.
+        # @!attribute [rw] interconnect_attachment
+        #   @return [::Google::Cloud::NetworkConnectivity::V1::PolicyBasedRoute::InterconnectAttachment]
+        #     Optional. The interconnect attachments to which this route applies to.
+        # @!attribute [rw] next_hop_ilb_ip
+        #   @return [::String]
+        #     Optional. The IP of a global access enabled L4 ILB that should be the
+        #     next hop to handle matching packets. For this version, only
+        #     next_hop_ilb_ip is supported.
+        # @!attribute [rw] next_hop_other_routes
+        #   @return [::Google::Cloud::NetworkConnectivity::V1::PolicyBasedRoute::OtherRoutes]
+        #     Optional. Other routes that will be referenced to determine the next hop
+        #     of the packet.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Immutable. A unique name of the resource in the form of
+        #     `projects/{project_number}/locations/global/PolicyBasedRoutes/{policy_based_route_id}`
+        # @!attribute [r] create_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Output only. Time when the PolicyBasedRoute was created.
+        # @!attribute [r] update_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Output only. Time when the PolicyBasedRoute was updated.
+        # @!attribute [rw] labels
+        #   @return [::Google::Protobuf::Map{::String => ::String}]
+        #     User-defined labels.
+        # @!attribute [rw] description
+        #   @return [::String]
+        #     Optional. An optional description of this resource. Provide this field when
+        #     you create the resource.
+        # @!attribute [rw] network
+        #   @return [::String]
+        #     Required. Fully-qualified URL of the network that this route applies to.
+        #     e.g. projects/my-project/global/networks/my-network.
+        # @!attribute [rw] filter
+        #   @return [::Google::Cloud::NetworkConnectivity::V1::PolicyBasedRoute::Filter]
+        #     Required. The filter to match L4 traffic.
+        # @!attribute [rw] priority
+        #   @return [::Integer]
+        #     Optional. The priority of this policy based route. Priority is used to
+        #     break ties in cases where there are more than one matching policy based
+        #     routes found. In cases where multiple policy based routes are matched, the
+        #     one with the lowest-numbered priority value wins. The default value is
+        #     1000. The priority value must be from 1 to 65535, inclusive.
+        # @!attribute [r] warnings
+        #   @return [::Array<::Google::Cloud::NetworkConnectivity::V1::PolicyBasedRoute::Warnings>]
+        #     Output only. If potential misconfigurations are detected for this route,
+        #     this field will be populated with warning messages.
+        # @!attribute [r] self_link
+        #   @return [::String]
+        #     Output only. Server-defined fully-qualified URL for this resource.
+        # @!attribute [r] kind
+        #   @return [::String]
+        #     Output only. Type of this resource. Always
+        #     networkconnectivity#policyBasedRoute for Policy Based Route resources.
+        class PolicyBasedRoute
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # VM instances to which this policy based route applies to.
+          # @!attribute [rw] tags
+          #   @return [::Array<::String>]
+          #     Optional. A list of VM instance tags to which this policy based route
+          #     applies to. VM instances that have ANY of tags specified here will
+          #     install this PBR.
+          class VirtualMachine
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # InterconnectAttachment to which this route applies to.
+          # @!attribute [rw] region
+          #   @return [::String]
+          #     Optional. Cloud region to install this policy based route on interconnect
+          #     attachment. Use `all` to install it on all interconnect attachments.
+          class InterconnectAttachment
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # Filter matches L4 traffic.
+          # @!attribute [rw] ip_protocol
+          #   @return [::String]
+          #     Optional. The IP protocol that this policy based route applies to. Valid
+          #     values are 'TCP', 'UDP', and 'ALL'. Default is 'ALL'.
+          # @!attribute [rw] src_range
+          #   @return [::String]
+          #     Optional. The source IP range of outgoing packets that this policy based
+          #     route applies to. Default is "0.0.0.0/0" if protocol version is IPv4.
+          # @!attribute [rw] dest_range
+          #   @return [::String]
+          #     Optional. The destination IP range of outgoing packets that this policy
+          #     based route applies to. Default is "0.0.0.0/0" if protocol version is
+          #     IPv4.
+          # @!attribute [rw] protocol_version
+          #   @return [::Google::Cloud::NetworkConnectivity::V1::PolicyBasedRoute::Filter::ProtocolVersion]
+          #     Required. Internet protocol versions this policy based route applies to.
+          #     For this version, only IPV4 is supported.
+          class Filter
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+
+            # The internet protocol version.
+            module ProtocolVersion
+              # Default value.
+              PROTOCOL_VERSION_UNSPECIFIED = 0
+
+              # The PBR is for IPv4 internet protocol traffic.
+              IPV4 = 1
+            end
+          end
+
+          # Informational warning message.
+          # @!attribute [r] code
+          #   @return [::Google::Cloud::NetworkConnectivity::V1::PolicyBasedRoute::Warnings::Code]
+          #     Output only. A warning code, if applicable.
+          # @!attribute [r] data
+          #   @return [::Google::Protobuf::Map{::String => ::String}]
+          #     Output only. Metadata about this warning in key: value format. The key
+          #     should provides more detail on the warning being returned. For example,
+          #     for warnings where there are no results in a list request for a
+          #     particular zone, this key might be scope and the key value might be the
+          #     zone name. Other examples might be a key indicating a deprecated resource
+          #     and a suggested replacement.
+          # @!attribute [r] warning_message
+          #   @return [::String]
+          #     Output only. A human-readable description of the warning code.
+          class Warnings
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+
+            # @!attribute [rw] key
+            #   @return [::String]
+            # @!attribute [rw] value
+            #   @return [::String]
+            class DataEntry
+              include ::Google::Protobuf::MessageExts
+              extend ::Google::Protobuf::MessageExts::ClassMethods
+            end
+
+            # Warning code for Policy Based Routing. Expect to add values in the
+            # future.
+            module Code
+              # Default value.
+              WARNING_UNSPECIFIED = 0
+
+              # The policy based route is not active and functioning. Common causes are
+              # the dependent network was deleted or the resource project was turned
+              # off.
+              RESOURCE_NOT_ACTIVE = 1
+
+              # The policy based route is being modified (e.g. created/deleted) at this
+              # time.
+              RESOURCE_BEING_MODIFIED = 2
+            end
+          end
+
+          # @!attribute [rw] key
+          #   @return [::String]
+          # @!attribute [rw] value
+          #   @return [::String]
+          class LabelsEntry
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # The other routing cases.
+          module OtherRoutes
+            # Default value.
+            OTHER_ROUTES_UNSPECIFIED = 0
+
+            # Use the routes from the default routing tables (system-generated routes,
+            # custom routes, peering route) to determine the next hop. This will
+            # effectively exclude matching packets being applied on other PBRs with a
+            # lower priority.
+            DEFAULT_ROUTING = 1
+          end
+        end
+
+        # Request for [PolicyBasedRouting.ListPolicyBasedRoutes][] method.
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. The parent resource's name.
+        # @!attribute [rw] page_size
+        #   @return [::Integer]
+        #     The maximum number of results per page that should be returned.
+        # @!attribute [rw] page_token
+        #   @return [::String]
+        #     The page token.
+        # @!attribute [rw] filter
+        #   @return [::String]
+        #     A filter expression that filters the results listed in the response.
+        # @!attribute [rw] order_by
+        #   @return [::String]
+        #     Sort the results by a certain order.
+        class ListPolicyBasedRoutesRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Response for [PolicyBasedRouting.ListPolicyBasedRoutes][] method.
+        # @!attribute [rw] policy_based_routes
+        #   @return [::Array<::Google::Cloud::NetworkConnectivity::V1::PolicyBasedRoute>]
+        #     Policy based routes to be returned.
+        # @!attribute [rw] next_page_token
+        #   @return [::String]
+        #     The next pagination token in the List response. It should be used as
+        #     page_token for the following request. An empty value means no more result.
+        # @!attribute [rw] unreachable
+        #   @return [::Array<::String>]
+        #     Locations that could not be reached.
+        class ListPolicyBasedRoutesResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request for [PolicyBasedRouting.GetPolicyBasedRoute][] method.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. Name of the PolicyBasedRoute resource to get.
+        class GetPolicyBasedRouteRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request for [PolicyBasedRouting.CreatePolicyBasedRoute][] method.
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. The parent resource's name of the PolicyBasedRoute.
+        # @!attribute [rw] policy_based_route_id
+        #   @return [::String]
+        #     Required. Unique id for the Policy Based Route to create.
+        # @!attribute [rw] policy_based_route
+        #   @return [::Google::Cloud::NetworkConnectivity::V1::PolicyBasedRoute]
+        #     Required. Initial values for a new Policy Based Route.
+        # @!attribute [rw] request_id
+        #   @return [::String]
+        #     Optional. An optional request ID to identify requests. Specify a unique
+        #     request ID so that if you must retry your request, the server will know to
+        #     ignore the request if it has already been completed. The server will
+        #     guarantee that for at least 60 minutes since the first request.
+        #
+        #     For example, consider a situation where you make an initial request and
+        #     the request times out. If you make the request again with the same request
+        #     ID, the server can check if original operation with the same request ID
+        #     was received, and if so, will ignore the second request. This prevents
+        #     clients from accidentally creating duplicate commitments.
+        #
+        #     The request ID must be a valid UUID with the exception that zero UUID is
+        #     not supported (00000000-0000-0000-0000-000000000000).
+        class CreatePolicyBasedRouteRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request for [PolicyBasedRouting.DeletePolicyBasedRoute][] method.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. Name of the PolicyBasedRoute resource to delete.
+        # @!attribute [rw] request_id
+        #   @return [::String]
+        #     Optional. An optional request ID to identify requests. Specify a unique
+        #     request ID so that if you must retry your request, the server will know to
+        #     ignore the request if it has already been completed. The server will
+        #     guarantee that for at least 60 minutes after the first request.
+        #
+        #     For example, consider a situation where you make an initial request and
+        #     the request times out. If you make the request again with the same request
+        #     ID, the server can check if original operation with the same request ID
+        #     was received, and if so, will ignore the second request. This prevents
+        #     clients from accidentally creating duplicate commitments.
+        #
+        #     The request ID must be a valid UUID with the exception that zero UUID is
+        #     not supported (00000000-0000-0000-0000-000000000000).
+        class DeletePolicyBasedRouteRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+      end
+    end
+  end
+end

data/proto_docs/google/type/expr.rb

@@ -0,0 +1,75 @@
+# frozen_string_literal: true
+
+# Copyright 2023 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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-network_connectivity-v1
 version: !ruby/object:Gem::Version
-  version: 0.6.1
+  version: 0.8.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-06-06 00:00:00.000000000 Z
+date: 2023-10-03 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.19.1
+        version: 0.20.0
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a
@@ -26,7 +26,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.19.1
+        version: 0.20.0
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a
@@ -218,10 +218,17 @@ files:
 - lib/google/cloud/network_connectivity/v1/hub_service/credentials.rb
 - lib/google/cloud/network_connectivity/v1/hub_service/operations.rb
 - lib/google/cloud/network_connectivity/v1/hub_service/paths.rb
+- lib/google/cloud/network_connectivity/v1/policy_based_routing_service.rb
+- lib/google/cloud/network_connectivity/v1/policy_based_routing_service/client.rb
+- lib/google/cloud/network_connectivity/v1/policy_based_routing_service/credentials.rb
+- lib/google/cloud/network_connectivity/v1/policy_based_routing_service/operations.rb
+- lib/google/cloud/network_connectivity/v1/policy_based_routing_service/paths.rb
 - lib/google/cloud/network_connectivity/v1/version.rb
 - lib/google/cloud/networkconnectivity/v1/common_pb.rb
 - lib/google/cloud/networkconnectivity/v1/hub_pb.rb
 - lib/google/cloud/networkconnectivity/v1/hub_services_pb.rb
+- lib/google/cloud/networkconnectivity/v1/policy_based_routing_pb.rb
+- lib/google/cloud/networkconnectivity/v1/policy_based_routing_services_pb.rb
 - proto_docs/README.md
 - proto_docs/google/api/client.rb
 - proto_docs/google/api/field_behavior.rb
@@ -229,6 +236,7 @@ files:
 - proto_docs/google/api/resource.rb
 - proto_docs/google/cloud/networkconnectivity/v1/common.rb
 - proto_docs/google/cloud/networkconnectivity/v1/hub.rb
+- proto_docs/google/cloud/networkconnectivity/v1/policy_based_routing.rb
 - proto_docs/google/longrunning/operations.rb
 - proto_docs/google/protobuf/any.rb
 - proto_docs/google/protobuf/duration.rb
@@ -236,6 +244,7 @@ files:
 - proto_docs/google/protobuf/field_mask.rb
 - proto_docs/google/protobuf/timestamp.rb
 - proto_docs/google/rpc/status.rb
+- proto_docs/google/type/expr.rb
 homepage: https://github.com/googleapis/google-cloud-ruby
 licenses:
 - Apache-2.0
@@ -255,7 +264,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.2
+rubygems_version: 3.4.19
 signing_key: 
 specification_version: 4
 summary: This API enables connectivity with and between Google Cloud resources.