google-api-client 0.36.0 → 0.37.0

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

@@ -36,6 +36,16 @@ module Google
         attr_accessor :use_partitioned_tables
         alias_method :use_partitioned_tables?, :use_partitioned_tables
       
+        # Output only. True if new timestamp column based partitioning is in use, false
+        # if legacy ingestion-time partitioning is in use. All new sinks will have this
+        # field set true and will use timestamp column based partitioning. If
+        # use_partitioned_tables is false, this value has no meaning and will be false.
+        # Legacy sinks using partitioned tables will have this field set to false.
+        # Corresponds to the JSON property `usesTimestampColumnPartitioning`
+        # @return [Boolean]
+        attr_accessor :uses_timestamp_column_partitioning
+        alias_method :uses_timestamp_column_partitioning?, :uses_timestamp_column_partitioning
+      
         def initialize(**args)
            update!(**args)
         end
@@ -43,6 +53,7 @@ module Google
         # Update properties of this object
         def update!(**args)
           @use_partitioned_tables = args[:use_partitioned_tables] if args.key?(:use_partitioned_tables)
+          @uses_timestamp_column_partitioning = args[:uses_timestamp_column_partitioning] if args.key?(:uses_timestamp_column_partitioning)
         end
       end
       
@@ -104,6 +115,58 @@ module Google
         end
       end
       
+      # Describes the customer-managed encryption key (CMEK) settings associated with
+      # a project, folder, organization, billing account, or flexible resource.Note:
+      # CMEK for the Logs Router can currently only be configured for GCP
+      # organizations. Once configured, it applies to all projects and folders in the
+      # GCP organization.See Enabling CMEK for Logs Router for more information.
+      class CmekSettings
+        include Google::Apis::Core::Hashable
+      
+        # The resource name for the configured Cloud KMS key.KMS key name format:  "
+        # projects/PROJECT_ID/locations/LOCATION/keyRings/KEYRING/cryptoKeys/KEY"For
+        # example:  "projects/my-project-id/locations/my-region/keyRings/key-ring-name/
+        # cryptoKeys/key-name"To enable CMEK for the Logs Router, set this field to a
+        # valid kms_key_name for which the associated service account has the required
+        # roles/cloudkms.cryptoKeyEncrypterDecrypter role assigned for the key.The Cloud
+        # KMS key used by the Log Router can be updated by changing the kms_key_name to
+        # a new valid key name. Encryption operations that are in progress will be
+        # completed with the key that was in use when they started. Decryption
+        # operations will be completed using the key that was used at the time of
+        # encryption unless access to that key has been revoked.To disable CMEK for the
+        # Logs Router, set this field to an empty string.See Enabling CMEK for Logs
+        # Router for more information.
+        # Corresponds to the JSON property `kmsKeyName`
+        # @return [String]
+        attr_accessor :kms_key_name
+      
+        # 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
+        # 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
+        # GetCmekSettings to obtain the service account ID.See Enabling CMEK for Logs
+        # Router for more information.
+        # Corresponds to the JSON property `serviceAccountId`
+        # @return [String]
+        attr_accessor :service_account_id
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @kms_key_name = args[:kms_key_name] if args.key?(:kms_key_name)
+          @name = args[:name] if args.key?(:name)
+          @service_account_id = args[:service_account_id] if args.key?(:service_account_id)
+        end
+      end
+      
       # A generic empty message that you can re-use to avoid defining duplicated empty
       # messages in your APIs. A typical example is to use it as the request or the
       # response type of an API method. For instance:
@@ -623,10 +686,12 @@ module Google
       
         # Optional. A unique identifier for the log entry. If you provide a value, then
         # Logging considers other log entries in the same project, with the same
