Class: Google::Apis::CloudtasksV2beta3::Task

Inherits:
Object
  • Object
show all
Includes:
Google::Apis::Core::Hashable, Google::Apis::Core::JsonObjectSupport
Defined in:
generated/google/apis/cloudtasks_v2beta3/classes.rb,
generated/google/apis/cloudtasks_v2beta3/representations.rb,
generated/google/apis/cloudtasks_v2beta3/representations.rb

Overview

A unit of scheduled work.

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(**args) ⇒ Task

Returns a new instance of Task.



1515
1516
1517
 
# File 'generated/google/apis/cloudtasks_v2beta3/classes.rb', line 1515

def initialize(**args)
   update!(**args)
end

Instance Attribute Details

#app_engine_http_request ⇒ Google::Apis::CloudtasksV2beta3::AppEngineHttpRequest

App Engine HTTP request. The message defines the HTTP request that is sent to an App Engine app when the task is dispatched. Using AppEngineHttpRequest requires appengine.applications.get Google IAM permission for the project and the following scope: https://www.googleapis.com/auth/cloud-platform The task will be delivered to the App Engine app which belongs to the same project as the queue. For more information, see How Requests are Routed and how routing is affected by dispatch files. Traffic is encrypted during transport and never leaves Google datacenters. Because this traffic is carried over a communication mechanism internal to Google, you cannot explicitly set the protocol (for example, HTTP or HTTPS). The request to the handler, however, will appear to have used the HTTP protocol. The AppEngineRouting used to construct the URL that the task is delivered to can be set at the queue-level or task-level: * If set, app_engine_routing_override is used for all tasks in the queue, no matter what the setting is for the task-level app_engine_routing. The url that the task will be sent to is: * url = host + relative_uri Tasks can be dispatched to secure app handlers, unsecure app handlers, and URIs restricted with login: admin. Because tasks are not run as any user, they cannot be dispatched to URIs restricted with login: required 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]. 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

Returns:



1403
1404
1405
 
# File 'generated/google/apis/cloudtasks_v2beta3/classes.rb', line 1403

def app_engine_http_request
  @app_engine_http_request
end

#create_time ⇒ String

Output only. The time that the task was created. create_time will be truncated to the nearest second. Corresponds to the JSON property createTime

Returns:

  • (String) 


1409
1410
1411
 
# File 'generated/google/apis/cloudtasks_v2beta3/classes.rb', line 1409

def create_time
  @create_time
end

#dispatch_count ⇒ Fixnum

Output only. The number of attempts dispatched. This count includes attempts which have been dispatched but haven't received a response. Corresponds to the JSON property dispatchCount

Returns:

  • (Fixnum) 


1415
1416
1417
 
# File 'generated/google/apis/cloudtasks_v2beta3/classes.rb', line 1415

def dispatch_count
  @dispatch_count
end

#dispatch_deadline ⇒ String

The deadline for requests sent to the worker. If the worker does not respond by this deadline then the request is cancelled and the attempt is marked as a DEADLINE_EXCEEDED failure. Cloud Tasks will retry the task according to the RetryConfig. Note that when the request is cancelled, Cloud Tasks will stop listening for the response, but whether the worker stops processing depends on the 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 type of the service: 10 minutes for standard apps with automatic scaling, 24 hours for standard apps with manual and basic scaling, and 60 minutes for flex apps. If the request deadline is set, it must be in the interval [15 seconds, 24 hours 15 seconds]. Regardless of the task's dispatch_deadline, the app handler will not run for longer than than the service's timeout. We recommend setting the dispatch_deadline to at most a few seconds more than the app handler's timeout. For more information see Timeouts. dispatch_deadline will be truncated to the nearest millisecond. The deadline is an approximate deadline. Corresponds to the JSON property dispatchDeadline

Returns:

  • (String) 


1440
1441
1442
 
# File 'generated/google/apis/cloudtasks_v2beta3/classes.rb', line 1440

def dispatch_deadline
  @dispatch_deadline
end

#first_attempt ⇒ Google::Apis::CloudtasksV2beta3::Attempt

The status of a task attempt. Corresponds to the JSON property firstAttempt

