google-cloud-network_management-v1 1.4.0 → 1.5.0

data/lib/google/cloud/networkmanagement/v1/vpc_flow_logs_services_pb.rb

@@ -0,0 +1,83 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# Source: google/cloud/networkmanagement/v1/vpc_flow_logs.proto for package 'Google.Cloud.NetworkManagement.V1'
+# Original file comments:
+# Copyright 2024 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
+#
+#     http://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.
+#
+
+require 'grpc'
+require 'google/cloud/networkmanagement/v1/vpc_flow_logs_pb'
+
+module Google
+  module Cloud
+    module NetworkManagement
+      module V1
+        module VpcFlowLogsService
+          # The VPC Flow Logs service in the Google Cloud Network Management API provides
+          # configurations that generate Flow Logs. The service and the configuration
+          # resources created using this service are global.
+          class Service
+
+            include ::GRPC::GenericService
+
+            self.marshal_class_method = :encode
+            self.unmarshal_class_method = :decode
+            self.service_name = 'google.cloud.networkmanagement.v1.VpcFlowLogsService'
+
+            # Lists all `VpcFlowLogsConfigs` in a given project.
+            rpc :ListVpcFlowLogsConfigs, ::Google::Cloud::NetworkManagement::V1::ListVpcFlowLogsConfigsRequest, ::Google::Cloud::NetworkManagement::V1::ListVpcFlowLogsConfigsResponse
+            # Gets the details of a specific `VpcFlowLogsConfig`.
+            rpc :GetVpcFlowLogsConfig, ::Google::Cloud::NetworkManagement::V1::GetVpcFlowLogsConfigRequest, ::Google::Cloud::NetworkManagement::V1::VpcFlowLogsConfig
+            # Creates a new `VpcFlowLogsConfig`.
+            # If a configuration with the exact same settings already exists (even if the
+            # ID is different), the creation fails.
+            # Notes:
+            #
+            #   1. Creating a configuration with state=DISABLED will fail
+            #   2. The following fields are not considered as `settings` for the purpose
+            #   of the check mentioned above, therefore - creating another configuration
+            #   with the same fields but different values for the following fields will
+            #   fail as well:
+            #       * name
+            #       * create_time
+            #       * update_time
+            #       * labels
+            #       * description
+            rpc :CreateVpcFlowLogsConfig, ::Google::Cloud::NetworkManagement::V1::CreateVpcFlowLogsConfigRequest, ::Google::Longrunning::Operation
+            # Updates an existing `VpcFlowLogsConfig`.
+            # If a configuration with the exact same settings already exists (even if the
+            # ID is different), the creation fails.
+            # Notes:
+            #
+            #   1. Updating a configuration with state=DISABLED will fail.
+            #   2. The following fields are not considered as `settings` for the purpose
+            #   of the check mentioned above, therefore - updating another configuration
+            #   with the same fields but different values for the following fields will
+            #   fail as well:
+            #       * name
+            #       * create_time
+            #       * update_time
+            #       * labels
+            #       * description
+            rpc :UpdateVpcFlowLogsConfig, ::Google::Cloud::NetworkManagement::V1::UpdateVpcFlowLogsConfigRequest, ::Google::Longrunning::Operation
+            # Deletes a specific `VpcFlowLogsConfig`.
+            rpc :DeleteVpcFlowLogsConfig, ::Google::Cloud::NetworkManagement::V1::DeleteVpcFlowLogsConfigRequest, ::Google::Longrunning::Operation
+          end
+
+          Stub = Service.rpc_stub_class
+        end
+      end
+    end
+  end
+end

data/proto_docs/google/cloud/networkmanagement/v1/vpc_flow_logs.rb

