google-api-client 0.37.0 → 0.38.0

data/generated/google/apis/logging_v2/classes.rb

@@ -140,12 +140,12 @@ module Google
         # @return [String]
         attr_accessor :kms_key_name
       
-        # Output Only. The resource name of the CMEK settings.
+        # Output only. The resource name of the CMEK settings.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
-        # Output Only. The service account that will be used by the Logs Router to
+        # Output only. The service account that will be used by the Logs Router to
         # access your Cloud KMS key.Before enabling CMEK for Logs Router, you must first
         # assign the role roles/cloudkms.cryptoKeyEncrypterDecrypter to the service
         # account that the Logs Router will use to access your Cloud KMS key. Use
@@ -432,6 +432,33 @@ module Google
         end
       end
       
+      # The response from ListBuckets (Beta).
+      class ListBucketsResponse
+        include Google::Apis::Core::Hashable
+      
+        # A list of buckets.
+        # Corresponds to the JSON property `buckets`
+        # @return [Array<Google::Apis::LoggingV2::LogBucket>]
+        attr_accessor :buckets
+      
+        # If there might be more results than appear in this response, then
+        # nextPageToken is included. To get the next set of results, call the same
+        # method again using the value of nextPageToken as pageToken.
+        # Corresponds to the JSON property `nextPageToken`
+        # @return [String]
+        attr_accessor :next_page_token
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @buckets = args[:buckets] if args.key?(:buckets)
+          @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
+        end
+      end
+      
       # Result returned from ListExclusions.
       class ListExclusionsResponse
         include Google::Apis::Core::Hashable
@@ -497,8 +524,9 @@ module Google
         # @return [String]
         attr_accessor :page_token
       
-        # Deprecated. Use resource_names instead. One or more project identifiers or
-        # project numbers from which to retrieve log entries. Example: "my-project-1A".
+        # Optional. Deprecated. Use resource_names instead. One or more project
+        # identifiers or project numbers from which to retrieve log entries. Example: "
+        # my-project-1A".
         # Corresponds to the JSON property `projectIds`
         # @return [Array<String>]
         attr_accessor :project_ids
@@ -673,6 +701,63 @@ module Google
         end
       end
       
+      # Describes a repository of logs (Beta).
+      class LogBucket
+        include Google::Apis::Core::Hashable
+      
+        # Output only. The creation timestamp of the bucket. This is not set for any of
+        # the default buckets.
+        # Corresponds to the JSON property `createTime`
+        # @return [String]
+        attr_accessor :create_time
+      
+        # Describes this bucket.
+        # Corresponds to the JSON property `description`
+        # @return [String]
+        attr_accessor :description
+      
+        # Output only. The bucket lifecycle state.
+        # Corresponds to the JSON property `lifecycleState`
+        # @return [String]
+        attr_accessor :lifecycle_state
+      
+        # The resource name of the bucket. For example: "projects/my-project-id/
+        # locations/my-location/buckets/my-bucket-id The supported locations are:  "
+        # global"  "us-central1"For the location of global it is unspecified where logs
+        # are actually stored. Once a bucket has been created, the location can not be
+        # changed.
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        # Logs will be retained by default for this amount of time, after which they
+        # will automatically be deleted. The minimum retention period is 1 day. If this
+        # value is set to zero at bucket creation time, the default time of 30 days will
+        # be used.
+        # Corresponds to the JSON property `retentionDays`
+        # @return [Fixnum]
+        attr_accessor :retention_days
+      
+        # Output only. The last update timestamp of the bucket.
+        # Corresponds to the JSON property `updateTime`
+        # @return [String]
+        attr_accessor :update_time
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @create_time = args[:create_time] if args.key?(:create_time)
+          @description = args[:description] if args.key?(:description)
+          @lifecycle_state = args[:lifecycle_state] if args.key?(:lifecycle_state)
+          @name = args[:name] if args.key?(:name)
+          @retention_days = args[:retention_days] if args.key?(:retention_days)
+          @update_time = args[:update_time] if args.key?(:update_time)
+        end
+      end
+      
       # An individual entry in a log.
       class LogEntry
         include Google::Apis::Core::Hashable
@@ -713,17 +798,17 @@ module Google
         # "organizations/[ORGANIZATION_ID]/logs/[LOG_ID]"
         # "billingAccounts/[BILLING_ACCOUNT_ID]/logs/[LOG_ID]"
         # "folders/[FOLDER_ID]/logs/[LOG_ID]"
-        # A project number may optionally be used in place of PROJECT_ID. The project
-        # number is translated to its corresponding PROJECT_ID internally and the
-        # log_name field will contain PROJECT_ID in queries and exports.[LOG_ID] must be
-        # URL-encoded within log_name. Example: "organizations/1234567890/logs/
-        # cloudresourcemanager.googleapis.com%2Factivity". [LOG_ID] must be less than
-        # 512 characters long and can only include the following characters: upper and
-        # lower case alphanumeric characters, forward-slash, underscore, hyphen, and
-        # period.For backward compatibility, if log_name begins with a forward-slash,
-        # such as /projects/..., then the log entry is ingested as usual but the forward-
-        # slash is removed. Listing the log entry will not show the leading slash and
-        # filtering for a log name with a leading slash will never return any results.
+        # A project number may be used in place of PROJECT_ID. The project number is
+        # translated to its corresponding PROJECT_ID internally and the log_name field
+        # will contain PROJECT_ID in queries and exports.[LOG_ID] must be URL-encoded
+        # within log_name. Example: "organizations/1234567890/logs/cloudresourcemanager.
+        # googleapis.com%2Factivity". [LOG_ID] must be less than 512 characters long and
+        # can only include the following characters: upper and lower case alphanumeric
+        # characters, forward-slash, underscore, hyphen, and period.For backward
+        # compatibility, if log_name begins with a forward-slash, such as /projects/...,
+        # then the log entry is ingested as usual but the forward-slash is removed.
+        # Listing the log entry will not show the leading slash and filtering for a log
+        # name with a leading slash will never return any results.
         # Corresponds to the JSON property `logName`
         # @return [String]
         attr_accessor :log_name