Returns:



1445
1446
1447
 
# File 'generated/google/apis/cloudtasks_v2beta3/classes.rb', line 1445

def first_attempt
  @first_attempt
end

#http_request ⇒ Google::Apis::CloudtasksV2beta3::HttpRequest

HTTP request. 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 be 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 backs off 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 increases in traffic, 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

Returns:



1467
1468
1469
 
# File 'generated/google/apis/cloudtasks_v2beta3/classes.rb', line 1467

def http_request
  @http_request
end

#last_attempt ⇒ Google::Apis::CloudtasksV2beta3::Attempt

The status of a task attempt. Corresponds to the JSON property lastAttempt

Returns:



1472
1473
1474
 
# File 'generated/google/apis/cloudtasks_v2beta3/classes.rb', line 1472

def last_attempt
  @last_attempt
end

#name ⇒ String

Optionally caller-specified in CreateTask. The task name. The task name must have the following format: projects/PROJECT_ID/locations/LOCATION_ID/queues/ QUEUE_ID/tasks/TASK_ID * PROJECT_ID can contain letters ([A-Za-z]), numbers ([0-9]), hyphens (-), colons (:), or periods (.). For more information, see Identifying projects * LOCATION_ID is the canonical ID for the task's location. The list of available locations can be obtained by calling ListLocations. For more information, see https://cloud.google.com/ about/locations/. * QUEUE_ID can contain letters ([A-Za-z]), numbers ([0-9]), or hyphens (-). The maximum length is 100 characters. * TASK_ID can contain only letters ([A-Za-z]), numbers ([0-9]), hyphens (-), or underscores (_). The maximum length is 500 characters. Corresponds to the JSON property name

Returns:

  • (String) 


1488
1489
1490
 
# File 'generated/google/apis/cloudtasks_v2beta3/classes.rb', line 1488

def name
  @name
end

#pull_message ⇒ Google::Apis::CloudtasksV2beta3::PullMessage

Pull Message. This proto can only be used for tasks in a queue which has PULL type. It currently exists for backwards compatibility with the App Engine Task Queue SDK. This message type maybe returned with methods list and get, when the response view is FULL. Corresponds to the JSON property pullMessage

Returns:



1496
1497
1498
 
# File 'generated/google/apis/cloudtasks_v2beta3/classes.rb', line 1496

def pull_message
  @pull_message
end

#response_count ⇒ Fixnum

Output only. The number of attempts which have received a response. Corresponds to the JSON property responseCount

Returns:

  • (Fixnum) 


1501
1502
1503
 
# File 'generated/google/apis/cloudtasks_v2beta3/classes.rb', line 1501

def response_count
  @response_count
end

#schedule_time ⇒ String

The time when the task is scheduled to be attempted. For App Engine queues, this is when the task will be attempted or retried. schedule_time will be truncated to the nearest microsecond. Corresponds to the JSON property scheduleTime

Returns:

  • (String) 


1508
1509
1510
 
# File 'generated/google/apis/cloudtasks_v2beta3/classes.rb', line 1508

def schedule_time
  @schedule_time
end

#view ⇒ String

Output only. The view specifies which subset of the Task has been returned. Corresponds to the JSON property view

Returns:

  • (String) 


1513
1514
1515
 
# File 'generated/google/apis/cloudtasks_v2beta3/classes.rb', line 1513

def view
  @view
end

Instance Method Details

#update!(**args) ⇒ Object

Update properties of this object



1520
1521
1522
1523
1524
1525
1526
1527
1528
1529
1530
1531
1532
1533
 
# File 'generated/google/apis/cloudtasks_v2beta3/classes.rb', line 1520

def update!(**args)
  @app_engine_http_request = args[:app_engine_http_request] if args.key?(:app_engine_http_request)
  @create_time = args[:create_time] if args.key?(:create_time)
  @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)
  @pull_message = args[:pull_message] if args.key?(:pull_message)
  @response_count = args[:response_count] if args.key?(:response_count)
  @schedule_time = args[:schedule_time] if args.key?(:schedule_time)
  @view = args[:view] if args.key?(:view)
end