-        # timestamp, and with the same insert_id to be duplicates which can be removed.
-        # If omitted in new log entries, then Logging assigns its own unique identifier.
-        # The insert_id is also used to order log entries that have the same timestamp
-        # value.
+        # timestamp, and with the same insert_id to be duplicates which are removed in a
+        # single query result. However, there are no guarantees of de-duplication in the
+        # export of logs.If the insert_id is omitted when writing a log entry, the
+        # Logging API  assigns its own unique identifier in this field.In queries, the
+        # insert_id is also used to order log entries that have the same log_name and
+        # timestamp values.
         # Corresponds to the JSON property `insertId`
         # @return [String]
         attr_accessor :insert_id
@@ -1302,39 +1367,54 @@ module Google
         # @return [String]
         attr_accessor :type
       
-        # The unit in which the metric value is reported. It is only applicable if the
-        # value_type is INT64, DOUBLE, or DISTRIBUTION. The supported units are a subset
-        # of The Unified Code for Units of Measure (http://unitsofmeasure.org/ucum.html)
-        # standard:Basic units (UNIT)
+        # The units in which the metric value is reported. It is only applicable if the
+        # value_type is INT64, DOUBLE, or DISTRIBUTION. The unit defines the
+        # representation of the stored metric values.Different systems may scale the
+        # values to be more easily displayed (so a value of 0.02KBy might be displayed
+        # as 20By, and a value of 3523KBy might be displayed as 3.5MBy). However, if the
+        # unit is KBy, then the value of the metric is always in thousands of bytes, no
+        # matter how it may be displayed..If you want a custom metric to record the
+        # exact number of CPU-seconds used by a job, you can create an INT64 CUMULATIVE
+        # metric whose unit is s`CPU` (or equivalently 1s`CPU` or just s). If the job
+        # uses 12,005 CPU-seconds, then the value is written as 12005.Alternatively, if
+        # you want a custom metric to record data in a more granular way, you can create
+        # a DOUBLE CUMULATIVE metric whose unit is ks`CPU`, and then write the value 12.
+        # 005 (which is 12005/1000), or use Kis`CPU` and write 11.723 (which is 12005/
+        # 1024).The supported units are a subset of The Unified Code for Units of
+        # Measure (http://unitsofmeasure.org/ucum.html) standard:Basic units (UNIT)
         # bit bit
         # By byte
         # s second
         # min minute
         # h hour
         # d dayPrefixes (PREFIX)
-        # k kilo (10**3)
-        # M mega (10**6)
-        # G giga (10**9)
-        # T tera (10**12)
-        # P peta (10**15)
-        # E exa (10**18)
-        # Z zetta (10**21)
-        # Y yotta (10**24)
-        # m milli (10**-3)
-        # u micro (10**-6)
-        # n nano (10**-9)
-        # p pico (10**-12)
-        # f femto (10**-15)
-        # a atto (10**-18)
-        # z zepto (10**-21)
-        # y yocto (10**-24)
-        # Ki kibi (2**10)
-        # Mi mebi (2**20)
-        # Gi gibi (2**30)
-        # Ti tebi (2**40)GrammarThe grammar also includes these connectors:
-        # / division (as an infix operator, e.g. 1/s).
-        # . multiplication (as an infix operator, e.g. GBy.d)The grammar for a unit is
-        # as follows:
+        # k kilo (10^3)
+        # M mega (10^6)
+        # G giga (10^9)
+        # T tera (10^12)
+        # P peta (10^15)
+        # E exa (10^18)
+        # Z zetta (10^21)
+        # Y yotta (10^24)
+        # m milli (10^-3)
+        # u micro (10^-6)
+        # n nano (10^-9)
+        # p pico (10^-12)
+        # f femto (10^-15)
+        # a atto (10^-18)
+        # z zepto (10^-21)
+        # y yocto (10^-24)
+        # Ki kibi (2^10)
+        # Mi mebi (2^20)
+        # Gi gibi (2^30)
+        # Ti tebi (2^40)
+        # Pi pebi (2^50)GrammarThe grammar also includes these connectors:
+        # / division or ratio (as an infix operator). For examples,  kBy/`email` or MiBy/
+        # 10ms (although you should almost never  have /s in a metric unit; rates should
+        # always be computed at  query time from the underlying cumulative or delta
+        # value).
+        # . multiplication or composition (as an infix operator). For  examples, GBy.d
+        # or k`watt`.h.The grammar for a unit is as follows:
         # Expression = Component ` "." Component ` ` "/" Component ` ;
         # Component = ( [ PREFIX ] UNIT | "%" ) [ Annotation ]
         # | Annotation
