google-apis-beyondcorp_v1alpha 0.3.0 → 0.6.0

data/lib/google/apis/beyondcorp_v1alpha/service.rb

@@ -25,7 +25,7 @@ module Google
       # Beyondcorp Enterprise provides identity and context aware access controls for
       #  enterprise resources and enables zero-trust access. Using the Beyondcorp
       #  Enterprise APIs, enterprises can set up multi-cloud and on-prem connectivity
-      #  using the App Connector hybrid connectivity solution.
+      #  solutions.
       #
       # @example
       #    require 'google/apis/beyondcorp_v1alpha'
@@ -52,6 +52,187 @@ module Google
           @batch_path = 'batch'
         end
         
+        # Gets the value for a selected particular insight based on the provided filters.
+        # Use the organization level path for fetching at org level and project level
+        # path for fetching the insight value specific to a particular project.
+        # @param [String] insight
+        #   Required. The resource name of the insight using the form: `organizations/`
+        #   organization_id`/locations/`location_id`/insights/`insight_id`` `projects/`
+        #   project_id`/locations/`location_id`/insights/`insight_id``.
+        # @param [String] aggregation
+        #   Optional. Aggregation type. Available aggregation could be fetched by calling
+        #   insight list and get APIs in `BASIC` view.
+        # @param [String] custom_grouping_field_filter
+        #   Optional. Filterable parameters to be added to the grouping clause. Available
+        #   fields could be fetched by calling insight list and get APIs in `BASIC` view. `
+        #   =` is the only comparison operator supported. `AND` is the only logical
+        #   operator supported. Usage: field_filter="fieldName1=fieldVal1 AND fieldName2=
+        #   fieldVal2". NOTE: Only `AND` conditions are allowed. NOTE: Use the `
+        #   filter_alias` from `Insight.Metadata.Field` message for the filtering the
+        #   corresponding fields in this filter field. (These expressions are based on the
+        #   filter language described at https://google.aip.dev/160).
+        # @param [Array<String>, String] custom_grouping_group_fields
+        #   Required. Fields to be used for grouping. NOTE: Use the `filter_alias` from `
+        #   Insight.Metadata.Field` message for declaring the fields to be grouped-by here.
+        # @param [String] end_time
+        #   Required. Ending time for the duration for which insight is to be pulled.
+        # @param [String] field_filter
+        #   Optional. Other filterable/configurable parameters as applicable to the
+        #   selected insight. Available fields could be fetched by calling insight list
+        #   and get APIs in `BASIC` view. `=` is the only comparison operator supported. `
+        #   AND` is the only logical operator supported. Usage: field_filter="fieldName1=
+        #   fieldVal1 AND fieldName2=fieldVal2". NOTE: Only `AND` conditions are allowed.
+        #   NOTE: Use the `filter_alias` from `Insight.Metadata.Field` message for the
+        #   filtering the corresponding fields in this filter field. (These expressions
+        #   are based on the filter language described at https://google.aip.dev/160).
+        # @param [String] group
+        #   Optional. Group id of the available groupings for the insight. Available
+        #   groupings could be fetched by calling insight list and get APIs in `BASIC`
+        #   view.
+        # @param [Fixnum] page_size
+        #   Optional. Requested page size. Server may return fewer items than requested.
+        #   If unspecified, server will pick an appropriate default.
+        # @param [String] page_token
+        #   Optional. Used to fetch the page represented by the token. Fetches the first
+        #   page when not set.
+        # @param [String] start_time
+        #   Required. Starting time for the duration for which insight is to be pulled.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::BeyondcorpV1alpha::GoogleCloudBeyondcorpSaasplatformInsightsV1alphaConfiguredInsightResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::BeyondcorpV1alpha::GoogleCloudBeyondcorpSaasplatformInsightsV1alphaConfiguredInsightResponse]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def configured_organization_location_insight_insight(insight, aggregation: nil, custom_grouping_field_filter: nil, custom_grouping_group_fields: nil, end_time: nil, field_filter: nil, group: nil, page_size: nil, page_token: nil, start_time: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v1alpha/{+insight}:configuredInsight', options)
+          command.response_representation = Google::Apis::BeyondcorpV1alpha::GoogleCloudBeyondcorpSaasplatformInsightsV1alphaConfiguredInsightResponse::Representation
+          command.response_class = Google::Apis::BeyondcorpV1alpha::GoogleCloudBeyondcorpSaasplatformInsightsV1alphaConfiguredInsightResponse
+          command.params['insight'] = insight unless insight.nil?
+          command.query['aggregation'] = aggregation unless aggregation.nil?
+          command.query['customGrouping.fieldFilter'] = custom_grouping_field_filter unless custom_grouping_field_filter.nil?
+          command.query['customGrouping.groupFields'] = custom_grouping_group_fields unless custom_grouping_group_fields.nil?
+          command.query['endTime'] = end_time unless end_time.nil?
+          command.query['fieldFilter'] = field_filter unless field_filter.nil?
+          command.query['group'] = group unless group.nil?
+          command.query['pageSize'] = page_size unless page_size.nil?
+          command.query['pageToken'] = page_token unless page_token.nil?
+          command.query['startTime'] = start_time unless start_time.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Gets the value for a selected particular insight with default configuration.
+        # The default aggregation level is 'DAILY' and no grouping will be applied or
+        # default grouping if applicable. The data will be returned for recent 7 days.
+        # Use the organization level path for fetching at org level and project level
+        # path for fetching the insight value specific to a particular project. Setting
+        # the `view` to `BASIC` will only return the metadata for the insight.
+        # @param [String] name
+        #   Required. The resource name of the insight using the form: `organizations/`
+        #   organization_id`/locations/`location_id`/insights/`insight_id`` `projects/`
+        #   project_id`/locations/`location_id`/insights/`insight_id``
+        # @param [String] view
+        #   Required. Metadata only or full data view.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::BeyondcorpV1alpha::GoogleCloudBeyondcorpSaasplatformInsightsV1alphaInsight] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::BeyondcorpV1alpha::GoogleCloudBeyondcorpSaasplatformInsightsV1alphaInsight]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def get_organization_location_insight(name, view: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v1alpha/{+name}', options)
+          command.response_representation = Google::Apis::BeyondcorpV1alpha::GoogleCloudBeyondcorpSaasplatformInsightsV1alphaInsight::Representation
+          command.response_class = Google::Apis::BeyondcorpV1alpha::GoogleCloudBeyondcorpSaasplatformInsightsV1alphaInsight
+          command.params['name'] = name unless name.nil?
+          command.query['view'] = view unless view.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Lists for all the available insights that could be fetched from the system.
+        # Allows to filter using category. Setting the `view` to `BASIC` will let you
+        # iterate over the list of insight metadatas.
+        # @param [String] parent
+        #   Required. The resource name of InsightMetadata using the form: `organizations/`
+        #   organization_id`/locations/`location`` `projects/`project_id`/locations/`
+        #   location_id``
+        # @param [String] filter
+        #   Optional. Filter expression to restrict the insights returned. Supported
+        #   filter fields: * `type` * `category` * `subCategory` Examples: * "category =
+        #   application AND type = count" * "category = application AND subCategory = iap"
+        #   * "type = status" Allowed values: * type: [count, latency, status, list] *
+        #   category: [application, device, request, security] * subCategory: [iap,
+        #   webprotect] NOTE: Only equality based comparison is allowed. Only `AND`
+        #   conjunction is allowed. NOTE: The 'AND' in the filter field needs to be in
+        #   capital letters only. NOTE: Just filtering on `subCategory` is not allowed. It
+        #   should be passed in with the parent `category` too. (These expressions are
+        #   based on the filter language described at https://google.aip.dev/160).
+        # @param [String] order_by
+        #   Optional. Hint for how to order the results. This is currently ignored.
+        # @param [Fixnum] page_size
+        #   Optional. Requested page size. Server may return fewer items than requested.
+        #   If unspecified, server will pick an appropriate default. NOTE: Default page
+        #   size is 50.
+        # @param [String] page_token
+        #   Optional. A token identifying a page of results the server should return.
+        # @param [String] view
+        #   Required. List only metadata or full data.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::BeyondcorpV1alpha::GoogleCloudBeyondcorpSaasplatformInsightsV1alphaListInsightsResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::BeyondcorpV1alpha::GoogleCloudBeyondcorpSaasplatformInsightsV1alphaListInsightsResponse]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def list_organization_location_insights(parent, filter: nil, order_by: nil, page_size: nil, page_token: nil, view: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v1alpha/{+parent}/insights', options)
+          command.response_representation = Google::Apis::BeyondcorpV1alpha::GoogleCloudBeyondcorpSaasplatformInsightsV1alphaListInsightsResponse::Representation
+          command.response_class = Google::Apis::BeyondcorpV1alpha::GoogleCloudBeyondcorpSaasplatformInsightsV1alphaListInsightsResponse
+          command.params['parent'] = parent unless parent.nil?
+          command.query['filter'] = filter unless filter.nil?
+          command.query['orderBy'] = order_by unless order_by.nil?
+          command.query['pageSize'] = page_size unless page_size.nil?
+          command.query['pageToken'] = page_token unless page_token.nil?
+          command.query['view'] = view unless view.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Gets information about a location.
         # @param [String] name
         #   Resource name for the location.