@@ -0,0 +1,115 @@
+# frozen_string_literal: true
+
+# Copyright 2025 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 NetworkManagement
+      module V1
+        # Request for the `ListVpcFlowLogsConfigs` method.
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. The parent resource of the VpcFlowLogsConfig:
+        #         `projects/{project_id}/locations/global`
+        # @!attribute [rw] page_size
+        #   @return [::Integer]
+        #     Optional. Number of `VpcFlowLogsConfigs` to return.
+        # @!attribute [rw] page_token
+        #   @return [::String]
+        #     Optional. Page token from an earlier query, as returned in
+        #     `next_page_token`.
+        # @!attribute [rw] filter
+        #   @return [::String]
+        #     Optional. Lists the `VpcFlowLogsConfigs` that match the filter expression.
+        #     A filter expression must use the supported [CEL logic operators]
+        #     (https://cloud.google.com/vpc/docs/about-flow-logs-records#supported_cel_logic_operators).
+        # @!attribute [rw] order_by
+        #   @return [::String]
+        #     Optional. Field to use to sort the list.
+        class ListVpcFlowLogsConfigsRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Response for the `ListVpcFlowLogsConfigs` method.
+        # @!attribute [rw] vpc_flow_logs_configs
+        #   @return [::Array<::Google::Cloud::NetworkManagement::V1::VpcFlowLogsConfig>]
+        #     List of VPC Flow Log configurations.
+        # @!attribute [rw] next_page_token
+        #   @return [::String]
+        #     Page token to fetch the next set of configurations.
+        # @!attribute [rw] unreachable
+        #   @return [::Array<::String>]
+        #     Locations that could not be reached (when querying all locations with `-`).
+        class ListVpcFlowLogsConfigsResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request for the `GetVpcFlowLogsConfig` method.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. `VpcFlowLogsConfig` resource name using the form:
+        #         `projects/{project_id}/locations/global/vpcFlowLogsConfigs/{vpc_flow_logs_config}`
+        class GetVpcFlowLogsConfigRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request for the `CreateVpcFlowLogsConfig` method.
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. The parent resource of the VPC Flow Logs configuration to create:
+        #         `projects/{project_id}/locations/global`
+        # @!attribute [rw] vpc_flow_logs_config_id
+        #   @return [::String]
+        #     Required. ID of the `VpcFlowLogsConfig`.
+        # @!attribute [rw] vpc_flow_logs_config
+        #   @return [::Google::Cloud::NetworkManagement::V1::VpcFlowLogsConfig]
+        #     Required. A `VpcFlowLogsConfig` resource
+        class CreateVpcFlowLogsConfigRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request for the `UpdateVpcFlowLogsConfig` method.
+        # @!attribute [rw] update_mask
+        #   @return [::Google::Protobuf::FieldMask]
+        #     Required. Mask of fields to update. At least one path must be supplied in
+        #     this field.
+        # @!attribute [rw] vpc_flow_logs_config
+        #   @return [::Google::Cloud::NetworkManagement::V1::VpcFlowLogsConfig]
+        #     Required. Only fields specified in update_mask are updated.
+        class UpdateVpcFlowLogsConfigRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request for the `DeleteVpcFlowLogsConfig` method.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. `VpcFlowLogsConfig` resource name using the form:
+        #         `projects/{project_id}/locations/global/vpcFlowLogsConfigs/{vpc_flow_logs_config}`
+        class DeleteVpcFlowLogsConfigRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+      end
+    end
+  end
+end

data/proto_docs/google/cloud/networkmanagement/v1/vpc_flow_logs_config.rb

