Home - News ( United States | United Kingdom | Italy | Germany ) - Football scores

Showing content from http://cloud.google.com/appengine/docs/legacy/standard/python/taskqueue/push/creating-handlers below:

Creating Task Handlers | App Engine standard environment for Python 2

Stay organized with collections Save and categorize content based on your preferences.

This page describes how to create a task handler, the code that handles a push task. You must provide a request handler to process the task. The mapping from the request URL to the appropriate handler is declared in your service's app.yaml, just like any other request handler. Because you control how to map task requests to a handler, you're free to organize your task handlers. If your application processes many different kinds of tasks, you can add all the handlers to a single service, or you can distribute them among multiple services.

In the queue, the Task Queue service creates an HTTP header and sends it to an instance of the worker service specified by the task's target. Task Queue requests are sent from the IP address 0.1.0.2.

Your handler does not need to be written in the same language that created and enqueued the task if the handler is in a separate service.

When you write your handler, follow these guidelines:

• The code must return an HTTP status code within the range 200–299 to indicate success. Any other code indicates that the task failed.

  Note: App Engine itself returns a 503 status code when instances are overloaded or otherwise unavailable. The Task Queue service responds to this by slowing delivery from queues to handlers, to avoid making the problem worse. If you wish to trigger a retry intentionally, use any status code other than 2xx or 503.

• Push tasks have a fixed completion deadline that depends on the scaling type of the service that's running them. Automatic scaling services must finish before 10 minutes have elapsed. Manual and basic scaling services can run up to 24 hours. If your handler misses the deadline, the Task Queue service assumes the task failed and will retry it.

  When a task's execution time nears the deadline, App Engine raises a DeadlineExceededError (from the module google.appengine.runtime) before the deadline is reached, so you can save your work or log whatever progress was made.

• The handler must be idempotent. App Engine's Task Queue API is designed to provide "at least once" delivery; that is, if a task is successfully added, App Engine will deliver it to a handler at least once. Note that in some rare circumstances, multiple task execution is possible, so your code must ensure that there are no harmful side-effects of repeated execution.

The following example demonstrates retrieving an integer value from a request and adding the value to a counter that is maintained in Cloud Datastore:

The mapping from the task's url /update-counter to the class UpdateCounterHandler is done inside WSGIApplication.

The worker.yaml file creates a service named "worker" and adds the worker code to it. Note that the handler's URL is secure because it specifies login:admin:

Task Queue uses the HTTP code in the handler's response to determine if the task succeeded. The response from the handler is seen only by the Task Queue service and only to determine if the task succeeded. The queue ignores all other fields in the response. Then the service discards the response. The originating app never receives any of the data. If a task fails, the Task Queue service retries the task by sending another request.

User-supplied data can be delivered to the handler in the request as a query string or as a payload in the request body. Inserting user data is described in Creating Tasks. If the request includes data, the handler must know how it was inserted into the request. The exact code you use to fetch the data from the request depends on the particular web framework you're using.

To test a task handler, sign in as an administrator and visit the handler's URL in your browser.

A push task HTTP request has special headers set by App Engine, which contain task-specific information your handler can use.

If these headers are present in an external user request to your app, they are stripped and replaced. The sole exception is for requests from logged-in administrators of the application, who are allowed to set headers for testing purposes. On the other hand, headers are not removed when your app is running in the development server.

Requests from Task Queue will always contain the following headers:

If your request handler finds any of the headers listed above, it can trust that the request is a Task Queue request.

In addition, requests from Task Queue can contain the following headers:

If a task performs sensitive operations (such as modifying data), you might want to secure the handler URL to prevent a malicious external user from calling it directly. You can prevent users from accessing task URLs by restricting access to App Engine administrators. Task requests themselves are issued by App Engine and can always target a restricted URL.

You can restrict a URL by adding the login: admin element to the handler configuration in your app.yaml file.

For example:

handlers:
- url: /your-task
  script: worker.app
  login: admin

• Learn how to delete tasks

Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025-08-07 UTC.

[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-07 UTC."],[[["A task handler processes push tasks and is mapped to a request URL in the `app.yaml` file, similar to other request handlers."],["Task handlers must return an HTTP status code between 200-299 to indicate success, and any other code triggers a retry of the task, except for 503 which will cause the service to slow the delivery."],["Task handlers should be idempotent to handle potential multiple executions of the same task due to the \"at least once\" delivery guarantee."],["App Engine adds specific headers to task requests (e.g., `X-Appengine-QueueName`, `X-Appengine-TaskRetryCount`) which can be used to identify task queue requests and gather task-specific information."],["You can secure task handler URLs by restricting access to App Engine administrators using `login: admin` in the `app.yaml` file to prevent external user access."]]],[]]

RetroSearch is an open source project built by @garambo | Open a GitHub Issue

Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo

HTML: 3.2 | Encoding: UTF-8 | Version: 0.7.4