Class: Google::Apis::CloudtasksV2beta2::Task
- Inherits:
-
Object
- Object
- Google::Apis::CloudtasksV2beta2::Task
- 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
-
#app_engine_http_request ⇒ Google::Apis::CloudtasksV2beta2::AppEngineHttpRequest
App Engine HTTP request.
-
#create_time ⇒ String
Output only.
-
#name ⇒ String
Optionally caller-specified in CreateTask.
-
#pull_message ⇒ Google::Apis::CloudtasksV2beta2::PullMessage
The pull message contains data that can be used by the caller of LeaseTasks to process the task.
-
#schedule_time ⇒ String
The time when the task is scheduled to be attempted.
-
#status ⇒ Google::Apis::CloudtasksV2beta2::TaskStatus
Status of the task.
-
#view ⇒ String
Output only.
Instance Method Summary collapse
-
#initialize(**args) ⇒ Task
constructor
A new instance of Task.
-
#update!(**args) ⇒ Object
Update properties of this object.
Methods included from Google::Apis::Core::JsonObjectSupport
Methods included from Google::Apis::Core::Hashable
Constructor Details
#initialize(**args) ⇒ Task
Returns a new instance of Task
1667 1668 1669 |
# File 'generated/google/apis/cloudtasks_v2beta2/classes.rb', line 1667 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 withlogin: admin
. Because tasks are not run as any user, they cannot be dispatched to URIs restricted withlogin: 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
].503
is considered an App Engine system error instead of an application error. Requests returning error503
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. Corresponds to the JSON propertyappEngineHttpRequest
1608 1609 1610 |
# File 'generated/google/apis/cloudtasks_v2beta2/classes.rb', line 1608 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
1614 1615 1616 |
# File 'generated/google/apis/cloudtasks_v2beta2/classes.rb', line 1614 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 projectsLOCATION_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 propertyname
1635 1636 1637 |
# File 'generated/google/apis/cloudtasks_v2beta2/classes.rb', line 1635 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
1643 1644 1645 |
# File 'generated/google/apis/cloudtasks_v2beta2/classes.rb', line 1643 def @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
1654 1655 1656 |
# File 'generated/google/apis/cloudtasks_v2beta2/classes.rb', line 1654 def schedule_time @schedule_time end |
#status ⇒ Google::Apis::CloudtasksV2beta2::TaskStatus
Status of the task.
Corresponds to the JSON property status
1659 1660 1661 |
# File 'generated/google/apis/cloudtasks_v2beta2/classes.rb', line 1659 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
1665 1666 1667 |
# File 'generated/google/apis/cloudtasks_v2beta2/classes.rb', line 1665 def view @view end |
Instance Method Details
#update!(**args) ⇒ Object
Update properties of this object
1672 1673 1674 1675 1676 1677 1678 1679 1680 |
# File 'generated/google/apis/cloudtasks_v2beta2/classes.rb', line 1672 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 |