@@ -0,0 +1,163 @@
+# frozen_string_literal: true
+
+# Copyright 2025 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 NetworkManagement
+      module V1
+        # A configuration to generate VPC Flow Logs.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Identifier. Unique name of the configuration using the form:
+        #         `projects/{project_id}/locations/global/vpcFlowLogsConfigs/{vpc_flow_logs_config_id}`
+        # @!attribute [rw] description
+        #   @return [::String]
+        #     Optional. The user-supplied description of the VPC Flow Logs configuration.
+        #     Maximum of 512 characters.
+        # @!attribute [rw] state
+        #   @return [::Google::Cloud::NetworkManagement::V1::VpcFlowLogsConfig::State]
+        #     Optional. The state of the VPC Flow Log configuration. Default value is
+        #     ENABLED. When creating a new configuration, it must be enabled.
+        # @!attribute [rw] aggregation_interval
+        #   @return [::Google::Cloud::NetworkManagement::V1::VpcFlowLogsConfig::AggregationInterval]
+        #     Optional. The aggregation interval for the logs. Default value is
+        #     INTERVAL_5_SEC.
+        # @!attribute [rw] flow_sampling
+        #   @return [::Float]
+        #     Optional. The value of the field must be in (0, 1]. The sampling rate of
+        #     VPC Flow Logs where 1.0 means all collected logs are reported. Setting the
+        #     sampling rate to 0.0 is not allowed. If you want to disable VPC Flow Logs,
+        #     use the state field instead. Default value is 1.0.
+        # @!attribute [rw] metadata
+        #   @return [::Google::Cloud::NetworkManagement::V1::VpcFlowLogsConfig::Metadata]
+        #     Optional. Configures whether all, none or a subset of metadata fields
+        #     should be added to the reported VPC flow logs. Default value is
+        #     INCLUDE_ALL_METADATA.
+        # @!attribute [rw] metadata_fields
+        #   @return [::Array<::String>]
+        #     Optional. Custom metadata fields to include in the reported VPC flow logs.
+        #     Can only be specified if "metadata" was set to CUSTOM_METADATA.
+        # @!attribute [rw] filter_expr
+        #   @return [::String]
+        #     Optional. Export filter used to define which VPC Flow Logs should be
+        #     logged.
+        # @!attribute [r] target_resource_state
+        #   @return [::Google::Cloud::NetworkManagement::V1::VpcFlowLogsConfig::TargetResourceState]
+        #     Output only. A diagnostic bit - describes the state of the configured
+        #     target resource for diagnostic purposes.
+        # @!attribute [rw] interconnect_attachment
+        #   @return [::String]
+        #     Traffic will be logged from the Interconnect Attachment.
+        #     Format:
+        #     projects/\\{project_id}/regions/\\{region}/interconnectAttachments/\\{name}
+        # @!attribute [rw] vpn_tunnel
+        #   @return [::String]
+        #     Traffic will be logged from the VPN Tunnel.
+        #     Format: projects/\\{project_id}/regions/\\{region}/vpnTunnels/\\{name}
+        # @!attribute [rw] labels
+        #   @return [::Google::Protobuf::Map{::String => ::String}]
+        #     Optional. Resource labels to represent user-provided metadata.
+        # @!attribute [r] create_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Output only. The time the config was created.
+        # @!attribute [r] update_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Output only. The time the config was updated.
+        class VpcFlowLogsConfig
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # @!attribute [rw] key
+          #   @return [::String]
+          # @!attribute [rw] value
+          #   @return [::String]
+          class LabelsEntry
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # Determines whether this configuration will be generating logs.
+          # Setting state=DISABLED will pause the log generation for this config.
+          module State
+            # If not specified, will default to ENABLED.
+            STATE_UNSPECIFIED = 0
+
+            # When ENABLED, this configuration will generate logs.
+            ENABLED = 1
+
+            # When DISABLED, this configuration will not generate logs.
+            DISABLED = 2
+          end
+
+          # Toggles the aggregation interval for collecting flow logs by 5-tuple.
+          module AggregationInterval
+            # If not specified, will default to INTERVAL_5_SEC.
+            AGGREGATION_INTERVAL_UNSPECIFIED = 0
+
+            # Aggregate logs in 5s intervals.
+            INTERVAL_5_SEC = 1
+
+            # Aggregate logs in 30s intervals.
+            INTERVAL_30_SEC = 2
+
+            # Aggregate logs in 1m intervals.
+            INTERVAL_1_MIN = 3
+
+            # Aggregate logs in 5m intervals.
+            INTERVAL_5_MIN = 4
+
+            # Aggregate logs in 10m intervals.
+            INTERVAL_10_MIN = 5
+
+            # Aggregate logs in 15m intervals.
+            INTERVAL_15_MIN = 6
+          end
+
+          # Configures which log fields would be included.
+          module Metadata
+            # If not specified, will default to INCLUDE_ALL_METADATA.
+            METADATA_UNSPECIFIED = 0
+
+            # Include all metadata fields.
+            INCLUDE_ALL_METADATA = 1
+
+            # Exclude all metadata fields.
+            EXCLUDE_ALL_METADATA = 2
+
+            # Include only custom fields (specified in metadata_fields).
+            CUSTOM_METADATA = 3
+          end
+
+          # Optional states of the target resource that are used as part of the
+          # diagnostic bit.
+          module TargetResourceState
+            # Unspecified target resource state.
+            TARGET_RESOURCE_STATE_UNSPECIFIED = 0
+
+            # Indicates that the target resource exists.
+            TARGET_RESOURCE_EXISTS = 1
+
+            # Indicates that the target resource does not exist.
+            TARGET_RESOURCE_DOES_NOT_EXIST = 2
+          end
+        end
+      end
+    end
+  end
+end

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-network_management-v1
 version: !ruby/object:Gem::Version
