Class AppEngineRouting (1.3.0)

App Engine Routing.

Defines routing characteristics specific to App Engine - service, version, and instance.

For more information about services, versions, and instances see An Overview of App Engine <https://cloud.google.com/appengine/docs/python/an-overview-of-app-engine>, Microservices Architecture on Google App Engine <https://cloud.google.com/appengine/docs/python/microservices-on-app-engine>, App Engine Standard request routing <https://cloud.google.com/appengine/docs/standard/python/how-requests-are-routed>, and App Engine Flex request routing <https://cloud.google.com/appengine/docs/flexible/python/how-requests-are-routed>.

App version. By default, the task is sent to the version which is the default version when the task is attempted. For some queues or tasks which were created using the App Engine Task Queue API, host is not parsable into [service][google.cloud.tasks.v2beta2.AppEngi neRouting.service], [version][google.cloud.tasks.v2beta2.AppEn gineRouting.version], and [instance][google.cloud.tasks.v2beta 2.AppEngineRouting.instance]. For example, some tasks which were created using the App Engine SDK use a custom domain name; custom domains are not parsed by Cloud Tasks. If host is not parsable, then [service][google.cloud.tasks.v2beta2.AppEng ineRouting.service], [version][google.cloud.tasks.v2beta2.AppE ngineRouting.version], and [instance][google.cloud.tasks.v2bet a2.AppEngineRouting.instance] are the empty string.

Output only. The host that the task is sent to. For more information, see How Requests are Routed <https://cloud.google.com/appengine/docs/standard/python/how- requests-are-routed>_. The host is constructed as: - host = [application_domain_name]\ `| [service] + '.'

  • [application_domain_name]\| [version] + '.' + [application_domain_name]\| [version_dot_service]+ '.' + [application_domain_name]\| [instance] + '.' + [application_domain_name]\| [instance_dot_service] + '.' + [application_domain_name]\| [instance_dot_version] + '.' + [application_domain_name]`| [instance_dot_version_dot_service] + '.' + [application_domain_name] - application_domain_name = The domain name of the app, for example .appspot.com, which is associated with the queue's project ID. Some tasks which were created using the App Engine SDK use a custom domain name. - service = service
  • version = version
  • version_dot_service = version + '.' + service
  • instance = [instance][google.cloud.tasks.v2beta2.App EngineRouting.instance] - instance_dot_service = [ins tance][google.cloud.tasks.v2beta2.AppEngineRouting.instance] + '.' + service
  • instance_dot_version = [instance][google.cloud.tasks .v2beta2.AppEngineRouting.instance] + '.' + version
  • instance_dot_version_dot_service = [instance][google .cloud.tasks.v2beta2.AppEngineRouting.instance] + '.' + version + '.' + service If service is empty, then the task will be sent to the service which is the default service when the task is attempted. If version is empty, then the task will be sent to the version which is the default version when the task is attempted. If [instance] [google.cloud.tasks.v2beta2.AppEngineRouting.instance] is empty, then the task will be sent to an instance which is available when the task is attempted. If [service][google.clo ud.tasks.v2beta2.AppEngineRouting.service], [version][google.c loud.tasks.v2beta2.AppEngineRouting.version], or [instance][go ogle.cloud.tasks.v2beta2.AppEngineRouting.instance] is invalid, then the task will be sent to the default version of the default service when the task is attempted.