google-api-client 0.29.1 → 0.29.2

data/generated/google/apis/cloudtasks_v2beta3.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://cloud.google.com/tasks/
     module CloudtasksV2beta3
       VERSION = 'V2beta3'
-      REVISION = '20190412'
+      REVISION = '20190513'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

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

@@ -69,8 +69,6 @@ module Google
       # App Engine HTTP request.
       # The message defines the HTTP request that is sent to an App Engine app when
       # the task is dispatched.
-      # This proto can only be used for tasks in a queue which has
-      # app_engine_http_queue set.
       # Using AppEngineHttpRequest requires
       # [`appengine.applications.get`](https://cloud.google.com/appengine/docs/admin-
       # api/access-control)
@@ -110,13 +108,17 @@ module Google
       # required`](https://cloud.google.com/appengine/docs/standard/python/config/
       # appref)
       # Task dispatches also do not follow redirects.
-      # The task attempt has succeeded if the app's request handler returns
-      # an HTTP response code in the range [`200` - `299`]. `503` is
-      # considered an App Engine system error instead of an application
-      # error. Requests returning error `503` will be retried regardless of
-      # retry configuration and not counted against retry counts.
-      # Any other response code or a failure to receive a response before the
-      # deadline is a failed attempt.
+      # The task attempt has succeeded if the app's request handler returns an HTTP
+      # response code in the range [`200` - `299`]. The task attempt has failed if
+      # the app's handler returns a non-2xx response code or Cloud Tasks does
+      # not receive response before the deadline. Failed
+      # tasks will be retried according to the
+      # retry configuration. `503` (Service Unavailable) is
+      # considered an App Engine system error instead of an application error and
+      # will cause Cloud Tasks' traffic congestion control to temporarily throttle
+      # the queue's dispatches. Unlike other types of task targets, a `429` (Too Many
+      # Requests) response from an app handler does not cause traffic congestion
+      # control to throttle the queue.
       class AppEngineHttpRequest
         include Google::Apis::Core::Hashable
       
@@ -564,6 +566,118 @@ module Google
         end
       end
       
