Class: Google::Apis::CloudtasksV2beta2::Task

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

Overview

A unit of scheduled work.

Instance Attribute Summary collapse

Instance Method Summary collapse

Methods included from Google::Apis::Core::JsonObjectSupport

#to_json

Methods included from Google::Apis::Core::Hashable

process_value, #to_h

Constructor Details

#initialize(**args) ⇒ Task

Returns a new instance of Task



1648
1649
1650
 
# File 'generated/google/apis/cloudtasks_v2beta2/classes.rb', line 1648

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

Instance Attribute Details

#app_engine_http_request ⇒ Google::Apis::CloudtasksV2beta2::AppEngineHttpRequest

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_target set. 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_url 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:



1588
1589
1590
 
# File 'generated/google/apis/cloudtasks_v2beta2/classes.rb', line 1588

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) 


1594
1595
1596
 
# File 'generated/google/apis/cloudtasks_v2beta2/classes.rb', line 1594

def create_time
  @create_time
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) 


1616
1617
1618
 
# File 'generated/google/apis/cloudtasks_v2beta2/classes.rb', line 1616

def name
  @name
end

#pull_message ⇒ Google::Apis::CloudtasksV2beta2::PullMessage

The pull message contains data that can be used by the caller of LeaseTasks to process the task. This proto can only be used for tasks in a queue which has pull_target set. Corresponds to the JSON property pullMessage

Returns:



1624
1625
1626
 
# File 'generated/google/apis/cloudtasks_v2beta2/classes.rb', line 1624

def pull_message
  @pull_message
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. For pull queues, this is the time when the task is available to be leased; if a task is currently leased, this is the time when the current lease expires, that is, the time that the task was leased plus the lease_duration. schedule_time will be truncated to the nearest microsecond. Corresponds to the JSON property scheduleTime

Returns:

  • (String) 


1635
1636
1637
 
# File 'generated/google/apis/cloudtasks_v2beta2/classes.rb', line 1635

def schedule_time
  @schedule_time
end

#status ⇒ Google::Apis::CloudtasksV2beta2::TaskStatus

Status of the task. Corresponds to the JSON property status

Returns:



1640
1641
1642
 
# File 'generated/google/apis/cloudtasks_v2beta2/classes.rb', line 1640

def status
  @status
end

#view ⇒ String

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

Returns:

  • (String) 


1646
1647
1648
 
# File 'generated/google/apis/cloudtasks_v2beta2/classes.rb', line 1646

def view
  @view
end

Instance Method Details

#update!(**args) ⇒ Object

Update properties of this object



1653
1654
1655
1656
1657
1658
1659
1660
1661
 
# File 'generated/google/apis/cloudtasks_v2beta2/classes.rb', line 1653

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)
  @name = args[:name] if args.key?(:name)
  @pull_message = args[:pull_message] if args.key?(:pull_message)
  @schedule_time = args[:schedule_time] if args.key?(:schedule_time)
  @status = args[:status] if args.key?(:status)
  @view = args[:view] if args.key?(:view)
end