@@ -132,7 +313,7 @@ module Google
         # @param [Google::Apis::BeyondcorpV1alpha::GoogleCloudBeyondcorpAppconnectionsV1alphaAppConnection] google_cloud_beyondcorp_appconnections_v1alpha_app_connection_object
         # @param [String] app_connection_id
         #   Optional. User-settable AppConnection resource ID. * Must start with a letter.
-        #   * Must contain between 4-63 characters from (/a-z-/). * Must end with a number
+        #   * Must contain between 4-63 characters from `/a-z-/`. * Must end with a number
         #   or a letter.
         # @param [String] request_id
         #   Optional. An optional request ID to identify requests. Specify a unique
@@ -542,7 +723,7 @@ module Google
         # @param [Google::Apis::BeyondcorpV1alpha::GoogleCloudBeyondcorpAppconnectorsV1alphaAppConnector] google_cloud_beyondcorp_appconnectors_v1alpha_app_connector_object
         # @param [String] app_connector_id
         #   Optional. User-settable AppConnector resource ID. * Must start with a letter. *
-        #   Must contain between 4-63 characters from (/a-z-/). * Must end with a number
+        #   Must contain between 4-63 characters from `/a-z-/`. * Must end with a number
         #   or a letter.
         # @param [String] request_id
         #   Optional. An optional request ID to identify requests. Specify a unique