+      # HTTP request.
+      # Warning: This is an [alpha](https://cloud.google.com/terms/launch-stages)
+      # feature. If you haven't already joined, you can [use this form to sign
+      # up](https://docs.google.com/forms/d/e/
+      # 1FAIpQLSfc4uEy9CBHKYUSdnY1hdhKDCX7julVZHy3imOiR-XrU7bUNQ/viewform).
+      # The task will be pushed to the worker as an HTTP request. If the worker
+      # or the redirected worker acknowledges the task by returning a successful HTTP
+      # response code ([`200` - `299`]), the task will removed from the queue. If
+      # any other HTTP response code is returned or no response is received, the
+      # task will be retried according to the following:
+      # * User-specified throttling: retry configuration,
+      # rate limits, and the queue's state.
+      # * System throttling: To prevent the worker from overloading, Cloud Tasks may
+      # temporarily reduce the queue's effective rate. User-specified settings
+      # will not be changed.
+      # System throttling happens because:
+      # * Cloud Tasks backoffs on all errors. Normally the backoff specified in
+      # rate limits will be used. But if the worker returns
+      # `429` (Too Many Requests), `503` (Service Unavailable), or the rate of
+      # errors is high, Cloud Tasks will use a higher backoff rate. The retry
+      # specified in the `Retry-After` HTTP response header is considered.
+      # * To prevent traffic spikes and to smooth sudden large traffic spikes,
+      # dispatches ramp up slowly when the queue is newly created or idle and
+      # if large numbers of tasks suddenly become available to dispatch (due to
+      # spikes in create task rates, the queue being unpaused, or many tasks
+      # that are scheduled at the same time).
+      class HttpRequest
+        include Google::Apis::Core::Hashable
+      
+        # HTTP request body.
+        # A request body is allowed only if the
+        # HTTP method is POST, PUT, or PATCH. It is an
+        # error to set body on a task with an incompatible HttpMethod.
+        # Corresponds to the JSON property `body`
+        # NOTE: Values are automatically base64 encoded/decoded in the client library.
+        # @return [String]
+        attr_accessor :body
+      
+        # HTTP request headers.
+        # This map contains the header field names and values.
+        # Headers can be set when the
+        # task is created.
+        # These headers represent a subset of the headers that will accompany the
+        # task's HTTP request. Some HTTP request headers will be ignored or replaced.
+        # A partial list of headers that will be ignored or replaced is:
+        # * Host: This will be computed by Cloud Tasks and derived from
+        # HttpRequest.url.
+        # * Content-Length: This will be computed by Cloud Tasks.
+        # * User-Agent: This will be set to `"Google-Cloud-Tasks"`.
+        # * X-Google-*: Google use only.
+        # * X-AppEngine-*: Google use only.
+        # `Content-Type` won't be set by Cloud Tasks. You can explicitly set
+        # `Content-Type` to a media type when the
+        # task is created.
+        # For example, `Content-Type` can be set to `"application/octet-stream"` or
+        # `"application/json"`.
+        # Headers which can have multiple values (according to RFC2616) can be
+        # specified using comma-separated values.
+        # The size of the headers must be less than 80KB.
+        # Corresponds to the JSON property `headers`
+        # @return [Hash<String,String>]
+        attr_accessor :headers
+      
+        # The HTTP method to use for the request. The default is POST.
+        # Corresponds to the JSON property `httpMethod`
+        # @return [String]
+        attr_accessor :http_method
+      
+        # Contains information needed for generating an
+        # [OAuth token](https://developers.google.com/identity/protocols/OAuth2).
+        # This type of authorization should generally only be used when calling Google
+        # APIs hosted on *.googleapis.com.
+        # Corresponds to the JSON property `oauthToken`
+        # @return [Google::Apis::CloudtasksV2beta3::OAuthToken]
+        attr_accessor :oauth_token
+      
+        # Contains information needed for generating an
+        # [OpenID Connect
+        # token](https://developers.google.com/identity/protocols/OpenIDConnect).
+        # This type of authorization can be used for many scenarios, including
+        # calling Cloud Run, or endpoints where you intend to validate the token
+        # yourself.
+        # Corresponds to the JSON property `oidcToken`
+        # @return [Google::Apis::CloudtasksV2beta3::OidcToken]
+        attr_accessor :oidc_token
+      
+        # Required. The full url path that the request will be sent to.
+        # This string must begin with either "http://" or "https://". Some examples
+        # are: `http://acme.com` and `https://acme.com/sales:8080`. Cloud Tasks will
+        # encode some characters for safety and compatibility. The maximum allowed
+        # URL length is 2083 characters after encoding.
+        # The `Location` header response from a redirect response [`300` - `399`]
+        # may be followed. The redirect is not counted as a separate attempt.
+        # Corresponds to the JSON property `url`
+        # @return [String]
+        attr_accessor :url
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @body = args[:body] if args.key?(:body)
+          @headers = args[:headers] if args.key?(:headers)
+          @http_method = args[:http_method] if args.key?(:http_method)
+          @oauth_token = args[:oauth_token] if args.key?(:oauth_token)
+          @oidc_token = args[:oidc_token] if args.key?(:oidc_token)
+          @url = args[:url] if args.key?(:url)
+        end
+      end
+      
       # The response message for Locations.ListLocations.
       class ListLocationsResponse
         include Google::Apis::Core::Hashable
@@ -695,6 +809,75 @@ module Google
         end
       end
       