@@ -787,8 +872,7 @@ module Google
       
         # Optional. The span ID within the trace associated with the log entry.For Trace
         # spans, this is the same format that the Trace API v2 uses: a 16-character
-        # hexadecimal encoding of an 8-byte array, such as <code>"000000000000004a"</
-        # code>.
+        # hexadecimal encoding of an 8-byte array, such as 000000000000004a.
         # Corresponds to the JSON property `spanId`
         # @return [String]
         attr_accessor :span_id
@@ -803,10 +887,9 @@ module Google
         # If this field is omitted in a new log entry, then Logging assigns it the
         # current time. Timestamps have nanosecond accuracy, but trailing zeros in the
         # fractional seconds might be omitted when the timestamp is displayed.Incoming
-        # log entries should have timestamps that are no more than the logs retention
-        # period in the past, and no more than 24 hours in the future. Log entries
-        # outside those time boundaries will not be available when calling entries.list,
-        # but those log entries can still be exported with LogSinks.
+        # log entries must have timestamps that don't exceed the logs retention period
+        # in the past, and that don't exceed 24 hours in the future. Log entries outside
+        # those time boundaries aren't ingested by Logging.
         # Corresponds to the JSON property `timestamp`
         # @return [String]
         attr_accessor :timestamp
@@ -1209,11 +1292,6 @@ module Google
         attr_accessor :disabled
         alias_method :disabled?, :disabled
       
-        # Do not use. This field is ignored.
-        # Corresponds to the JSON property `endTime`
-        # @return [String]
-        attr_accessor :end_time
-      
         # Optional. An advanced logs filter. The only exported log entries are those
         # that are in the resource owning the sink and that match the filter. For
         # example:
@@ -1254,11 +1332,6 @@ module Google
         # @return [String]
         attr_accessor :output_version_format
       
-        # Do not use. This field is ignored.
-        # Corresponds to the JSON property `startTime`
-        # @return [String]
-        attr_accessor :start_time
-      
         # Output only. The last update timestamp of the sink.This field may not be
         # present for older sinks.
         # Corresponds to the JSON property `updateTime`
@@ -1288,12 +1361,10 @@ module Google
           @description = args[:description] if args.key?(:description)
           @destination = args[:destination] if args.key?(:destination)
           @disabled = args[:disabled] if args.key?(:disabled)
-          @end_time = args[:end_time] if args.key?(:end_time)
           @filter = args[:filter] if args.key?(:filter)
           @include_children = args[:include_children] if args.key?(:include_children)
           @name = args[:name] if args.key?(:name)
           @output_version_format = args[:output_version_format] if args.key?(:output_version_format)
-          @start_time = args[:start_time] if args.key?(:start_time)
           @update_time = args[:update_time] if args.key?(:update_time)
           @writer_identity = args[:writer_identity] if args.key?(:writer_identity)
         end
@@ -1990,10 +2061,9 @@ module Google
         # [LOG_ID] must be URL-encoded. For example:
         # "projects/my-project-id/logs/syslog"
         # "organizations/1234567890/logs/cloudresourcemanager.googleapis.com%2Factivity"
-        # The permission <code>logging.logEntries.create</code> is needed on each
-        # project, organization, billing account, or folder that is receiving new log
-        # entries, whether the resource is specified in <code>logName</code> or in an
-        # individual log entry.
+        # The permission logging.logEntries.create is needed on each project,
+        # organization, billing account, or folder that is receiving new log entries,
+        # whether the resource is specified in logName or in an individual log entry.
         # Corresponds to the JSON property `logName`
         # @return [String]
         attr_accessor :log_name
@@ -2039,7 +2109,7 @@ module Google
         end
       end
       
-      # Result returned from WriteLogEntries. empty
+      # Result returned from WriteLogEntries.
       class WriteLogEntriesResponse
         include Google::Apis::Core::Hashable
       

data/generated/google/apis/logging_v2/representations.rb

@@ -76,6 +76,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class ListBucketsResponse
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class ListExclusionsResponse
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -118,6 +124,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class LogBucket
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class LogEntry
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -310,6 +322,15 @@ module Google
         end
       end
       
+      class ListBucketsResponse
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :buckets, as: 'buckets', class: Google::Apis::LoggingV2::LogBucket, decorator: Google::Apis::LoggingV2::LogBucket::Representation
+      
+          property :next_page_token, as: 'nextPageToken'
+        end
+      end
+      
       class ListExclusionsResponse
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -375,6 +396,18 @@ module Google
         end
       end
       
+      class LogBucket
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :create_time, as: 'createTime'
+          property :description, as: 'description'
+          property :lifecycle_state, as: 'lifecycleState'
+          property :name, as: 'name'
+          property :retention_days, as: 'retentionDays'
+          property :update_time, as: 'updateTime'
+        end
+      end
+      
       class LogEntry
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -472,12 +505,10 @@ module Google
           property :description, as: 'description'
           property :destination, as: 'destination'
           property :disabled, as: 'disabled'
-          property :end_time, as: 'endTime'
           property :filter, as: 'filter'
           property :include_children, as: 'includeChildren'
           property :name, as: 'name'
           property :output_version_format, as: 'outputVersionFormat'
-          property :start_time, as: 'startTime'
           property :update_time, as: 'updateTime'
           property :writer_identity, as: 'writerIdentity'
         end