@@ -851,8 +1032,8 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Get instance config for a given AppConnector. An internal method called by a
-        # AppConnector to get its container config.
+        # Gets instance configuration for a given AppConnector. An internal method
+        # called by a AppConnector to get its container config.
         # @param [String] app_connector
         #   Required. BeyondCorp AppConnector name using the form: `projects/`project_id`/
         #   locations/`location_id`/appConnectors/`app_connector``
@@ -966,7 +1147,7 @@ module Google
         # @param [Google::Apis::BeyondcorpV1alpha::AppGateway] app_gateway_object
         # @param [String] app_gateway_id
         #   Optional. User-settable AppGateway resource ID. * Must start with a letter. *
-        #   Must contain between 4-63 characters from (/a-z-/). * Must end with a number
+        #   Must contain between 4-63 characters from `/a-z-/`. * Must end with a number
         #   or a letter.
         # @param [String] request_id
         #   Optional. An optional request ID to identify requests. Specify a unique
@@ -1262,13 +1443,134 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Gets the access control policy for a resource. Returns an empty policy if the
+        # resource exists and does not have a policy set.
+        # @param [String] resource
+        #   REQUIRED: The resource for which the policy is being requested. See [Resource
+        #   names](https://cloud.google.com/apis/design/resource_names) for the
+        #   appropriate value for this field.
+        # @param [Fixnum] options_requested_policy_version
+        #   Optional. The maximum policy version that will be used to format the policy.
+        #   Valid values are 0, 1, and 3. Requests specifying an invalid value will be
+        #   rejected. Requests for policies with any conditional role bindings must
+        #   specify version 3. Policies with no conditional role bindings may specify any
+        #   valid value or leave the field unset. The policy in the response might use the
+        #   policy version that you specified, or it might use a lower policy version. For
+        #   example, if you specify version 3, but the policy has no conditional role
+        #   bindings, the response uses version 1. To learn which resources support
+        #   conditions in their IAM policies, see the [IAM documentation](https://cloud.
+        #   google.com/iam/help/conditions/resource-policies).
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::BeyondcorpV1alpha::GoogleIamV1Policy] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::BeyondcorpV1alpha::GoogleIamV1Policy]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def get_project_location_application_iam_policy(resource, options_requested_policy_version: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v1alpha/{+resource}:getIamPolicy', options)
+          command.response_representation = Google::Apis::BeyondcorpV1alpha::GoogleIamV1Policy::Representation
+          command.response_class = Google::Apis::BeyondcorpV1alpha::GoogleIamV1Policy
+          command.params['resource'] = resource unless resource.nil?
+          command.query['options.requestedPolicyVersion'] = options_requested_policy_version unless options_requested_policy_version.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Sets the access control policy on the specified resource. Replaces any
+        # existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `
+        # PERMISSION_DENIED` errors.
+        # @param [String] resource
+        #   REQUIRED: The resource for which the policy is being specified. See [Resource
+        #   names](https://cloud.google.com/apis/design/resource_names) for the
+        #   appropriate value for this field.
+        # @param [Google::Apis::BeyondcorpV1alpha::GoogleIamV1SetIamPolicyRequest] google_iam_v1_set_iam_policy_request_object
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::BeyondcorpV1alpha::GoogleIamV1Policy] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::BeyondcorpV1alpha::GoogleIamV1Policy]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def set_project_location_application_iam_policy(resource, google_iam_v1_set_iam_policy_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1alpha/{+resource}:setIamPolicy', options)
+          command.request_representation = Google::Apis::BeyondcorpV1alpha::GoogleIamV1SetIamPolicyRequest::Representation
+          command.request_object = google_iam_v1_set_iam_policy_request_object
+          command.response_representation = Google::Apis::BeyondcorpV1alpha::GoogleIamV1Policy::Representation
+          command.response_class = Google::Apis::BeyondcorpV1alpha::GoogleIamV1Policy
+          command.params['resource'] = resource unless resource.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Returns permissions that a caller has on the specified resource. If the
+        # resource does not exist, this will return an empty set of permissions, not a `
+        # NOT_FOUND` error. Note: This operation is designed to be used for building
+        # permission-aware UIs and command-line tools, not for authorization checking.
+        # This operation may "fail open" without warning.
+        # @param [String] resource
+        #   REQUIRED: The resource for which the policy detail is being requested. See [
+        #   Resource names](https://cloud.google.com/apis/design/resource_names) for the
+        #   appropriate value for this field.
+        # @param [Google::Apis::BeyondcorpV1alpha::GoogleIamV1TestIamPermissionsRequest] google_iam_v1_test_iam_permissions_request_object
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::BeyondcorpV1alpha::GoogleIamV1TestIamPermissionsResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::BeyondcorpV1alpha::GoogleIamV1TestIamPermissionsResponse]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def test_project_location_application_iam_permissions(resource, google_iam_v1_test_iam_permissions_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1alpha/{+resource}:testIamPermissions', options)
+          command.request_representation = Google::Apis::BeyondcorpV1alpha::GoogleIamV1TestIamPermissionsRequest::Representation
+          command.request_object = google_iam_v1_test_iam_permissions_request_object
+          command.response_representation = Google::Apis::BeyondcorpV1alpha::GoogleIamV1TestIamPermissionsResponse::Representation
+          command.response_class = Google::Apis::BeyondcorpV1alpha::GoogleIamV1TestIamPermissionsResponse
+          command.params['resource'] = resource unless resource.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Creates a new ClientConnectorService in a given project and location.
         # @param [String] parent
         #   Required. Value for parent.
         # @param [Google::Apis::BeyondcorpV1alpha::ClientConnectorService] client_connector_service_object
         # @param [String] client_connector_service_id
         #   Optional. User-settable client connector service resource ID. * Must start
-        #   with a letter. * Must contain between 4-63 characters from (/a-z-/). * Must
+        #   with a letter. * Must contain between 4-63 characters from `/a-z-/`. * Must
         #   end with a number or a letter. A random system generated name will be assigned
         #   if not specified by the user.
         # @param [String] request_id
@@ -1503,7 +1805,8 @@ module Google
         #   ClientConnectorService resource by the update. The fields specified in the
         #   update_mask are relative to the resource, not the full request. A field will
         #   be overwritten if it is in the mask. If the user does not provide a mask then
-        #   all fields will be overwritten. Mutable fields: display_name.
+        #   all fields will be overwritten. Mutable fields: display_name, ingress.config.
+        #   destination_routes.
         # @param [Boolean] validate_only
         #   Optional. If set, validates request by executing a dry-run which would not
         #   alter the resource in any way.
@@ -1622,7 +1925,7 @@ module Google
         # @param [Google::Apis::BeyondcorpV1alpha::ClientGateway] client_gateway_object
         # @param [String] client_gateway_id
         #   Optional. User-settable client gateway resource ID. * Must start with a letter.
-        #   * Must contain between 4-63 characters from (/a-z-/). * Must end with a
+        #   * Must contain between 4-63 characters from `/a-z-/`. * Must end with a
         #   number or a letter.
         # @param [String] request_id
         #   Optional. An optional request ID to identify requests. Specify a unique
@@ -1917,7 +2220,7 @@ module Google
         # @param [Google::Apis::BeyondcorpV1alpha::Connection] connection_object
         # @param [String] connection_id
         #   Optional. User-settable connection resource ID. * Must start with a letter. *
-        #   Must contain between 4-63 characters from (/a-z-/). * Must end with a number
+        #   Must contain between 4-63 characters from `/a-z-/`. * Must end with a number
         #   or a letter.
         # @param [String] request_id
         #   Optional. An optional request ID to identify requests. Specify a unique
@@ -2327,7 +2630,7 @@ module Google
         # @param [Google::Apis::BeyondcorpV1alpha::Connector] connector_object
         # @param [String] connector_id
         #   Optional. User-settable connector resource ID. * Must start with a letter. *
-        #   Must contain between 4-63 characters from (/a-z-/). * Must end with a number
+        #   Must contain between 4-63 characters from `/a-z-/`. * Must end with a number
         #   or a letter.
         # @param [String] request_id
         #   Optional. An optional request ID to identify requests. Specify a unique
@@ -2636,8 +2939,8 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Get instance config for a given connector. An internal method called by a
-        # connector to get its container config.
+        # Gets instance configuration for a given connector. An internal method called
+        # by a connector to get its container config.
         # @param [String] connector
         #   Required. BeyondCorp Connector name using the form: `projects/`project_id`/
         #   locations/`location_id`/connectors/`connector``
@@ -2744,6 +3047,187 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Gets the value for a selected particular insight based on the provided filters.
+        # Use the organization level path for fetching at org level and project level
+        # path for fetching the insight value specific to a particular project.
+        # @param [String] insight
+        #   Required. The resource name of the insight using the form: `organizations/`
+        #   organization_id`/locations/`location_id`/insights/`insight_id`` `projects/`
+        #   project_id`/locations/`location_id`/insights/`insight_id``.
+        # @param [String] aggregation
+        #   Optional. Aggregation type. Available aggregation could be fetched by calling
+        #   insight list and get APIs in `BASIC` view.
+        # @param [String] custom_grouping_field_filter
+        #   Optional. Filterable parameters to be added to the grouping clause. Available
+        #   fields could be fetched by calling insight list and get APIs in `BASIC` view. `
+        #   =` is the only comparison operator supported. `AND` is the only logical
+        #   operator supported. Usage: field_filter="fieldName1=fieldVal1 AND fieldName2=
+        #   fieldVal2". NOTE: Only `AND` conditions are allowed. NOTE: Use the `
+        #   filter_alias` from `Insight.Metadata.Field` message for the filtering the
+        #   corresponding fields in this filter field. (These expressions are based on the
+        #   filter language described at https://google.aip.dev/160).
+        # @param [Array<String>, String] custom_grouping_group_fields
+        #   Required. Fields to be used for grouping. NOTE: Use the `filter_alias` from `
+        #   Insight.Metadata.Field` message for declaring the fields to be grouped-by here.
+        # @param [String] end_time
+        #   Required. Ending time for the duration for which insight is to be pulled.
+        # @param [String] field_filter
+        #   Optional. Other filterable/configurable parameters as applicable to the
+        #   selected insight. Available fields could be fetched by calling insight list
+        #   and get APIs in `BASIC` view. `=` is the only comparison operator supported. `
+        #   AND` is the only logical operator supported. Usage: field_filter="fieldName1=
+        #   fieldVal1 AND fieldName2=fieldVal2". NOTE: Only `AND` conditions are allowed.
+        #   NOTE: Use the `filter_alias` from `Insight.Metadata.Field` message for the
+        #   filtering the corresponding fields in this filter field. (These expressions
+        #   are based on the filter language described at https://google.aip.dev/160).
+        # @param [String] group
+        #   Optional. Group id of the available groupings for the insight. Available
+        #   groupings could be fetched by calling insight list and get APIs in `BASIC`
+        #   view.
+        # @param [Fixnum] page_size
+        #   Optional. Requested page size. Server may return fewer items than requested.
+        #   If unspecified, server will pick an appropriate default.
+        # @param [String] page_token
+        #   Optional. Used to fetch the page represented by the token. Fetches the first
+        #   page when not set.
+        # @param [String] start_time
+        #   Required. Starting time for the duration for which insight is to be pulled.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::BeyondcorpV1alpha::GoogleCloudBeyondcorpSaasplatformInsightsV1alphaConfiguredInsightResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::BeyondcorpV1alpha::GoogleCloudBeyondcorpSaasplatformInsightsV1alphaConfiguredInsightResponse]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def configured_project_location_insight_insight(insight, aggregation: nil, custom_grouping_field_filter: nil, custom_grouping_group_fields: nil, end_time: nil, field_filter: nil, group: nil, page_size: nil, page_token: nil, start_time: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v1alpha/{+insight}:configuredInsight', options)
+          command.response_representation = Google::Apis::BeyondcorpV1alpha::GoogleCloudBeyondcorpSaasplatformInsightsV1alphaConfiguredInsightResponse::Representation
+          command.response_class = Google::Apis::BeyondcorpV1alpha::GoogleCloudBeyondcorpSaasplatformInsightsV1alphaConfiguredInsightResponse
+          command.params['insight'] = insight unless insight.nil?
+          command.query['aggregation'] = aggregation unless aggregation.nil?
+          command.query['customGrouping.fieldFilter'] = custom_grouping_field_filter unless custom_grouping_field_filter.nil?
+          command.query['customGrouping.groupFields'] = custom_grouping_group_fields unless custom_grouping_group_fields.nil?
+          command.query['endTime'] = end_time unless end_time.nil?
+          command.query['fieldFilter'] = field_filter unless field_filter.nil?
+          command.query['group'] = group unless group.nil?
+          command.query['pageSize'] = page_size unless page_size.nil?
+          command.query['pageToken'] = page_token unless page_token.nil?
+          command.query['startTime'] = start_time unless start_time.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Gets the value for a selected particular insight with default configuration.
+        # The default aggregation level is 'DAILY' and no grouping will be applied or
+        # default grouping if applicable. The data will be returned for recent 7 days.
+        # Use the organization level path for fetching at org level and project level
+        # path for fetching the insight value specific to a particular project. Setting
+        # the `view` to `BASIC` will only return the metadata for the insight.
+        # @param [String] name
+        #   Required. The resource name of the insight using the form: `organizations/`
+        #   organization_id`/locations/`location_id`/insights/`insight_id`` `projects/`
+        #   project_id`/locations/`location_id`/insights/`insight_id``
+        # @param [String] view
+        #   Required. Metadata only or full data view.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::BeyondcorpV1alpha::GoogleCloudBeyondcorpSaasplatformInsightsV1alphaInsight] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::BeyondcorpV1alpha::GoogleCloudBeyondcorpSaasplatformInsightsV1alphaInsight]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def get_project_location_insight(name, view: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v1alpha/{+name}', options)
+          command.response_representation = Google::Apis::BeyondcorpV1alpha::GoogleCloudBeyondcorpSaasplatformInsightsV1alphaInsight::Representation
+          command.response_class = Google::Apis::BeyondcorpV1alpha::GoogleCloudBeyondcorpSaasplatformInsightsV1alphaInsight
+          command.params['name'] = name unless name.nil?
+          command.query['view'] = view unless view.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Lists for all the available insights that could be fetched from the system.
+        # Allows to filter using category. Setting the `view` to `BASIC` will let you
+        # iterate over the list of insight metadatas.
+        # @param [String] parent
+        #   Required. The resource name of InsightMetadata using the form: `organizations/`
+        #   organization_id`/locations/`location`` `projects/`project_id`/locations/`
+        #   location_id``
+        # @param [String] filter
+        #   Optional. Filter expression to restrict the insights returned. Supported
+        #   filter fields: * `type` * `category` * `subCategory` Examples: * "category =
+        #   application AND type = count" * "category = application AND subCategory = iap"
+        #   * "type = status" Allowed values: * type: [count, latency, status, list] *
+        #   category: [application, device, request, security] * subCategory: [iap,
+        #   webprotect] NOTE: Only equality based comparison is allowed. Only `AND`
+        #   conjunction is allowed. NOTE: The 'AND' in the filter field needs to be in
+        #   capital letters only. NOTE: Just filtering on `subCategory` is not allowed. It
+        #   should be passed in with the parent `category` too. (These expressions are
+        #   based on the filter language described at https://google.aip.dev/160).
+        # @param [String] order_by
+        #   Optional. Hint for how to order the results. This is currently ignored.
+        # @param [Fixnum] page_size
+        #   Optional. Requested page size. Server may return fewer items than requested.
+        #   If unspecified, server will pick an appropriate default. NOTE: Default page
+        #   size is 50.
+        # @param [String] page_token
+        #   Optional. A token identifying a page of results the server should return.
+        # @param [String] view
+        #   Required. List only metadata or full data.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::BeyondcorpV1alpha::GoogleCloudBeyondcorpSaasplatformInsightsV1alphaListInsightsResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::BeyondcorpV1alpha::GoogleCloudBeyondcorpSaasplatformInsightsV1alphaListInsightsResponse]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def list_project_location_insights(parent, filter: nil, order_by: nil, page_size: nil, page_token: nil, view: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v1alpha/{+parent}/insights', options)
+          command.response_representation = Google::Apis::BeyondcorpV1alpha::GoogleCloudBeyondcorpSaasplatformInsightsV1alphaListInsightsResponse::Representation
+          command.response_class = Google::Apis::BeyondcorpV1alpha::GoogleCloudBeyondcorpSaasplatformInsightsV1alphaListInsightsResponse
+          command.params['parent'] = parent unless parent.nil?
+          command.query['filter'] = filter unless filter.nil?
+          command.query['orderBy'] = order_by unless order_by.nil?
+          command.query['pageSize'] = page_size unless page_size.nil?
+          command.query['pageToken'] = page_token unless page_token.nil?
+          command.query['view'] = view unless view.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Starts asynchronous cancellation on a long-running operation. The server makes
         # a best effort to cancel the operation, but success is not guaranteed. If the
         # server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.

data/lib/google/apis/beyondcorp_v1alpha.rb

@@ -24,7 +24,7 @@ module Google
     # Beyondcorp Enterprise provides identity and context aware access controls for
     # enterprise resources and enables zero-trust access. Using the Beyondcorp
     # Enterprise APIs, enterprises can set up multi-cloud and on-prem connectivity
-    # using the App Connector hybrid connectivity solution.
+    # solutions.
     #
     # @see https://cloud.google.com/
     module BeyondcorpV1alpha