+      # Contains information needed for generating an
+      # [OAuth token](https://developers.google.com/identity/protocols/OAuth2).
+      # This type of authorization should generally only be used when calling Google
+      # APIs hosted on *.googleapis.com.
+      class OAuthToken
+        include Google::Apis::Core::Hashable
+      
+        # OAuth scope to be used for generating OAuth access token.
+        # If not specified, "https://www.googleapis.com/auth/cloud-platform"
+        # will be used.
+        # Corresponds to the JSON property `scope`
+        # @return [String]
+        attr_accessor :scope
+      
+        # [Service account email](https://cloud.google.com/iam/docs/service-accounts)
+        # to be used for generating OAuth token.
+        # The service account must be within the same project as the queue. The
+        # caller must have iam.serviceAccounts.actAs permission for the service
+        # account.
+        # Corresponds to the JSON property `serviceAccountEmail`
+        # @return [String]
+        attr_accessor :service_account_email
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @scope = args[:scope] if args.key?(:scope)
+          @service_account_email = args[:service_account_email] if args.key?(:service_account_email)
+        end
+      end
+      
+      # Contains information needed for generating an
+      # [OpenID Connect
+      # token](https://developers.google.com/identity/protocols/OpenIDConnect).
+      # This type of authorization can be used for many scenarios, including
+      # calling Cloud Run, or endpoints where you intend to validate the token
+      # yourself.
+      class OidcToken
+        include Google::Apis::Core::Hashable
+      
+        # Audience to be used when generating OIDC token. If not specified, the URI
+        # specified in target will be used.
+        # Corresponds to the JSON property `audience`
+        # @return [String]
+        attr_accessor :audience
+      
+        # [Service account email](https://cloud.google.com/iam/docs/service-accounts)
+        # to be used for generating OIDC token.
+        # The service account must be within the same project as the queue. The
+        # caller must have iam.serviceAccounts.actAs permission for the service
+        # account.
+        # Corresponds to the JSON property `serviceAccountEmail`
+        # @return [String]
+        attr_accessor :service_account_email
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @audience = args[:audience] if args.key?(:audience)
+          @service_account_email = args[:service_account_email] if args.key?(:service_account_email)
+        end
+      end
+      
       # Request message for PauseQueue.
       class PauseQueueRequest
         include Google::Apis::Core::Hashable
@@ -868,6 +1051,12 @@ module Google
         # @return [Google::Apis::CloudtasksV2beta3::RetryConfig]
         attr_accessor :retry_config
       
+        # Configuration options for writing logs to
+        # [Stackdriver Logging](https://cloud.google.com/logging/docs/).
+        # Corresponds to the JSON property `stackdriverLoggingConfig`
+        # @return [Google::Apis::CloudtasksV2beta3::StackdriverLoggingConfig]
+        attr_accessor :stackdriver_logging_config
+      
         # Output only. The state of the queue.
         # `state` can only be changed by called
         # PauseQueue,
@@ -890,6 +1079,7 @@ module Google
           @purge_time = args[:purge_time] if args.key?(:purge_time)
           @rate_limits = args[:rate_limits] if args.key?(:rate_limits)
           @retry_config = args[:retry_config] if args.key?(:retry_config)
+          @stackdriver_logging_config = args[:stackdriver_logging_config] if args.key?(:stackdriver_logging_config)
           @state = args[:state] if args.key?(:state)
         end
       end
@@ -1182,6 +1372,29 @@ module Google
         end
       end
       
+      # Configuration options for writing logs to
+      # [Stackdriver Logging](https://cloud.google.com/logging/docs/).
+      class StackdriverLoggingConfig
+        include Google::Apis::Core::Hashable
+      
+        # Specifies the fraction of operations to write to
+        # [Stackdriver Logging](https://cloud.google.com/logging/docs/).
+        # This field may contain any value between 0.0 and 1.0, inclusive.
+        # 0.0 is the default and means that no operations are logged.
+        # Corresponds to the JSON property `samplingRatio`
+        # @return [Float]
+        attr_accessor :sampling_ratio
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @sampling_ratio = args[:sampling_ratio] if args.key?(:sampling_ratio)
+        end
+      end
+      
       # The `Status` type defines a logical error model that is suitable for
       # different programming environments, including REST APIs and RPC APIs. It is
       # used by [gRPC](https://github.com/grpc). The error model is designed to be:
@@ -1261,8 +1474,6 @@ module Google
         # App Engine HTTP request.
         # The message defines the HTTP request that is sent to an App Engine app when
         # the task is dispatched.
-        # This proto can only be used for tasks in a queue which has
-        # app_engine_http_queue set.
         # Using AppEngineHttpRequest requires
         # [`appengine.applications.get`](https://cloud.google.com/appengine/docs/admin-
         # api/access-control)
@@ -1302,13 +1513,17 @@ module Google
         # required`](https://cloud.google.com/appengine/docs/standard/python/config/
         # appref)
         # Task dispatches also do not follow redirects.
-        # The task attempt has succeeded if the app's request handler returns
-        # an HTTP response code in the range [`200` - `299`]. `503` is
-        # considered an App Engine system error instead of an application
-        # error. Requests returning error `503` will be retried regardless of
-        # retry configuration and not counted against retry counts.
-        # Any other response code or a failure to receive a response before the
-        # deadline is a failed attempt.
+        # The task attempt has succeeded if the app's request handler returns an HTTP
+        # response code in the range [`200` - `299`]. The task attempt has failed if
+        # the app's handler returns a non-2xx response code or Cloud Tasks does
+        # not receive response before the deadline. Failed
+        # tasks will be retried according to the
+        # retry configuration. `503` (Service Unavailable) is
+        # considered an App Engine system error instead of an application error and
+        # will cause Cloud Tasks' traffic congestion control to temporarily throttle
+        # the queue's dispatches. Unlike other types of task targets, a `429` (Too Many
+        # Requests) response from an app handler does not cause traffic congestion
+        # control to throttle the queue.
         # Corresponds to the JSON property `appEngineHttpRequest`
         # @return [Google::Apis::CloudtasksV2beta3::AppEngineHttpRequest]
         attr_accessor :app_engine_http_request
@@ -1335,6 +1550,8 @@ module Google
         # worker. For example, if the worker is stuck, it may not react to cancelled
         # requests.
         # The default and maximum values depend on the type of request:
+        # * For HTTP tasks, the default is 10 minutes. The deadline
+        # must be in the interval [15 seconds, 30 minutes].
         # * For App Engine tasks, 0 indicates that the
         # request has the default deadline. The default deadline depends on the
         # [scaling
@@ -1361,6 +1578,36 @@ module Google
         # @return [Google::Apis::CloudtasksV2beta3::Attempt]
         attr_accessor :first_attempt
       
+        # HTTP request.
+        # Warning: This is an [alpha](https://cloud.google.com/terms/launch-stages)
+        # feature. If you haven't already joined, you can [use this form to sign
+        # up](https://docs.google.com/forms/d/e/
+        # 1FAIpQLSfc4uEy9CBHKYUSdnY1hdhKDCX7julVZHy3imOiR-XrU7bUNQ/viewform).
+        # The task will be pushed to the worker as an HTTP request. If the worker
+        # or the redirected worker acknowledges the task by returning a successful HTTP
+        # response code ([`200` - `299`]), the task will removed from the queue. If
+        # any other HTTP response code is returned or no response is received, the
+        # task will be retried according to the following:
+        # * User-specified throttling: retry configuration,
+        # rate limits, and the queue's state.
+        # * System throttling: To prevent the worker from overloading, Cloud Tasks may
+        # temporarily reduce the queue's effective rate. User-specified settings
+        # will not be changed.
+        # System throttling happens because:
+        # * Cloud Tasks backoffs on all errors. Normally the backoff specified in
+        # rate limits will be used. But if the worker returns
+        # `429` (Too Many Requests), `503` (Service Unavailable), or the rate of
+        # errors is high, Cloud Tasks will use a higher backoff rate. The retry
+        # specified in the `Retry-After` HTTP response header is considered.
+        # * To prevent traffic spikes and to smooth sudden large traffic spikes,
+        # dispatches ramp up slowly when the queue is newly created or idle and
+        # if large numbers of tasks suddenly become available to dispatch (due to
+        # spikes in create task rates, the queue being unpaused, or many tasks
+        # that are scheduled at the same time).
+        # Corresponds to the JSON property `httpRequest`
+        # @return [Google::Apis::CloudtasksV2beta3::HttpRequest]
+        attr_accessor :http_request
+      
         # The status of a task attempt.
         # Corresponds to the JSON property `lastAttempt`
         # @return [Google::Apis::CloudtasksV2beta3::Attempt]
