Documentation ¶
Overview ¶
Package cloudtasks aliases all exported identifiers in package "cloud.google.com/go/cloudtasks/apiv2/cloudtaskspb".
Deprecated: Please use types in: cloud.google.com/go/cloudtasks/apiv2/cloudtaskspb. Please read https://github.com/googleapis/google-cloud-go/blob/main/migration.md for more details.
Index ¶
- Constants
- Variables
- func RegisterCloudTasksServer(s *grpc.Server, srv CloudTasksServer)deprecated
- type AppEngineHttpRequestdeprecated
- type AppEngineRoutingdeprecated
- type Attemptdeprecated
- type CloudTasksClientdeprecated
- type CloudTasksServerdeprecated
- type CreateQueueRequestdeprecated
- type CreateTaskRequestdeprecated
- type DeleteQueueRequestdeprecated
- type DeleteTaskRequestdeprecated
- type GetQueueRequestdeprecated
- type GetTaskRequestdeprecated
- type HttpMethoddeprecated
- type HttpRequestdeprecated
- type HttpRequest_OauthToken
- type HttpRequest_OidcToken
- type ListQueuesRequestdeprecated
- type ListQueuesResponsedeprecated
- type ListTasksRequestdeprecated
- type ListTasksResponsedeprecated
- type OAuthTokendeprecated
- type OidcTokendeprecated
- type PauseQueueRequestdeprecated
- type PurgeQueueRequestdeprecated
- type Queuedeprecated
- type Queue_Statedeprecated
- type RateLimitsdeprecated
- type ResumeQueueRequestdeprecated
- type RetryConfigdeprecated
- type RunTaskRequestdeprecated
- type StackdriverLoggingConfigdeprecated
- type Taskdeprecated
- type Task_AppEngineHttpRequest
- type Task_HttpRequest
- type Task_Viewdeprecated
- type UnimplementedCloudTasksServerdeprecated
- type UpdateQueueRequestdeprecated
Constants ¶
const ( HttpMethod_DELETE = src.HttpMethod_DELETE HttpMethod_GET = src.HttpMethod_GET HttpMethod_HEAD = src.HttpMethod_HEAD HttpMethod_HTTP_METHOD_UNSPECIFIED = src.HttpMethod_HTTP_METHOD_UNSPECIFIED HttpMethod_OPTIONS = src.HttpMethod_OPTIONS HttpMethod_PATCH = src.HttpMethod_PATCH HttpMethod_POST = src.HttpMethod_POST HttpMethod_PUT = src.HttpMethod_PUT Queue_DISABLED = src.Queue_DISABLED Queue_PAUSED = src.Queue_PAUSED Queue_RUNNING = src.Queue_RUNNING Queue_STATE_UNSPECIFIED = src.Queue_STATE_UNSPECIFIED Task_BASIC = src.Task_BASIC Task_FULL = src.Task_FULL Task_VIEW_UNSPECIFIED = src.Task_VIEW_UNSPECIFIED )
Deprecated: Please use consts in: cloud.google.com/go/cloudtasks/apiv2/cloudtaskspb
Variables ¶
var ( File_google_cloud_tasks_v2_cloudtasks_proto = src.File_google_cloud_tasks_v2_cloudtasks_proto File_google_cloud_tasks_v2_queue_proto = src.File_google_cloud_tasks_v2_queue_proto File_google_cloud_tasks_v2_target_proto = src.File_google_cloud_tasks_v2_target_proto File_google_cloud_tasks_v2_task_proto = src.File_google_cloud_tasks_v2_task_proto HttpMethod_name = src.HttpMethod_name HttpMethod_value = src.HttpMethod_value Queue_State_name = src.Queue_State_name Queue_State_value = src.Queue_State_value Task_View_name = src.Task_View_name Task_View_value = src.Task_View_value )
Deprecated: Please use vars in: cloud.google.com/go/cloudtasks/apiv2/cloudtaskspb
Functions ¶
func RegisterCloudTasksServer
deprecated
func RegisterCloudTasksServer(s *grpc.Server, srv CloudTasksServer)
Deprecated: Please use funcs in: cloud.google.com/go/cloudtasks/apiv2/cloudtaskspb
Types ¶
type AppEngineHttpRequest
deprecated
type AppEngineHttpRequest = src.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[google.cloud.tasks.v2.AppEngineHttpRequest] requires [`appengine.applications.get`](https://cloud.google.com/appengine/docs/admin-api/access-control) 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](https://cloud.google.com/appengine/docs/standard/python/how-requests-are-routed) and how routing is affected by [dispatch files](https://cloud.google.com/appengine/docs/python/config/dispatchref). 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[google.cloud.tasks.v2.AppEngineRouting] used to construct the URL that the task is delivered to can be set at the queue-level or task-level: - If [app_engine_routing_override is set on the queue][Queue.app_engine_routing_override], this value is used for all tasks in the queue, no matter what the setting is for the [task-level app_engine_routing][AppEngineHttpRequest.app_engine_routing]. The `url` that the task will be sent to is: - `url =` [host][google.cloud.tasks.v2.AppEngineRouting.host] `+` [relative_uri][google.cloud.tasks.v2.AppEngineHttpRequest.relative_uri] Tasks can be dispatched to secure app handlers, unsecure app handlers, and URIs restricted with [`login: admin`](https://cloud.google.com/appengine/docs/standard/python/config/appref). Because tasks are not run as any user, they cannot be dispatched to URIs restricted with [`login: required`](https://cloud.google.com/appengine/docs/standard/python/config/appref) 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][google.cloud.tasks.v2.Task.dispatch_deadline]. Failed tasks will be retried according to the [retry configuration][google.cloud.tasks.v2.Queue.retry_config]. `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.
Deprecated: Please use types in: cloud.google.com/go/cloudtasks/apiv2/cloudtaskspb
type AppEngineRouting
deprecated
type AppEngineRouting = src.AppEngineRouting
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). Using AppEngineRouting[google.cloud.tasks.v2.AppEngineRouting] requires [`appengine.applications.get`](https://cloud.google.com/appengine/docs/admin-api/access-control) Google IAM permission for the project and the following scope: `https://www.googleapis.com/auth/cloud-platform`
Deprecated: Please use types in: cloud.google.com/go/cloudtasks/apiv2/cloudtaskspb
type CloudTasksClient
deprecated
type CloudTasksClient = src.CloudTasksClient
CloudTasksClient is the client API for CloudTasks service. For semantics around ctx use and closing/ending streaming RPCs, please refer to https://godoc.org/google.golang.org/grpc#ClientConn.NewStream.
Deprecated: Please use types in: cloud.google.com/go/cloudtasks/apiv2/cloudtaskspb
func NewCloudTasksClient
deprecated
func NewCloudTasksClient(cc grpc.ClientConnInterface) CloudTasksClient
Deprecated: Please use funcs in: cloud.google.com/go/cloudtasks/apiv2/cloudtaskspb
type CloudTasksServer
deprecated
type CloudTasksServer = src.CloudTasksServer
CloudTasksServer is the server API for CloudTasks service.
Deprecated: Please use types in: cloud.google.com/go/cloudtasks/apiv2/cloudtaskspb
type CreateQueueRequest
deprecated
type CreateQueueRequest = src.CreateQueueRequest
Request message for [CreateQueue][google.cloud.tasks.v2.CloudTasks.CreateQueue].
Deprecated: Please use types in: cloud.google.com/go/cloudtasks/apiv2/cloudtaskspb
type CreateTaskRequest
deprecated
type CreateTaskRequest = src.CreateTaskRequest
Request message for [CreateTask][google.cloud.tasks.v2.CloudTasks.CreateTask].
Deprecated: Please use types in: cloud.google.com/go/cloudtasks/apiv2/cloudtaskspb
type DeleteQueueRequest
deprecated
type DeleteQueueRequest = src.DeleteQueueRequest
Request message for [DeleteQueue][google.cloud.tasks.v2.CloudTasks.DeleteQueue].
Deprecated: Please use types in: cloud.google.com/go/cloudtasks/apiv2/cloudtaskspb
type DeleteTaskRequest
deprecated
type DeleteTaskRequest = src.DeleteTaskRequest
Request message for deleting a task using [DeleteTask][google.cloud.tasks.v2.CloudTasks.DeleteTask].
Deprecated: Please use types in: cloud.google.com/go/cloudtasks/apiv2/cloudtaskspb
type GetQueueRequest
deprecated
type GetQueueRequest = src.GetQueueRequest
Request message for [GetQueue][google.cloud.tasks.v2.CloudTasks.GetQueue].
Deprecated: Please use types in: cloud.google.com/go/cloudtasks/apiv2/cloudtaskspb
type GetTaskRequest
deprecated
type GetTaskRequest = src.GetTaskRequest
Request message for getting a task using [GetTask][google.cloud.tasks.v2.CloudTasks.GetTask].
Deprecated: Please use types in: cloud.google.com/go/cloudtasks/apiv2/cloudtaskspb
type HttpMethod
deprecated
type HttpMethod = src.HttpMethod
The HTTP method used to deliver the task.
Deprecated: Please use types in: cloud.google.com/go/cloudtasks/apiv2/cloudtaskspb
type HttpRequest
deprecated
type HttpRequest = src.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][google.cloud.tasks.v2.Queue.retry_config], [rate limits][google.cloud.tasks.v2.Queue.rate_limits], and the [queue's state][google.cloud.tasks.v2.Queue.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][google.cloud.tasks.v2.Queue.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).
Deprecated: Please use types in: cloud.google.com/go/cloudtasks/apiv2/cloudtaskspb
type HttpRequest_OauthToken ¶
type HttpRequest_OauthToken = src.HttpRequest_OauthToken
type HttpRequest_OidcToken ¶
type HttpRequest_OidcToken = src.HttpRequest_OidcToken
type ListQueuesRequest
deprecated
type ListQueuesRequest = src.ListQueuesRequest
Request message for [ListQueues][google.cloud.tasks.v2.CloudTasks.ListQueues].
Deprecated: Please use types in: cloud.google.com/go/cloudtasks/apiv2/cloudtaskspb
type ListQueuesResponse
deprecated
type ListQueuesResponse = src.ListQueuesResponse
Response message for [ListQueues][google.cloud.tasks.v2.CloudTasks.ListQueues].
Deprecated: Please use types in: cloud.google.com/go/cloudtasks/apiv2/cloudtaskspb
type ListTasksRequest
deprecated
type ListTasksRequest = src.ListTasksRequest
Request message for listing tasks using [ListTasks][google.cloud.tasks.v2.CloudTasks.ListTasks].
Deprecated: Please use types in: cloud.google.com/go/cloudtasks/apiv2/cloudtaskspb
type ListTasksResponse
deprecated
type ListTasksResponse = src.ListTasksResponse
Response message for listing tasks using [ListTasks][google.cloud.tasks.v2.CloudTasks.ListTasks].
Deprecated: Please use types in: cloud.google.com/go/cloudtasks/apiv2/cloudtaskspb
type OAuthToken
deprecated
type OAuthToken = src.OAuthToken
Contains information needed for generating an [OAuth token](https://developers.google.com/identity/protocols/OAuth2). This type of authorization should generally only be used when calling Google APIs hosted on *.googleapis.com.
Deprecated: Please use types in: cloud.google.com/go/cloudtasks/apiv2/cloudtaskspb
type OidcToken
deprecated
Contains information needed for generating an [OpenID Connect token](https://developers.google.com/identity/protocols/OpenIDConnect). This type of authorization can be used for many scenarios, including calling Cloud Run, or endpoints where you intend to validate the token yourself.
Deprecated: Please use types in: cloud.google.com/go/cloudtasks/apiv2/cloudtaskspb
type PauseQueueRequest
deprecated
type PauseQueueRequest = src.PauseQueueRequest
Request message for [PauseQueue][google.cloud.tasks.v2.CloudTasks.PauseQueue].
Deprecated: Please use types in: cloud.google.com/go/cloudtasks/apiv2/cloudtaskspb
type PurgeQueueRequest
deprecated
type PurgeQueueRequest = src.PurgeQueueRequest
Request message for [PurgeQueue][google.cloud.tasks.v2.CloudTasks.PurgeQueue].
Deprecated: Please use types in: cloud.google.com/go/cloudtasks/apiv2/cloudtaskspb
type Queue
deprecated
type Queue_State
deprecated
type Queue_State = src.Queue_State
State of the queue.
Deprecated: Please use types in: cloud.google.com/go/cloudtasks/apiv2/cloudtaskspb
type RateLimits
deprecated
type RateLimits = src.RateLimits
Rate limits. This message determines the maximum rate that tasks can be dispatched by a queue, regardless of whether the dispatch is a first task attempt or a retry. Note: The debugging command, [RunTask][google.cloud.tasks.v2.CloudTasks.RunTask], will run a task even if the queue has reached its RateLimits[google.cloud.tasks.v2.RateLimits].
Deprecated: Please use types in: cloud.google.com/go/cloudtasks/apiv2/cloudtaskspb
type ResumeQueueRequest
deprecated
type ResumeQueueRequest = src.ResumeQueueRequest
Request message for [ResumeQueue][google.cloud.tasks.v2.CloudTasks.ResumeQueue].
Deprecated: Please use types in: cloud.google.com/go/cloudtasks/apiv2/cloudtaskspb
type RetryConfig
deprecated
type RetryConfig = src.RetryConfig
Retry config. These settings determine when a failed task attempt is retried.
Deprecated: Please use types in: cloud.google.com/go/cloudtasks/apiv2/cloudtaskspb
type RunTaskRequest
deprecated
type RunTaskRequest = src.RunTaskRequest
Request message for forcing a task to run now using [RunTask][google.cloud.tasks.v2.CloudTasks.RunTask].
Deprecated: Please use types in: cloud.google.com/go/cloudtasks/apiv2/cloudtaskspb
type StackdriverLoggingConfig
deprecated
type StackdriverLoggingConfig = src.StackdriverLoggingConfig
Configuration options for writing logs to [Stackdriver Logging](https://cloud.google.com/logging/docs/).
Deprecated: Please use types in: cloud.google.com/go/cloudtasks/apiv2/cloudtaskspb
type Task_AppEngineHttpRequest ¶
type Task_AppEngineHttpRequest = src.Task_AppEngineHttpRequest
type Task_HttpRequest ¶
type Task_HttpRequest = src.Task_HttpRequest
type Task_View
deprecated
The view specifies a subset of Task[google.cloud.tasks.v2.Task] data. When a task is returned in a response, not all information is retrieved by default because some data, such as payloads, might be desirable to return only when needed because of its large size or because of the sensitivity of data that it contains.
Deprecated: Please use types in: cloud.google.com/go/cloudtasks/apiv2/cloudtaskspb
type UnimplementedCloudTasksServer
deprecated
type UnimplementedCloudTasksServer = src.UnimplementedCloudTasksServer
UnimplementedCloudTasksServer can be embedded to have forward compatible implementations.
Deprecated: Please use types in: cloud.google.com/go/cloudtasks/apiv2/cloudtaskspb
type UpdateQueueRequest
deprecated
type UpdateQueueRequest = src.UpdateQueueRequest
Request message for [UpdateQueue][google.cloud.tasks.v2.CloudTasks.UpdateQueue].
Deprecated: Please use types in: cloud.google.com/go/cloudtasks/apiv2/cloudtaskspb