@@ -1342,14 +1422,24 @@ module Google
         # ;
         # Annotation = "`" NAME "`" ;
         # Notes:
-        # Annotation is just a comment if it follows a UNIT and is  equivalent to 1 if
-        # it is used alone. For examples,  `requests`/s == 1/s, By`transmitted`/s == By/
-        # s.
-        # NAME is a sequence of non-blank printable ASCII characters not  containing '`'
-        # or '`'.
-        # 1 represents dimensionless value 1, such as in 1/s.
-        # % represents dimensionless value 1/100, and annotates values giving  a
-        # percentage.
+        # Annotation is just a comment if it follows a UNIT. If the annotation  is used
+        # alone, then the unit is equivalent to 1. For examples,  `request`/s == 1/s, By`
+        # transmitted`/s == By/s.
+        # NAME is a sequence of non-blank printable ASCII characters not  containing `
+        # or `.
+        # 1 represents a unitary dimensionless  unit (https://en.wikipedia.org/wiki/
+        # Dimensionless_quantity) of 1, such  as in 1/s. It is typically used when none
+        # of the basic units are  appropriate. For example, "new users per day" can be
+        # represented as  1/d or `new-users`/d (and a metric value 5 would mean "5 new
+        # users). Alternatively, "thousands of page views per day" would be  represented
+        # as 1000/d or k1/d or k`page_views`/d (and a metric  value of 5.3 would mean "
+        # 5300 page views per day").
+        # % represents dimensionless value of 1/100, and annotates values giving  a
+        # percentage (so the metric values are typically in the range of 0..100,  and a
+        # metric value 3 means "3 percent").
+        # 10^2.% indicates a metric contains a ratio, typically in the range  0..1, that
+        # will be multiplied by 100 and displayed as a percentage  (so a metric value 0.
+        # 03 means "3 percent").
         # Corresponds to the JSON property `unit`
         # @return [String]
         attr_accessor :unit

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

@@ -34,6 +34,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class CmekSettings
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class Empty
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -218,6 +224,7 @@ module Google
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
           property :use_partitioned_tables, as: 'usePartitionedTables'
+          property :uses_timestamp_column_partitioning, as: 'usesTimestampColumnPartitioning'
         end
       end
       
@@ -233,6 +240,15 @@ module Google
         end
       end
       
+      class CmekSettings
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :kms_key_name, as: 'kmsKeyName'
+          property :name, as: 'name'
+          property :service_account_id, as: 'serviceAccountId'
+        end
+      end
+      
       class Empty
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation

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

@@ -25,7 +25,8 @@ module Google
       # Writes log entries and manages your Stackdriver Logging configuration. The
       #  table entries below are presented in alphabetical order, not in order of
       #  common use. For explanations of the concepts found in the table entries, read
-      #  the Stackdriver Logging documentation.
+      #  the <a href=https://cloud.google.com/logging/docs>Stackdriver Logging
+      #  documentation</a>.
       #
       # @example
       #    require 'google/apis/logging_v2'
