google-api-client 0.30.10 → 0.31.0

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

@@ -935,7 +935,12 @@ module Google
         # @return [String]
         attr_accessor :etag
       
-        # Deprecated.
+        # Specifies the format of the policy.
+        # Valid values are 0, 1, and 3. Requests specifying an invalid value will be
+        # rejected.
+        # Policies with any conditional bindings must specify version 3. Policies
+        # without any conditional bindings may specify any valid value or leave the
+        # field unset.
         # Corresponds to the JSON property `version`
         # @return [Fixnum]
         attr_accessor :version
@@ -1367,6 +1372,9 @@ module Google
         attr_accessor :valid_after_time
       
         # The key can be used before this timestamp.
+        # For system-managed key pairs, this timestamp is the end time for the
+        # private key signing operation. The public key could still be used
+        # for verification for a few hours after this time.
         # Corresponds to the JSON property `validBeforeTime`
         # @return [String]
         attr_accessor :valid_before_time

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

@@ -1046,9 +1046,11 @@ module Google
         #   See the operation documentation for the appropriate value for this field.
         # @param [Fixnum] options_requested_policy_version
         #   Optional. The policy format version to be returned.
-        #   Acceptable values are 0, 1, and 3.
-        #   If the value is 0, or the field is omitted, policy format version 1 will be
-        #   returned.
+        #   Valid values are 0, 1, and 3. Requests specifying an invalid value will be
+        #   rejected.
+        #   Requests for policies with any conditional bindings must specify version 3.
+        #   Policies without any conditional bindings may specify any valid value or
+        #   leave the field unset.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user

data/generated/google/apis/iap_v1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://cloud.google.com/iap
     module IapV1
       VERSION = 'V1'
-      REVISION = '20190802'
+      REVISION = '20190906'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

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

@@ -141,9 +141,11 @@ module Google
         include Google::Apis::Core::Hashable
       
         # Optional. The policy format version to be returned.
-        # Acceptable values are 0, 1, and 3.
-        # If the value is 0, or the field is omitted, policy format version 1 will be
-        # returned.
+        # Valid values are 0, 1, and 3. Requests specifying an invalid value will be
+        # rejected.
+        # Requests for policies with any conditional bindings must specify version 3.
+        # Policies without any conditional bindings may specify any valid value or
+        # leave the field unset.
         # Corresponds to the JSON property `requestedPolicyVersion`
         # @return [Fixnum]
         attr_accessor :requested_policy_version
@@ -218,7 +220,12 @@ module Google
         # @return [String]
         attr_accessor :etag
       
-        # Deprecated.
+        # Specifies the format of the policy.
+        # Valid values are 0, 1, and 3. Requests specifying an invalid value will be
+        # rejected.
+        # Policies with any conditional bindings must specify version 3. Policies
+        # without any conditional bindings may specify any valid value or leave the
+        # field unset.
         # Corresponds to the JSON property `version`
         # @return [Fixnum]
         attr_accessor :version

data/generated/google/apis/iap_v1beta1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://cloud.google.com/iap
     module IapV1beta1
       VERSION = 'V1beta1'
-      REVISION = '20190802'
+      REVISION = '20190906'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

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

@@ -141,9 +141,11 @@ module Google
         include Google::Apis::Core::Hashable
       
         # Optional. The policy format version to be returned.
-        # Acceptable values are 0, 1, and 3.
-        # If the value is 0, or the field is omitted, policy format version 1 will be
-        # returned.
+        # Valid values are 0, 1, and 3. Requests specifying an invalid value will be
+        # rejected.
+        # Requests for policies with any conditional bindings must specify version 3.
+        # Policies without any conditional bindings may specify any valid value or
+        # leave the field unset.
         # Corresponds to the JSON property `requestedPolicyVersion`
         # @return [Fixnum]
         attr_accessor :requested_policy_version
@@ -218,7 +220,12 @@ module Google
         # @return [String]
         attr_accessor :etag
       
-        # Deprecated.
+        # Specifies the format of the policy.
+        # Valid values are 0, 1, and 3. Requests specifying an invalid value will be
+        # rejected.
+        # Policies with any conditional bindings must specify version 3. Policies
+        # without any conditional bindings may specify any valid value or leave the
+        # field unset.
         # Corresponds to the JSON property `version`
         # @return [Fixnum]
         attr_accessor :version

