# Copyright 2017, Google Inc. All rights reserved.
#
# 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.

module Google
  module Logging
    module V2
      # The parameters to DeleteLog.
      # @!attribute [rw] log_name
      #   @return [String]
      #     Required. The resource name of the log to delete:
      #
      #         "projects/[PROJECT_ID]/logs/[LOG_ID]"
      #         "organizations/[ORGANIZATION_ID]/logs/[LOG_ID]"
      #
      #     +[LOG_ID]+ must be URL-encoded. For example,
      #     +"projects/my-project-id/logs/syslog"+,
      #     +"organizations/1234567890/logs/cloudresourcemanager.googleapis.com%2Factivity"+.
      #     For more information about log names, see
      #     LogEntry.
      class DeleteLogRequest; end

      # The parameters to WriteLogEntries.
      # @!attribute [rw] log_name
      #   @return [String]
      #     Optional. A default log resource name that is assigned to all log entries
      #     in +entries+ that do not specify a value for +log_name+:
      #
      #         "projects/[PROJECT_ID]/logs/[LOG_ID]"
      #         "organizations/[ORGANIZATION_ID]/logs/[LOG_ID]"
      #
      #     +[LOG_ID]+ must be URL-encoded. For example,
      #     +"projects/my-project-id/logs/syslog"+ or
      #     +"organizations/1234567890/logs/cloudresourcemanager.googleapis.com%2Factivity"+.
      #     For more information about log names, see
      #     LogEntry.
      # @!attribute [rw] resource
      #   @return [Google::Api::MonitoredResource]
      #     Optional. A default monitored resource object that is assigned to all log
      #     entries in +entries+ that do not specify a value for +resource+. Example:
      #
      #         { "type": "gce_instance",
      #           "labels": {
      #             "zone": "us-central1-a", "instance_id": "00000000000000000000" }}
      #
      #     See LogEntry.
      # @!attribute [rw] labels
      #   @return [Hash{String => String}]
      #     Optional. Default labels that are added to the +labels+ field of all log
      #     entries in +entries+. If a log entry already has a label with the same key
      #     as a label in this parameter, then the log entry's label is not changed.
      #     See LogEntry.
      # @!attribute [rw] entries
      #   @return [Array<Google::Logging::V2::LogEntry>]
      #     Required. The log entries to write. Values supplied for the fields
      #     +log_name+, +resource+, and +labels+ in this +entries.write+ request are
      #     added to those log entries that do not provide their own values for the
      #     fields.
      #
      #     To improve throughput and to avoid exceeding the
      #     {quota limit}[https://cloud.google.com/logging/quota-policy] for calls to +entries.write+,
      #     you should write multiple log entries at once rather than
      #     calling this method for each individual log entry.
      # @!attribute [rw] partial_success
      #   @return [true, false]
      #     Optional. Whether valid entries should be written even if some other
      #     entries fail due to INVALID_ARGUMENT or PERMISSION_DENIED errors. If any
      #     entry is not written, the response status will be the error associated
      #     with one of the failed entries and include error details in the form of
      #     WriteLogEntriesPartialErrors.
      class WriteLogEntriesRequest; end

      # Result returned from WriteLogEntries.
      # empty
      class WriteLogEntriesResponse; end

      # The parameters to +ListLogEntries+.
      # @!attribute [rw] project_ids
      #   @return [Array<String>]
      #     Deprecated. Use +resource_names+ instead.  One or more project identifiers
      #     or project numbers from which to retrieve log entries.  Example:
      #     +"my-project-1A"+. If present, these project identifiers are converted to
      #     resource name format and added to the list of resources in
      #     +resource_names+.
      # @!attribute [rw] resource_names
      #   @return [Array<String>]
      #     Required. Names of one or more resources from which to retrieve log
      #     entries:
      #
      #         "projects/[PROJECT_ID]"
      #         "organizations/[ORGANIZATION_ID]"
      #
      #     Projects listed in the +project_ids+ field are added to this list.
      # @!attribute [rw] filter
      #   @return [String]
      #     Optional. A filter that chooses which log entries to return.  See {Advanced
      #     Logs Filters}[https://cloud.google.com/logging/docs/view/advanced_filters].  Only log entries that
      #     match the filter are returned.  An empty filter matches all log entries in
      #     the resources listed in +resource_names+. Referencing a parent resource
      #     that is not listed in +resource_names+ will cause the filter to return no
      #     results.
      #     The maximum length of the filter is 20000 characters.
      # @!attribute [rw] order_by
      #   @return [String]
      #     Optional. How the results should be sorted.  Presently, the only permitted
      #     values are +"timestamp asc"+ (default) and +"timestamp desc"+. The first
      #     option returns entries in order of increasing values of
      #     +LogEntry.timestamp+ (oldest first), and the second option returns entries
      #     in order of decreasing timestamps (newest first).  Entries with equal
      #     timestamps are returned in order of +LogEntry.insertId+.
      # @!attribute [rw] page_size
      #   @return [Integer]
      #     Optional. The maximum number of results to return from this request.
      #     Non-positive values are ignored.  The presence of +nextPageToken+ in the
      #     response indicates that more results might be available.
      # @!attribute [rw] page_token
      #   @return [String]
      #     Optional. If present, then retrieve the next batch of results from the
      #     preceding call to this method.  +pageToken+ must be the value of
      #     +nextPageToken+ from the previous response.  The values of other method
      #     parameters should be identical to those in the previous call.
      class ListLogEntriesRequest; end

      # Result returned from +ListLogEntries+.
      # @!attribute [rw] entries
      #   @return [Array<Google::Logging::V2::LogEntry>]
      #     A list of log entries.
      # @!attribute [rw] next_page_token
      #   @return [String]
      #     If there might be more results than those appearing in this response, then
      #     +nextPageToken+ is included.  To get the next set of results, call this
      #     method again using the value of +nextPageToken+ as +pageToken+.
      #
      #     If a value for +next_page_token+ appears and the +entries+ field is empty,
      #     it means that the search found no log entries so far but it did not have
      #     time to search all the possible log entries.  Retry the method with this
      #     value for +page_token+ to continue the search.  Alternatively, consider
      #     speeding up the search by changing your filter to specify a single log name
      #     or resource type, or to narrow the time range of the search.
      class ListLogEntriesResponse; end

      # The parameters to ListMonitoredResourceDescriptors
      # @!attribute [rw] page_size
      #   @return [Integer]
      #     Optional. The maximum number of results to return from this request.
      #     Non-positive values are ignored.  The presence of +nextPageToken+ in the
      #     response indicates that more results might be available.
      # @!attribute [rw] page_token
      #   @return [String]
      #     Optional. If present, then retrieve the next batch of results from the
      #     preceding call to this method.  +pageToken+ must be the value of
      #     +nextPageToken+ from the previous response.  The values of other method
      #     parameters should be identical to those in the previous call.
      class ListMonitoredResourceDescriptorsRequest; end

      # Result returned from ListMonitoredResourceDescriptors.
      # @!attribute [rw] resource_descriptors
      #   @return [Array<Google::Api::MonitoredResourceDescriptor>]
      #     A list of resource descriptors.
      # @!attribute [rw] next_page_token
      #   @return [String]
      #     If there might be more results than those appearing in this response, then
      #     +nextPageToken+ is included.  To get the next set of results, call this
      #     method again using the value of +nextPageToken+ as +pageToken+.
      class ListMonitoredResourceDescriptorsResponse; end

      # The parameters to ListLogs.
      # @!attribute [rw] parent
      #   @return [String]
      #     Required. The resource name that owns the logs:
      #
      #         "projects/[PROJECT_ID]"
      #         "organizations/[ORGANIZATION_ID]"
      # @!attribute [rw] page_size
      #   @return [Integer]
      #     Optional. The maximum number of results to return from this request.
      #     Non-positive values are ignored.  The presence of +nextPageToken+ in the
      #     response indicates that more results might be available.
      # @!attribute [rw] page_token
      #   @return [String]
      #     Optional. If present, then retrieve the next batch of results from the
      #     preceding call to this method.  +pageToken+ must be the value of
      #     +nextPageToken+ from the previous response.  The values of other method
      #     parameters should be identical to those in the previous call.
      class ListLogsRequest; end

      # Result returned from ListLogs.
      # @!attribute [rw] log_names
      #   @return [Array<String>]
      #     A list of log names. For example,
      #     +"projects/my-project/syslog"+ or
      #     +"organizations/123/cloudresourcemanager.googleapis.com%2Factivity"+.
      # @!attribute [rw] next_page_token
      #   @return [String]
      #     If there might be more results than those appearing in this response, then
      #     +nextPageToken+ is included.  To get the next set of results, call this
      #     method again using the value of +nextPageToken+ as +pageToken+.
      class ListLogsResponse; end
    end
  end
end