@@ -1601,6 +1602,98 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Gets the Logs Router CMEK settings for the given resource.Note: CMEK for the
+        # Logs Router can currently only be configured for GCP organizations. Once
+        # configured, it applies to all projects and folders in the GCP organization.See
+        # Enabling CMEK for Logs Router for more information.
+        # @param [String] name
+        #   Required. The resource for which to retrieve CMEK settings.
+        #   "projects/[PROJECT_ID]/cmekSettings"
+        #   "organizations/[ORGANIZATION_ID]/cmekSettings"
+        #   "billingAccounts/[BILLING_ACCOUNT_ID]/cmekSettings"
+        #   "folders/[FOLDER_ID]/cmekSettings"
+        #   Example: "organizations/12345/cmekSettings".Note: CMEK for the Logs Router can
+        #   currently only be configured for GCP organizations. Once configured, it
+        #   applies to all projects and folders in the GCP organization.
+        # @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::LoggingV2::CmekSettings] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::LoggingV2::CmekSettings]
+        #
+        # @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_cmek_settings(name, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v2/{+name}/cmekSettings', options)
+          command.response_representation = Google::Apis::LoggingV2::CmekSettings::Representation
+          command.response_class = Google::Apis::LoggingV2::CmekSettings
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Updates the Logs Router CMEK settings for the given resource.Note: CMEK for
+        # the Logs Router can currently only be configured for GCP organizations. Once
+        # configured, it applies to all projects and folders in the GCP organization.
+        # UpdateCmekSettings will fail if 1) kms_key_name is invalid, or 2) the
+        # associated service account does not have the required roles/cloudkms.
+        # cryptoKeyEncrypterDecrypter role assigned for the key, or 3) access to the key
+        # is disabled.See Enabling CMEK for Logs Router for more information.
+        # @param [String] name
+        #   Required. The resource name for the CMEK settings to update.
+        #   "projects/[PROJECT_ID]/cmekSettings"
+        #   "organizations/[ORGANIZATION_ID]/cmekSettings"
+        #   "billingAccounts/[BILLING_ACCOUNT_ID]/cmekSettings"
+        #   "folders/[FOLDER_ID]/cmekSettings"
+        #   Example: "organizations/12345/cmekSettings".Note: CMEK for the Logs Router can
+        #   currently only be configured for GCP organizations. Once configured, it
+        #   applies to all projects and folders in the GCP organization.
+        # @param [Google::Apis::LoggingV2::CmekSettings] cmek_settings_object
+        # @param [String] update_mask
+        #   Optional. Field mask identifying which fields from cmek_settings should be
+        #   updated. A field will be overwritten if and only if it is in the update mask.
+        #   Output only fields cannot be updated.See FieldMask for more information.
+        #   Example: "updateMask=kmsKeyName"
+        # @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::LoggingV2::CmekSettings] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::LoggingV2::CmekSettings]
+        #
+        # @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 update_organization_cmek_settings(name, cmek_settings_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:patch, 'v2/{+name}/cmekSettings', options)
+          command.request_representation = Google::Apis::LoggingV2::CmekSettings::Representation
+          command.request_object = cmek_settings_object
+          command.response_representation = Google::Apis::LoggingV2::CmekSettings::Representation
+          command.response_class = Google::Apis::LoggingV2::CmekSettings
+          command.params['name'] = name unless name.nil?
+          command.query['updateMask'] = update_mask unless update_mask.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 exclusion in a specified parent resource. Only log entries
         # belonging to that resource can be excluded. You can have up to 10 exclusions
         # in a resource.
@@ -3167,6 +3260,98 @@ module Google
           command.query['quotaUser'] = quota_user unless quota_user.nil?
           execute_or_queue_command(command, &block)
         end