data/generated/google/apis/jobs_v3.rb

@@ -26,7 +26,7 @@ module Google
     # @see https://cloud.google.com/talent-solution/job-search/docs/
     module JobsV3
       VERSION = 'V3'
-      REVISION = '20190820'
+      REVISION = '20190912'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

data/generated/google/apis/jobs_v3p1beta1.rb

@@ -26,7 +26,7 @@ module Google
     # @see https://cloud.google.com/talent-solution/job-search/docs/
     module JobsV3p1beta1
       VERSION = 'V3p1beta1'
-      REVISION = '20190820'
+      REVISION = '20190912'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

data/generated/google/apis/logging_v2.rb

@@ -28,7 +28,7 @@ module Google
     # @see https://cloud.google.com/logging/docs/
     module LoggingV2
       VERSION = 'V2'
-      REVISION = '20190902'
+      REVISION = '20190907'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

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

@@ -22,6 +22,30 @@ module Google
   module Apis
     module LoggingV2
       
+      # Options that change functionality of a sink exporting data to BigQuery.
+      class BigQueryOptions
+        include Google::Apis::Core::Hashable
+      
+        # Optional. Whether to use BigQuery's partition tables. By default, Logging
+        # creates dated tables based on the log entries' timestamps, e.g.
+        # syslog_20170523. With partitioned tables the date suffix is no longer present
+        # and special query syntax has to be used instead. In both cases, tables are
+        # sharded based on UTC timezone.
+        # Corresponds to the JSON property `usePartitionedTables`
+        # @return [Boolean]
+        attr_accessor :use_partitioned_tables
+        alias_method :use_partitioned_tables?, :use_partitioned_tables
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @use_partitioned_tables = args[:use_partitioned_tables] if args.key?(:use_partitioned_tables)
+        end
+      end
+      
       # BucketOptions describes the bucket boundaries used to create a histogram for
       # the distribution. The buckets can be in a linear sequence, an exponential
       # sequence, or each bucket can be specified explicitly. BucketOptions does not
@@ -1085,6 +1109,11 @@ module Google
       class LogSink
         include Google::Apis::Core::Hashable
       
+        # Options that change functionality of a sink exporting data to BigQuery.
+        # Corresponds to the JSON property `bigqueryOptions`
+        # @return [Google::Apis::LoggingV2::BigQueryOptions]
+        attr_accessor :bigquery_options
+      
         # Output only. The creation timestamp of the sink.This field may not be present
         # for older sinks.
         # Corresponds to the JSON property `createTime`
@@ -1165,6 +1194,7 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @bigquery_options = args[:bigquery_options] if args.key?(:bigquery_options)
           @create_time = args[:create_time] if args.key?(:create_time)
           @destination = args[:destination] if args.key?(:destination)
           @filter = args[:filter] if args.key?(:filter)

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

@@ -22,6 +22,12 @@ module Google
   module Apis
     module LoggingV2
       
+      class BigQueryOptions
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class BucketOptions
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -208,6 +214,13 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class BigQueryOptions
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :use_partitioned_tables, as: 'usePartitionedTables'
+        end
+      end
+      
       class BucketOptions
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -437,6 +450,8 @@ module Google
       class LogSink
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
+          property :bigquery_options, as: 'bigqueryOptions', class: Google::Apis::LoggingV2::BigQueryOptions, decorator: Google::Apis::LoggingV2::BigQueryOptions::Representation
+      
           property :create_time, as: 'createTime'
           property :destination, as: 'destination'
           property :filter, as: 'filter'

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

@@ -293,7 +293,11 @@ module Google
         # Lists the logs in projects, organizations, folders, or billing accounts. Only
         # logs that have entries are listed.
         # @param [String] parent
-        #   Required. To be deprecated in Logging Data Model V2.
+        #   Required. The resource name that owns the logs:
+        #   "projects/[PROJECT_ID]"
+        #   "organizations/[ORGANIZATION_ID]"
+        #   "billingAccounts/[BILLING_ACCOUNT_ID]"
+        #   "folders/[FOLDER_ID]"
         # @param [Fixnum] page_size
         #   Optional. The maximum number of results to return from this request. Non-
         #   positive values are ignored. The presence of nextPageToken in the response
@@ -303,10 +307,6 @@ module Google
         #   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.