-  version: 1.4.0
+  version: 1.5.0
 platform: ruby
 authors:
 - Google LLC
-autorequire: 
 bindir: bin
 cert_chain: []
-date: 2024-12-10 00:00:00.000000000 Z
+date: 2025-01-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gapic-common
@@ -112,10 +111,22 @@ files:
 - lib/google/cloud/network_management/v1/reachability_service/rest/service_stub.rb
 - lib/google/cloud/network_management/v1/rest.rb
 - lib/google/cloud/network_management/v1/version.rb
+- lib/google/cloud/network_management/v1/vpc_flow_logs_service.rb
+- lib/google/cloud/network_management/v1/vpc_flow_logs_service/client.rb
+- lib/google/cloud/network_management/v1/vpc_flow_logs_service/credentials.rb
+- lib/google/cloud/network_management/v1/vpc_flow_logs_service/operations.rb
+- lib/google/cloud/network_management/v1/vpc_flow_logs_service/paths.rb
+- lib/google/cloud/network_management/v1/vpc_flow_logs_service/rest.rb
+- lib/google/cloud/network_management/v1/vpc_flow_logs_service/rest/client.rb
+- lib/google/cloud/network_management/v1/vpc_flow_logs_service/rest/operations.rb
+- lib/google/cloud/network_management/v1/vpc_flow_logs_service/rest/service_stub.rb
 - lib/google/cloud/networkmanagement/v1/connectivity_test_pb.rb
 - lib/google/cloud/networkmanagement/v1/reachability_pb.rb
 - lib/google/cloud/networkmanagement/v1/reachability_services_pb.rb
 - lib/google/cloud/networkmanagement/v1/trace_pb.rb
+- lib/google/cloud/networkmanagement/v1/vpc_flow_logs_config_pb.rb
+- lib/google/cloud/networkmanagement/v1/vpc_flow_logs_pb.rb
+- lib/google/cloud/networkmanagement/v1/vpc_flow_logs_services_pb.rb
 - proto_docs/README.md
 - proto_docs/google/api/client.rb
 - proto_docs/google/api/field_behavior.rb
@@ -125,6 +136,8 @@ files:
 - proto_docs/google/cloud/networkmanagement/v1/connectivity_test.rb
 - proto_docs/google/cloud/networkmanagement/v1/reachability.rb
 - proto_docs/google/cloud/networkmanagement/v1/trace.rb
+- proto_docs/google/cloud/networkmanagement/v1/vpc_flow_logs.rb
+- proto_docs/google/cloud/networkmanagement/v1/vpc_flow_logs_config.rb
 - proto_docs/google/longrunning/operations.rb
 - proto_docs/google/protobuf/any.rb
 - proto_docs/google/protobuf/duration.rb
@@ -137,7 +150,6 @@ homepage: https://github.com/googleapis/google-cloud-ruby
 licenses:
 - Apache-2.0
 metadata: {}
-post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
@@ -152,8 +164,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.23
-signing_key: 
+rubygems_version: 3.6.2
 specification_version: 4
 summary: The Network Management API provides a collection of network performance monitoring
   and diagnostic capabilities.