+        
+        # Gets the Logs Router CMEK settings for the given resource.Note: CMEK for the
+        # Logs Router can currently only be configured for GCP organizations. Once
+        # configured, it applies to all projects and folders in the GCP organization.See
+        # Enabling CMEK for Logs Router for more information.
+        # @param [String] name
+        #   Required. The resource for which to retrieve CMEK settings.
+        #   "projects/[PROJECT_ID]/cmekSettings"
+        #   "organizations/[ORGANIZATION_ID]/cmekSettings"
+        #   "billingAccounts/[BILLING_ACCOUNT_ID]/cmekSettings"
+        #   "folders/[FOLDER_ID]/cmekSettings"
+        #   Example: "organizations/12345/cmekSettings".Note: CMEK for the Logs Router can
+        #   currently only be configured for GCP organizations. Once configured, it
+        #   applies to all projects and folders in the GCP organization.
+        # @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::LoggingV2::CmekSettings] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::LoggingV2::CmekSettings]
+        #
+        # @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_cmek_settings(name, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v2/{+name}/cmekSettings', options)
+          command.response_representation = Google::Apis::LoggingV2::CmekSettings::Representation
+          command.response_class = Google::Apis::LoggingV2::CmekSettings
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Updates the Logs Router CMEK settings for the given resource.Note: CMEK for
+        # the Logs Router can currently only be configured for GCP organizations. Once
+        # configured, it applies to all projects and folders in the GCP organization.
+        # UpdateCmekSettings will fail if 1) kms_key_name is invalid, or 2) the
+        # associated service account does not have the required roles/cloudkms.
+        # cryptoKeyEncrypterDecrypter role assigned for the key, or 3) access to the key
+        # is disabled.See Enabling CMEK for Logs Router for more information.
+        # @param [String] name
+        #   Required. The resource name for the CMEK settings to update.
+        #   "projects/[PROJECT_ID]/cmekSettings"
+        #   "organizations/[ORGANIZATION_ID]/cmekSettings"
+        #   "billingAccounts/[BILLING_ACCOUNT_ID]/cmekSettings"
+        #   "folders/[FOLDER_ID]/cmekSettings"
+        #   Example: "organizations/12345/cmekSettings".Note: CMEK for the Logs Router can
+        #   currently only be configured for GCP organizations. Once configured, it
+        #   applies to all projects and folders in the GCP organization.
+        # @param [Google::Apis::LoggingV2::CmekSettings] cmek_settings_object
+        # @param [String] update_mask
+        #   Optional. Field mask identifying which fields from cmek_settings should be
+        #   updated. A field will be overwritten if and only if it is in the update mask.
+        #   Output only fields cannot be updated.See FieldMask for more information.
+        #   Example: "updateMask=kmsKeyName"
+        # @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::LoggingV2::CmekSettings] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::LoggingV2::CmekSettings]
+        #
+        # @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 update_cmek_settings(name, cmek_settings_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:patch, 'v2/{+name}/cmekSettings', options)
+          command.request_representation = Google::Apis::LoggingV2::CmekSettings::Representation
+          command.request_object = cmek_settings_object
+          command.response_representation = Google::Apis::LoggingV2::CmekSettings::Representation
+          command.response_class = Google::Apis::LoggingV2::CmekSettings
+          command.params['name'] = name unless name.nil?
+          command.query['updateMask'] = update_mask unless update_mask.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
 
         protected
 

data/generated/google/apis/logging_v2.rb

@@ -23,12 +23,13 @@ module Google
     # Writes log entries and manages your Stackdriver Logging configuration. The
     # table entries below are presented in alphabetical order, not in order of
     # common use. For explanations of the concepts found in the table entries, read
-    # the Stackdriver Logging documentation.
+    # the <a href=https://cloud.google.com/logging/docs>Stackdriver Logging
+    # documentation</a>.
     #
     # @see https://cloud.google.com/logging/docs/
     module LoggingV2
       VERSION = 'V2'
-      REVISION = '20191115'
+      REVISION = '20200125'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

data/generated/google/apis/manufacturers_v1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://developers.google.com/manufacturers/
     module ManufacturersV1
       VERSION = 'V1'
-      REVISION = '20180903'
+      REVISION = '20200213'
 
       # Manage your product listings for Google Manufacturer Center
       AUTH_MANUFACTURERCENTER = 'https://www.googleapis.com/auth/manufacturercenter'