-        # @param [Array<String>, String] resource_names
-        #   Required for Logging Data Model V2. The resource name that owns the logs:  "
-        #   projects/PROJECT_ID"  "organizations/ORGANIZATION_ID"  "billingAccounts/
-        #   BILLING_ACCOUNT_ID"  "folders/FOLDER_ID"
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -324,14 +324,13 @@ module Google
         # @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_billing_account_logs(parent, page_size: nil, page_token: nil, resource_names: nil, fields: nil, quota_user: nil, options: nil, &block)
+        def list_billing_account_logs(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
           command = make_simple_command(:get, 'v2/{+parent}/logs', options)
           command.response_representation = Google::Apis::LoggingV2::ListLogsResponse::Representation
           command.response_class = Google::Apis::LoggingV2::ListLogsResponse
           command.params['parent'] = parent unless parent.nil?
           command.query['pageSize'] = page_size unless page_size.nil?
           command.query['pageToken'] = page_token unless page_token.nil?
-          command.query['resourceNames'] = resource_names unless resource_names.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
           execute_or_queue_command(command, &block)
@@ -1140,7 +1139,11 @@ module Google
         # Lists the logs in projects, organizations, folders, or billing accounts. Only
         # logs that have entries are listed.
         # @param [String] parent
-        #   Required. To be deprecated in Logging Data Model V2.
+        #   Required. The resource name that owns the logs:
+        #   "projects/[PROJECT_ID]"
+        #   "organizations/[ORGANIZATION_ID]"
+        #   "billingAccounts/[BILLING_ACCOUNT_ID]"
+        #   "folders/[FOLDER_ID]"
         # @param [Fixnum] page_size
         #   Optional. The maximum number of results to return from this request. Non-
         #   positive values are ignored. The presence of nextPageToken in the response
@@ -1150,10 +1153,6 @@ module Google
         #   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.
-        # @param [Array<String>, String] resource_names
-        #   Required for Logging Data Model V2. The resource name that owns the logs:  "
-        #   projects/PROJECT_ID"  "organizations/ORGANIZATION_ID"  "billingAccounts/
-        #   BILLING_ACCOUNT_ID"  "folders/FOLDER_ID"
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1171,14 +1170,13 @@ module Google
         # @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_folder_logs(parent, page_size: nil, page_token: nil, resource_names: nil, fields: nil, quota_user: nil, options: nil, &block)
+        def list_folder_logs(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
           command = make_simple_command(:get, 'v2/{+parent}/logs', options)
           command.response_representation = Google::Apis::LoggingV2::ListLogsResponse::Representation
           command.response_class = Google::Apis::LoggingV2::ListLogsResponse
           command.params['parent'] = parent unless parent.nil?
           command.query['pageSize'] = page_size unless page_size.nil?
           command.query['pageToken'] = page_token unless page_token.nil?
-          command.query['resourceNames'] = resource_names unless resource_names.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
           execute_or_queue_command(command, &block)
@@ -1519,7 +1517,11 @@ module Google
         # Lists the logs in projects, organizations, folders, or billing accounts. Only
         # logs that have entries are listed.
         # @param [String] parent
-        #   Required. To be deprecated in Logging Data Model V2.
+        #   Required. The resource name that owns the logs:
+        #   "projects/[PROJECT_ID]"
+        #   "organizations/[ORGANIZATION_ID]"
+        #   "billingAccounts/[BILLING_ACCOUNT_ID]"
+        #   "folders/[FOLDER_ID]"
         # @param [Fixnum] page_size
         #   Optional. The maximum number of results to return from this request. Non-
         #   positive values are ignored. The presence of nextPageToken in the response
@@ -1529,10 +1531,6 @@ module Google
         #   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.
-        # @param [Array<String>, String] resource_names
-        #   Required for Logging Data Model V2. The resource name that owns the logs:  "
-        #   projects/PROJECT_ID"  "organizations/ORGANIZATION_ID"  "billingAccounts/
-        #   BILLING_ACCOUNT_ID"  "folders/FOLDER_ID"
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1550,14 +1548,13 @@ module Google
         # @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_logs(parent, page_size: nil, page_token: nil, resource_names: nil, fields: nil, quota_user: nil, options: nil, &block)
+        def list_logs(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
           command = make_simple_command(:get, 'v2/{+parent}/logs', options)
           command.response_representation = Google::Apis::LoggingV2::ListLogsResponse::Representation
           command.response_class = Google::Apis::LoggingV2::ListLogsResponse
           command.params['parent'] = parent unless parent.nil?
           command.query['pageSize'] = page_size unless page_size.nil?
           command.query['pageToken'] = page_token unless page_token.nil?
-          command.query['resourceNames'] = resource_names unless resource_names.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
           execute_or_queue_command(command, &block)
@@ -1844,7 +1841,11 @@ module Google
         # Lists the logs in projects, organizations, folders, or billing accounts. Only
         # logs that have entries are listed.
         # @param [String] parent
-        #   Required. To be deprecated in Logging Data Model V2.
+        #   Required. The resource name that owns the logs:
+        #   "projects/[PROJECT_ID]"
+        #   "organizations/[ORGANIZATION_ID]"
+        #   "billingAccounts/[BILLING_ACCOUNT_ID]"
+        #   "folders/[FOLDER_ID]"
         # @param [Fixnum] page_size
         #   Optional. The maximum number of results to return from this request. Non-
         #   positive values are ignored. The presence of nextPageToken in the response
@@ -1854,10 +1855,6 @@ module Google
         #   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.
-        # @param [Array<String>, String] resource_names
-        #   Required for Logging Data Model V2. The resource name that owns the logs:  "
-        #   projects/PROJECT_ID"  "organizations/ORGANIZATION_ID"  "billingAccounts/
-        #   BILLING_ACCOUNT_ID"  "folders/FOLDER_ID"
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1875,14 +1872,13 @@ module Google
         # @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_logs(parent, page_size: nil, page_token: nil, resource_names: nil, fields: nil, quota_user: nil, options: nil, &block)
+        def list_organization_logs(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
           command = make_simple_command(:get, 'v2/{+parent}/logs', options)
           command.response_representation = Google::Apis::LoggingV2::ListLogsResponse::Representation
           command.response_class = Google::Apis::LoggingV2::ListLogsResponse
           command.params['parent'] = parent unless parent.nil?
           command.query['pageSize'] = page_size unless page_size.nil?
           command.query['pageToken'] = page_token unless page_token.nil?
-          command.query['resourceNames'] = resource_names unless resource_names.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
           execute_or_queue_command(command, &block)
@@ -2424,7 +2420,11 @@ module Google
         # Lists the logs in projects, organizations, folders, or billing accounts. Only
         # logs that have entries are listed.
         # @param [String] parent
-        #   Required. To be deprecated in Logging Data Model V2.
+        #   Required. The resource name that owns the logs:
+        #   "projects/[PROJECT_ID]"
+        #   "organizations/[ORGANIZATION_ID]"
+        #   "billingAccounts/[BILLING_ACCOUNT_ID]"
+        #   "folders/[FOLDER_ID]"
         # @param [Fixnum] page_size
         #   Optional. The maximum number of results to return from this request. Non-
         #   positive values are ignored. The presence of nextPageToken in the response
@@ -2434,10 +2434,6 @@ module Google
         #   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.
-        # @param [Array<String>, String] resource_names
-        #   Required for Logging Data Model V2. The resource name that owns the logs:  "
-        #   projects/PROJECT_ID"  "organizations/ORGANIZATION_ID"  "billingAccounts/
-        #   BILLING_ACCOUNT_ID"  "folders/FOLDER_ID"
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -2455,14 +2451,13 @@ module Google
         # @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_logs(parent, page_size: nil, page_token: nil, resource_names: nil, fields: nil, quota_user: nil, options: nil, &block)
+        def list_project_logs(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
           command = make_simple_command(:get, 'v2/{+parent}/logs', options)
           command.response_representation = Google::Apis::LoggingV2::ListLogsResponse::Representation
           command.response_class = Google::Apis::LoggingV2::ListLogsResponse
           command.params['parent'] = parent unless parent.nil?
           command.query['pageSize'] = page_size unless page_size.nil?
           command.query['pageToken'] = page_token unless page_token.nil?
-          command.query['resourceNames'] = resource_names unless resource_names.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
           execute_or_queue_command(command, &block)

data/generated/google/apis/monitoring_v3.rb

@@ -30,7 +30,7 @@ module Google
     # @see https://cloud.google.com/monitoring/api/
     module MonitoringV3
       VERSION = 'V3'
-      REVISION = '20190904'
+      REVISION = '20190907'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

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

@@ -201,18 +201,18 @@ module Google
         end
       end
       
-      # A type of authentication to perform against the specified resource or URL that
-      # uses username and password. Currently, only Basic authentication is supported
-      # in Uptime Monitoring.
+      # The authentication parameters to provide to the specified resource or URL that
+      # requires a username and password. Currently, only Basic HTTP authentication (
+      # https://tools.ietf.org/html/rfc7617) is supported in Uptime checks.
       class BasicAuthentication
         include Google::Apis::Core::Hashable
       
-        # The password to authenticate.
+        # The password to use when authenticating with the HTTP server.
         # Corresponds to the JSON property `password`
         # @return [String]
         attr_accessor :password
       
-        # The username to authenticate.
+        # The username to use when authenticating with the HTTP server.
         # Corresponds to the JSON property `username`
         # @return [String]
         attr_accessor :username
@@ -517,9 +517,8 @@ module Google
         # @return [String]
         attr_accessor :content
       
-        # The matcher representing content match options which the check will run with.
-        # If the field is not specified (in previous versions), the option is set to be
-        # CONTAINS_STRING which performs content substring matching.
+        # The type of content matcher that will be applied to the server output,
+        # compared to the content string when the check is run.
         # Corresponds to the JSON property `matcher`
         # @return [String]
         attr_accessor :matcher
@@ -1096,18 +1095,18 @@ module Google
         end
       end
       
-      # Information involved in an HTTP/HTTPS uptime check request.
+      # Information involved in an HTTP/HTTPS Uptime check request.
       class HttpCheck
         include Google::Apis::Core::Hashable
       
-        # A type of authentication to perform against the specified resource or URL that
-        # uses username and password. Currently, only Basic authentication is supported
-        # in Uptime Monitoring.
+        # The authentication parameters to provide to the specified resource or URL that
+        # requires a username and password. Currently, only Basic HTTP authentication (
+        # https://tools.ietf.org/html/rfc7617) is supported in Uptime checks.
         # Corresponds to the JSON property `authInfo`
         # @return [Google::Apis::MonitoringV3::BasicAuthentication]
         attr_accessor :auth_info
       
-        # The list of headers to send as part of the uptime check request. If two
+        # The list of headers to send as part of the Uptime check request. If two
         # headers have the same key and different values, they should be entered as a
         # single header, with the value being a comma-separated list of all the desired
         # values as described at https://www.w3.org/Protocols/rfc2616/rfc2616.txt (page
@@ -1122,23 +1121,24 @@ module Google
         # should be specified for any headers related to authentication that you do not
         # wish to be seen when retrieving the configuration. The server will be
         # responsible for encrypting the headers. On Get/List calls, if mask_headers is
-        # set to True then the headers will be obscured with ******.
+        # set to true then the headers will be obscured with ******.
         # Corresponds to the JSON property `maskHeaders`
         # @return [Boolean]
         attr_accessor :mask_headers
         alias_method :mask_headers?, :mask_headers
       
-        # The path to the page to run the check against. Will be combined with the host (
-        # specified within the MonitoredResource) and port to construct the full URL.
-        # Optional (defaults to "/"). If the provided path does not begin with "/", it
-        # will be prepended automatically.
+        # Optional (defaults to "/"). The path to the page against which to run the
+        # check. Will be combined with the host (specified within the monitored_resource)
+        # and port to construct the full URL. If the provided path does not begin with "
+        # /", a "/" will be prepended automatically.
         # Corresponds to the JSON property `path`
         # @return [String]
         attr_accessor :path
       
-        # The port to the page to run the check against. Will be combined with host (
-        # specified within the MonitoredResource) and path to construct the full URL.
-        # Optional (defaults to 80 without SSL, or 443 with SSL).
+        # Optional (defaults to 80 when use_ssl is false, and 443 when use_ssl is true).
+        # The TCP port on the HTTP server against which to run the check. Will be
+        # combined with host (specified within the monitored_resource) and path to
+        # construct the full URL.
         # Corresponds to the JSON property `port`
         # @return [Fixnum]
         attr_accessor :port
@@ -1149,8 +1149,9 @@ module Google
         attr_accessor :use_ssl
         alias_method :use_ssl?, :use_ssl
       
-        # Boolean specifying whether to validate SSL certificates. Only applies to
-        # uptime_url checks. If use_ssl is false, setting this to true has no effect.
+        # Boolean specifying whether to include SSL certificate validation as a part of
+        # the Uptime check. Only applies to checks where monitored_resource is set to
+        # uptime_url. If use_ssl is false, setting validate_ssl to true has no effect.
         # Corresponds to the JSON property `validateSsl`
         # @return [Boolean]
         attr_accessor :validate_ssl
@@ -1172,7 +1173,7 @@ module Google
         end
       end
       
-      # An internal checker allows uptime checks to run on private/internal GCP
+      # An internal checker allows Uptime checks to run on private/internal GCP
       # resources.
       class InternalChecker
         include Google::Apis::Core::Hashable
@@ -1184,15 +1185,15 @@ module Google
         # @return [String]
         attr_accessor :display_name
       
-        # The GCP zone the uptime check should egress from. Only respected for internal
-        # uptime checks, where internal_network is specified.
+        # The GCP zone the Uptime check should egress from. Only respected for internal
+        # Uptime checks, where internal_network is specified.
         # Corresponds to the JSON property `gcpZone`
         # @return [String]
         attr_accessor :gcp_zone
       
         # A unique resource name for this InternalChecker. The format is:projects/[
-        # PROJECT_ID]/internalCheckers/[INTERNAL_CHECKER_ID].PROJECT_ID is the
-        # stackdriver workspace project for the uptime check config associated with the
+        # PROJECT_ID]/internalCheckers/[INTERNAL_CHECKER_ID].[PROJECT_ID] is the
+        # Stackdriver Workspace project for the Uptime check config associated with the
         # internal checker.
         # Corresponds to the JSON property `name`
         # @return [String]
@@ -1204,8 +1205,8 @@ module Google
         # @return [String]
         attr_accessor :network
       
-        # The GCP project_id where the internal checker lives. Not necessary the same as
-        # the workspace project.
+        # The GCP project ID where the internal checker lives. Not necessary the same as
+        # the Workspace project.
         # Corresponds to the JSON property `peerProjectId`
         # @return [String]
         attr_accessor :peer_project_id
@@ -1542,13 +1543,13 @@ module Google
         # @return [String]
         attr_accessor :next_page_token
       
-        # The total number of uptime check configurations for the project, irrespective
+        # The total number of Uptime check configurations for the project, irrespective
         # of any pagination.
         # Corresponds to the JSON property `totalSize`
         # @return [Fixnum]
         attr_accessor :total_size
       
-        # The returned uptime check configurations.
+        # The returned Uptime check configurations.
         # Corresponds to the JSON property `uptimeCheckConfigs`
         # @return [Array<Google::Apis::MonitoringV3::UptimeCheckConfig>]
         attr_accessor :uptime_check_configs
@@ -2378,8 +2379,8 @@ module Google
       class ResourceGroup
         include Google::Apis::Core::Hashable
       
-        # The group of resources being monitored. Should be only the group_id, not
-        # projects/<project_id>/groups/<group_id>.
+        # The group of resources being monitored. Should be only the [GROUP_ID], and not
+        # the full-path projects/[PROJECT_ID]/groups/[GROUP_ID].
         # Corresponds to the JSON property `groupId`
         # @return [String]
         attr_accessor :group_id
@@ -2499,12 +2500,13 @@ module Google
         end
       end
       
-      # Information required for a TCP uptime check request.
+      # Information required for a TCP Uptime check request.
       class TcpCheck
         include Google::Apis::Core::Hashable
       
-        # The port to the page to run the check against. Will be combined with host (
-        # specified within the MonitoredResource) to construct the full URL. Required.
+        # The TCP port on the server against which to run the check. Will be combined
+        # with host (specified within the monitored_resource) to construct the full URL.
+        # Required.
         # Corresponds to the JSON property `port`
         # @return [Fixnum]
         attr_accessor :port
@@ -2781,30 +2783,30 @@ module Google
       class UptimeCheckConfig
         include Google::Apis::Core::Hashable
       
-        # The expected content on the page the check is run against. Currently, only the
-        # first entry in the list is supported, and other entries will be ignored. The
-        # server will look for an exact match of the string in the page response's
-        # content. This field is optional and should only be specified if a content
-        # match is required.
+        # The content that is expected to appear in the data returned by the target
+        # server against which the check is run. Currently, only the first entry in the
+        # content_matchers list is supported, and additional entries will be ignored.
+        # This field is optional and should only be specified if a content match is
+        # required as part of the/ Uptime check.
         # Corresponds to the JSON property `contentMatchers`
         # @return [Array<Google::Apis::MonitoringV3::ContentMatcher>]
         attr_accessor :content_matchers
       
-        # A human-friendly name for the uptime check configuration. The display name
+        # A human-friendly name for the Uptime check configuration. The display name
         # should be unique within a Stackdriver Workspace in order to make it easier to
         # identify; however, uniqueness is not enforced. Required.
         # Corresponds to the JSON property `displayName`
         # @return [String]
         attr_accessor :display_name
       
-        # Information involved in an HTTP/HTTPS uptime check request.
+        # Information involved in an HTTP/HTTPS Uptime check request.
         # Corresponds to the JSON property `httpCheck`
         # @return [Google::Apis::MonitoringV3::HttpCheck]
         attr_accessor :http_check
       
         # The internal checkers that this check will egress from. If is_internal is true
         # and this list is empty, the check will egress from all the InternalCheckers
-        # configured for the project that owns this CheckConfig.
+        # configured for the project that owns this UptimeCheckConfig.
         # Corresponds to the JSON property `internalCheckers`
         # @return [Array<Google::Apis::MonitoringV3::InternalChecker>]
         attr_accessor :internal_checkers
@@ -2825,15 +2827,15 @@ module Google
         # @return [Google::Apis::MonitoringV3::MonitoredResource]
         attr_accessor :monitored_resource
       
-        # A unique resource name for this UptimeCheckConfig. The format is:projects/[
-        # PROJECT_ID]/uptimeCheckConfigs/[UPTIME_CHECK_ID].This field should be omitted
-        # when creating the uptime check configuration; on create, the resource name is
-        # assigned by the server and included in the response.
+        # A unique resource name for this Uptime check configuration. The format is:
+        # projects/[PROJECT_ID]/uptimeCheckConfigs/[UPTIME_CHECK_ID].This field should
+        # be omitted when creating the Uptime check configuration; on create, the
+        # resource name is assigned by the server and included in the response.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
-        # How often, in seconds, the uptime check is performed. Currently, the only
+        # How often, in seconds, the Uptime check is performed. Currently, the only
         # supported values are 60s (1 minute), 300s (5 minutes), 600s (10 minutes), and
         # 900s (15 minutes). Optional, defaults to 60s.
         # Corresponds to the JSON property `period`
@@ -2848,14 +2850,13 @@ module Google
       
         # The list of regions from which the check will be run. Some regions contain one
         # location, and others contain more than one. If this field is specified, enough
-        # regions to include a minimum of 3 locations must be provided, or an error
-        # message is returned. Not specifying this field will result in uptime checks
-        # running from all regions.
+        # regions must be provided to include a minimum of 3 locations. Not specifying
+        # this field will result in Uptime checks running from all available regions.
         # Corresponds to the JSON property `selectedRegions`
         # @return [Array<String>]
         attr_accessor :selected_regions
       
-        # Information required for a TCP uptime check request.
+        # Information required for a TCP Uptime check request.
         # Corresponds to the JSON property `tcpCheck`
         # @return [Google::Apis::MonitoringV3::TcpCheck]
         attr_accessor :tcp_check
@@ -2891,11 +2892,11 @@ module Google
       class UptimeCheckIp
         include Google::Apis::Core::Hashable
       
-        # The IP address from which the uptime check originates. This is a full IP
-        # address (not an IP address range). Most IP addresses, as of this publication,
-        # are in IPv4 format; however, one should not rely on the IP addresses being in
-        # IPv4 format indefinitely and should support interpreting this field in either
-        # IPv4 or IPv6 format.
+        # The IP address from which the Uptime check originates. This is a fully
+        # specified IP address (not an IP address range). Most IP addresses, as of this
+        # publication, are in IPv4 format; however, one should not rely on the IP
+        # addresses being in IPv4 format indefinitely, and should support interpreting
+        # this field in either IPv4 or IPv6 format.
         # Corresponds to the JSON property `ipAddress`
         # @return [String]
         attr_accessor :ip_address