@@ -1417,6 +1664,7 @@ module Google
           @dispatch_count = args[:dispatch_count] if args.key?(:dispatch_count)
           @dispatch_deadline = args[:dispatch_deadline] if args.key?(:dispatch_deadline)
           @first_attempt = args[:first_attempt] if args.key?(:first_attempt)
+          @http_request = args[:http_request] if args.key?(:http_request)
           @last_attempt = args[:last_attempt] if args.key?(:last_attempt)
           @name = args[:name] if args.key?(:name)
           @response_count = args[:response_count] if args.key?(:response_count)

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

@@ -76,6 +76,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class HttpRequest
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class ListLocationsResponse
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -100,6 +106,18 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class OAuthToken
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class OidcToken
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class PauseQueueRequest
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -154,6 +172,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class StackdriverLoggingConfig
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class Status
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -260,6 +284,20 @@ module Google
         end
       end
       
+      class HttpRequest
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :body, :base64 => true, as: 'body'
+          hash :headers, as: 'headers'
+          property :http_method, as: 'httpMethod'
+          property :oauth_token, as: 'oauthToken', class: Google::Apis::CloudtasksV2beta3::OAuthToken, decorator: Google::Apis::CloudtasksV2beta3::OAuthToken::Representation
+      
+          property :oidc_token, as: 'oidcToken', class: Google::Apis::CloudtasksV2beta3::OidcToken, decorator: Google::Apis::CloudtasksV2beta3::OidcToken::Representation
+      
+          property :url, as: 'url'
+        end
+      end
+      
       class ListLocationsResponse
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -298,6 +336,22 @@ module Google
         end
       end
       
+      class OAuthToken
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :scope, as: 'scope'
+          property :service_account_email, as: 'serviceAccountEmail'
+        end
+      end
+      
+      class OidcToken
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :audience, as: 'audience'
+          property :service_account_email, as: 'serviceAccountEmail'
+        end
+      end
+      
       class PauseQueueRequest
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -331,6 +385,8 @@ module Google
       
           property :retry_config, as: 'retryConfig', class: Google::Apis::CloudtasksV2beta3::RetryConfig, decorator: Google::Apis::CloudtasksV2beta3::RetryConfig::Representation
       
+          property :stackdriver_logging_config, as: 'stackdriverLoggingConfig', class: Google::Apis::CloudtasksV2beta3::StackdriverLoggingConfig, decorator: Google::Apis::CloudtasksV2beta3::StackdriverLoggingConfig::Representation
+      
           property :state, as: 'state'
         end
       end
@@ -376,6 +432,13 @@ module Google
         end
       end
       
+      class StackdriverLoggingConfig
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :sampling_ratio, as: 'samplingRatio'
+        end
+      end
+      
       class Status
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -395,6 +458,8 @@ module Google
           property :dispatch_deadline, as: 'dispatchDeadline'
           property :first_attempt, as: 'firstAttempt', class: Google::Apis::CloudtasksV2beta3::Attempt, decorator: Google::Apis::CloudtasksV2beta3::Attempt::Representation
       
+          property :http_request, as: 'httpRequest', class: Google::Apis::CloudtasksV2beta3::HttpRequest, decorator: Google::Apis::CloudtasksV2beta3::HttpRequest::Representation
+      
           property :last_attempt, as: 'lastAttempt', class: Google::Apis::CloudtasksV2beta3::Attempt, decorator: Google::Apis::CloudtasksV2beta3::Attempt::Representation
       
           property :name, as: 'name'