diff --git a/.flake8 b/.flake8 index 20fe9bda..ed931638 100644 --- a/.flake8 +++ b/.flake8 @@ -21,6 +21,8 @@ exclude = # Exclude generated code. **/proto/** **/gapic/** + **/services/** + **/types/** *_pb2.py # Standard linting exemptions. diff --git a/.gitignore b/.gitignore index 3fb06e09..b87e1ed5 100644 --- a/.gitignore +++ b/.gitignore @@ -10,6 +10,7 @@ dist build eggs +.eggs parts bin var @@ -49,6 +50,7 @@ bigquery/docs/generated # Virtual environment env/ coverage.xml +sponge_log.xml # System test environment variables. system_tests/local_test_setup diff --git a/.kokoro/publish-docs.sh b/.kokoro/publish-docs.sh index eabfe626..81c6e278 100755 --- a/.kokoro/publish-docs.sh +++ b/.kokoro/publish-docs.sh @@ -13,8 +13,6 @@ # See the License for the specific language governing permissions and # limitations under the License. -#!/bin/bash - set -eo pipefail # Disable buffering, so that the logs stream through. diff --git a/.kokoro/release.sh b/.kokoro/release.sh index 29330b18..7cce3b21 100755 --- a/.kokoro/release.sh +++ b/.kokoro/release.sh @@ -13,8 +13,6 @@ # See the License for the specific language governing permissions and # limitations under the License. -#!/bin/bash - set -eo pipefail # Start the releasetool reporter diff --git a/.kokoro/samples/lint/common.cfg b/.kokoro/samples/lint/common.cfg new file mode 100644 index 00000000..9ba5735f --- /dev/null +++ b/.kokoro/samples/lint/common.cfg @@ -0,0 +1,34 @@ +# Format: //devtools/kokoro/config/proto/build.proto + +# Build logs will be here +action { + define_artifacts { + regex: "**/*sponge_log.xml" + } +} + +# Specify which tests to run +env_vars: { + key: "RUN_TESTS_SESSION" + value: "lint" +} + +env_vars: { + key: "TRAMPOLINE_BUILD_FILE" + value: "github/python-tasks/.kokoro/test-samples.sh" +} + +# Configure the docker image for kokoro-trampoline. +env_vars: { + key: "TRAMPOLINE_IMAGE" + value: "gcr.io/cloud-devrel-kokoro-resources/python-samples-testing-docker" +} + +# Download secrets for samples +gfile_resources: "/bigstore/cloud-devrel-kokoro-resources/python-docs-samples" + +# Download trampoline resources. +gfile_resources: "/bigstore/cloud-devrel-kokoro-resources/trampoline" + +# Use the trampoline script to run in docker. +build_file: "python-tasks/.kokoro/trampoline.sh" \ No newline at end of file diff --git a/.kokoro/samples/lint/continuous.cfg b/.kokoro/samples/lint/continuous.cfg new file mode 100644 index 00000000..a1c8d975 --- /dev/null +++ b/.kokoro/samples/lint/continuous.cfg @@ -0,0 +1,6 @@ +# Format: //devtools/kokoro/config/proto/build.proto + +env_vars: { + key: "INSTALL_LIBRARY_FROM_SOURCE" + value: "True" +} \ No newline at end of file diff --git a/.kokoro/samples/lint/periodic.cfg b/.kokoro/samples/lint/periodic.cfg new file mode 100644 index 00000000..50fec964 --- /dev/null +++ b/.kokoro/samples/lint/periodic.cfg @@ -0,0 +1,6 @@ +# Format: //devtools/kokoro/config/proto/build.proto + +env_vars: { + key: "INSTALL_LIBRARY_FROM_SOURCE" + value: "False" +} \ No newline at end of file diff --git a/.kokoro/samples/lint/presubmit.cfg b/.kokoro/samples/lint/presubmit.cfg new file mode 100644 index 00000000..a1c8d975 --- /dev/null +++ b/.kokoro/samples/lint/presubmit.cfg @@ -0,0 +1,6 @@ +# Format: //devtools/kokoro/config/proto/build.proto + +env_vars: { + key: "INSTALL_LIBRARY_FROM_SOURCE" + value: "True" +} \ No newline at end of file diff --git a/.kokoro/samples/python3.6/common.cfg b/.kokoro/samples/python3.6/common.cfg new file mode 100644 index 00000000..d999f828 --- /dev/null +++ b/.kokoro/samples/python3.6/common.cfg @@ -0,0 +1,34 @@ +# Format: //devtools/kokoro/config/proto/build.proto + +# Build logs will be here +action { + define_artifacts { + regex: "**/*sponge_log.xml" + } +} + +# Specify which tests to run +env_vars: { + key: "RUN_TESTS_SESSION" + value: "py-3.6" +} + +env_vars: { + key: "TRAMPOLINE_BUILD_FILE" + value: "github/python-tasks/.kokoro/test-samples.sh" +} + +# Configure the docker image for kokoro-trampoline. +env_vars: { + key: "TRAMPOLINE_IMAGE" + value: "gcr.io/cloud-devrel-kokoro-resources/python-samples-testing-docker" +} + +# Download secrets for samples +gfile_resources: "/bigstore/cloud-devrel-kokoro-resources/python-docs-samples" + +# Download trampoline resources. +gfile_resources: "/bigstore/cloud-devrel-kokoro-resources/trampoline" + +# Use the trampoline script to run in docker. +build_file: "python-tasks/.kokoro/trampoline.sh" \ No newline at end of file diff --git a/.kokoro/samples/python3.6/continuous.cfg b/.kokoro/samples/python3.6/continuous.cfg new file mode 100644 index 00000000..7218af14 --- /dev/null +++ b/.kokoro/samples/python3.6/continuous.cfg @@ -0,0 +1,7 @@ +# Format: //devtools/kokoro/config/proto/build.proto + +env_vars: { + key: "INSTALL_LIBRARY_FROM_SOURCE" + value: "True" +} + diff --git a/.kokoro/samples/python3.6/periodic.cfg b/.kokoro/samples/python3.6/periodic.cfg new file mode 100644 index 00000000..50fec964 --- /dev/null +++ b/.kokoro/samples/python3.6/periodic.cfg @@ -0,0 +1,6 @@ +# Format: //devtools/kokoro/config/proto/build.proto + +env_vars: { + key: "INSTALL_LIBRARY_FROM_SOURCE" + value: "False" +} \ No newline at end of file diff --git a/.kokoro/samples/python3.6/presubmit.cfg b/.kokoro/samples/python3.6/presubmit.cfg new file mode 100644 index 00000000..a1c8d975 --- /dev/null +++ b/.kokoro/samples/python3.6/presubmit.cfg @@ -0,0 +1,6 @@ +# Format: //devtools/kokoro/config/proto/build.proto + +env_vars: { + key: "INSTALL_LIBRARY_FROM_SOURCE" + value: "True" +} \ No newline at end of file diff --git a/.kokoro/samples/python3.7/common.cfg b/.kokoro/samples/python3.7/common.cfg new file mode 100644 index 00000000..70c5a021 --- /dev/null +++ b/.kokoro/samples/python3.7/common.cfg @@ -0,0 +1,34 @@ +# Format: //devtools/kokoro/config/proto/build.proto + +# Build logs will be here +action { + define_artifacts { + regex: "**/*sponge_log.xml" + } +} + +# Specify which tests to run +env_vars: { + key: "RUN_TESTS_SESSION" + value: "py-3.7" +} + +env_vars: { + key: "TRAMPOLINE_BUILD_FILE" + value: "github/python-tasks/.kokoro/test-samples.sh" +} + +# Configure the docker image for kokoro-trampoline. +env_vars: { + key: "TRAMPOLINE_IMAGE" + value: "gcr.io/cloud-devrel-kokoro-resources/python-samples-testing-docker" +} + +# Download secrets for samples +gfile_resources: "/bigstore/cloud-devrel-kokoro-resources/python-docs-samples" + +# Download trampoline resources. +gfile_resources: "/bigstore/cloud-devrel-kokoro-resources/trampoline" + +# Use the trampoline script to run in docker. +build_file: "python-tasks/.kokoro/trampoline.sh" \ No newline at end of file diff --git a/.kokoro/samples/python3.7/continuous.cfg b/.kokoro/samples/python3.7/continuous.cfg new file mode 100644 index 00000000..a1c8d975 --- /dev/null +++ b/.kokoro/samples/python3.7/continuous.cfg @@ -0,0 +1,6 @@ +# Format: //devtools/kokoro/config/proto/build.proto + +env_vars: { + key: "INSTALL_LIBRARY_FROM_SOURCE" + value: "True" +} \ No newline at end of file diff --git a/.kokoro/samples/python3.7/periodic.cfg b/.kokoro/samples/python3.7/periodic.cfg new file mode 100644 index 00000000..50fec964 --- /dev/null +++ b/.kokoro/samples/python3.7/periodic.cfg @@ -0,0 +1,6 @@ +# Format: //devtools/kokoro/config/proto/build.proto + +env_vars: { + key: "INSTALL_LIBRARY_FROM_SOURCE" + value: "False" +} \ No newline at end of file diff --git a/.kokoro/samples/python3.7/presubmit.cfg b/.kokoro/samples/python3.7/presubmit.cfg new file mode 100644 index 00000000..a1c8d975 --- /dev/null +++ b/.kokoro/samples/python3.7/presubmit.cfg @@ -0,0 +1,6 @@ +# Format: //devtools/kokoro/config/proto/build.proto + +env_vars: { + key: "INSTALL_LIBRARY_FROM_SOURCE" + value: "True" +} \ No newline at end of file diff --git a/.kokoro/samples/python3.8/common.cfg b/.kokoro/samples/python3.8/common.cfg new file mode 100644 index 00000000..d9216c2b --- /dev/null +++ b/.kokoro/samples/python3.8/common.cfg @@ -0,0 +1,34 @@ +# Format: //devtools/kokoro/config/proto/build.proto + +# Build logs will be here +action { + define_artifacts { + regex: "**/*sponge_log.xml" + } +} + +# Specify which tests to run +env_vars: { + key: "RUN_TESTS_SESSION" + value: "py-3.8" +} + +env_vars: { + key: "TRAMPOLINE_BUILD_FILE" + value: "github/python-tasks/.kokoro/test-samples.sh" +} + +# Configure the docker image for kokoro-trampoline. +env_vars: { + key: "TRAMPOLINE_IMAGE" + value: "gcr.io/cloud-devrel-kokoro-resources/python-samples-testing-docker" +} + +# Download secrets for samples +gfile_resources: "/bigstore/cloud-devrel-kokoro-resources/python-docs-samples" + +# Download trampoline resources. +gfile_resources: "/bigstore/cloud-devrel-kokoro-resources/trampoline" + +# Use the trampoline script to run in docker. +build_file: "python-tasks/.kokoro/trampoline.sh" \ No newline at end of file diff --git a/.kokoro/samples/python3.8/continuous.cfg b/.kokoro/samples/python3.8/continuous.cfg new file mode 100644 index 00000000..a1c8d975 --- /dev/null +++ b/.kokoro/samples/python3.8/continuous.cfg @@ -0,0 +1,6 @@ +# Format: //devtools/kokoro/config/proto/build.proto + +env_vars: { + key: "INSTALL_LIBRARY_FROM_SOURCE" + value: "True" +} \ No newline at end of file diff --git a/.kokoro/samples/python3.8/periodic.cfg b/.kokoro/samples/python3.8/periodic.cfg new file mode 100644 index 00000000..50fec964 --- /dev/null +++ b/.kokoro/samples/python3.8/periodic.cfg @@ -0,0 +1,6 @@ +# Format: //devtools/kokoro/config/proto/build.proto + +env_vars: { + key: "INSTALL_LIBRARY_FROM_SOURCE" + value: "False" +} \ No newline at end of file diff --git a/.kokoro/samples/python3.8/presubmit.cfg b/.kokoro/samples/python3.8/presubmit.cfg new file mode 100644 index 00000000..a1c8d975 --- /dev/null +++ b/.kokoro/samples/python3.8/presubmit.cfg @@ -0,0 +1,6 @@ +# Format: //devtools/kokoro/config/proto/build.proto + +env_vars: { + key: "INSTALL_LIBRARY_FROM_SOURCE" + value: "True" +} \ No newline at end of file diff --git a/.kokoro/test-samples.sh b/.kokoro/test-samples.sh new file mode 100755 index 00000000..b2c51ae2 --- /dev/null +++ b/.kokoro/test-samples.sh @@ -0,0 +1,104 @@ +#!/bin/bash +# Copyright 2020 Google LLC +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# https://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + + +# `-e` enables the script to automatically fail when a command fails +# `-o pipefail` sets the exit code to the rightmost comment to exit with a non-zero +set -eo pipefail +# Enables `**` to include files nested inside sub-folders +shopt -s globstar + +cd github/python-tasks + +# Run periodic samples tests at latest release +if [[ $KOKORO_BUILD_ARTIFACTS_SUBDIR = *"periodic"* ]]; then + LATEST_RELEASE=$(git describe --abbrev=0 --tags) + git checkout $LATEST_RELEASE +fi + +# Disable buffering, so that the logs stream through. +export PYTHONUNBUFFERED=1 + +# Debug: show build environment +env | grep KOKORO + +# Install nox +python3.6 -m pip install --upgrade --quiet nox + +# Use secrets acessor service account to get secrets +if [[ -f "${KOKORO_GFILE_DIR}/secrets_viewer_service_account.json" ]]; then + gcloud auth activate-service-account \ + --key-file="${KOKORO_GFILE_DIR}/secrets_viewer_service_account.json" \ + --project="cloud-devrel-kokoro-resources" +fi + +# This script will create 3 files: +# - testing/test-env.sh +# - testing/service-account.json +# - testing/client-secrets.json +./scripts/decrypt-secrets.sh + +source ./testing/test-env.sh +export GOOGLE_APPLICATION_CREDENTIALS=$(pwd)/testing/service-account.json + +# For cloud-run session, we activate the service account for gcloud sdk. +gcloud auth activate-service-account \ + --key-file "${GOOGLE_APPLICATION_CREDENTIALS}" + +export GOOGLE_CLIENT_SECRETS=$(pwd)/testing/client-secrets.json + +echo -e "\n******************** TESTING PROJECTS ********************" + +# Switch to 'fail at end' to allow all tests to complete before exiting. +set +e +# Use RTN to return a non-zero value if the test fails. +RTN=0 +ROOT=$(pwd) +# Find all requirements.txt in the samples directory (may break on whitespace). +for file in samples/**/requirements.txt; do + cd "$ROOT" + # Navigate to the project folder. + file=$(dirname "$file") + cd "$file" + + echo "------------------------------------------------------------" + echo "- testing $file" + echo "------------------------------------------------------------" + + # Use nox to execute the tests for the project. + python3.6 -m nox -s "$RUN_TESTS_SESSION" + EXIT=$? + + # If this is a periodic build, send the test log to the Build Cop Bot. + # See https://github.com/googleapis/repo-automation-bots/tree/master/packages/buildcop. + if [[ $KOKORO_BUILD_ARTIFACTS_SUBDIR = *"periodic"* ]]; then + chmod +x $KOKORO_GFILE_DIR/linux_amd64/buildcop + $KOKORO_GFILE_DIR/linux_amd64/buildcop + fi + + if [[ $EXIT -ne 0 ]]; then + RTN=1 + echo -e "\n Testing failed: Nox returned a non-zero exit code. \n" + else + echo -e "\n Testing completed.\n" + fi + +done +cd "$ROOT" + +# Workaround for Kokoro permissions issue: delete secrets +rm testing/{test-env.sh,client-secrets.json,service-account.json} + +exit "$RTN" \ No newline at end of file diff --git a/MANIFEST.in b/MANIFEST.in index 68855abc..e9e29d12 100644 --- a/MANIFEST.in +++ b/MANIFEST.in @@ -20,3 +20,6 @@ recursive-include google *.json *.proto recursive-include tests * global-exclude *.py[co] global-exclude __pycache__ + +# Exclude scripts for samples readmegen +prune scripts/readme-gen \ No newline at end of file diff --git a/docs/conf.py b/docs/conf.py index 4c8da29b..136a058f 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -38,21 +38,18 @@ "sphinx.ext.napoleon", "sphinx.ext.todo", "sphinx.ext.viewcode", + "recommonmark", ] # autodoc/autosummary flags autoclass_content = "both" -autodoc_default_flags = ["members"] +autodoc_default_options = {"members": True} autosummary_generate = True # Add any paths that contain templates here, relative to this directory. templates_path = ["_templates"] -# Allow markdown includes (so releases.md can include CHANGLEOG.md) -# http://www.sphinx-doc.org/en/master/markdown.html -source_parsers = {".md": "recommonmark.parser.CommonMarkParser"} - # The suffix(es) of source filenames. # You can specify multiple suffix as a list of string: # source_suffix = ['.rst', '.md'] @@ -293,7 +290,13 @@ # One entry per manual page. List of tuples # (source start file, name, description, authors, manual section). man_pages = [ - (master_doc, "google-cloud-tasks", u"google-cloud-tasks Documentation", [author], 1) + ( + master_doc, + "google-cloud-tasks", + u"google-cloud-tasks Documentation", + [author], + 1, + ) ] # If true, show URL addresses after external links. @@ -334,7 +337,7 @@ intersphinx_mapping = { "python": ("http://python.readthedocs.org/en/latest/", None), "google-auth": ("https://google-auth.readthedocs.io/en/stable", None), - "google.api_core": ("https://googleapis.dev/python/google-api-core/latest/", None), + "google.api_core": ("https://googleapis.dev/python/google-api-core/latest/", None,), "grpc": ("https://grpc.io/grpc/python/", None), } diff --git a/docs/index.rst b/docs/index.rst index 03eab0c5..2c816781 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -1,5 +1,7 @@ .. include:: README.rst +.. include:: multiprocessing.rst + API Reference ------------- diff --git a/docs/multiprocessing.rst b/docs/multiprocessing.rst new file mode 100644 index 00000000..1cb29d4c --- /dev/null +++ b/docs/multiprocessing.rst @@ -0,0 +1,7 @@ +.. note:: + + Because this client uses :mod:`grpcio` library, it is safe to + share instances across threads. In multiprocessing scenarios, the best + practice is to create client instances *after* the invocation of + :func:`os.fork` by :class:`multiprocessing.Pool` or + :class:`multiprocessing.Process`. diff --git a/google/cloud/tasks.py b/google/cloud/tasks.py index 71a3298a..4b5214d5 100644 --- a/google/cloud/tasks.py +++ b/google/cloud/tasks.py @@ -22,4 +22,8 @@ from google.cloud.tasks_v2 import types -__all__ = ("enums", "types", "CloudTasksClient") +__all__ = ( + "enums", + "types", + "CloudTasksClient", +) diff --git a/google/cloud/tasks_v2/__init__.py b/google/cloud/tasks_v2/__init__.py index 0871ab0f..b9550b95 100644 --- a/google/cloud/tasks_v2/__init__.py +++ b/google/cloud/tasks_v2/__init__.py @@ -26,8 +26,8 @@ if sys.version_info[:2] == (2, 7): message = ( - "A future version of this library will drop support for Python 2.7." - "More details about Python 2 support for Google Cloud Client Libraries" + "A future version of this library will drop support for Python 2.7. " + "More details about Python 2 support for Google Cloud Client Libraries " "can be found at https://cloud.google.com/python/docs/python2-sunset/" ) warnings.warn(message, DeprecationWarning) @@ -38,4 +38,8 @@ class CloudTasksClient(cloud_tasks_client.CloudTasksClient): enums = enums -__all__ = ("enums", "types", "CloudTasksClient") +__all__ = ( + "enums", + "types", + "CloudTasksClient", +) diff --git a/google/cloud/tasks_v2/gapic/cloud_tasks_client.py b/google/cloud/tasks_v2/gapic/cloud_tasks_client.py index 7e185203..d0f62bff 100644 --- a/google/cloud/tasks_v2/gapic/cloud_tasks_client.py +++ b/google/cloud/tasks_v2/gapic/cloud_tasks_client.py @@ -45,7 +45,7 @@ from google.protobuf import field_mask_pb2 -_GAPIC_LIBRARY_VERSION = pkg_resources.get_distribution("google-cloud-tasks").version +_GAPIC_LIBRARY_VERSION = pkg_resources.get_distribution("google-cloud-tasks",).version class CloudTasksClient(object): @@ -198,12 +198,12 @@ def __init__( self.transport = transport else: self.transport = cloud_tasks_grpc_transport.CloudTasksGrpcTransport( - address=api_endpoint, channel=channel, credentials=credentials + address=api_endpoint, channel=channel, credentials=credentials, ) if client_info is None: client_info = google.api_core.gapic_v1.client_info.ClientInfo( - gapic_version=_GAPIC_LIBRARY_VERSION + gapic_version=_GAPIC_LIBRARY_VERSION, ) else: client_info.gapic_version = _GAPIC_LIBRARY_VERSION @@ -214,7 +214,7 @@ def __init__( # (Ordinarily, these are the defaults specified in the `*_config.py` # file next to this one.) self._method_configs = google.api_core.gapic_v1.config.parse_method_configs( - client_config["interfaces"][self._INTERFACE_NAME] + client_config["interfaces"][self._INTERFACE_NAME], ) # Save a dictionary of cached API call functions. @@ -271,7 +271,7 @@ def list_queues( Sample filter "state: PAUSED". Note that using filters might cause fewer queues than the requested - page\_size to be returned. + page_size to be returned. page_size (int): The maximum number of resources contained in the underlying API response. If page streaming is performed per- resource, this parameter does not affect the return value. If page @@ -311,7 +311,7 @@ def list_queues( ) request = cloudtasks_pb2.ListQueuesRequest( - parent=parent, filter=filter_, page_size=page_size + parent=parent, filter=filter_, page_size=page_size, ) if metadata is None: metadata = [] @@ -393,7 +393,7 @@ def get_queue( client_info=self._client_info, ) - request = cloudtasks_pb2.GetQueueRequest(name=name) + request = cloudtasks_pb2.GetQueueRequest(name=name,) if metadata is None: metadata = [] metadata = list(metadata) @@ -486,7 +486,7 @@ def create_queue( client_info=self._client_info, ) - request = cloudtasks_pb2.CreateQueueRequest(parent=parent, queue=queue) + request = cloudtasks_pb2.CreateQueueRequest(parent=parent, queue=queue,) if metadata is None: metadata = [] metadata = list(metadata) @@ -586,7 +586,7 @@ def update_queue( ) request = cloudtasks_pb2.UpdateQueueRequest( - queue=queue, update_mask=update_mask + queue=queue, update_mask=update_mask, ) if metadata is None: metadata = [] @@ -665,7 +665,7 @@ def delete_queue( client_info=self._client_info, ) - request = cloudtasks_pb2.DeleteQueueRequest(name=name) + request = cloudtasks_pb2.DeleteQueueRequest(name=name,) if metadata is None: metadata = [] metadata = list(metadata) @@ -740,7 +740,7 @@ def purge_queue( client_info=self._client_info, ) - request = cloudtasks_pb2.PurgeQueueRequest(name=name) + request = cloudtasks_pb2.PurgeQueueRequest(name=name,) if metadata is None: metadata = [] metadata = list(metadata) @@ -814,7 +814,7 @@ def pause_queue( client_info=self._client_info, ) - request = cloudtasks_pb2.PauseQueueRequest(name=name) + request = cloudtasks_pb2.PauseQueueRequest(name=name,) if metadata is None: metadata = [] metadata = list(metadata) @@ -893,7 +893,7 @@ def resume_queue( client_info=self._client_info, ) - request = cloudtasks_pb2.ResumeQueueRequest(name=name) + request = cloudtasks_pb2.ResumeQueueRequest(name=name,) if metadata is None: metadata = [] metadata = list(metadata) @@ -920,8 +920,8 @@ def get_iam_policy( metadata=None, ): """ - Gets the access control policy for a ``Queue``. Returns an empty policy - if the resource exists and does not have a policy set. + Gets the access control policy for a ``Queue``. Returns an empty + policy if the resource exists and does not have a policy set. Authorization requires the following `Google IAM `__ permission on the specified @@ -978,7 +978,7 @@ def get_iam_policy( ) request = iam_policy_pb2.GetIamPolicyRequest( - resource=resource, options=options_ + resource=resource, options=options_, ) if metadata is None: metadata = [] @@ -1006,8 +1006,8 @@ def set_iam_policy( metadata=None, ): """ - Sets the access control policy for a ``Queue``. Replaces any existing - policy. + Sets the access control policy for a ``Queue``. Replaces any + existing policy. Note: The Cloud Console does not check queue-level IAM permissions yet. Project-level permissions are required to use the Cloud Console. @@ -1071,7 +1071,7 @@ def set_iam_policy( client_info=self._client_info, ) - request = iam_policy_pb2.SetIamPolicyRequest(resource=resource, policy=policy) + request = iam_policy_pb2.SetIamPolicyRequest(resource=resource, policy=policy,) if metadata is None: metadata = [] metadata = list(metadata) @@ -1098,9 +1098,9 @@ def test_iam_permissions( metadata=None, ): """ - Returns permissions that a caller has on a ``Queue``. If the resource - does not exist, this will return an empty set of permissions, not a - ``NOT_FOUND`` error. + Returns permissions that a caller has on a ``Queue``. If the + resource does not exist, this will return an empty set of permissions, + not a ``NOT_FOUND`` error. Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization @@ -1122,8 +1122,8 @@ def test_iam_permissions( Args: resource (str): REQUIRED: The resource for which the policy detail is being requested. See the operation documentation for the appropriate value for this field. - permissions (list[str]): The set of permissions to check for the ``resource``. Permissions with - wildcards (such as '*' or 'storage.*') are not allowed. For more + permissions (list[str]): The set of permissions to check for the ``resource``. Permissions + with wildcards (such as '*' or 'storage.*') are not allowed. For more information see `IAM Overview `__. retry (Optional[google.api_core.retry.Retry]): A retry object used @@ -1157,7 +1157,7 @@ def test_iam_permissions( ) request = iam_policy_pb2.TestIamPermissionsRequest( - resource=resource, permissions=permissions + resource=resource, permissions=permissions, ) if metadata is None: metadata = [] @@ -1219,10 +1219,10 @@ def list_tasks( Args: parent (str): Required. The queue name. For example: ``projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`` - response_view (~google.cloud.tasks_v2.enums.Task.View): The response\_view specifies which subset of the ``Task`` will be + response_view (~google.cloud.tasks_v2.enums.Task.View): The response_view specifies which subset of the ``Task`` will be returned. - By default response\_view is ``BASIC``; not all information is retrieved + By default response_view is ``BASIC``; 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. @@ -1269,7 +1269,7 @@ def list_tasks( ) request = cloudtasks_pb2.ListTasksRequest( - parent=parent, response_view=response_view, page_size=page_size + parent=parent, response_view=response_view, page_size=page_size, ) if metadata is None: metadata = [] @@ -1322,10 +1322,10 @@ def get_task( Args: name (str): Required. The task name. For example: ``projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`` - response_view (~google.cloud.tasks_v2.enums.Task.View): The response\_view specifies which subset of the ``Task`` will be + response_view (~google.cloud.tasks_v2.enums.Task.View): The response_view specifies which subset of the ``Task`` will be returned. - By default response\_view is ``BASIC``; not all information is retrieved + By default response_view is ``BASIC``; 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. @@ -1363,7 +1363,7 @@ def get_task( client_info=self._client_info, ) - request = cloudtasks_pb2.GetTaskRequest(name=name, response_view=response_view) + request = cloudtasks_pb2.GetTaskRequest(name=name, response_view=response_view,) if metadata is None: metadata = [] metadata = list(metadata) @@ -1447,10 +1447,10 @@ def create_task( If a dict is provided, it must be of the same form as the protobuf message :class:`~google.cloud.tasks_v2.types.Task` - response_view (~google.cloud.tasks_v2.enums.Task.View): The response\_view specifies which subset of the ``Task`` will be + response_view (~google.cloud.tasks_v2.enums.Task.View): The response_view specifies which subset of the ``Task`` will be returned. - By default response\_view is ``BASIC``; not all information is retrieved + By default response_view is ``BASIC``; 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. @@ -1489,7 +1489,7 @@ def create_task( ) request = cloudtasks_pb2.CreateTaskRequest( - parent=parent, task=task, response_view=response_view + parent=parent, task=task, response_view=response_view, ) if metadata is None: metadata = [] @@ -1561,7 +1561,7 @@ def delete_task( client_info=self._client_info, ) - request = cloudtasks_pb2.DeleteTaskRequest(name=name) + request = cloudtasks_pb2.DeleteTaskRequest(name=name,) if metadata is None: metadata = [] metadata = list(metadata) @@ -1622,10 +1622,10 @@ def run_task( Args: name (str): Required. The task name. For example: ``projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`` - response_view (~google.cloud.tasks_v2.enums.Task.View): The response\_view specifies which subset of the ``Task`` will be + response_view (~google.cloud.tasks_v2.enums.Task.View): The response_view specifies which subset of the ``Task`` will be returned. - By default response\_view is ``BASIC``; not all information is retrieved + By default response_view is ``BASIC``; 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. @@ -1663,7 +1663,7 @@ def run_task( client_info=self._client_info, ) - request = cloudtasks_pb2.RunTaskRequest(name=name, response_view=response_view) + request = cloudtasks_pb2.RunTaskRequest(name=name, response_view=response_view,) if metadata is None: metadata = [] metadata = list(metadata) diff --git a/google/cloud/tasks_v2/gapic/cloud_tasks_client_config.py b/google/cloud/tasks_v2/gapic/cloud_tasks_client_config.py index 5c059c94..1517ab34 100644 --- a/google/cloud/tasks_v2/gapic/cloud_tasks_client_config.py +++ b/google/cloud/tasks_v2/gapic/cloud_tasks_client_config.py @@ -2,100 +2,119 @@ "interfaces": { "google.cloud.tasks.v2.CloudTasks": { "retry_codes": { - "idempotent": ["DEADLINE_EXCEEDED", "UNAVAILABLE"], - "non_idempotent": [], + "retry_policy_1_codes": ["DEADLINE_EXCEEDED", "UNAVAILABLE"], + "no_retry_codes": [], + "no_retry_1_codes": [], }, "retry_params": { - "default": { + "retry_policy_1_params": { "initial_retry_delay_millis": 100, "retry_delay_multiplier": 1.3, - "max_retry_delay_millis": 60000, - "initial_rpc_timeout_millis": 20000, + "max_retry_delay_millis": 10000, + "initial_rpc_timeout_millis": 10000, "rpc_timeout_multiplier": 1.0, - "max_rpc_timeout_millis": 20000, - "total_timeout_millis": 600000, - } + "max_rpc_timeout_millis": 10000, + "total_timeout_millis": 10000, + }, + "no_retry_params": { + "initial_retry_delay_millis": 0, + "retry_delay_multiplier": 0.0, + "max_retry_delay_millis": 0, + "initial_rpc_timeout_millis": 0, + "rpc_timeout_multiplier": 1.0, + "max_rpc_timeout_millis": 0, + "total_timeout_millis": 0, + }, + "no_retry_1_params": { + "initial_retry_delay_millis": 0, + "retry_delay_multiplier": 0.0, + "max_retry_delay_millis": 0, + "initial_rpc_timeout_millis": 10000, + "rpc_timeout_multiplier": 1.0, + "max_rpc_timeout_millis": 10000, + "total_timeout_millis": 10000, + }, }, "methods": { "ListQueues": { "timeout_millis": 15000, - "retry_codes_name": "idempotent", - "retry_params_name": "default", + "retry_codes_name": "retry_policy_1_codes", + "retry_params_name": "retry_policy_1_params", }, "GetQueue": { "timeout_millis": 10000, - "retry_codes_name": "idempotent", - "retry_params_name": "default", + "retry_codes_name": "retry_policy_1_codes", + "retry_params_name": "retry_policy_1_params", }, "CreateQueue": { "timeout_millis": 10000, - "retry_codes_name": "non_idempotent", - "retry_params_name": "default", + "retry_codes_name": "no_retry_1_codes", + "retry_params_name": "no_retry_1_params", }, "UpdateQueue": { "timeout_millis": 10000, - "retry_codes_name": "non_idempotent", - "retry_params_name": "default", + "retry_codes_name": "no_retry_1_codes", + "retry_params_name": "no_retry_1_params", }, "DeleteQueue": { "timeout_millis": 10000, - "retry_codes_name": "idempotent", - "retry_params_name": "default", + "retry_codes_name": "retry_policy_1_codes", + "retry_params_name": "retry_policy_1_params", }, "PurgeQueue": { "timeout_millis": 10000, - "retry_codes_name": "non_idempotent", - "retry_params_name": "default", + "retry_codes_name": "no_retry_1_codes", + "retry_params_name": "no_retry_1_params", }, "PauseQueue": { "timeout_millis": 10000, - "retry_codes_name": "non_idempotent", - "retry_params_name": "default", + "retry_codes_name": "no_retry_1_codes", + "retry_params_name": "no_retry_1_params", }, "ResumeQueue": { "timeout_millis": 10000, - "retry_codes_name": "non_idempotent", - "retry_params_name": "default", + "retry_codes_name": "no_retry_1_codes", + "retry_params_name": "no_retry_1_params", }, "GetIamPolicy": { "timeout_millis": 10000, - "retry_codes_name": "idempotent", - "retry_params_name": "default", + "retry_codes_name": "retry_policy_1_codes", + "retry_params_name": "retry_policy_1_params", }, "SetIamPolicy": { "timeout_millis": 10000, - "retry_codes_name": "non_idempotent", - "retry_params_name": "default", + "retry_codes_name": "no_retry_1_codes", + "retry_params_name": "no_retry_1_params", }, "TestIamPermissions": { "timeout_millis": 10000, - "retry_codes_name": "idempotent", - "retry_params_name": "default", + "retry_codes_name": "retry_policy_1_codes", + "retry_params_name": "retry_policy_1_params", }, "ListTasks": { "timeout_millis": 10000, - "retry_codes_name": "idempotent", - "retry_params_name": "default", + "retry_codes_name": "retry_policy_1_codes", + "retry_params_name": "retry_policy_1_params", }, "GetTask": { "timeout_millis": 10000, - "retry_codes_name": "idempotent", - "retry_params_name": "default", + "retry_codes_name": "retry_policy_1_codes", + "retry_params_name": "retry_policy_1_params", }, "CreateTask": { "timeout_millis": 10000, - "retry_codes_name": "non_idempotent", - "retry_params_name": "default", + "retry_codes_name": "no_retry_1_codes", + "retry_params_name": "no_retry_1_params", }, "DeleteTask": { "timeout_millis": 10000, - "retry_codes_name": "idempotent", - "retry_params_name": "default", + "retry_codes_name": "retry_policy_1_codes", + "retry_params_name": "retry_policy_1_params", }, "RunTask": { "timeout_millis": 10000, - "retry_codes_name": "non_idempotent", - "retry_params_name": "default", + "retry_codes_name": "no_retry_1_codes", + "retry_params_name": "no_retry_1_params", }, }, } diff --git a/google/cloud/tasks_v2/gapic/enums.py b/google/cloud/tasks_v2/gapic/enums.py index e35e3b71..60106a25 100644 --- a/google/cloud/tasks_v2/gapic/enums.py +++ b/google/cloud/tasks_v2/gapic/enums.py @@ -95,8 +95,8 @@ class View(enum.IntEnum): Attributes: VIEW_UNSPECIFIED (int): Unspecified. Defaults to BASIC. - BASIC (int): The basic view omits fields which can be large or can contain sensitive - data. + BASIC (int): The basic view omits fields which can be large or can contain + sensitive data. This view does not include the ``body in AppEngineHttpRequest``. Bodies are desirable to return only when needed, because they can be large and diff --git a/google/cloud/tasks_v2/gapic/transports/cloud_tasks_grpc_transport.py b/google/cloud/tasks_v2/gapic/transports/cloud_tasks_grpc_transport.py index 40209347..6a29a6d3 100644 --- a/google/cloud/tasks_v2/gapic/transports/cloud_tasks_grpc_transport.py +++ b/google/cloud/tasks_v2/gapic/transports/cloud_tasks_grpc_transport.py @@ -53,7 +53,7 @@ def __init__( # exception (channels come with credentials baked in already). if channel is not None and credentials is not None: raise ValueError( - "The `channel` and `credentials` arguments are mutually " "exclusive." + "The `channel` and `credentials` arguments are mutually " "exclusive.", ) # Create the channel. @@ -71,7 +71,9 @@ def __init__( # gRPC uses objects called "stubs" that are bound to the # channel and provide a basic method for each RPC. - self._stubs = {"cloud_tasks_stub": cloudtasks_pb2_grpc.CloudTasksStub(channel)} + self._stubs = { + "cloud_tasks_stub": cloudtasks_pb2_grpc.CloudTasksStub(channel), + } @classmethod def create_channel( @@ -267,8 +269,8 @@ def resume_queue(self): def get_iam_policy(self): """Return the gRPC stub for :meth:`CloudTasksClient.get_iam_policy`. - Gets the access control policy for a ``Queue``. Returns an empty policy - if the resource exists and does not have a policy set. + Gets the access control policy for a ``Queue``. Returns an empty + policy if the resource exists and does not have a policy set. Authorization requires the following `Google IAM `__ permission on the specified @@ -287,8 +289,8 @@ def get_iam_policy(self): def set_iam_policy(self): """Return the gRPC stub for :meth:`CloudTasksClient.set_iam_policy`. - Sets the access control policy for a ``Queue``. Replaces any existing - policy. + Sets the access control policy for a ``Queue``. Replaces any + existing policy. Note: The Cloud Console does not check queue-level IAM permissions yet. Project-level permissions are required to use the Cloud Console. @@ -310,9 +312,9 @@ def set_iam_policy(self): def test_iam_permissions(self): """Return the gRPC stub for :meth:`CloudTasksClient.test_iam_permissions`. - Returns permissions that a caller has on a ``Queue``. If the resource - does not exist, this will return an empty set of permissions, not a - ``NOT_FOUND`` error. + Returns permissions that a caller has on a ``Queue``. If the + resource does not exist, this will return an empty set of permissions, + not a ``NOT_FOUND`` error. Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization diff --git a/google/cloud/tasks_v2/proto/cloudtasks_pb2.py b/google/cloud/tasks_v2/proto/cloudtasks_pb2.py index 14243f13..5819e162 100644 --- a/google/cloud/tasks_v2/proto/cloudtasks_pb2.py +++ b/google/cloud/tasks_v2/proto/cloudtasks_pb2.py @@ -1,10 +1,7 @@ # -*- coding: utf-8 -*- # Generated by the protocol buffer compiler. DO NOT EDIT! # source: google/cloud/tasks_v2/proto/cloudtasks.proto - -import sys - -_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1")) +"""Generated protocol buffer code.""" from google.protobuf import descriptor as _descriptor from google.protobuf import message as _message from google.protobuf import reflection as _reflection @@ -35,12 +32,9 @@ name="google/cloud/tasks_v2/proto/cloudtasks.proto", package="google.cloud.tasks.v2", syntax="proto3", - serialized_options=_b( - "\n\031com.google.cloud.tasks.v2B\017CloudTasksProtoP\001Z:google.golang.org/genproto/googleapis/cloud/tasks/v2;tasks\242\002\005TASKS" - ), - serialized_pb=_b( - '\n,google/cloud/tasks_v2/proto/cloudtasks.proto\x12\x15google.cloud.tasks.v2\x1a\x1cgoogle/api/annotations.proto\x1a\x17google/api/client.proto\x1a\x1fgoogle/api/field_behavior.proto\x1a\x19google/api/resource.proto\x1a\'google/cloud/tasks_v2/proto/queue.proto\x1a&google/cloud/tasks_v2/proto/task.proto\x1a\x1egoogle/iam/v1/iam_policy.proto\x1a\x1agoogle/iam/v1/policy.proto\x1a\x1bgoogle/protobuf/empty.proto\x1a google/protobuf/field_mask.proto"\x83\x01\n\x11ListQueuesRequest\x12\x37\n\x06parent\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\x12\x1f\x63loudtasks.googleapis.com/Queue\x12\x0e\n\x06\x66ilter\x18\x02 \x01(\t\x12\x11\n\tpage_size\x18\x03 \x01(\x05\x12\x12\n\npage_token\x18\x04 \x01(\t"[\n\x12ListQueuesResponse\x12,\n\x06queues\x18\x01 \x03(\x0b\x32\x1c.google.cloud.tasks.v2.Queue\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"H\n\x0fGetQueueRequest\x12\x35\n\x04name\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\n\x1f\x63loudtasks.googleapis.com/Queue"\x7f\n\x12\x43reateQueueRequest\x12\x37\n\x06parent\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\x12\x1f\x63loudtasks.googleapis.com/Queue\x12\x30\n\x05queue\x18\x02 \x01(\x0b\x32\x1c.google.cloud.tasks.v2.QueueB\x03\xe0\x41\x02"w\n\x12UpdateQueueRequest\x12\x30\n\x05queue\x18\x01 \x01(\x0b\x32\x1c.google.cloud.tasks.v2.QueueB\x03\xe0\x41\x02\x12/\n\x0bupdate_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMask"K\n\x12\x44\x65leteQueueRequest\x12\x35\n\x04name\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\n\x1f\x63loudtasks.googleapis.com/Queue"J\n\x11PurgeQueueRequest\x12\x35\n\x04name\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\n\x1f\x63loudtasks.googleapis.com/Queue"J\n\x11PauseQueueRequest\x12\x35\n\x04name\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\n\x1f\x63loudtasks.googleapis.com/Queue"K\n\x12ResumeQueueRequest\x12\x35\n\x04name\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\n\x1f\x63loudtasks.googleapis.com/Queue"\xaa\x01\n\x10ListTasksRequest\x12\x36\n\x06parent\x18\x01 \x01(\tB&\xe0\x41\x02\xfa\x41 \x12\x1e\x63loudtasks.googleapis.com/Task\x12\x37\n\rresponse_view\x18\x02 \x01(\x0e\x32 .google.cloud.tasks.v2.Task.View\x12\x11\n\tpage_size\x18\x03 \x01(\x05\x12\x12\n\npage_token\x18\x04 \x01(\t"X\n\x11ListTasksResponse\x12*\n\x05tasks\x18\x01 \x03(\x0b\x32\x1b.google.cloud.tasks.v2.Task\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"\x7f\n\x0eGetTaskRequest\x12\x34\n\x04name\x18\x01 \x01(\tB&\xe0\x41\x02\xfa\x41 \n\x1e\x63loudtasks.googleapis.com/Task\x12\x37\n\rresponse_view\x18\x02 \x01(\x0e\x32 .google.cloud.tasks.v2.Task.View"\xb4\x01\n\x11\x43reateTaskRequest\x12\x36\n\x06parent\x18\x01 \x01(\tB&\xe0\x41\x02\xfa\x41 \x12\x1e\x63loudtasks.googleapis.com/Task\x12.\n\x04task\x18\x02 \x01(\x0b\x32\x1b.google.cloud.tasks.v2.TaskB\x03\xe0\x41\x02\x12\x37\n\rresponse_view\x18\x03 \x01(\x0e\x32 .google.cloud.tasks.v2.Task.View"I\n\x11\x44\x65leteTaskRequest\x12\x34\n\x04name\x18\x01 \x01(\tB&\xe0\x41\x02\xfa\x41 \n\x1e\x63loudtasks.googleapis.com/Task"\x7f\n\x0eRunTaskRequest\x12\x34\n\x04name\x18\x01 \x01(\tB&\xe0\x41\x02\xfa\x41 \n\x1e\x63loudtasks.googleapis.com/Task\x12\x37\n\rresponse_view\x18\x02 \x01(\x0e\x32 .google.cloud.tasks.v2.Task.View2\xdd\x14\n\nCloudTasks\x12\x9e\x01\n\nListQueues\x12(.google.cloud.tasks.v2.ListQueuesRequest\x1a).google.cloud.tasks.v2.ListQueuesResponse";\x82\xd3\xe4\x93\x02,\x12*/v2/{parent=projects/*/locations/*}/queues\xda\x41\x06parent\x12\x8b\x01\n\x08GetQueue\x12&.google.cloud.tasks.v2.GetQueueRequest\x1a\x1c.google.cloud.tasks.v2.Queue"9\x82\xd3\xe4\x93\x02,\x12*/v2/{name=projects/*/locations/*/queues/*}\xda\x41\x04name\x12\xa0\x01\n\x0b\x43reateQueue\x12).google.cloud.tasks.v2.CreateQueueRequest\x1a\x1c.google.cloud.tasks.v2.Queue"H\x82\xd3\xe4\x93\x02\x33"*/v2/{parent=projects/*/locations/*}/queues:\x05queue\xda\x41\x0cparent,queue\x12\xab\x01\n\x0bUpdateQueue\x12).google.cloud.tasks.v2.UpdateQueueRequest\x1a\x1c.google.cloud.tasks.v2.Queue"S\x82\xd3\xe4\x93\x02\x39\x32\x30/v2/{queue.name=projects/*/locations/*/queues/*}:\x05queue\xda\x41\x11queue,update_mask\x12\x8b\x01\n\x0b\x44\x65leteQueue\x12).google.cloud.tasks.v2.DeleteQueueRequest\x1a\x16.google.protobuf.Empty"9\x82\xd3\xe4\x93\x02,**/v2/{name=projects/*/locations/*/queues/*}\xda\x41\x04name\x12\x98\x01\n\nPurgeQueue\x12(.google.cloud.tasks.v2.PurgeQueueRequest\x1a\x1c.google.cloud.tasks.v2.Queue"B\x82\xd3\xe4\x93\x02\x35"0/v2/{name=projects/*/locations/*/queues/*}:purge:\x01*\xda\x41\x04name\x12\x98\x01\n\nPauseQueue\x12(.google.cloud.tasks.v2.PauseQueueRequest\x1a\x1c.google.cloud.tasks.v2.Queue"B\x82\xd3\xe4\x93\x02\x35"0/v2/{name=projects/*/locations/*/queues/*}:pause:\x01*\xda\x41\x04name\x12\x9b\x01\n\x0bResumeQueue\x12).google.cloud.tasks.v2.ResumeQueueRequest\x1a\x1c.google.cloud.tasks.v2.Queue"C\x82\xd3\xe4\x93\x02\x36"1/v2/{name=projects/*/locations/*/queues/*}:resume:\x01*\xda\x41\x04name\x12\x9c\x01\n\x0cGetIamPolicy\x12".google.iam.v1.GetIamPolicyRequest\x1a\x15.google.iam.v1.Policy"Q\x82\xd3\xe4\x93\x02@";/v2/{resource=projects/*/locations/*/queues/*}:getIamPolicy:\x01*\xda\x41\x08resource\x12\xa3\x01\n\x0cSetIamPolicy\x12".google.iam.v1.SetIamPolicyRequest\x1a\x15.google.iam.v1.Policy"X\x82\xd3\xe4\x93\x02@";/v2/{resource=projects/*/locations/*/queues/*}:setIamPolicy:\x01*\xda\x41\x0fresource,policy\x12\xce\x01\n\x12TestIamPermissions\x12(.google.iam.v1.TestIamPermissionsRequest\x1a).google.iam.v1.TestIamPermissionsResponse"c\x82\xd3\xe4\x93\x02\x46"A/v2/{resource=projects/*/locations/*/queues/*}:testIamPermissions:\x01*\xda\x41\x14resource,permissions\x12\xa3\x01\n\tListTasks\x12\'.google.cloud.tasks.v2.ListTasksRequest\x1a(.google.cloud.tasks.v2.ListTasksResponse"C\x82\xd3\xe4\x93\x02\x34\x12\x32/v2/{parent=projects/*/locations/*/queues/*}/tasks\xda\x41\x06parent\x12\x90\x01\n\x07GetTask\x12%.google.cloud.tasks.v2.GetTaskRequest\x1a\x1b.google.cloud.tasks.v2.Task"A\x82\xd3\xe4\x93\x02\x34\x12\x32/v2/{name=projects/*/locations/*/queues/*/tasks/*}\xda\x41\x04name\x12\xa0\x01\n\nCreateTask\x12(.google.cloud.tasks.v2.CreateTaskRequest\x1a\x1b.google.cloud.tasks.v2.Task"K\x82\xd3\xe4\x93\x02\x37"2/v2/{parent=projects/*/locations/*/queues/*}/tasks:\x01*\xda\x41\x0bparent,task\x12\x91\x01\n\nDeleteTask\x12(.google.cloud.tasks.v2.DeleteTaskRequest\x1a\x16.google.protobuf.Empty"A\x82\xd3\xe4\x93\x02\x34*2/v2/{name=projects/*/locations/*/queues/*/tasks/*}\xda\x41\x04name\x12\x97\x01\n\x07RunTask\x12%.google.cloud.tasks.v2.RunTaskRequest\x1a\x1b.google.cloud.tasks.v2.Task"H\x82\xd3\xe4\x93\x02;"6/v2/{name=projects/*/locations/*/queues/*/tasks/*}:run:\x01*\xda\x41\x04name\x1aM\xca\x41\x19\x63loudtasks.googleapis.com\xd2\x41.https://www.googleapis.com/auth/cloud-platformBr\n\x19\x63om.google.cloud.tasks.v2B\x0f\x43loudTasksProtoP\x01Z:google.golang.org/genproto/googleapis/cloud/tasks/v2;tasks\xa2\x02\x05TASKSb\x06proto3' - ), + serialized_options=b"\n\031com.google.cloud.tasks.v2B\017CloudTasksProtoP\001Z:google.golang.org/genproto/googleapis/cloud/tasks/v2;tasks\242\002\005TASKS", + create_key=_descriptor._internal_create_key, + serialized_pb=b'\n,google/cloud/tasks_v2/proto/cloudtasks.proto\x12\x15google.cloud.tasks.v2\x1a\x1cgoogle/api/annotations.proto\x1a\x17google/api/client.proto\x1a\x1fgoogle/api/field_behavior.proto\x1a\x19google/api/resource.proto\x1a\'google/cloud/tasks_v2/proto/queue.proto\x1a&google/cloud/tasks_v2/proto/task.proto\x1a\x1egoogle/iam/v1/iam_policy.proto\x1a\x1agoogle/iam/v1/policy.proto\x1a\x1bgoogle/protobuf/empty.proto\x1a google/protobuf/field_mask.proto"\x83\x01\n\x11ListQueuesRequest\x12\x37\n\x06parent\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\x12\x1f\x63loudtasks.googleapis.com/Queue\x12\x0e\n\x06\x66ilter\x18\x02 \x01(\t\x12\x11\n\tpage_size\x18\x03 \x01(\x05\x12\x12\n\npage_token\x18\x04 \x01(\t"[\n\x12ListQueuesResponse\x12,\n\x06queues\x18\x01 \x03(\x0b\x32\x1c.google.cloud.tasks.v2.Queue\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"H\n\x0fGetQueueRequest\x12\x35\n\x04name\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\n\x1f\x63loudtasks.googleapis.com/Queue"\x7f\n\x12\x43reateQueueRequest\x12\x37\n\x06parent\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\x12\x1f\x63loudtasks.googleapis.com/Queue\x12\x30\n\x05queue\x18\x02 \x01(\x0b\x32\x1c.google.cloud.tasks.v2.QueueB\x03\xe0\x41\x02"w\n\x12UpdateQueueRequest\x12\x30\n\x05queue\x18\x01 \x01(\x0b\x32\x1c.google.cloud.tasks.v2.QueueB\x03\xe0\x41\x02\x12/\n\x0bupdate_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMask"K\n\x12\x44\x65leteQueueRequest\x12\x35\n\x04name\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\n\x1f\x63loudtasks.googleapis.com/Queue"J\n\x11PurgeQueueRequest\x12\x35\n\x04name\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\n\x1f\x63loudtasks.googleapis.com/Queue"J\n\x11PauseQueueRequest\x12\x35\n\x04name\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\n\x1f\x63loudtasks.googleapis.com/Queue"K\n\x12ResumeQueueRequest\x12\x35\n\x04name\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\n\x1f\x63loudtasks.googleapis.com/Queue"\xaa\x01\n\x10ListTasksRequest\x12\x36\n\x06parent\x18\x01 \x01(\tB&\xe0\x41\x02\xfa\x41 \x12\x1e\x63loudtasks.googleapis.com/Task\x12\x37\n\rresponse_view\x18\x02 \x01(\x0e\x32 .google.cloud.tasks.v2.Task.View\x12\x11\n\tpage_size\x18\x03 \x01(\x05\x12\x12\n\npage_token\x18\x04 \x01(\t"X\n\x11ListTasksResponse\x12*\n\x05tasks\x18\x01 \x03(\x0b\x32\x1b.google.cloud.tasks.v2.Task\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"\x7f\n\x0eGetTaskRequest\x12\x34\n\x04name\x18\x01 \x01(\tB&\xe0\x41\x02\xfa\x41 \n\x1e\x63loudtasks.googleapis.com/Task\x12\x37\n\rresponse_view\x18\x02 \x01(\x0e\x32 .google.cloud.tasks.v2.Task.View"\xb4\x01\n\x11\x43reateTaskRequest\x12\x36\n\x06parent\x18\x01 \x01(\tB&\xe0\x41\x02\xfa\x41 \x12\x1e\x63loudtasks.googleapis.com/Task\x12.\n\x04task\x18\x02 \x01(\x0b\x32\x1b.google.cloud.tasks.v2.TaskB\x03\xe0\x41\x02\x12\x37\n\rresponse_view\x18\x03 \x01(\x0e\x32 .google.cloud.tasks.v2.Task.View"I\n\x11\x44\x65leteTaskRequest\x12\x34\n\x04name\x18\x01 \x01(\tB&\xe0\x41\x02\xfa\x41 \n\x1e\x63loudtasks.googleapis.com/Task"\x7f\n\x0eRunTaskRequest\x12\x34\n\x04name\x18\x01 \x01(\tB&\xe0\x41\x02\xfa\x41 \n\x1e\x63loudtasks.googleapis.com/Task\x12\x37\n\rresponse_view\x18\x02 \x01(\x0e\x32 .google.cloud.tasks.v2.Task.View2\xdd\x14\n\nCloudTasks\x12\x9e\x01\n\nListQueues\x12(.google.cloud.tasks.v2.ListQueuesRequest\x1a).google.cloud.tasks.v2.ListQueuesResponse";\x82\xd3\xe4\x93\x02,\x12*/v2/{parent=projects/*/locations/*}/queues\xda\x41\x06parent\x12\x8b\x01\n\x08GetQueue\x12&.google.cloud.tasks.v2.GetQueueRequest\x1a\x1c.google.cloud.tasks.v2.Queue"9\x82\xd3\xe4\x93\x02,\x12*/v2/{name=projects/*/locations/*/queues/*}\xda\x41\x04name\x12\xa0\x01\n\x0b\x43reateQueue\x12).google.cloud.tasks.v2.CreateQueueRequest\x1a\x1c.google.cloud.tasks.v2.Queue"H\x82\xd3\xe4\x93\x02\x33"*/v2/{parent=projects/*/locations/*}/queues:\x05queue\xda\x41\x0cparent,queue\x12\xab\x01\n\x0bUpdateQueue\x12).google.cloud.tasks.v2.UpdateQueueRequest\x1a\x1c.google.cloud.tasks.v2.Queue"S\x82\xd3\xe4\x93\x02\x39\x32\x30/v2/{queue.name=projects/*/locations/*/queues/*}:\x05queue\xda\x41\x11queue,update_mask\x12\x8b\x01\n\x0b\x44\x65leteQueue\x12).google.cloud.tasks.v2.DeleteQueueRequest\x1a\x16.google.protobuf.Empty"9\x82\xd3\xe4\x93\x02,**/v2/{name=projects/*/locations/*/queues/*}\xda\x41\x04name\x12\x98\x01\n\nPurgeQueue\x12(.google.cloud.tasks.v2.PurgeQueueRequest\x1a\x1c.google.cloud.tasks.v2.Queue"B\x82\xd3\xe4\x93\x02\x35"0/v2/{name=projects/*/locations/*/queues/*}:purge:\x01*\xda\x41\x04name\x12\x98\x01\n\nPauseQueue\x12(.google.cloud.tasks.v2.PauseQueueRequest\x1a\x1c.google.cloud.tasks.v2.Queue"B\x82\xd3\xe4\x93\x02\x35"0/v2/{name=projects/*/locations/*/queues/*}:pause:\x01*\xda\x41\x04name\x12\x9b\x01\n\x0bResumeQueue\x12).google.cloud.tasks.v2.ResumeQueueRequest\x1a\x1c.google.cloud.tasks.v2.Queue"C\x82\xd3\xe4\x93\x02\x36"1/v2/{name=projects/*/locations/*/queues/*}:resume:\x01*\xda\x41\x04name\x12\x9c\x01\n\x0cGetIamPolicy\x12".google.iam.v1.GetIamPolicyRequest\x1a\x15.google.iam.v1.Policy"Q\x82\xd3\xe4\x93\x02@";/v2/{resource=projects/*/locations/*/queues/*}:getIamPolicy:\x01*\xda\x41\x08resource\x12\xa3\x01\n\x0cSetIamPolicy\x12".google.iam.v1.SetIamPolicyRequest\x1a\x15.google.iam.v1.Policy"X\x82\xd3\xe4\x93\x02@";/v2/{resource=projects/*/locations/*/queues/*}:setIamPolicy:\x01*\xda\x41\x0fresource,policy\x12\xce\x01\n\x12TestIamPermissions\x12(.google.iam.v1.TestIamPermissionsRequest\x1a).google.iam.v1.TestIamPermissionsResponse"c\x82\xd3\xe4\x93\x02\x46"A/v2/{resource=projects/*/locations/*/queues/*}:testIamPermissions:\x01*\xda\x41\x14resource,permissions\x12\xa3\x01\n\tListTasks\x12\'.google.cloud.tasks.v2.ListTasksRequest\x1a(.google.cloud.tasks.v2.ListTasksResponse"C\x82\xd3\xe4\x93\x02\x34\x12\x32/v2/{parent=projects/*/locations/*/queues/*}/tasks\xda\x41\x06parent\x12\x90\x01\n\x07GetTask\x12%.google.cloud.tasks.v2.GetTaskRequest\x1a\x1b.google.cloud.tasks.v2.Task"A\x82\xd3\xe4\x93\x02\x34\x12\x32/v2/{name=projects/*/locations/*/queues/*/tasks/*}\xda\x41\x04name\x12\xa0\x01\n\nCreateTask\x12(.google.cloud.tasks.v2.CreateTaskRequest\x1a\x1b.google.cloud.tasks.v2.Task"K\x82\xd3\xe4\x93\x02\x37"2/v2/{parent=projects/*/locations/*/queues/*}/tasks:\x01*\xda\x41\x0bparent,task\x12\x91\x01\n\nDeleteTask\x12(.google.cloud.tasks.v2.DeleteTaskRequest\x1a\x16.google.protobuf.Empty"A\x82\xd3\xe4\x93\x02\x34*2/v2/{name=projects/*/locations/*/queues/*/tasks/*}\xda\x41\x04name\x12\x97\x01\n\x07RunTask\x12%.google.cloud.tasks.v2.RunTaskRequest\x1a\x1b.google.cloud.tasks.v2.Task"H\x82\xd3\xe4\x93\x02;"6/v2/{name=projects/*/locations/*/queues/*/tasks/*}:run:\x01*\xda\x41\x04name\x1aM\xca\x41\x19\x63loudtasks.googleapis.com\xd2\x41.https://www.googleapis.com/auth/cloud-platformBr\n\x19\x63om.google.cloud.tasks.v2B\x0f\x43loudTasksProtoP\x01Z:google.golang.org/genproto/googleapis/cloud/tasks/v2;tasks\xa2\x02\x05TASKSb\x06proto3', dependencies=[ google_dot_api_dot_annotations__pb2.DESCRIPTOR, google_dot_api_dot_client__pb2.DESCRIPTOR, @@ -62,6 +56,7 @@ filename=None, file=DESCRIPTOR, containing_type=None, + create_key=_descriptor._internal_create_key, fields=[ _descriptor.FieldDescriptor( name="parent", @@ -72,16 +67,15 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b( - "\340A\002\372A!\022\037cloudtasks.googleapis.com/Queue" - ), + serialized_options=b"\340A\002\372A!\022\037cloudtasks.googleapis.com/Queue", file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="filter", @@ -92,7 +86,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -100,6 +94,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="page_size", @@ -118,6 +113,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="page_token", @@ -128,7 +124,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -136,6 +132,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), ], extensions=[], @@ -157,6 +154,7 @@ filename=None, file=DESCRIPTOR, containing_type=None, + create_key=_descriptor._internal_create_key, fields=[ _descriptor.FieldDescriptor( name="queues", @@ -175,6 +173,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="next_page_token", @@ -185,7 +184,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -193,6 +192,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), ], extensions=[], @@ -214,6 +214,7 @@ filename=None, file=DESCRIPTOR, containing_type=None, + create_key=_descriptor._internal_create_key, fields=[ _descriptor.FieldDescriptor( name="name", @@ -224,17 +225,16 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b( - "\340A\002\372A!\n\037cloudtasks.googleapis.com/Queue" - ), + serialized_options=b"\340A\002\372A!\n\037cloudtasks.googleapis.com/Queue", file=DESCRIPTOR, - ) + create_key=_descriptor._internal_create_key, + ), ], extensions=[], nested_types=[], @@ -255,6 +255,7 @@ filename=None, file=DESCRIPTOR, containing_type=None, + create_key=_descriptor._internal_create_key, fields=[ _descriptor.FieldDescriptor( name="parent", @@ -265,16 +266,15 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b( - "\340A\002\372A!\022\037cloudtasks.googleapis.com/Queue" - ), + serialized_options=b"\340A\002\372A!\022\037cloudtasks.googleapis.com/Queue", file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="queue", @@ -291,8 +291,9 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b("\340A\002"), + serialized_options=b"\340A\002", file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), ], extensions=[], @@ -314,6 +315,7 @@ filename=None, file=DESCRIPTOR, containing_type=None, + create_key=_descriptor._internal_create_key, fields=[ _descriptor.FieldDescriptor( name="queue", @@ -330,8 +332,9 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b("\340A\002"), + serialized_options=b"\340A\002", file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="update_mask", @@ -350,6 +353,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), ], extensions=[], @@ -371,6 +375,7 @@ filename=None, file=DESCRIPTOR, containing_type=None, + create_key=_descriptor._internal_create_key, fields=[ _descriptor.FieldDescriptor( name="name", @@ -381,17 +386,16 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b( - "\340A\002\372A!\n\037cloudtasks.googleapis.com/Queue" - ), + serialized_options=b"\340A\002\372A!\n\037cloudtasks.googleapis.com/Queue", file=DESCRIPTOR, - ) + create_key=_descriptor._internal_create_key, + ), ], extensions=[], nested_types=[], @@ -412,6 +416,7 @@ filename=None, file=DESCRIPTOR, containing_type=None, + create_key=_descriptor._internal_create_key, fields=[ _descriptor.FieldDescriptor( name="name", @@ -422,17 +427,16 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b( - "\340A\002\372A!\n\037cloudtasks.googleapis.com/Queue" - ), + serialized_options=b"\340A\002\372A!\n\037cloudtasks.googleapis.com/Queue", file=DESCRIPTOR, - ) + create_key=_descriptor._internal_create_key, + ), ], extensions=[], nested_types=[], @@ -453,6 +457,7 @@ filename=None, file=DESCRIPTOR, containing_type=None, + create_key=_descriptor._internal_create_key, fields=[ _descriptor.FieldDescriptor( name="name", @@ -463,17 +468,16 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b( - "\340A\002\372A!\n\037cloudtasks.googleapis.com/Queue" - ), + serialized_options=b"\340A\002\372A!\n\037cloudtasks.googleapis.com/Queue", file=DESCRIPTOR, - ) + create_key=_descriptor._internal_create_key, + ), ], extensions=[], nested_types=[], @@ -494,6 +498,7 @@ filename=None, file=DESCRIPTOR, containing_type=None, + create_key=_descriptor._internal_create_key, fields=[ _descriptor.FieldDescriptor( name="name", @@ -504,17 +509,16 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b( - "\340A\002\372A!\n\037cloudtasks.googleapis.com/Queue" - ), + serialized_options=b"\340A\002\372A!\n\037cloudtasks.googleapis.com/Queue", file=DESCRIPTOR, - ) + create_key=_descriptor._internal_create_key, + ), ], extensions=[], nested_types=[], @@ -535,6 +539,7 @@ filename=None, file=DESCRIPTOR, containing_type=None, + create_key=_descriptor._internal_create_key, fields=[ _descriptor.FieldDescriptor( name="parent", @@ -545,16 +550,15 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b( - "\340A\002\372A \022\036cloudtasks.googleapis.com/Task" - ), + serialized_options=b"\340A\002\372A \022\036cloudtasks.googleapis.com/Task", file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="response_view", @@ -573,6 +577,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="page_size", @@ -591,6 +596,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="page_token", @@ -601,7 +607,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -609,6 +615,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), ], extensions=[], @@ -630,6 +637,7 @@ filename=None, file=DESCRIPTOR, containing_type=None, + create_key=_descriptor._internal_create_key, fields=[ _descriptor.FieldDescriptor( name="tasks", @@ -648,6 +656,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="next_page_token", @@ -658,7 +667,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -666,6 +675,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), ], extensions=[], @@ -687,6 +697,7 @@ filename=None, file=DESCRIPTOR, containing_type=None, + create_key=_descriptor._internal_create_key, fields=[ _descriptor.FieldDescriptor( name="name", @@ -697,16 +708,15 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b( - "\340A\002\372A \n\036cloudtasks.googleapis.com/Task" - ), + serialized_options=b"\340A\002\372A \n\036cloudtasks.googleapis.com/Task", file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="response_view", @@ -725,6 +735,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), ], extensions=[], @@ -746,6 +757,7 @@ filename=None, file=DESCRIPTOR, containing_type=None, + create_key=_descriptor._internal_create_key, fields=[ _descriptor.FieldDescriptor( name="parent", @@ -756,16 +768,15 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b( - "\340A\002\372A \022\036cloudtasks.googleapis.com/Task" - ), + serialized_options=b"\340A\002\372A \022\036cloudtasks.googleapis.com/Task", file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="task", @@ -782,8 +793,9 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b("\340A\002"), + serialized_options=b"\340A\002", file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="response_view", @@ -802,6 +814,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), ], extensions=[], @@ -823,6 +836,7 @@ filename=None, file=DESCRIPTOR, containing_type=None, + create_key=_descriptor._internal_create_key, fields=[ _descriptor.FieldDescriptor( name="name", @@ -833,17 +847,16 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b( - "\340A\002\372A \n\036cloudtasks.googleapis.com/Task" - ), + serialized_options=b"\340A\002\372A \n\036cloudtasks.googleapis.com/Task", file=DESCRIPTOR, - ) + create_key=_descriptor._internal_create_key, + ), ], extensions=[], nested_types=[], @@ -864,6 +877,7 @@ filename=None, file=DESCRIPTOR, containing_type=None, + create_key=_descriptor._internal_create_key, fields=[ _descriptor.FieldDescriptor( name="name", @@ -874,16 +888,15 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b( - "\340A\002\372A \n\036cloudtasks.googleapis.com/Task" - ), + serialized_options=b"\340A\002\372A \n\036cloudtasks.googleapis.com/Task", file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="response_view", @@ -902,6 +915,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), ], extensions=[], @@ -966,11 +980,12 @@ ListQueuesRequest = _reflection.GeneratedProtocolMessageType( "ListQueuesRequest", (_message.Message,), - dict( - DESCRIPTOR=_LISTQUEUESREQUEST, - __module__="google.cloud.tasks_v2.proto.cloudtasks_pb2", - __doc__="""Request message for + { + "DESCRIPTOR": _LISTQUEUESREQUEST, + "__module__": "google.cloud.tasks_v2.proto.cloudtasks_pb2", + "__doc__": """Request message for [ListQueues][google.cloud.tasks.v2.CloudTasks.ListQueues]. + Attributes: parent: Required. The location name. For example: @@ -980,41 +995,42 @@ [Queue][google.cloud.tasks.v2.Queue] field can be used as a filter and several operators as supported. For example: ``<=, <, >=, >, !=, =, :``. The filter syntax is the same as - described in `Stackdriver's Advanced Logs Filters `_. Sample - filter "state: PAUSED". Note that using filters might cause - fewer queues than the requested page\_size to be returned. + filter “state: PAUSED”. Note that using filters might cause + fewer queues than the requested page_size to be returned. page_size: Requested page size. The maximum page size is 9800. If unspecified, the page size will be the maximum. Fewer queues than requested might be returned, even if more queues exist; - use the [next\_page\_token][google.cloud.tasks.v2.ListQueuesRe - sponse.next\_page\_token] in the response to determine if more + use the [next_page_token][google.cloud.tasks.v2.ListQueuesResp + onse.next_page_token] in the response to determine if more queues exist. page_token: A token identifying the page of results to return. To request - the first page results, page\_token must be empty. To request - the next page of results, page\_token must be the value of [ne - xt\_page\_token][google.cloud.tasks.v2.ListQueuesResponse.next - \_page\_token] returned from the previous call to + the first page results, page_token must be empty. To request + the next page of results, page_token must be the value of [nex + t_page_token][google.cloud.tasks.v2.ListQueuesResponse.next_pa + ge_token] returned from the previous call to [ListQueues][google.cloud.tasks.v2.CloudTasks.ListQueues] method. It is an error to switch the value of the [filter][google.cloud.tasks.v2.ListQueuesRequest.filter] while iterating through pages. """, # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2.ListQueuesRequest) - ), + }, ) _sym_db.RegisterMessage(ListQueuesRequest) ListQueuesResponse = _reflection.GeneratedProtocolMessageType( "ListQueuesResponse", (_message.Message,), - dict( - DESCRIPTOR=_LISTQUEUESRESPONSE, - __module__="google.cloud.tasks_v2.proto.cloudtasks_pb2", - __doc__="""Response message for + { + "DESCRIPTOR": _LISTQUEUESRESPONSE, + "__module__": "google.cloud.tasks_v2.proto.cloudtasks_pb2", + "__doc__": """Response message for [ListQueues][google.cloud.tasks.v2.CloudTasks.ListQueues]. + Attributes: queues: The list of queues. @@ -1022,173 +1038,181 @@ A token to retrieve next page of results. To return the next page of results, call [ListQueues][google.cloud.tasks.v2.CloudTasks.ListQueues] with - this value as the [page\_token][google.cloud.tasks.v2.ListQueu - esRequest.page\_token]. If the next\_page\_token is empty, - there are no more results. The page token is valid for only 2 + this value as the [page_token][google.cloud.tasks.v2.ListQueue + sRequest.page_token]. If the next_page_token is empty, there + are no more results. The page token is valid for only 2 hours. """, # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2.ListQueuesResponse) - ), + }, ) _sym_db.RegisterMessage(ListQueuesResponse) GetQueueRequest = _reflection.GeneratedProtocolMessageType( "GetQueueRequest", (_message.Message,), - dict( - DESCRIPTOR=_GETQUEUEREQUEST, - __module__="google.cloud.tasks_v2.proto.cloudtasks_pb2", - __doc__="""Request message for + { + "DESCRIPTOR": _GETQUEUEREQUEST, + "__module__": "google.cloud.tasks_v2.proto.cloudtasks_pb2", + "__doc__": """Request message for [GetQueue][google.cloud.tasks.v2.CloudTasks.GetQueue]. + Attributes: name: Required. The resource name of the queue. For example: ``projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`` """, # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2.GetQueueRequest) - ), + }, ) _sym_db.RegisterMessage(GetQueueRequest) CreateQueueRequest = _reflection.GeneratedProtocolMessageType( "CreateQueueRequest", (_message.Message,), - dict( - DESCRIPTOR=_CREATEQUEUEREQUEST, - __module__="google.cloud.tasks_v2.proto.cloudtasks_pb2", - __doc__="""Request message for + { + "DESCRIPTOR": _CREATEQUEUEREQUEST, + "__module__": "google.cloud.tasks_v2.proto.cloudtasks_pb2", + "__doc__": """Request message for [CreateQueue][google.cloud.tasks.v2.CloudTasks.CreateQueue]. + Attributes: parent: Required. The location name in which the queue will be created. For example: ``projects/PROJECT_ID/locations/LOCATION_ID`` The list of - allowed locations can be obtained by calling Cloud Tasks' + allowed locations can be obtained by calling Cloud Tasks’ implementation of [ListLocations][google.cloud.location.Locati ons.ListLocations]. queue: - Required. The queue to create. [Queue's + Required. The queue to create. [Queue’s name][google.cloud.tasks.v2.Queue.name] cannot be the same as an existing queue. """, # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2.CreateQueueRequest) - ), + }, ) _sym_db.RegisterMessage(CreateQueueRequest) UpdateQueueRequest = _reflection.GeneratedProtocolMessageType( "UpdateQueueRequest", (_message.Message,), - dict( - DESCRIPTOR=_UPDATEQUEUEREQUEST, - __module__="google.cloud.tasks_v2.proto.cloudtasks_pb2", - __doc__="""Request message for + { + "DESCRIPTOR": _UPDATEQUEUEREQUEST, + "__module__": "google.cloud.tasks_v2.proto.cloudtasks_pb2", + "__doc__": """Request message for [UpdateQueue][google.cloud.tasks.v2.CloudTasks.UpdateQueue]. + Attributes: queue: - Required. The queue to create or update. The queue's + Required. The queue to create or update. The queue’s [name][google.cloud.tasks.v2.Queue.name] must be specified. Output only fields cannot be modified using UpdateQueue. Any value specified for an output only field will be ignored. The - queue's [name][google.cloud.tasks.v2.Queue.name] cannot be + queue’s [name][google.cloud.tasks.v2.Queue.name] cannot be changed. update_mask: A mask used to specify which fields of the queue are being updated. If empty, then all fields will be updated. """, # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2.UpdateQueueRequest) - ), + }, ) _sym_db.RegisterMessage(UpdateQueueRequest) DeleteQueueRequest = _reflection.GeneratedProtocolMessageType( "DeleteQueueRequest", (_message.Message,), - dict( - DESCRIPTOR=_DELETEQUEUEREQUEST, - __module__="google.cloud.tasks_v2.proto.cloudtasks_pb2", - __doc__="""Request message for + { + "DESCRIPTOR": _DELETEQUEUEREQUEST, + "__module__": "google.cloud.tasks_v2.proto.cloudtasks_pb2", + "__doc__": """Request message for [DeleteQueue][google.cloud.tasks.v2.CloudTasks.DeleteQueue]. + Attributes: name: Required. The queue name. For example: ``projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`` """, # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2.DeleteQueueRequest) - ), + }, ) _sym_db.RegisterMessage(DeleteQueueRequest) PurgeQueueRequest = _reflection.GeneratedProtocolMessageType( "PurgeQueueRequest", (_message.Message,), - dict( - DESCRIPTOR=_PURGEQUEUEREQUEST, - __module__="google.cloud.tasks_v2.proto.cloudtasks_pb2", - __doc__="""Request message for + { + "DESCRIPTOR": _PURGEQUEUEREQUEST, + "__module__": "google.cloud.tasks_v2.proto.cloudtasks_pb2", + "__doc__": """Request message for [PurgeQueue][google.cloud.tasks.v2.CloudTasks.PurgeQueue]. + Attributes: name: Required. The queue name. For example: ``projects/PROJECT_ID/location/LOCATION_ID/queues/QUEUE_ID`` """, # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2.PurgeQueueRequest) - ), + }, ) _sym_db.RegisterMessage(PurgeQueueRequest) PauseQueueRequest = _reflection.GeneratedProtocolMessageType( "PauseQueueRequest", (_message.Message,), - dict( - DESCRIPTOR=_PAUSEQUEUEREQUEST, - __module__="google.cloud.tasks_v2.proto.cloudtasks_pb2", - __doc__="""Request message for + { + "DESCRIPTOR": _PAUSEQUEUEREQUEST, + "__module__": "google.cloud.tasks_v2.proto.cloudtasks_pb2", + "__doc__": """Request message for [PauseQueue][google.cloud.tasks.v2.CloudTasks.PauseQueue]. + Attributes: name: Required. The queue name. For example: ``projects/PROJECT_ID/location/LOCATION_ID/queues/QUEUE_ID`` """, # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2.PauseQueueRequest) - ), + }, ) _sym_db.RegisterMessage(PauseQueueRequest) ResumeQueueRequest = _reflection.GeneratedProtocolMessageType( "ResumeQueueRequest", (_message.Message,), - dict( - DESCRIPTOR=_RESUMEQUEUEREQUEST, - __module__="google.cloud.tasks_v2.proto.cloudtasks_pb2", - __doc__="""Request message for + { + "DESCRIPTOR": _RESUMEQUEUEREQUEST, + "__module__": "google.cloud.tasks_v2.proto.cloudtasks_pb2", + "__doc__": """Request message for [ResumeQueue][google.cloud.tasks.v2.CloudTasks.ResumeQueue]. + Attributes: name: Required. The queue name. For example: ``projects/PROJECT_ID/location/LOCATION_ID/queues/QUEUE_ID`` """, # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2.ResumeQueueRequest) - ), + }, ) _sym_db.RegisterMessage(ResumeQueueRequest) ListTasksRequest = _reflection.GeneratedProtocolMessageType( "ListTasksRequest", (_message.Message,), - dict( - DESCRIPTOR=_LISTTASKSREQUEST, - __module__="google.cloud.tasks_v2.proto.cloudtasks_pb2", - __doc__="""Request message for listing tasks using + { + "DESCRIPTOR": _LISTTASKSREQUEST, + "__module__": "google.cloud.tasks_v2.proto.cloudtasks_pb2", + "__doc__": """Request message for listing tasks using [ListTasks][google.cloud.tasks.v2.CloudTasks.ListTasks]. + Attributes: parent: Required. The queue name. For example: ``projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`` response_view: - The response\_view specifies which subset of the + The response_view specifies which subset of the [Task][google.cloud.tasks.v2.Task] will be returned. By - default response\_view is + default response_view is [BASIC][google.cloud.tasks.v2.Task.View.BASIC]; not all information is retrieved by default because some data, such as payloads, might be desirable to return only when needed @@ -1200,33 +1224,34 @@ [Task][google.cloud.tasks.v2.Task] resource. page_size: Maximum page size. Fewer tasks than requested might be - returned, even if more tasks exist; use [next\_page\_token][go - ogle.cloud.tasks.v2.ListTasksResponse.next\_page\_token] in - the response to determine if more tasks exist. The maximum - page size is 1000. If unspecified, the page size will be the + returned, even if more tasks exist; use [next_page_token][goog + le.cloud.tasks.v2.ListTasksResponse.next_page_token] in the + response to determine if more tasks exist. The maximum page + size is 1000. If unspecified, the page size will be the maximum. page_token: A token identifying the page of results to return. To request - the first page results, page\_token must be empty. To request - the next page of results, page\_token must be the value of [ne - xt\_page\_token][google.cloud.tasks.v2.ListTasksResponse.next\ - _page\_token] returned from the previous call to + the first page results, page_token must be empty. To request + the next page of results, page_token must be the value of [nex + t_page_token][google.cloud.tasks.v2.ListTasksResponse.next_pag + e_token] returned from the previous call to [ListTasks][google.cloud.tasks.v2.CloudTasks.ListTasks] method. The page token is valid for only 2 hours. """, # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2.ListTasksRequest) - ), + }, ) _sym_db.RegisterMessage(ListTasksRequest) ListTasksResponse = _reflection.GeneratedProtocolMessageType( "ListTasksResponse", (_message.Message,), - dict( - DESCRIPTOR=_LISTTASKSRESPONSE, - __module__="google.cloud.tasks_v2.proto.cloudtasks_pb2", - __doc__="""Response message for listing tasks using + { + "DESCRIPTOR": _LISTTASKSRESPONSE, + "__module__": "google.cloud.tasks_v2.proto.cloudtasks_pb2", + "__doc__": """Response message for listing tasks using [ListTasks][google.cloud.tasks.v2.CloudTasks.ListTasks]. + Attributes: tasks: The list of tasks. @@ -1234,31 +1259,32 @@ A token to retrieve next page of results. To return the next page of results, call [ListTasks][google.cloud.tasks.v2.CloudTasks.ListTasks] with - this value as the [page\_token][google.cloud.tasks.v2.ListTask - sRequest.page\_token]. If the next\_page\_token is empty, - there are no more results. + this value as the [page_token][google.cloud.tasks.v2.ListTasks + Request.page_token]. If the next_page_token is empty, there + are no more results. """, # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2.ListTasksResponse) - ), + }, ) _sym_db.RegisterMessage(ListTasksResponse) GetTaskRequest = _reflection.GeneratedProtocolMessageType( "GetTaskRequest", (_message.Message,), - dict( - DESCRIPTOR=_GETTASKREQUEST, - __module__="google.cloud.tasks_v2.proto.cloudtasks_pb2", - __doc__="""Request message for getting a task using + { + "DESCRIPTOR": _GETTASKREQUEST, + "__module__": "google.cloud.tasks_v2.proto.cloudtasks_pb2", + "__doc__": """Request message for getting a task using [GetTask][google.cloud.tasks.v2.CloudTasks.GetTask]. + Attributes: name: Required. The task name. For example: ``projects/PROJECT_ID/lo cations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`` response_view: - The response\_view specifies which subset of the + The response_view specifies which subset of the [Task][google.cloud.tasks.v2.Task] will be returned. By - default response\_view is + default response_view is [BASIC][google.cloud.tasks.v2.Task.View.BASIC]; not all information is retrieved by default because some data, such as payloads, might be desirable to return only when needed @@ -1270,18 +1296,19 @@ [Task][google.cloud.tasks.v2.Task] resource. """, # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2.GetTaskRequest) - ), + }, ) _sym_db.RegisterMessage(GetTaskRequest) CreateTaskRequest = _reflection.GeneratedProtocolMessageType( "CreateTaskRequest", (_message.Message,), - dict( - DESCRIPTOR=_CREATETASKREQUEST, - __module__="google.cloud.tasks_v2.proto.cloudtasks_pb2", - __doc__="""Request message for + { + "DESCRIPTOR": _CREATETASKREQUEST, + "__module__": "google.cloud.tasks_v2.proto.cloudtasks_pb2", + "__doc__": """Request message for [CreateTask][google.cloud.tasks.v2.CloudTasks.CreateTask]. + Attributes: parent: Required. The queue name. For example: @@ -1295,18 +1322,18 @@ specified then the system will generate a random unique task id, which will be set in the task returned in the [response][google.cloud.tasks.v2.Task.name]. If - [schedule\_time][google.cloud.tasks.v2.Task.schedule\_time] is + [schedule_time][google.cloud.tasks.v2.Task.schedule_time] is not set or is in the past then Cloud Tasks will set it to the current time. Task De-duplication: Explicitly specifying a - task ID enables task de-duplication. If a task's ID is + task ID enables task de-duplication. If a task’s ID is identical to that of an existing task or a task that was deleted or executed recently then the call will fail with - [ALREADY\_EXISTS][google.rpc.Code.ALREADY\_EXISTS]. If the - task's queue was created using Cloud Tasks, then another task - with the same name can't be created for ~1hour after the - original task was deleted or executed. If the task's queue was + [ALREADY_EXISTS][google.rpc.Code.ALREADY_EXISTS]. If the + task’s queue was created using Cloud Tasks, then another task + with the same name can’t be created for ~1hour after the + original task was deleted or executed. If the task’s queue was created using queue.yaml or queue.xml, then another task with - the same name can't be created for ~9days after the original + the same name can’t be created for ~9days after the original task was deleted or executed. Because there is an extra lookup cost to identify duplicate task names, these [CreateTask][google.cloud.tasks.v2.CloudTasks.CreateTask] @@ -1318,9 +1345,9 @@ infrastructure relies on an approximately uniform distribution of task ids to store and serve tasks efficiently. response_view: - The response\_view specifies which subset of the + The response_view specifies which subset of the [Task][google.cloud.tasks.v2.Task] will be returned. By - default response\_view is + default response_view is [BASIC][google.cloud.tasks.v2.Task.View.BASIC]; not all information is retrieved by default because some data, such as payloads, might be desirable to return only when needed @@ -1332,44 +1359,46 @@ [Task][google.cloud.tasks.v2.Task] resource. """, # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2.CreateTaskRequest) - ), + }, ) _sym_db.RegisterMessage(CreateTaskRequest) DeleteTaskRequest = _reflection.GeneratedProtocolMessageType( "DeleteTaskRequest", (_message.Message,), - dict( - DESCRIPTOR=_DELETETASKREQUEST, - __module__="google.cloud.tasks_v2.proto.cloudtasks_pb2", - __doc__="""Request message for deleting a task using + { + "DESCRIPTOR": _DELETETASKREQUEST, + "__module__": "google.cloud.tasks_v2.proto.cloudtasks_pb2", + "__doc__": """Request message for deleting a task using [DeleteTask][google.cloud.tasks.v2.CloudTasks.DeleteTask]. + Attributes: name: Required. The task name. For example: ``projects/PROJECT_ID/lo cations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`` """, # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2.DeleteTaskRequest) - ), + }, ) _sym_db.RegisterMessage(DeleteTaskRequest) RunTaskRequest = _reflection.GeneratedProtocolMessageType( "RunTaskRequest", (_message.Message,), - dict( - DESCRIPTOR=_RUNTASKREQUEST, - __module__="google.cloud.tasks_v2.proto.cloudtasks_pb2", - __doc__="""Request message for forcing a task to run now using + { + "DESCRIPTOR": _RUNTASKREQUEST, + "__module__": "google.cloud.tasks_v2.proto.cloudtasks_pb2", + "__doc__": """Request message for forcing a task to run now using [RunTask][google.cloud.tasks.v2.CloudTasks.RunTask]. + Attributes: name: Required. The task name. For example: ``projects/PROJECT_ID/lo cations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`` response_view: - The response\_view specifies which subset of the + The response_view specifies which subset of the [Task][google.cloud.tasks.v2.Task] will be returned. By - default response\_view is + default response_view is [BASIC][google.cloud.tasks.v2.Task.View.BASIC]; not all information is retrieved by default because some data, such as payloads, might be desirable to return only when needed @@ -1381,7 +1410,7 @@ [Task][google.cloud.tasks.v2.Task] resource. """, # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2.RunTaskRequest) - ), + }, ) _sym_db.RegisterMessage(RunTaskRequest) @@ -1408,9 +1437,8 @@ full_name="google.cloud.tasks.v2.CloudTasks", file=DESCRIPTOR, index=0, - serialized_options=_b( - "\312A\031cloudtasks.googleapis.com\322A.https://www.googleapis.com/auth/cloud-platform" - ), + serialized_options=b"\312A\031cloudtasks.googleapis.com\322A.https://www.googleapis.com/auth/cloud-platform", + create_key=_descriptor._internal_create_key, serialized_start=2027, serialized_end=4680, methods=[ @@ -1421,9 +1449,8 @@ containing_service=None, input_type=_LISTQUEUESREQUEST, output_type=_LISTQUEUESRESPONSE, - serialized_options=_b( - "\202\323\344\223\002,\022*/v2/{parent=projects/*/locations/*}/queues\332A\006parent" - ), + serialized_options=b"\202\323\344\223\002,\022*/v2/{parent=projects/*/locations/*}/queues\332A\006parent", + create_key=_descriptor._internal_create_key, ), _descriptor.MethodDescriptor( name="GetQueue", @@ -1432,9 +1459,8 @@ containing_service=None, input_type=_GETQUEUEREQUEST, output_type=google_dot_cloud_dot_tasks__v2_dot_proto_dot_queue__pb2._QUEUE, - serialized_options=_b( - "\202\323\344\223\002,\022*/v2/{name=projects/*/locations/*/queues/*}\332A\004name" - ), + serialized_options=b"\202\323\344\223\002,\022*/v2/{name=projects/*/locations/*/queues/*}\332A\004name", + create_key=_descriptor._internal_create_key, ), _descriptor.MethodDescriptor( name="CreateQueue", @@ -1443,9 +1469,8 @@ containing_service=None, input_type=_CREATEQUEUEREQUEST, output_type=google_dot_cloud_dot_tasks__v2_dot_proto_dot_queue__pb2._QUEUE, - serialized_options=_b( - '\202\323\344\223\0023"*/v2/{parent=projects/*/locations/*}/queues:\005queue\332A\014parent,queue' - ), + serialized_options=b'\202\323\344\223\0023"*/v2/{parent=projects/*/locations/*}/queues:\005queue\332A\014parent,queue', + create_key=_descriptor._internal_create_key, ), _descriptor.MethodDescriptor( name="UpdateQueue", @@ -1454,9 +1479,8 @@ containing_service=None, input_type=_UPDATEQUEUEREQUEST, output_type=google_dot_cloud_dot_tasks__v2_dot_proto_dot_queue__pb2._QUEUE, - serialized_options=_b( - "\202\323\344\223\002920/v2/{queue.name=projects/*/locations/*/queues/*}:\005queue\332A\021queue,update_mask" - ), + serialized_options=b"\202\323\344\223\002920/v2/{queue.name=projects/*/locations/*/queues/*}:\005queue\332A\021queue,update_mask", + create_key=_descriptor._internal_create_key, ), _descriptor.MethodDescriptor( name="DeleteQueue", @@ -1465,9 +1489,8 @@ containing_service=None, input_type=_DELETEQUEUEREQUEST, output_type=google_dot_protobuf_dot_empty__pb2._EMPTY, - serialized_options=_b( - "\202\323\344\223\002,**/v2/{name=projects/*/locations/*/queues/*}\332A\004name" - ), + serialized_options=b"\202\323\344\223\002,**/v2/{name=projects/*/locations/*/queues/*}\332A\004name", + create_key=_descriptor._internal_create_key, ), _descriptor.MethodDescriptor( name="PurgeQueue", @@ -1476,9 +1499,8 @@ containing_service=None, input_type=_PURGEQUEUEREQUEST, output_type=google_dot_cloud_dot_tasks__v2_dot_proto_dot_queue__pb2._QUEUE, - serialized_options=_b( - '\202\323\344\223\0025"0/v2/{name=projects/*/locations/*/queues/*}:purge:\001*\332A\004name' - ), + serialized_options=b'\202\323\344\223\0025"0/v2/{name=projects/*/locations/*/queues/*}:purge:\001*\332A\004name', + create_key=_descriptor._internal_create_key, ), _descriptor.MethodDescriptor( name="PauseQueue", @@ -1487,9 +1509,8 @@ containing_service=None, input_type=_PAUSEQUEUEREQUEST, output_type=google_dot_cloud_dot_tasks__v2_dot_proto_dot_queue__pb2._QUEUE, - serialized_options=_b( - '\202\323\344\223\0025"0/v2/{name=projects/*/locations/*/queues/*}:pause:\001*\332A\004name' - ), + serialized_options=b'\202\323\344\223\0025"0/v2/{name=projects/*/locations/*/queues/*}:pause:\001*\332A\004name', + create_key=_descriptor._internal_create_key, ), _descriptor.MethodDescriptor( name="ResumeQueue", @@ -1498,9 +1519,8 @@ containing_service=None, input_type=_RESUMEQUEUEREQUEST, output_type=google_dot_cloud_dot_tasks__v2_dot_proto_dot_queue__pb2._QUEUE, - serialized_options=_b( - '\202\323\344\223\0026"1/v2/{name=projects/*/locations/*/queues/*}:resume:\001*\332A\004name' - ), + serialized_options=b'\202\323\344\223\0026"1/v2/{name=projects/*/locations/*/queues/*}:resume:\001*\332A\004name', + create_key=_descriptor._internal_create_key, ), _descriptor.MethodDescriptor( name="GetIamPolicy", @@ -1509,9 +1529,8 @@ containing_service=None, input_type=google_dot_iam_dot_v1_dot_iam__policy__pb2._GETIAMPOLICYREQUEST, output_type=google_dot_iam_dot_v1_dot_policy__pb2._POLICY, - serialized_options=_b( - '\202\323\344\223\002@";/v2/{resource=projects/*/locations/*/queues/*}:getIamPolicy:\001*\332A\010resource' - ), + serialized_options=b'\202\323\344\223\002@";/v2/{resource=projects/*/locations/*/queues/*}:getIamPolicy:\001*\332A\010resource', + create_key=_descriptor._internal_create_key, ), _descriptor.MethodDescriptor( name="SetIamPolicy", @@ -1520,9 +1539,8 @@ containing_service=None, input_type=google_dot_iam_dot_v1_dot_iam__policy__pb2._SETIAMPOLICYREQUEST, output_type=google_dot_iam_dot_v1_dot_policy__pb2._POLICY, - serialized_options=_b( - '\202\323\344\223\002@";/v2/{resource=projects/*/locations/*/queues/*}:setIamPolicy:\001*\332A\017resource,policy' - ), + serialized_options=b'\202\323\344\223\002@";/v2/{resource=projects/*/locations/*/queues/*}:setIamPolicy:\001*\332A\017resource,policy', + create_key=_descriptor._internal_create_key, ), _descriptor.MethodDescriptor( name="TestIamPermissions", @@ -1531,9 +1549,8 @@ containing_service=None, input_type=google_dot_iam_dot_v1_dot_iam__policy__pb2._TESTIAMPERMISSIONSREQUEST, output_type=google_dot_iam_dot_v1_dot_iam__policy__pb2._TESTIAMPERMISSIONSRESPONSE, - serialized_options=_b( - '\202\323\344\223\002F"A/v2/{resource=projects/*/locations/*/queues/*}:testIamPermissions:\001*\332A\024resource,permissions' - ), + serialized_options=b'\202\323\344\223\002F"A/v2/{resource=projects/*/locations/*/queues/*}:testIamPermissions:\001*\332A\024resource,permissions', + create_key=_descriptor._internal_create_key, ), _descriptor.MethodDescriptor( name="ListTasks", @@ -1542,9 +1559,8 @@ containing_service=None, input_type=_LISTTASKSREQUEST, output_type=_LISTTASKSRESPONSE, - serialized_options=_b( - "\202\323\344\223\0024\0222/v2/{parent=projects/*/locations/*/queues/*}/tasks\332A\006parent" - ), + serialized_options=b"\202\323\344\223\0024\0222/v2/{parent=projects/*/locations/*/queues/*}/tasks\332A\006parent", + create_key=_descriptor._internal_create_key, ), _descriptor.MethodDescriptor( name="GetTask", @@ -1553,9 +1569,8 @@ containing_service=None, input_type=_GETTASKREQUEST, output_type=google_dot_cloud_dot_tasks__v2_dot_proto_dot_task__pb2._TASK, - serialized_options=_b( - "\202\323\344\223\0024\0222/v2/{name=projects/*/locations/*/queues/*/tasks/*}\332A\004name" - ), + serialized_options=b"\202\323\344\223\0024\0222/v2/{name=projects/*/locations/*/queues/*/tasks/*}\332A\004name", + create_key=_descriptor._internal_create_key, ), _descriptor.MethodDescriptor( name="CreateTask", @@ -1564,9 +1579,8 @@ containing_service=None, input_type=_CREATETASKREQUEST, output_type=google_dot_cloud_dot_tasks__v2_dot_proto_dot_task__pb2._TASK, - serialized_options=_b( - '\202\323\344\223\0027"2/v2/{parent=projects/*/locations/*/queues/*}/tasks:\001*\332A\013parent,task' - ), + serialized_options=b'\202\323\344\223\0027"2/v2/{parent=projects/*/locations/*/queues/*}/tasks:\001*\332A\013parent,task', + create_key=_descriptor._internal_create_key, ), _descriptor.MethodDescriptor( name="DeleteTask", @@ -1575,9 +1589,8 @@ containing_service=None, input_type=_DELETETASKREQUEST, output_type=google_dot_protobuf_dot_empty__pb2._EMPTY, - serialized_options=_b( - "\202\323\344\223\0024*2/v2/{name=projects/*/locations/*/queues/*/tasks/*}\332A\004name" - ), + serialized_options=b"\202\323\344\223\0024*2/v2/{name=projects/*/locations/*/queues/*/tasks/*}\332A\004name", + create_key=_descriptor._internal_create_key, ), _descriptor.MethodDescriptor( name="RunTask", @@ -1586,9 +1599,8 @@ containing_service=None, input_type=_RUNTASKREQUEST, output_type=google_dot_cloud_dot_tasks__v2_dot_proto_dot_task__pb2._TASK, - serialized_options=_b( - '\202\323\344\223\002;"6/v2/{name=projects/*/locations/*/queues/*/tasks/*}:run:\001*\332A\004name' - ), + serialized_options=b'\202\323\344\223\002;"6/v2/{name=projects/*/locations/*/queues/*/tasks/*}:run:\001*\332A\004name', + create_key=_descriptor._internal_create_key, ), ], ) diff --git a/google/cloud/tasks_v2/proto/cloudtasks_pb2_grpc.py b/google/cloud/tasks_v2/proto/cloudtasks_pb2_grpc.py index 0815f660..838e3b80 100644 --- a/google/cloud/tasks_v2/proto/cloudtasks_pb2_grpc.py +++ b/google/cloud/tasks_v2/proto/cloudtasks_pb2_grpc.py @@ -1,4 +1,5 @@ # Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT! +"""Client and server classes corresponding to protobuf-defined services.""" import grpc from google.cloud.tasks_v2.proto import ( @@ -17,15 +18,15 @@ class CloudTasksStub(object): """Cloud Tasks allows developers to manage the execution of background - work in their applications. - """ + work in their applications. + """ def __init__(self, channel): """Constructor. - Args: - channel: A grpc.Channel. - """ + Args: + channel: A grpc.Channel. + """ self.ListQueues = channel.unary_unary( "/google.cloud.tasks.v2.CloudTasks/ListQueues", request_serializer=google_dot_cloud_dot_tasks__v2_dot_proto_dot_cloudtasks__pb2.ListQueuesRequest.SerializeToString, @@ -110,21 +111,21 @@ def __init__(self, channel): class CloudTasksServicer(object): """Cloud Tasks allows developers to manage the execution of background - work in their applications. - """ + work in their applications. + """ def ListQueues(self, request, context): """Lists queues. - Queues are returned in lexicographical order. - """ + Queues are returned in lexicographical order. + """ context.set_code(grpc.StatusCode.UNIMPLEMENTED) context.set_details("Method not implemented!") raise NotImplementedError("Method not implemented!") def GetQueue(self, request, context): """Gets a queue. - """ + """ context.set_code(grpc.StatusCode.UNIMPLEMENTED) context.set_details("Method not implemented!") raise NotImplementedError("Method not implemented!") @@ -132,17 +133,17 @@ def GetQueue(self, request, context): def CreateQueue(self, request, context): """Creates a queue. - Queues created with this method allow tasks to live for a maximum of 31 - days. After a task is 31 days old, the task will be deleted regardless of whether - it was dispatched or not. - - WARNING: Using this method may have unintended side effects if you are - using an App Engine `queue.yaml` or `queue.xml` file to manage your queues. - Read - [Overview of Queue Management and - queue.yaml](https://cloud.google.com/tasks/docs/queue-yaml) before using - this method. - """ + Queues created with this method allow tasks to live for a maximum of 31 + days. After a task is 31 days old, the task will be deleted regardless of whether + it was dispatched or not. + + WARNING: Using this method may have unintended side effects if you are + using an App Engine `queue.yaml` or `queue.xml` file to manage your queues. + Read + [Overview of Queue Management and + queue.yaml](https://cloud.google.com/tasks/docs/queue-yaml) before using + this method. + """ context.set_code(grpc.StatusCode.UNIMPLEMENTED) context.set_details("Method not implemented!") raise NotImplementedError("Method not implemented!") @@ -150,20 +151,20 @@ def CreateQueue(self, request, context): def UpdateQueue(self, request, context): """Updates a queue. - This method creates the queue if it does not exist and updates - the queue if it does exist. + This method creates the queue if it does not exist and updates + the queue if it does exist. - Queues created with this method allow tasks to live for a maximum of 31 - days. After a task is 31 days old, the task will be deleted regardless of whether - it was dispatched or not. + Queues created with this method allow tasks to live for a maximum of 31 + days. After a task is 31 days old, the task will be deleted regardless of whether + it was dispatched or not. - WARNING: Using this method may have unintended side effects if you are - using an App Engine `queue.yaml` or `queue.xml` file to manage your queues. - Read - [Overview of Queue Management and - queue.yaml](https://cloud.google.com/tasks/docs/queue-yaml) before using - this method. - """ + WARNING: Using this method may have unintended side effects if you are + using an App Engine `queue.yaml` or `queue.xml` file to manage your queues. + Read + [Overview of Queue Management and + queue.yaml](https://cloud.google.com/tasks/docs/queue-yaml) before using + this method. + """ context.set_code(grpc.StatusCode.UNIMPLEMENTED) context.set_details("Method not implemented!") raise NotImplementedError("Method not implemented!") @@ -171,18 +172,18 @@ def UpdateQueue(self, request, context): def DeleteQueue(self, request, context): """Deletes a queue. - This command will delete the queue even if it has tasks in it. + This command will delete the queue even if it has tasks in it. - Note: If you delete a queue, a queue with the same name can't be created - for 7 days. + Note: If you delete a queue, a queue with the same name can't be created + for 7 days. - WARNING: Using this method may have unintended side effects if you are - using an App Engine `queue.yaml` or `queue.xml` file to manage your queues. - Read - [Overview of Queue Management and - queue.yaml](https://cloud.google.com/tasks/docs/queue-yaml) before using - this method. - """ + WARNING: Using this method may have unintended side effects if you are + using an App Engine `queue.yaml` or `queue.xml` file to manage your queues. + Read + [Overview of Queue Management and + queue.yaml](https://cloud.google.com/tasks/docs/queue-yaml) before using + this method. + """ context.set_code(grpc.StatusCode.UNIMPLEMENTED) context.set_details("Method not implemented!") raise NotImplementedError("Method not implemented!") @@ -190,11 +191,11 @@ def DeleteQueue(self, request, context): def PurgeQueue(self, request, context): """Purges a queue by deleting all of its tasks. - All tasks created before this method is called are permanently deleted. + All tasks created before this method is called are permanently deleted. - Purge operations can take up to one minute to take effect. Tasks - might be dispatched before the purge takes effect. A purge is irreversible. - """ + Purge operations can take up to one minute to take effect. Tasks + might be dispatched before the purge takes effect. A purge is irreversible. + """ context.set_code(grpc.StatusCode.UNIMPLEMENTED) context.set_details("Method not implemented!") raise NotImplementedError("Method not implemented!") @@ -202,12 +203,12 @@ def PurgeQueue(self, request, context): def PauseQueue(self, request, context): """Pauses the queue. - If a queue is paused then the system will stop dispatching tasks - until the queue is resumed via - [ResumeQueue][google.cloud.tasks.v2.CloudTasks.ResumeQueue]. Tasks can still be added - when the queue is paused. A queue is paused if its - [state][google.cloud.tasks.v2.Queue.state] is [PAUSED][google.cloud.tasks.v2.Queue.State.PAUSED]. - """ + If a queue is paused then the system will stop dispatching tasks + until the queue is resumed via + [ResumeQueue][google.cloud.tasks.v2.CloudTasks.ResumeQueue]. Tasks can still be added + when the queue is paused. A queue is paused if its + [state][google.cloud.tasks.v2.Queue.state] is [PAUSED][google.cloud.tasks.v2.Queue.State.PAUSED]. + """ context.set_code(grpc.StatusCode.UNIMPLEMENTED) context.set_details("Method not implemented!") raise NotImplementedError("Method not implemented!") @@ -215,63 +216,63 @@ def PauseQueue(self, request, context): def ResumeQueue(self, request, context): """Resume a queue. - This method resumes a queue after it has been - [PAUSED][google.cloud.tasks.v2.Queue.State.PAUSED] or - [DISABLED][google.cloud.tasks.v2.Queue.State.DISABLED]. The state of a queue is stored - in the queue's [state][google.cloud.tasks.v2.Queue.state]; after calling this method it - will be set to [RUNNING][google.cloud.tasks.v2.Queue.State.RUNNING]. - - WARNING: Resuming many high-QPS queues at the same time can - lead to target overloading. If you are resuming high-QPS - queues, follow the 500/50/5 pattern described in - [Managing Cloud Tasks Scaling - Risks](https://cloud.google.com/tasks/docs/manage-cloud-task-scaling). - """ + This method resumes a queue after it has been + [PAUSED][google.cloud.tasks.v2.Queue.State.PAUSED] or + [DISABLED][google.cloud.tasks.v2.Queue.State.DISABLED]. The state of a queue is stored + in the queue's [state][google.cloud.tasks.v2.Queue.state]; after calling this method it + will be set to [RUNNING][google.cloud.tasks.v2.Queue.State.RUNNING]. + + WARNING: Resuming many high-QPS queues at the same time can + lead to target overloading. If you are resuming high-QPS + queues, follow the 500/50/5 pattern described in + [Managing Cloud Tasks Scaling + Risks](https://cloud.google.com/tasks/docs/manage-cloud-task-scaling). + """ context.set_code(grpc.StatusCode.UNIMPLEMENTED) context.set_details("Method not implemented!") raise NotImplementedError("Method not implemented!") def GetIamPolicy(self, request, context): """Gets the access control policy for a [Queue][google.cloud.tasks.v2.Queue]. - Returns an empty policy if the resource exists and does not have a policy - set. + Returns an empty policy if the resource exists and does not have a policy + set. - Authorization requires the following - [Google IAM](https://cloud.google.com/iam) permission on the specified - resource parent: + Authorization requires the following + [Google IAM](https://cloud.google.com/iam) permission on the specified + resource parent: - * `cloudtasks.queues.getIamPolicy` - """ + * `cloudtasks.queues.getIamPolicy` + """ context.set_code(grpc.StatusCode.UNIMPLEMENTED) context.set_details("Method not implemented!") raise NotImplementedError("Method not implemented!") def SetIamPolicy(self, request, context): """Sets the access control policy for a [Queue][google.cloud.tasks.v2.Queue]. Replaces any existing - policy. + policy. - Note: The Cloud Console does not check queue-level IAM permissions yet. - Project-level permissions are required to use the Cloud Console. + Note: The Cloud Console does not check queue-level IAM permissions yet. + Project-level permissions are required to use the Cloud Console. - Authorization requires the following - [Google IAM](https://cloud.google.com/iam) permission on the specified - resource parent: + Authorization requires the following + [Google IAM](https://cloud.google.com/iam) permission on the specified + resource parent: - * `cloudtasks.queues.setIamPolicy` - """ + * `cloudtasks.queues.setIamPolicy` + """ context.set_code(grpc.StatusCode.UNIMPLEMENTED) context.set_details("Method not implemented!") raise NotImplementedError("Method not implemented!") def TestIamPermissions(self, request, context): """Returns permissions that a caller has on a [Queue][google.cloud.tasks.v2.Queue]. - If the resource does not exist, this will return an empty set of - permissions, not a [NOT_FOUND][google.rpc.Code.NOT_FOUND] error. + If the resource does not exist, this will return an empty set of + permissions, not a [NOT_FOUND][google.rpc.Code.NOT_FOUND] error. - Note: This operation is designed to be used for building permission-aware - UIs and command-line tools, not for authorization checking. This operation - may "fail open" without warning. - """ + Note: This operation is designed to be used for building permission-aware + UIs and command-line tools, not for authorization checking. This operation + may "fail open" without warning. + """ context.set_code(grpc.StatusCode.UNIMPLEMENTED) context.set_details("Method not implemented!") raise NotImplementedError("Method not implemented!") @@ -279,21 +280,21 @@ def TestIamPermissions(self, request, context): def ListTasks(self, request, context): """Lists the tasks in a queue. - By default, only the [BASIC][google.cloud.tasks.v2.Task.View.BASIC] view is retrieved - due to performance considerations; - [response_view][google.cloud.tasks.v2.ListTasksRequest.response_view] controls the - subset of information which is returned. + By default, only the [BASIC][google.cloud.tasks.v2.Task.View.BASIC] view is retrieved + due to performance considerations; + [response_view][google.cloud.tasks.v2.ListTasksRequest.response_view] controls the + subset of information which is returned. - The tasks may be returned in any order. The ordering may change at any - time. - """ + The tasks may be returned in any order. The ordering may change at any + time. + """ context.set_code(grpc.StatusCode.UNIMPLEMENTED) context.set_details("Method not implemented!") raise NotImplementedError("Method not implemented!") def GetTask(self, request, context): """Gets a task. - """ + """ context.set_code(grpc.StatusCode.UNIMPLEMENTED) context.set_details("Method not implemented!") raise NotImplementedError("Method not implemented!") @@ -301,10 +302,10 @@ def GetTask(self, request, context): def CreateTask(self, request, context): """Creates a task and adds it to a queue. - Tasks cannot be updated after creation; there is no UpdateTask command. + Tasks cannot be updated after creation; there is no UpdateTask command. - * The maximum task size is 100KB. - """ + * The maximum task size is 100KB. + """ context.set_code(grpc.StatusCode.UNIMPLEMENTED) context.set_details("Method not implemented!") raise NotImplementedError("Method not implemented!") @@ -312,10 +313,10 @@ def CreateTask(self, request, context): def DeleteTask(self, request, context): """Deletes a task. - A task can be deleted if it is scheduled or dispatched. A task - cannot be deleted if it has executed successfully or permanently - failed. - """ + A task can be deleted if it is scheduled or dispatched. A task + cannot be deleted if it has executed successfully or permanently + failed. + """ context.set_code(grpc.StatusCode.UNIMPLEMENTED) context.set_details("Method not implemented!") raise NotImplementedError("Method not implemented!") @@ -323,29 +324,29 @@ def DeleteTask(self, request, context): def RunTask(self, request, context): """Forces a task to run now. - When this method is called, Cloud Tasks will dispatch the task, even if - the task is already running, the queue has reached its [RateLimits][google.cloud.tasks.v2.RateLimits] or - is [PAUSED][google.cloud.tasks.v2.Queue.State.PAUSED]. - - This command is meant to be used for manual debugging. For - example, [RunTask][google.cloud.tasks.v2.CloudTasks.RunTask] can be used to retry a failed - task after a fix has been made or to manually force a task to be - dispatched now. - - The dispatched task is returned. That is, the task that is returned - contains the [status][Task.status] after the task is dispatched but - before the task is received by its target. - - If Cloud Tasks receives a successful response from the task's - target, then the task will be deleted; otherwise the task's - [schedule_time][google.cloud.tasks.v2.Task.schedule_time] will be reset to the time that - [RunTask][google.cloud.tasks.v2.CloudTasks.RunTask] was called plus the retry delay specified - in the queue's [RetryConfig][google.cloud.tasks.v2.RetryConfig]. - - [RunTask][google.cloud.tasks.v2.CloudTasks.RunTask] returns - [NOT_FOUND][google.rpc.Code.NOT_FOUND] when it is called on a - task that has already succeeded or permanently failed. - """ + When this method is called, Cloud Tasks will dispatch the task, even if + the task is already running, the queue has reached its [RateLimits][google.cloud.tasks.v2.RateLimits] or + is [PAUSED][google.cloud.tasks.v2.Queue.State.PAUSED]. + + This command is meant to be used for manual debugging. For + example, [RunTask][google.cloud.tasks.v2.CloudTasks.RunTask] can be used to retry a failed + task after a fix has been made or to manually force a task to be + dispatched now. + + The dispatched task is returned. That is, the task that is returned + contains the [status][Task.status] after the task is dispatched but + before the task is received by its target. + + If Cloud Tasks receives a successful response from the task's + target, then the task will be deleted; otherwise the task's + [schedule_time][google.cloud.tasks.v2.Task.schedule_time] will be reset to the time that + [RunTask][google.cloud.tasks.v2.CloudTasks.RunTask] was called plus the retry delay specified + in the queue's [RetryConfig][google.cloud.tasks.v2.RetryConfig]. + + [RunTask][google.cloud.tasks.v2.CloudTasks.RunTask] returns + [NOT_FOUND][google.rpc.Code.NOT_FOUND] when it is called on a + task that has already succeeded or permanently failed. + """ context.set_code(grpc.StatusCode.UNIMPLEMENTED) context.set_details("Method not implemented!") raise NotImplementedError("Method not implemented!") @@ -438,3 +439,442 @@ def add_CloudTasksServicer_to_server(servicer, server): "google.cloud.tasks.v2.CloudTasks", rpc_method_handlers ) server.add_generic_rpc_handlers((generic_handler,)) + + +# This class is part of an EXPERIMENTAL API. +class CloudTasks(object): + """Cloud Tasks allows developers to manage the execution of background + work in their applications. + """ + + @staticmethod + def ListQueues( + request, + target, + options=(), + channel_credentials=None, + call_credentials=None, + compression=None, + wait_for_ready=None, + timeout=None, + metadata=None, + ): + return grpc.experimental.unary_unary( + request, + target, + "/google.cloud.tasks.v2.CloudTasks/ListQueues", + google_dot_cloud_dot_tasks__v2_dot_proto_dot_cloudtasks__pb2.ListQueuesRequest.SerializeToString, + google_dot_cloud_dot_tasks__v2_dot_proto_dot_cloudtasks__pb2.ListQueuesResponse.FromString, + options, + channel_credentials, + call_credentials, + compression, + wait_for_ready, + timeout, + metadata, + ) + + @staticmethod + def GetQueue( + request, + target, + options=(), + channel_credentials=None, + call_credentials=None, + compression=None, + wait_for_ready=None, + timeout=None, + metadata=None, + ): + return grpc.experimental.unary_unary( + request, + target, + "/google.cloud.tasks.v2.CloudTasks/GetQueue", + google_dot_cloud_dot_tasks__v2_dot_proto_dot_cloudtasks__pb2.GetQueueRequest.SerializeToString, + google_dot_cloud_dot_tasks__v2_dot_proto_dot_queue__pb2.Queue.FromString, + options, + channel_credentials, + call_credentials, + compression, + wait_for_ready, + timeout, + metadata, + ) + + @staticmethod + def CreateQueue( + request, + target, + options=(), + channel_credentials=None, + call_credentials=None, + compression=None, + wait_for_ready=None, + timeout=None, + metadata=None, + ): + return grpc.experimental.unary_unary( + request, + target, + "/google.cloud.tasks.v2.CloudTasks/CreateQueue", + google_dot_cloud_dot_tasks__v2_dot_proto_dot_cloudtasks__pb2.CreateQueueRequest.SerializeToString, + google_dot_cloud_dot_tasks__v2_dot_proto_dot_queue__pb2.Queue.FromString, + options, + channel_credentials, + call_credentials, + compression, + wait_for_ready, + timeout, + metadata, + ) + + @staticmethod + def UpdateQueue( + request, + target, + options=(), + channel_credentials=None, + call_credentials=None, + compression=None, + wait_for_ready=None, + timeout=None, + metadata=None, + ): + return grpc.experimental.unary_unary( + request, + target, + "/google.cloud.tasks.v2.CloudTasks/UpdateQueue", + google_dot_cloud_dot_tasks__v2_dot_proto_dot_cloudtasks__pb2.UpdateQueueRequest.SerializeToString, + google_dot_cloud_dot_tasks__v2_dot_proto_dot_queue__pb2.Queue.FromString, + options, + channel_credentials, + call_credentials, + compression, + wait_for_ready, + timeout, + metadata, + ) + + @staticmethod + def DeleteQueue( + request, + target, + options=(), + channel_credentials=None, + call_credentials=None, + compression=None, + wait_for_ready=None, + timeout=None, + metadata=None, + ): + return grpc.experimental.unary_unary( + request, + target, + "/google.cloud.tasks.v2.CloudTasks/DeleteQueue", + google_dot_cloud_dot_tasks__v2_dot_proto_dot_cloudtasks__pb2.DeleteQueueRequest.SerializeToString, + google_dot_protobuf_dot_empty__pb2.Empty.FromString, + options, + channel_credentials, + call_credentials, + compression, + wait_for_ready, + timeout, + metadata, + ) + + @staticmethod + def PurgeQueue( + request, + target, + options=(), + channel_credentials=None, + call_credentials=None, + compression=None, + wait_for_ready=None, + timeout=None, + metadata=None, + ): + return grpc.experimental.unary_unary( + request, + target, + "/google.cloud.tasks.v2.CloudTasks/PurgeQueue", + google_dot_cloud_dot_tasks__v2_dot_proto_dot_cloudtasks__pb2.PurgeQueueRequest.SerializeToString, + google_dot_cloud_dot_tasks__v2_dot_proto_dot_queue__pb2.Queue.FromString, + options, + channel_credentials, + call_credentials, + compression, + wait_for_ready, + timeout, + metadata, + ) + + @staticmethod + def PauseQueue( + request, + target, + options=(), + channel_credentials=None, + call_credentials=None, + compression=None, + wait_for_ready=None, + timeout=None, + metadata=None, + ): + return grpc.experimental.unary_unary( + request, + target, + "/google.cloud.tasks.v2.CloudTasks/PauseQueue", + google_dot_cloud_dot_tasks__v2_dot_proto_dot_cloudtasks__pb2.PauseQueueRequest.SerializeToString, + google_dot_cloud_dot_tasks__v2_dot_proto_dot_queue__pb2.Queue.FromString, + options, + channel_credentials, + call_credentials, + compression, + wait_for_ready, + timeout, + metadata, + ) + + @staticmethod + def ResumeQueue( + request, + target, + options=(), + channel_credentials=None, + call_credentials=None, + compression=None, + wait_for_ready=None, + timeout=None, + metadata=None, + ): + return grpc.experimental.unary_unary( + request, + target, + "/google.cloud.tasks.v2.CloudTasks/ResumeQueue", + google_dot_cloud_dot_tasks__v2_dot_proto_dot_cloudtasks__pb2.ResumeQueueRequest.SerializeToString, + google_dot_cloud_dot_tasks__v2_dot_proto_dot_queue__pb2.Queue.FromString, + options, + channel_credentials, + call_credentials, + compression, + wait_for_ready, + timeout, + metadata, + ) + + @staticmethod + def GetIamPolicy( + request, + target, + options=(), + channel_credentials=None, + call_credentials=None, + compression=None, + wait_for_ready=None, + timeout=None, + metadata=None, + ): + return grpc.experimental.unary_unary( + request, + target, + "/google.cloud.tasks.v2.CloudTasks/GetIamPolicy", + google_dot_iam_dot_v1_dot_iam__policy__pb2.GetIamPolicyRequest.SerializeToString, + google_dot_iam_dot_v1_dot_policy__pb2.Policy.FromString, + options, + channel_credentials, + call_credentials, + compression, + wait_for_ready, + timeout, + metadata, + ) + + @staticmethod + def SetIamPolicy( + request, + target, + options=(), + channel_credentials=None, + call_credentials=None, + compression=None, + wait_for_ready=None, + timeout=None, + metadata=None, + ): + return grpc.experimental.unary_unary( + request, + target, + "/google.cloud.tasks.v2.CloudTasks/SetIamPolicy", + google_dot_iam_dot_v1_dot_iam__policy__pb2.SetIamPolicyRequest.SerializeToString, + google_dot_iam_dot_v1_dot_policy__pb2.Policy.FromString, + options, + channel_credentials, + call_credentials, + compression, + wait_for_ready, + timeout, + metadata, + ) + + @staticmethod + def TestIamPermissions( + request, + target, + options=(), + channel_credentials=None, + call_credentials=None, + compression=None, + wait_for_ready=None, + timeout=None, + metadata=None, + ): + return grpc.experimental.unary_unary( + request, + target, + "/google.cloud.tasks.v2.CloudTasks/TestIamPermissions", + google_dot_iam_dot_v1_dot_iam__policy__pb2.TestIamPermissionsRequest.SerializeToString, + google_dot_iam_dot_v1_dot_iam__policy__pb2.TestIamPermissionsResponse.FromString, + options, + channel_credentials, + call_credentials, + compression, + wait_for_ready, + timeout, + metadata, + ) + + @staticmethod + def ListTasks( + request, + target, + options=(), + channel_credentials=None, + call_credentials=None, + compression=None, + wait_for_ready=None, + timeout=None, + metadata=None, + ): + return grpc.experimental.unary_unary( + request, + target, + "/google.cloud.tasks.v2.CloudTasks/ListTasks", + google_dot_cloud_dot_tasks__v2_dot_proto_dot_cloudtasks__pb2.ListTasksRequest.SerializeToString, + google_dot_cloud_dot_tasks__v2_dot_proto_dot_cloudtasks__pb2.ListTasksResponse.FromString, + options, + channel_credentials, + call_credentials, + compression, + wait_for_ready, + timeout, + metadata, + ) + + @staticmethod + def GetTask( + request, + target, + options=(), + channel_credentials=None, + call_credentials=None, + compression=None, + wait_for_ready=None, + timeout=None, + metadata=None, + ): + return grpc.experimental.unary_unary( + request, + target, + "/google.cloud.tasks.v2.CloudTasks/GetTask", + google_dot_cloud_dot_tasks__v2_dot_proto_dot_cloudtasks__pb2.GetTaskRequest.SerializeToString, + google_dot_cloud_dot_tasks__v2_dot_proto_dot_task__pb2.Task.FromString, + options, + channel_credentials, + call_credentials, + compression, + wait_for_ready, + timeout, + metadata, + ) + + @staticmethod + def CreateTask( + request, + target, + options=(), + channel_credentials=None, + call_credentials=None, + compression=None, + wait_for_ready=None, + timeout=None, + metadata=None, + ): + return grpc.experimental.unary_unary( + request, + target, + "/google.cloud.tasks.v2.CloudTasks/CreateTask", + google_dot_cloud_dot_tasks__v2_dot_proto_dot_cloudtasks__pb2.CreateTaskRequest.SerializeToString, + google_dot_cloud_dot_tasks__v2_dot_proto_dot_task__pb2.Task.FromString, + options, + channel_credentials, + call_credentials, + compression, + wait_for_ready, + timeout, + metadata, + ) + + @staticmethod + def DeleteTask( + request, + target, + options=(), + channel_credentials=None, + call_credentials=None, + compression=None, + wait_for_ready=None, + timeout=None, + metadata=None, + ): + return grpc.experimental.unary_unary( + request, + target, + "/google.cloud.tasks.v2.CloudTasks/DeleteTask", + google_dot_cloud_dot_tasks__v2_dot_proto_dot_cloudtasks__pb2.DeleteTaskRequest.SerializeToString, + google_dot_protobuf_dot_empty__pb2.Empty.FromString, + options, + channel_credentials, + call_credentials, + compression, + wait_for_ready, + timeout, + metadata, + ) + + @staticmethod + def RunTask( + request, + target, + options=(), + channel_credentials=None, + call_credentials=None, + compression=None, + wait_for_ready=None, + timeout=None, + metadata=None, + ): + return grpc.experimental.unary_unary( + request, + target, + "/google.cloud.tasks.v2.CloudTasks/RunTask", + google_dot_cloud_dot_tasks__v2_dot_proto_dot_cloudtasks__pb2.RunTaskRequest.SerializeToString, + google_dot_cloud_dot_tasks__v2_dot_proto_dot_task__pb2.Task.FromString, + options, + channel_credentials, + call_credentials, + compression, + wait_for_ready, + timeout, + metadata, + ) diff --git a/google/cloud/tasks_v2/proto/queue_pb2.py b/google/cloud/tasks_v2/proto/queue_pb2.py index bcc89905..c74256b7 100644 --- a/google/cloud/tasks_v2/proto/queue_pb2.py +++ b/google/cloud/tasks_v2/proto/queue_pb2.py @@ -1,10 +1,7 @@ # -*- coding: utf-8 -*- # Generated by the protocol buffer compiler. DO NOT EDIT! # source: google/cloud/tasks_v2/proto/queue.proto - -import sys - -_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1")) +"""Generated protocol buffer code.""" from google.protobuf import descriptor as _descriptor from google.protobuf import message as _message from google.protobuf import reflection as _reflection @@ -28,12 +25,9 @@ name="google/cloud/tasks_v2/proto/queue.proto", package="google.cloud.tasks.v2", syntax="proto3", - serialized_options=_b( - "\n\031com.google.cloud.tasks.v2B\nQueueProtoP\001Z:google.golang.org/genproto/googleapis/cloud/tasks/v2;tasks" - ), - serialized_pb=_b( - '\n\'google/cloud/tasks_v2/proto/queue.proto\x12\x15google.cloud.tasks.v2\x1a\x19google/api/resource.proto\x1a(google/cloud/tasks_v2/proto/target.proto\x1a\x1egoogle/protobuf/duration.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x1cgoogle/api/annotations.proto"\xb2\x04\n\x05Queue\x12\x0c\n\x04name\x18\x01 \x01(\t\x12L\n\x1b\x61pp_engine_routing_override\x18\x02 \x01(\x0b\x32\'.google.cloud.tasks.v2.AppEngineRouting\x12\x36\n\x0brate_limits\x18\x03 \x01(\x0b\x32!.google.cloud.tasks.v2.RateLimits\x12\x38\n\x0cretry_config\x18\x04 \x01(\x0b\x32".google.cloud.tasks.v2.RetryConfig\x12\x31\n\x05state\x18\x05 \x01(\x0e\x32".google.cloud.tasks.v2.Queue.State\x12.\n\npurge_time\x18\x06 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12S\n\x1astackdriver_logging_config\x18\t \x01(\x0b\x32/.google.cloud.tasks.v2.StackdriverLoggingConfig"E\n\x05State\x12\x15\n\x11STATE_UNSPECIFIED\x10\x00\x12\x0b\n\x07RUNNING\x10\x01\x12\n\n\x06PAUSED\x10\x02\x12\x0c\n\x08\x44ISABLED\x10\x03:\\\xea\x41Y\n\x1f\x63loudtasks.googleapis.com/Queue\x12\x36projects/{project}/locations/{location}/queues/{queue}"j\n\nRateLimits\x12!\n\x19max_dispatches_per_second\x18\x01 \x01(\x01\x12\x16\n\x0emax_burst_size\x18\x02 \x01(\x05\x12!\n\x19max_concurrent_dispatches\x18\x03 \x01(\x05"\xd1\x01\n\x0bRetryConfig\x12\x14\n\x0cmax_attempts\x18\x01 \x01(\x05\x12\x35\n\x12max_retry_duration\x18\x02 \x01(\x0b\x32\x19.google.protobuf.Duration\x12.\n\x0bmin_backoff\x18\x03 \x01(\x0b\x32\x19.google.protobuf.Duration\x12.\n\x0bmax_backoff\x18\x04 \x01(\x0b\x32\x19.google.protobuf.Duration\x12\x15\n\rmax_doublings\x18\x05 \x01(\x05"2\n\x18StackdriverLoggingConfig\x12\x16\n\x0esampling_ratio\x18\x01 \x01(\x01\x42\x65\n\x19\x63om.google.cloud.tasks.v2B\nQueueProtoP\x01Z:google.golang.org/genproto/googleapis/cloud/tasks/v2;tasksb\x06proto3' - ), + serialized_options=b"\n\031com.google.cloud.tasks.v2B\nQueueProtoP\001Z:google.golang.org/genproto/googleapis/cloud/tasks/v2;tasks", + create_key=_descriptor._internal_create_key, + serialized_pb=b'\n\'google/cloud/tasks_v2/proto/queue.proto\x12\x15google.cloud.tasks.v2\x1a\x19google/api/resource.proto\x1a(google/cloud/tasks_v2/proto/target.proto\x1a\x1egoogle/protobuf/duration.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x1cgoogle/api/annotations.proto"\xb2\x04\n\x05Queue\x12\x0c\n\x04name\x18\x01 \x01(\t\x12L\n\x1b\x61pp_engine_routing_override\x18\x02 \x01(\x0b\x32\'.google.cloud.tasks.v2.AppEngineRouting\x12\x36\n\x0brate_limits\x18\x03 \x01(\x0b\x32!.google.cloud.tasks.v2.RateLimits\x12\x38\n\x0cretry_config\x18\x04 \x01(\x0b\x32".google.cloud.tasks.v2.RetryConfig\x12\x31\n\x05state\x18\x05 \x01(\x0e\x32".google.cloud.tasks.v2.Queue.State\x12.\n\npurge_time\x18\x06 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12S\n\x1astackdriver_logging_config\x18\t \x01(\x0b\x32/.google.cloud.tasks.v2.StackdriverLoggingConfig"E\n\x05State\x12\x15\n\x11STATE_UNSPECIFIED\x10\x00\x12\x0b\n\x07RUNNING\x10\x01\x12\n\n\x06PAUSED\x10\x02\x12\x0c\n\x08\x44ISABLED\x10\x03:\\\xea\x41Y\n\x1f\x63loudtasks.googleapis.com/Queue\x12\x36projects/{project}/locations/{location}/queues/{queue}"j\n\nRateLimits\x12!\n\x19max_dispatches_per_second\x18\x01 \x01(\x01\x12\x16\n\x0emax_burst_size\x18\x02 \x01(\x05\x12!\n\x19max_concurrent_dispatches\x18\x03 \x01(\x05"\xd1\x01\n\x0bRetryConfig\x12\x14\n\x0cmax_attempts\x18\x01 \x01(\x05\x12\x35\n\x12max_retry_duration\x18\x02 \x01(\x0b\x32\x19.google.protobuf.Duration\x12.\n\x0bmin_backoff\x18\x03 \x01(\x0b\x32\x19.google.protobuf.Duration\x12.\n\x0bmax_backoff\x18\x04 \x01(\x0b\x32\x19.google.protobuf.Duration\x12\x15\n\rmax_doublings\x18\x05 \x01(\x05"2\n\x18StackdriverLoggingConfig\x12\x16\n\x0esampling_ratio\x18\x01 \x01(\x01\x42\x65\n\x19\x63om.google.cloud.tasks.v2B\nQueueProtoP\x01Z:google.golang.org/genproto/googleapis/cloud/tasks/v2;tasksb\x06proto3', dependencies=[ google_dot_api_dot_resource__pb2.DESCRIPTOR, google_dot_cloud_dot_tasks__v2_dot_proto_dot_target__pb2.DESCRIPTOR, @@ -49,6 +43,7 @@ full_name="google.cloud.tasks.v2.Queue.State", filename=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, values=[ _descriptor.EnumValueDescriptor( name="STATE_UNSPECIFIED", @@ -56,15 +51,31 @@ number=0, serialized_options=None, type=None, + create_key=_descriptor._internal_create_key, ), _descriptor.EnumValueDescriptor( - name="RUNNING", index=1, number=1, serialized_options=None, type=None + name="RUNNING", + index=1, + number=1, + serialized_options=None, + type=None, + create_key=_descriptor._internal_create_key, ), _descriptor.EnumValueDescriptor( - name="PAUSED", index=2, number=2, serialized_options=None, type=None + name="PAUSED", + index=2, + number=2, + serialized_options=None, + type=None, + create_key=_descriptor._internal_create_key, ), _descriptor.EnumValueDescriptor( - name="DISABLED", index=3, number=3, serialized_options=None, type=None + name="DISABLED", + index=3, + number=3, + serialized_options=None, + type=None, + create_key=_descriptor._internal_create_key, ), ], containing_type=None, @@ -81,6 +92,7 @@ filename=None, file=DESCRIPTOR, containing_type=None, + create_key=_descriptor._internal_create_key, fields=[ _descriptor.FieldDescriptor( name="name", @@ -91,7 +103,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -99,6 +111,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="app_engine_routing_override", @@ -117,6 +130,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="rate_limits", @@ -135,6 +149,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="retry_config", @@ -153,6 +168,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="state", @@ -171,6 +187,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="purge_time", @@ -189,6 +206,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="stackdriver_logging_config", @@ -207,14 +225,13 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), ], extensions=[], nested_types=[], - enum_types=[_QUEUE_STATE], - serialized_options=_b( - "\352AY\n\037cloudtasks.googleapis.com/Queue\0226projects/{project}/locations/{location}/queues/{queue}" - ), + enum_types=[_QUEUE_STATE,], + serialized_options=b"\352AY\n\037cloudtasks.googleapis.com/Queue\0226projects/{project}/locations/{location}/queues/{queue}", is_extendable=False, syntax="proto3", extension_ranges=[], @@ -230,6 +247,7 @@ filename=None, file=DESCRIPTOR, containing_type=None, + create_key=_descriptor._internal_create_key, fields=[ _descriptor.FieldDescriptor( name="max_dispatches_per_second", @@ -248,6 +266,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="max_burst_size", @@ -266,6 +285,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="max_concurrent_dispatches", @@ -284,6 +304,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), ], extensions=[], @@ -305,6 +326,7 @@ filename=None, file=DESCRIPTOR, containing_type=None, + create_key=_descriptor._internal_create_key, fields=[ _descriptor.FieldDescriptor( name="max_attempts", @@ -323,6 +345,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="max_retry_duration", @@ -341,6 +364,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="min_backoff", @@ -359,6 +383,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="max_backoff", @@ -377,6 +402,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="max_doublings", @@ -395,6 +421,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), ], extensions=[], @@ -416,6 +443,7 @@ filename=None, file=DESCRIPTOR, containing_type=None, + create_key=_descriptor._internal_create_key, fields=[ _descriptor.FieldDescriptor( name="sampling_ratio", @@ -434,7 +462,8 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, - ) + create_key=_descriptor._internal_create_key, + ), ], extensions=[], nested_types=[], @@ -481,12 +510,13 @@ Queue = _reflection.GeneratedProtocolMessageType( "Queue", (_message.Message,), - dict( - DESCRIPTOR=_QUEUE, - __module__="google.cloud.tasks_v2.proto.queue_pb2", - __doc__="""A queue is a container of related tasks. Queues are configured to + { + "DESCRIPTOR": _QUEUE, + "__module__": "google.cloud.tasks_v2.proto.queue_pb2", + "__doc__": """A queue is a container of related tasks. Queues are configured to manage how those tasks are dispatched. Configurable properties include rate limits, retry options, queue types, and others. + Attributes: name: Caller-specified and required in @@ -499,7 +529,7 @@ information, see `Identifying projects `_ - ``LOCATION_ID`` - is the canonical ID for the queue's location. The list of + is the canonical ID for the queue’s location. The list of available locations can be obtained by calling [ListLocatio ns][google.cloud.location.Locations.ListLocations]. For more information, see @@ -507,38 +537,38 @@ contain letters ([A-Za-z]), numbers ([0-9]), or hyphens (-). The maximum length is 100 characters. app_engine_routing_override: - Overrides for [task-level app\_engine\_routing][google.cloud.t - asks.v2.AppEngineHttpRequest.app\_engine\_routing]. These - settings apply only to [App Engine + Overrides for [task-level app_engine_routing][google.cloud.tas + ks.v2.AppEngineHttpRequest.app_engine_routing]. These settings + apply only to [App Engine tasks][google.cloud.tasks.v2.AppEngineHttpRequest] in this queue. [Http tasks][google.cloud.tasks.v2.HttpRequest] are not affected. If set, ``app_engine_routing_override`` is used for all [App Engine tasks][google.cloud.tasks.v2.AppEngineHttpRequest] in the - queue, no matter what the setting is for the [task-level app\_ - engine\_routing][google.cloud.tasks.v2.AppEngineHttpRequest.ap - p\_engine\_routing]. + queue, no matter what the setting is for the [task-level app_e + ngine_routing][google.cloud.tasks.v2.AppEngineHttpRequest.app\_ + engine_routing]. rate_limits: Rate limits for task dispatches. - [rate\_limits][google.cloud.tasks.v2.Queue.rate\_limits] and - [retry\_config][google.cloud.tasks.v2.Queue.retry\_config] are + [rate_limits][google.cloud.tasks.v2.Queue.rate_limits] and + [retry_config][google.cloud.tasks.v2.Queue.retry_config] are related because they both control task attempts. However they control task attempts in different ways: - - [rate\_limits][google.cloud.tasks.v2.Queue.rate\_limits] - controls the total rate of dispatches from a queue (i.e. - all traffic dispatched from the queue, regardless of + [rate_limits][google.cloud.tasks.v2.Queue.rate_limits] + controls the total rate of dispatches from a queue + (i.e. all traffic dispatched from the queue, regardless of whether the dispatch is from a first attempt or a retry). - - [retry\_config][google.cloud.tasks.v2.Queue.retry\_config] + [retry_config][google.cloud.tasks.v2.Queue.retry_config] controls what happens to particular a task after its first attempt fails. That is, - [retry\_config][google.cloud.tasks.v2.Queue.retry\_config] - controls task retries (the second attempt, third attempt, - etc). The queue's actual dispatch rate is the result of: - + [retry_config][google.cloud.tasks.v2.Queue.retry_config] + controls task retries (the second attempt, third attempt, + etc). The queue’s actual dispatch rate is the result of: - Number of tasks in the queue - User-specified throttling: - [rate\_limits][google.cloud.tasks.v2.Queue.rate\_limits], - [retry\_config][google.cloud.tasks.v2.Queue.retry\_config], - and the [queue's state][google.cloud.tasks.v2.Queue.state]. - - System throttling due to ``429`` (Too Many Requests) or + [rate_limits][google.cloud.tasks.v2.Queue.rate_limits], + [retry_config][google.cloud.tasks.v2.Queue.retry_config], and + the [queue’s state][google.cloud.tasks.v2.Queue.state]. - + System throttling due to ``429`` (Too Many Requests) or ``503`` (Service Unavailable) responses from the worker, high error rates, or to smooth sudden large traffic spikes. retry_config: @@ -563,7 +593,7 @@ cannot be used to change ``state``. purge_time: Output only. The last time this queue was purged. All tasks - that were [created][google.cloud.tasks.v2.Task.create\_time] + that were [created][google.cloud.tasks.v2.Task.create_time] before this time were purged. A queue can be purged using [PurgeQueue][google.cloud.tasks.v2.CloudTasks.PurgeQueue], the `App Engine Task Queue SDK, or the Cloud Console `_. Since + `bucket_size `_. Since ``max_burst_size`` is output only, if [UpdateQueue][google.cloud.tasks.v2.CloudTasks.UpdateQueue] is called on a queue created by ``queue.yaml/xml``, - ``max_burst_size`` will be reset based on the value of [max\_d - ispatches\_per\_second][google.cloud.tasks.v2.RateLimits.max\_ - dispatches\_per\_second], regardless of whether [max\_dispatch - es\_per\_second][google.cloud.tasks.v2.RateLimits.max\_dispatc - hes\_per\_second] is updated. + ``max_burst_size`` will be reset based on the value of [max_di + spatches_per_second][google.cloud.tasks.v2.RateLimits.max_disp + atches_per_second], regardless of whether [max_dispatches_per\_ + second][google.cloud.tasks.v2.RateLimits.max_dispatches_per_se + cond] is updated. max_concurrent_dispatches: The maximum number of concurrent tasks that Cloud Tasks allows to be dispatched for this queue. After this threshold has been @@ -638,23 +669,24 @@ of concurrent requests decreases. If unspecified when the queue is created, Cloud Tasks will pick the default. The maximum allowed value is 5,000. This field has the same - meaning as `max\_concurrent\_requests in queue.yaml/xml `_. + meaning as `max_concurrent_requests in queue.yaml/xml `_. """, # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2.RateLimits) - ), + }, ) _sym_db.RegisterMessage(RateLimits) RetryConfig = _reflection.GeneratedProtocolMessageType( "RetryConfig", (_message.Message,), - dict( - DESCRIPTOR=_RETRYCONFIG, - __module__="google.cloud.tasks_v2.proto.queue_pb2", - __doc__="""Retry config. These settings determine when a failed task attempt is + { + "DESCRIPTOR": _RETRYCONFIG, + "__module__": "google.cloud.tasks_v2.proto.queue_pb2", + "__doc__": """Retry config. These settings determine when a failed task attempt is retried. + Attributes: max_attempts: Number of attempts per task. Cloud Tasks will attempt the @@ -662,90 +694,93 @@ fails, then there will be ``max_attempts - 1`` retries). Must be >= -1. If unspecified when the queue is created, Cloud Tasks will pick the default. -1 indicates unlimited attempts. - This field has the same meaning as `task\_retry\_limit in + This field has the same meaning as `task_retry_limit in queue.yaml/xml `_. max_retry_duration: If positive, ``max_retry_duration`` specifies the time limit for retrying a failed task, measured from when the task was first attempted. Once ``max_retry_duration`` time has passed - *and* the task has been attempted [max\_attempts][google.cloud - .tasks.v2.RetryConfig.max\_attempts] times, no further - attempts will be made and the task will be deleted. If zero, - then the task age is unlimited. If unspecified when the queue - is created, Cloud Tasks will pick the default. - ``max_retry_duration`` will be truncated to the nearest - second. This field has the same meaning as `task\_age\_limit - in queue.yaml/xml `_. + *and* the task has been attempted + [max_attempts][google.cloud.tasks.v2.RetryConfig.max_attempts] + times, no further attempts will be made and the task will be + deleted. If zero, then the task age is unlimited. If + unspecified when the queue is created, Cloud Tasks will pick + the default. ``max_retry_duration`` will be truncated to the + nearest second. This field has the same meaning as + `task_age_limit in queue.yaml/xml `__. min_backoff: A task will be - [scheduled][google.cloud.tasks.v2.Task.schedule\_time] for + [scheduled][google.cloud.tasks.v2.Task.schedule_time] for retry between - [min\_backoff][google.cloud.tasks.v2.RetryConfig.min\_backoff] + [min_backoff][google.cloud.tasks.v2.RetryConfig.min_backoff] and - [max\_backoff][google.cloud.tasks.v2.RetryConfig.max\_backoff] - duration after it fails, if the queue's + [max_backoff][google.cloud.tasks.v2.RetryConfig.max_backoff] + duration after it fails, if the queue’s [RetryConfig][google.cloud.tasks.v2.RetryConfig] specifies that the task should be retried. If unspecified when the queue is created, Cloud Tasks will pick the default. ``min_backoff`` will be truncated to the nearest second. This - field has the same meaning as `min\_backoff\_seconds in + field has the same meaning as `min_backoff_seconds in queue.yaml/xml `_. max_backoff: A task will be - [scheduled][google.cloud.tasks.v2.Task.schedule\_time] for + [scheduled][google.cloud.tasks.v2.Task.schedule_time] for retry between - [min\_backoff][google.cloud.tasks.v2.RetryConfig.min\_backoff] + [min_backoff][google.cloud.tasks.v2.RetryConfig.min_backoff] and - [max\_backoff][google.cloud.tasks.v2.RetryConfig.max\_backoff] - duration after it fails, if the queue's + [max_backoff][google.cloud.tasks.v2.RetryConfig.max_backoff] + duration after it fails, if the queue’s [RetryConfig][google.cloud.tasks.v2.RetryConfig] specifies that the task should be retried. If unspecified when the queue is created, Cloud Tasks will pick the default. ``max_backoff`` will be truncated to the nearest second. This - field has the same meaning as `max\_backoff\_seconds in + field has the same meaning as `max_backoff_seconds in queue.yaml/xml `_. max_doublings: The time between retries will double ``max_doublings`` times. - A task's retry interval starts at [min\_backoff][google.cloud. - tasks.v2.RetryConfig.min\_backoff], then doubles - ``max_doublings`` times, then increases linearly, and finally - retries retries at intervals of - [max\_backoff][google.cloud.tasks.v2.RetryConfig.max\_backoff] - up to [max\_attempts][google.cloud.tasks.v2.RetryConfig.max\_a - ttempts] times. For example, if - [min\_backoff][google.cloud.tasks.v2.RetryConfig.min\_backoff] + A task’s retry interval starts at + [min_backoff][google.cloud.tasks.v2.RetryConfig.min_backoff], + then doubles ``max_doublings`` times, then increases linearly, + and finally retries retries at intervals of + [max_backoff][google.cloud.tasks.v2.RetryConfig.max_backoff] + up to + [max_attempts][google.cloud.tasks.v2.RetryConfig.max_attempts] + times. For example, if + [min_backoff][google.cloud.tasks.v2.RetryConfig.min_backoff] is 10s, - [max\_backoff][google.cloud.tasks.v2.RetryConfig.max\_backoff] + [max_backoff][google.cloud.tasks.v2.RetryConfig.max_backoff] is 300s, and ``max_doublings`` is 3, then the a task will first be retried in 10s. The retry interval will double three times, and then increase linearly by 2^3 \* 10s. Finally, the task will retry at intervals of - [max\_backoff][google.cloud.tasks.v2.RetryConfig.max\_backoff] - until the task has been attempted [max\_attempts][google.cloud - .tasks.v2.RetryConfig.max\_attempts] times. Thus, the requests - will retry at 10s, 20s, 40s, 80s, 160s, 240s, 300s, 300s, .... - If unspecified when the queue is created, Cloud Tasks will - pick the default. This field has the same meaning as - `max\_doublings in queue.yaml/xml `__. + [max_backoff][google.cloud.tasks.v2.RetryConfig.max_backoff] + until the task has been attempted + [max_attempts][google.cloud.tasks.v2.RetryConfig.max_attempts] + times. Thus, the requests will retry at 10s, 20s, 40s, 80s, + 160s, 240s, 300s, 300s, …. If unspecified when the queue is + created, Cloud Tasks will pick the default. This field has + the same meaning as `max_doublings in queue.yaml/xml `_. """, # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2.RetryConfig) - ), + }, ) _sym_db.RegisterMessage(RetryConfig) StackdriverLoggingConfig = _reflection.GeneratedProtocolMessageType( "StackdriverLoggingConfig", (_message.Message,), - dict( - DESCRIPTOR=_STACKDRIVERLOGGINGCONFIG, - __module__="google.cloud.tasks_v2.proto.queue_pb2", - __doc__="""Configuration options for writing logs to `Stackdriver Logging + { + "DESCRIPTOR": _STACKDRIVERLOGGINGCONFIG, + "__module__": "google.cloud.tasks_v2.proto.queue_pb2", + "__doc__": """Configuration options for writing logs to `Stackdriver Logging `_. + Attributes: sampling_ratio: Specifies the fraction of operations to write to `Stackdriver @@ -754,7 +789,7 @@ 0.0 is the default and means that no operations are logged. """, # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2.StackdriverLoggingConfig) - ), + }, ) _sym_db.RegisterMessage(StackdriverLoggingConfig) diff --git a/google/cloud/tasks_v2/proto/queue_pb2_grpc.py b/google/cloud/tasks_v2/proto/queue_pb2_grpc.py index 07cb78fe..8a939394 100644 --- a/google/cloud/tasks_v2/proto/queue_pb2_grpc.py +++ b/google/cloud/tasks_v2/proto/queue_pb2_grpc.py @@ -1,2 +1,3 @@ # Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT! +"""Client and server classes corresponding to protobuf-defined services.""" import grpc diff --git a/google/cloud/tasks_v2/proto/target_pb2.py b/google/cloud/tasks_v2/proto/target_pb2.py index 1ae54401..a890c3d6 100644 --- a/google/cloud/tasks_v2/proto/target_pb2.py +++ b/google/cloud/tasks_v2/proto/target_pb2.py @@ -1,10 +1,7 @@ # -*- coding: utf-8 -*- # Generated by the protocol buffer compiler. DO NOT EDIT! # source: google/cloud/tasks_v2/proto/target.proto - -import sys - -_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1")) +"""Generated protocol buffer code.""" from google.protobuf.internal import enum_type_wrapper from google.protobuf import descriptor as _descriptor from google.protobuf import message as _message @@ -24,12 +21,9 @@ name="google/cloud/tasks_v2/proto/target.proto", package="google.cloud.tasks.v2", syntax="proto3", - serialized_options=_b( - "\n\031com.google.cloud.tasks.v2B\013TargetProtoP\001Z:google.golang.org/genproto/googleapis/cloud/tasks/v2;tasks" - ), - serialized_pb=_b( - '\n(google/cloud/tasks_v2/proto/target.proto\x12\x15google.cloud.tasks.v2\x1a\x1fgoogle/api/field_behavior.proto\x1a\x1cgoogle/api/annotations.proto"\xe1\x02\n\x0bHttpRequest\x12\x10\n\x03url\x18\x01 \x01(\tB\x03\xe0\x41\x02\x12\x36\n\x0bhttp_method\x18\x02 \x01(\x0e\x32!.google.cloud.tasks.v2.HttpMethod\x12@\n\x07headers\x18\x03 \x03(\x0b\x32/.google.cloud.tasks.v2.HttpRequest.HeadersEntry\x12\x0c\n\x04\x62ody\x18\x04 \x01(\x0c\x12\x38\n\x0boauth_token\x18\x05 \x01(\x0b\x32!.google.cloud.tasks.v2.OAuthTokenH\x00\x12\x36\n\noidc_token\x18\x06 \x01(\x0b\x32 .google.cloud.tasks.v2.OidcTokenH\x00\x1a.\n\x0cHeadersEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\x42\x16\n\x14\x61uthorization_header"\xb2\x02\n\x14\x41ppEngineHttpRequest\x12\x36\n\x0bhttp_method\x18\x01 \x01(\x0e\x32!.google.cloud.tasks.v2.HttpMethod\x12\x43\n\x12\x61pp_engine_routing\x18\x02 \x01(\x0b\x32\'.google.cloud.tasks.v2.AppEngineRouting\x12\x14\n\x0crelative_uri\x18\x03 \x01(\t\x12I\n\x07headers\x18\x04 \x03(\x0b\x32\x38.google.cloud.tasks.v2.AppEngineHttpRequest.HeadersEntry\x12\x0c\n\x04\x62ody\x18\x05 \x01(\x0c\x1a.\n\x0cHeadersEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01"T\n\x10\x41ppEngineRouting\x12\x0f\n\x07service\x18\x01 \x01(\t\x12\x0f\n\x07version\x18\x02 \x01(\t\x12\x10\n\x08instance\x18\x03 \x01(\t\x12\x0c\n\x04host\x18\x04 \x01(\t":\n\nOAuthToken\x12\x1d\n\x15service_account_email\x18\x01 \x01(\t\x12\r\n\x05scope\x18\x02 \x01(\t"<\n\tOidcToken\x12\x1d\n\x15service_account_email\x18\x01 \x01(\t\x12\x10\n\x08\x61udience\x18\x02 \x01(\t*s\n\nHttpMethod\x12\x1b\n\x17HTTP_METHOD_UNSPECIFIED\x10\x00\x12\x08\n\x04POST\x10\x01\x12\x07\n\x03GET\x10\x02\x12\x08\n\x04HEAD\x10\x03\x12\x07\n\x03PUT\x10\x04\x12\n\n\x06\x44\x45LETE\x10\x05\x12\t\n\x05PATCH\x10\x06\x12\x0b\n\x07OPTIONS\x10\x07\x42\x66\n\x19\x63om.google.cloud.tasks.v2B\x0bTargetProtoP\x01Z:google.golang.org/genproto/googleapis/cloud/tasks/v2;tasksb\x06proto3' - ), + serialized_options=b"\n\031com.google.cloud.tasks.v2B\013TargetProtoP\001Z:google.golang.org/genproto/googleapis/cloud/tasks/v2;tasks", + create_key=_descriptor._internal_create_key, + serialized_pb=b'\n(google/cloud/tasks_v2/proto/target.proto\x12\x15google.cloud.tasks.v2\x1a\x1fgoogle/api/field_behavior.proto\x1a\x1cgoogle/api/annotations.proto"\xe1\x02\n\x0bHttpRequest\x12\x10\n\x03url\x18\x01 \x01(\tB\x03\xe0\x41\x02\x12\x36\n\x0bhttp_method\x18\x02 \x01(\x0e\x32!.google.cloud.tasks.v2.HttpMethod\x12@\n\x07headers\x18\x03 \x03(\x0b\x32/.google.cloud.tasks.v2.HttpRequest.HeadersEntry\x12\x0c\n\x04\x62ody\x18\x04 \x01(\x0c\x12\x38\n\x0boauth_token\x18\x05 \x01(\x0b\x32!.google.cloud.tasks.v2.OAuthTokenH\x00\x12\x36\n\noidc_token\x18\x06 \x01(\x0b\x32 .google.cloud.tasks.v2.OidcTokenH\x00\x1a.\n\x0cHeadersEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\x42\x16\n\x14\x61uthorization_header"\xb2\x02\n\x14\x41ppEngineHttpRequest\x12\x36\n\x0bhttp_method\x18\x01 \x01(\x0e\x32!.google.cloud.tasks.v2.HttpMethod\x12\x43\n\x12\x61pp_engine_routing\x18\x02 \x01(\x0b\x32\'.google.cloud.tasks.v2.AppEngineRouting\x12\x14\n\x0crelative_uri\x18\x03 \x01(\t\x12I\n\x07headers\x18\x04 \x03(\x0b\x32\x38.google.cloud.tasks.v2.AppEngineHttpRequest.HeadersEntry\x12\x0c\n\x04\x62ody\x18\x05 \x01(\x0c\x1a.\n\x0cHeadersEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01"T\n\x10\x41ppEngineRouting\x12\x0f\n\x07service\x18\x01 \x01(\t\x12\x0f\n\x07version\x18\x02 \x01(\t\x12\x10\n\x08instance\x18\x03 \x01(\t\x12\x0c\n\x04host\x18\x04 \x01(\t":\n\nOAuthToken\x12\x1d\n\x15service_account_email\x18\x01 \x01(\t\x12\r\n\x05scope\x18\x02 \x01(\t"<\n\tOidcToken\x12\x1d\n\x15service_account_email\x18\x01 \x01(\t\x12\x10\n\x08\x61udience\x18\x02 \x01(\t*s\n\nHttpMethod\x12\x1b\n\x17HTTP_METHOD_UNSPECIFIED\x10\x00\x12\x08\n\x04POST\x10\x01\x12\x07\n\x03GET\x10\x02\x12\x08\n\x04HEAD\x10\x03\x12\x07\n\x03PUT\x10\x04\x12\n\n\x06\x44\x45LETE\x10\x05\x12\t\n\x05PATCH\x10\x06\x12\x0b\n\x07OPTIONS\x10\x07\x42\x66\n\x19\x63om.google.cloud.tasks.v2B\x0bTargetProtoP\x01Z:google.golang.org/genproto/googleapis/cloud/tasks/v2;tasksb\x06proto3', dependencies=[ google_dot_api_dot_field__behavior__pb2.DESCRIPTOR, google_dot_api_dot_annotations__pb2.DESCRIPTOR, @@ -41,6 +35,7 @@ full_name="google.cloud.tasks.v2.HttpMethod", filename=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, values=[ _descriptor.EnumValueDescriptor( name="HTTP_METHOD_UNSPECIFIED", @@ -48,27 +43,63 @@ number=0, serialized_options=None, type=None, + create_key=_descriptor._internal_create_key, ), _descriptor.EnumValueDescriptor( - name="POST", index=1, number=1, serialized_options=None, type=None + name="POST", + index=1, + number=1, + serialized_options=None, + type=None, + create_key=_descriptor._internal_create_key, ), _descriptor.EnumValueDescriptor( - name="GET", index=2, number=2, serialized_options=None, type=None + name="GET", + index=2, + number=2, + serialized_options=None, + type=None, + create_key=_descriptor._internal_create_key, ), _descriptor.EnumValueDescriptor( - name="HEAD", index=3, number=3, serialized_options=None, type=None + name="HEAD", + index=3, + number=3, + serialized_options=None, + type=None, + create_key=_descriptor._internal_create_key, ), _descriptor.EnumValueDescriptor( - name="PUT", index=4, number=4, serialized_options=None, type=None + name="PUT", + index=4, + number=4, + serialized_options=None, + type=None, + create_key=_descriptor._internal_create_key, ), _descriptor.EnumValueDescriptor( - name="DELETE", index=5, number=5, serialized_options=None, type=None + name="DELETE", + index=5, + number=5, + serialized_options=None, + type=None, + create_key=_descriptor._internal_create_key, ), _descriptor.EnumValueDescriptor( - name="PATCH", index=6, number=6, serialized_options=None, type=None + name="PATCH", + index=6, + number=6, + serialized_options=None, + type=None, + create_key=_descriptor._internal_create_key, ), _descriptor.EnumValueDescriptor( - name="OPTIONS", index=7, number=7, serialized_options=None, type=None + name="OPTIONS", + index=7, + number=7, + serialized_options=None, + type=None, + create_key=_descriptor._internal_create_key, ), ], containing_type=None, @@ -95,6 +126,7 @@ filename=None, file=DESCRIPTOR, containing_type=None, + create_key=_descriptor._internal_create_key, fields=[ _descriptor.FieldDescriptor( name="key", @@ -105,7 +137,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -113,6 +145,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="value", @@ -123,7 +156,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -131,12 +164,13 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), ], extensions=[], nested_types=[], enum_types=[], - serialized_options=_b("8\001"), + serialized_options=b"8\001", is_extendable=False, syntax="proto3", extension_ranges=[], @@ -151,6 +185,7 @@ filename=None, file=DESCRIPTOR, containing_type=None, + create_key=_descriptor._internal_create_key, fields=[ _descriptor.FieldDescriptor( name="url", @@ -161,14 +196,15 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b("\340A\002"), + serialized_options=b"\340A\002", file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="http_method", @@ -187,6 +223,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="headers", @@ -205,6 +242,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="body", @@ -215,7 +253,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b(""), + default_value=b"", message_type=None, enum_type=None, containing_type=None, @@ -223,6 +261,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="oauth_token", @@ -241,6 +280,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="oidc_token", @@ -259,10 +299,11 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), ], extensions=[], - nested_types=[_HTTPREQUEST_HEADERSENTRY], + nested_types=[_HTTPREQUEST_HEADERSENTRY,], enum_types=[], serialized_options=None, is_extendable=False, @@ -274,8 +315,9 @@ full_name="google.cloud.tasks.v2.HttpRequest.authorization_header", index=0, containing_type=None, + create_key=_descriptor._internal_create_key, fields=[], - ) + ), ], serialized_start=131, serialized_end=484, @@ -288,6 +330,7 @@ filename=None, file=DESCRIPTOR, containing_type=None, + create_key=_descriptor._internal_create_key, fields=[ _descriptor.FieldDescriptor( name="key", @@ -298,7 +341,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -306,6 +349,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="value", @@ -316,7 +360,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -324,12 +368,13 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), ], extensions=[], nested_types=[], enum_types=[], - serialized_options=_b("8\001"), + serialized_options=b"8\001", is_extendable=False, syntax="proto3", extension_ranges=[], @@ -344,6 +389,7 @@ filename=None, file=DESCRIPTOR, containing_type=None, + create_key=_descriptor._internal_create_key, fields=[ _descriptor.FieldDescriptor( name="http_method", @@ -362,6 +408,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="app_engine_routing", @@ -380,6 +427,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="relative_uri", @@ -390,7 +438,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -398,6 +446,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="headers", @@ -416,6 +465,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="body", @@ -426,7 +476,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b(""), + default_value=b"", message_type=None, enum_type=None, containing_type=None, @@ -434,10 +484,11 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), ], extensions=[], - nested_types=[_APPENGINEHTTPREQUEST_HEADERSENTRY], + nested_types=[_APPENGINEHTTPREQUEST_HEADERSENTRY,], enum_types=[], serialized_options=None, is_extendable=False, @@ -455,6 +506,7 @@ filename=None, file=DESCRIPTOR, containing_type=None, + create_key=_descriptor._internal_create_key, fields=[ _descriptor.FieldDescriptor( name="service", @@ -465,7 +517,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -473,6 +525,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="version", @@ -483,7 +536,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -491,6 +544,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="instance", @@ -501,7 +555,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -509,6 +563,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="host", @@ -519,7 +574,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -527,6 +582,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), ], extensions=[], @@ -548,6 +604,7 @@ filename=None, file=DESCRIPTOR, containing_type=None, + create_key=_descriptor._internal_create_key, fields=[ _descriptor.FieldDescriptor( name="service_account_email", @@ -558,7 +615,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -566,6 +623,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="scope", @@ -576,7 +634,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -584,6 +642,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), ], extensions=[], @@ -605,6 +664,7 @@ filename=None, file=DESCRIPTOR, containing_type=None, + create_key=_descriptor._internal_create_key, fields=[ _descriptor.FieldDescriptor( name="service_account_email", @@ -615,7 +675,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -623,6 +683,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="audience", @@ -633,7 +694,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -641,6 +702,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), ], extensions=[], @@ -691,32 +753,32 @@ HttpRequest = _reflection.GeneratedProtocolMessageType( "HttpRequest", (_message.Message,), - dict( - HeadersEntry=_reflection.GeneratedProtocolMessageType( + { + "HeadersEntry": _reflection.GeneratedProtocolMessageType( "HeadersEntry", (_message.Message,), - dict( - DESCRIPTOR=_HTTPREQUEST_HEADERSENTRY, - __module__="google.cloud.tasks_v2.proto.target_pb2" + { + "DESCRIPTOR": _HTTPREQUEST_HEADERSENTRY, + "__module__": "google.cloud.tasks_v2.proto.target_pb2" # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2.HttpRequest.HeadersEntry) - ), + }, ), - DESCRIPTOR=_HTTPREQUEST, - __module__="google.cloud.tasks_v2.proto.target_pb2", - __doc__="""HTTP request. The task will be pushed to the worker as an HTTP + "DESCRIPTOR": _HTTPREQUEST, + "__module__": "google.cloud.tasks_v2.proto.target_pb2", + "__doc__": """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 + 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 + 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 + 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`` @@ -726,10 +788,11 @@ 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). + Attributes: url: Required. The full url path that the request will be sent to. - This string must begin with either "http://" or "https://". + This string must begin with either “http://” or “https://”. Some examples are: ``http://acme.com`` and ``https://acme.com/sales:8080``. Cloud Tasks will encode some characters for safety and compatibility. The maximum allowed @@ -744,15 +807,15 @@ names and values. Headers can be set when the [task is created][google.cloud.tasks.v2beta3.CloudTasks.CreateTask]. These headers represent a subset of the headers that will - accompany the task's HTTP request. Some HTTP request headers + accompany the task’s HTTP request. Some HTTP request headers will be ignored or replaced. A partial list of headers that will be ignored or replaced is: - Host: This will be computed by Cloud Tasks and derived from [HttpRequest.url][google.cloud.tasks.v2.HttpRequest.url]. - Content-Length: This will be computed by Cloud Tasks. - User- Agent: This will be set to ``"Google-Cloud-Tasks"``. - - X-Google-\*: Google use only. - X-AppEngine-\*: Google use - only. ``Content-Type`` won't be set by Cloud Tasks. You can + X-Google-*: Google use only. - X-AppEngine-*: Google use + only. ``Content-Type`` won’t be set by Cloud Tasks. You can explicitly set ``Content-Type`` to a media type when the [task is created][google.cloud.tasks.v2beta3.CloudTasks.CreateTask]. For example, ``Content-Type`` can be set to @@ -762,7 +825,7 @@ the headers must be less than 80KB. body: HTTP request body. A request body is allowed only if the - [HTTP method][google.cloud.tasks.v2.HttpRequest.http\_method] + [HTTP method][google.cloud.tasks.v2.HttpRequest.http_method] is POST, PUT, or PATCH. It is an error to set body on a task with an incompatible [HttpMethod][google.cloud.tasks.v2.HttpMethod]. @@ -773,7 +836,7 @@ s] field will be overridden. oauth_token: If specified, an `OAuth token - `_ + `\_ will be generated and attached as an ``Authorization`` header in the HTTP request. This type of authorization should generally only be used when calling Google APIs hosted on @@ -787,7 +850,7 @@ validate the token yourself. """, # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2.HttpRequest) - ), + }, ) _sym_db.RegisterMessage(HttpRequest) _sym_db.RegisterMessage(HttpRequest.HeadersEntry) @@ -795,23 +858,23 @@ AppEngineHttpRequest = _reflection.GeneratedProtocolMessageType( "AppEngineHttpRequest", (_message.Message,), - dict( - HeadersEntry=_reflection.GeneratedProtocolMessageType( + { + "HeadersEntry": _reflection.GeneratedProtocolMessageType( "HeadersEntry", (_message.Message,), - dict( - DESCRIPTOR=_APPENGINEHTTPREQUEST_HEADERSENTRY, - __module__="google.cloud.tasks_v2.proto.target_pb2" + { + "DESCRIPTOR": _APPENGINEHTTPREQUEST_HEADERSENTRY, + "__module__": "google.cloud.tasks_v2.proto.target_pb2" # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2.AppEngineHttpRequest.HeadersEntry) - ), + }, ), - DESCRIPTOR=_APPENGINEHTTPREQUEST, - __module__="google.cloud.tasks_v2.proto.target_pb2", - __doc__="""App Engine HTTP request. The message defines the HTTP request that is + "DESCRIPTOR": _APPENGINEHTTPREQUEST, + "__module__": "google.cloud.tasks_v2.proto.target_pb2", + "__doc__": """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`` - `_ + `\_ 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 @@ -826,38 +889,39 @@ 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 + 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`` `_. Because tasks are not - run as any user, they cannot be dispatched to URIs restricted with + _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`` `_. 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 + 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 + ``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 + 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`` + 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 + 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. + Attributes: http_method: The HTTP method to use for the request. The default is POST. - The app's request handler for the task's target URL must be - able to handle HTTP requests with this http\_method, otherwise + The app’s request handler for the task’s target URL must be + able to handle HTTP requests with this http_method, otherwise the task attempt will fail with error code 405 (Method Not Allowed). See `Writing a push task request handler `_. app_engine_routing: Task-level setting for App Engine routing. - 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][AppEngineHt - tpRequest.app\_engine\_routing]. + [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]. relative_uri: - The relative URI. The relative URI must begin with "/" and + The relative URI. The relative URI must begin with “/” and must be a valid HTTP relative URI. It can contain a path and query string arguments. If the relative URI is empty, then the - root path "/" will be used. No spaces are allowed, and the + root path “/” will be used. No spaces are allowed, and the maximum length allowed is 2083 characters. headers: HTTP request headers. This map contains the header field @@ -921,7 +985,7 @@ [HttpMethod][google.cloud.tasks.v2.HttpMethod]. """, # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2.AppEngineHttpRequest) - ), + }, ) _sym_db.RegisterMessage(AppEngineHttpRequest) _sym_db.RegisterMessage(AppEngineHttpRequest.HeadersEntry) @@ -929,10 +993,10 @@ AppEngineRouting = _reflection.GeneratedProtocolMessageType( "AppEngineRouting", (_message.Message,), - dict( - DESCRIPTOR=_APPENGINEROUTING, - __module__="google.cloud.tasks_v2.proto.target_pb2", - __doc__="""App Engine Routing. Defines routing characteristics specific to App + { + "DESCRIPTOR": _APPENGINEROUTING, + "__module__": "google.cloud.tasks_v2.proto.target_pb2", + "__doc__": """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 `_. Using [AppEngineRouting][google.cloud.tasks.v2.AppEngineRouting] requires ```appengine.applications.get`` - `_ + `\_ Google IAM permission for the project and the following scope: ``https://www.googleapis.com/auth/cloud-platform`` + Attributes: service: App service. By default, the task is sent to the service @@ -1003,7 +1068,7 @@ host: Output only. The host that the task is sent to. The host is constructed from the domain name of the app associated with - the queue's project ID (for example .appspot.com), and the + the queue’s project ID (for example .appspot.com), and the [service][google.cloud.tasks.v2.AppEngineRouting.service], [version][google.cloud.tasks.v2.AppEngineRouting.version], and [instance][google.cloud.tasks.v2.AppEngineRouting.instance]. @@ -1014,20 +1079,21 @@ requests-are-routed>`_. """, # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2.AppEngineRouting) - ), + }, ) _sym_db.RegisterMessage(AppEngineRouting) OAuthToken = _reflection.GeneratedProtocolMessageType( "OAuthToken", (_message.Message,), - dict( - DESCRIPTOR=_OAUTHTOKEN, - __module__="google.cloud.tasks_v2.proto.target_pb2", - __doc__="""Contains information needed for generating an `OAuth token + { + "DESCRIPTOR": _OAUTHTOKEN, + "__module__": "google.cloud.tasks_v2.proto.target_pb2", + "__doc__": """Contains information needed for generating an `OAuth token `_. This type of authorization should generally only be used when calling Google APIs hosted on \*.googleapis.com. + Attributes: service_account_email: \ `Service account email @@ -1037,25 +1103,26 @@ iam.serviceAccounts.actAs permission for the service account. scope: OAuth scope to be used for generating OAuth access token. If - not specified, "https://www.googleapis.com/auth/cloud- - platform" will be used. + not specified, “https://www.googleapis.com/auth/cloud- + platform” will be used. """, # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2.OAuthToken) - ), + }, ) _sym_db.RegisterMessage(OAuthToken) OidcToken = _reflection.GeneratedProtocolMessageType( "OidcToken", (_message.Message,), - dict( - DESCRIPTOR=_OIDCTOKEN, - __module__="google.cloud.tasks_v2.proto.target_pb2", - __doc__="""Contains information needed for generating an `OpenID Connect token + { + "DESCRIPTOR": _OIDCTOKEN, + "__module__": "google.cloud.tasks_v2.proto.target_pb2", + "__doc__": """Contains information needed for generating an `OpenID Connect token `_. This type of authorization can be used for many scenarios, including calling Cloud Run, or endpoints where you intend to validate the token yourself. + Attributes: service_account_email: \ `Service account email @@ -1068,7 +1135,7 @@ specified, the URI specified in target will be used. """, # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2.OidcToken) - ), + }, ) _sym_db.RegisterMessage(OidcToken) diff --git a/google/cloud/tasks_v2/proto/target_pb2_grpc.py b/google/cloud/tasks_v2/proto/target_pb2_grpc.py index 07cb78fe..8a939394 100644 --- a/google/cloud/tasks_v2/proto/target_pb2_grpc.py +++ b/google/cloud/tasks_v2/proto/target_pb2_grpc.py @@ -1,2 +1,3 @@ # Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT! +"""Client and server classes corresponding to protobuf-defined services.""" import grpc diff --git a/google/cloud/tasks_v2/proto/task_pb2.py b/google/cloud/tasks_v2/proto/task_pb2.py index 6235f3da..fcf78524 100644 --- a/google/cloud/tasks_v2/proto/task_pb2.py +++ b/google/cloud/tasks_v2/proto/task_pb2.py @@ -1,10 +1,7 @@ # -*- coding: utf-8 -*- # Generated by the protocol buffer compiler. DO NOT EDIT! # source: google/cloud/tasks_v2/proto/task.proto - -import sys - -_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1")) +"""Generated protocol buffer code.""" from google.protobuf import descriptor as _descriptor from google.protobuf import message as _message from google.protobuf import reflection as _reflection @@ -29,12 +26,9 @@ name="google/cloud/tasks_v2/proto/task.proto", package="google.cloud.tasks.v2", syntax="proto3", - serialized_options=_b( - "\n\031com.google.cloud.tasks.v2B\tTaskProtoP\001Z:google.golang.org/genproto/googleapis/cloud/tasks/v2;tasks" - ), - serialized_pb=_b( - '\n&google/cloud/tasks_v2/proto/task.proto\x12\x15google.cloud.tasks.v2\x1a\x19google/api/resource.proto\x1a(google/cloud/tasks_v2/proto/target.proto\x1a\x1egoogle/protobuf/duration.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x17google/rpc/status.proto\x1a\x1cgoogle/api/annotations.proto"\xb4\x05\n\x04Task\x12\x0c\n\x04name\x18\x01 \x01(\t\x12N\n\x17\x61pp_engine_http_request\x18\x02 \x01(\x0b\x32+.google.cloud.tasks.v2.AppEngineHttpRequestH\x00\x12:\n\x0chttp_request\x18\x03 \x01(\x0b\x32".google.cloud.tasks.v2.HttpRequestH\x00\x12\x31\n\rschedule_time\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12/\n\x0b\x63reate_time\x18\x05 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x34\n\x11\x64ispatch_deadline\x18\x06 \x01(\x0b\x32\x19.google.protobuf.Duration\x12\x16\n\x0e\x64ispatch_count\x18\x07 \x01(\x05\x12\x16\n\x0eresponse_count\x18\x08 \x01(\x05\x12\x35\n\rfirst_attempt\x18\t \x01(\x0b\x32\x1e.google.cloud.tasks.v2.Attempt\x12\x34\n\x0clast_attempt\x18\n \x01(\x0b\x32\x1e.google.cloud.tasks.v2.Attempt\x12.\n\x04view\x18\x0b \x01(\x0e\x32 .google.cloud.tasks.v2.Task.View"1\n\x04View\x12\x14\n\x10VIEW_UNSPECIFIED\x10\x00\x12\t\n\x05\x42\x41SIC\x10\x01\x12\x08\n\x04\x46ULL\x10\x02:h\xea\x41\x65\n\x1e\x63loudtasks.googleapis.com/Task\x12\x43projects/{project}/locations/{location}/queues/{queue}/tasks/{task}B\x0e\n\x0cmessage_type"\xcf\x01\n\x07\x41ttempt\x12\x31\n\rschedule_time\x18\x01 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x31\n\rdispatch_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x31\n\rresponse_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12+\n\x0fresponse_status\x18\x04 \x01(\x0b\x32\x12.google.rpc.StatusBd\n\x19\x63om.google.cloud.tasks.v2B\tTaskProtoP\x01Z:google.golang.org/genproto/googleapis/cloud/tasks/v2;tasksb\x06proto3' - ), + serialized_options=b"\n\031com.google.cloud.tasks.v2B\tTaskProtoP\001Z:google.golang.org/genproto/googleapis/cloud/tasks/v2;tasks", + create_key=_descriptor._internal_create_key, + serialized_pb=b'\n&google/cloud/tasks_v2/proto/task.proto\x12\x15google.cloud.tasks.v2\x1a\x19google/api/resource.proto\x1a(google/cloud/tasks_v2/proto/target.proto\x1a\x1egoogle/protobuf/duration.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x17google/rpc/status.proto\x1a\x1cgoogle/api/annotations.proto"\xb4\x05\n\x04Task\x12\x0c\n\x04name\x18\x01 \x01(\t\x12N\n\x17\x61pp_engine_http_request\x18\x02 \x01(\x0b\x32+.google.cloud.tasks.v2.AppEngineHttpRequestH\x00\x12:\n\x0chttp_request\x18\x03 \x01(\x0b\x32".google.cloud.tasks.v2.HttpRequestH\x00\x12\x31\n\rschedule_time\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12/\n\x0b\x63reate_time\x18\x05 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x34\n\x11\x64ispatch_deadline\x18\x06 \x01(\x0b\x32\x19.google.protobuf.Duration\x12\x16\n\x0e\x64ispatch_count\x18\x07 \x01(\x05\x12\x16\n\x0eresponse_count\x18\x08 \x01(\x05\x12\x35\n\rfirst_attempt\x18\t \x01(\x0b\x32\x1e.google.cloud.tasks.v2.Attempt\x12\x34\n\x0clast_attempt\x18\n \x01(\x0b\x32\x1e.google.cloud.tasks.v2.Attempt\x12.\n\x04view\x18\x0b \x01(\x0e\x32 .google.cloud.tasks.v2.Task.View"1\n\x04View\x12\x14\n\x10VIEW_UNSPECIFIED\x10\x00\x12\t\n\x05\x42\x41SIC\x10\x01\x12\x08\n\x04\x46ULL\x10\x02:h\xea\x41\x65\n\x1e\x63loudtasks.googleapis.com/Task\x12\x43projects/{project}/locations/{location}/queues/{queue}/tasks/{task}B\x0e\n\x0cmessage_type"\xcf\x01\n\x07\x41ttempt\x12\x31\n\rschedule_time\x18\x01 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x31\n\rdispatch_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x31\n\rresponse_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12+\n\x0fresponse_status\x18\x04 \x01(\x0b\x32\x12.google.rpc.StatusBd\n\x19\x63om.google.cloud.tasks.v2B\tTaskProtoP\x01Z:google.golang.org/genproto/googleapis/cloud/tasks/v2;tasksb\x06proto3', dependencies=[ google_dot_api_dot_resource__pb2.DESCRIPTOR, google_dot_cloud_dot_tasks__v2_dot_proto_dot_target__pb2.DESCRIPTOR, @@ -51,6 +45,7 @@ full_name="google.cloud.tasks.v2.Task.View", filename=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, values=[ _descriptor.EnumValueDescriptor( name="VIEW_UNSPECIFIED", @@ -58,12 +53,23 @@ number=0, serialized_options=None, type=None, + create_key=_descriptor._internal_create_key, ), _descriptor.EnumValueDescriptor( - name="BASIC", index=1, number=1, serialized_options=None, type=None + name="BASIC", + index=1, + number=1, + serialized_options=None, + type=None, + create_key=_descriptor._internal_create_key, ), _descriptor.EnumValueDescriptor( - name="FULL", index=2, number=2, serialized_options=None, type=None + name="FULL", + index=2, + number=2, + serialized_options=None, + type=None, + create_key=_descriptor._internal_create_key, ), ], containing_type=None, @@ -80,6 +86,7 @@ filename=None, file=DESCRIPTOR, containing_type=None, + create_key=_descriptor._internal_create_key, fields=[ _descriptor.FieldDescriptor( name="name", @@ -90,7 +97,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -98,6 +105,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="app_engine_http_request", @@ -116,6 +124,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="http_request", @@ -134,6 +143,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="schedule_time", @@ -152,6 +162,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="create_time", @@ -170,6 +181,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="dispatch_deadline", @@ -188,6 +200,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="dispatch_count", @@ -206,6 +219,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="response_count", @@ -224,6 +238,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="first_attempt", @@ -242,6 +257,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="last_attempt", @@ -260,6 +276,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="view", @@ -278,14 +295,13 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), ], extensions=[], nested_types=[], - enum_types=[_TASK_VIEW], - serialized_options=_b( - "\352Ae\n\036cloudtasks.googleapis.com/Task\022Cprojects/{project}/locations/{location}/queues/{queue}/tasks/{task}" - ), + enum_types=[_TASK_VIEW,], + serialized_options=b"\352Ae\n\036cloudtasks.googleapis.com/Task\022Cprojects/{project}/locations/{location}/queues/{queue}/tasks/{task}", is_extendable=False, syntax="proto3", extension_ranges=[], @@ -295,8 +311,9 @@ full_name="google.cloud.tasks.v2.Task.message_type", index=0, containing_type=None, + create_key=_descriptor._internal_create_key, fields=[], - ) + ), ], serialized_start=255, serialized_end=947, @@ -309,6 +326,7 @@ filename=None, file=DESCRIPTOR, containing_type=None, + create_key=_descriptor._internal_create_key, fields=[ _descriptor.FieldDescriptor( name="schedule_time", @@ -327,6 +345,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="dispatch_time", @@ -345,6 +364,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="response_time", @@ -363,6 +383,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="response_status", @@ -381,6 +402,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), ], extensions=[], @@ -445,10 +467,11 @@ Task = _reflection.GeneratedProtocolMessageType( "Task", (_message.Message,), - dict( - DESCRIPTOR=_TASK, - __module__="google.cloud.tasks_v2.proto.task_pb2", - __doc__="""A unit of scheduled work. + { + "DESCRIPTOR": _TASK, + "__module__": "google.cloud.tasks_v2.proto.task_pb2", + "__doc__": """A unit of scheduled work. + Attributes: name: Optionally caller-specified in @@ -461,14 +484,14 @@ projects `_ - ``LOCATION_ID`` is the - canonical ID for the task's location. The list of available + canonical ID for the task’s location. The list of available locations can be obtained by calling [ListLocations][google .cloud.location.Locations.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 + ([0-9]), hyphens (-), or underscores (_). The maximum length is 500 characters. message_type: Required. The message to send to the worker. @@ -510,10 +533,10 @@ hours for standard apps with manual and basic scaling, and 60 minutes for flex apps. If the request deadline is set, it must be in the interval [15 seconds, 24 hours 15 seconds]. - Regardless of the task's ``dispatch_deadline``, the app - handler will not run for longer than than the service's + Regardless of the task’s ``dispatch_deadline``, the app + handler will not run for longer than than the service’s timeout. We recommend setting the ``dispatch_deadline`` to - at most a few seconds more than the app handler's timeout. + at most a few seconds more than the app handler’s timeout. For more information see `Timeouts `_. ``dispatch_deadline`` will be @@ -521,35 +544,36 @@ approximate deadline. dispatch_count: Output only. The number of attempts dispatched. This count - includes attempts which have been dispatched but haven't + includes attempts which have been dispatched but haven’t received a response. response_count: Output only. The number of attempts which have received a response. first_attempt: - Output only. The status of the task's first attempt. Only - [dispatch\_time][google.cloud.tasks.v2.Attempt.dispatch\_time] + Output only. The status of the task’s first attempt. Only + [dispatch_time][google.cloud.tasks.v2.Attempt.dispatch_time] will be set. The other [Attempt][google.cloud.tasks.v2.Attempt] information is not retained by Cloud Tasks. last_attempt: - Output only. The status of the task's last attempt. + Output only. The status of the task’s last attempt. view: Output only. The view specifies which subset of the [Task][google.cloud.tasks.v2.Task] has been returned. """, # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2.Task) - ), + }, ) _sym_db.RegisterMessage(Task) Attempt = _reflection.GeneratedProtocolMessageType( "Attempt", (_message.Message,), - dict( - DESCRIPTOR=_ATTEMPT, - __module__="google.cloud.tasks_v2.proto.task_pb2", - __doc__="""The status of a task attempt. + { + "DESCRIPTOR": _ATTEMPT, + "__module__": "google.cloud.tasks_v2.proto.task_pb2", + "__doc__": """The status of a task attempt. + Attributes: schedule_time: Output only. The time that this attempt was scheduled. @@ -570,7 +594,7 @@ field is meaningless. """, # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2.Attempt) - ), + }, ) _sym_db.RegisterMessage(Attempt) diff --git a/google/cloud/tasks_v2/proto/task_pb2_grpc.py b/google/cloud/tasks_v2/proto/task_pb2_grpc.py index 07cb78fe..8a939394 100644 --- a/google/cloud/tasks_v2/proto/task_pb2_grpc.py +++ b/google/cloud/tasks_v2/proto/task_pb2_grpc.py @@ -1,2 +1,3 @@ # Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT! +"""Client and server classes corresponding to protobuf-defined services.""" import grpc diff --git a/google/cloud/tasks_v2/types.py b/google/cloud/tasks_v2/types.py index 5c549ab4..3556d47f 100644 --- a/google/cloud/tasks_v2/types.py +++ b/google/cloud/tasks_v2/types.py @@ -49,7 +49,12 @@ expr_pb2, ] -_local_modules = [cloudtasks_pb2, queue_pb2, target_pb2, task_pb2] +_local_modules = [ + cloudtasks_pb2, + queue_pb2, + target_pb2, + task_pb2, +] names = [] diff --git a/google/cloud/tasks_v2beta2/__init__.py b/google/cloud/tasks_v2beta2/__init__.py index c943253c..d6aba004 100644 --- a/google/cloud/tasks_v2beta2/__init__.py +++ b/google/cloud/tasks_v2beta2/__init__.py @@ -26,8 +26,8 @@ if sys.version_info[:2] == (2, 7): message = ( - "A future version of this library will drop support for Python 2.7." - "More details about Python 2 support for Google Cloud Client Libraries" + "A future version of this library will drop support for Python 2.7. " + "More details about Python 2 support for Google Cloud Client Libraries " "can be found at https://cloud.google.com/python/docs/python2-sunset/" ) warnings.warn(message, DeprecationWarning) @@ -38,4 +38,8 @@ class CloudTasksClient(cloud_tasks_client.CloudTasksClient): enums = enums -__all__ = ("enums", "types", "CloudTasksClient") +__all__ = ( + "enums", + "types", + "CloudTasksClient", +) diff --git a/google/cloud/tasks_v2beta2/gapic/cloud_tasks_client.py b/google/cloud/tasks_v2beta2/gapic/cloud_tasks_client.py index c2a6429c..84279e1a 100644 --- a/google/cloud/tasks_v2beta2/gapic/cloud_tasks_client.py +++ b/google/cloud/tasks_v2beta2/gapic/cloud_tasks_client.py @@ -47,7 +47,7 @@ from google.protobuf import timestamp_pb2 -_GAPIC_LIBRARY_VERSION = pkg_resources.get_distribution("google-cloud-tasks").version +_GAPIC_LIBRARY_VERSION = pkg_resources.get_distribution("google-cloud-tasks",).version class CloudTasksClient(object): @@ -200,12 +200,12 @@ def __init__( self.transport = transport else: self.transport = cloud_tasks_grpc_transport.CloudTasksGrpcTransport( - address=api_endpoint, channel=channel, credentials=credentials + address=api_endpoint, channel=channel, credentials=credentials, ) if client_info is None: client_info = google.api_core.gapic_v1.client_info.ClientInfo( - gapic_version=_GAPIC_LIBRARY_VERSION + gapic_version=_GAPIC_LIBRARY_VERSION, ) else: client_info.gapic_version = _GAPIC_LIBRARY_VERSION @@ -216,7 +216,7 @@ def __init__( # (Ordinarily, these are the defaults specified in the `*_config.py` # file next to this one.) self._method_configs = google.api_core.gapic_v1.config.parse_method_configs( - client_config["interfaces"][self._INTERFACE_NAME] + client_config["interfaces"][self._INTERFACE_NAME], ) # Save a dictionary of cached API call functions. @@ -270,10 +270,10 @@ def list_queues( described in `Stackdriver's Advanced Logs Filters `__. - Sample filter "app\_engine\_http\_target: \*". + Sample filter "app_engine_http_target: \*". - Note that using filters might cause fewer queues than the - requested\_page size to be returned. + Note that using filters might cause fewer queues than the requested_page + size to be returned. page_size (int): The maximum number of resources contained in the underlying API response. If page streaming is performed per- resource, this parameter does not affect the return value. If page @@ -313,7 +313,7 @@ def list_queues( ) request = cloudtasks_pb2.ListQueuesRequest( - parent=parent, filter=filter_, page_size=page_size + parent=parent, filter=filter_, page_size=page_size, ) if metadata is None: metadata = [] @@ -395,7 +395,7 @@ def get_queue( client_info=self._client_info, ) - request = cloudtasks_pb2.GetQueueRequest(name=name) + request = cloudtasks_pb2.GetQueueRequest(name=name,) if metadata is None: metadata = [] metadata = list(metadata) @@ -488,7 +488,7 @@ def create_queue( client_info=self._client_info, ) - request = cloudtasks_pb2.CreateQueueRequest(parent=parent, queue=queue) + request = cloudtasks_pb2.CreateQueueRequest(parent=parent, queue=queue,) if metadata is None: metadata = [] metadata = list(metadata) @@ -588,7 +588,7 @@ def update_queue( ) request = cloudtasks_pb2.UpdateQueueRequest( - queue=queue, update_mask=update_mask + queue=queue, update_mask=update_mask, ) if metadata is None: metadata = [] @@ -667,7 +667,7 @@ def delete_queue( client_info=self._client_info, ) - request = cloudtasks_pb2.DeleteQueueRequest(name=name) + request = cloudtasks_pb2.DeleteQueueRequest(name=name,) if metadata is None: metadata = [] metadata = list(metadata) @@ -742,7 +742,7 @@ def purge_queue( client_info=self._client_info, ) - request = cloudtasks_pb2.PurgeQueueRequest(name=name) + request = cloudtasks_pb2.PurgeQueueRequest(name=name,) if metadata is None: metadata = [] metadata = list(metadata) @@ -816,7 +816,7 @@ def pause_queue( client_info=self._client_info, ) - request = cloudtasks_pb2.PauseQueueRequest(name=name) + request = cloudtasks_pb2.PauseQueueRequest(name=name,) if metadata is None: metadata = [] metadata = list(metadata) @@ -895,7 +895,7 @@ def resume_queue( client_info=self._client_info, ) - request = cloudtasks_pb2.ResumeQueueRequest(name=name) + request = cloudtasks_pb2.ResumeQueueRequest(name=name,) if metadata is None: metadata = [] metadata = list(metadata) @@ -922,8 +922,8 @@ def get_iam_policy( metadata=None, ): """ - Gets the access control policy for a ``Queue``. Returns an empty policy - if the resource exists and does not have a policy set. + Gets the access control policy for a ``Queue``. Returns an empty + policy if the resource exists and does not have a policy set. Authorization requires the following `Google IAM `__ permission on the specified @@ -980,7 +980,7 @@ def get_iam_policy( ) request = iam_policy_pb2.GetIamPolicyRequest( - resource=resource, options=options_ + resource=resource, options=options_, ) if metadata is None: metadata = [] @@ -1008,8 +1008,8 @@ def set_iam_policy( metadata=None, ): """ - Sets the access control policy for a ``Queue``. Replaces any existing - policy. + Sets the access control policy for a ``Queue``. Replaces any + existing policy. Note: The Cloud Console does not check queue-level IAM permissions yet. Project-level permissions are required to use the Cloud Console. @@ -1073,7 +1073,7 @@ def set_iam_policy( client_info=self._client_info, ) - request = iam_policy_pb2.SetIamPolicyRequest(resource=resource, policy=policy) + request = iam_policy_pb2.SetIamPolicyRequest(resource=resource, policy=policy,) if metadata is None: metadata = [] metadata = list(metadata) @@ -1100,9 +1100,9 @@ def test_iam_permissions( metadata=None, ): """ - Returns permissions that a caller has on a ``Queue``. If the resource - does not exist, this will return an empty set of permissions, not a - ``NOT_FOUND`` error. + Returns permissions that a caller has on a ``Queue``. If the + resource does not exist, this will return an empty set of permissions, + not a ``NOT_FOUND`` error. Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization @@ -1124,8 +1124,8 @@ def test_iam_permissions( Args: resource (str): REQUIRED: The resource for which the policy detail is being requested. See the operation documentation for the appropriate value for this field. - permissions (list[str]): The set of permissions to check for the ``resource``. Permissions with - wildcards (such as '*' or 'storage.*') are not allowed. For more + permissions (list[str]): The set of permissions to check for the ``resource``. Permissions + with wildcards (such as '*' or 'storage.*') are not allowed. For more information see `IAM Overview `__. retry (Optional[google.api_core.retry.Retry]): A retry object used @@ -1159,7 +1159,7 @@ def test_iam_permissions( ) request = iam_policy_pb2.TestIamPermissionsRequest( - resource=resource, permissions=permissions + resource=resource, permissions=permissions, ) if metadata is None: metadata = [] @@ -1221,10 +1221,10 @@ def list_tasks( Args: parent (str): Required. The queue name. For example: ``projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`` - response_view (~google.cloud.tasks_v2beta2.enums.Task.View): The response\_view specifies which subset of the ``Task`` will be + response_view (~google.cloud.tasks_v2beta2.enums.Task.View): The response_view specifies which subset of the ``Task`` will be returned. - By default response\_view is ``BASIC``; not all information is retrieved + By default response_view is ``BASIC``; 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. @@ -1271,7 +1271,7 @@ def list_tasks( ) request = cloudtasks_pb2.ListTasksRequest( - parent=parent, response_view=response_view, page_size=page_size + parent=parent, response_view=response_view, page_size=page_size, ) if metadata is None: metadata = [] @@ -1324,10 +1324,10 @@ def get_task( Args: name (str): Required. The task name. For example: ``projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`` - response_view (~google.cloud.tasks_v2beta2.enums.Task.View): The response\_view specifies which subset of the ``Task`` will be + response_view (~google.cloud.tasks_v2beta2.enums.Task.View): The response_view specifies which subset of the ``Task`` will be returned. - By default response\_view is ``BASIC``; not all information is retrieved + By default response_view is ``BASIC``; 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. @@ -1365,7 +1365,7 @@ def get_task( client_info=self._client_info, ) - request = cloudtasks_pb2.GetTaskRequest(name=name, response_view=response_view) + request = cloudtasks_pb2.GetTaskRequest(name=name, response_view=response_view,) if metadata is None: metadata = [] metadata = list(metadata) @@ -1450,10 +1450,10 @@ def create_task( If a dict is provided, it must be of the same form as the protobuf message :class:`~google.cloud.tasks_v2beta2.types.Task` - response_view (~google.cloud.tasks_v2beta2.enums.Task.View): The response\_view specifies which subset of the ``Task`` will be + response_view (~google.cloud.tasks_v2beta2.enums.Task.View): The response_view specifies which subset of the ``Task`` will be returned. - By default response\_view is ``BASIC``; not all information is retrieved + By default response_view is ``BASIC``; 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. @@ -1492,7 +1492,7 @@ def create_task( ) request = cloudtasks_pb2.CreateTaskRequest( - parent=parent, task=task, response_view=response_view + parent=parent, task=task, response_view=response_view, ) if metadata is None: metadata = [] @@ -1564,7 +1564,7 @@ def delete_task( client_info=self._client_info, ) - request = cloudtasks_pb2.DeleteTaskRequest(name=name) + request = cloudtasks_pb2.DeleteTaskRequest(name=name,) if metadata is None: metadata = [] metadata = list(metadata) @@ -1651,10 +1651,10 @@ def lease_tasks( The maximum total size of a ``lease tasks response`` is 32 MB. If the sum of all task sizes requested reaches this limit, fewer tasks than requested are returned. - response_view (~google.cloud.tasks_v2beta2.enums.Task.View): The response\_view specifies which subset of the ``Task`` will be + response_view (~google.cloud.tasks_v2beta2.enums.Task.View): The response_view specifies which subset of the ``Task`` will be returned. - By default response\_view is ``BASIC``; not all information is retrieved + By default response_view is ``BASIC``; 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. @@ -1811,7 +1811,7 @@ def acknowledge_task( ) request = cloudtasks_pb2.AcknowledgeTaskRequest( - name=name, schedule_time=schedule_time + name=name, schedule_time=schedule_time, ) if metadata is None: metadata = [] @@ -1879,10 +1879,10 @@ def renew_lease( If a dict is provided, it must be of the same form as the protobuf message :class:`~google.cloud.tasks_v2beta2.types.Duration` - response_view (~google.cloud.tasks_v2beta2.enums.Task.View): The response\_view specifies which subset of the ``Task`` will be + response_view (~google.cloud.tasks_v2beta2.enums.Task.View): The response_view specifies which subset of the ``Task`` will be returned. - By default response\_view is ``BASIC``; not all information is retrieved + By default response_view is ``BASIC``; 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. @@ -1981,10 +1981,10 @@ def cancel_lease( If a dict is provided, it must be of the same form as the protobuf message :class:`~google.cloud.tasks_v2beta2.types.Timestamp` - response_view (~google.cloud.tasks_v2beta2.enums.Task.View): The response\_view specifies which subset of the ``Task`` will be + response_view (~google.cloud.tasks_v2beta2.enums.Task.View): The response_view specifies which subset of the ``Task`` will be returned. - By default response\_view is ``BASIC``; not all information is retrieved + By default response_view is ``BASIC``; 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. @@ -2023,7 +2023,7 @@ def cancel_lease( ) request = cloudtasks_pb2.CancelLeaseRequest( - name=name, schedule_time=schedule_time, response_view=response_view + name=name, schedule_time=schedule_time, response_view=response_view, ) if metadata is None: metadata = [] @@ -2087,10 +2087,10 @@ def run_task( Args: name (str): Required. The task name. For example: ``projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`` - response_view (~google.cloud.tasks_v2beta2.enums.Task.View): The response\_view specifies which subset of the ``Task`` will be + response_view (~google.cloud.tasks_v2beta2.enums.Task.View): The response_view specifies which subset of the ``Task`` will be returned. - By default response\_view is ``BASIC``; not all information is retrieved + By default response_view is ``BASIC``; 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. @@ -2128,7 +2128,7 @@ def run_task( client_info=self._client_info, ) - request = cloudtasks_pb2.RunTaskRequest(name=name, response_view=response_view) + request = cloudtasks_pb2.RunTaskRequest(name=name, response_view=response_view,) if metadata is None: metadata = [] metadata = list(metadata) diff --git a/google/cloud/tasks_v2beta2/gapic/cloud_tasks_client_config.py b/google/cloud/tasks_v2beta2/gapic/cloud_tasks_client_config.py index 00d82f9f..662a99e8 100644 --- a/google/cloud/tasks_v2beta2/gapic/cloud_tasks_client_config.py +++ b/google/cloud/tasks_v2beta2/gapic/cloud_tasks_client_config.py @@ -2,120 +2,139 @@ "interfaces": { "google.cloud.tasks.v2beta2.CloudTasks": { "retry_codes": { - "idempotent": ["DEADLINE_EXCEEDED", "UNAVAILABLE"], - "non_idempotent": [], + "retry_policy_1_codes": ["UNAVAILABLE", "DEADLINE_EXCEEDED"], + "no_retry_codes": [], + "no_retry_1_codes": [], }, "retry_params": { - "default": { + "retry_policy_1_params": { "initial_retry_delay_millis": 100, "retry_delay_multiplier": 1.3, - "max_retry_delay_millis": 60000, - "initial_rpc_timeout_millis": 20000, + "max_retry_delay_millis": 10000, + "initial_rpc_timeout_millis": 10000, "rpc_timeout_multiplier": 1.0, - "max_rpc_timeout_millis": 20000, - "total_timeout_millis": 600000, - } + "max_rpc_timeout_millis": 10000, + "total_timeout_millis": 10000, + }, + "no_retry_params": { + "initial_retry_delay_millis": 0, + "retry_delay_multiplier": 0.0, + "max_retry_delay_millis": 0, + "initial_rpc_timeout_millis": 0, + "rpc_timeout_multiplier": 1.0, + "max_rpc_timeout_millis": 0, + "total_timeout_millis": 0, + }, + "no_retry_1_params": { + "initial_retry_delay_millis": 0, + "retry_delay_multiplier": 0.0, + "max_retry_delay_millis": 0, + "initial_rpc_timeout_millis": 10000, + "rpc_timeout_multiplier": 1.0, + "max_rpc_timeout_millis": 10000, + "total_timeout_millis": 10000, + }, }, "methods": { "ListQueues": { "timeout_millis": 15000, - "retry_codes_name": "idempotent", - "retry_params_name": "default", + "retry_codes_name": "retry_policy_1_codes", + "retry_params_name": "retry_policy_1_params", }, "GetQueue": { "timeout_millis": 10000, - "retry_codes_name": "idempotent", - "retry_params_name": "default", + "retry_codes_name": "retry_policy_1_codes", + "retry_params_name": "retry_policy_1_params", }, "CreateQueue": { "timeout_millis": 10000, - "retry_codes_name": "non_idempotent", - "retry_params_name": "default", + "retry_codes_name": "no_retry_1_codes", + "retry_params_name": "no_retry_1_params", }, "UpdateQueue": { "timeout_millis": 10000, - "retry_codes_name": "non_idempotent", - "retry_params_name": "default", + "retry_codes_name": "no_retry_1_codes", + "retry_params_name": "no_retry_1_params", }, "DeleteQueue": { "timeout_millis": 10000, - "retry_codes_name": "idempotent", - "retry_params_name": "default", + "retry_codes_name": "retry_policy_1_codes", + "retry_params_name": "retry_policy_1_params", }, "PurgeQueue": { "timeout_millis": 10000, - "retry_codes_name": "non_idempotent", - "retry_params_name": "default", + "retry_codes_name": "no_retry_1_codes", + "retry_params_name": "no_retry_1_params", }, "PauseQueue": { "timeout_millis": 10000, - "retry_codes_name": "non_idempotent", - "retry_params_name": "default", + "retry_codes_name": "no_retry_1_codes", + "retry_params_name": "no_retry_1_params", }, "ResumeQueue": { "timeout_millis": 10000, - "retry_codes_name": "non_idempotent", - "retry_params_name": "default", + "retry_codes_name": "no_retry_1_codes", + "retry_params_name": "no_retry_1_params", }, "GetIamPolicy": { "timeout_millis": 10000, - "retry_codes_name": "non_idempotent", - "retry_params_name": "default", + "retry_codes_name": "retry_policy_1_codes", + "retry_params_name": "retry_policy_1_params", }, "SetIamPolicy": { "timeout_millis": 10000, - "retry_codes_name": "non_idempotent", - "retry_params_name": "default", + "retry_codes_name": "no_retry_1_codes", + "retry_params_name": "no_retry_1_params", }, "TestIamPermissions": { "timeout_millis": 10000, - "retry_codes_name": "non_idempotent", - "retry_params_name": "default", + "retry_codes_name": "retry_policy_1_codes", + "retry_params_name": "retry_policy_1_params", }, "ListTasks": { "timeout_millis": 10000, - "retry_codes_name": "idempotent", - "retry_params_name": "default", + "retry_codes_name": "retry_policy_1_codes", + "retry_params_name": "retry_policy_1_params", }, "GetTask": { "timeout_millis": 10000, - "retry_codes_name": "idempotent", - "retry_params_name": "default", + "retry_codes_name": "retry_policy_1_codes", + "retry_params_name": "retry_policy_1_params", }, "CreateTask": { "timeout_millis": 10000, - "retry_codes_name": "non_idempotent", - "retry_params_name": "default", + "retry_codes_name": "no_retry_1_codes", + "retry_params_name": "no_retry_1_params", }, "DeleteTask": { "timeout_millis": 10000, - "retry_codes_name": "non_idempotent", - "retry_params_name": "default", + "retry_codes_name": "retry_policy_1_codes", + "retry_params_name": "retry_policy_1_params", }, "LeaseTasks": { "timeout_millis": 10000, - "retry_codes_name": "non_idempotent", - "retry_params_name": "default", + "retry_codes_name": "no_retry_1_codes", + "retry_params_name": "no_retry_1_params", }, "AcknowledgeTask": { "timeout_millis": 10000, - "retry_codes_name": "non_idempotent", - "retry_params_name": "default", + "retry_codes_name": "no_retry_1_codes", + "retry_params_name": "no_retry_1_params", }, "RenewLease": { "timeout_millis": 10000, - "retry_codes_name": "non_idempotent", - "retry_params_name": "default", + "retry_codes_name": "no_retry_1_codes", + "retry_params_name": "no_retry_1_params", }, "CancelLease": { "timeout_millis": 10000, - "retry_codes_name": "non_idempotent", - "retry_params_name": "default", + "retry_codes_name": "no_retry_1_codes", + "retry_params_name": "no_retry_1_params", }, "RunTask": { "timeout_millis": 10000, - "retry_codes_name": "non_idempotent", - "retry_params_name": "default", + "retry_codes_name": "no_retry_1_codes", + "retry_params_name": "no_retry_1_params", }, }, } diff --git a/google/cloud/tasks_v2beta2/gapic/enums.py b/google/cloud/tasks_v2beta2/gapic/enums.py index 35263360..d5a7094c 100644 --- a/google/cloud/tasks_v2beta2/gapic/enums.py +++ b/google/cloud/tasks_v2beta2/gapic/enums.py @@ -54,10 +54,10 @@ class State(enum.IntEnum): take a few minutes to re-activate. Some method calls may return ``NOT_FOUND`` and tasks may not be dispatched for a few minutes until the queue has been re-activated. - PAUSED (int): Tasks are paused by the user. If the queue is paused then Cloud Tasks - will stop delivering tasks from it, but more tasks can still be added to - it by the user. When a pull queue is paused, all ``LeaseTasks`` calls - will return a ``FAILED_PRECONDITION``. + PAUSED (int): Tasks are paused by the user. If the queue is paused then Cloud + Tasks will stop delivering tasks from it, but more tasks can still be + added to it by the user. When a pull queue is paused, all ``LeaseTasks`` + calls will return a ``FAILED_PRECONDITION``. DISABLED (int): The queue is disabled. A queue becomes ``DISABLED`` when @@ -93,8 +93,8 @@ class View(enum.IntEnum): Attributes: VIEW_UNSPECIFIED (int): Unspecified. Defaults to BASIC. - BASIC (int): The basic view omits fields which can be large or can contain sensitive - data. + BASIC (int): The basic view omits fields which can be large or can contain + sensitive data. This view does not include the (``payload in AppEngineHttpRequest`` and ``payload in PullMessage``). These payloads are desirable to return only diff --git a/google/cloud/tasks_v2beta2/gapic/transports/cloud_tasks_grpc_transport.py b/google/cloud/tasks_v2beta2/gapic/transports/cloud_tasks_grpc_transport.py index 6f36025a..426b7a23 100644 --- a/google/cloud/tasks_v2beta2/gapic/transports/cloud_tasks_grpc_transport.py +++ b/google/cloud/tasks_v2beta2/gapic/transports/cloud_tasks_grpc_transport.py @@ -53,7 +53,7 @@ def __init__( # exception (channels come with credentials baked in already). if channel is not None and credentials is not None: raise ValueError( - "The `channel` and `credentials` arguments are mutually " "exclusive." + "The `channel` and `credentials` arguments are mutually " "exclusive.", ) # Create the channel. @@ -71,7 +71,9 @@ def __init__( # gRPC uses objects called "stubs" that are bound to the # channel and provide a basic method for each RPC. - self._stubs = {"cloud_tasks_stub": cloudtasks_pb2_grpc.CloudTasksStub(channel)} + self._stubs = { + "cloud_tasks_stub": cloudtasks_pb2_grpc.CloudTasksStub(channel), + } @classmethod def create_channel( @@ -267,8 +269,8 @@ def resume_queue(self): def get_iam_policy(self): """Return the gRPC stub for :meth:`CloudTasksClient.get_iam_policy`. - Gets the access control policy for a ``Queue``. Returns an empty policy - if the resource exists and does not have a policy set. + Gets the access control policy for a ``Queue``. Returns an empty + policy if the resource exists and does not have a policy set. Authorization requires the following `Google IAM `__ permission on the specified @@ -287,8 +289,8 @@ def get_iam_policy(self): def set_iam_policy(self): """Return the gRPC stub for :meth:`CloudTasksClient.set_iam_policy`. - Sets the access control policy for a ``Queue``. Replaces any existing - policy. + Sets the access control policy for a ``Queue``. Replaces any + existing policy. Note: The Cloud Console does not check queue-level IAM permissions yet. Project-level permissions are required to use the Cloud Console. @@ -310,9 +312,9 @@ def set_iam_policy(self): def test_iam_permissions(self): """Return the gRPC stub for :meth:`CloudTasksClient.test_iam_permissions`. - Returns permissions that a caller has on a ``Queue``. If the resource - does not exist, this will return an empty set of permissions, not a - ``NOT_FOUND`` error. + Returns permissions that a caller has on a ``Queue``. If the + resource does not exist, this will return an empty set of permissions, + not a ``NOT_FOUND`` error. Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization diff --git a/google/cloud/tasks_v2beta2/proto/cloudtasks_pb2.py b/google/cloud/tasks_v2beta2/proto/cloudtasks_pb2.py index 89af8545..bd5a0365 100644 --- a/google/cloud/tasks_v2beta2/proto/cloudtasks_pb2.py +++ b/google/cloud/tasks_v2beta2/proto/cloudtasks_pb2.py @@ -1,10 +1,7 @@ # -*- coding: utf-8 -*- # Generated by the protocol buffer compiler. DO NOT EDIT! # source: google/cloud/tasks_v2beta2/proto/cloudtasks.proto - -import sys - -_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1")) +"""Generated protocol buffer code.""" from google.protobuf import descriptor as _descriptor from google.protobuf import message as _message from google.protobuf import reflection as _reflection @@ -37,12 +34,9 @@ name="google/cloud/tasks_v2beta2/proto/cloudtasks.proto", package="google.cloud.tasks.v2beta2", syntax="proto3", - serialized_options=_b( - "\n\036com.google.cloud.tasks.v2beta2B\017CloudTasksProtoP\001Z?google.golang.org/genproto/googleapis/cloud/tasks/v2beta2;tasks\242\002\005TASKS" - ), - serialized_pb=_b( - '\n1google/cloud/tasks_v2beta2/proto/cloudtasks.proto\x12\x1agoogle.cloud.tasks.v2beta2\x1a\x1cgoogle/api/annotations.proto\x1a\x17google/api/client.proto\x1a\x1fgoogle/api/field_behavior.proto\x1a\x19google/api/resource.proto\x1a,google/cloud/tasks_v2beta2/proto/queue.proto\x1a+google/cloud/tasks_v2beta2/proto/task.proto\x1a\x1egoogle/iam/v1/iam_policy.proto\x1a\x1agoogle/iam/v1/policy.proto\x1a\x1egoogle/protobuf/duration.proto\x1a\x1bgoogle/protobuf/empty.proto\x1a google/protobuf/field_mask.proto\x1a\x1fgoogle/protobuf/timestamp.proto"\x83\x01\n\x11ListQueuesRequest\x12\x37\n\x06parent\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\x12\x1f\x63loudtasks.googleapis.com/Queue\x12\x0e\n\x06\x66ilter\x18\x02 \x01(\t\x12\x11\n\tpage_size\x18\x03 \x01(\x05\x12\x12\n\npage_token\x18\x04 \x01(\t"`\n\x12ListQueuesResponse\x12\x31\n\x06queues\x18\x01 \x03(\x0b\x32!.google.cloud.tasks.v2beta2.Queue\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"H\n\x0fGetQueueRequest\x12\x35\n\x04name\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\n\x1f\x63loudtasks.googleapis.com/Queue"\x84\x01\n\x12\x43reateQueueRequest\x12\x37\n\x06parent\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\x12\x1f\x63loudtasks.googleapis.com/Queue\x12\x35\n\x05queue\x18\x02 \x01(\x0b\x32!.google.cloud.tasks.v2beta2.QueueB\x03\xe0\x41\x02"|\n\x12UpdateQueueRequest\x12\x35\n\x05queue\x18\x01 \x01(\x0b\x32!.google.cloud.tasks.v2beta2.QueueB\x03\xe0\x41\x02\x12/\n\x0bupdate_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMask"K\n\x12\x44\x65leteQueueRequest\x12\x35\n\x04name\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\n\x1f\x63loudtasks.googleapis.com/Queue"J\n\x11PurgeQueueRequest\x12\x35\n\x04name\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\n\x1f\x63loudtasks.googleapis.com/Queue"J\n\x11PauseQueueRequest\x12\x35\n\x04name\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\n\x1f\x63loudtasks.googleapis.com/Queue"K\n\x12ResumeQueueRequest\x12\x35\n\x04name\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\n\x1f\x63loudtasks.googleapis.com/Queue"\xaf\x01\n\x10ListTasksRequest\x12\x36\n\x06parent\x18\x01 \x01(\tB&\xe0\x41\x02\xfa\x41 \x12\x1e\x63loudtasks.googleapis.com/Task\x12<\n\rresponse_view\x18\x02 \x01(\x0e\x32%.google.cloud.tasks.v2beta2.Task.View\x12\x11\n\tpage_size\x18\x04 \x01(\x05\x12\x12\n\npage_token\x18\x05 \x01(\t"]\n\x11ListTasksResponse\x12/\n\x05tasks\x18\x01 \x03(\x0b\x32 .google.cloud.tasks.v2beta2.Task\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"\x84\x01\n\x0eGetTaskRequest\x12\x34\n\x04name\x18\x01 \x01(\tB&\xe0\x41\x02\xfa\x41 \n\x1e\x63loudtasks.googleapis.com/Task\x12<\n\rresponse_view\x18\x02 \x01(\x0e\x32%.google.cloud.tasks.v2beta2.Task.View"\xbe\x01\n\x11\x43reateTaskRequest\x12\x36\n\x06parent\x18\x01 \x01(\tB&\xe0\x41\x02\xfa\x41 \x12\x1e\x63loudtasks.googleapis.com/Task\x12\x33\n\x04task\x18\x02 \x01(\x0b\x32 .google.cloud.tasks.v2beta2.TaskB\x03\xe0\x41\x02\x12<\n\rresponse_view\x18\x03 \x01(\x0e\x32%.google.cloud.tasks.v2beta2.Task.View"I\n\x11\x44\x65leteTaskRequest\x12\x34\n\x04name\x18\x01 \x01(\tB&\xe0\x41\x02\xfa\x41 \n\x1e\x63loudtasks.googleapis.com/Task"\xe4\x01\n\x11LeaseTasksRequest\x12\x36\n\x06parent\x18\x01 \x01(\tB&\xe0\x41\x02\xfa\x41 \x12\x1e\x63loudtasks.googleapis.com/Task\x12\x11\n\tmax_tasks\x18\x02 \x01(\x05\x12\x36\n\x0elease_duration\x18\x03 \x01(\x0b\x32\x19.google.protobuf.DurationB\x03\xe0\x41\x02\x12<\n\rresponse_view\x18\x04 \x01(\x0e\x32%.google.cloud.tasks.v2beta2.Task.View\x12\x0e\n\x06\x66ilter\x18\x05 \x01(\t"E\n\x12LeaseTasksResponse\x12/\n\x05tasks\x18\x01 \x03(\x0b\x32 .google.cloud.tasks.v2beta2.Task"\x86\x01\n\x16\x41\x63knowledgeTaskRequest\x12\x34\n\x04name\x18\x01 \x01(\tB&\xe0\x41\x02\xfa\x41 \n\x1e\x63loudtasks.googleapis.com/Task\x12\x36\n\rschedule_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.TimestampB\x03\xe0\x41\x02"\xf7\x01\n\x11RenewLeaseRequest\x12\x34\n\x04name\x18\x01 \x01(\tB&\xe0\x41\x02\xfa\x41 \n\x1e\x63loudtasks.googleapis.com/Task\x12\x36\n\rschedule_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.TimestampB\x03\xe0\x41\x02\x12\x36\n\x0elease_duration\x18\x03 \x01(\x0b\x32\x19.google.protobuf.DurationB\x03\xe0\x41\x02\x12<\n\rresponse_view\x18\x04 \x01(\x0e\x32%.google.cloud.tasks.v2beta2.Task.View"\xc0\x01\n\x12\x43\x61ncelLeaseRequest\x12\x34\n\x04name\x18\x01 \x01(\tB&\xe0\x41\x02\xfa\x41 \n\x1e\x63loudtasks.googleapis.com/Task\x12\x36\n\rschedule_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.TimestampB\x03\xe0\x41\x02\x12<\n\rresponse_view\x18\x03 \x01(\x0e\x32%.google.cloud.tasks.v2beta2.Task.View"\x84\x01\n\x0eRunTaskRequest\x12\x34\n\x04name\x18\x01 \x01(\tB&\xe0\x41\x02\xfa\x41 \n\x1e\x63loudtasks.googleapis.com/Task\x12<\n\rresponse_view\x18\x02 \x01(\x0e\x32%.google.cloud.tasks.v2beta2.Task.View2\xd4\x1c\n\nCloudTasks\x12\xad\x01\n\nListQueues\x12-.google.cloud.tasks.v2beta2.ListQueuesRequest\x1a..google.cloud.tasks.v2beta2.ListQueuesResponse"@\x82\xd3\xe4\x93\x02\x31\x12//v2beta2/{parent=projects/*/locations/*}/queues\xda\x41\x06parent\x12\x9a\x01\n\x08GetQueue\x12+.google.cloud.tasks.v2beta2.GetQueueRequest\x1a!.google.cloud.tasks.v2beta2.Queue">\x82\xd3\xe4\x93\x02\x31\x12//v2beta2/{name=projects/*/locations/*/queues/*}\xda\x41\x04name\x12\xaf\x01\n\x0b\x43reateQueue\x12..google.cloud.tasks.v2beta2.CreateQueueRequest\x1a!.google.cloud.tasks.v2beta2.Queue"M\x82\xd3\xe4\x93\x02\x38"//v2beta2/{parent=projects/*/locations/*}/queues:\x05queue\xda\x41\x0cparent,queue\x12\xba\x01\n\x0bUpdateQueue\x12..google.cloud.tasks.v2beta2.UpdateQueueRequest\x1a!.google.cloud.tasks.v2beta2.Queue"X\x82\xd3\xe4\x93\x02>25/v2beta2/{queue.name=projects/*/locations/*/queues/*}:\x05queue\xda\x41\x11queue,update_mask\x12\x95\x01\n\x0b\x44\x65leteQueue\x12..google.cloud.tasks.v2beta2.DeleteQueueRequest\x1a\x16.google.protobuf.Empty">\x82\xd3\xe4\x93\x02\x31*//v2beta2/{name=projects/*/locations/*/queues/*}\xda\x41\x04name\x12\xa7\x01\n\nPurgeQueue\x12-.google.cloud.tasks.v2beta2.PurgeQueueRequest\x1a!.google.cloud.tasks.v2beta2.Queue"G\x82\xd3\xe4\x93\x02:"5/v2beta2/{name=projects/*/locations/*/queues/*}:purge:\x01*\xda\x41\x04name\x12\xa7\x01\n\nPauseQueue\x12-.google.cloud.tasks.v2beta2.PauseQueueRequest\x1a!.google.cloud.tasks.v2beta2.Queue"G\x82\xd3\xe4\x93\x02:"5/v2beta2/{name=projects/*/locations/*/queues/*}:pause:\x01*\xda\x41\x04name\x12\xaa\x01\n\x0bResumeQueue\x12..google.cloud.tasks.v2beta2.ResumeQueueRequest\x1a!.google.cloud.tasks.v2beta2.Queue"H\x82\xd3\xe4\x93\x02;"6/v2beta2/{name=projects/*/locations/*/queues/*}:resume:\x01*\xda\x41\x04name\x12\xa1\x01\n\x0cGetIamPolicy\x12".google.iam.v1.GetIamPolicyRequest\x1a\x15.google.iam.v1.Policy"V\x82\xd3\xe4\x93\x02\x45"@/v2beta2/{resource=projects/*/locations/*/queues/*}:getIamPolicy:\x01*\xda\x41\x08resource\x12\xa8\x01\n\x0cSetIamPolicy\x12".google.iam.v1.SetIamPolicyRequest\x1a\x15.google.iam.v1.Policy"]\x82\xd3\xe4\x93\x02\x45"@/v2beta2/{resource=projects/*/locations/*/queues/*}:setIamPolicy:\x01*\xda\x41\x0fresource,policy\x12\xd3\x01\n\x12TestIamPermissions\x12(.google.iam.v1.TestIamPermissionsRequest\x1a).google.iam.v1.TestIamPermissionsResponse"h\x82\xd3\xe4\x93\x02K"F/v2beta2/{resource=projects/*/locations/*/queues/*}:testIamPermissions:\x01*\xda\x41\x14resource,permissions\x12\xb2\x01\n\tListTasks\x12,.google.cloud.tasks.v2beta2.ListTasksRequest\x1a-.google.cloud.tasks.v2beta2.ListTasksResponse"H\x82\xd3\xe4\x93\x02\x39\x12\x37/v2beta2/{parent=projects/*/locations/*/queues/*}/tasks\xda\x41\x06parent\x12\x9f\x01\n\x07GetTask\x12*.google.cloud.tasks.v2beta2.GetTaskRequest\x1a .google.cloud.tasks.v2beta2.Task"F\x82\xd3\xe4\x93\x02\x39\x12\x37/v2beta2/{name=projects/*/locations/*/queues/*/tasks/*}\xda\x41\x04name\x12\xaf\x01\n\nCreateTask\x12-.google.cloud.tasks.v2beta2.CreateTaskRequest\x1a .google.cloud.tasks.v2beta2.Task"P\x82\xd3\xe4\x93\x02<"7/v2beta2/{parent=projects/*/locations/*/queues/*}/tasks:\x01*\xda\x41\x0bparent,task\x12\x9b\x01\n\nDeleteTask\x12-.google.cloud.tasks.v2beta2.DeleteTaskRequest\x1a\x16.google.protobuf.Empty"F\x82\xd3\xe4\x93\x02\x39*7/v2beta2/{name=projects/*/locations/*/queues/*/tasks/*}\xda\x41\x04name\x12\xcd\x01\n\nLeaseTasks\x12-.google.cloud.tasks.v2beta2.LeaseTasksRequest\x1a..google.cloud.tasks.v2beta2.LeaseTasksResponse"`\x82\xd3\xe4\x93\x02\x42"=/v2beta2/{parent=projects/*/locations/*/queues/*}/tasks:lease:\x01*\xda\x41\x15parent,lease_duration\x12\xc2\x01\n\x0f\x41\x63knowledgeTask\x12\x32.google.cloud.tasks.v2beta2.AcknowledgeTaskRequest\x1a\x16.google.protobuf.Empty"c\x82\xd3\xe4\x93\x02H"C/v2beta2/{name=projects/*/locations/*/queues/*/tasks/*}:acknowledge:\x01*\xda\x41\x12name,schedule_time\x12\xd0\x01\n\nRenewLease\x12-.google.cloud.tasks.v2beta2.RenewLeaseRequest\x1a .google.cloud.tasks.v2beta2.Task"q\x82\xd3\xe4\x93\x02G"B/v2beta2/{name=projects/*/locations/*/queues/*/tasks/*}:renewLease:\x01*\xda\x41!name,schedule_time,lease_duration\x12\xc4\x01\n\x0b\x43\x61ncelLease\x12..google.cloud.tasks.v2beta2.CancelLeaseRequest\x1a .google.cloud.tasks.v2beta2.Task"c\x82\xd3\xe4\x93\x02H"C/v2beta2/{name=projects/*/locations/*/queues/*/tasks/*}:cancelLease:\x01*\xda\x41\x12name,schedule_time\x12\xa6\x01\n\x07RunTask\x12*.google.cloud.tasks.v2beta2.RunTaskRequest\x1a .google.cloud.tasks.v2beta2.Task"M\x82\xd3\xe4\x93\x02@";/v2beta2/{name=projects/*/locations/*/queues/*/tasks/*}:run:\x01*\xda\x41\x04name\x1aM\xca\x41\x19\x63loudtasks.googleapis.com\xd2\x41.https://www.googleapis.com/auth/cloud-platformB|\n\x1e\x63om.google.cloud.tasks.v2beta2B\x0f\x43loudTasksProtoP\x01Z?google.golang.org/genproto/googleapis/cloud/tasks/v2beta2;tasks\xa2\x02\x05TASKSb\x06proto3' - ), + serialized_options=b"\n\036com.google.cloud.tasks.v2beta2B\017CloudTasksProtoP\001Z?google.golang.org/genproto/googleapis/cloud/tasks/v2beta2;tasks\242\002\005TASKS", + create_key=_descriptor._internal_create_key, + serialized_pb=b'\n1google/cloud/tasks_v2beta2/proto/cloudtasks.proto\x12\x1agoogle.cloud.tasks.v2beta2\x1a\x1cgoogle/api/annotations.proto\x1a\x17google/api/client.proto\x1a\x1fgoogle/api/field_behavior.proto\x1a\x19google/api/resource.proto\x1a,google/cloud/tasks_v2beta2/proto/queue.proto\x1a+google/cloud/tasks_v2beta2/proto/task.proto\x1a\x1egoogle/iam/v1/iam_policy.proto\x1a\x1agoogle/iam/v1/policy.proto\x1a\x1egoogle/protobuf/duration.proto\x1a\x1bgoogle/protobuf/empty.proto\x1a google/protobuf/field_mask.proto\x1a\x1fgoogle/protobuf/timestamp.proto"\x83\x01\n\x11ListQueuesRequest\x12\x37\n\x06parent\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\x12\x1f\x63loudtasks.googleapis.com/Queue\x12\x0e\n\x06\x66ilter\x18\x02 \x01(\t\x12\x11\n\tpage_size\x18\x03 \x01(\x05\x12\x12\n\npage_token\x18\x04 \x01(\t"`\n\x12ListQueuesResponse\x12\x31\n\x06queues\x18\x01 \x03(\x0b\x32!.google.cloud.tasks.v2beta2.Queue\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"H\n\x0fGetQueueRequest\x12\x35\n\x04name\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\n\x1f\x63loudtasks.googleapis.com/Queue"\x84\x01\n\x12\x43reateQueueRequest\x12\x37\n\x06parent\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\x12\x1f\x63loudtasks.googleapis.com/Queue\x12\x35\n\x05queue\x18\x02 \x01(\x0b\x32!.google.cloud.tasks.v2beta2.QueueB\x03\xe0\x41\x02"|\n\x12UpdateQueueRequest\x12\x35\n\x05queue\x18\x01 \x01(\x0b\x32!.google.cloud.tasks.v2beta2.QueueB\x03\xe0\x41\x02\x12/\n\x0bupdate_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMask"K\n\x12\x44\x65leteQueueRequest\x12\x35\n\x04name\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\n\x1f\x63loudtasks.googleapis.com/Queue"J\n\x11PurgeQueueRequest\x12\x35\n\x04name\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\n\x1f\x63loudtasks.googleapis.com/Queue"J\n\x11PauseQueueRequest\x12\x35\n\x04name\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\n\x1f\x63loudtasks.googleapis.com/Queue"K\n\x12ResumeQueueRequest\x12\x35\n\x04name\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\n\x1f\x63loudtasks.googleapis.com/Queue"\xaf\x01\n\x10ListTasksRequest\x12\x36\n\x06parent\x18\x01 \x01(\tB&\xe0\x41\x02\xfa\x41 \x12\x1e\x63loudtasks.googleapis.com/Task\x12<\n\rresponse_view\x18\x02 \x01(\x0e\x32%.google.cloud.tasks.v2beta2.Task.View\x12\x11\n\tpage_size\x18\x04 \x01(\x05\x12\x12\n\npage_token\x18\x05 \x01(\t"]\n\x11ListTasksResponse\x12/\n\x05tasks\x18\x01 \x03(\x0b\x32 .google.cloud.tasks.v2beta2.Task\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"\x84\x01\n\x0eGetTaskRequest\x12\x34\n\x04name\x18\x01 \x01(\tB&\xe0\x41\x02\xfa\x41 \n\x1e\x63loudtasks.googleapis.com/Task\x12<\n\rresponse_view\x18\x02 \x01(\x0e\x32%.google.cloud.tasks.v2beta2.Task.View"\xbe\x01\n\x11\x43reateTaskRequest\x12\x36\n\x06parent\x18\x01 \x01(\tB&\xe0\x41\x02\xfa\x41 \x12\x1e\x63loudtasks.googleapis.com/Task\x12\x33\n\x04task\x18\x02 \x01(\x0b\x32 .google.cloud.tasks.v2beta2.TaskB\x03\xe0\x41\x02\x12<\n\rresponse_view\x18\x03 \x01(\x0e\x32%.google.cloud.tasks.v2beta2.Task.View"I\n\x11\x44\x65leteTaskRequest\x12\x34\n\x04name\x18\x01 \x01(\tB&\xe0\x41\x02\xfa\x41 \n\x1e\x63loudtasks.googleapis.com/Task"\xe4\x01\n\x11LeaseTasksRequest\x12\x36\n\x06parent\x18\x01 \x01(\tB&\xe0\x41\x02\xfa\x41 \x12\x1e\x63loudtasks.googleapis.com/Task\x12\x11\n\tmax_tasks\x18\x02 \x01(\x05\x12\x36\n\x0elease_duration\x18\x03 \x01(\x0b\x32\x19.google.protobuf.DurationB\x03\xe0\x41\x02\x12<\n\rresponse_view\x18\x04 \x01(\x0e\x32%.google.cloud.tasks.v2beta2.Task.View\x12\x0e\n\x06\x66ilter\x18\x05 \x01(\t"E\n\x12LeaseTasksResponse\x12/\n\x05tasks\x18\x01 \x03(\x0b\x32 .google.cloud.tasks.v2beta2.Task"\x86\x01\n\x16\x41\x63knowledgeTaskRequest\x12\x34\n\x04name\x18\x01 \x01(\tB&\xe0\x41\x02\xfa\x41 \n\x1e\x63loudtasks.googleapis.com/Task\x12\x36\n\rschedule_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.TimestampB\x03\xe0\x41\x02"\xf7\x01\n\x11RenewLeaseRequest\x12\x34\n\x04name\x18\x01 \x01(\tB&\xe0\x41\x02\xfa\x41 \n\x1e\x63loudtasks.googleapis.com/Task\x12\x36\n\rschedule_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.TimestampB\x03\xe0\x41\x02\x12\x36\n\x0elease_duration\x18\x03 \x01(\x0b\x32\x19.google.protobuf.DurationB\x03\xe0\x41\x02\x12<\n\rresponse_view\x18\x04 \x01(\x0e\x32%.google.cloud.tasks.v2beta2.Task.View"\xc0\x01\n\x12\x43\x61ncelLeaseRequest\x12\x34\n\x04name\x18\x01 \x01(\tB&\xe0\x41\x02\xfa\x41 \n\x1e\x63loudtasks.googleapis.com/Task\x12\x36\n\rschedule_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.TimestampB\x03\xe0\x41\x02\x12<\n\rresponse_view\x18\x03 \x01(\x0e\x32%.google.cloud.tasks.v2beta2.Task.View"\x84\x01\n\x0eRunTaskRequest\x12\x34\n\x04name\x18\x01 \x01(\tB&\xe0\x41\x02\xfa\x41 \n\x1e\x63loudtasks.googleapis.com/Task\x12<\n\rresponse_view\x18\x02 \x01(\x0e\x32%.google.cloud.tasks.v2beta2.Task.View2\xd4\x1c\n\nCloudTasks\x12\xad\x01\n\nListQueues\x12-.google.cloud.tasks.v2beta2.ListQueuesRequest\x1a..google.cloud.tasks.v2beta2.ListQueuesResponse"@\x82\xd3\xe4\x93\x02\x31\x12//v2beta2/{parent=projects/*/locations/*}/queues\xda\x41\x06parent\x12\x9a\x01\n\x08GetQueue\x12+.google.cloud.tasks.v2beta2.GetQueueRequest\x1a!.google.cloud.tasks.v2beta2.Queue">\x82\xd3\xe4\x93\x02\x31\x12//v2beta2/{name=projects/*/locations/*/queues/*}\xda\x41\x04name\x12\xaf\x01\n\x0b\x43reateQueue\x12..google.cloud.tasks.v2beta2.CreateQueueRequest\x1a!.google.cloud.tasks.v2beta2.Queue"M\x82\xd3\xe4\x93\x02\x38"//v2beta2/{parent=projects/*/locations/*}/queues:\x05queue\xda\x41\x0cparent,queue\x12\xba\x01\n\x0bUpdateQueue\x12..google.cloud.tasks.v2beta2.UpdateQueueRequest\x1a!.google.cloud.tasks.v2beta2.Queue"X\x82\xd3\xe4\x93\x02>25/v2beta2/{queue.name=projects/*/locations/*/queues/*}:\x05queue\xda\x41\x11queue,update_mask\x12\x95\x01\n\x0b\x44\x65leteQueue\x12..google.cloud.tasks.v2beta2.DeleteQueueRequest\x1a\x16.google.protobuf.Empty">\x82\xd3\xe4\x93\x02\x31*//v2beta2/{name=projects/*/locations/*/queues/*}\xda\x41\x04name\x12\xa7\x01\n\nPurgeQueue\x12-.google.cloud.tasks.v2beta2.PurgeQueueRequest\x1a!.google.cloud.tasks.v2beta2.Queue"G\x82\xd3\xe4\x93\x02:"5/v2beta2/{name=projects/*/locations/*/queues/*}:purge:\x01*\xda\x41\x04name\x12\xa7\x01\n\nPauseQueue\x12-.google.cloud.tasks.v2beta2.PauseQueueRequest\x1a!.google.cloud.tasks.v2beta2.Queue"G\x82\xd3\xe4\x93\x02:"5/v2beta2/{name=projects/*/locations/*/queues/*}:pause:\x01*\xda\x41\x04name\x12\xaa\x01\n\x0bResumeQueue\x12..google.cloud.tasks.v2beta2.ResumeQueueRequest\x1a!.google.cloud.tasks.v2beta2.Queue"H\x82\xd3\xe4\x93\x02;"6/v2beta2/{name=projects/*/locations/*/queues/*}:resume:\x01*\xda\x41\x04name\x12\xa1\x01\n\x0cGetIamPolicy\x12".google.iam.v1.GetIamPolicyRequest\x1a\x15.google.iam.v1.Policy"V\x82\xd3\xe4\x93\x02\x45"@/v2beta2/{resource=projects/*/locations/*/queues/*}:getIamPolicy:\x01*\xda\x41\x08resource\x12\xa8\x01\n\x0cSetIamPolicy\x12".google.iam.v1.SetIamPolicyRequest\x1a\x15.google.iam.v1.Policy"]\x82\xd3\xe4\x93\x02\x45"@/v2beta2/{resource=projects/*/locations/*/queues/*}:setIamPolicy:\x01*\xda\x41\x0fresource,policy\x12\xd3\x01\n\x12TestIamPermissions\x12(.google.iam.v1.TestIamPermissionsRequest\x1a).google.iam.v1.TestIamPermissionsResponse"h\x82\xd3\xe4\x93\x02K"F/v2beta2/{resource=projects/*/locations/*/queues/*}:testIamPermissions:\x01*\xda\x41\x14resource,permissions\x12\xb2\x01\n\tListTasks\x12,.google.cloud.tasks.v2beta2.ListTasksRequest\x1a-.google.cloud.tasks.v2beta2.ListTasksResponse"H\x82\xd3\xe4\x93\x02\x39\x12\x37/v2beta2/{parent=projects/*/locations/*/queues/*}/tasks\xda\x41\x06parent\x12\x9f\x01\n\x07GetTask\x12*.google.cloud.tasks.v2beta2.GetTaskRequest\x1a .google.cloud.tasks.v2beta2.Task"F\x82\xd3\xe4\x93\x02\x39\x12\x37/v2beta2/{name=projects/*/locations/*/queues/*/tasks/*}\xda\x41\x04name\x12\xaf\x01\n\nCreateTask\x12-.google.cloud.tasks.v2beta2.CreateTaskRequest\x1a .google.cloud.tasks.v2beta2.Task"P\x82\xd3\xe4\x93\x02<"7/v2beta2/{parent=projects/*/locations/*/queues/*}/tasks:\x01*\xda\x41\x0bparent,task\x12\x9b\x01\n\nDeleteTask\x12-.google.cloud.tasks.v2beta2.DeleteTaskRequest\x1a\x16.google.protobuf.Empty"F\x82\xd3\xe4\x93\x02\x39*7/v2beta2/{name=projects/*/locations/*/queues/*/tasks/*}\xda\x41\x04name\x12\xcd\x01\n\nLeaseTasks\x12-.google.cloud.tasks.v2beta2.LeaseTasksRequest\x1a..google.cloud.tasks.v2beta2.LeaseTasksResponse"`\x82\xd3\xe4\x93\x02\x42"=/v2beta2/{parent=projects/*/locations/*/queues/*}/tasks:lease:\x01*\xda\x41\x15parent,lease_duration\x12\xc2\x01\n\x0f\x41\x63knowledgeTask\x12\x32.google.cloud.tasks.v2beta2.AcknowledgeTaskRequest\x1a\x16.google.protobuf.Empty"c\x82\xd3\xe4\x93\x02H"C/v2beta2/{name=projects/*/locations/*/queues/*/tasks/*}:acknowledge:\x01*\xda\x41\x12name,schedule_time\x12\xd0\x01\n\nRenewLease\x12-.google.cloud.tasks.v2beta2.RenewLeaseRequest\x1a .google.cloud.tasks.v2beta2.Task"q\x82\xd3\xe4\x93\x02G"B/v2beta2/{name=projects/*/locations/*/queues/*/tasks/*}:renewLease:\x01*\xda\x41!name,schedule_time,lease_duration\x12\xc4\x01\n\x0b\x43\x61ncelLease\x12..google.cloud.tasks.v2beta2.CancelLeaseRequest\x1a .google.cloud.tasks.v2beta2.Task"c\x82\xd3\xe4\x93\x02H"C/v2beta2/{name=projects/*/locations/*/queues/*/tasks/*}:cancelLease:\x01*\xda\x41\x12name,schedule_time\x12\xa6\x01\n\x07RunTask\x12*.google.cloud.tasks.v2beta2.RunTaskRequest\x1a .google.cloud.tasks.v2beta2.Task"M\x82\xd3\xe4\x93\x02@";/v2beta2/{name=projects/*/locations/*/queues/*/tasks/*}:run:\x01*\xda\x41\x04name\x1aM\xca\x41\x19\x63loudtasks.googleapis.com\xd2\x41.https://www.googleapis.com/auth/cloud-platformB|\n\x1e\x63om.google.cloud.tasks.v2beta2B\x0f\x43loudTasksProtoP\x01Z?google.golang.org/genproto/googleapis/cloud/tasks/v2beta2;tasks\xa2\x02\x05TASKSb\x06proto3', dependencies=[ google_dot_api_dot_annotations__pb2.DESCRIPTOR, google_dot_api_dot_client__pb2.DESCRIPTOR, @@ -66,6 +60,7 @@ filename=None, file=DESCRIPTOR, containing_type=None, + create_key=_descriptor._internal_create_key, fields=[ _descriptor.FieldDescriptor( name="parent", @@ -76,16 +71,15 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b( - "\340A\002\372A!\022\037cloudtasks.googleapis.com/Queue" - ), + serialized_options=b"\340A\002\372A!\022\037cloudtasks.googleapis.com/Queue", file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="filter", @@ -96,7 +90,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -104,6 +98,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="page_size", @@ -122,6 +117,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="page_token", @@ -132,7 +128,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -140,6 +136,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), ], extensions=[], @@ -161,6 +158,7 @@ filename=None, file=DESCRIPTOR, containing_type=None, + create_key=_descriptor._internal_create_key, fields=[ _descriptor.FieldDescriptor( name="queues", @@ -179,6 +177,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="next_page_token", @@ -189,7 +188,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -197,6 +196,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), ], extensions=[], @@ -218,6 +218,7 @@ filename=None, file=DESCRIPTOR, containing_type=None, + create_key=_descriptor._internal_create_key, fields=[ _descriptor.FieldDescriptor( name="name", @@ -228,17 +229,16 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b( - "\340A\002\372A!\n\037cloudtasks.googleapis.com/Queue" - ), + serialized_options=b"\340A\002\372A!\n\037cloudtasks.googleapis.com/Queue", file=DESCRIPTOR, - ) + create_key=_descriptor._internal_create_key, + ), ], extensions=[], nested_types=[], @@ -259,6 +259,7 @@ filename=None, file=DESCRIPTOR, containing_type=None, + create_key=_descriptor._internal_create_key, fields=[ _descriptor.FieldDescriptor( name="parent", @@ -269,16 +270,15 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b( - "\340A\002\372A!\022\037cloudtasks.googleapis.com/Queue" - ), + serialized_options=b"\340A\002\372A!\022\037cloudtasks.googleapis.com/Queue", file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="queue", @@ -295,8 +295,9 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b("\340A\002"), + serialized_options=b"\340A\002", file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), ], extensions=[], @@ -318,6 +319,7 @@ filename=None, file=DESCRIPTOR, containing_type=None, + create_key=_descriptor._internal_create_key, fields=[ _descriptor.FieldDescriptor( name="queue", @@ -334,8 +336,9 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b("\340A\002"), + serialized_options=b"\340A\002", file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="update_mask", @@ -354,6 +357,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), ], extensions=[], @@ -375,6 +379,7 @@ filename=None, file=DESCRIPTOR, containing_type=None, + create_key=_descriptor._internal_create_key, fields=[ _descriptor.FieldDescriptor( name="name", @@ -385,17 +390,16 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b( - "\340A\002\372A!\n\037cloudtasks.googleapis.com/Queue" - ), + serialized_options=b"\340A\002\372A!\n\037cloudtasks.googleapis.com/Queue", file=DESCRIPTOR, - ) + create_key=_descriptor._internal_create_key, + ), ], extensions=[], nested_types=[], @@ -416,6 +420,7 @@ filename=None, file=DESCRIPTOR, containing_type=None, + create_key=_descriptor._internal_create_key, fields=[ _descriptor.FieldDescriptor( name="name", @@ -426,17 +431,16 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b( - "\340A\002\372A!\n\037cloudtasks.googleapis.com/Queue" - ), + serialized_options=b"\340A\002\372A!\n\037cloudtasks.googleapis.com/Queue", file=DESCRIPTOR, - ) + create_key=_descriptor._internal_create_key, + ), ], extensions=[], nested_types=[], @@ -457,6 +461,7 @@ filename=None, file=DESCRIPTOR, containing_type=None, + create_key=_descriptor._internal_create_key, fields=[ _descriptor.FieldDescriptor( name="name", @@ -467,17 +472,16 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b( - "\340A\002\372A!\n\037cloudtasks.googleapis.com/Queue" - ), + serialized_options=b"\340A\002\372A!\n\037cloudtasks.googleapis.com/Queue", file=DESCRIPTOR, - ) + create_key=_descriptor._internal_create_key, + ), ], extensions=[], nested_types=[], @@ -498,6 +502,7 @@ filename=None, file=DESCRIPTOR, containing_type=None, + create_key=_descriptor._internal_create_key, fields=[ _descriptor.FieldDescriptor( name="name", @@ -508,17 +513,16 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b( - "\340A\002\372A!\n\037cloudtasks.googleapis.com/Queue" - ), + serialized_options=b"\340A\002\372A!\n\037cloudtasks.googleapis.com/Queue", file=DESCRIPTOR, - ) + create_key=_descriptor._internal_create_key, + ), ], extensions=[], nested_types=[], @@ -539,6 +543,7 @@ filename=None, file=DESCRIPTOR, containing_type=None, + create_key=_descriptor._internal_create_key, fields=[ _descriptor.FieldDescriptor( name="parent", @@ -549,16 +554,15 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b( - "\340A\002\372A \022\036cloudtasks.googleapis.com/Task" - ), + serialized_options=b"\340A\002\372A \022\036cloudtasks.googleapis.com/Task", file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="response_view", @@ -577,6 +581,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="page_size", @@ -595,6 +600,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="page_token", @@ -605,7 +611,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -613,6 +619,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), ], extensions=[], @@ -634,6 +641,7 @@ filename=None, file=DESCRIPTOR, containing_type=None, + create_key=_descriptor._internal_create_key, fields=[ _descriptor.FieldDescriptor( name="tasks", @@ -652,6 +660,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="next_page_token", @@ -662,7 +671,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -670,6 +679,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), ], extensions=[], @@ -691,6 +701,7 @@ filename=None, file=DESCRIPTOR, containing_type=None, + create_key=_descriptor._internal_create_key, fields=[ _descriptor.FieldDescriptor( name="name", @@ -701,16 +712,15 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b( - "\340A\002\372A \n\036cloudtasks.googleapis.com/Task" - ), + serialized_options=b"\340A\002\372A \n\036cloudtasks.googleapis.com/Task", file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="response_view", @@ -729,6 +739,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), ], extensions=[], @@ -750,6 +761,7 @@ filename=None, file=DESCRIPTOR, containing_type=None, + create_key=_descriptor._internal_create_key, fields=[ _descriptor.FieldDescriptor( name="parent", @@ -760,16 +772,15 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b( - "\340A\002\372A \022\036cloudtasks.googleapis.com/Task" - ), + serialized_options=b"\340A\002\372A \022\036cloudtasks.googleapis.com/Task", file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="task", @@ -786,8 +797,9 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b("\340A\002"), + serialized_options=b"\340A\002", file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="response_view", @@ -806,6 +818,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), ], extensions=[], @@ -827,6 +840,7 @@ filename=None, file=DESCRIPTOR, containing_type=None, + create_key=_descriptor._internal_create_key, fields=[ _descriptor.FieldDescriptor( name="name", @@ -837,17 +851,16 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b( - "\340A\002\372A \n\036cloudtasks.googleapis.com/Task" - ), + serialized_options=b"\340A\002\372A \n\036cloudtasks.googleapis.com/Task", file=DESCRIPTOR, - ) + create_key=_descriptor._internal_create_key, + ), ], extensions=[], nested_types=[], @@ -868,6 +881,7 @@ filename=None, file=DESCRIPTOR, containing_type=None, + create_key=_descriptor._internal_create_key, fields=[ _descriptor.FieldDescriptor( name="parent", @@ -878,16 +892,15 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b( - "\340A\002\372A \022\036cloudtasks.googleapis.com/Task" - ), + serialized_options=b"\340A\002\372A \022\036cloudtasks.googleapis.com/Task", file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="max_tasks", @@ -906,6 +919,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="lease_duration", @@ -922,8 +936,9 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b("\340A\002"), + serialized_options=b"\340A\002", file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="response_view", @@ -942,6 +957,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="filter", @@ -952,7 +968,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -960,6 +976,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), ], extensions=[], @@ -981,6 +998,7 @@ filename=None, file=DESCRIPTOR, containing_type=None, + create_key=_descriptor._internal_create_key, fields=[ _descriptor.FieldDescriptor( name="tasks", @@ -999,7 +1017,8 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, - ) + create_key=_descriptor._internal_create_key, + ), ], extensions=[], nested_types=[], @@ -1020,6 +1039,7 @@ filename=None, file=DESCRIPTOR, containing_type=None, + create_key=_descriptor._internal_create_key, fields=[ _descriptor.FieldDescriptor( name="name", @@ -1030,16 +1050,15 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b( - "\340A\002\372A \n\036cloudtasks.googleapis.com/Task" - ), + serialized_options=b"\340A\002\372A \n\036cloudtasks.googleapis.com/Task", file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="schedule_time", @@ -1056,8 +1075,9 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b("\340A\002"), + serialized_options=b"\340A\002", file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), ], extensions=[], @@ -1079,6 +1099,7 @@ filename=None, file=DESCRIPTOR, containing_type=None, + create_key=_descriptor._internal_create_key, fields=[ _descriptor.FieldDescriptor( name="name", @@ -1089,16 +1110,15 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b( - "\340A\002\372A \n\036cloudtasks.googleapis.com/Task" - ), + serialized_options=b"\340A\002\372A \n\036cloudtasks.googleapis.com/Task", file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="schedule_time", @@ -1115,8 +1135,9 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b("\340A\002"), + serialized_options=b"\340A\002", file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="lease_duration", @@ -1133,8 +1154,9 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b("\340A\002"), + serialized_options=b"\340A\002", file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="response_view", @@ -1153,6 +1175,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), ], extensions=[], @@ -1174,6 +1197,7 @@ filename=None, file=DESCRIPTOR, containing_type=None, + create_key=_descriptor._internal_create_key, fields=[ _descriptor.FieldDescriptor( name="name", @@ -1184,16 +1208,15 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b( - "\340A\002\372A \n\036cloudtasks.googleapis.com/Task" - ), + serialized_options=b"\340A\002\372A \n\036cloudtasks.googleapis.com/Task", file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="schedule_time", @@ -1210,8 +1233,9 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b("\340A\002"), + serialized_options=b"\340A\002", file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="response_view", @@ -1230,6 +1254,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), ], extensions=[], @@ -1251,6 +1276,7 @@ filename=None, file=DESCRIPTOR, containing_type=None, + create_key=_descriptor._internal_create_key, fields=[ _descriptor.FieldDescriptor( name="name", @@ -1261,16 +1287,15 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b( - "\340A\002\372A \n\036cloudtasks.googleapis.com/Task" - ), + serialized_options=b"\340A\002\372A \n\036cloudtasks.googleapis.com/Task", file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="response_view", @@ -1289,6 +1314,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), ], extensions=[], @@ -1385,11 +1411,12 @@ ListQueuesRequest = _reflection.GeneratedProtocolMessageType( "ListQueuesRequest", (_message.Message,), - dict( - DESCRIPTOR=_LISTQUEUESREQUEST, - __module__="google.cloud.tasks_v2beta2.proto.cloudtasks_pb2", - __doc__="""Request message for + { + "DESCRIPTOR": _LISTQUEUESREQUEST, + "__module__": "google.cloud.tasks_v2beta2.proto.cloudtasks_pb2", + "__doc__": """Request message for [ListQueues][google.cloud.tasks.v2beta2.CloudTasks.ListQueues]. + Attributes: parent: Required. The location name. For example: @@ -1399,42 +1426,43 @@ [Queue][google.cloud.tasks.v2beta2.Queue] field can be used as a filter and several operators as supported. For example: ``<=, <, >=, >, !=, =, :``. The filter syntax is the same as - described in `Stackdriver's Advanced Logs Filters `_. Sample - filter "app\_engine\_http\_target: \*". Note that using - filters might cause fewer queues than the requested\_page size - to be returned. + filter "app_engine_http_target: \*". Note that using filters + might cause fewer queues than the requested_page size to be + returned. page_size: Requested page size. The maximum page size is 9800. If unspecified, the page size will be the maximum. Fewer queues than requested might be returned, even if more queues exist; - use the [next\_page\_token][google.cloud.tasks.v2beta2.ListQue - uesResponse.next\_page\_token] in the response to determine if + use the [next_page_token][google.cloud.tasks.v2beta2.ListQueue + sResponse.next_page_token] in the response to determine if more queues exist. page_token: A token identifying the page of results to return. To request - the first page results, page\_token must be empty. To request - the next page of results, page\_token must be the value of [ne - xt\_page\_token][google.cloud.tasks.v2beta2.ListQueuesResponse - .next\_page\_token] returned from the previous call to + the first page results, page_token must be empty. To request + the next page of results, page_token must be the value of [nex + t_page_token][google.cloud.tasks.v2beta2.ListQueuesResponse.ne + xt_page_token] returned from the previous call to [ListQueues][google.cloud.tasks.v2beta2.CloudTasks.ListQueues] method. It is an error to switch the value of the [filter][google.cloud.tasks.v2beta2.ListQueuesRequest.filter] while iterating through pages. """, # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta2.ListQueuesRequest) - ), + }, ) _sym_db.RegisterMessage(ListQueuesRequest) ListQueuesResponse = _reflection.GeneratedProtocolMessageType( "ListQueuesResponse", (_message.Message,), - dict( - DESCRIPTOR=_LISTQUEUESRESPONSE, - __module__="google.cloud.tasks_v2beta2.proto.cloudtasks_pb2", - __doc__="""Response message for + { + "DESCRIPTOR": _LISTQUEUESRESPONSE, + "__module__": "google.cloud.tasks_v2beta2.proto.cloudtasks_pb2", + "__doc__": """Response message for [ListQueues][google.cloud.tasks.v2beta2.CloudTasks.ListQueues]. + Attributes: queues: The list of queues. @@ -1442,75 +1470,78 @@ A token to retrieve next page of results. To return the next page of results, call [ListQueues][google.cloud.tasks.v2beta2.CloudTasks.ListQueues] - with this value as the [page\_token][google.cloud.tasks.v2beta - 2.ListQueuesRequest.page\_token]. If the next\_page\_token is + with this value as the [page_token][google.cloud.tasks.v2beta2 + .ListQueuesRequest.page_token]. If the next_page_token is empty, there are no more results. The page token is valid for only 2 hours. """, # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta2.ListQueuesResponse) - ), + }, ) _sym_db.RegisterMessage(ListQueuesResponse) GetQueueRequest = _reflection.GeneratedProtocolMessageType( "GetQueueRequest", (_message.Message,), - dict( - DESCRIPTOR=_GETQUEUEREQUEST, - __module__="google.cloud.tasks_v2beta2.proto.cloudtasks_pb2", - __doc__="""Request message for + { + "DESCRIPTOR": _GETQUEUEREQUEST, + "__module__": "google.cloud.tasks_v2beta2.proto.cloudtasks_pb2", + "__doc__": """Request message for [GetQueue][google.cloud.tasks.v2beta2.CloudTasks.GetQueue]. + Attributes: name: Required. The resource name of the queue. For example: ``projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`` """, # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta2.GetQueueRequest) - ), + }, ) _sym_db.RegisterMessage(GetQueueRequest) CreateQueueRequest = _reflection.GeneratedProtocolMessageType( "CreateQueueRequest", (_message.Message,), - dict( - DESCRIPTOR=_CREATEQUEUEREQUEST, - __module__="google.cloud.tasks_v2beta2.proto.cloudtasks_pb2", - __doc__="""Request message for + { + "DESCRIPTOR": _CREATEQUEUEREQUEST, + "__module__": "google.cloud.tasks_v2beta2.proto.cloudtasks_pb2", + "__doc__": """Request message for [CreateQueue][google.cloud.tasks.v2beta2.CloudTasks.CreateQueue]. + Attributes: parent: Required. The location name in which the queue will be created. For example: ``projects/PROJECT_ID/locations/LOCATION_ID`` The list of - allowed locations can be obtained by calling Cloud Tasks' + allowed locations can be obtained by calling Cloud Tasks’ implementation of [ListLocations][google.cloud.location.Locati ons.ListLocations]. queue: - Required. The queue to create. [Queue's + Required. The queue to create. [Queue’s name][google.cloud.tasks.v2beta2.Queue.name] cannot be the same as an existing queue. """, # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta2.CreateQueueRequest) - ), + }, ) _sym_db.RegisterMessage(CreateQueueRequest) UpdateQueueRequest = _reflection.GeneratedProtocolMessageType( "UpdateQueueRequest", (_message.Message,), - dict( - DESCRIPTOR=_UPDATEQUEUEREQUEST, - __module__="google.cloud.tasks_v2beta2.proto.cloudtasks_pb2", - __doc__="""Request message for + { + "DESCRIPTOR": _UPDATEQUEUEREQUEST, + "__module__": "google.cloud.tasks_v2beta2.proto.cloudtasks_pb2", + "__doc__": """Request message for [UpdateQueue][google.cloud.tasks.v2beta2.CloudTasks.UpdateQueue]. + Attributes: queue: - Required. The queue to create or update. The queue's + Required. The queue to create or update. The queue’s [name][google.cloud.tasks.v2beta2.Queue.name] must be specified. Output only fields cannot be modified using UpdateQueue. Any value specified for an output only field will - be ignored. The queue's + be ignored. The queue’s [name][google.cloud.tasks.v2beta2.Queue.name] cannot be changed. update_mask: @@ -1518,98 +1549,103 @@ updated. If empty, then all fields will be updated. """, # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta2.UpdateQueueRequest) - ), + }, ) _sym_db.RegisterMessage(UpdateQueueRequest) DeleteQueueRequest = _reflection.GeneratedProtocolMessageType( "DeleteQueueRequest", (_message.Message,), - dict( - DESCRIPTOR=_DELETEQUEUEREQUEST, - __module__="google.cloud.tasks_v2beta2.proto.cloudtasks_pb2", - __doc__="""Request message for + { + "DESCRIPTOR": _DELETEQUEUEREQUEST, + "__module__": "google.cloud.tasks_v2beta2.proto.cloudtasks_pb2", + "__doc__": """Request message for [DeleteQueue][google.cloud.tasks.v2beta2.CloudTasks.DeleteQueue]. + Attributes: name: Required. The queue name. For example: ``projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`` """, # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta2.DeleteQueueRequest) - ), + }, ) _sym_db.RegisterMessage(DeleteQueueRequest) PurgeQueueRequest = _reflection.GeneratedProtocolMessageType( "PurgeQueueRequest", (_message.Message,), - dict( - DESCRIPTOR=_PURGEQUEUEREQUEST, - __module__="google.cloud.tasks_v2beta2.proto.cloudtasks_pb2", - __doc__="""Request message for + { + "DESCRIPTOR": _PURGEQUEUEREQUEST, + "__module__": "google.cloud.tasks_v2beta2.proto.cloudtasks_pb2", + "__doc__": """Request message for [PurgeQueue][google.cloud.tasks.v2beta2.CloudTasks.PurgeQueue]. + Attributes: name: Required. The queue name. For example: ``projects/PROJECT_ID/location/LOCATION_ID/queues/QUEUE_ID`` """, # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta2.PurgeQueueRequest) - ), + }, ) _sym_db.RegisterMessage(PurgeQueueRequest) PauseQueueRequest = _reflection.GeneratedProtocolMessageType( "PauseQueueRequest", (_message.Message,), - dict( - DESCRIPTOR=_PAUSEQUEUEREQUEST, - __module__="google.cloud.tasks_v2beta2.proto.cloudtasks_pb2", - __doc__="""Request message for + { + "DESCRIPTOR": _PAUSEQUEUEREQUEST, + "__module__": "google.cloud.tasks_v2beta2.proto.cloudtasks_pb2", + "__doc__": """Request message for [PauseQueue][google.cloud.tasks.v2beta2.CloudTasks.PauseQueue]. + Attributes: name: Required. The queue name. For example: ``projects/PROJECT_ID/location/LOCATION_ID/queues/QUEUE_ID`` """, # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta2.PauseQueueRequest) - ), + }, ) _sym_db.RegisterMessage(PauseQueueRequest) ResumeQueueRequest = _reflection.GeneratedProtocolMessageType( "ResumeQueueRequest", (_message.Message,), - dict( - DESCRIPTOR=_RESUMEQUEUEREQUEST, - __module__="google.cloud.tasks_v2beta2.proto.cloudtasks_pb2", - __doc__="""Request message for + { + "DESCRIPTOR": _RESUMEQUEUEREQUEST, + "__module__": "google.cloud.tasks_v2beta2.proto.cloudtasks_pb2", + "__doc__": """Request message for [ResumeQueue][google.cloud.tasks.v2beta2.CloudTasks.ResumeQueue]. + Attributes: name: Required. The queue name. For example: ``projects/PROJECT_ID/location/LOCATION_ID/queues/QUEUE_ID`` """, # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta2.ResumeQueueRequest) - ), + }, ) _sym_db.RegisterMessage(ResumeQueueRequest) ListTasksRequest = _reflection.GeneratedProtocolMessageType( "ListTasksRequest", (_message.Message,), - dict( - DESCRIPTOR=_LISTTASKSREQUEST, - __module__="google.cloud.tasks_v2beta2.proto.cloudtasks_pb2", - __doc__="""Request message for listing tasks using + { + "DESCRIPTOR": _LISTTASKSREQUEST, + "__module__": "google.cloud.tasks_v2beta2.proto.cloudtasks_pb2", + "__doc__": """Request message for listing tasks using [ListTasks][google.cloud.tasks.v2beta2.CloudTasks.ListTasks]. + Attributes: parent: Required. The queue name. For example: ``projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`` response_view: - The response\_view specifies which subset of the + The response_view specifies which subset of the [Task][google.cloud.tasks.v2beta2.Task] will be returned. By - default response\_view is + default response_view is [BASIC][google.cloud.tasks.v2beta2.Task.View.BASIC]; not all information is retrieved by default because some data, such as payloads, might be desirable to return only when needed @@ -1621,33 +1657,34 @@ [Task][google.cloud.tasks.v2beta2.Task] resource. page_size: Maximum page size. Fewer tasks than requested might be - returned, even if more tasks exist; use [next\_page\_token][go - ogle.cloud.tasks.v2beta2.ListTasksResponse.next\_page\_token] - in the response to determine if more tasks exist. The maximum + returned, even if more tasks exist; use [next_page_token][goog + le.cloud.tasks.v2beta2.ListTasksResponse.next_page_token] in + the response to determine if more tasks exist. The maximum page size is 1000. If unspecified, the page size will be the maximum. page_token: A token identifying the page of results to return. To request - the first page results, page\_token must be empty. To request - the next page of results, page\_token must be the value of [ne - xt\_page\_token][google.cloud.tasks.v2beta2.ListTasksResponse. - next\_page\_token] returned from the previous call to + the first page results, page_token must be empty. To request + the next page of results, page_token must be the value of [nex + t_page_token][google.cloud.tasks.v2beta2.ListTasksResponse.nex + t_page_token] returned from the previous call to [ListTasks][google.cloud.tasks.v2beta2.CloudTasks.ListTasks] method. The page token is valid for only 2 hours. """, # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta2.ListTasksRequest) - ), + }, ) _sym_db.RegisterMessage(ListTasksRequest) ListTasksResponse = _reflection.GeneratedProtocolMessageType( "ListTasksResponse", (_message.Message,), - dict( - DESCRIPTOR=_LISTTASKSRESPONSE, - __module__="google.cloud.tasks_v2beta2.proto.cloudtasks_pb2", - __doc__="""Response message for listing tasks using + { + "DESCRIPTOR": _LISTTASKSRESPONSE, + "__module__": "google.cloud.tasks_v2beta2.proto.cloudtasks_pb2", + "__doc__": """Response message for listing tasks using [ListTasks][google.cloud.tasks.v2beta2.CloudTasks.ListTasks]. + Attributes: tasks: The list of tasks. @@ -1655,31 +1692,32 @@ A token to retrieve next page of results. To return the next page of results, call [ListTasks][google.cloud.tasks.v2beta2.CloudTasks.ListTasks] - with this value as the [page\_token][google.cloud.tasks.v2beta - 2.ListTasksRequest.page\_token]. If the next\_page\_token is + with this value as the [page_token][google.cloud.tasks.v2beta2 + .ListTasksRequest.page_token]. If the next_page_token is empty, there are no more results. """, # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta2.ListTasksResponse) - ), + }, ) _sym_db.RegisterMessage(ListTasksResponse) GetTaskRequest = _reflection.GeneratedProtocolMessageType( "GetTaskRequest", (_message.Message,), - dict( - DESCRIPTOR=_GETTASKREQUEST, - __module__="google.cloud.tasks_v2beta2.proto.cloudtasks_pb2", - __doc__="""Request message for getting a task using + { + "DESCRIPTOR": _GETTASKREQUEST, + "__module__": "google.cloud.tasks_v2beta2.proto.cloudtasks_pb2", + "__doc__": """Request message for getting a task using [GetTask][google.cloud.tasks.v2beta2.CloudTasks.GetTask]. + Attributes: name: Required. The task name. For example: ``projects/PROJECT_ID/lo cations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`` response_view: - The response\_view specifies which subset of the + The response_view specifies which subset of the [Task][google.cloud.tasks.v2beta2.Task] will be returned. By - default response\_view is + default response_view is [BASIC][google.cloud.tasks.v2beta2.Task.View.BASIC]; not all information is retrieved by default because some data, such as payloads, might be desirable to return only when needed @@ -1691,18 +1729,19 @@ [Task][google.cloud.tasks.v2beta2.Task] resource. """, # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta2.GetTaskRequest) - ), + }, ) _sym_db.RegisterMessage(GetTaskRequest) CreateTaskRequest = _reflection.GeneratedProtocolMessageType( "CreateTaskRequest", (_message.Message,), - dict( - DESCRIPTOR=_CREATETASKREQUEST, - __module__="google.cloud.tasks_v2beta2.proto.cloudtasks_pb2", - __doc__="""Request message for + { + "DESCRIPTOR": _CREATETASKREQUEST, + "__module__": "google.cloud.tasks_v2beta2.proto.cloudtasks_pb2", + "__doc__": """Request message for [CreateTask][google.cloud.tasks.v2beta2.CloudTasks.CreateTask]. + Attributes: parent: Required. The queue name. For example: @@ -1715,19 +1754,19 @@ [name][google.cloud.tasks.v2beta2.Task.name]. If a name is not specified then the system will generate a random unique task id, which will be set in the task returned in the - [response][google.cloud.tasks.v2beta2.Task.name]. If [schedul - e\_time][google.cloud.tasks.v2beta2.Task.schedule\_time] is - not set or is in the past then Cloud Tasks will set it to the - current time. Task De-duplication: Explicitly specifying a - task ID enables task de-duplication. If a task's ID is + [response][google.cloud.tasks.v2beta2.Task.name]. If + [schedule_time][google.cloud.tasks.v2beta2.Task.schedule_time] + is not set or is in the past then Cloud Tasks will set it to + the current time. Task De-duplication: Explicitly specifying + a task ID enables task de-duplication. If a task’s ID is identical to that of an existing task or a task that was deleted or completed recently then the call will fail with - [ALREADY\_EXISTS][google.rpc.Code.ALREADY\_EXISTS]. If the - task's queue was created using Cloud Tasks, then another task - with the same name can't be created for ~1hour after the - original task was deleted or completed. If the task's queue + [ALREADY_EXISTS][google.rpc.Code.ALREADY_EXISTS]. If the + task’s queue was created using Cloud Tasks, then another task + with the same name can’t be created for ~1hour after the + original task was deleted or completed. If the task’s queue was created using queue.yaml or queue.xml, then another task - with the same name can't be created for ~9days after the + with the same name can’t be created for ~9days after the original task was deleted or completed. Because there is an extra lookup cost to identify duplicate task names, these [CreateTask][google.cloud.tasks.v2beta2.CloudTasks.CreateTask] @@ -1739,9 +1778,9 @@ infrastructure relies on an approximately uniform distribution of task ids to store and serve tasks efficiently. response_view: - The response\_view specifies which subset of the + The response_view specifies which subset of the [Task][google.cloud.tasks.v2beta2.Task] will be returned. By - default response\_view is + default response_view is [BASIC][google.cloud.tasks.v2beta2.Task.View.BASIC]; not all information is retrieved by default because some data, such as payloads, might be desirable to return only when needed @@ -1753,36 +1792,38 @@ [Task][google.cloud.tasks.v2beta2.Task] resource. """, # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta2.CreateTaskRequest) - ), + }, ) _sym_db.RegisterMessage(CreateTaskRequest) DeleteTaskRequest = _reflection.GeneratedProtocolMessageType( "DeleteTaskRequest", (_message.Message,), - dict( - DESCRIPTOR=_DELETETASKREQUEST, - __module__="google.cloud.tasks_v2beta2.proto.cloudtasks_pb2", - __doc__="""Request message for deleting a task using + { + "DESCRIPTOR": _DELETETASKREQUEST, + "__module__": "google.cloud.tasks_v2beta2.proto.cloudtasks_pb2", + "__doc__": """Request message for deleting a task using [DeleteTask][google.cloud.tasks.v2beta2.CloudTasks.DeleteTask]. + Attributes: name: Required. The task name. For example: ``projects/PROJECT_ID/lo cations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`` """, # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta2.DeleteTaskRequest) - ), + }, ) _sym_db.RegisterMessage(DeleteTaskRequest) LeaseTasksRequest = _reflection.GeneratedProtocolMessageType( "LeaseTasksRequest", (_message.Message,), - dict( - DESCRIPTOR=_LEASETASKSREQUEST, - __module__="google.cloud.tasks_v2beta2.proto.cloudtasks_pb2", - __doc__="""Request message for leasing tasks using + { + "DESCRIPTOR": _LEASETASKSREQUEST, + "__module__": "google.cloud.tasks_v2beta2.proto.cloudtasks_pb2", + "__doc__": """Request message for leasing tasks using [LeaseTasks][google.cloud.tasks.v2beta2.CloudTasks.LeaseTasks]. + Attributes: parent: Required. The queue name. For example: @@ -1798,27 +1839,28 @@ lease_duration: Required. The duration of the lease. Each task returned in the [response][google.cloud.tasks.v2beta2.LeaseTasksResponse] - will have its [schedule\_time][google.cloud.tasks.v2beta2.Task - .schedule\_time] set to the current time plus the - ``lease_duration``. The task is leased until its [schedule\_ti - me][google.cloud.tasks.v2beta2.Task.schedule\_time]; thus, the - task will not be returned to another + will have its + [schedule_time][google.cloud.tasks.v2beta2.Task.schedule_time] + set to the current time plus the ``lease_duration``. The task + is leased until its [schedule_time][google.cloud.tasks.v2beta2 + .Task.schedule_time]; thus, the task will not be returned to + another [LeaseTasks][google.cloud.tasks.v2beta2.CloudTasks.LeaseTasks] - call before its [schedule\_time][google.cloud.tasks.v2beta2.Ta - sk.schedule\_time]. After the worker has successfully - finished the work associated with the task, the worker must - call via [AcknowledgeTask][google.cloud.tasks.v2beta2.CloudTas - ks.AcknowledgeTask] before the [schedule\_time][google.cloud.t - asks.v2beta2.Task.schedule\_time]. Otherwise the task will be - returned to a later + call before its [schedule_time][google.cloud.tasks.v2beta2.Tas + k.schedule_time]. After the worker has successfully finished + the work associated with the task, the worker must call via [A + cknowledgeTask][google.cloud.tasks.v2beta2.CloudTasks.Acknowle + dgeTask] before the [schedule_time][google.cloud.tasks.v2beta2 + .Task.schedule_time]. Otherwise the task will be returned to a + later [LeaseTasks][google.cloud.tasks.v2beta2.CloudTasks.LeaseTasks] call so that another worker can retry it. The maximum lease duration is 1 week. ``lease_duration`` will be truncated to the nearest second. response_view: - The response\_view specifies which subset of the + The response_view specifies which subset of the [Task][google.cloud.tasks.v2beta2.Task] will be returned. By - default response\_view is + default response_view is [BASIC][google.cloud.tasks.v2beta2.Task.View.BASIC]; not all information is retrieved by default because some data, such as payloads, might be desirable to return only when needed @@ -1836,8 +1878,8 @@ [tag][google.cloud.tasks.v2beta2.PullMessage.tag] is equal to ````. ```` must be less than 500 characters. When ``filter`` is set to ``tag_function=oldest_tag()``, only - tasks which have the same tag as the task with the oldest [sch - edule\_time][google.cloud.tasks.v2beta2.Task.schedule\_time] + tasks which have the same tag as the task with the oldest + [schedule_time][google.cloud.tasks.v2beta2.Task.schedule_time] will be returned. Grammar Syntax: - ``filter = "tag=" tag | "tag_function=" function`` - ``tag = string`` - ``function = "oldest_tag()"`` The ``oldest_tag()`` function returns @@ -1846,51 +1888,53 @@ tags to be either string or `bytes `_, only UTF-8 encoded - tags can be used in Cloud Tasks. Tag which aren't UTF-8 - encoded can't be used in the + tags can be used in Cloud Tasks. Tag which aren’t UTF-8 + encoded can’t be used in the [filter][google.cloud.tasks.v2beta2.LeaseTasksRequest.filter] - and the task's + and the task’s [tag][google.cloud.tasks.v2beta2.PullMessage.tag] will be displayed as empty in Cloud Tasks. """, # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta2.LeaseTasksRequest) - ), + }, ) _sym_db.RegisterMessage(LeaseTasksRequest) LeaseTasksResponse = _reflection.GeneratedProtocolMessageType( "LeaseTasksResponse", (_message.Message,), - dict( - DESCRIPTOR=_LEASETASKSRESPONSE, - __module__="google.cloud.tasks_v2beta2.proto.cloudtasks_pb2", - __doc__="""Response message for leasing tasks using + { + "DESCRIPTOR": _LEASETASKSRESPONSE, + "__module__": "google.cloud.tasks_v2beta2.proto.cloudtasks_pb2", + "__doc__": """Response message for leasing tasks using [LeaseTasks][google.cloud.tasks.v2beta2.CloudTasks.LeaseTasks]. + Attributes: tasks: The leased tasks. """, # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta2.LeaseTasksResponse) - ), + }, ) _sym_db.RegisterMessage(LeaseTasksResponse) AcknowledgeTaskRequest = _reflection.GeneratedProtocolMessageType( "AcknowledgeTaskRequest", (_message.Message,), - dict( - DESCRIPTOR=_ACKNOWLEDGETASKREQUEST, - __module__="google.cloud.tasks_v2beta2.proto.cloudtasks_pb2", - __doc__="""Request message for acknowledging a task using [AcknowledgeTask][googl + { + "DESCRIPTOR": _ACKNOWLEDGETASKREQUEST, + "__module__": "google.cloud.tasks_v2beta2.proto.cloudtasks_pb2", + "__doc__": """Request message for acknowledging a task using [AcknowledgeTask][googl e.cloud.tasks.v2beta2.CloudTasks.AcknowledgeTask]. + Attributes: name: Required. The task name. For example: ``projects/PROJECT_ID/lo cations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`` schedule_time: - Required. The task's current schedule time, available in the [ - schedule\_time][google.cloud.tasks.v2beta2.Task.schedule\_time - ] returned by + Required. The task’s current schedule time, available in the + [schedule_time][google.cloud.tasks.v2beta2.Task.schedule_time] + returned by [LeaseTasks][google.cloud.tasks.v2beta2.CloudTasks.LeaseTasks] response or [RenewLease][google.cloud.tasks.v2beta2.CloudTasks.RenewLease] @@ -1898,26 +1942,27 @@ currently holds the lease. """, # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta2.AcknowledgeTaskRequest) - ), + }, ) _sym_db.RegisterMessage(AcknowledgeTaskRequest) RenewLeaseRequest = _reflection.GeneratedProtocolMessageType( "RenewLeaseRequest", (_message.Message,), - dict( - DESCRIPTOR=_RENEWLEASEREQUEST, - __module__="google.cloud.tasks_v2beta2.proto.cloudtasks_pb2", - __doc__="""Request message for renewing a lease using + { + "DESCRIPTOR": _RENEWLEASEREQUEST, + "__module__": "google.cloud.tasks_v2beta2.proto.cloudtasks_pb2", + "__doc__": """Request message for renewing a lease using [RenewLease][google.cloud.tasks.v2beta2.CloudTasks.RenewLease]. + Attributes: name: Required. The task name. For example: ``projects/PROJECT_ID/lo cations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`` schedule_time: - Required. The task's current schedule time, available in the [ - schedule\_time][google.cloud.tasks.v2beta2.Task.schedule\_time - ] returned by + Required. The task’s current schedule time, available in the + [schedule_time][google.cloud.tasks.v2beta2.Task.schedule_time] + returned by [LeaseTasks][google.cloud.tasks.v2beta2.CloudTasks.LeaseTasks] response or [RenewLease][google.cloud.tasks.v2beta2.CloudTasks.RenewLease] @@ -1928,9 +1973,9 @@ The maximum lease duration is 1 week. ``lease_duration`` will be truncated to the nearest second. response_view: - The response\_view specifies which subset of the + The response_view specifies which subset of the [Task][google.cloud.tasks.v2beta2.Task] will be returned. By - default response\_view is + default response_view is [BASIC][google.cloud.tasks.v2beta2.Task.View.BASIC]; not all information is retrieved by default because some data, such as payloads, might be desirable to return only when needed @@ -1942,35 +1987,36 @@ [Task][google.cloud.tasks.v2beta2.Task] resource. """, # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta2.RenewLeaseRequest) - ), + }, ) _sym_db.RegisterMessage(RenewLeaseRequest) CancelLeaseRequest = _reflection.GeneratedProtocolMessageType( "CancelLeaseRequest", (_message.Message,), - dict( - DESCRIPTOR=_CANCELLEASEREQUEST, - __module__="google.cloud.tasks_v2beta2.proto.cloudtasks_pb2", - __doc__="""Request message for canceling a lease using + { + "DESCRIPTOR": _CANCELLEASEREQUEST, + "__module__": "google.cloud.tasks_v2beta2.proto.cloudtasks_pb2", + "__doc__": """Request message for canceling a lease using [CancelLease][google.cloud.tasks.v2beta2.CloudTasks.CancelLease]. + Attributes: name: Required. The task name. For example: ``projects/PROJECT_ID/lo cations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`` schedule_time: - Required. The task's current schedule time, available in the [ - schedule\_time][google.cloud.tasks.v2beta2.Task.schedule\_time - ] returned by + Required. The task’s current schedule time, available in the + [schedule_time][google.cloud.tasks.v2beta2.Task.schedule_time] + returned by [LeaseTasks][google.cloud.tasks.v2beta2.CloudTasks.LeaseTasks] response or [RenewLease][google.cloud.tasks.v2beta2.CloudTasks.RenewLease] response. This restriction is to ensure that your worker currently holds the lease. response_view: - The response\_view specifies which subset of the + The response_view specifies which subset of the [Task][google.cloud.tasks.v2beta2.Task] will be returned. By - default response\_view is + default response_view is [BASIC][google.cloud.tasks.v2beta2.Task.View.BASIC]; not all information is retrieved by default because some data, such as payloads, might be desirable to return only when needed @@ -1982,26 +2028,27 @@ [Task][google.cloud.tasks.v2beta2.Task] resource. """, # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta2.CancelLeaseRequest) - ), + }, ) _sym_db.RegisterMessage(CancelLeaseRequest) RunTaskRequest = _reflection.GeneratedProtocolMessageType( "RunTaskRequest", (_message.Message,), - dict( - DESCRIPTOR=_RUNTASKREQUEST, - __module__="google.cloud.tasks_v2beta2.proto.cloudtasks_pb2", - __doc__="""Request message for forcing a task to run now using + { + "DESCRIPTOR": _RUNTASKREQUEST, + "__module__": "google.cloud.tasks_v2beta2.proto.cloudtasks_pb2", + "__doc__": """Request message for forcing a task to run now using [RunTask][google.cloud.tasks.v2beta2.CloudTasks.RunTask]. + Attributes: name: Required. The task name. For example: ``projects/PROJECT_ID/lo cations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`` response_view: - The response\_view specifies which subset of the + The response_view specifies which subset of the [Task][google.cloud.tasks.v2beta2.Task] will be returned. By - default response\_view is + default response_view is [BASIC][google.cloud.tasks.v2beta2.Task.View.BASIC]; not all information is retrieved by default because some data, such as payloads, might be desirable to return only when needed @@ -2013,7 +2060,7 @@ [Task][google.cloud.tasks.v2beta2.Task] resource. """, # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta2.RunTaskRequest) - ), + }, ) _sym_db.RegisterMessage(RunTaskRequest) @@ -2049,9 +2096,8 @@ full_name="google.cloud.tasks.v2beta2.CloudTasks", file=DESCRIPTOR, index=0, - serialized_options=_b( - "\312A\031cloudtasks.googleapis.com\322A.https://www.googleapis.com/auth/cloud-platform" - ), + serialized_options=b"\312A\031cloudtasks.googleapis.com\322A.https://www.googleapis.com/auth/cloud-platform", + create_key=_descriptor._internal_create_key, serialized_start=3044, serialized_end=6712, methods=[ @@ -2062,9 +2108,8 @@ containing_service=None, input_type=_LISTQUEUESREQUEST, output_type=_LISTQUEUESRESPONSE, - serialized_options=_b( - "\202\323\344\223\0021\022//v2beta2/{parent=projects/*/locations/*}/queues\332A\006parent" - ), + serialized_options=b"\202\323\344\223\0021\022//v2beta2/{parent=projects/*/locations/*}/queues\332A\006parent", + create_key=_descriptor._internal_create_key, ), _descriptor.MethodDescriptor( name="GetQueue", @@ -2073,9 +2118,8 @@ containing_service=None, input_type=_GETQUEUEREQUEST, output_type=google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_queue__pb2._QUEUE, - serialized_options=_b( - "\202\323\344\223\0021\022//v2beta2/{name=projects/*/locations/*/queues/*}\332A\004name" - ), + serialized_options=b"\202\323\344\223\0021\022//v2beta2/{name=projects/*/locations/*/queues/*}\332A\004name", + create_key=_descriptor._internal_create_key, ), _descriptor.MethodDescriptor( name="CreateQueue", @@ -2084,9 +2128,8 @@ containing_service=None, input_type=_CREATEQUEUEREQUEST, output_type=google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_queue__pb2._QUEUE, - serialized_options=_b( - '\202\323\344\223\0028"//v2beta2/{parent=projects/*/locations/*}/queues:\005queue\332A\014parent,queue' - ), + serialized_options=b'\202\323\344\223\0028"//v2beta2/{parent=projects/*/locations/*}/queues:\005queue\332A\014parent,queue', + create_key=_descriptor._internal_create_key, ), _descriptor.MethodDescriptor( name="UpdateQueue", @@ -2095,9 +2138,8 @@ containing_service=None, input_type=_UPDATEQUEUEREQUEST, output_type=google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_queue__pb2._QUEUE, - serialized_options=_b( - "\202\323\344\223\002>25/v2beta2/{queue.name=projects/*/locations/*/queues/*}:\005queue\332A\021queue,update_mask" - ), + serialized_options=b"\202\323\344\223\002>25/v2beta2/{queue.name=projects/*/locations/*/queues/*}:\005queue\332A\021queue,update_mask", + create_key=_descriptor._internal_create_key, ), _descriptor.MethodDescriptor( name="DeleteQueue", @@ -2106,9 +2148,8 @@ containing_service=None, input_type=_DELETEQUEUEREQUEST, output_type=google_dot_protobuf_dot_empty__pb2._EMPTY, - serialized_options=_b( - "\202\323\344\223\0021*//v2beta2/{name=projects/*/locations/*/queues/*}\332A\004name" - ), + serialized_options=b"\202\323\344\223\0021*//v2beta2/{name=projects/*/locations/*/queues/*}\332A\004name", + create_key=_descriptor._internal_create_key, ), _descriptor.MethodDescriptor( name="PurgeQueue", @@ -2117,9 +2158,8 @@ containing_service=None, input_type=_PURGEQUEUEREQUEST, output_type=google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_queue__pb2._QUEUE, - serialized_options=_b( - '\202\323\344\223\002:"5/v2beta2/{name=projects/*/locations/*/queues/*}:purge:\001*\332A\004name' - ), + serialized_options=b'\202\323\344\223\002:"5/v2beta2/{name=projects/*/locations/*/queues/*}:purge:\001*\332A\004name', + create_key=_descriptor._internal_create_key, ), _descriptor.MethodDescriptor( name="PauseQueue", @@ -2128,9 +2168,8 @@ containing_service=None, input_type=_PAUSEQUEUEREQUEST, output_type=google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_queue__pb2._QUEUE, - serialized_options=_b( - '\202\323\344\223\002:"5/v2beta2/{name=projects/*/locations/*/queues/*}:pause:\001*\332A\004name' - ), + serialized_options=b'\202\323\344\223\002:"5/v2beta2/{name=projects/*/locations/*/queues/*}:pause:\001*\332A\004name', + create_key=_descriptor._internal_create_key, ), _descriptor.MethodDescriptor( name="ResumeQueue", @@ -2139,9 +2178,8 @@ containing_service=None, input_type=_RESUMEQUEUEREQUEST, output_type=google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_queue__pb2._QUEUE, - serialized_options=_b( - '\202\323\344\223\002;"6/v2beta2/{name=projects/*/locations/*/queues/*}:resume:\001*\332A\004name' - ), + serialized_options=b'\202\323\344\223\002;"6/v2beta2/{name=projects/*/locations/*/queues/*}:resume:\001*\332A\004name', + create_key=_descriptor._internal_create_key, ), _descriptor.MethodDescriptor( name="GetIamPolicy", @@ -2150,9 +2188,8 @@ containing_service=None, input_type=google_dot_iam_dot_v1_dot_iam__policy__pb2._GETIAMPOLICYREQUEST, output_type=google_dot_iam_dot_v1_dot_policy__pb2._POLICY, - serialized_options=_b( - '\202\323\344\223\002E"@/v2beta2/{resource=projects/*/locations/*/queues/*}:getIamPolicy:\001*\332A\010resource' - ), + serialized_options=b'\202\323\344\223\002E"@/v2beta2/{resource=projects/*/locations/*/queues/*}:getIamPolicy:\001*\332A\010resource', + create_key=_descriptor._internal_create_key, ), _descriptor.MethodDescriptor( name="SetIamPolicy", @@ -2161,9 +2198,8 @@ containing_service=None, input_type=google_dot_iam_dot_v1_dot_iam__policy__pb2._SETIAMPOLICYREQUEST, output_type=google_dot_iam_dot_v1_dot_policy__pb2._POLICY, - serialized_options=_b( - '\202\323\344\223\002E"@/v2beta2/{resource=projects/*/locations/*/queues/*}:setIamPolicy:\001*\332A\017resource,policy' - ), + serialized_options=b'\202\323\344\223\002E"@/v2beta2/{resource=projects/*/locations/*/queues/*}:setIamPolicy:\001*\332A\017resource,policy', + create_key=_descriptor._internal_create_key, ), _descriptor.MethodDescriptor( name="TestIamPermissions", @@ -2172,9 +2208,8 @@ containing_service=None, input_type=google_dot_iam_dot_v1_dot_iam__policy__pb2._TESTIAMPERMISSIONSREQUEST, output_type=google_dot_iam_dot_v1_dot_iam__policy__pb2._TESTIAMPERMISSIONSRESPONSE, - serialized_options=_b( - '\202\323\344\223\002K"F/v2beta2/{resource=projects/*/locations/*/queues/*}:testIamPermissions:\001*\332A\024resource,permissions' - ), + serialized_options=b'\202\323\344\223\002K"F/v2beta2/{resource=projects/*/locations/*/queues/*}:testIamPermissions:\001*\332A\024resource,permissions', + create_key=_descriptor._internal_create_key, ), _descriptor.MethodDescriptor( name="ListTasks", @@ -2183,9 +2218,8 @@ containing_service=None, input_type=_LISTTASKSREQUEST, output_type=_LISTTASKSRESPONSE, - serialized_options=_b( - "\202\323\344\223\0029\0227/v2beta2/{parent=projects/*/locations/*/queues/*}/tasks\332A\006parent" - ), + serialized_options=b"\202\323\344\223\0029\0227/v2beta2/{parent=projects/*/locations/*/queues/*}/tasks\332A\006parent", + create_key=_descriptor._internal_create_key, ), _descriptor.MethodDescriptor( name="GetTask", @@ -2194,9 +2228,8 @@ containing_service=None, input_type=_GETTASKREQUEST, output_type=google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_task__pb2._TASK, - serialized_options=_b( - "\202\323\344\223\0029\0227/v2beta2/{name=projects/*/locations/*/queues/*/tasks/*}\332A\004name" - ), + serialized_options=b"\202\323\344\223\0029\0227/v2beta2/{name=projects/*/locations/*/queues/*/tasks/*}\332A\004name", + create_key=_descriptor._internal_create_key, ), _descriptor.MethodDescriptor( name="CreateTask", @@ -2205,9 +2238,8 @@ containing_service=None, input_type=_CREATETASKREQUEST, output_type=google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_task__pb2._TASK, - serialized_options=_b( - '\202\323\344\223\002<"7/v2beta2/{parent=projects/*/locations/*/queues/*}/tasks:\001*\332A\013parent,task' - ), + serialized_options=b'\202\323\344\223\002<"7/v2beta2/{parent=projects/*/locations/*/queues/*}/tasks:\001*\332A\013parent,task', + create_key=_descriptor._internal_create_key, ), _descriptor.MethodDescriptor( name="DeleteTask", @@ -2216,9 +2248,8 @@ containing_service=None, input_type=_DELETETASKREQUEST, output_type=google_dot_protobuf_dot_empty__pb2._EMPTY, - serialized_options=_b( - "\202\323\344\223\0029*7/v2beta2/{name=projects/*/locations/*/queues/*/tasks/*}\332A\004name" - ), + serialized_options=b"\202\323\344\223\0029*7/v2beta2/{name=projects/*/locations/*/queues/*/tasks/*}\332A\004name", + create_key=_descriptor._internal_create_key, ), _descriptor.MethodDescriptor( name="LeaseTasks", @@ -2227,9 +2258,8 @@ containing_service=None, input_type=_LEASETASKSREQUEST, output_type=_LEASETASKSRESPONSE, - serialized_options=_b( - '\202\323\344\223\002B"=/v2beta2/{parent=projects/*/locations/*/queues/*}/tasks:lease:\001*\332A\025parent,lease_duration' - ), + serialized_options=b'\202\323\344\223\002B"=/v2beta2/{parent=projects/*/locations/*/queues/*}/tasks:lease:\001*\332A\025parent,lease_duration', + create_key=_descriptor._internal_create_key, ), _descriptor.MethodDescriptor( name="AcknowledgeTask", @@ -2238,9 +2268,8 @@ containing_service=None, input_type=_ACKNOWLEDGETASKREQUEST, output_type=google_dot_protobuf_dot_empty__pb2._EMPTY, - serialized_options=_b( - '\202\323\344\223\002H"C/v2beta2/{name=projects/*/locations/*/queues/*/tasks/*}:acknowledge:\001*\332A\022name,schedule_time' - ), + serialized_options=b'\202\323\344\223\002H"C/v2beta2/{name=projects/*/locations/*/queues/*/tasks/*}:acknowledge:\001*\332A\022name,schedule_time', + create_key=_descriptor._internal_create_key, ), _descriptor.MethodDescriptor( name="RenewLease", @@ -2249,9 +2278,8 @@ containing_service=None, input_type=_RENEWLEASEREQUEST, output_type=google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_task__pb2._TASK, - serialized_options=_b( - '\202\323\344\223\002G"B/v2beta2/{name=projects/*/locations/*/queues/*/tasks/*}:renewLease:\001*\332A!name,schedule_time,lease_duration' - ), + serialized_options=b'\202\323\344\223\002G"B/v2beta2/{name=projects/*/locations/*/queues/*/tasks/*}:renewLease:\001*\332A!name,schedule_time,lease_duration', + create_key=_descriptor._internal_create_key, ), _descriptor.MethodDescriptor( name="CancelLease", @@ -2260,9 +2288,8 @@ containing_service=None, input_type=_CANCELLEASEREQUEST, output_type=google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_task__pb2._TASK, - serialized_options=_b( - '\202\323\344\223\002H"C/v2beta2/{name=projects/*/locations/*/queues/*/tasks/*}:cancelLease:\001*\332A\022name,schedule_time' - ), + serialized_options=b'\202\323\344\223\002H"C/v2beta2/{name=projects/*/locations/*/queues/*/tasks/*}:cancelLease:\001*\332A\022name,schedule_time', + create_key=_descriptor._internal_create_key, ), _descriptor.MethodDescriptor( name="RunTask", @@ -2271,9 +2298,8 @@ containing_service=None, input_type=_RUNTASKREQUEST, output_type=google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_task__pb2._TASK, - serialized_options=_b( - '\202\323\344\223\002@";/v2beta2/{name=projects/*/locations/*/queues/*/tasks/*}:run:\001*\332A\004name' - ), + serialized_options=b'\202\323\344\223\002@";/v2beta2/{name=projects/*/locations/*/queues/*/tasks/*}:run:\001*\332A\004name', + create_key=_descriptor._internal_create_key, ), ], ) diff --git a/google/cloud/tasks_v2beta2/proto/cloudtasks_pb2_grpc.py b/google/cloud/tasks_v2beta2/proto/cloudtasks_pb2_grpc.py index 040424a3..8b3a5531 100644 --- a/google/cloud/tasks_v2beta2/proto/cloudtasks_pb2_grpc.py +++ b/google/cloud/tasks_v2beta2/proto/cloudtasks_pb2_grpc.py @@ -1,4 +1,5 @@ # Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT! +"""Client and server classes corresponding to protobuf-defined services.""" import grpc from google.cloud.tasks_v2beta2.proto import ( @@ -17,15 +18,15 @@ class CloudTasksStub(object): """Cloud Tasks allows developers to manage the execution of background - work in their applications. - """ + work in their applications. + """ def __init__(self, channel): """Constructor. - Args: - channel: A grpc.Channel. - """ + Args: + channel: A grpc.Channel. + """ self.ListQueues = channel.unary_unary( "/google.cloud.tasks.v2beta2.CloudTasks/ListQueues", request_serializer=google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_cloudtasks__pb2.ListQueuesRequest.SerializeToString, @@ -130,21 +131,21 @@ def __init__(self, channel): class CloudTasksServicer(object): """Cloud Tasks allows developers to manage the execution of background - work in their applications. - """ + work in their applications. + """ def ListQueues(self, request, context): """Lists queues. - Queues are returned in lexicographical order. - """ + Queues are returned in lexicographical order. + """ context.set_code(grpc.StatusCode.UNIMPLEMENTED) context.set_details("Method not implemented!") raise NotImplementedError("Method not implemented!") def GetQueue(self, request, context): """Gets a queue. - """ + """ context.set_code(grpc.StatusCode.UNIMPLEMENTED) context.set_details("Method not implemented!") raise NotImplementedError("Method not implemented!") @@ -152,17 +153,17 @@ def GetQueue(self, request, context): def CreateQueue(self, request, context): """Creates a queue. - Queues created with this method allow tasks to live for a maximum of 31 - days. After a task is 31 days old, the task will be deleted regardless of whether - it was dispatched or not. - - WARNING: Using this method may have unintended side effects if you are - using an App Engine `queue.yaml` or `queue.xml` file to manage your queues. - Read - [Overview of Queue Management and - queue.yaml](https://cloud.google.com/tasks/docs/queue-yaml) before using - this method. - """ + Queues created with this method allow tasks to live for a maximum of 31 + days. After a task is 31 days old, the task will be deleted regardless of whether + it was dispatched or not. + + WARNING: Using this method may have unintended side effects if you are + using an App Engine `queue.yaml` or `queue.xml` file to manage your queues. + Read + [Overview of Queue Management and + queue.yaml](https://cloud.google.com/tasks/docs/queue-yaml) before using + this method. + """ context.set_code(grpc.StatusCode.UNIMPLEMENTED) context.set_details("Method not implemented!") raise NotImplementedError("Method not implemented!") @@ -170,20 +171,20 @@ def CreateQueue(self, request, context): def UpdateQueue(self, request, context): """Updates a queue. - This method creates the queue if it does not exist and updates - the queue if it does exist. + This method creates the queue if it does not exist and updates + the queue if it does exist. - Queues created with this method allow tasks to live for a maximum of 31 - days. After a task is 31 days old, the task will be deleted regardless of whether - it was dispatched or not. + Queues created with this method allow tasks to live for a maximum of 31 + days. After a task is 31 days old, the task will be deleted regardless of whether + it was dispatched or not. - WARNING: Using this method may have unintended side effects if you are - using an App Engine `queue.yaml` or `queue.xml` file to manage your queues. - Read - [Overview of Queue Management and - queue.yaml](https://cloud.google.com/tasks/docs/queue-yaml) before using - this method. - """ + WARNING: Using this method may have unintended side effects if you are + using an App Engine `queue.yaml` or `queue.xml` file to manage your queues. + Read + [Overview of Queue Management and + queue.yaml](https://cloud.google.com/tasks/docs/queue-yaml) before using + this method. + """ context.set_code(grpc.StatusCode.UNIMPLEMENTED) context.set_details("Method not implemented!") raise NotImplementedError("Method not implemented!") @@ -191,18 +192,18 @@ def UpdateQueue(self, request, context): def DeleteQueue(self, request, context): """Deletes a queue. - This command will delete the queue even if it has tasks in it. + This command will delete the queue even if it has tasks in it. - Note: If you delete a queue, a queue with the same name can't be created - for 7 days. + Note: If you delete a queue, a queue with the same name can't be created + for 7 days. - WARNING: Using this method may have unintended side effects if you are - using an App Engine `queue.yaml` or `queue.xml` file to manage your queues. - Read - [Overview of Queue Management and - queue.yaml](https://cloud.google.com/tasks/docs/queue-yaml) before using - this method. - """ + WARNING: Using this method may have unintended side effects if you are + using an App Engine `queue.yaml` or `queue.xml` file to manage your queues. + Read + [Overview of Queue Management and + queue.yaml](https://cloud.google.com/tasks/docs/queue-yaml) before using + this method. + """ context.set_code(grpc.StatusCode.UNIMPLEMENTED) context.set_details("Method not implemented!") raise NotImplementedError("Method not implemented!") @@ -210,11 +211,11 @@ def DeleteQueue(self, request, context): def PurgeQueue(self, request, context): """Purges a queue by deleting all of its tasks. - All tasks created before this method is called are permanently deleted. + All tasks created before this method is called are permanently deleted. - Purge operations can take up to one minute to take effect. Tasks - might be dispatched before the purge takes effect. A purge is irreversible. - """ + Purge operations can take up to one minute to take effect. Tasks + might be dispatched before the purge takes effect. A purge is irreversible. + """ context.set_code(grpc.StatusCode.UNIMPLEMENTED) context.set_details("Method not implemented!") raise NotImplementedError("Method not implemented!") @@ -222,12 +223,12 @@ def PurgeQueue(self, request, context): def PauseQueue(self, request, context): """Pauses the queue. - If a queue is paused then the system will stop dispatching tasks - until the queue is resumed via - [ResumeQueue][google.cloud.tasks.v2beta2.CloudTasks.ResumeQueue]. Tasks can still be added - when the queue is paused. A queue is paused if its - [state][google.cloud.tasks.v2beta2.Queue.state] is [PAUSED][google.cloud.tasks.v2beta2.Queue.State.PAUSED]. - """ + If a queue is paused then the system will stop dispatching tasks + until the queue is resumed via + [ResumeQueue][google.cloud.tasks.v2beta2.CloudTasks.ResumeQueue]. Tasks can still be added + when the queue is paused. A queue is paused if its + [state][google.cloud.tasks.v2beta2.Queue.state] is [PAUSED][google.cloud.tasks.v2beta2.Queue.State.PAUSED]. + """ context.set_code(grpc.StatusCode.UNIMPLEMENTED) context.set_details("Method not implemented!") raise NotImplementedError("Method not implemented!") @@ -235,63 +236,63 @@ def PauseQueue(self, request, context): def ResumeQueue(self, request, context): """Resume a queue. - This method resumes a queue after it has been - [PAUSED][google.cloud.tasks.v2beta2.Queue.State.PAUSED] or - [DISABLED][google.cloud.tasks.v2beta2.Queue.State.DISABLED]. The state of a queue is stored - in the queue's [state][google.cloud.tasks.v2beta2.Queue.state]; after calling this method it - will be set to [RUNNING][google.cloud.tasks.v2beta2.Queue.State.RUNNING]. - - WARNING: Resuming many high-QPS queues at the same time can - lead to target overloading. If you are resuming high-QPS - queues, follow the 500/50/5 pattern described in - [Managing Cloud Tasks Scaling - Risks](https://cloud.google.com/tasks/docs/manage-cloud-task-scaling). - """ + This method resumes a queue after it has been + [PAUSED][google.cloud.tasks.v2beta2.Queue.State.PAUSED] or + [DISABLED][google.cloud.tasks.v2beta2.Queue.State.DISABLED]. The state of a queue is stored + in the queue's [state][google.cloud.tasks.v2beta2.Queue.state]; after calling this method it + will be set to [RUNNING][google.cloud.tasks.v2beta2.Queue.State.RUNNING]. + + WARNING: Resuming many high-QPS queues at the same time can + lead to target overloading. If you are resuming high-QPS + queues, follow the 500/50/5 pattern described in + [Managing Cloud Tasks Scaling + Risks](https://cloud.google.com/tasks/docs/manage-cloud-task-scaling). + """ context.set_code(grpc.StatusCode.UNIMPLEMENTED) context.set_details("Method not implemented!") raise NotImplementedError("Method not implemented!") def GetIamPolicy(self, request, context): """Gets the access control policy for a [Queue][google.cloud.tasks.v2beta2.Queue]. - Returns an empty policy if the resource exists and does not have a policy - set. + Returns an empty policy if the resource exists and does not have a policy + set. - Authorization requires the following - [Google IAM](https://cloud.google.com/iam) permission on the specified - resource parent: + Authorization requires the following + [Google IAM](https://cloud.google.com/iam) permission on the specified + resource parent: - * `cloudtasks.queues.getIamPolicy` - """ + * `cloudtasks.queues.getIamPolicy` + """ context.set_code(grpc.StatusCode.UNIMPLEMENTED) context.set_details("Method not implemented!") raise NotImplementedError("Method not implemented!") def SetIamPolicy(self, request, context): """Sets the access control policy for a [Queue][google.cloud.tasks.v2beta2.Queue]. Replaces any existing - policy. + policy. - Note: The Cloud Console does not check queue-level IAM permissions yet. - Project-level permissions are required to use the Cloud Console. + Note: The Cloud Console does not check queue-level IAM permissions yet. + Project-level permissions are required to use the Cloud Console. - Authorization requires the following - [Google IAM](https://cloud.google.com/iam) permission on the specified - resource parent: + Authorization requires the following + [Google IAM](https://cloud.google.com/iam) permission on the specified + resource parent: - * `cloudtasks.queues.setIamPolicy` - """ + * `cloudtasks.queues.setIamPolicy` + """ context.set_code(grpc.StatusCode.UNIMPLEMENTED) context.set_details("Method not implemented!") raise NotImplementedError("Method not implemented!") def TestIamPermissions(self, request, context): """Returns permissions that a caller has on a [Queue][google.cloud.tasks.v2beta2.Queue]. - If the resource does not exist, this will return an empty set of - permissions, not a [NOT_FOUND][google.rpc.Code.NOT_FOUND] error. + If the resource does not exist, this will return an empty set of + permissions, not a [NOT_FOUND][google.rpc.Code.NOT_FOUND] error. - Note: This operation is designed to be used for building permission-aware - UIs and command-line tools, not for authorization checking. This operation - may "fail open" without warning. - """ + Note: This operation is designed to be used for building permission-aware + UIs and command-line tools, not for authorization checking. This operation + may "fail open" without warning. + """ context.set_code(grpc.StatusCode.UNIMPLEMENTED) context.set_details("Method not implemented!") raise NotImplementedError("Method not implemented!") @@ -299,21 +300,21 @@ def TestIamPermissions(self, request, context): def ListTasks(self, request, context): """Lists the tasks in a queue. - By default, only the [BASIC][google.cloud.tasks.v2beta2.Task.View.BASIC] view is retrieved - due to performance considerations; - [response_view][google.cloud.tasks.v2beta2.ListTasksRequest.response_view] controls the - subset of information which is returned. + By default, only the [BASIC][google.cloud.tasks.v2beta2.Task.View.BASIC] view is retrieved + due to performance considerations; + [response_view][google.cloud.tasks.v2beta2.ListTasksRequest.response_view] controls the + subset of information which is returned. - The tasks may be returned in any order. The ordering may change at any - time. - """ + The tasks may be returned in any order. The ordering may change at any + time. + """ context.set_code(grpc.StatusCode.UNIMPLEMENTED) context.set_details("Method not implemented!") raise NotImplementedError("Method not implemented!") def GetTask(self, request, context): """Gets a task. - """ + """ context.set_code(grpc.StatusCode.UNIMPLEMENTED) context.set_details("Method not implemented!") raise NotImplementedError("Method not implemented!") @@ -321,12 +322,12 @@ def GetTask(self, request, context): def CreateTask(self, request, context): """Creates a task and adds it to a queue. - Tasks cannot be updated after creation; there is no UpdateTask command. + Tasks cannot be updated after creation; there is no UpdateTask command. - * For [App Engine queues][google.cloud.tasks.v2beta2.AppEngineHttpTarget], the maximum task size is - 100KB. - * For [pull queues][google.cloud.tasks.v2beta2.PullTarget], the maximum task size is 1MB. - """ + * For [App Engine queues][google.cloud.tasks.v2beta2.AppEngineHttpTarget], the maximum task size is + 100KB. + * For [pull queues][google.cloud.tasks.v2beta2.PullTarget], the maximum task size is 1MB. + """ context.set_code(grpc.StatusCode.UNIMPLEMENTED) context.set_details("Method not implemented!") raise NotImplementedError("Method not implemented!") @@ -334,38 +335,38 @@ def CreateTask(self, request, context): def DeleteTask(self, request, context): """Deletes a task. - A task can be deleted if it is scheduled or dispatched. A task - cannot be deleted if it has completed successfully or permanently - failed. - """ + A task can be deleted if it is scheduled or dispatched. A task + cannot be deleted if it has completed successfully or permanently + failed. + """ context.set_code(grpc.StatusCode.UNIMPLEMENTED) context.set_details("Method not implemented!") raise NotImplementedError("Method not implemented!") def LeaseTasks(self, request, context): """Leases tasks from a pull queue for - [lease_duration][google.cloud.tasks.v2beta2.LeaseTasksRequest.lease_duration]. - - This method is invoked by the worker to obtain a lease. The - worker must acknowledge the task via - [AcknowledgeTask][google.cloud.tasks.v2beta2.CloudTasks.AcknowledgeTask] after they have - performed the work associated with the task. - - The [payload][google.cloud.tasks.v2beta2.PullMessage.payload] is intended to store data that - the worker needs to perform the work associated with the task. To - return the payloads in the [response][google.cloud.tasks.v2beta2.LeaseTasksResponse], set - [response_view][google.cloud.tasks.v2beta2.LeaseTasksRequest.response_view] to - [FULL][google.cloud.tasks.v2beta2.Task.View.FULL]. - - A maximum of 10 qps of [LeaseTasks][google.cloud.tasks.v2beta2.CloudTasks.LeaseTasks] - requests are allowed per - queue. [RESOURCE_EXHAUSTED][google.rpc.Code.RESOURCE_EXHAUSTED] - is returned when this limit is - exceeded. [RESOURCE_EXHAUSTED][google.rpc.Code.RESOURCE_EXHAUSTED] - is also returned when - [max_tasks_dispatched_per_second][google.cloud.tasks.v2beta2.RateLimits.max_tasks_dispatched_per_second] - is exceeded. - """ + [lease_duration][google.cloud.tasks.v2beta2.LeaseTasksRequest.lease_duration]. + + This method is invoked by the worker to obtain a lease. The + worker must acknowledge the task via + [AcknowledgeTask][google.cloud.tasks.v2beta2.CloudTasks.AcknowledgeTask] after they have + performed the work associated with the task. + + The [payload][google.cloud.tasks.v2beta2.PullMessage.payload] is intended to store data that + the worker needs to perform the work associated with the task. To + return the payloads in the [response][google.cloud.tasks.v2beta2.LeaseTasksResponse], set + [response_view][google.cloud.tasks.v2beta2.LeaseTasksRequest.response_view] to + [FULL][google.cloud.tasks.v2beta2.Task.View.FULL]. + + A maximum of 10 qps of [LeaseTasks][google.cloud.tasks.v2beta2.CloudTasks.LeaseTasks] + requests are allowed per + queue. [RESOURCE_EXHAUSTED][google.rpc.Code.RESOURCE_EXHAUSTED] + is returned when this limit is + exceeded. [RESOURCE_EXHAUSTED][google.rpc.Code.RESOURCE_EXHAUSTED] + is also returned when + [max_tasks_dispatched_per_second][google.cloud.tasks.v2beta2.RateLimits.max_tasks_dispatched_per_second] + is exceeded. + """ context.set_code(grpc.StatusCode.UNIMPLEMENTED) context.set_details("Method not implemented!") raise NotImplementedError("Method not implemented!") @@ -373,18 +374,18 @@ def LeaseTasks(self, request, context): def AcknowledgeTask(self, request, context): """Acknowledges a pull task. - The worker, that is, the entity that - [leased][google.cloud.tasks.v2beta2.CloudTasks.LeaseTasks] this task must call this method - to indicate that the work associated with the task has finished. - - The worker must acknowledge a task within the - [lease_duration][google.cloud.tasks.v2beta2.LeaseTasksRequest.lease_duration] or the lease - will expire and the task will become available to be leased - again. After the task is acknowledged, it will not be returned - by a later [LeaseTasks][google.cloud.tasks.v2beta2.CloudTasks.LeaseTasks], - [GetTask][google.cloud.tasks.v2beta2.CloudTasks.GetTask], or - [ListTasks][google.cloud.tasks.v2beta2.CloudTasks.ListTasks]. - """ + The worker, that is, the entity that + [leased][google.cloud.tasks.v2beta2.CloudTasks.LeaseTasks] this task must call this method + to indicate that the work associated with the task has finished. + + The worker must acknowledge a task within the + [lease_duration][google.cloud.tasks.v2beta2.LeaseTasksRequest.lease_duration] or the lease + will expire and the task will become available to be leased + again. After the task is acknowledged, it will not be returned + by a later [LeaseTasks][google.cloud.tasks.v2beta2.CloudTasks.LeaseTasks], + [GetTask][google.cloud.tasks.v2beta2.CloudTasks.GetTask], or + [ListTasks][google.cloud.tasks.v2beta2.CloudTasks.ListTasks]. + """ context.set_code(grpc.StatusCode.UNIMPLEMENTED) context.set_details("Method not implemented!") raise NotImplementedError("Method not implemented!") @@ -392,10 +393,10 @@ def AcknowledgeTask(self, request, context): def RenewLease(self, request, context): """Renew the current lease of a pull task. - The worker can use this method to extend the lease by a new - duration, starting from now. The new task lease will be - returned in the task's [schedule_time][google.cloud.tasks.v2beta2.Task.schedule_time]. - """ + The worker can use this method to extend the lease by a new + duration, starting from now. The new task lease will be + returned in the task's [schedule_time][google.cloud.tasks.v2beta2.Task.schedule_time]. + """ context.set_code(grpc.StatusCode.UNIMPLEMENTED) context.set_details("Method not implemented!") raise NotImplementedError("Method not implemented!") @@ -403,11 +404,11 @@ def RenewLease(self, request, context): def CancelLease(self, request, context): """Cancel a pull task's lease. - The worker can use this method to cancel a task's lease by - setting its [schedule_time][google.cloud.tasks.v2beta2.Task.schedule_time] to now. This will - make the task available to be leased to the next caller of - [LeaseTasks][google.cloud.tasks.v2beta2.CloudTasks.LeaseTasks]. - """ + The worker can use this method to cancel a task's lease by + setting its [schedule_time][google.cloud.tasks.v2beta2.Task.schedule_time] to now. This will + make the task available to be leased to the next caller of + [LeaseTasks][google.cloud.tasks.v2beta2.CloudTasks.LeaseTasks]. + """ context.set_code(grpc.StatusCode.UNIMPLEMENTED) context.set_details("Method not implemented!") raise NotImplementedError("Method not implemented!") @@ -415,32 +416,32 @@ def CancelLease(self, request, context): def RunTask(self, request, context): """Forces a task to run now. - When this method is called, Cloud Tasks will dispatch the task, even if - the task is already running, the queue has reached its [RateLimits][google.cloud.tasks.v2beta2.RateLimits] or - is [PAUSED][google.cloud.tasks.v2beta2.Queue.State.PAUSED]. + When this method is called, Cloud Tasks will dispatch the task, even if + the task is already running, the queue has reached its [RateLimits][google.cloud.tasks.v2beta2.RateLimits] or + is [PAUSED][google.cloud.tasks.v2beta2.Queue.State.PAUSED]. - This command is meant to be used for manual debugging. For - example, [RunTask][google.cloud.tasks.v2beta2.CloudTasks.RunTask] can be used to retry a failed - task after a fix has been made or to manually force a task to be - dispatched now. + This command is meant to be used for manual debugging. For + example, [RunTask][google.cloud.tasks.v2beta2.CloudTasks.RunTask] can be used to retry a failed + task after a fix has been made or to manually force a task to be + dispatched now. - The dispatched task is returned. That is, the task that is returned - contains the [status][google.cloud.tasks.v2beta2.Task.status] after the task is dispatched but - before the task is received by its target. + The dispatched task is returned. That is, the task that is returned + contains the [status][google.cloud.tasks.v2beta2.Task.status] after the task is dispatched but + before the task is received by its target. - If Cloud Tasks receives a successful response from the task's - target, then the task will be deleted; otherwise the task's - [schedule_time][google.cloud.tasks.v2beta2.Task.schedule_time] will be reset to the time that - [RunTask][google.cloud.tasks.v2beta2.CloudTasks.RunTask] was called plus the retry delay specified - in the queue's [RetryConfig][google.cloud.tasks.v2beta2.RetryConfig]. + If Cloud Tasks receives a successful response from the task's + target, then the task will be deleted; otherwise the task's + [schedule_time][google.cloud.tasks.v2beta2.Task.schedule_time] will be reset to the time that + [RunTask][google.cloud.tasks.v2beta2.CloudTasks.RunTask] was called plus the retry delay specified + in the queue's [RetryConfig][google.cloud.tasks.v2beta2.RetryConfig]. - [RunTask][google.cloud.tasks.v2beta2.CloudTasks.RunTask] returns - [NOT_FOUND][google.rpc.Code.NOT_FOUND] when it is called on a - task that has already succeeded or permanently failed. + [RunTask][google.cloud.tasks.v2beta2.CloudTasks.RunTask] returns + [NOT_FOUND][google.rpc.Code.NOT_FOUND] when it is called on a + task that has already succeeded or permanently failed. - [RunTask][google.cloud.tasks.v2beta2.CloudTasks.RunTask] cannot be called on a - [pull task][google.cloud.tasks.v2beta2.PullMessage]. - """ + [RunTask][google.cloud.tasks.v2beta2.CloudTasks.RunTask] cannot be called on a + [pull task][google.cloud.tasks.v2beta2.PullMessage]. + """ context.set_code(grpc.StatusCode.UNIMPLEMENTED) context.set_details("Method not implemented!") raise NotImplementedError("Method not implemented!") @@ -553,3 +554,550 @@ def add_CloudTasksServicer_to_server(servicer, server): "google.cloud.tasks.v2beta2.CloudTasks", rpc_method_handlers ) server.add_generic_rpc_handlers((generic_handler,)) + + +# This class is part of an EXPERIMENTAL API. +class CloudTasks(object): + """Cloud Tasks allows developers to manage the execution of background + work in their applications. + """ + + @staticmethod + def ListQueues( + request, + target, + options=(), + channel_credentials=None, + call_credentials=None, + compression=None, + wait_for_ready=None, + timeout=None, + metadata=None, + ): + return grpc.experimental.unary_unary( + request, + target, + "/google.cloud.tasks.v2beta2.CloudTasks/ListQueues", + google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_cloudtasks__pb2.ListQueuesRequest.SerializeToString, + google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_cloudtasks__pb2.ListQueuesResponse.FromString, + options, + channel_credentials, + call_credentials, + compression, + wait_for_ready, + timeout, + metadata, + ) + + @staticmethod + def GetQueue( + request, + target, + options=(), + channel_credentials=None, + call_credentials=None, + compression=None, + wait_for_ready=None, + timeout=None, + metadata=None, + ): + return grpc.experimental.unary_unary( + request, + target, + "/google.cloud.tasks.v2beta2.CloudTasks/GetQueue", + google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_cloudtasks__pb2.GetQueueRequest.SerializeToString, + google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_queue__pb2.Queue.FromString, + options, + channel_credentials, + call_credentials, + compression, + wait_for_ready, + timeout, + metadata, + ) + + @staticmethod + def CreateQueue( + request, + target, + options=(), + channel_credentials=None, + call_credentials=None, + compression=None, + wait_for_ready=None, + timeout=None, + metadata=None, + ): + return grpc.experimental.unary_unary( + request, + target, + "/google.cloud.tasks.v2beta2.CloudTasks/CreateQueue", + google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_cloudtasks__pb2.CreateQueueRequest.SerializeToString, + google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_queue__pb2.Queue.FromString, + options, + channel_credentials, + call_credentials, + compression, + wait_for_ready, + timeout, + metadata, + ) + + @staticmethod + def UpdateQueue( + request, + target, + options=(), + channel_credentials=None, + call_credentials=None, + compression=None, + wait_for_ready=None, + timeout=None, + metadata=None, + ): + return grpc.experimental.unary_unary( + request, + target, + "/google.cloud.tasks.v2beta2.CloudTasks/UpdateQueue", + google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_cloudtasks__pb2.UpdateQueueRequest.SerializeToString, + google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_queue__pb2.Queue.FromString, + options, + channel_credentials, + call_credentials, + compression, + wait_for_ready, + timeout, + metadata, + ) + + @staticmethod + def DeleteQueue( + request, + target, + options=(), + channel_credentials=None, + call_credentials=None, + compression=None, + wait_for_ready=None, + timeout=None, + metadata=None, + ): + return grpc.experimental.unary_unary( + request, + target, + "/google.cloud.tasks.v2beta2.CloudTasks/DeleteQueue", + google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_cloudtasks__pb2.DeleteQueueRequest.SerializeToString, + google_dot_protobuf_dot_empty__pb2.Empty.FromString, + options, + channel_credentials, + call_credentials, + compression, + wait_for_ready, + timeout, + metadata, + ) + + @staticmethod + def PurgeQueue( + request, + target, + options=(), + channel_credentials=None, + call_credentials=None, + compression=None, + wait_for_ready=None, + timeout=None, + metadata=None, + ): + return grpc.experimental.unary_unary( + request, + target, + "/google.cloud.tasks.v2beta2.CloudTasks/PurgeQueue", + google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_cloudtasks__pb2.PurgeQueueRequest.SerializeToString, + google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_queue__pb2.Queue.FromString, + options, + channel_credentials, + call_credentials, + compression, + wait_for_ready, + timeout, + metadata, + ) + + @staticmethod + def PauseQueue( + request, + target, + options=(), + channel_credentials=None, + call_credentials=None, + compression=None, + wait_for_ready=None, + timeout=None, + metadata=None, + ): + return grpc.experimental.unary_unary( + request, + target, + "/google.cloud.tasks.v2beta2.CloudTasks/PauseQueue", + google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_cloudtasks__pb2.PauseQueueRequest.SerializeToString, + google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_queue__pb2.Queue.FromString, + options, + channel_credentials, + call_credentials, + compression, + wait_for_ready, + timeout, + metadata, + ) + + @staticmethod + def ResumeQueue( + request, + target, + options=(), + channel_credentials=None, + call_credentials=None, + compression=None, + wait_for_ready=None, + timeout=None, + metadata=None, + ): + return grpc.experimental.unary_unary( + request, + target, + "/google.cloud.tasks.v2beta2.CloudTasks/ResumeQueue", + google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_cloudtasks__pb2.ResumeQueueRequest.SerializeToString, + google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_queue__pb2.Queue.FromString, + options, + channel_credentials, + call_credentials, + compression, + wait_for_ready, + timeout, + metadata, + ) + + @staticmethod + def GetIamPolicy( + request, + target, + options=(), + channel_credentials=None, + call_credentials=None, + compression=None, + wait_for_ready=None, + timeout=None, + metadata=None, + ): + return grpc.experimental.unary_unary( + request, + target, + "/google.cloud.tasks.v2beta2.CloudTasks/GetIamPolicy", + google_dot_iam_dot_v1_dot_iam__policy__pb2.GetIamPolicyRequest.SerializeToString, + google_dot_iam_dot_v1_dot_policy__pb2.Policy.FromString, + options, + channel_credentials, + call_credentials, + compression, + wait_for_ready, + timeout, + metadata, + ) + + @staticmethod + def SetIamPolicy( + request, + target, + options=(), + channel_credentials=None, + call_credentials=None, + compression=None, + wait_for_ready=None, + timeout=None, + metadata=None, + ): + return grpc.experimental.unary_unary( + request, + target, + "/google.cloud.tasks.v2beta2.CloudTasks/SetIamPolicy", + google_dot_iam_dot_v1_dot_iam__policy__pb2.SetIamPolicyRequest.SerializeToString, + google_dot_iam_dot_v1_dot_policy__pb2.Policy.FromString, + options, + channel_credentials, + call_credentials, + compression, + wait_for_ready, + timeout, + metadata, + ) + + @staticmethod + def TestIamPermissions( + request, + target, + options=(), + channel_credentials=None, + call_credentials=None, + compression=None, + wait_for_ready=None, + timeout=None, + metadata=None, + ): + return grpc.experimental.unary_unary( + request, + target, + "/google.cloud.tasks.v2beta2.CloudTasks/TestIamPermissions", + google_dot_iam_dot_v1_dot_iam__policy__pb2.TestIamPermissionsRequest.SerializeToString, + google_dot_iam_dot_v1_dot_iam__policy__pb2.TestIamPermissionsResponse.FromString, + options, + channel_credentials, + call_credentials, + compression, + wait_for_ready, + timeout, + metadata, + ) + + @staticmethod + def ListTasks( + request, + target, + options=(), + channel_credentials=None, + call_credentials=None, + compression=None, + wait_for_ready=None, + timeout=None, + metadata=None, + ): + return grpc.experimental.unary_unary( + request, + target, + "/google.cloud.tasks.v2beta2.CloudTasks/ListTasks", + google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_cloudtasks__pb2.ListTasksRequest.SerializeToString, + google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_cloudtasks__pb2.ListTasksResponse.FromString, + options, + channel_credentials, + call_credentials, + compression, + wait_for_ready, + timeout, + metadata, + ) + + @staticmethod + def GetTask( + request, + target, + options=(), + channel_credentials=None, + call_credentials=None, + compression=None, + wait_for_ready=None, + timeout=None, + metadata=None, + ): + return grpc.experimental.unary_unary( + request, + target, + "/google.cloud.tasks.v2beta2.CloudTasks/GetTask", + google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_cloudtasks__pb2.GetTaskRequest.SerializeToString, + google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_task__pb2.Task.FromString, + options, + channel_credentials, + call_credentials, + compression, + wait_for_ready, + timeout, + metadata, + ) + + @staticmethod + def CreateTask( + request, + target, + options=(), + channel_credentials=None, + call_credentials=None, + compression=None, + wait_for_ready=None, + timeout=None, + metadata=None, + ): + return grpc.experimental.unary_unary( + request, + target, + "/google.cloud.tasks.v2beta2.CloudTasks/CreateTask", + google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_cloudtasks__pb2.CreateTaskRequest.SerializeToString, + google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_task__pb2.Task.FromString, + options, + channel_credentials, + call_credentials, + compression, + wait_for_ready, + timeout, + metadata, + ) + + @staticmethod + def DeleteTask( + request, + target, + options=(), + channel_credentials=None, + call_credentials=None, + compression=None, + wait_for_ready=None, + timeout=None, + metadata=None, + ): + return grpc.experimental.unary_unary( + request, + target, + "/google.cloud.tasks.v2beta2.CloudTasks/DeleteTask", + google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_cloudtasks__pb2.DeleteTaskRequest.SerializeToString, + google_dot_protobuf_dot_empty__pb2.Empty.FromString, + options, + channel_credentials, + call_credentials, + compression, + wait_for_ready, + timeout, + metadata, + ) + + @staticmethod + def LeaseTasks( + request, + target, + options=(), + channel_credentials=None, + call_credentials=None, + compression=None, + wait_for_ready=None, + timeout=None, + metadata=None, + ): + return grpc.experimental.unary_unary( + request, + target, + "/google.cloud.tasks.v2beta2.CloudTasks/LeaseTasks", + google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_cloudtasks__pb2.LeaseTasksRequest.SerializeToString, + google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_cloudtasks__pb2.LeaseTasksResponse.FromString, + options, + channel_credentials, + call_credentials, + compression, + wait_for_ready, + timeout, + metadata, + ) + + @staticmethod + def AcknowledgeTask( + request, + target, + options=(), + channel_credentials=None, + call_credentials=None, + compression=None, + wait_for_ready=None, + timeout=None, + metadata=None, + ): + return grpc.experimental.unary_unary( + request, + target, + "/google.cloud.tasks.v2beta2.CloudTasks/AcknowledgeTask", + google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_cloudtasks__pb2.AcknowledgeTaskRequest.SerializeToString, + google_dot_protobuf_dot_empty__pb2.Empty.FromString, + options, + channel_credentials, + call_credentials, + compression, + wait_for_ready, + timeout, + metadata, + ) + + @staticmethod + def RenewLease( + request, + target, + options=(), + channel_credentials=None, + call_credentials=None, + compression=None, + wait_for_ready=None, + timeout=None, + metadata=None, + ): + return grpc.experimental.unary_unary( + request, + target, + "/google.cloud.tasks.v2beta2.CloudTasks/RenewLease", + google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_cloudtasks__pb2.RenewLeaseRequest.SerializeToString, + google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_task__pb2.Task.FromString, + options, + channel_credentials, + call_credentials, + compression, + wait_for_ready, + timeout, + metadata, + ) + + @staticmethod + def CancelLease( + request, + target, + options=(), + channel_credentials=None, + call_credentials=None, + compression=None, + wait_for_ready=None, + timeout=None, + metadata=None, + ): + return grpc.experimental.unary_unary( + request, + target, + "/google.cloud.tasks.v2beta2.CloudTasks/CancelLease", + google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_cloudtasks__pb2.CancelLeaseRequest.SerializeToString, + google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_task__pb2.Task.FromString, + options, + channel_credentials, + call_credentials, + compression, + wait_for_ready, + timeout, + metadata, + ) + + @staticmethod + def RunTask( + request, + target, + options=(), + channel_credentials=None, + call_credentials=None, + compression=None, + wait_for_ready=None, + timeout=None, + metadata=None, + ): + return grpc.experimental.unary_unary( + request, + target, + "/google.cloud.tasks.v2beta2.CloudTasks/RunTask", + google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_cloudtasks__pb2.RunTaskRequest.SerializeToString, + google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_task__pb2.Task.FromString, + options, + channel_credentials, + call_credentials, + compression, + wait_for_ready, + timeout, + metadata, + ) diff --git a/google/cloud/tasks_v2beta2/proto/queue_pb2.py b/google/cloud/tasks_v2beta2/proto/queue_pb2.py index cca7588e..8aeffd22 100644 --- a/google/cloud/tasks_v2beta2/proto/queue_pb2.py +++ b/google/cloud/tasks_v2beta2/proto/queue_pb2.py @@ -1,10 +1,7 @@ # -*- coding: utf-8 -*- # Generated by the protocol buffer compiler. DO NOT EDIT! # source: google/cloud/tasks_v2beta2/proto/queue.proto - -import sys - -_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1")) +"""Generated protocol buffer code.""" from google.protobuf import descriptor as _descriptor from google.protobuf import message as _message from google.protobuf import reflection as _reflection @@ -28,12 +25,9 @@ name="google/cloud/tasks_v2beta2/proto/queue.proto", package="google.cloud.tasks.v2beta2", syntax="proto3", - serialized_options=_b( - "\n\036com.google.cloud.tasks.v2beta2B\nQueueProtoP\001Z?google.golang.org/genproto/googleapis/cloud/tasks/v2beta2;tasks" - ), - serialized_pb=_b( - '\n,google/cloud/tasks_v2beta2/proto/queue.proto\x12\x1agoogle.cloud.tasks.v2beta2\x1a\x19google/api/resource.proto\x1a-google/cloud/tasks_v2beta2/proto/target.proto\x1a\x1egoogle/protobuf/duration.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x1cgoogle/api/annotations.proto"\xbf\x04\n\x05Queue\x12\x0c\n\x04name\x18\x01 \x01(\t\x12Q\n\x16\x61pp_engine_http_target\x18\x03 \x01(\x0b\x32/.google.cloud.tasks.v2beta2.AppEngineHttpTargetH\x00\x12=\n\x0bpull_target\x18\x04 \x01(\x0b\x32&.google.cloud.tasks.v2beta2.PullTargetH\x00\x12;\n\x0brate_limits\x18\x05 \x01(\x0b\x32&.google.cloud.tasks.v2beta2.RateLimits\x12=\n\x0cretry_config\x18\x06 \x01(\x0b\x32\'.google.cloud.tasks.v2beta2.RetryConfig\x12\x36\n\x05state\x18\x07 \x01(\x0e\x32\'.google.cloud.tasks.v2beta2.Queue.State\x12.\n\npurge_time\x18\x08 \x01(\x0b\x32\x1a.google.protobuf.Timestamp"E\n\x05State\x12\x15\n\x11STATE_UNSPECIFIED\x10\x00\x12\x0b\n\x07RUNNING\x10\x01\x12\n\n\x06PAUSED\x10\x02\x12\x0c\n\x08\x44ISABLED\x10\x03:\\\xea\x41Y\n\x1f\x63loudtasks.googleapis.com/Queue\x12\x36projects/{project}/locations/{location}/queues/{queue}B\r\n\x0btarget_type"k\n\nRateLimits\x12\'\n\x1fmax_tasks_dispatched_per_second\x18\x01 \x01(\x01\x12\x16\n\x0emax_burst_size\x18\x02 \x01(\x05\x12\x1c\n\x14max_concurrent_tasks\x18\x03 \x01(\x05"\x81\x02\n\x0bRetryConfig\x12\x16\n\x0cmax_attempts\x18\x01 \x01(\x05H\x00\x12\x1c\n\x12unlimited_attempts\x18\x02 \x01(\x08H\x00\x12\x35\n\x12max_retry_duration\x18\x03 \x01(\x0b\x32\x19.google.protobuf.Duration\x12.\n\x0bmin_backoff\x18\x04 \x01(\x0b\x32\x19.google.protobuf.Duration\x12.\n\x0bmax_backoff\x18\x05 \x01(\x0b\x32\x19.google.protobuf.Duration\x12\x15\n\rmax_doublings\x18\x06 \x01(\x05\x42\x0e\n\x0cnum_attemptsBo\n\x1e\x63om.google.cloud.tasks.v2beta2B\nQueueProtoP\x01Z?google.golang.org/genproto/googleapis/cloud/tasks/v2beta2;tasksb\x06proto3' - ), + serialized_options=b"\n\036com.google.cloud.tasks.v2beta2B\nQueueProtoP\001Z?google.golang.org/genproto/googleapis/cloud/tasks/v2beta2;tasks", + create_key=_descriptor._internal_create_key, + serialized_pb=b'\n,google/cloud/tasks_v2beta2/proto/queue.proto\x12\x1agoogle.cloud.tasks.v2beta2\x1a\x19google/api/resource.proto\x1a-google/cloud/tasks_v2beta2/proto/target.proto\x1a\x1egoogle/protobuf/duration.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x1cgoogle/api/annotations.proto"\xbf\x04\n\x05Queue\x12\x0c\n\x04name\x18\x01 \x01(\t\x12Q\n\x16\x61pp_engine_http_target\x18\x03 \x01(\x0b\x32/.google.cloud.tasks.v2beta2.AppEngineHttpTargetH\x00\x12=\n\x0bpull_target\x18\x04 \x01(\x0b\x32&.google.cloud.tasks.v2beta2.PullTargetH\x00\x12;\n\x0brate_limits\x18\x05 \x01(\x0b\x32&.google.cloud.tasks.v2beta2.RateLimits\x12=\n\x0cretry_config\x18\x06 \x01(\x0b\x32\'.google.cloud.tasks.v2beta2.RetryConfig\x12\x36\n\x05state\x18\x07 \x01(\x0e\x32\'.google.cloud.tasks.v2beta2.Queue.State\x12.\n\npurge_time\x18\x08 \x01(\x0b\x32\x1a.google.protobuf.Timestamp"E\n\x05State\x12\x15\n\x11STATE_UNSPECIFIED\x10\x00\x12\x0b\n\x07RUNNING\x10\x01\x12\n\n\x06PAUSED\x10\x02\x12\x0c\n\x08\x44ISABLED\x10\x03:\\\xea\x41Y\n\x1f\x63loudtasks.googleapis.com/Queue\x12\x36projects/{project}/locations/{location}/queues/{queue}B\r\n\x0btarget_type"k\n\nRateLimits\x12\'\n\x1fmax_tasks_dispatched_per_second\x18\x01 \x01(\x01\x12\x16\n\x0emax_burst_size\x18\x02 \x01(\x05\x12\x1c\n\x14max_concurrent_tasks\x18\x03 \x01(\x05"\x81\x02\n\x0bRetryConfig\x12\x16\n\x0cmax_attempts\x18\x01 \x01(\x05H\x00\x12\x1c\n\x12unlimited_attempts\x18\x02 \x01(\x08H\x00\x12\x35\n\x12max_retry_duration\x18\x03 \x01(\x0b\x32\x19.google.protobuf.Duration\x12.\n\x0bmin_backoff\x18\x04 \x01(\x0b\x32\x19.google.protobuf.Duration\x12.\n\x0bmax_backoff\x18\x05 \x01(\x0b\x32\x19.google.protobuf.Duration\x12\x15\n\rmax_doublings\x18\x06 \x01(\x05\x42\x0e\n\x0cnum_attemptsBo\n\x1e\x63om.google.cloud.tasks.v2beta2B\nQueueProtoP\x01Z?google.golang.org/genproto/googleapis/cloud/tasks/v2beta2;tasksb\x06proto3', dependencies=[ google_dot_api_dot_resource__pb2.DESCRIPTOR, google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_target__pb2.DESCRIPTOR, @@ -49,6 +43,7 @@ full_name="google.cloud.tasks.v2beta2.Queue.State", filename=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, values=[ _descriptor.EnumValueDescriptor( name="STATE_UNSPECIFIED", @@ -56,15 +51,31 @@ number=0, serialized_options=None, type=None, + create_key=_descriptor._internal_create_key, ), _descriptor.EnumValueDescriptor( - name="RUNNING", index=1, number=1, serialized_options=None, type=None + name="RUNNING", + index=1, + number=1, + serialized_options=None, + type=None, + create_key=_descriptor._internal_create_key, ), _descriptor.EnumValueDescriptor( - name="PAUSED", index=2, number=2, serialized_options=None, type=None + name="PAUSED", + index=2, + number=2, + serialized_options=None, + type=None, + create_key=_descriptor._internal_create_key, ), _descriptor.EnumValueDescriptor( - name="DISABLED", index=3, number=3, serialized_options=None, type=None + name="DISABLED", + index=3, + number=3, + serialized_options=None, + type=None, + create_key=_descriptor._internal_create_key, ), ], containing_type=None, @@ -81,6 +92,7 @@ filename=None, file=DESCRIPTOR, containing_type=None, + create_key=_descriptor._internal_create_key, fields=[ _descriptor.FieldDescriptor( name="name", @@ -91,7 +103,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -99,6 +111,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="app_engine_http_target", @@ -117,6 +130,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="pull_target", @@ -135,6 +149,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="rate_limits", @@ -153,6 +168,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="retry_config", @@ -171,6 +187,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="state", @@ -189,6 +206,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="purge_time", @@ -207,14 +225,13 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), ], extensions=[], nested_types=[], - enum_types=[_QUEUE_STATE], - serialized_options=_b( - "\352AY\n\037cloudtasks.googleapis.com/Queue\0226projects/{project}/locations/{location}/queues/{queue}" - ), + enum_types=[_QUEUE_STATE,], + serialized_options=b"\352AY\n\037cloudtasks.googleapis.com/Queue\0226projects/{project}/locations/{location}/queues/{queue}", is_extendable=False, syntax="proto3", extension_ranges=[], @@ -224,8 +241,9 @@ full_name="google.cloud.tasks.v2beta2.Queue.target_type", index=0, containing_type=None, + create_key=_descriptor._internal_create_key, fields=[], - ) + ), ], serialized_start=246, serialized_end=821, @@ -238,6 +256,7 @@ filename=None, file=DESCRIPTOR, containing_type=None, + create_key=_descriptor._internal_create_key, fields=[ _descriptor.FieldDescriptor( name="max_tasks_dispatched_per_second", @@ -256,6 +275,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="max_burst_size", @@ -274,6 +294,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="max_concurrent_tasks", @@ -292,6 +313,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), ], extensions=[], @@ -313,6 +335,7 @@ filename=None, file=DESCRIPTOR, containing_type=None, + create_key=_descriptor._internal_create_key, fields=[ _descriptor.FieldDescriptor( name="max_attempts", @@ -331,6 +354,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="unlimited_attempts", @@ -349,6 +373,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="max_retry_duration", @@ -367,6 +392,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="min_backoff", @@ -385,6 +411,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="max_backoff", @@ -403,6 +430,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="max_doublings", @@ -421,6 +449,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), ], extensions=[], @@ -436,8 +465,9 @@ full_name="google.cloud.tasks.v2beta2.RetryConfig.num_attempts", index=0, containing_type=None, + create_key=_descriptor._internal_create_key, fields=[], - ) + ), ], serialized_start=933, serialized_end=1190, @@ -499,12 +529,13 @@ Queue = _reflection.GeneratedProtocolMessageType( "Queue", (_message.Message,), - dict( - DESCRIPTOR=_QUEUE, - __module__="google.cloud.tasks_v2beta2.proto.queue_pb2", - __doc__="""A queue is a container of related tasks. Queues are configured to + { + "DESCRIPTOR": _QUEUE, + "__module__": "google.cloud.tasks_v2beta2.proto.queue_pb2", + "__doc__": """A queue is a container of related tasks. Queues are configured to manage how those tasks are dispatched. Configurable properties include rate limits, retry options, target types, and others. + Attributes: name: Caller-specified and required in [CreateQueue][google.cloud.ta @@ -517,7 +548,7 @@ information, see `Identifying projects `_ - ``LOCATION_ID`` - is the canonical ID for the queue's location. The list of + is the canonical ID for the queue’s location. The list of available locations can be obtained by calling [ListLocatio ns][google.cloud.location.Locations.ListLocations]. For more information, see @@ -528,7 +559,7 @@ Caller-specified and required in [CreateQueue][google.cloud.ta sks.v2beta2.CloudTasks.CreateQueue][], after which the queue config type becomes output only, though fields within the - config are mutable. The queue's target. The target applies + config are mutable. The queue’s target. The target applies to all tasks in the queue. app_engine_http_target: App Engine HTTP target. An App Engine queue is a queue that @@ -539,20 +570,21 @@ [PullTarget][google.cloud.tasks.v2beta2.PullTarget]. rate_limits: Rate limits for task dispatches. - [rate\_limits][google.cloud.tasks.v2beta2.Queue.rate\_limits] - and [retry\_config][google.cloud.tasks.v2beta2.Queue.retry\_co - nfig] are related because they both control task attempts - however they control how tasks are attempted in different - ways: - - [rate\_limits][google.cloud.tasks.v2beta2.Queue.rate\_limits] - controls the total rate of dispatches from a queue (i.e. all - traffic dispatched from the queue, regardless of whether - the dispatch is from a first attempt or a retry). - [retry - \_config][google.cloud.tasks.v2beta2.Queue.retry\_config] + [rate_limits][google.cloud.tasks.v2beta2.Queue.rate_limits] + and + [retry_config][google.cloud.tasks.v2beta2.Queue.retry_config] + are related because they both control task attempts however + they control how tasks are attempted in different ways: - + [rate_limits][google.cloud.tasks.v2beta2.Queue.rate_limits] + controls the total rate of dispatches from a queue + (i.e. all traffic dispatched from the queue, regardless of + whether the dispatch is from a first attempt or a retry). - + [retry_config][google.cloud.tasks.v2beta2.Queue.retry_config] controls what happens to particular a task after its first - attempt fails. That is, [retry\_config][google.cloud.tas - ks.v2beta2.Queue.retry\_config] controls task retries (the - second attempt, third attempt, etc). + attempt fails. That is, + [retry_config][google.cloud.tasks.v2beta2.Queue.retry_config] + controls task retries (the second attempt, third attempt, + etc). retry_config: Settings that determine the retry behavior. - For tasks created using Cloud Tasks: the queue-level retry settings @@ -575,7 +607,7 @@ purge_time: Output only. The last time this queue was purged. All tasks that were - [created][google.cloud.tasks.v2beta2.Task.create\_time] before + [created][google.cloud.tasks.v2beta2.Task.create_time] before this time were purged. A queue can be purged using [PurgeQueu e][google.cloud.tasks.v2beta2.CloudTasks.PurgeQueue], the `App Engine Task Queue SDK, or the Cloud Console `_. Since ``max_burst_size`` is output only, if [Update - Queue][google.cloud.tasks.v2beta2.CloudTasks.UpdateQueue] is + queue’s bucket runs out of tokens. The bucket will be + continuously refilled with new tokens based on [max_tasks_disp + atched_per_second][google.cloud.tasks.v2beta2.RateLimits.max_t + asks_dispatched_per_second]. Cloud Tasks will pick the value + of ``max_burst_size`` based on the value of [max_tasks_dispatc + hed_per_second][google.cloud.tasks.v2beta2.RateLimits.max_task + s_dispatched_per_second]. For App Engine queues that were + created or updated using ``queue.yaml/xml``, + ``max_burst_size`` is equal to `bucket_size `_. Since ``max_burst_size`` is output only, if [UpdateQ + ueue][google.cloud.tasks.v2beta2.CloudTasks.UpdateQueue] is called on a queue created by ``queue.yaml/xml``, - ``max_burst_size`` will be reset based on the value of [max\_t - asks\_dispatched\_per\_second][google.cloud.tasks.v2beta2.Rate - Limits.max\_tasks\_dispatched\_per\_second], regardless of - whether [max\_tasks\_dispatched\_per\_second][google.cloud.tas - ks.v2beta2.RateLimits.max\_tasks\_dispatched\_per\_second] is - updated. + ``max_burst_size`` will be reset based on the value of [max_ta + sks_dispatched_per_second][google.cloud.tasks.v2beta2.RateLimi + ts.max_tasks_dispatched_per_second], regardless of whether [ma + x_tasks_dispatched_per_second][google.cloud.tasks.v2beta2.Rate + Limits.max_tasks_dispatched_per_second] is updated. max_concurrent_tasks: The maximum number of concurrent tasks that Cloud Tasks allows to be dispatched for this queue. After this threshold has been @@ -656,30 +688,31 @@ [pull queues][google.cloud.tasks.v2beta2.PullTarget] and always -1, which indicates no limit. No other queue types can have ``max_concurrent_tasks`` set to -1. This field has the - same meaning as `max\_concurrent\_requests in queue.yaml/xml - `_. + same meaning as `max_concurrent_requests in queue.yaml/xml `_. """, # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta2.RateLimits) - ), + }, ) _sym_db.RegisterMessage(RateLimits) RetryConfig = _reflection.GeneratedProtocolMessageType( "RetryConfig", (_message.Message,), - dict( - DESCRIPTOR=_RETRYCONFIG, - __module__="google.cloud.tasks_v2beta2.proto.queue_pb2", - __doc__="""Retry config. These settings determine how a failed task attempt is + { + "DESCRIPTOR": _RETRYCONFIG, + "__module__": "google.cloud.tasks_v2beta2.proto.queue_pb2", + "__doc__": """Retry config. These settings determine how a failed task attempt is retried. + Attributes: num_attempts: Number of attempts per task. If unspecified when the queue is created, Cloud Tasks will pick the default. This field has - the same meaning as `task\_retry\_limit in queue.yaml/xml `_. + the same meaning as `task_retry_limit in queue.yaml/xml `_. max_attempts: The maximum number of attempts for a task. Cloud Tasks will attempt the task ``max_attempts`` times (that is, if the first @@ -691,77 +724,74 @@ If positive, ``max_retry_duration`` specifies the time limit for retrying a failed task, measured from when the task was first attempted. Once ``max_retry_duration`` time has passed - *and* the task has been attempted [max\_attempts][google.cloud - .tasks.v2beta2.RetryConfig.max\_attempts] times, no further + *and* the task has been attempted [max_attempts][google.cloud. + tasks.v2beta2.RetryConfig.max_attempts] times, no further attempts will be made and the task will be deleted. If zero, then the task age is unlimited. If unspecified when the queue is created, Cloud Tasks will pick the default. This field is output only for [pull queues][google.cloud.tasks.v2beta2.PullTarget]. ``max_retry_duration`` will be truncated to the nearest - second. This field has the same meaning as `task\_age\_limit - in queue.yaml/xml `_. + second. This field has the same meaning as `task_age_limit in + queue.yaml/xml `_. min_backoff: A task will be - [scheduled][google.cloud.tasks.v2beta2.Task.schedule\_time] - for retry between [min\_backoff][google.cloud.tasks.v2beta2.Re - tryConfig.min\_backoff] and [max\_backoff][google.cloud.tasks. - v2beta2.RetryConfig.max\_backoff] duration after it fails, if - the queue's - [RetryConfig][google.cloud.tasks.v2beta2.RetryConfig] + [scheduled][google.cloud.tasks.v2beta2.Task.schedule_time] for + retry between [min_backoff][google.cloud.tasks.v2beta2.RetryCo + nfig.min_backoff] and [max_backoff][google.cloud.tasks.v2beta2 + .RetryConfig.max_backoff] duration after it fails, if the + queue’s [RetryConfig][google.cloud.tasks.v2beta2.RetryConfig] specifies that the task should be retried. If unspecified when the queue is created, Cloud Tasks will pick the default. This field is output only for [pull queues][google.cloud.tasks.v2beta2.PullTarget]. ``min_backoff`` will be truncated to the nearest second. This - field has the same meaning as `min\_backoff\_seconds in + field has the same meaning as `min_backoff_seconds in queue.yaml/xml `_. max_backoff: A task will be - [scheduled][google.cloud.tasks.v2beta2.Task.schedule\_time] - for retry between [min\_backoff][google.cloud.tasks.v2beta2.Re - tryConfig.min\_backoff] and [max\_backoff][google.cloud.tasks. - v2beta2.RetryConfig.max\_backoff] duration after it fails, if - the queue's - [RetryConfig][google.cloud.tasks.v2beta2.RetryConfig] + [scheduled][google.cloud.tasks.v2beta2.Task.schedule_time] for + retry between [min_backoff][google.cloud.tasks.v2beta2.RetryCo + nfig.min_backoff] and [max_backoff][google.cloud.tasks.v2beta2 + .RetryConfig.max_backoff] duration after it fails, if the + queue’s [RetryConfig][google.cloud.tasks.v2beta2.RetryConfig] specifies that the task should be retried. If unspecified when the queue is created, Cloud Tasks will pick the default. This field is output only for [pull queues][google.cloud.tasks.v2beta2.PullTarget]. ``max_backoff`` will be truncated to the nearest second. This - field has the same meaning as `max\_backoff\_seconds in + field has the same meaning as `max_backoff_seconds in queue.yaml/xml `_. max_doublings: The time between retries will double ``max_doublings`` times. - A task's retry interval starts at [min\_backoff][google.cloud. - tasks.v2beta2.RetryConfig.min\_backoff], then doubles + A task’s retry interval starts at [min_backoff][google.cloud.t + asks.v2beta2.RetryConfig.min_backoff], then doubles ``max_doublings`` times, then increases linearly, and finally - retries retries at intervals of [max\_backoff][google.cloud.ta - sks.v2beta2.RetryConfig.max\_backoff] up to [max\_attempts][go - ogle.cloud.tasks.v2beta2.RetryConfig.max\_attempts] times. - For example, if [min\_backoff][google.cloud.tasks.v2beta2.Retr - yConfig.min\_backoff] is 10s, [max\_backoff][google.cloud.task - s.v2beta2.RetryConfig.max\_backoff] is 300s, and - ``max_doublings`` is 3, then the a task will first be retried - in 10s. The retry interval will double three times, and then - increase linearly by 2^3 \* 10s. Finally, the task will retry - at intervals of [max\_backoff][google.cloud.tasks.v2beta2.Retr - yConfig.max\_backoff] until the task has been attempted [max\_ - attempts][google.cloud.tasks.v2beta2.RetryConfig.max\_attempts - ] times. Thus, the requests will retry at 10s, 20s, 40s, 80s, - 160s, 240s, 300s, 300s, .... If unspecified when the queue is - created, Cloud Tasks will pick the default. This field is - output only for [pull - queues][google.cloud.tasks.v2beta2.PullTarget]. This field - has the same meaning as `max\_doublings in queue.yaml/xml `_. + retries retries at intervals of [max_backoff][google.cloud.tas + ks.v2beta2.RetryConfig.max_backoff] up to [max_attempts][googl + e.cloud.tasks.v2beta2.RetryConfig.max_attempts] times. For + example, if [min_backoff][google.cloud.tasks.v2beta2.RetryConf + ig.min_backoff] is 10s, [max_backoff][google.cloud.tasks.v2bet + a2.RetryConfig.max_backoff] is 300s, and ``max_doublings`` is + 3, then the a task will first be retried in 10s. The retry + interval will double three times, and then increase linearly + by 2^3 \* 10s. Finally, the task will retry at intervals of [m + ax_backoff][google.cloud.tasks.v2beta2.RetryConfig.max_backoff + ] until the task has been attempted [max_attempts][google.clou + d.tasks.v2beta2.RetryConfig.max_attempts] times. Thus, the + requests will retry at 10s, 20s, 40s, 80s, 160s, 240s, 300s, + 300s, …. If unspecified when the queue is created, Cloud + Tasks will pick the default. This field is output only for + [pull queues][google.cloud.tasks.v2beta2.PullTarget]. This + field has the same meaning as `max_doublings in queue.yaml/xml + `_. """, # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta2.RetryConfig) - ), + }, ) _sym_db.RegisterMessage(RetryConfig) diff --git a/google/cloud/tasks_v2beta2/proto/queue_pb2_grpc.py b/google/cloud/tasks_v2beta2/proto/queue_pb2_grpc.py index 07cb78fe..8a939394 100644 --- a/google/cloud/tasks_v2beta2/proto/queue_pb2_grpc.py +++ b/google/cloud/tasks_v2beta2/proto/queue_pb2_grpc.py @@ -1,2 +1,3 @@ # Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT! +"""Client and server classes corresponding to protobuf-defined services.""" import grpc diff --git a/google/cloud/tasks_v2beta2/proto/target_pb2.py b/google/cloud/tasks_v2beta2/proto/target_pb2.py index 83561f4f..cb7365b3 100644 --- a/google/cloud/tasks_v2beta2/proto/target_pb2.py +++ b/google/cloud/tasks_v2beta2/proto/target_pb2.py @@ -1,10 +1,7 @@ # -*- coding: utf-8 -*- # Generated by the protocol buffer compiler. DO NOT EDIT! # source: google/cloud/tasks_v2beta2/proto/target.proto - -import sys - -_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1")) +"""Generated protocol buffer code.""" from google.protobuf.internal import enum_type_wrapper from google.protobuf import descriptor as _descriptor from google.protobuf import message as _message @@ -23,13 +20,10 @@ name="google/cloud/tasks_v2beta2/proto/target.proto", package="google.cloud.tasks.v2beta2", syntax="proto3", - serialized_options=_b( - "\n\036com.google.cloud.tasks.v2beta2B\013TargetProtoP\001Z?google.golang.org/genproto/googleapis/cloud/tasks/v2beta2;tasks" - ), - serialized_pb=_b( - '\n-google/cloud/tasks_v2beta2/proto/target.proto\x12\x1agoogle.cloud.tasks.v2beta2\x1a\x1cgoogle/api/annotations.proto"\x0c\n\nPullTarget"+\n\x0bPullMessage\x12\x0f\n\x07payload\x18\x01 \x01(\x0c\x12\x0b\n\x03tag\x18\x02 \x01(\t"h\n\x13\x41ppEngineHttpTarget\x12Q\n\x1b\x61pp_engine_routing_override\x18\x01 \x01(\x0b\x32,.google.cloud.tasks.v2beta2.AppEngineRouting"\xc4\x02\n\x14\x41ppEngineHttpRequest\x12;\n\x0bhttp_method\x18\x01 \x01(\x0e\x32&.google.cloud.tasks.v2beta2.HttpMethod\x12H\n\x12\x61pp_engine_routing\x18\x02 \x01(\x0b\x32,.google.cloud.tasks.v2beta2.AppEngineRouting\x12\x14\n\x0crelative_url\x18\x03 \x01(\t\x12N\n\x07headers\x18\x04 \x03(\x0b\x32=.google.cloud.tasks.v2beta2.AppEngineHttpRequest.HeadersEntry\x12\x0f\n\x07payload\x18\x05 \x01(\x0c\x1a.\n\x0cHeadersEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01"T\n\x10\x41ppEngineRouting\x12\x0f\n\x07service\x18\x01 \x01(\t\x12\x0f\n\x07version\x18\x02 \x01(\t\x12\x10\n\x08instance\x18\x03 \x01(\t\x12\x0c\n\x04host\x18\x04 \x01(\t*[\n\nHttpMethod\x12\x1b\n\x17HTTP_METHOD_UNSPECIFIED\x10\x00\x12\x08\n\x04POST\x10\x01\x12\x07\n\x03GET\x10\x02\x12\x08\n\x04HEAD\x10\x03\x12\x07\n\x03PUT\x10\x04\x12\n\n\x06\x44\x45LETE\x10\x05\x42p\n\x1e\x63om.google.cloud.tasks.v2beta2B\x0bTargetProtoP\x01Z?google.golang.org/genproto/googleapis/cloud/tasks/v2beta2;tasksb\x06proto3' - ), - dependencies=[google_dot_api_dot_annotations__pb2.DESCRIPTOR], + serialized_options=b"\n\036com.google.cloud.tasks.v2beta2B\013TargetProtoP\001Z?google.golang.org/genproto/googleapis/cloud/tasks/v2beta2;tasks", + create_key=_descriptor._internal_create_key, + serialized_pb=b'\n-google/cloud/tasks_v2beta2/proto/target.proto\x12\x1agoogle.cloud.tasks.v2beta2\x1a\x1cgoogle/api/annotations.proto"\x0c\n\nPullTarget"+\n\x0bPullMessage\x12\x0f\n\x07payload\x18\x01 \x01(\x0c\x12\x0b\n\x03tag\x18\x02 \x01(\t"h\n\x13\x41ppEngineHttpTarget\x12Q\n\x1b\x61pp_engine_routing_override\x18\x01 \x01(\x0b\x32,.google.cloud.tasks.v2beta2.AppEngineRouting"\xc4\x02\n\x14\x41ppEngineHttpRequest\x12;\n\x0bhttp_method\x18\x01 \x01(\x0e\x32&.google.cloud.tasks.v2beta2.HttpMethod\x12H\n\x12\x61pp_engine_routing\x18\x02 \x01(\x0b\x32,.google.cloud.tasks.v2beta2.AppEngineRouting\x12\x14\n\x0crelative_url\x18\x03 \x01(\t\x12N\n\x07headers\x18\x04 \x03(\x0b\x32=.google.cloud.tasks.v2beta2.AppEngineHttpRequest.HeadersEntry\x12\x0f\n\x07payload\x18\x05 \x01(\x0c\x1a.\n\x0cHeadersEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01"T\n\x10\x41ppEngineRouting\x12\x0f\n\x07service\x18\x01 \x01(\t\x12\x0f\n\x07version\x18\x02 \x01(\t\x12\x10\n\x08instance\x18\x03 \x01(\t\x12\x0c\n\x04host\x18\x04 \x01(\t*[\n\nHttpMethod\x12\x1b\n\x17HTTP_METHOD_UNSPECIFIED\x10\x00\x12\x08\n\x04POST\x10\x01\x12\x07\n\x03GET\x10\x02\x12\x08\n\x04HEAD\x10\x03\x12\x07\n\x03PUT\x10\x04\x12\n\n\x06\x44\x45LETE\x10\x05\x42p\n\x1e\x63om.google.cloud.tasks.v2beta2B\x0bTargetProtoP\x01Z?google.golang.org/genproto/googleapis/cloud/tasks/v2beta2;tasksb\x06proto3', + dependencies=[google_dot_api_dot_annotations__pb2.DESCRIPTOR,], ) _HTTPMETHOD = _descriptor.EnumDescriptor( @@ -37,6 +31,7 @@ full_name="google.cloud.tasks.v2beta2.HttpMethod", filename=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, values=[ _descriptor.EnumValueDescriptor( name="HTTP_METHOD_UNSPECIFIED", @@ -44,21 +39,47 @@ number=0, serialized_options=None, type=None, + create_key=_descriptor._internal_create_key, ), _descriptor.EnumValueDescriptor( - name="POST", index=1, number=1, serialized_options=None, type=None + name="POST", + index=1, + number=1, + serialized_options=None, + type=None, + create_key=_descriptor._internal_create_key, ), _descriptor.EnumValueDescriptor( - name="GET", index=2, number=2, serialized_options=None, type=None + name="GET", + index=2, + number=2, + serialized_options=None, + type=None, + create_key=_descriptor._internal_create_key, ), _descriptor.EnumValueDescriptor( - name="HEAD", index=3, number=3, serialized_options=None, type=None + name="HEAD", + index=3, + number=3, + serialized_options=None, + type=None, + create_key=_descriptor._internal_create_key, ), _descriptor.EnumValueDescriptor( - name="PUT", index=4, number=4, serialized_options=None, type=None + name="PUT", + index=4, + number=4, + serialized_options=None, + type=None, + create_key=_descriptor._internal_create_key, ), _descriptor.EnumValueDescriptor( - name="DELETE", index=5, number=5, serialized_options=None, type=None + name="DELETE", + index=5, + number=5, + serialized_options=None, + type=None, + create_key=_descriptor._internal_create_key, ), ], containing_type=None, @@ -83,6 +104,7 @@ filename=None, file=DESCRIPTOR, containing_type=None, + create_key=_descriptor._internal_create_key, fields=[], extensions=[], nested_types=[], @@ -103,6 +125,7 @@ filename=None, file=DESCRIPTOR, containing_type=None, + create_key=_descriptor._internal_create_key, fields=[ _descriptor.FieldDescriptor( name="payload", @@ -113,7 +136,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b(""), + default_value=b"", message_type=None, enum_type=None, containing_type=None, @@ -121,6 +144,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="tag", @@ -131,7 +155,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -139,6 +163,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), ], extensions=[], @@ -160,6 +185,7 @@ filename=None, file=DESCRIPTOR, containing_type=None, + create_key=_descriptor._internal_create_key, fields=[ _descriptor.FieldDescriptor( name="app_engine_routing_override", @@ -178,7 +204,8 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, - ) + create_key=_descriptor._internal_create_key, + ), ], extensions=[], nested_types=[], @@ -199,6 +226,7 @@ filename=None, file=DESCRIPTOR, containing_type=None, + create_key=_descriptor._internal_create_key, fields=[ _descriptor.FieldDescriptor( name="key", @@ -209,7 +237,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -217,6 +245,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="value", @@ -227,7 +256,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -235,12 +264,13 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), ], extensions=[], nested_types=[], enum_types=[], - serialized_options=_b("8\001"), + serialized_options=b"8\001", is_extendable=False, syntax="proto3", extension_ranges=[], @@ -255,6 +285,7 @@ filename=None, file=DESCRIPTOR, containing_type=None, + create_key=_descriptor._internal_create_key, fields=[ _descriptor.FieldDescriptor( name="http_method", @@ -273,6 +304,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="app_engine_routing", @@ -291,6 +323,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="relative_url", @@ -301,7 +334,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -309,6 +342,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="headers", @@ -327,6 +361,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="payload", @@ -337,7 +372,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b(""), + default_value=b"", message_type=None, enum_type=None, containing_type=None, @@ -345,10 +380,11 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), ], extensions=[], - nested_types=[_APPENGINEHTTPREQUEST_HEADERSENTRY], + nested_types=[_APPENGINEHTTPREQUEST_HEADERSENTRY,], enum_types=[], serialized_options=None, is_extendable=False, @@ -366,6 +402,7 @@ filename=None, file=DESCRIPTOR, containing_type=None, + create_key=_descriptor._internal_create_key, fields=[ _descriptor.FieldDescriptor( name="service", @@ -376,7 +413,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -384,6 +421,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="version", @@ -394,7 +432,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -402,6 +440,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="instance", @@ -412,7 +451,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -420,6 +459,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="host", @@ -430,7 +470,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -438,6 +478,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), ], extensions=[], @@ -474,106 +515,108 @@ PullTarget = _reflection.GeneratedProtocolMessageType( "PullTarget", (_message.Message,), - dict( - DESCRIPTOR=_PULLTARGET, - __module__="google.cloud.tasks_v2beta2.proto.target_pb2", - __doc__="""Pull target.""", + { + "DESCRIPTOR": _PULLTARGET, + "__module__": "google.cloud.tasks_v2beta2.proto.target_pb2", + "__doc__": """Pull target.""", # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta2.PullTarget) - ), + }, ) _sym_db.RegisterMessage(PullTarget) PullMessage = _reflection.GeneratedProtocolMessageType( "PullMessage", (_message.Message,), - dict( - DESCRIPTOR=_PULLMESSAGE, - __module__="google.cloud.tasks_v2beta2.proto.target_pb2", - __doc__="""The pull message contains data that can be used by the caller of + { + "DESCRIPTOR": _PULLMESSAGE, + "__module__": "google.cloud.tasks_v2beta2.proto.target_pb2", + "__doc__": """The pull message contains data that can be used by the caller of [LeaseTasks][google.cloud.tasks.v2beta2.CloudTasks.LeaseTasks] to process the task. This proto can only be used for tasks in a queue - which has - [pull\_target][google.cloud.tasks.v2beta2.Queue.pull\_target] set. + which has [pull_target][google.cloud.tasks.v2beta2.Queue.pull_target] + set. + Attributes: payload: A data payload consumed by the worker to execute the task. tag: - The task's tag. Tags allow similar tasks to be processed in a + The task’s tag. Tags allow similar tasks to be processed in a batch. If you label tasks with a tag, your worker can [lease tasks][google.cloud.tasks.v2beta2.CloudTasks.LeaseTasks] with the same tag using [filter][google.cloud.tasks.v2beta2.LeaseTasksRequest.filter]. For example, if you want to aggregate the events associated with a specific user once a day, you could tag tasks with the - user ID. The task's tag can only be set when the [task is + user ID. The task’s tag can only be set when the [task is created][google.cloud.tasks.v2beta2.CloudTasks.CreateTask]. The tag must be less than 500 characters. SDK compatibility: Although the SDK allows tags to be either string or `bytes `_, only UTF-8 encoded tags can be used in Cloud - Tasks. If a tag isn't UTF-8 encoded, the tag will be empty + Tasks. If a tag isn’t UTF-8 encoded, the tag will be empty when the task is returned by Cloud Tasks. """, # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta2.PullMessage) - ), + }, ) _sym_db.RegisterMessage(PullMessage) AppEngineHttpTarget = _reflection.GeneratedProtocolMessageType( "AppEngineHttpTarget", (_message.Message,), - dict( - DESCRIPTOR=_APPENGINEHTTPTARGET, - __module__="google.cloud.tasks_v2beta2.proto.target_pb2", - __doc__="""App Engine HTTP target. The task will be delivered to the App Engine + { + "DESCRIPTOR": _APPENGINEHTTPTARGET, + "__module__": "google.cloud.tasks_v2beta2.proto.target_pb2", + "__doc__": """App Engine HTTP target. The task will be delivered to the App Engine application hostname specified by its [AppEngineHttpTarget][google.cloud.tasks.v2beta2.AppEngineHttpTarget] and [AppEngineHttpRequest][google.cloud.tasks.v2beta2.AppEngineHttpReq uest]. The documentation for [AppEngineHttpRequest][google.cloud.tasks - .v2beta2.AppEngineHttpRequest] explains how the task's host URL is + .v2beta2.AppEngineHttpRequest] explains how the task’s host URL is constructed. Using [AppEngineHttpTarget][google.cloud.tasks.v2beta2.AppEngineHttpTarget] requires ```appengine.applications.get`` - `_ + `\_ Google IAM permission for the project and the following scope: ``https://www.googleapis.com/auth/cloud-platform`` + Attributes: app_engine_routing_override: - Overrides for the [task-level app\_engine\_routing][google.clo - ud.tasks.v2beta2.AppEngineHttpRequest.app\_engine\_routing]. - 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][google.cloud.tasks.v2beta2.AppEngi - neHttpRequest.app\_engine\_routing]. + Overrides for the [task-level app_engine_routing][google.cloud + .tasks.v2beta2.AppEngineHttpRequest.app_engine_routing]. If + set, ``app_engine_routing_override`` is used for all tasks in + the queue, no matter what the setting is for the [task-level a + pp_engine_routing][google.cloud.tasks.v2beta2.AppEngineHttpReq + uest.app_engine_routing]. """, # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta2.AppEngineHttpTarget) - ), + }, ) _sym_db.RegisterMessage(AppEngineHttpTarget) AppEngineHttpRequest = _reflection.GeneratedProtocolMessageType( "AppEngineHttpRequest", (_message.Message,), - dict( - HeadersEntry=_reflection.GeneratedProtocolMessageType( + { + "HeadersEntry": _reflection.GeneratedProtocolMessageType( "HeadersEntry", (_message.Message,), - dict( - DESCRIPTOR=_APPENGINEHTTPREQUEST_HEADERSENTRY, - __module__="google.cloud.tasks_v2beta2.proto.target_pb2" + { + "DESCRIPTOR": _APPENGINEHTTPREQUEST_HEADERSENTRY, + "__module__": "google.cloud.tasks_v2beta2.proto.target_pb2" # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta2.AppEngineHttpRequest.HeadersEntry) - ), + }, ), - DESCRIPTOR=_APPENGINEHTTPREQUEST, - __module__="google.cloud.tasks_v2beta2.proto.target_pb2", - __doc__="""App Engine HTTP request. The message defines the HTTP request that is + "DESCRIPTOR": _APPENGINEHTTPREQUEST, + "__module__": "google.cloud.tasks_v2beta2.proto.target_pb2", + "__doc__": """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 - ][google.cloud.tasks.v2beta2.Queue.app\_engine\_http\_target] set. - Using [AppEngineHttpRequest][google.cloud.tasks.v2beta2.AppEngineHttpR - equest] requires ```appengine.applications.get`` - `_ + only be used for tasks in a queue which has [app_engine_http_target][g + oogle.cloud.tasks.v2beta2.Queue.app_engine_http_target] set. Using [A + ppEngineHttpRequest][google.cloud.tasks.v2beta2.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 @@ -588,38 +631,39 @@ will appear to have used the HTTP protocol. The [AppEngineRouting][google.cloud.tasks.v2beta2.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\_overr - ide][google.cloud.tasks.v2beta2.AppEngineHttpTarget.app\_engine\_routi - ng\_override] is used for all tasks in the queue, no matter what - the setting is for the [task-level app\_engine\_routing][google. - cloud.tasks.v2beta2.AppEngineHttpRequest.app\_engine\_routing]. The - ``url`` that the task will be sent to is: - ``url =`` + queue-level or task-level: - If set, [app_engine_routing_override + ][google.cloud.tasks.v2beta2.AppEngineHttpTarget.app_engine_routing_ov + erride] is used for all tasks in the queue, no matter what the + setting is for the [task-level app_engine_routing][google.cloud. + tasks.v2beta2.AppEngineHttpRequest.app_engine_routing]. The ``url`` + that the task will be sent to is: - ``url =`` [host][google.cloud.tasks.v2beta2.AppEngineRouting.host] ``+`` [ - relative\_url][google.cloud.tasks.v2beta2.AppEngineHttpRequest.relativ - e\_url] Tasks can be dispatched to secure app handlers, unsecure app + relative_url][google.cloud.tasks.v2beta2.AppEngineHttpRequest.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 + 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 + ``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][Task.dispatch\_deadline]. Failed tasks will be retried + the [deadline][Task.dispatch_deadline]. Failed tasks will be retried according to the [retry - configuration][google.cloud.tasks.v2beta2.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. + configuration][google.cloud.tasks.v2beta2.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. + Attributes: http_method: The HTTP method to use for the request. The default is POST. - The app's request handler for the task's target URL must be - able to handle HTTP requests with this http\_method, otherwise + The app’s request handler for the task’s target URL must be + able to handle HTTP requests with this http_method, otherwise the task attempt will fail with error code 405 (Method Not Allowed). See `Writing a push task request handler `_. app_engine_routing: - Task-level setting for App Engine routing. If set, [app\_engi - ne\_routing\_override][google.cloud.tasks.v2beta2.AppEngineHtt - pTarget.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][google.cloud.tasks.v2beta2.AppEngi - neHttpRequest.app\_engine\_routing]. + Task-level setting for App Engine routing. If set, [app_engin + e_routing_override][google.cloud.tasks.v2beta2.AppEngineHttpTa + rget.app_engine_routing_override] is used for all tasks in the + queue, no matter what the setting is for the [task-level app_e + ngine_routing][google.cloud.tasks.v2beta2.AppEngineHttpRequest + .app_engine_routing]. relative_url: - The relative URL. The relative URL must begin with "/" and + The relative URL. The relative URL must begin with “/” and must be a valid HTTP relative URL. It can contain a path and query string arguments. If the relative URL is empty, then the - root path "/" will be used. No spaces are allowed, and the + root path “/” will be used. No spaces are allowed, and the maximum length allowed is 2083 characters. headers: HTTP request headers. This map contains the header field @@ -685,7 +729,7 @@ [HttpMethod][google.cloud.tasks.v2beta2.HttpMethod]. """, # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta2.AppEngineHttpRequest) - ), + }, ) _sym_db.RegisterMessage(AppEngineHttpRequest) _sym_db.RegisterMessage(AppEngineHttpRequest.HeadersEntry) @@ -693,10 +737,10 @@ AppEngineRouting = _reflection.GeneratedProtocolMessageType( "AppEngineRouting", (_message.Message,), - dict( - DESCRIPTOR=_APPENGINEROUTING, - __module__="google.cloud.tasks_v2beta2.proto.target_pb2", - __doc__="""App Engine Routing. Defines routing characteristics specific to App + { + "DESCRIPTOR": _APPENGINEROUTING, + "__module__": "google.cloud.tasks_v2beta2.proto.target_pb2", + "__doc__": """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 `_, and `App Engine Flex request routing `_. + Attributes: service: App service. By default, the task is sent to the service @@ -770,7 +815,7 @@ ``| [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 + 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][google.cloud.tasks.v2beta2.AppEngineRouting.service] @@ -810,7 +855,7 @@ the default service when the task is attempted. """, # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta2.AppEngineRouting) - ), + }, ) _sym_db.RegisterMessage(AppEngineRouting) diff --git a/google/cloud/tasks_v2beta2/proto/target_pb2_grpc.py b/google/cloud/tasks_v2beta2/proto/target_pb2_grpc.py index 07cb78fe..8a939394 100644 --- a/google/cloud/tasks_v2beta2/proto/target_pb2_grpc.py +++ b/google/cloud/tasks_v2beta2/proto/target_pb2_grpc.py @@ -1,2 +1,3 @@ # Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT! +"""Client and server classes corresponding to protobuf-defined services.""" import grpc diff --git a/google/cloud/tasks_v2beta2/proto/task_pb2.py b/google/cloud/tasks_v2beta2/proto/task_pb2.py index 57466dbc..8a1680ed 100644 --- a/google/cloud/tasks_v2beta2/proto/task_pb2.py +++ b/google/cloud/tasks_v2beta2/proto/task_pb2.py @@ -1,10 +1,7 @@ # -*- coding: utf-8 -*- # Generated by the protocol buffer compiler. DO NOT EDIT! # source: google/cloud/tasks_v2beta2/proto/task.proto - -import sys - -_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1")) +"""Generated protocol buffer code.""" from google.protobuf import descriptor as _descriptor from google.protobuf import message as _message from google.protobuf import reflection as _reflection @@ -28,12 +25,9 @@ name="google/cloud/tasks_v2beta2/proto/task.proto", package="google.cloud.tasks.v2beta2", syntax="proto3", - serialized_options=_b( - "\n\036com.google.cloud.tasks.v2beta2B\tTaskProtoP\001Z?google.golang.org/genproto/googleapis/cloud/tasks/v2beta2;tasks" - ), - serialized_pb=_b( - '\n+google/cloud/tasks_v2beta2/proto/task.proto\x12\x1agoogle.cloud.tasks.v2beta2\x1a\x19google/api/resource.proto\x1a-google/cloud/tasks_v2beta2/proto/target.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x17google/rpc/status.proto\x1a\x1cgoogle/api/annotations.proto"\xa8\x04\n\x04Task\x12\x0c\n\x04name\x18\x01 \x01(\t\x12S\n\x17\x61pp_engine_http_request\x18\x03 \x01(\x0b\x32\x30.google.cloud.tasks.v2beta2.AppEngineHttpRequestH\x00\x12?\n\x0cpull_message\x18\x04 \x01(\x0b\x32\'.google.cloud.tasks.v2beta2.PullMessageH\x00\x12\x31\n\rschedule_time\x18\x05 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12/\n\x0b\x63reate_time\x18\x06 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x36\n\x06status\x18\x07 \x01(\x0b\x32&.google.cloud.tasks.v2beta2.TaskStatus\x12\x33\n\x04view\x18\x08 \x01(\x0e\x32%.google.cloud.tasks.v2beta2.Task.View"1\n\x04View\x12\x14\n\x10VIEW_UNSPECIFIED\x10\x00\x12\t\n\x05\x42\x41SIC\x10\x01\x12\x08\n\x04\x46ULL\x10\x02:h\xea\x41\x65\n\x1e\x63loudtasks.googleapis.com/Task\x12\x43projects/{project}/locations/{location}/queues/{queue}/tasks/{task}B\x0e\n\x0cpayload_type"\xdd\x01\n\nTaskStatus\x12\x1e\n\x16\x61ttempt_dispatch_count\x18\x01 \x01(\x05\x12\x1e\n\x16\x61ttempt_response_count\x18\x02 \x01(\x05\x12G\n\x14\x66irst_attempt_status\x18\x03 \x01(\x0b\x32).google.cloud.tasks.v2beta2.AttemptStatus\x12\x46\n\x13last_attempt_status\x18\x04 \x01(\x0b\x32).google.cloud.tasks.v2beta2.AttemptStatus"\xd5\x01\n\rAttemptStatus\x12\x31\n\rschedule_time\x18\x01 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x31\n\rdispatch_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x31\n\rresponse_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12+\n\x0fresponse_status\x18\x04 \x01(\x0b\x32\x12.google.rpc.StatusBn\n\x1e\x63om.google.cloud.tasks.v2beta2B\tTaskProtoP\x01Z?google.golang.org/genproto/googleapis/cloud/tasks/v2beta2;tasksb\x06proto3' - ), + serialized_options=b"\n\036com.google.cloud.tasks.v2beta2B\tTaskProtoP\001Z?google.golang.org/genproto/googleapis/cloud/tasks/v2beta2;tasks", + create_key=_descriptor._internal_create_key, + serialized_pb=b'\n+google/cloud/tasks_v2beta2/proto/task.proto\x12\x1agoogle.cloud.tasks.v2beta2\x1a\x19google/api/resource.proto\x1a-google/cloud/tasks_v2beta2/proto/target.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x17google/rpc/status.proto\x1a\x1cgoogle/api/annotations.proto"\xa8\x04\n\x04Task\x12\x0c\n\x04name\x18\x01 \x01(\t\x12S\n\x17\x61pp_engine_http_request\x18\x03 \x01(\x0b\x32\x30.google.cloud.tasks.v2beta2.AppEngineHttpRequestH\x00\x12?\n\x0cpull_message\x18\x04 \x01(\x0b\x32\'.google.cloud.tasks.v2beta2.PullMessageH\x00\x12\x31\n\rschedule_time\x18\x05 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12/\n\x0b\x63reate_time\x18\x06 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x36\n\x06status\x18\x07 \x01(\x0b\x32&.google.cloud.tasks.v2beta2.TaskStatus\x12\x33\n\x04view\x18\x08 \x01(\x0e\x32%.google.cloud.tasks.v2beta2.Task.View"1\n\x04View\x12\x14\n\x10VIEW_UNSPECIFIED\x10\x00\x12\t\n\x05\x42\x41SIC\x10\x01\x12\x08\n\x04\x46ULL\x10\x02:h\xea\x41\x65\n\x1e\x63loudtasks.googleapis.com/Task\x12\x43projects/{project}/locations/{location}/queues/{queue}/tasks/{task}B\x0e\n\x0cpayload_type"\xdd\x01\n\nTaskStatus\x12\x1e\n\x16\x61ttempt_dispatch_count\x18\x01 \x01(\x05\x12\x1e\n\x16\x61ttempt_response_count\x18\x02 \x01(\x05\x12G\n\x14\x66irst_attempt_status\x18\x03 \x01(\x0b\x32).google.cloud.tasks.v2beta2.AttemptStatus\x12\x46\n\x13last_attempt_status\x18\x04 \x01(\x0b\x32).google.cloud.tasks.v2beta2.AttemptStatus"\xd5\x01\n\rAttemptStatus\x12\x31\n\rschedule_time\x18\x01 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x31\n\rdispatch_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x31\n\rresponse_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12+\n\x0fresponse_status\x18\x04 \x01(\x0b\x32\x12.google.rpc.StatusBn\n\x1e\x63om.google.cloud.tasks.v2beta2B\tTaskProtoP\x01Z?google.golang.org/genproto/googleapis/cloud/tasks/v2beta2;tasksb\x06proto3', dependencies=[ google_dot_api_dot_resource__pb2.DESCRIPTOR, google_dot_cloud_dot_tasks__v2beta2_dot_proto_dot_target__pb2.DESCRIPTOR, @@ -49,6 +43,7 @@ full_name="google.cloud.tasks.v2beta2.Task.View", filename=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, values=[ _descriptor.EnumValueDescriptor( name="VIEW_UNSPECIFIED", @@ -56,12 +51,23 @@ number=0, serialized_options=None, type=None, + create_key=_descriptor._internal_create_key, ), _descriptor.EnumValueDescriptor( - name="BASIC", index=1, number=1, serialized_options=None, type=None + name="BASIC", + index=1, + number=1, + serialized_options=None, + type=None, + create_key=_descriptor._internal_create_key, ), _descriptor.EnumValueDescriptor( - name="FULL", index=2, number=2, serialized_options=None, type=None + name="FULL", + index=2, + number=2, + serialized_options=None, + type=None, + create_key=_descriptor._internal_create_key, ), ], containing_type=None, @@ -78,6 +84,7 @@ filename=None, file=DESCRIPTOR, containing_type=None, + create_key=_descriptor._internal_create_key, fields=[ _descriptor.FieldDescriptor( name="name", @@ -88,7 +95,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -96,6 +103,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="app_engine_http_request", @@ -114,6 +122,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="pull_message", @@ -132,6 +141,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="schedule_time", @@ -150,6 +160,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="create_time", @@ -168,6 +179,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="status", @@ -186,6 +198,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="view", @@ -204,14 +217,13 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), ], extensions=[], nested_types=[], - enum_types=[_TASK_VIEW], - serialized_options=_b( - "\352Ae\n\036cloudtasks.googleapis.com/Task\022Cprojects/{project}/locations/{location}/queues/{queue}/tasks/{task}" - ), + enum_types=[_TASK_VIEW,], + serialized_options=b"\352Ae\n\036cloudtasks.googleapis.com/Task\022Cprojects/{project}/locations/{location}/queues/{queue}/tasks/{task}", is_extendable=False, syntax="proto3", extension_ranges=[], @@ -221,8 +233,9 @@ full_name="google.cloud.tasks.v2beta2.Task.payload_type", index=0, containing_type=None, + create_key=_descriptor._internal_create_key, fields=[], - ) + ), ], serialized_start=238, serialized_end=790, @@ -235,6 +248,7 @@ filename=None, file=DESCRIPTOR, containing_type=None, + create_key=_descriptor._internal_create_key, fields=[ _descriptor.FieldDescriptor( name="attempt_dispatch_count", @@ -253,6 +267,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="attempt_response_count", @@ -271,6 +286,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="first_attempt_status", @@ -289,6 +305,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="last_attempt_status", @@ -307,6 +324,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), ], extensions=[], @@ -328,6 +346,7 @@ filename=None, file=DESCRIPTOR, containing_type=None, + create_key=_descriptor._internal_create_key, fields=[ _descriptor.FieldDescriptor( name="schedule_time", @@ -346,6 +365,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="dispatch_time", @@ -364,6 +384,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="response_time", @@ -382,6 +403,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="response_status", @@ -400,6 +422,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), ], extensions=[], @@ -465,10 +488,11 @@ Task = _reflection.GeneratedProtocolMessageType( "Task", (_message.Message,), - dict( - DESCRIPTOR=_TASK, - __module__="google.cloud.tasks_v2beta2.proto.task_pb2", - __doc__="""A unit of scheduled work. + { + "DESCRIPTOR": _TASK, + "__module__": "google.cloud.tasks_v2beta2.proto.task_pb2", + "__doc__": """A unit of scheduled work. + Attributes: name: Optionally caller-specified in [CreateTask][google.cloud.tasks @@ -480,7 +504,7 @@ information, see `Identifying projects `_ - ``LOCATION_ID`` - is the canonical ID for the task's location. The list of + is the canonical ID for the task’s location. The list of available locations can be obtained by calling [ListLocatio ns][google.cloud.location.Locations.ListLocations]. For more information, see @@ -488,23 +512,23 @@ 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 + (-), or underscores (_). The maximum length is 500 characters. payload_type: - Required. The task's payload is used by the task's target to + Required. The task’s payload is used by the task’s target to process the task. A payload is valid only if it is compatible - with the queue's target. + with the queue’s target. app_engine_http_request: - App Engine HTTP request that is sent to the task's target. Can - be set only if [app\_engine\_http\_target][google.cloud.tasks. - v2beta2.Queue.app\_engine\_http\_target] is set on the queue. - An App Engine task is a task that has [AppEngineHttpRequest][g - oogle.cloud.tasks.v2beta2.AppEngineHttpRequest] set. + App Engine HTTP request that is sent to the task’s target. Can + be set only if [app_engine_http_target][google.cloud.tasks.v2b + eta2.Queue.app_engine_http_target] is set on the queue. An + App Engine task is a task that has [AppEngineHttpRequest][goog + le.cloud.tasks.v2beta2.AppEngineHttpRequest] set. pull_message: [LeaseTasks][google.cloud.tasks.v2beta2.CloudTasks.LeaseTasks] to process the task. Can be set only if - [pull\_target][google.cloud.tasks.v2beta2.Queue.pull\_target] - is set on the queue. A pull task is a task that has + [pull_target][google.cloud.tasks.v2beta2.Queue.pull_target] is + set on the queue. A pull task is a task that has [PullMessage][google.cloud.tasks.v2beta2.PullMessage] set. schedule_time: The time when the task is scheduled to be attempted. For App @@ -512,8 +536,8 @@ 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][google.clo - ud.tasks.v2beta2.LeaseTasksRequest.lease\_duration]. + that the task was leased plus the [lease_duration][google.clou + d.tasks.v2beta2.LeaseTasksRequest.lease_duration]. ``schedule_time`` will be truncated to the nearest microsecond. create_time: @@ -526,51 +550,53 @@ [Task][google.cloud.tasks.v2beta2.Task] has been returned. """, # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta2.Task) - ), + }, ) _sym_db.RegisterMessage(Task) TaskStatus = _reflection.GeneratedProtocolMessageType( "TaskStatus", (_message.Message,), - dict( - DESCRIPTOR=_TASKSTATUS, - __module__="google.cloud.tasks_v2beta2.proto.task_pb2", - __doc__="""Status of the task. + { + "DESCRIPTOR": _TASKSTATUS, + "__module__": "google.cloud.tasks_v2beta2.proto.task_pb2", + "__doc__": """Status of the task. + Attributes: attempt_dispatch_count: Output only. The number of attempts dispatched. This count - includes attempts which have been dispatched but haven't + includes attempts which have been dispatched but haven’t received a response. attempt_response_count: Output only. The number of attempts which have received a response. This field is not calculated for [pull tasks][google.cloud.tasks.v2beta2.PullMessage]. first_attempt_status: - Output only. The status of the task's first attempt. Only [di - spatch\_time][google.cloud.tasks.v2beta2.AttemptStatus.dispatc - h\_time] will be set. The other + Output only. The status of the task’s first attempt. Only [di + spatch_time][google.cloud.tasks.v2beta2.AttemptStatus.dispatch + _time] will be set. The other [AttemptStatus][google.cloud.tasks.v2beta2.AttemptStatus] information is not retained by Cloud Tasks. This field is not calculated for [pull tasks][google.cloud.tasks.v2beta2.PullMessage]. last_attempt_status: - Output only. The status of the task's last attempt. This + Output only. The status of the task’s last attempt. This field is not calculated for [pull tasks][google.cloud.tasks.v2beta2.PullMessage]. """, # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta2.TaskStatus) - ), + }, ) _sym_db.RegisterMessage(TaskStatus) AttemptStatus = _reflection.GeneratedProtocolMessageType( "AttemptStatus", (_message.Message,), - dict( - DESCRIPTOR=_ATTEMPTSTATUS, - __module__="google.cloud.tasks_v2beta2.proto.task_pb2", - __doc__="""The status of a task attempt. + { + "DESCRIPTOR": _ATTEMPTSTATUS, + "__module__": "google.cloud.tasks_v2beta2.proto.task_pb2", + "__doc__": """The status of a task attempt. + Attributes: schedule_time: Output only. The time that this attempt was scheduled. @@ -590,7 +616,7 @@ running then the response status is unset. """, # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta2.AttemptStatus) - ), + }, ) _sym_db.RegisterMessage(AttemptStatus) diff --git a/google/cloud/tasks_v2beta2/proto/task_pb2_grpc.py b/google/cloud/tasks_v2beta2/proto/task_pb2_grpc.py index 07cb78fe..8a939394 100644 --- a/google/cloud/tasks_v2beta2/proto/task_pb2_grpc.py +++ b/google/cloud/tasks_v2beta2/proto/task_pb2_grpc.py @@ -1,2 +1,3 @@ # Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT! +"""Client and server classes corresponding to protobuf-defined services.""" import grpc diff --git a/google/cloud/tasks_v2beta2/types.py b/google/cloud/tasks_v2beta2/types.py index d040eadf..6d6a6d6e 100644 --- a/google/cloud/tasks_v2beta2/types.py +++ b/google/cloud/tasks_v2beta2/types.py @@ -49,7 +49,12 @@ expr_pb2, ] -_local_modules = [cloudtasks_pb2, queue_pb2, target_pb2, task_pb2] +_local_modules = [ + cloudtasks_pb2, + queue_pb2, + target_pb2, + task_pb2, +] names = [] diff --git a/google/cloud/tasks_v2beta3/__init__.py b/google/cloud/tasks_v2beta3/__init__.py index 29ee68e4..5096a5b8 100644 --- a/google/cloud/tasks_v2beta3/__init__.py +++ b/google/cloud/tasks_v2beta3/__init__.py @@ -26,8 +26,8 @@ if sys.version_info[:2] == (2, 7): message = ( - "A future version of this library will drop support for Python 2.7." - "More details about Python 2 support for Google Cloud Client Libraries" + "A future version of this library will drop support for Python 2.7. " + "More details about Python 2 support for Google Cloud Client Libraries " "can be found at https://cloud.google.com/python/docs/python2-sunset/" ) warnings.warn(message, DeprecationWarning) @@ -38,4 +38,8 @@ class CloudTasksClient(cloud_tasks_client.CloudTasksClient): enums = enums -__all__ = ("enums", "types", "CloudTasksClient") +__all__ = ( + "enums", + "types", + "CloudTasksClient", +) diff --git a/google/cloud/tasks_v2beta3/gapic/cloud_tasks_client.py b/google/cloud/tasks_v2beta3/gapic/cloud_tasks_client.py index 44ba4d70..6b6c4e34 100644 --- a/google/cloud/tasks_v2beta3/gapic/cloud_tasks_client.py +++ b/google/cloud/tasks_v2beta3/gapic/cloud_tasks_client.py @@ -45,7 +45,7 @@ from google.protobuf import field_mask_pb2 -_GAPIC_LIBRARY_VERSION = pkg_resources.get_distribution("google-cloud-tasks").version +_GAPIC_LIBRARY_VERSION = pkg_resources.get_distribution("google-cloud-tasks",).version class CloudTasksClient(object): @@ -198,12 +198,12 @@ def __init__( self.transport = transport else: self.transport = cloud_tasks_grpc_transport.CloudTasksGrpcTransport( - address=api_endpoint, channel=channel, credentials=credentials + address=api_endpoint, channel=channel, credentials=credentials, ) if client_info is None: client_info = google.api_core.gapic_v1.client_info.ClientInfo( - gapic_version=_GAPIC_LIBRARY_VERSION + gapic_version=_GAPIC_LIBRARY_VERSION, ) else: client_info.gapic_version = _GAPIC_LIBRARY_VERSION @@ -214,7 +214,7 @@ def __init__( # (Ordinarily, these are the defaults specified in the `*_config.py` # file next to this one.) self._method_configs = google.api_core.gapic_v1.config.parse_method_configs( - client_config["interfaces"][self._INTERFACE_NAME] + client_config["interfaces"][self._INTERFACE_NAME], ) # Save a dictionary of cached API call functions. @@ -271,7 +271,7 @@ def list_queues( Sample filter "state: PAUSED". Note that using filters might cause fewer queues than the requested - page\_size to be returned. + page_size to be returned. page_size (int): The maximum number of resources contained in the underlying API response. If page streaming is performed per- resource, this parameter does not affect the return value. If page @@ -311,7 +311,7 @@ def list_queues( ) request = cloudtasks_pb2.ListQueuesRequest( - parent=parent, filter=filter_, page_size=page_size + parent=parent, filter=filter_, page_size=page_size, ) if metadata is None: metadata = [] @@ -393,7 +393,7 @@ def get_queue( client_info=self._client_info, ) - request = cloudtasks_pb2.GetQueueRequest(name=name) + request = cloudtasks_pb2.GetQueueRequest(name=name,) if metadata is None: metadata = [] metadata = list(metadata) @@ -495,7 +495,7 @@ def create_queue( client_info=self._client_info, ) - request = cloudtasks_pb2.CreateQueueRequest(parent=parent, queue=queue) + request = cloudtasks_pb2.CreateQueueRequest(parent=parent, queue=queue,) if metadata is None: metadata = [] metadata = list(metadata) @@ -604,7 +604,7 @@ def update_queue( ) request = cloudtasks_pb2.UpdateQueueRequest( - queue=queue, update_mask=update_mask + queue=queue, update_mask=update_mask, ) if metadata is None: metadata = [] @@ -683,7 +683,7 @@ def delete_queue( client_info=self._client_info, ) - request = cloudtasks_pb2.DeleteQueueRequest(name=name) + request = cloudtasks_pb2.DeleteQueueRequest(name=name,) if metadata is None: metadata = [] metadata = list(metadata) @@ -758,7 +758,7 @@ def purge_queue( client_info=self._client_info, ) - request = cloudtasks_pb2.PurgeQueueRequest(name=name) + request = cloudtasks_pb2.PurgeQueueRequest(name=name,) if metadata is None: metadata = [] metadata = list(metadata) @@ -832,7 +832,7 @@ def pause_queue( client_info=self._client_info, ) - request = cloudtasks_pb2.PauseQueueRequest(name=name) + request = cloudtasks_pb2.PauseQueueRequest(name=name,) if metadata is None: metadata = [] metadata = list(metadata) @@ -911,7 +911,7 @@ def resume_queue( client_info=self._client_info, ) - request = cloudtasks_pb2.ResumeQueueRequest(name=name) + request = cloudtasks_pb2.ResumeQueueRequest(name=name,) if metadata is None: metadata = [] metadata = list(metadata) @@ -938,8 +938,8 @@ def get_iam_policy( metadata=None, ): """ - Gets the access control policy for a ``Queue``. Returns an empty policy - if the resource exists and does not have a policy set. + Gets the access control policy for a ``Queue``. Returns an empty + policy if the resource exists and does not have a policy set. Authorization requires the following `Google IAM `__ permission on the specified @@ -996,7 +996,7 @@ def get_iam_policy( ) request = iam_policy_pb2.GetIamPolicyRequest( - resource=resource, options=options_ + resource=resource, options=options_, ) if metadata is None: metadata = [] @@ -1024,8 +1024,8 @@ def set_iam_policy( metadata=None, ): """ - Sets the access control policy for a ``Queue``. Replaces any existing - policy. + Sets the access control policy for a ``Queue``. Replaces any + existing policy. Note: The Cloud Console does not check queue-level IAM permissions yet. Project-level permissions are required to use the Cloud Console. @@ -1089,7 +1089,7 @@ def set_iam_policy( client_info=self._client_info, ) - request = iam_policy_pb2.SetIamPolicyRequest(resource=resource, policy=policy) + request = iam_policy_pb2.SetIamPolicyRequest(resource=resource, policy=policy,) if metadata is None: metadata = [] metadata = list(metadata) @@ -1116,9 +1116,9 @@ def test_iam_permissions( metadata=None, ): """ - Returns permissions that a caller has on a ``Queue``. If the resource - does not exist, this will return an empty set of permissions, not a - ``NOT_FOUND`` error. + Returns permissions that a caller has on a ``Queue``. If the + resource does not exist, this will return an empty set of permissions, + not a ``NOT_FOUND`` error. Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization @@ -1140,8 +1140,8 @@ def test_iam_permissions( Args: resource (str): REQUIRED: The resource for which the policy detail is being requested. See the operation documentation for the appropriate value for this field. - permissions (list[str]): The set of permissions to check for the ``resource``. Permissions with - wildcards (such as '*' or 'storage.*') are not allowed. For more + permissions (list[str]): The set of permissions to check for the ``resource``. Permissions + with wildcards (such as '*' or 'storage.*') are not allowed. For more information see `IAM Overview `__. retry (Optional[google.api_core.retry.Retry]): A retry object used @@ -1175,7 +1175,7 @@ def test_iam_permissions( ) request = iam_policy_pb2.TestIamPermissionsRequest( - resource=resource, permissions=permissions + resource=resource, permissions=permissions, ) if metadata is None: metadata = [] @@ -1237,10 +1237,10 @@ def list_tasks( Args: parent (str): Required. The queue name. For example: ``projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`` - response_view (~google.cloud.tasks_v2beta3.enums.Task.View): The response\_view specifies which subset of the ``Task`` will be + response_view (~google.cloud.tasks_v2beta3.enums.Task.View): The response_view specifies which subset of the ``Task`` will be returned. - By default response\_view is ``BASIC``; not all information is retrieved + By default response_view is ``BASIC``; 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. @@ -1287,7 +1287,7 @@ def list_tasks( ) request = cloudtasks_pb2.ListTasksRequest( - parent=parent, response_view=response_view, page_size=page_size + parent=parent, response_view=response_view, page_size=page_size, ) if metadata is None: metadata = [] @@ -1340,10 +1340,10 @@ def get_task( Args: name (str): Required. The task name. For example: ``projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`` - response_view (~google.cloud.tasks_v2beta3.enums.Task.View): The response\_view specifies which subset of the ``Task`` will be + response_view (~google.cloud.tasks_v2beta3.enums.Task.View): The response_view specifies which subset of the ``Task`` will be returned. - By default response\_view is ``BASIC``; not all information is retrieved + By default response_view is ``BASIC``; 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. @@ -1381,7 +1381,7 @@ def get_task( client_info=self._client_info, ) - request = cloudtasks_pb2.GetTaskRequest(name=name, response_view=response_view) + request = cloudtasks_pb2.GetTaskRequest(name=name, response_view=response_view,) if metadata is None: metadata = [] metadata = list(metadata) @@ -1465,10 +1465,10 @@ def create_task( If a dict is provided, it must be of the same form as the protobuf message :class:`~google.cloud.tasks_v2beta3.types.Task` - response_view (~google.cloud.tasks_v2beta3.enums.Task.View): The response\_view specifies which subset of the ``Task`` will be + response_view (~google.cloud.tasks_v2beta3.enums.Task.View): The response_view specifies which subset of the ``Task`` will be returned. - By default response\_view is ``BASIC``; not all information is retrieved + By default response_view is ``BASIC``; 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. @@ -1507,7 +1507,7 @@ def create_task( ) request = cloudtasks_pb2.CreateTaskRequest( - parent=parent, task=task, response_view=response_view + parent=parent, task=task, response_view=response_view, ) if metadata is None: metadata = [] @@ -1579,7 +1579,7 @@ def delete_task( client_info=self._client_info, ) - request = cloudtasks_pb2.DeleteTaskRequest(name=name) + request = cloudtasks_pb2.DeleteTaskRequest(name=name,) if metadata is None: metadata = [] metadata = list(metadata) @@ -1640,10 +1640,10 @@ def run_task( Args: name (str): Required. The task name. For example: ``projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`` - response_view (~google.cloud.tasks_v2beta3.enums.Task.View): The response\_view specifies which subset of the ``Task`` will be + response_view (~google.cloud.tasks_v2beta3.enums.Task.View): The response_view specifies which subset of the ``Task`` will be returned. - By default response\_view is ``BASIC``; not all information is retrieved + By default response_view is ``BASIC``; 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. @@ -1681,7 +1681,7 @@ def run_task( client_info=self._client_info, ) - request = cloudtasks_pb2.RunTaskRequest(name=name, response_view=response_view) + request = cloudtasks_pb2.RunTaskRequest(name=name, response_view=response_view,) if metadata is None: metadata = [] metadata = list(metadata) diff --git a/google/cloud/tasks_v2beta3/gapic/cloud_tasks_client_config.py b/google/cloud/tasks_v2beta3/gapic/cloud_tasks_client_config.py index b70f7947..0db084a8 100644 --- a/google/cloud/tasks_v2beta3/gapic/cloud_tasks_client_config.py +++ b/google/cloud/tasks_v2beta3/gapic/cloud_tasks_client_config.py @@ -2,100 +2,119 @@ "interfaces": { "google.cloud.tasks.v2beta3.CloudTasks": { "retry_codes": { - "idempotent": ["DEADLINE_EXCEEDED", "UNAVAILABLE"], - "non_idempotent": [], + "retry_policy_1_codes": ["DEADLINE_EXCEEDED", "UNAVAILABLE"], + "no_retry_codes": [], + "no_retry_1_codes": [], }, "retry_params": { - "default": { + "retry_policy_1_params": { "initial_retry_delay_millis": 100, "retry_delay_multiplier": 1.3, - "max_retry_delay_millis": 60000, - "initial_rpc_timeout_millis": 20000, + "max_retry_delay_millis": 10000, + "initial_rpc_timeout_millis": 10000, "rpc_timeout_multiplier": 1.0, - "max_rpc_timeout_millis": 20000, - "total_timeout_millis": 600000, - } + "max_rpc_timeout_millis": 10000, + "total_timeout_millis": 10000, + }, + "no_retry_params": { + "initial_retry_delay_millis": 0, + "retry_delay_multiplier": 0.0, + "max_retry_delay_millis": 0, + "initial_rpc_timeout_millis": 0, + "rpc_timeout_multiplier": 1.0, + "max_rpc_timeout_millis": 0, + "total_timeout_millis": 0, + }, + "no_retry_1_params": { + "initial_retry_delay_millis": 0, + "retry_delay_multiplier": 0.0, + "max_retry_delay_millis": 0, + "initial_rpc_timeout_millis": 10000, + "rpc_timeout_multiplier": 1.0, + "max_rpc_timeout_millis": 10000, + "total_timeout_millis": 10000, + }, }, "methods": { "ListQueues": { "timeout_millis": 15000, - "retry_codes_name": "idempotent", - "retry_params_name": "default", + "retry_codes_name": "retry_policy_1_codes", + "retry_params_name": "retry_policy_1_params", }, "GetQueue": { "timeout_millis": 10000, - "retry_codes_name": "idempotent", - "retry_params_name": "default", + "retry_codes_name": "retry_policy_1_codes", + "retry_params_name": "retry_policy_1_params", }, "CreateQueue": { "timeout_millis": 10000, - "retry_codes_name": "non_idempotent", - "retry_params_name": "default", + "retry_codes_name": "no_retry_1_codes", + "retry_params_name": "no_retry_1_params", }, "UpdateQueue": { "timeout_millis": 10000, - "retry_codes_name": "non_idempotent", - "retry_params_name": "default", + "retry_codes_name": "no_retry_1_codes", + "retry_params_name": "no_retry_1_params", }, "DeleteQueue": { "timeout_millis": 10000, - "retry_codes_name": "idempotent", - "retry_params_name": "default", + "retry_codes_name": "retry_policy_1_codes", + "retry_params_name": "retry_policy_1_params", }, "PurgeQueue": { "timeout_millis": 10000, - "retry_codes_name": "non_idempotent", - "retry_params_name": "default", + "retry_codes_name": "no_retry_1_codes", + "retry_params_name": "no_retry_1_params", }, "PauseQueue": { "timeout_millis": 10000, - "retry_codes_name": "non_idempotent", - "retry_params_name": "default", + "retry_codes_name": "no_retry_1_codes", + "retry_params_name": "no_retry_1_params", }, "ResumeQueue": { "timeout_millis": 10000, - "retry_codes_name": "non_idempotent", - "retry_params_name": "default", + "retry_codes_name": "no_retry_1_codes", + "retry_params_name": "no_retry_1_params", }, "GetIamPolicy": { "timeout_millis": 10000, - "retry_codes_name": "non_idempotent", - "retry_params_name": "default", + "retry_codes_name": "retry_policy_1_codes", + "retry_params_name": "retry_policy_1_params", }, "SetIamPolicy": { "timeout_millis": 10000, - "retry_codes_name": "non_idempotent", - "retry_params_name": "default", + "retry_codes_name": "no_retry_1_codes", + "retry_params_name": "no_retry_1_params", }, "TestIamPermissions": { "timeout_millis": 10000, - "retry_codes_name": "non_idempotent", - "retry_params_name": "default", + "retry_codes_name": "retry_policy_1_codes", + "retry_params_name": "retry_policy_1_params", }, "ListTasks": { "timeout_millis": 10000, - "retry_codes_name": "idempotent", - "retry_params_name": "default", + "retry_codes_name": "retry_policy_1_codes", + "retry_params_name": "retry_policy_1_params", }, "GetTask": { "timeout_millis": 10000, - "retry_codes_name": "idempotent", - "retry_params_name": "default", + "retry_codes_name": "retry_policy_1_codes", + "retry_params_name": "retry_policy_1_params", }, "CreateTask": { "timeout_millis": 10000, - "retry_codes_name": "non_idempotent", - "retry_params_name": "default", + "retry_codes_name": "no_retry_1_codes", + "retry_params_name": "no_retry_1_params", }, "DeleteTask": { "timeout_millis": 10000, - "retry_codes_name": "non_idempotent", - "retry_params_name": "default", + "retry_codes_name": "retry_policy_1_codes", + "retry_params_name": "retry_policy_1_params", }, "RunTask": { "timeout_millis": 10000, - "retry_codes_name": "non_idempotent", - "retry_params_name": "default", + "retry_codes_name": "no_retry_1_codes", + "retry_params_name": "no_retry_1_params", }, }, } diff --git a/google/cloud/tasks_v2beta3/gapic/enums.py b/google/cloud/tasks_v2beta3/gapic/enums.py index 6b4abbeb..1c243db6 100644 --- a/google/cloud/tasks_v2beta3/gapic/enums.py +++ b/google/cloud/tasks_v2beta3/gapic/enums.py @@ -82,6 +82,20 @@ class State(enum.IntEnum): PAUSED = 2 DISABLED = 3 + class Type(enum.IntEnum): + """ + The type of the queue. + + Attributes: + TYPE_UNSPECIFIED (int): Default value. + PULL (int): A pull queue. + PUSH (int): A push queue. + """ + + TYPE_UNSPECIFIED = 0 + PULL = 1 + PUSH = 2 + class Task(object): class View(enum.IntEnum): @@ -95,8 +109,8 @@ class View(enum.IntEnum): Attributes: VIEW_UNSPECIFIED (int): Unspecified. Defaults to BASIC. - BASIC (int): The basic view omits fields which can be large or can contain sensitive - data. + BASIC (int): The basic view omits fields which can be large or can contain + sensitive data. This view does not include the ``body in AppEngineHttpRequest``. Bodies are desirable to return only when needed, because they can be large and diff --git a/google/cloud/tasks_v2beta3/gapic/transports/cloud_tasks_grpc_transport.py b/google/cloud/tasks_v2beta3/gapic/transports/cloud_tasks_grpc_transport.py index 9858eb6d..7d7d4f99 100644 --- a/google/cloud/tasks_v2beta3/gapic/transports/cloud_tasks_grpc_transport.py +++ b/google/cloud/tasks_v2beta3/gapic/transports/cloud_tasks_grpc_transport.py @@ -53,7 +53,7 @@ def __init__( # exception (channels come with credentials baked in already). if channel is not None and credentials is not None: raise ValueError( - "The `channel` and `credentials` arguments are mutually " "exclusive." + "The `channel` and `credentials` arguments are mutually " "exclusive.", ) # Create the channel. @@ -71,7 +71,9 @@ def __init__( # gRPC uses objects called "stubs" that are bound to the # channel and provide a basic method for each RPC. - self._stubs = {"cloud_tasks_stub": cloudtasks_pb2_grpc.CloudTasksStub(channel)} + self._stubs = { + "cloud_tasks_stub": cloudtasks_pb2_grpc.CloudTasksStub(channel), + } @classmethod def create_channel( @@ -267,8 +269,8 @@ def resume_queue(self): def get_iam_policy(self): """Return the gRPC stub for :meth:`CloudTasksClient.get_iam_policy`. - Gets the access control policy for a ``Queue``. Returns an empty policy - if the resource exists and does not have a policy set. + Gets the access control policy for a ``Queue``. Returns an empty + policy if the resource exists and does not have a policy set. Authorization requires the following `Google IAM `__ permission on the specified @@ -287,8 +289,8 @@ def get_iam_policy(self): def set_iam_policy(self): """Return the gRPC stub for :meth:`CloudTasksClient.set_iam_policy`. - Sets the access control policy for a ``Queue``. Replaces any existing - policy. + Sets the access control policy for a ``Queue``. Replaces any + existing policy. Note: The Cloud Console does not check queue-level IAM permissions yet. Project-level permissions are required to use the Cloud Console. @@ -310,9 +312,9 @@ def set_iam_policy(self): def test_iam_permissions(self): """Return the gRPC stub for :meth:`CloudTasksClient.test_iam_permissions`. - Returns permissions that a caller has on a ``Queue``. If the resource - does not exist, this will return an empty set of permissions, not a - ``NOT_FOUND`` error. + Returns permissions that a caller has on a ``Queue``. If the + resource does not exist, this will return an empty set of permissions, + not a ``NOT_FOUND`` error. Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization diff --git a/google/cloud/tasks_v2beta3/proto/cloudtasks.proto b/google/cloud/tasks_v2beta3/proto/cloudtasks.proto index 711c7a61..de3460f6 100644 --- a/google/cloud/tasks_v2beta3/proto/cloudtasks.proto +++ b/google/cloud/tasks_v2beta3/proto/cloudtasks.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; diff --git a/google/cloud/tasks_v2beta3/proto/cloudtasks_pb2.py b/google/cloud/tasks_v2beta3/proto/cloudtasks_pb2.py index 7f0ec4d9..80db9c78 100644 --- a/google/cloud/tasks_v2beta3/proto/cloudtasks_pb2.py +++ b/google/cloud/tasks_v2beta3/proto/cloudtasks_pb2.py @@ -1,10 +1,7 @@ # -*- coding: utf-8 -*- # Generated by the protocol buffer compiler. DO NOT EDIT! # source: google/cloud/tasks_v2beta3/proto/cloudtasks.proto - -import sys - -_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1")) +"""Generated protocol buffer code.""" from google.protobuf import descriptor as _descriptor from google.protobuf import message as _message from google.protobuf import reflection as _reflection @@ -35,12 +32,9 @@ name="google/cloud/tasks_v2beta3/proto/cloudtasks.proto", package="google.cloud.tasks.v2beta3", syntax="proto3", - serialized_options=_b( - "\n\036com.google.cloud.tasks.v2beta3B\017CloudTasksProtoP\001Z?google.golang.org/genproto/googleapis/cloud/tasks/v2beta3;tasks\242\002\005TASKS" - ), - serialized_pb=_b( - '\n1google/cloud/tasks_v2beta3/proto/cloudtasks.proto\x12\x1agoogle.cloud.tasks.v2beta3\x1a\x1cgoogle/api/annotations.proto\x1a\x17google/api/client.proto\x1a\x1fgoogle/api/field_behavior.proto\x1a\x19google/api/resource.proto\x1a,google/cloud/tasks_v2beta3/proto/queue.proto\x1a+google/cloud/tasks_v2beta3/proto/task.proto\x1a\x1egoogle/iam/v1/iam_policy.proto\x1a\x1agoogle/iam/v1/policy.proto\x1a\x1bgoogle/protobuf/empty.proto\x1a google/protobuf/field_mask.proto"\x83\x01\n\x11ListQueuesRequest\x12\x37\n\x06parent\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\x12\x1f\x63loudtasks.googleapis.com/Queue\x12\x0e\n\x06\x66ilter\x18\x02 \x01(\t\x12\x11\n\tpage_size\x18\x03 \x01(\x05\x12\x12\n\npage_token\x18\x04 \x01(\t"`\n\x12ListQueuesResponse\x12\x31\n\x06queues\x18\x01 \x03(\x0b\x32!.google.cloud.tasks.v2beta3.Queue\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"H\n\x0fGetQueueRequest\x12\x35\n\x04name\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\n\x1f\x63loudtasks.googleapis.com/Queue"\x84\x01\n\x12\x43reateQueueRequest\x12\x37\n\x06parent\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\x12\x1f\x63loudtasks.googleapis.com/Queue\x12\x35\n\x05queue\x18\x02 \x01(\x0b\x32!.google.cloud.tasks.v2beta3.QueueB\x03\xe0\x41\x02"|\n\x12UpdateQueueRequest\x12\x35\n\x05queue\x18\x01 \x01(\x0b\x32!.google.cloud.tasks.v2beta3.QueueB\x03\xe0\x41\x02\x12/\n\x0bupdate_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMask"K\n\x12\x44\x65leteQueueRequest\x12\x35\n\x04name\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\n\x1f\x63loudtasks.googleapis.com/Queue"J\n\x11PurgeQueueRequest\x12\x35\n\x04name\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\n\x1f\x63loudtasks.googleapis.com/Queue"J\n\x11PauseQueueRequest\x12\x35\n\x04name\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\n\x1f\x63loudtasks.googleapis.com/Queue"K\n\x12ResumeQueueRequest\x12\x35\n\x04name\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\n\x1f\x63loudtasks.googleapis.com/Queue"\xaf\x01\n\x10ListTasksRequest\x12\x36\n\x06parent\x18\x01 \x01(\tB&\xe0\x41\x02\xfa\x41 \x12\x1e\x63loudtasks.googleapis.com/Task\x12<\n\rresponse_view\x18\x02 \x01(\x0e\x32%.google.cloud.tasks.v2beta3.Task.View\x12\x11\n\tpage_size\x18\x03 \x01(\x05\x12\x12\n\npage_token\x18\x04 \x01(\t"]\n\x11ListTasksResponse\x12/\n\x05tasks\x18\x01 \x03(\x0b\x32 .google.cloud.tasks.v2beta3.Task\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"\x84\x01\n\x0eGetTaskRequest\x12\x34\n\x04name\x18\x01 \x01(\tB&\xe0\x41\x02\xfa\x41 \n\x1e\x63loudtasks.googleapis.com/Task\x12<\n\rresponse_view\x18\x02 \x01(\x0e\x32%.google.cloud.tasks.v2beta3.Task.View"\xbe\x01\n\x11\x43reateTaskRequest\x12\x36\n\x06parent\x18\x01 \x01(\tB&\xe0\x41\x02\xfa\x41 \x12\x1e\x63loudtasks.googleapis.com/Task\x12\x33\n\x04task\x18\x02 \x01(\x0b\x32 .google.cloud.tasks.v2beta3.TaskB\x03\xe0\x41\x02\x12<\n\rresponse_view\x18\x03 \x01(\x0e\x32%.google.cloud.tasks.v2beta3.Task.View"I\n\x11\x44\x65leteTaskRequest\x12\x34\n\x04name\x18\x01 \x01(\tB&\xe0\x41\x02\xfa\x41 \n\x1e\x63loudtasks.googleapis.com/Task"\x84\x01\n\x0eRunTaskRequest\x12\x34\n\x04name\x18\x01 \x01(\tB&\xe0\x41\x02\xfa\x41 \n\x1e\x63loudtasks.googleapis.com/Task\x12<\n\rresponse_view\x18\x02 \x01(\x0e\x32%.google.cloud.tasks.v2beta3.Task.View2\xa5\x16\n\nCloudTasks\x12\xad\x01\n\nListQueues\x12-.google.cloud.tasks.v2beta3.ListQueuesRequest\x1a..google.cloud.tasks.v2beta3.ListQueuesResponse"@\x82\xd3\xe4\x93\x02\x31\x12//v2beta3/{parent=projects/*/locations/*}/queues\xda\x41\x06parent\x12\x9a\x01\n\x08GetQueue\x12+.google.cloud.tasks.v2beta3.GetQueueRequest\x1a!.google.cloud.tasks.v2beta3.Queue">\x82\xd3\xe4\x93\x02\x31\x12//v2beta3/{name=projects/*/locations/*/queues/*}\xda\x41\x04name\x12\xaf\x01\n\x0b\x43reateQueue\x12..google.cloud.tasks.v2beta3.CreateQueueRequest\x1a!.google.cloud.tasks.v2beta3.Queue"M\x82\xd3\xe4\x93\x02\x38"//v2beta3/{parent=projects/*/locations/*}/queues:\x05queue\xda\x41\x0cparent,queue\x12\xba\x01\n\x0bUpdateQueue\x12..google.cloud.tasks.v2beta3.UpdateQueueRequest\x1a!.google.cloud.tasks.v2beta3.Queue"X\x82\xd3\xe4\x93\x02>25/v2beta3/{queue.name=projects/*/locations/*/queues/*}:\x05queue\xda\x41\x11queue,update_mask\x12\x95\x01\n\x0b\x44\x65leteQueue\x12..google.cloud.tasks.v2beta3.DeleteQueueRequest\x1a\x16.google.protobuf.Empty">\x82\xd3\xe4\x93\x02\x31*//v2beta3/{name=projects/*/locations/*/queues/*}\xda\x41\x04name\x12\xa7\x01\n\nPurgeQueue\x12-.google.cloud.tasks.v2beta3.PurgeQueueRequest\x1a!.google.cloud.tasks.v2beta3.Queue"G\x82\xd3\xe4\x93\x02:"5/v2beta3/{name=projects/*/locations/*/queues/*}:purge:\x01*\xda\x41\x04name\x12\xa7\x01\n\nPauseQueue\x12-.google.cloud.tasks.v2beta3.PauseQueueRequest\x1a!.google.cloud.tasks.v2beta3.Queue"G\x82\xd3\xe4\x93\x02:"5/v2beta3/{name=projects/*/locations/*/queues/*}:pause:\x01*\xda\x41\x04name\x12\xaa\x01\n\x0bResumeQueue\x12..google.cloud.tasks.v2beta3.ResumeQueueRequest\x1a!.google.cloud.tasks.v2beta3.Queue"H\x82\xd3\xe4\x93\x02;"6/v2beta3/{name=projects/*/locations/*/queues/*}:resume:\x01*\xda\x41\x04name\x12\xa1\x01\n\x0cGetIamPolicy\x12".google.iam.v1.GetIamPolicyRequest\x1a\x15.google.iam.v1.Policy"V\x82\xd3\xe4\x93\x02\x45"@/v2beta3/{resource=projects/*/locations/*/queues/*}:getIamPolicy:\x01*\xda\x41\x08resource\x12\xa8\x01\n\x0cSetIamPolicy\x12".google.iam.v1.SetIamPolicyRequest\x1a\x15.google.iam.v1.Policy"]\x82\xd3\xe4\x93\x02\x45"@/v2beta3/{resource=projects/*/locations/*/queues/*}:setIamPolicy:\x01*\xda\x41\x0fresource,policy\x12\xd3\x01\n\x12TestIamPermissions\x12(.google.iam.v1.TestIamPermissionsRequest\x1a).google.iam.v1.TestIamPermissionsResponse"h\x82\xd3\xe4\x93\x02K"F/v2beta3/{resource=projects/*/locations/*/queues/*}:testIamPermissions:\x01*\xda\x41\x14resource,permissions\x12\xb2\x01\n\tListTasks\x12,.google.cloud.tasks.v2beta3.ListTasksRequest\x1a-.google.cloud.tasks.v2beta3.ListTasksResponse"H\x82\xd3\xe4\x93\x02\x39\x12\x37/v2beta3/{parent=projects/*/locations/*/queues/*}/tasks\xda\x41\x06parent\x12\x9f\x01\n\x07GetTask\x12*.google.cloud.tasks.v2beta3.GetTaskRequest\x1a .google.cloud.tasks.v2beta3.Task"F\x82\xd3\xe4\x93\x02\x39\x12\x37/v2beta3/{name=projects/*/locations/*/queues/*/tasks/*}\xda\x41\x04name\x12\xaf\x01\n\nCreateTask\x12-.google.cloud.tasks.v2beta3.CreateTaskRequest\x1a .google.cloud.tasks.v2beta3.Task"P\x82\xd3\xe4\x93\x02<"7/v2beta3/{parent=projects/*/locations/*/queues/*}/tasks:\x01*\xda\x41\x0bparent,task\x12\x9b\x01\n\nDeleteTask\x12-.google.cloud.tasks.v2beta3.DeleteTaskRequest\x1a\x16.google.protobuf.Empty"F\x82\xd3\xe4\x93\x02\x39*7/v2beta3/{name=projects/*/locations/*/queues/*/tasks/*}\xda\x41\x04name\x12\xa6\x01\n\x07RunTask\x12*.google.cloud.tasks.v2beta3.RunTaskRequest\x1a .google.cloud.tasks.v2beta3.Task"M\x82\xd3\xe4\x93\x02@";/v2beta3/{name=projects/*/locations/*/queues/*/tasks/*}:run:\x01*\xda\x41\x04name\x1aM\xca\x41\x19\x63loudtasks.googleapis.com\xd2\x41.https://www.googleapis.com/auth/cloud-platformB|\n\x1e\x63om.google.cloud.tasks.v2beta3B\x0f\x43loudTasksProtoP\x01Z?google.golang.org/genproto/googleapis/cloud/tasks/v2beta3;tasks\xa2\x02\x05TASKSb\x06proto3' - ), + serialized_options=b"\n\036com.google.cloud.tasks.v2beta3B\017CloudTasksProtoP\001Z?google.golang.org/genproto/googleapis/cloud/tasks/v2beta3;tasks\242\002\005TASKS", + create_key=_descriptor._internal_create_key, + serialized_pb=b'\n1google/cloud/tasks_v2beta3/proto/cloudtasks.proto\x12\x1agoogle.cloud.tasks.v2beta3\x1a\x1cgoogle/api/annotations.proto\x1a\x17google/api/client.proto\x1a\x1fgoogle/api/field_behavior.proto\x1a\x19google/api/resource.proto\x1a,google/cloud/tasks_v2beta3/proto/queue.proto\x1a+google/cloud/tasks_v2beta3/proto/task.proto\x1a\x1egoogle/iam/v1/iam_policy.proto\x1a\x1agoogle/iam/v1/policy.proto\x1a\x1bgoogle/protobuf/empty.proto\x1a google/protobuf/field_mask.proto"\x83\x01\n\x11ListQueuesRequest\x12\x37\n\x06parent\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\x12\x1f\x63loudtasks.googleapis.com/Queue\x12\x0e\n\x06\x66ilter\x18\x02 \x01(\t\x12\x11\n\tpage_size\x18\x03 \x01(\x05\x12\x12\n\npage_token\x18\x04 \x01(\t"`\n\x12ListQueuesResponse\x12\x31\n\x06queues\x18\x01 \x03(\x0b\x32!.google.cloud.tasks.v2beta3.Queue\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"H\n\x0fGetQueueRequest\x12\x35\n\x04name\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\n\x1f\x63loudtasks.googleapis.com/Queue"\x84\x01\n\x12\x43reateQueueRequest\x12\x37\n\x06parent\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\x12\x1f\x63loudtasks.googleapis.com/Queue\x12\x35\n\x05queue\x18\x02 \x01(\x0b\x32!.google.cloud.tasks.v2beta3.QueueB\x03\xe0\x41\x02"|\n\x12UpdateQueueRequest\x12\x35\n\x05queue\x18\x01 \x01(\x0b\x32!.google.cloud.tasks.v2beta3.QueueB\x03\xe0\x41\x02\x12/\n\x0bupdate_mask\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.FieldMask"K\n\x12\x44\x65leteQueueRequest\x12\x35\n\x04name\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\n\x1f\x63loudtasks.googleapis.com/Queue"J\n\x11PurgeQueueRequest\x12\x35\n\x04name\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\n\x1f\x63loudtasks.googleapis.com/Queue"J\n\x11PauseQueueRequest\x12\x35\n\x04name\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\n\x1f\x63loudtasks.googleapis.com/Queue"K\n\x12ResumeQueueRequest\x12\x35\n\x04name\x18\x01 \x01(\tB\'\xe0\x41\x02\xfa\x41!\n\x1f\x63loudtasks.googleapis.com/Queue"\xaf\x01\n\x10ListTasksRequest\x12\x36\n\x06parent\x18\x01 \x01(\tB&\xe0\x41\x02\xfa\x41 \x12\x1e\x63loudtasks.googleapis.com/Task\x12<\n\rresponse_view\x18\x02 \x01(\x0e\x32%.google.cloud.tasks.v2beta3.Task.View\x12\x11\n\tpage_size\x18\x03 \x01(\x05\x12\x12\n\npage_token\x18\x04 \x01(\t"]\n\x11ListTasksResponse\x12/\n\x05tasks\x18\x01 \x03(\x0b\x32 .google.cloud.tasks.v2beta3.Task\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t"\x84\x01\n\x0eGetTaskRequest\x12\x34\n\x04name\x18\x01 \x01(\tB&\xe0\x41\x02\xfa\x41 \n\x1e\x63loudtasks.googleapis.com/Task\x12<\n\rresponse_view\x18\x02 \x01(\x0e\x32%.google.cloud.tasks.v2beta3.Task.View"\xbe\x01\n\x11\x43reateTaskRequest\x12\x36\n\x06parent\x18\x01 \x01(\tB&\xe0\x41\x02\xfa\x41 \x12\x1e\x63loudtasks.googleapis.com/Task\x12\x33\n\x04task\x18\x02 \x01(\x0b\x32 .google.cloud.tasks.v2beta3.TaskB\x03\xe0\x41\x02\x12<\n\rresponse_view\x18\x03 \x01(\x0e\x32%.google.cloud.tasks.v2beta3.Task.View"I\n\x11\x44\x65leteTaskRequest\x12\x34\n\x04name\x18\x01 \x01(\tB&\xe0\x41\x02\xfa\x41 \n\x1e\x63loudtasks.googleapis.com/Task"\x84\x01\n\x0eRunTaskRequest\x12\x34\n\x04name\x18\x01 \x01(\tB&\xe0\x41\x02\xfa\x41 \n\x1e\x63loudtasks.googleapis.com/Task\x12<\n\rresponse_view\x18\x02 \x01(\x0e\x32%.google.cloud.tasks.v2beta3.Task.View2\xa5\x16\n\nCloudTasks\x12\xad\x01\n\nListQueues\x12-.google.cloud.tasks.v2beta3.ListQueuesRequest\x1a..google.cloud.tasks.v2beta3.ListQueuesResponse"@\x82\xd3\xe4\x93\x02\x31\x12//v2beta3/{parent=projects/*/locations/*}/queues\xda\x41\x06parent\x12\x9a\x01\n\x08GetQueue\x12+.google.cloud.tasks.v2beta3.GetQueueRequest\x1a!.google.cloud.tasks.v2beta3.Queue">\x82\xd3\xe4\x93\x02\x31\x12//v2beta3/{name=projects/*/locations/*/queues/*}\xda\x41\x04name\x12\xaf\x01\n\x0b\x43reateQueue\x12..google.cloud.tasks.v2beta3.CreateQueueRequest\x1a!.google.cloud.tasks.v2beta3.Queue"M\x82\xd3\xe4\x93\x02\x38"//v2beta3/{parent=projects/*/locations/*}/queues:\x05queue\xda\x41\x0cparent,queue\x12\xba\x01\n\x0bUpdateQueue\x12..google.cloud.tasks.v2beta3.UpdateQueueRequest\x1a!.google.cloud.tasks.v2beta3.Queue"X\x82\xd3\xe4\x93\x02>25/v2beta3/{queue.name=projects/*/locations/*/queues/*}:\x05queue\xda\x41\x11queue,update_mask\x12\x95\x01\n\x0b\x44\x65leteQueue\x12..google.cloud.tasks.v2beta3.DeleteQueueRequest\x1a\x16.google.protobuf.Empty">\x82\xd3\xe4\x93\x02\x31*//v2beta3/{name=projects/*/locations/*/queues/*}\xda\x41\x04name\x12\xa7\x01\n\nPurgeQueue\x12-.google.cloud.tasks.v2beta3.PurgeQueueRequest\x1a!.google.cloud.tasks.v2beta3.Queue"G\x82\xd3\xe4\x93\x02:"5/v2beta3/{name=projects/*/locations/*/queues/*}:purge:\x01*\xda\x41\x04name\x12\xa7\x01\n\nPauseQueue\x12-.google.cloud.tasks.v2beta3.PauseQueueRequest\x1a!.google.cloud.tasks.v2beta3.Queue"G\x82\xd3\xe4\x93\x02:"5/v2beta3/{name=projects/*/locations/*/queues/*}:pause:\x01*\xda\x41\x04name\x12\xaa\x01\n\x0bResumeQueue\x12..google.cloud.tasks.v2beta3.ResumeQueueRequest\x1a!.google.cloud.tasks.v2beta3.Queue"H\x82\xd3\xe4\x93\x02;"6/v2beta3/{name=projects/*/locations/*/queues/*}:resume:\x01*\xda\x41\x04name\x12\xa1\x01\n\x0cGetIamPolicy\x12".google.iam.v1.GetIamPolicyRequest\x1a\x15.google.iam.v1.Policy"V\x82\xd3\xe4\x93\x02\x45"@/v2beta3/{resource=projects/*/locations/*/queues/*}:getIamPolicy:\x01*\xda\x41\x08resource\x12\xa8\x01\n\x0cSetIamPolicy\x12".google.iam.v1.SetIamPolicyRequest\x1a\x15.google.iam.v1.Policy"]\x82\xd3\xe4\x93\x02\x45"@/v2beta3/{resource=projects/*/locations/*/queues/*}:setIamPolicy:\x01*\xda\x41\x0fresource,policy\x12\xd3\x01\n\x12TestIamPermissions\x12(.google.iam.v1.TestIamPermissionsRequest\x1a).google.iam.v1.TestIamPermissionsResponse"h\x82\xd3\xe4\x93\x02K"F/v2beta3/{resource=projects/*/locations/*/queues/*}:testIamPermissions:\x01*\xda\x41\x14resource,permissions\x12\xb2\x01\n\tListTasks\x12,.google.cloud.tasks.v2beta3.ListTasksRequest\x1a-.google.cloud.tasks.v2beta3.ListTasksResponse"H\x82\xd3\xe4\x93\x02\x39\x12\x37/v2beta3/{parent=projects/*/locations/*/queues/*}/tasks\xda\x41\x06parent\x12\x9f\x01\n\x07GetTask\x12*.google.cloud.tasks.v2beta3.GetTaskRequest\x1a .google.cloud.tasks.v2beta3.Task"F\x82\xd3\xe4\x93\x02\x39\x12\x37/v2beta3/{name=projects/*/locations/*/queues/*/tasks/*}\xda\x41\x04name\x12\xaf\x01\n\nCreateTask\x12-.google.cloud.tasks.v2beta3.CreateTaskRequest\x1a .google.cloud.tasks.v2beta3.Task"P\x82\xd3\xe4\x93\x02<"7/v2beta3/{parent=projects/*/locations/*/queues/*}/tasks:\x01*\xda\x41\x0bparent,task\x12\x9b\x01\n\nDeleteTask\x12-.google.cloud.tasks.v2beta3.DeleteTaskRequest\x1a\x16.google.protobuf.Empty"F\x82\xd3\xe4\x93\x02\x39*7/v2beta3/{name=projects/*/locations/*/queues/*/tasks/*}\xda\x41\x04name\x12\xa6\x01\n\x07RunTask\x12*.google.cloud.tasks.v2beta3.RunTaskRequest\x1a .google.cloud.tasks.v2beta3.Task"M\x82\xd3\xe4\x93\x02@";/v2beta3/{name=projects/*/locations/*/queues/*/tasks/*}:run:\x01*\xda\x41\x04name\x1aM\xca\x41\x19\x63loudtasks.googleapis.com\xd2\x41.https://www.googleapis.com/auth/cloud-platformB|\n\x1e\x63om.google.cloud.tasks.v2beta3B\x0f\x43loudTasksProtoP\x01Z?google.golang.org/genproto/googleapis/cloud/tasks/v2beta3;tasks\xa2\x02\x05TASKSb\x06proto3', dependencies=[ google_dot_api_dot_annotations__pb2.DESCRIPTOR, google_dot_api_dot_client__pb2.DESCRIPTOR, @@ -62,6 +56,7 @@ filename=None, file=DESCRIPTOR, containing_type=None, + create_key=_descriptor._internal_create_key, fields=[ _descriptor.FieldDescriptor( name="parent", @@ -72,16 +67,15 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b( - "\340A\002\372A!\022\037cloudtasks.googleapis.com/Queue" - ), + serialized_options=b"\340A\002\372A!\022\037cloudtasks.googleapis.com/Queue", file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="filter", @@ -92,7 +86,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -100,6 +94,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="page_size", @@ -118,6 +113,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="page_token", @@ -128,7 +124,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -136,6 +132,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), ], extensions=[], @@ -157,6 +154,7 @@ filename=None, file=DESCRIPTOR, containing_type=None, + create_key=_descriptor._internal_create_key, fields=[ _descriptor.FieldDescriptor( name="queues", @@ -175,6 +173,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="next_page_token", @@ -185,7 +184,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -193,6 +192,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), ], extensions=[], @@ -214,6 +214,7 @@ filename=None, file=DESCRIPTOR, containing_type=None, + create_key=_descriptor._internal_create_key, fields=[ _descriptor.FieldDescriptor( name="name", @@ -224,17 +225,16 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b( - "\340A\002\372A!\n\037cloudtasks.googleapis.com/Queue" - ), + serialized_options=b"\340A\002\372A!\n\037cloudtasks.googleapis.com/Queue", file=DESCRIPTOR, - ) + create_key=_descriptor._internal_create_key, + ), ], extensions=[], nested_types=[], @@ -255,6 +255,7 @@ filename=None, file=DESCRIPTOR, containing_type=None, + create_key=_descriptor._internal_create_key, fields=[ _descriptor.FieldDescriptor( name="parent", @@ -265,16 +266,15 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b( - "\340A\002\372A!\022\037cloudtasks.googleapis.com/Queue" - ), + serialized_options=b"\340A\002\372A!\022\037cloudtasks.googleapis.com/Queue", file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="queue", @@ -291,8 +291,9 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b("\340A\002"), + serialized_options=b"\340A\002", file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), ], extensions=[], @@ -314,6 +315,7 @@ filename=None, file=DESCRIPTOR, containing_type=None, + create_key=_descriptor._internal_create_key, fields=[ _descriptor.FieldDescriptor( name="queue", @@ -330,8 +332,9 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b("\340A\002"), + serialized_options=b"\340A\002", file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="update_mask", @@ -350,6 +353,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), ], extensions=[], @@ -371,6 +375,7 @@ filename=None, file=DESCRIPTOR, containing_type=None, + create_key=_descriptor._internal_create_key, fields=[ _descriptor.FieldDescriptor( name="name", @@ -381,17 +386,16 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b( - "\340A\002\372A!\n\037cloudtasks.googleapis.com/Queue" - ), + serialized_options=b"\340A\002\372A!\n\037cloudtasks.googleapis.com/Queue", file=DESCRIPTOR, - ) + create_key=_descriptor._internal_create_key, + ), ], extensions=[], nested_types=[], @@ -412,6 +416,7 @@ filename=None, file=DESCRIPTOR, containing_type=None, + create_key=_descriptor._internal_create_key, fields=[ _descriptor.FieldDescriptor( name="name", @@ -422,17 +427,16 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b( - "\340A\002\372A!\n\037cloudtasks.googleapis.com/Queue" - ), + serialized_options=b"\340A\002\372A!\n\037cloudtasks.googleapis.com/Queue", file=DESCRIPTOR, - ) + create_key=_descriptor._internal_create_key, + ), ], extensions=[], nested_types=[], @@ -453,6 +457,7 @@ filename=None, file=DESCRIPTOR, containing_type=None, + create_key=_descriptor._internal_create_key, fields=[ _descriptor.FieldDescriptor( name="name", @@ -463,17 +468,16 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b( - "\340A\002\372A!\n\037cloudtasks.googleapis.com/Queue" - ), + serialized_options=b"\340A\002\372A!\n\037cloudtasks.googleapis.com/Queue", file=DESCRIPTOR, - ) + create_key=_descriptor._internal_create_key, + ), ], extensions=[], nested_types=[], @@ -494,6 +498,7 @@ filename=None, file=DESCRIPTOR, containing_type=None, + create_key=_descriptor._internal_create_key, fields=[ _descriptor.FieldDescriptor( name="name", @@ -504,17 +509,16 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b( - "\340A\002\372A!\n\037cloudtasks.googleapis.com/Queue" - ), + serialized_options=b"\340A\002\372A!\n\037cloudtasks.googleapis.com/Queue", file=DESCRIPTOR, - ) + create_key=_descriptor._internal_create_key, + ), ], extensions=[], nested_types=[], @@ -535,6 +539,7 @@ filename=None, file=DESCRIPTOR, containing_type=None, + create_key=_descriptor._internal_create_key, fields=[ _descriptor.FieldDescriptor( name="parent", @@ -545,16 +550,15 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b( - "\340A\002\372A \022\036cloudtasks.googleapis.com/Task" - ), + serialized_options=b"\340A\002\372A \022\036cloudtasks.googleapis.com/Task", file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="response_view", @@ -573,6 +577,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="page_size", @@ -591,6 +596,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="page_token", @@ -601,7 +607,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -609,6 +615,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), ], extensions=[], @@ -630,6 +637,7 @@ filename=None, file=DESCRIPTOR, containing_type=None, + create_key=_descriptor._internal_create_key, fields=[ _descriptor.FieldDescriptor( name="tasks", @@ -648,6 +656,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="next_page_token", @@ -658,7 +667,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -666,6 +675,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), ], extensions=[], @@ -687,6 +697,7 @@ filename=None, file=DESCRIPTOR, containing_type=None, + create_key=_descriptor._internal_create_key, fields=[ _descriptor.FieldDescriptor( name="name", @@ -697,16 +708,15 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b( - "\340A\002\372A \n\036cloudtasks.googleapis.com/Task" - ), + serialized_options=b"\340A\002\372A \n\036cloudtasks.googleapis.com/Task", file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="response_view", @@ -725,6 +735,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), ], extensions=[], @@ -746,6 +757,7 @@ filename=None, file=DESCRIPTOR, containing_type=None, + create_key=_descriptor._internal_create_key, fields=[ _descriptor.FieldDescriptor( name="parent", @@ -756,16 +768,15 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b( - "\340A\002\372A \022\036cloudtasks.googleapis.com/Task" - ), + serialized_options=b"\340A\002\372A \022\036cloudtasks.googleapis.com/Task", file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="task", @@ -782,8 +793,9 @@ containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b("\340A\002"), + serialized_options=b"\340A\002", file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="response_view", @@ -802,6 +814,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), ], extensions=[], @@ -823,6 +836,7 @@ filename=None, file=DESCRIPTOR, containing_type=None, + create_key=_descriptor._internal_create_key, fields=[ _descriptor.FieldDescriptor( name="name", @@ -833,17 +847,16 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b( - "\340A\002\372A \n\036cloudtasks.googleapis.com/Task" - ), + serialized_options=b"\340A\002\372A \n\036cloudtasks.googleapis.com/Task", file=DESCRIPTOR, - ) + create_key=_descriptor._internal_create_key, + ), ], extensions=[], nested_types=[], @@ -864,6 +877,7 @@ filename=None, file=DESCRIPTOR, containing_type=None, + create_key=_descriptor._internal_create_key, fields=[ _descriptor.FieldDescriptor( name="name", @@ -874,16 +888,15 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, is_extension=False, extension_scope=None, - serialized_options=_b( - "\340A\002\372A \n\036cloudtasks.googleapis.com/Task" - ), + serialized_options=b"\340A\002\372A \n\036cloudtasks.googleapis.com/Task", file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="response_view", @@ -902,6 +915,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), ], extensions=[], @@ -966,11 +980,12 @@ ListQueuesRequest = _reflection.GeneratedProtocolMessageType( "ListQueuesRequest", (_message.Message,), - dict( - DESCRIPTOR=_LISTQUEUESREQUEST, - __module__="google.cloud.tasks_v2beta3.proto.cloudtasks_pb2", - __doc__="""Request message for + { + "DESCRIPTOR": _LISTQUEUESREQUEST, + "__module__": "google.cloud.tasks_v2beta3.proto.cloudtasks_pb2", + "__doc__": """Request message for [ListQueues][google.cloud.tasks.v2beta3.CloudTasks.ListQueues]. + Attributes: parent: Required. The location name. For example: @@ -980,41 +995,42 @@ [Queue][google.cloud.tasks.v2beta3.Queue] field can be used as a filter and several operators as supported. For example: ``<=, <, >=, >, !=, =, :``. The filter syntax is the same as - described in `Stackdriver's Advanced Logs Filters `_. Sample - filter "state: PAUSED". Note that using filters might cause - fewer queues than the requested page\_size to be returned. + filter “state: PAUSED”. Note that using filters might cause + fewer queues than the requested page_size to be returned. page_size: Requested page size. The maximum page size is 9800. If unspecified, the page size will be the maximum. Fewer queues than requested might be returned, even if more queues exist; - use the [next\_page\_token][google.cloud.tasks.v2beta3.ListQue - uesResponse.next\_page\_token] in the response to determine if + use the [next_page_token][google.cloud.tasks.v2beta3.ListQueue + sResponse.next_page_token] in the response to determine if more queues exist. page_token: A token identifying the page of results to return. To request - the first page results, page\_token must be empty. To request - the next page of results, page\_token must be the value of [ne - xt\_page\_token][google.cloud.tasks.v2beta3.ListQueuesResponse - .next\_page\_token] returned from the previous call to + the first page results, page_token must be empty. To request + the next page of results, page_token must be the value of [nex + t_page_token][google.cloud.tasks.v2beta3.ListQueuesResponse.ne + xt_page_token] returned from the previous call to [ListQueues][google.cloud.tasks.v2beta3.CloudTasks.ListQueues] method. It is an error to switch the value of the [filter][google.cloud.tasks.v2beta3.ListQueuesRequest.filter] while iterating through pages. """, # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta3.ListQueuesRequest) - ), + }, ) _sym_db.RegisterMessage(ListQueuesRequest) ListQueuesResponse = _reflection.GeneratedProtocolMessageType( "ListQueuesResponse", (_message.Message,), - dict( - DESCRIPTOR=_LISTQUEUESRESPONSE, - __module__="google.cloud.tasks_v2beta3.proto.cloudtasks_pb2", - __doc__="""Response message for + { + "DESCRIPTOR": _LISTQUEUESRESPONSE, + "__module__": "google.cloud.tasks_v2beta3.proto.cloudtasks_pb2", + "__doc__": """Response message for [ListQueues][google.cloud.tasks.v2beta3.CloudTasks.ListQueues]. + Attributes: queues: The list of queues. @@ -1022,75 +1038,78 @@ A token to retrieve next page of results. To return the next page of results, call [ListQueues][google.cloud.tasks.v2beta3.CloudTasks.ListQueues] - with this value as the [page\_token][google.cloud.tasks.v2beta - 3.ListQueuesRequest.page\_token]. If the next\_page\_token is + with this value as the [page_token][google.cloud.tasks.v2beta3 + .ListQueuesRequest.page_token]. If the next_page_token is empty, there are no more results. The page token is valid for only 2 hours. """, # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta3.ListQueuesResponse) - ), + }, ) _sym_db.RegisterMessage(ListQueuesResponse) GetQueueRequest = _reflection.GeneratedProtocolMessageType( "GetQueueRequest", (_message.Message,), - dict( - DESCRIPTOR=_GETQUEUEREQUEST, - __module__="google.cloud.tasks_v2beta3.proto.cloudtasks_pb2", - __doc__="""Request message for + { + "DESCRIPTOR": _GETQUEUEREQUEST, + "__module__": "google.cloud.tasks_v2beta3.proto.cloudtasks_pb2", + "__doc__": """Request message for [GetQueue][google.cloud.tasks.v2beta3.CloudTasks.GetQueue]. + Attributes: name: Required. The resource name of the queue. For example: ``projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`` """, # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta3.GetQueueRequest) - ), + }, ) _sym_db.RegisterMessage(GetQueueRequest) CreateQueueRequest = _reflection.GeneratedProtocolMessageType( "CreateQueueRequest", (_message.Message,), - dict( - DESCRIPTOR=_CREATEQUEUEREQUEST, - __module__="google.cloud.tasks_v2beta3.proto.cloudtasks_pb2", - __doc__="""Request message for + { + "DESCRIPTOR": _CREATEQUEUEREQUEST, + "__module__": "google.cloud.tasks_v2beta3.proto.cloudtasks_pb2", + "__doc__": """Request message for [CreateQueue][google.cloud.tasks.v2beta3.CloudTasks.CreateQueue]. + Attributes: parent: Required. The location name in which the queue will be created. For example: ``projects/PROJECT_ID/locations/LOCATION_ID`` The list of - allowed locations can be obtained by calling Cloud Tasks' + allowed locations can be obtained by calling Cloud Tasks’ implementation of [ListLocations][google.cloud.location.Locati ons.ListLocations]. queue: - Required. The queue to create. [Queue's + Required. The queue to create. [Queue’s name][google.cloud.tasks.v2beta3.Queue.name] cannot be the same as an existing queue. """, # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta3.CreateQueueRequest) - ), + }, ) _sym_db.RegisterMessage(CreateQueueRequest) UpdateQueueRequest = _reflection.GeneratedProtocolMessageType( "UpdateQueueRequest", (_message.Message,), - dict( - DESCRIPTOR=_UPDATEQUEUEREQUEST, - __module__="google.cloud.tasks_v2beta3.proto.cloudtasks_pb2", - __doc__="""Request message for + { + "DESCRIPTOR": _UPDATEQUEUEREQUEST, + "__module__": "google.cloud.tasks_v2beta3.proto.cloudtasks_pb2", + "__doc__": """Request message for [UpdateQueue][google.cloud.tasks.v2beta3.CloudTasks.UpdateQueue]. + Attributes: queue: - Required. The queue to create or update. The queue's + Required. The queue to create or update. The queue’s [name][google.cloud.tasks.v2beta3.Queue.name] must be specified. Output only fields cannot be modified using UpdateQueue. Any value specified for an output only field will - be ignored. The queue's + be ignored. The queue’s [name][google.cloud.tasks.v2beta3.Queue.name] cannot be changed. update_mask: @@ -1098,98 +1117,103 @@ updated. If empty, then all fields will be updated. """, # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta3.UpdateQueueRequest) - ), + }, ) _sym_db.RegisterMessage(UpdateQueueRequest) DeleteQueueRequest = _reflection.GeneratedProtocolMessageType( "DeleteQueueRequest", (_message.Message,), - dict( - DESCRIPTOR=_DELETEQUEUEREQUEST, - __module__="google.cloud.tasks_v2beta3.proto.cloudtasks_pb2", - __doc__="""Request message for + { + "DESCRIPTOR": _DELETEQUEUEREQUEST, + "__module__": "google.cloud.tasks_v2beta3.proto.cloudtasks_pb2", + "__doc__": """Request message for [DeleteQueue][google.cloud.tasks.v2beta3.CloudTasks.DeleteQueue]. + Attributes: name: Required. The queue name. For example: ``projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`` """, # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta3.DeleteQueueRequest) - ), + }, ) _sym_db.RegisterMessage(DeleteQueueRequest) PurgeQueueRequest = _reflection.GeneratedProtocolMessageType( "PurgeQueueRequest", (_message.Message,), - dict( - DESCRIPTOR=_PURGEQUEUEREQUEST, - __module__="google.cloud.tasks_v2beta3.proto.cloudtasks_pb2", - __doc__="""Request message for + { + "DESCRIPTOR": _PURGEQUEUEREQUEST, + "__module__": "google.cloud.tasks_v2beta3.proto.cloudtasks_pb2", + "__doc__": """Request message for [PurgeQueue][google.cloud.tasks.v2beta3.CloudTasks.PurgeQueue]. + Attributes: name: Required. The queue name. For example: ``projects/PROJECT_ID/location/LOCATION_ID/queues/QUEUE_ID`` """, # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta3.PurgeQueueRequest) - ), + }, ) _sym_db.RegisterMessage(PurgeQueueRequest) PauseQueueRequest = _reflection.GeneratedProtocolMessageType( "PauseQueueRequest", (_message.Message,), - dict( - DESCRIPTOR=_PAUSEQUEUEREQUEST, - __module__="google.cloud.tasks_v2beta3.proto.cloudtasks_pb2", - __doc__="""Request message for + { + "DESCRIPTOR": _PAUSEQUEUEREQUEST, + "__module__": "google.cloud.tasks_v2beta3.proto.cloudtasks_pb2", + "__doc__": """Request message for [PauseQueue][google.cloud.tasks.v2beta3.CloudTasks.PauseQueue]. + Attributes: name: Required. The queue name. For example: ``projects/PROJECT_ID/location/LOCATION_ID/queues/QUEUE_ID`` """, # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta3.PauseQueueRequest) - ), + }, ) _sym_db.RegisterMessage(PauseQueueRequest) ResumeQueueRequest = _reflection.GeneratedProtocolMessageType( "ResumeQueueRequest", (_message.Message,), - dict( - DESCRIPTOR=_RESUMEQUEUEREQUEST, - __module__="google.cloud.tasks_v2beta3.proto.cloudtasks_pb2", - __doc__="""Request message for + { + "DESCRIPTOR": _RESUMEQUEUEREQUEST, + "__module__": "google.cloud.tasks_v2beta3.proto.cloudtasks_pb2", + "__doc__": """Request message for [ResumeQueue][google.cloud.tasks.v2beta3.CloudTasks.ResumeQueue]. + Attributes: name: Required. The queue name. For example: ``projects/PROJECT_ID/location/LOCATION_ID/queues/QUEUE_ID`` """, # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta3.ResumeQueueRequest) - ), + }, ) _sym_db.RegisterMessage(ResumeQueueRequest) ListTasksRequest = _reflection.GeneratedProtocolMessageType( "ListTasksRequest", (_message.Message,), - dict( - DESCRIPTOR=_LISTTASKSREQUEST, - __module__="google.cloud.tasks_v2beta3.proto.cloudtasks_pb2", - __doc__="""Request message for listing tasks using + { + "DESCRIPTOR": _LISTTASKSREQUEST, + "__module__": "google.cloud.tasks_v2beta3.proto.cloudtasks_pb2", + "__doc__": """Request message for listing tasks using [ListTasks][google.cloud.tasks.v2beta3.CloudTasks.ListTasks]. + Attributes: parent: Required. The queue name. For example: ``projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`` response_view: - The response\_view specifies which subset of the + The response_view specifies which subset of the [Task][google.cloud.tasks.v2beta3.Task] will be returned. By - default response\_view is + default response_view is [BASIC][google.cloud.tasks.v2beta3.Task.View.BASIC]; not all information is retrieved by default because some data, such as payloads, might be desirable to return only when needed @@ -1201,33 +1225,34 @@ [Task][google.cloud.tasks.v2beta3.Task] resource. page_size: Maximum page size. Fewer tasks than requested might be - returned, even if more tasks exist; use [next\_page\_token][go - ogle.cloud.tasks.v2beta3.ListTasksResponse.next\_page\_token] - in the response to determine if more tasks exist. The maximum + returned, even if more tasks exist; use [next_page_token][goog + le.cloud.tasks.v2beta3.ListTasksResponse.next_page_token] in + the response to determine if more tasks exist. The maximum page size is 1000. If unspecified, the page size will be the maximum. page_token: A token identifying the page of results to return. To request - the first page results, page\_token must be empty. To request - the next page of results, page\_token must be the value of [ne - xt\_page\_token][google.cloud.tasks.v2beta3.ListTasksResponse. - next\_page\_token] returned from the previous call to + the first page results, page_token must be empty. To request + the next page of results, page_token must be the value of [nex + t_page_token][google.cloud.tasks.v2beta3.ListTasksResponse.nex + t_page_token] returned from the previous call to [ListTasks][google.cloud.tasks.v2beta3.CloudTasks.ListTasks] method. The page token is valid for only 2 hours. """, # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta3.ListTasksRequest) - ), + }, ) _sym_db.RegisterMessage(ListTasksRequest) ListTasksResponse = _reflection.GeneratedProtocolMessageType( "ListTasksResponse", (_message.Message,), - dict( - DESCRIPTOR=_LISTTASKSRESPONSE, - __module__="google.cloud.tasks_v2beta3.proto.cloudtasks_pb2", - __doc__="""Response message for listing tasks using + { + "DESCRIPTOR": _LISTTASKSRESPONSE, + "__module__": "google.cloud.tasks_v2beta3.proto.cloudtasks_pb2", + "__doc__": """Response message for listing tasks using [ListTasks][google.cloud.tasks.v2beta3.CloudTasks.ListTasks]. + Attributes: tasks: The list of tasks. @@ -1235,31 +1260,32 @@ A token to retrieve next page of results. To return the next page of results, call [ListTasks][google.cloud.tasks.v2beta3.CloudTasks.ListTasks] - with this value as the [page\_token][google.cloud.tasks.v2beta - 3.ListTasksRequest.page\_token]. If the next\_page\_token is + with this value as the [page_token][google.cloud.tasks.v2beta3 + .ListTasksRequest.page_token]. If the next_page_token is empty, there are no more results. """, # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta3.ListTasksResponse) - ), + }, ) _sym_db.RegisterMessage(ListTasksResponse) GetTaskRequest = _reflection.GeneratedProtocolMessageType( "GetTaskRequest", (_message.Message,), - dict( - DESCRIPTOR=_GETTASKREQUEST, - __module__="google.cloud.tasks_v2beta3.proto.cloudtasks_pb2", - __doc__="""Request message for getting a task using + { + "DESCRIPTOR": _GETTASKREQUEST, + "__module__": "google.cloud.tasks_v2beta3.proto.cloudtasks_pb2", + "__doc__": """Request message for getting a task using [GetTask][google.cloud.tasks.v2beta3.CloudTasks.GetTask]. + Attributes: name: Required. The task name. For example: ``projects/PROJECT_ID/lo cations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`` response_view: - The response\_view specifies which subset of the + The response_view specifies which subset of the [Task][google.cloud.tasks.v2beta3.Task] will be returned. By - default response\_view is + default response_view is [BASIC][google.cloud.tasks.v2beta3.Task.View.BASIC]; not all information is retrieved by default because some data, such as payloads, might be desirable to return only when needed @@ -1271,18 +1297,19 @@ [Task][google.cloud.tasks.v2beta3.Task] resource. """, # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta3.GetTaskRequest) - ), + }, ) _sym_db.RegisterMessage(GetTaskRequest) CreateTaskRequest = _reflection.GeneratedProtocolMessageType( "CreateTaskRequest", (_message.Message,), - dict( - DESCRIPTOR=_CREATETASKREQUEST, - __module__="google.cloud.tasks_v2beta3.proto.cloudtasks_pb2", - __doc__="""Request message for + { + "DESCRIPTOR": _CREATETASKREQUEST, + "__module__": "google.cloud.tasks_v2beta3.proto.cloudtasks_pb2", + "__doc__": """Request message for [CreateTask][google.cloud.tasks.v2beta3.CloudTasks.CreateTask]. + Attributes: parent: Required. The queue name. For example: @@ -1295,19 +1322,19 @@ [name][google.cloud.tasks.v2beta3.Task.name]. If a name is not specified then the system will generate a random unique task id, which will be set in the task returned in the - [response][google.cloud.tasks.v2beta3.Task.name]. If [schedul - e\_time][google.cloud.tasks.v2beta3.Task.schedule\_time] is - not set or is in the past then Cloud Tasks will set it to the - current time. Task De-duplication: Explicitly specifying a - task ID enables task de-duplication. If a task's ID is + [response][google.cloud.tasks.v2beta3.Task.name]. If + [schedule_time][google.cloud.tasks.v2beta3.Task.schedule_time] + is not set or is in the past then Cloud Tasks will set it to + the current time. Task De-duplication: Explicitly specifying + a task ID enables task de-duplication. If a task’s ID is identical to that of an existing task or a task that was deleted or executed recently then the call will fail with - [ALREADY\_EXISTS][google.rpc.Code.ALREADY\_EXISTS]. If the - task's queue was created using Cloud Tasks, then another task - with the same name can't be created for ~1hour after the - original task was deleted or executed. If the task's queue was + [ALREADY_EXISTS][google.rpc.Code.ALREADY_EXISTS]. If the + task’s queue was created using Cloud Tasks, then another task + with the same name can’t be created for ~1hour after the + original task was deleted or executed. If the task’s queue was created using queue.yaml or queue.xml, then another task with - the same name can't be created for ~9days after the original + the same name can’t be created for ~9days after the original task was deleted or executed. Because there is an extra lookup cost to identify duplicate task names, these [CreateTask][google.cloud.tasks.v2beta3.CloudTasks.CreateTask] @@ -1319,9 +1346,9 @@ infrastructure relies on an approximately uniform distribution of task ids to store and serve tasks efficiently. response_view: - The response\_view specifies which subset of the + The response_view specifies which subset of the [Task][google.cloud.tasks.v2beta3.Task] will be returned. By - default response\_view is + default response_view is [BASIC][google.cloud.tasks.v2beta3.Task.View.BASIC]; not all information is retrieved by default because some data, such as payloads, might be desirable to return only when needed @@ -1333,44 +1360,46 @@ [Task][google.cloud.tasks.v2beta3.Task] resource. """, # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta3.CreateTaskRequest) - ), + }, ) _sym_db.RegisterMessage(CreateTaskRequest) DeleteTaskRequest = _reflection.GeneratedProtocolMessageType( "DeleteTaskRequest", (_message.Message,), - dict( - DESCRIPTOR=_DELETETASKREQUEST, - __module__="google.cloud.tasks_v2beta3.proto.cloudtasks_pb2", - __doc__="""Request message for deleting a task using + { + "DESCRIPTOR": _DELETETASKREQUEST, + "__module__": "google.cloud.tasks_v2beta3.proto.cloudtasks_pb2", + "__doc__": """Request message for deleting a task using [DeleteTask][google.cloud.tasks.v2beta3.CloudTasks.DeleteTask]. + Attributes: name: Required. The task name. For example: ``projects/PROJECT_ID/lo cations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`` """, # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta3.DeleteTaskRequest) - ), + }, ) _sym_db.RegisterMessage(DeleteTaskRequest) RunTaskRequest = _reflection.GeneratedProtocolMessageType( "RunTaskRequest", (_message.Message,), - dict( - DESCRIPTOR=_RUNTASKREQUEST, - __module__="google.cloud.tasks_v2beta3.proto.cloudtasks_pb2", - __doc__="""Request message for forcing a task to run now using + { + "DESCRIPTOR": _RUNTASKREQUEST, + "__module__": "google.cloud.tasks_v2beta3.proto.cloudtasks_pb2", + "__doc__": """Request message for forcing a task to run now using [RunTask][google.cloud.tasks.v2beta3.CloudTasks.RunTask]. + Attributes: name: Required. The task name. For example: ``projects/PROJECT_ID/lo cations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`` response_view: - The response\_view specifies which subset of the + The response_view specifies which subset of the [Task][google.cloud.tasks.v2beta3.Task] will be returned. By - default response\_view is + default response_view is [BASIC][google.cloud.tasks.v2beta3.Task.View.BASIC]; not all information is retrieved by default because some data, such as payloads, might be desirable to return only when needed @@ -1382,7 +1411,7 @@ [Task][google.cloud.tasks.v2beta3.Task] resource. """, # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta3.RunTaskRequest) - ), + }, ) _sym_db.RegisterMessage(RunTaskRequest) @@ -1409,9 +1438,8 @@ full_name="google.cloud.tasks.v2beta3.CloudTasks", file=DESCRIPTOR, index=0, - serialized_options=_b( - "\312A\031cloudtasks.googleapis.com\322A.https://www.googleapis.com/auth/cloud-platform" - ), + serialized_options=b"\312A\031cloudtasks.googleapis.com\322A.https://www.googleapis.com/auth/cloud-platform", + create_key=_descriptor._internal_create_key, serialized_start=2095, serialized_end=4948, methods=[ @@ -1422,9 +1450,8 @@ containing_service=None, input_type=_LISTQUEUESREQUEST, output_type=_LISTQUEUESRESPONSE, - serialized_options=_b( - "\202\323\344\223\0021\022//v2beta3/{parent=projects/*/locations/*}/queues\332A\006parent" - ), + serialized_options=b"\202\323\344\223\0021\022//v2beta3/{parent=projects/*/locations/*}/queues\332A\006parent", + create_key=_descriptor._internal_create_key, ), _descriptor.MethodDescriptor( name="GetQueue", @@ -1433,9 +1460,8 @@ containing_service=None, input_type=_GETQUEUEREQUEST, output_type=google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_queue__pb2._QUEUE, - serialized_options=_b( - "\202\323\344\223\0021\022//v2beta3/{name=projects/*/locations/*/queues/*}\332A\004name" - ), + serialized_options=b"\202\323\344\223\0021\022//v2beta3/{name=projects/*/locations/*/queues/*}\332A\004name", + create_key=_descriptor._internal_create_key, ), _descriptor.MethodDescriptor( name="CreateQueue", @@ -1444,9 +1470,8 @@ containing_service=None, input_type=_CREATEQUEUEREQUEST, output_type=google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_queue__pb2._QUEUE, - serialized_options=_b( - '\202\323\344\223\0028"//v2beta3/{parent=projects/*/locations/*}/queues:\005queue\332A\014parent,queue' - ), + serialized_options=b'\202\323\344\223\0028"//v2beta3/{parent=projects/*/locations/*}/queues:\005queue\332A\014parent,queue', + create_key=_descriptor._internal_create_key, ), _descriptor.MethodDescriptor( name="UpdateQueue", @@ -1455,9 +1480,8 @@ containing_service=None, input_type=_UPDATEQUEUEREQUEST, output_type=google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_queue__pb2._QUEUE, - serialized_options=_b( - "\202\323\344\223\002>25/v2beta3/{queue.name=projects/*/locations/*/queues/*}:\005queue\332A\021queue,update_mask" - ), + serialized_options=b"\202\323\344\223\002>25/v2beta3/{queue.name=projects/*/locations/*/queues/*}:\005queue\332A\021queue,update_mask", + create_key=_descriptor._internal_create_key, ), _descriptor.MethodDescriptor( name="DeleteQueue", @@ -1466,9 +1490,8 @@ containing_service=None, input_type=_DELETEQUEUEREQUEST, output_type=google_dot_protobuf_dot_empty__pb2._EMPTY, - serialized_options=_b( - "\202\323\344\223\0021*//v2beta3/{name=projects/*/locations/*/queues/*}\332A\004name" - ), + serialized_options=b"\202\323\344\223\0021*//v2beta3/{name=projects/*/locations/*/queues/*}\332A\004name", + create_key=_descriptor._internal_create_key, ), _descriptor.MethodDescriptor( name="PurgeQueue", @@ -1477,9 +1500,8 @@ containing_service=None, input_type=_PURGEQUEUEREQUEST, output_type=google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_queue__pb2._QUEUE, - serialized_options=_b( - '\202\323\344\223\002:"5/v2beta3/{name=projects/*/locations/*/queues/*}:purge:\001*\332A\004name' - ), + serialized_options=b'\202\323\344\223\002:"5/v2beta3/{name=projects/*/locations/*/queues/*}:purge:\001*\332A\004name', + create_key=_descriptor._internal_create_key, ), _descriptor.MethodDescriptor( name="PauseQueue", @@ -1488,9 +1510,8 @@ containing_service=None, input_type=_PAUSEQUEUEREQUEST, output_type=google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_queue__pb2._QUEUE, - serialized_options=_b( - '\202\323\344\223\002:"5/v2beta3/{name=projects/*/locations/*/queues/*}:pause:\001*\332A\004name' - ), + serialized_options=b'\202\323\344\223\002:"5/v2beta3/{name=projects/*/locations/*/queues/*}:pause:\001*\332A\004name', + create_key=_descriptor._internal_create_key, ), _descriptor.MethodDescriptor( name="ResumeQueue", @@ -1499,9 +1520,8 @@ containing_service=None, input_type=_RESUMEQUEUEREQUEST, output_type=google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_queue__pb2._QUEUE, - serialized_options=_b( - '\202\323\344\223\002;"6/v2beta3/{name=projects/*/locations/*/queues/*}:resume:\001*\332A\004name' - ), + serialized_options=b'\202\323\344\223\002;"6/v2beta3/{name=projects/*/locations/*/queues/*}:resume:\001*\332A\004name', + create_key=_descriptor._internal_create_key, ), _descriptor.MethodDescriptor( name="GetIamPolicy", @@ -1510,9 +1530,8 @@ containing_service=None, input_type=google_dot_iam_dot_v1_dot_iam__policy__pb2._GETIAMPOLICYREQUEST, output_type=google_dot_iam_dot_v1_dot_policy__pb2._POLICY, - serialized_options=_b( - '\202\323\344\223\002E"@/v2beta3/{resource=projects/*/locations/*/queues/*}:getIamPolicy:\001*\332A\010resource' - ), + serialized_options=b'\202\323\344\223\002E"@/v2beta3/{resource=projects/*/locations/*/queues/*}:getIamPolicy:\001*\332A\010resource', + create_key=_descriptor._internal_create_key, ), _descriptor.MethodDescriptor( name="SetIamPolicy", @@ -1521,9 +1540,8 @@ containing_service=None, input_type=google_dot_iam_dot_v1_dot_iam__policy__pb2._SETIAMPOLICYREQUEST, output_type=google_dot_iam_dot_v1_dot_policy__pb2._POLICY, - serialized_options=_b( - '\202\323\344\223\002E"@/v2beta3/{resource=projects/*/locations/*/queues/*}:setIamPolicy:\001*\332A\017resource,policy' - ), + serialized_options=b'\202\323\344\223\002E"@/v2beta3/{resource=projects/*/locations/*/queues/*}:setIamPolicy:\001*\332A\017resource,policy', + create_key=_descriptor._internal_create_key, ), _descriptor.MethodDescriptor( name="TestIamPermissions", @@ -1532,9 +1550,8 @@ containing_service=None, input_type=google_dot_iam_dot_v1_dot_iam__policy__pb2._TESTIAMPERMISSIONSREQUEST, output_type=google_dot_iam_dot_v1_dot_iam__policy__pb2._TESTIAMPERMISSIONSRESPONSE, - serialized_options=_b( - '\202\323\344\223\002K"F/v2beta3/{resource=projects/*/locations/*/queues/*}:testIamPermissions:\001*\332A\024resource,permissions' - ), + serialized_options=b'\202\323\344\223\002K"F/v2beta3/{resource=projects/*/locations/*/queues/*}:testIamPermissions:\001*\332A\024resource,permissions', + create_key=_descriptor._internal_create_key, ), _descriptor.MethodDescriptor( name="ListTasks", @@ -1543,9 +1560,8 @@ containing_service=None, input_type=_LISTTASKSREQUEST, output_type=_LISTTASKSRESPONSE, - serialized_options=_b( - "\202\323\344\223\0029\0227/v2beta3/{parent=projects/*/locations/*/queues/*}/tasks\332A\006parent" - ), + serialized_options=b"\202\323\344\223\0029\0227/v2beta3/{parent=projects/*/locations/*/queues/*}/tasks\332A\006parent", + create_key=_descriptor._internal_create_key, ), _descriptor.MethodDescriptor( name="GetTask", @@ -1554,9 +1570,8 @@ containing_service=None, input_type=_GETTASKREQUEST, output_type=google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_task__pb2._TASK, - serialized_options=_b( - "\202\323\344\223\0029\0227/v2beta3/{name=projects/*/locations/*/queues/*/tasks/*}\332A\004name" - ), + serialized_options=b"\202\323\344\223\0029\0227/v2beta3/{name=projects/*/locations/*/queues/*/tasks/*}\332A\004name", + create_key=_descriptor._internal_create_key, ), _descriptor.MethodDescriptor( name="CreateTask", @@ -1565,9 +1580,8 @@ containing_service=None, input_type=_CREATETASKREQUEST, output_type=google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_task__pb2._TASK, - serialized_options=_b( - '\202\323\344\223\002<"7/v2beta3/{parent=projects/*/locations/*/queues/*}/tasks:\001*\332A\013parent,task' - ), + serialized_options=b'\202\323\344\223\002<"7/v2beta3/{parent=projects/*/locations/*/queues/*}/tasks:\001*\332A\013parent,task', + create_key=_descriptor._internal_create_key, ), _descriptor.MethodDescriptor( name="DeleteTask", @@ -1576,9 +1590,8 @@ containing_service=None, input_type=_DELETETASKREQUEST, output_type=google_dot_protobuf_dot_empty__pb2._EMPTY, - serialized_options=_b( - "\202\323\344\223\0029*7/v2beta3/{name=projects/*/locations/*/queues/*/tasks/*}\332A\004name" - ), + serialized_options=b"\202\323\344\223\0029*7/v2beta3/{name=projects/*/locations/*/queues/*/tasks/*}\332A\004name", + create_key=_descriptor._internal_create_key, ), _descriptor.MethodDescriptor( name="RunTask", @@ -1587,9 +1600,8 @@ containing_service=None, input_type=_RUNTASKREQUEST, output_type=google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_task__pb2._TASK, - serialized_options=_b( - '\202\323\344\223\002@";/v2beta3/{name=projects/*/locations/*/queues/*/tasks/*}:run:\001*\332A\004name' - ), + serialized_options=b'\202\323\344\223\002@";/v2beta3/{name=projects/*/locations/*/queues/*/tasks/*}:run:\001*\332A\004name', + create_key=_descriptor._internal_create_key, ), ], ) diff --git a/google/cloud/tasks_v2beta3/proto/cloudtasks_pb2_grpc.py b/google/cloud/tasks_v2beta3/proto/cloudtasks_pb2_grpc.py index 79dea089..477db97b 100644 --- a/google/cloud/tasks_v2beta3/proto/cloudtasks_pb2_grpc.py +++ b/google/cloud/tasks_v2beta3/proto/cloudtasks_pb2_grpc.py @@ -1,4 +1,5 @@ # Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT! +"""Client and server classes corresponding to protobuf-defined services.""" import grpc from google.cloud.tasks_v2beta3.proto import ( @@ -17,15 +18,15 @@ class CloudTasksStub(object): """Cloud Tasks allows developers to manage the execution of background - work in their applications. - """ + work in their applications. + """ def __init__(self, channel): """Constructor. - Args: - channel: A grpc.Channel. - """ + Args: + channel: A grpc.Channel. + """ self.ListQueues = channel.unary_unary( "/google.cloud.tasks.v2beta3.CloudTasks/ListQueues", request_serializer=google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_cloudtasks__pb2.ListQueuesRequest.SerializeToString, @@ -110,21 +111,21 @@ def __init__(self, channel): class CloudTasksServicer(object): """Cloud Tasks allows developers to manage the execution of background - work in their applications. - """ + work in their applications. + """ def ListQueues(self, request, context): """Lists queues. - Queues are returned in lexicographical order. - """ + Queues are returned in lexicographical order. + """ context.set_code(grpc.StatusCode.UNIMPLEMENTED) context.set_details("Method not implemented!") raise NotImplementedError("Method not implemented!") def GetQueue(self, request, context): """Gets a queue. - """ + """ context.set_code(grpc.StatusCode.UNIMPLEMENTED) context.set_details("Method not implemented!") raise NotImplementedError("Method not implemented!") @@ -132,17 +133,17 @@ def GetQueue(self, request, context): def CreateQueue(self, request, context): """Creates a queue. - Queues created with this method allow tasks to live for a maximum of 31 - days. After a task is 31 days old, the task will be deleted regardless of whether - it was dispatched or not. - - WARNING: Using this method may have unintended side effects if you are - using an App Engine `queue.yaml` or `queue.xml` file to manage your queues. - Read - [Overview of Queue Management and - queue.yaml](https://cloud.google.com/tasks/docs/queue-yaml) before using - this method. - """ + Queues created with this method allow tasks to live for a maximum of 31 + days. After a task is 31 days old, the task will be deleted regardless of whether + it was dispatched or not. + + WARNING: Using this method may have unintended side effects if you are + using an App Engine `queue.yaml` or `queue.xml` file to manage your queues. + Read + [Overview of Queue Management and + queue.yaml](https://cloud.google.com/tasks/docs/queue-yaml) before using + this method. + """ context.set_code(grpc.StatusCode.UNIMPLEMENTED) context.set_details("Method not implemented!") raise NotImplementedError("Method not implemented!") @@ -150,20 +151,20 @@ def CreateQueue(self, request, context): def UpdateQueue(self, request, context): """Updates a queue. - This method creates the queue if it does not exist and updates - the queue if it does exist. + This method creates the queue if it does not exist and updates + the queue if it does exist. - Queues created with this method allow tasks to live for a maximum of 31 - days. After a task is 31 days old, the task will be deleted regardless of whether - it was dispatched or not. + Queues created with this method allow tasks to live for a maximum of 31 + days. After a task is 31 days old, the task will be deleted regardless of whether + it was dispatched or not. - WARNING: Using this method may have unintended side effects if you are - using an App Engine `queue.yaml` or `queue.xml` file to manage your queues. - Read - [Overview of Queue Management and - queue.yaml](https://cloud.google.com/tasks/docs/queue-yaml) before using - this method. - """ + WARNING: Using this method may have unintended side effects if you are + using an App Engine `queue.yaml` or `queue.xml` file to manage your queues. + Read + [Overview of Queue Management and + queue.yaml](https://cloud.google.com/tasks/docs/queue-yaml) before using + this method. + """ context.set_code(grpc.StatusCode.UNIMPLEMENTED) context.set_details("Method not implemented!") raise NotImplementedError("Method not implemented!") @@ -171,18 +172,18 @@ def UpdateQueue(self, request, context): def DeleteQueue(self, request, context): """Deletes a queue. - This command will delete the queue even if it has tasks in it. + This command will delete the queue even if it has tasks in it. - Note: If you delete a queue, a queue with the same name can't be created - for 7 days. + Note: If you delete a queue, a queue with the same name can't be created + for 7 days. - WARNING: Using this method may have unintended side effects if you are - using an App Engine `queue.yaml` or `queue.xml` file to manage your queues. - Read - [Overview of Queue Management and - queue.yaml](https://cloud.google.com/tasks/docs/queue-yaml) before using - this method. - """ + WARNING: Using this method may have unintended side effects if you are + using an App Engine `queue.yaml` or `queue.xml` file to manage your queues. + Read + [Overview of Queue Management and + queue.yaml](https://cloud.google.com/tasks/docs/queue-yaml) before using + this method. + """ context.set_code(grpc.StatusCode.UNIMPLEMENTED) context.set_details("Method not implemented!") raise NotImplementedError("Method not implemented!") @@ -190,11 +191,11 @@ def DeleteQueue(self, request, context): def PurgeQueue(self, request, context): """Purges a queue by deleting all of its tasks. - All tasks created before this method is called are permanently deleted. + All tasks created before this method is called are permanently deleted. - Purge operations can take up to one minute to take effect. Tasks - might be dispatched before the purge takes effect. A purge is irreversible. - """ + Purge operations can take up to one minute to take effect. Tasks + might be dispatched before the purge takes effect. A purge is irreversible. + """ context.set_code(grpc.StatusCode.UNIMPLEMENTED) context.set_details("Method not implemented!") raise NotImplementedError("Method not implemented!") @@ -202,12 +203,12 @@ def PurgeQueue(self, request, context): def PauseQueue(self, request, context): """Pauses the queue. - If a queue is paused then the system will stop dispatching tasks - until the queue is resumed via - [ResumeQueue][google.cloud.tasks.v2beta3.CloudTasks.ResumeQueue]. Tasks can still be added - when the queue is paused. A queue is paused if its - [state][google.cloud.tasks.v2beta3.Queue.state] is [PAUSED][google.cloud.tasks.v2beta3.Queue.State.PAUSED]. - """ + If a queue is paused then the system will stop dispatching tasks + until the queue is resumed via + [ResumeQueue][google.cloud.tasks.v2beta3.CloudTasks.ResumeQueue]. Tasks can still be added + when the queue is paused. A queue is paused if its + [state][google.cloud.tasks.v2beta3.Queue.state] is [PAUSED][google.cloud.tasks.v2beta3.Queue.State.PAUSED]. + """ context.set_code(grpc.StatusCode.UNIMPLEMENTED) context.set_details("Method not implemented!") raise NotImplementedError("Method not implemented!") @@ -215,63 +216,63 @@ def PauseQueue(self, request, context): def ResumeQueue(self, request, context): """Resume a queue. - This method resumes a queue after it has been - [PAUSED][google.cloud.tasks.v2beta3.Queue.State.PAUSED] or - [DISABLED][google.cloud.tasks.v2beta3.Queue.State.DISABLED]. The state of a queue is stored - in the queue's [state][google.cloud.tasks.v2beta3.Queue.state]; after calling this method it - will be set to [RUNNING][google.cloud.tasks.v2beta3.Queue.State.RUNNING]. - - WARNING: Resuming many high-QPS queues at the same time can - lead to target overloading. If you are resuming high-QPS - queues, follow the 500/50/5 pattern described in - [Managing Cloud Tasks Scaling - Risks](https://cloud.google.com/tasks/docs/manage-cloud-task-scaling). - """ + This method resumes a queue after it has been + [PAUSED][google.cloud.tasks.v2beta3.Queue.State.PAUSED] or + [DISABLED][google.cloud.tasks.v2beta3.Queue.State.DISABLED]. The state of a queue is stored + in the queue's [state][google.cloud.tasks.v2beta3.Queue.state]; after calling this method it + will be set to [RUNNING][google.cloud.tasks.v2beta3.Queue.State.RUNNING]. + + WARNING: Resuming many high-QPS queues at the same time can + lead to target overloading. If you are resuming high-QPS + queues, follow the 500/50/5 pattern described in + [Managing Cloud Tasks Scaling + Risks](https://cloud.google.com/tasks/docs/manage-cloud-task-scaling). + """ context.set_code(grpc.StatusCode.UNIMPLEMENTED) context.set_details("Method not implemented!") raise NotImplementedError("Method not implemented!") def GetIamPolicy(self, request, context): """Gets the access control policy for a [Queue][google.cloud.tasks.v2beta3.Queue]. - Returns an empty policy if the resource exists and does not have a policy - set. + Returns an empty policy if the resource exists and does not have a policy + set. - Authorization requires the following - [Google IAM](https://cloud.google.com/iam) permission on the specified - resource parent: + Authorization requires the following + [Google IAM](https://cloud.google.com/iam) permission on the specified + resource parent: - * `cloudtasks.queues.getIamPolicy` - """ + * `cloudtasks.queues.getIamPolicy` + """ context.set_code(grpc.StatusCode.UNIMPLEMENTED) context.set_details("Method not implemented!") raise NotImplementedError("Method not implemented!") def SetIamPolicy(self, request, context): """Sets the access control policy for a [Queue][google.cloud.tasks.v2beta3.Queue]. Replaces any existing - policy. + policy. - Note: The Cloud Console does not check queue-level IAM permissions yet. - Project-level permissions are required to use the Cloud Console. + Note: The Cloud Console does not check queue-level IAM permissions yet. + Project-level permissions are required to use the Cloud Console. - Authorization requires the following - [Google IAM](https://cloud.google.com/iam) permission on the specified - resource parent: + Authorization requires the following + [Google IAM](https://cloud.google.com/iam) permission on the specified + resource parent: - * `cloudtasks.queues.setIamPolicy` - """ + * `cloudtasks.queues.setIamPolicy` + """ context.set_code(grpc.StatusCode.UNIMPLEMENTED) context.set_details("Method not implemented!") raise NotImplementedError("Method not implemented!") def TestIamPermissions(self, request, context): """Returns permissions that a caller has on a [Queue][google.cloud.tasks.v2beta3.Queue]. - If the resource does not exist, this will return an empty set of - permissions, not a [NOT_FOUND][google.rpc.Code.NOT_FOUND] error. + If the resource does not exist, this will return an empty set of + permissions, not a [NOT_FOUND][google.rpc.Code.NOT_FOUND] error. - Note: This operation is designed to be used for building permission-aware - UIs and command-line tools, not for authorization checking. This operation - may "fail open" without warning. - """ + Note: This operation is designed to be used for building permission-aware + UIs and command-line tools, not for authorization checking. This operation + may "fail open" without warning. + """ context.set_code(grpc.StatusCode.UNIMPLEMENTED) context.set_details("Method not implemented!") raise NotImplementedError("Method not implemented!") @@ -279,21 +280,21 @@ def TestIamPermissions(self, request, context): def ListTasks(self, request, context): """Lists the tasks in a queue. - By default, only the [BASIC][google.cloud.tasks.v2beta3.Task.View.BASIC] view is retrieved - due to performance considerations; - [response_view][google.cloud.tasks.v2beta3.ListTasksRequest.response_view] controls the - subset of information which is returned. + By default, only the [BASIC][google.cloud.tasks.v2beta3.Task.View.BASIC] view is retrieved + due to performance considerations; + [response_view][google.cloud.tasks.v2beta3.ListTasksRequest.response_view] controls the + subset of information which is returned. - The tasks may be returned in any order. The ordering may change at any - time. - """ + The tasks may be returned in any order. The ordering may change at any + time. + """ context.set_code(grpc.StatusCode.UNIMPLEMENTED) context.set_details("Method not implemented!") raise NotImplementedError("Method not implemented!") def GetTask(self, request, context): """Gets a task. - """ + """ context.set_code(grpc.StatusCode.UNIMPLEMENTED) context.set_details("Method not implemented!") raise NotImplementedError("Method not implemented!") @@ -301,10 +302,10 @@ def GetTask(self, request, context): def CreateTask(self, request, context): """Creates a task and adds it to a queue. - Tasks cannot be updated after creation; there is no UpdateTask command. + Tasks cannot be updated after creation; there is no UpdateTask command. - * The maximum task size is 100KB. - """ + * The maximum task size is 100KB. + """ context.set_code(grpc.StatusCode.UNIMPLEMENTED) context.set_details("Method not implemented!") raise NotImplementedError("Method not implemented!") @@ -312,10 +313,10 @@ def CreateTask(self, request, context): def DeleteTask(self, request, context): """Deletes a task. - A task can be deleted if it is scheduled or dispatched. A task - cannot be deleted if it has executed successfully or permanently - failed. - """ + A task can be deleted if it is scheduled or dispatched. A task + cannot be deleted if it has executed successfully or permanently + failed. + """ context.set_code(grpc.StatusCode.UNIMPLEMENTED) context.set_details("Method not implemented!") raise NotImplementedError("Method not implemented!") @@ -323,29 +324,29 @@ def DeleteTask(self, request, context): def RunTask(self, request, context): """Forces a task to run now. - When this method is called, Cloud Tasks will dispatch the task, even if - the task is already running, the queue has reached its [RateLimits][google.cloud.tasks.v2beta3.RateLimits] or - is [PAUSED][google.cloud.tasks.v2beta3.Queue.State.PAUSED]. - - This command is meant to be used for manual debugging. For - example, [RunTask][google.cloud.tasks.v2beta3.CloudTasks.RunTask] can be used to retry a failed - task after a fix has been made or to manually force a task to be - dispatched now. - - The dispatched task is returned. That is, the task that is returned - contains the [status][Task.status] after the task is dispatched but - before the task is received by its target. - - If Cloud Tasks receives a successful response from the task's - target, then the task will be deleted; otherwise the task's - [schedule_time][google.cloud.tasks.v2beta3.Task.schedule_time] will be reset to the time that - [RunTask][google.cloud.tasks.v2beta3.CloudTasks.RunTask] was called plus the retry delay specified - in the queue's [RetryConfig][google.cloud.tasks.v2beta3.RetryConfig]. - - [RunTask][google.cloud.tasks.v2beta3.CloudTasks.RunTask] returns - [NOT_FOUND][google.rpc.Code.NOT_FOUND] when it is called on a - task that has already succeeded or permanently failed. - """ + When this method is called, Cloud Tasks will dispatch the task, even if + the task is already running, the queue has reached its [RateLimits][google.cloud.tasks.v2beta3.RateLimits] or + is [PAUSED][google.cloud.tasks.v2beta3.Queue.State.PAUSED]. + + This command is meant to be used for manual debugging. For + example, [RunTask][google.cloud.tasks.v2beta3.CloudTasks.RunTask] can be used to retry a failed + task after a fix has been made or to manually force a task to be + dispatched now. + + The dispatched task is returned. That is, the task that is returned + contains the [status][Task.status] after the task is dispatched but + before the task is received by its target. + + If Cloud Tasks receives a successful response from the task's + target, then the task will be deleted; otherwise the task's + [schedule_time][google.cloud.tasks.v2beta3.Task.schedule_time] will be reset to the time that + [RunTask][google.cloud.tasks.v2beta3.CloudTasks.RunTask] was called plus the retry delay specified + in the queue's [RetryConfig][google.cloud.tasks.v2beta3.RetryConfig]. + + [RunTask][google.cloud.tasks.v2beta3.CloudTasks.RunTask] returns + [NOT_FOUND][google.rpc.Code.NOT_FOUND] when it is called on a + task that has already succeeded or permanently failed. + """ context.set_code(grpc.StatusCode.UNIMPLEMENTED) context.set_details("Method not implemented!") raise NotImplementedError("Method not implemented!") @@ -438,3 +439,442 @@ def add_CloudTasksServicer_to_server(servicer, server): "google.cloud.tasks.v2beta3.CloudTasks", rpc_method_handlers ) server.add_generic_rpc_handlers((generic_handler,)) + + +# This class is part of an EXPERIMENTAL API. +class CloudTasks(object): + """Cloud Tasks allows developers to manage the execution of background + work in their applications. + """ + + @staticmethod + def ListQueues( + request, + target, + options=(), + channel_credentials=None, + call_credentials=None, + compression=None, + wait_for_ready=None, + timeout=None, + metadata=None, + ): + return grpc.experimental.unary_unary( + request, + target, + "/google.cloud.tasks.v2beta3.CloudTasks/ListQueues", + google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_cloudtasks__pb2.ListQueuesRequest.SerializeToString, + google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_cloudtasks__pb2.ListQueuesResponse.FromString, + options, + channel_credentials, + call_credentials, + compression, + wait_for_ready, + timeout, + metadata, + ) + + @staticmethod + def GetQueue( + request, + target, + options=(), + channel_credentials=None, + call_credentials=None, + compression=None, + wait_for_ready=None, + timeout=None, + metadata=None, + ): + return grpc.experimental.unary_unary( + request, + target, + "/google.cloud.tasks.v2beta3.CloudTasks/GetQueue", + google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_cloudtasks__pb2.GetQueueRequest.SerializeToString, + google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_queue__pb2.Queue.FromString, + options, + channel_credentials, + call_credentials, + compression, + wait_for_ready, + timeout, + metadata, + ) + + @staticmethod + def CreateQueue( + request, + target, + options=(), + channel_credentials=None, + call_credentials=None, + compression=None, + wait_for_ready=None, + timeout=None, + metadata=None, + ): + return grpc.experimental.unary_unary( + request, + target, + "/google.cloud.tasks.v2beta3.CloudTasks/CreateQueue", + google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_cloudtasks__pb2.CreateQueueRequest.SerializeToString, + google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_queue__pb2.Queue.FromString, + options, + channel_credentials, + call_credentials, + compression, + wait_for_ready, + timeout, + metadata, + ) + + @staticmethod + def UpdateQueue( + request, + target, + options=(), + channel_credentials=None, + call_credentials=None, + compression=None, + wait_for_ready=None, + timeout=None, + metadata=None, + ): + return grpc.experimental.unary_unary( + request, + target, + "/google.cloud.tasks.v2beta3.CloudTasks/UpdateQueue", + google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_cloudtasks__pb2.UpdateQueueRequest.SerializeToString, + google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_queue__pb2.Queue.FromString, + options, + channel_credentials, + call_credentials, + compression, + wait_for_ready, + timeout, + metadata, + ) + + @staticmethod + def DeleteQueue( + request, + target, + options=(), + channel_credentials=None, + call_credentials=None, + compression=None, + wait_for_ready=None, + timeout=None, + metadata=None, + ): + return grpc.experimental.unary_unary( + request, + target, + "/google.cloud.tasks.v2beta3.CloudTasks/DeleteQueue", + google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_cloudtasks__pb2.DeleteQueueRequest.SerializeToString, + google_dot_protobuf_dot_empty__pb2.Empty.FromString, + options, + channel_credentials, + call_credentials, + compression, + wait_for_ready, + timeout, + metadata, + ) + + @staticmethod + def PurgeQueue( + request, + target, + options=(), + channel_credentials=None, + call_credentials=None, + compression=None, + wait_for_ready=None, + timeout=None, + metadata=None, + ): + return grpc.experimental.unary_unary( + request, + target, + "/google.cloud.tasks.v2beta3.CloudTasks/PurgeQueue", + google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_cloudtasks__pb2.PurgeQueueRequest.SerializeToString, + google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_queue__pb2.Queue.FromString, + options, + channel_credentials, + call_credentials, + compression, + wait_for_ready, + timeout, + metadata, + ) + + @staticmethod + def PauseQueue( + request, + target, + options=(), + channel_credentials=None, + call_credentials=None, + compression=None, + wait_for_ready=None, + timeout=None, + metadata=None, + ): + return grpc.experimental.unary_unary( + request, + target, + "/google.cloud.tasks.v2beta3.CloudTasks/PauseQueue", + google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_cloudtasks__pb2.PauseQueueRequest.SerializeToString, + google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_queue__pb2.Queue.FromString, + options, + channel_credentials, + call_credentials, + compression, + wait_for_ready, + timeout, + metadata, + ) + + @staticmethod + def ResumeQueue( + request, + target, + options=(), + channel_credentials=None, + call_credentials=None, + compression=None, + wait_for_ready=None, + timeout=None, + metadata=None, + ): + return grpc.experimental.unary_unary( + request, + target, + "/google.cloud.tasks.v2beta3.CloudTasks/ResumeQueue", + google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_cloudtasks__pb2.ResumeQueueRequest.SerializeToString, + google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_queue__pb2.Queue.FromString, + options, + channel_credentials, + call_credentials, + compression, + wait_for_ready, + timeout, + metadata, + ) + + @staticmethod + def GetIamPolicy( + request, + target, + options=(), + channel_credentials=None, + call_credentials=None, + compression=None, + wait_for_ready=None, + timeout=None, + metadata=None, + ): + return grpc.experimental.unary_unary( + request, + target, + "/google.cloud.tasks.v2beta3.CloudTasks/GetIamPolicy", + google_dot_iam_dot_v1_dot_iam__policy__pb2.GetIamPolicyRequest.SerializeToString, + google_dot_iam_dot_v1_dot_policy__pb2.Policy.FromString, + options, + channel_credentials, + call_credentials, + compression, + wait_for_ready, + timeout, + metadata, + ) + + @staticmethod + def SetIamPolicy( + request, + target, + options=(), + channel_credentials=None, + call_credentials=None, + compression=None, + wait_for_ready=None, + timeout=None, + metadata=None, + ): + return grpc.experimental.unary_unary( + request, + target, + "/google.cloud.tasks.v2beta3.CloudTasks/SetIamPolicy", + google_dot_iam_dot_v1_dot_iam__policy__pb2.SetIamPolicyRequest.SerializeToString, + google_dot_iam_dot_v1_dot_policy__pb2.Policy.FromString, + options, + channel_credentials, + call_credentials, + compression, + wait_for_ready, + timeout, + metadata, + ) + + @staticmethod + def TestIamPermissions( + request, + target, + options=(), + channel_credentials=None, + call_credentials=None, + compression=None, + wait_for_ready=None, + timeout=None, + metadata=None, + ): + return grpc.experimental.unary_unary( + request, + target, + "/google.cloud.tasks.v2beta3.CloudTasks/TestIamPermissions", + google_dot_iam_dot_v1_dot_iam__policy__pb2.TestIamPermissionsRequest.SerializeToString, + google_dot_iam_dot_v1_dot_iam__policy__pb2.TestIamPermissionsResponse.FromString, + options, + channel_credentials, + call_credentials, + compression, + wait_for_ready, + timeout, + metadata, + ) + + @staticmethod + def ListTasks( + request, + target, + options=(), + channel_credentials=None, + call_credentials=None, + compression=None, + wait_for_ready=None, + timeout=None, + metadata=None, + ): + return grpc.experimental.unary_unary( + request, + target, + "/google.cloud.tasks.v2beta3.CloudTasks/ListTasks", + google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_cloudtasks__pb2.ListTasksRequest.SerializeToString, + google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_cloudtasks__pb2.ListTasksResponse.FromString, + options, + channel_credentials, + call_credentials, + compression, + wait_for_ready, + timeout, + metadata, + ) + + @staticmethod + def GetTask( + request, + target, + options=(), + channel_credentials=None, + call_credentials=None, + compression=None, + wait_for_ready=None, + timeout=None, + metadata=None, + ): + return grpc.experimental.unary_unary( + request, + target, + "/google.cloud.tasks.v2beta3.CloudTasks/GetTask", + google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_cloudtasks__pb2.GetTaskRequest.SerializeToString, + google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_task__pb2.Task.FromString, + options, + channel_credentials, + call_credentials, + compression, + wait_for_ready, + timeout, + metadata, + ) + + @staticmethod + def CreateTask( + request, + target, + options=(), + channel_credentials=None, + call_credentials=None, + compression=None, + wait_for_ready=None, + timeout=None, + metadata=None, + ): + return grpc.experimental.unary_unary( + request, + target, + "/google.cloud.tasks.v2beta3.CloudTasks/CreateTask", + google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_cloudtasks__pb2.CreateTaskRequest.SerializeToString, + google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_task__pb2.Task.FromString, + options, + channel_credentials, + call_credentials, + compression, + wait_for_ready, + timeout, + metadata, + ) + + @staticmethod + def DeleteTask( + request, + target, + options=(), + channel_credentials=None, + call_credentials=None, + compression=None, + wait_for_ready=None, + timeout=None, + metadata=None, + ): + return grpc.experimental.unary_unary( + request, + target, + "/google.cloud.tasks.v2beta3.CloudTasks/DeleteTask", + google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_cloudtasks__pb2.DeleteTaskRequest.SerializeToString, + google_dot_protobuf_dot_empty__pb2.Empty.FromString, + options, + channel_credentials, + call_credentials, + compression, + wait_for_ready, + timeout, + metadata, + ) + + @staticmethod + def RunTask( + request, + target, + options=(), + channel_credentials=None, + call_credentials=None, + compression=None, + wait_for_ready=None, + timeout=None, + metadata=None, + ): + return grpc.experimental.unary_unary( + request, + target, + "/google.cloud.tasks.v2beta3.CloudTasks/RunTask", + google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_cloudtasks__pb2.RunTaskRequest.SerializeToString, + google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_task__pb2.Task.FromString, + options, + channel_credentials, + call_credentials, + compression, + wait_for_ready, + timeout, + metadata, + ) diff --git a/google/cloud/tasks_v2beta3/proto/queue.proto b/google/cloud/tasks_v2beta3/proto/queue.proto index 777e9b8b..b24b7063 100644 --- a/google/cloud/tasks_v2beta3/proto/queue.proto +++ b/google/cloud/tasks_v2beta3/proto/queue.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,12 +11,12 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; package google.cloud.tasks.v2beta3; +import "google/api/field_behavior.proto"; import "google/api/resource.proto"; import "google/cloud/tasks/v2beta3/target.proto"; import "google/protobuf/duration.proto"; @@ -74,6 +74,18 @@ message Queue { DISABLED = 3; } + // The type of the queue. + enum Type { + // Default value. + TYPE_UNSPECIFIED = 0; + + // A pull queue. + PULL = 1; + + // A push queue. + PUSH = 2; + } + // Caller-specified and required in [CreateQueue][google.cloud.tasks.v2beta3.CloudTasks.CreateQueue], // after which it becomes output only. // @@ -166,6 +178,13 @@ message Queue { // [Stackdriver Logging](https://cloud.google.com/logging/docs/). If this // field is unset, then no logs are written. StackdriverLoggingConfig stackdriver_logging_config = 10; + + // Immutable. The type of a queue (push or pull). + // + // `Queue.type` is an immutable property of the queue that is set at the queue + // creation time. When left unspecified, the default value of `PUSH` is + // selected. + Type type = 11 [(google.api.field_behavior) = IMMUTABLE]; } // Rate limits. @@ -322,7 +341,7 @@ message RetryConfig { // A task's retry interval starts at // [min_backoff][google.cloud.tasks.v2beta3.RetryConfig.min_backoff], then doubles // `max_doublings` times, then increases linearly, and finally - // retries retries at intervals of + // retries at intervals of // [max_backoff][google.cloud.tasks.v2beta3.RetryConfig.max_backoff] up to // [max_attempts][google.cloud.tasks.v2beta3.RetryConfig.max_attempts] times. // diff --git a/google/cloud/tasks_v2beta3/proto/queue_pb2.py b/google/cloud/tasks_v2beta3/proto/queue_pb2.py index dbfd8d38..427354eb 100644 --- a/google/cloud/tasks_v2beta3/proto/queue_pb2.py +++ b/google/cloud/tasks_v2beta3/proto/queue_pb2.py @@ -1,10 +1,7 @@ # -*- coding: utf-8 -*- # Generated by the protocol buffer compiler. DO NOT EDIT! # source: google/cloud/tasks_v2beta3/proto/queue.proto - -import sys - -_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1")) +"""Generated protocol buffer code.""" from google.protobuf import descriptor as _descriptor from google.protobuf import message as _message from google.protobuf import reflection as _reflection @@ -15,6 +12,7 @@ _sym_db = _symbol_database.Default() +from google.api import field_behavior_pb2 as google_dot_api_dot_field__behavior__pb2 from google.api import resource_pb2 as google_dot_api_dot_resource__pb2 from google.cloud.tasks_v2beta3.proto import ( target_pb2 as google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_target__pb2, @@ -28,13 +26,11 @@ name="google/cloud/tasks_v2beta3/proto/queue.proto", package="google.cloud.tasks.v2beta3", syntax="proto3", - serialized_options=_b( - "\n\036com.google.cloud.tasks.v2beta3B\nQueueProtoP\001Z?google.golang.org/genproto/googleapis/cloud/tasks/v2beta3;tasks" - ), - serialized_pb=_b( - '\n,google/cloud/tasks_v2beta3/proto/queue.proto\x12\x1agoogle.cloud.tasks.v2beta3\x1a\x19google/api/resource.proto\x1a-google/cloud/tasks_v2beta3/proto/target.proto\x1a\x1egoogle/protobuf/duration.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x1cgoogle/api/annotations.proto"\xd7\x04\n\x05Queue\x12\x0c\n\x04name\x18\x01 \x01(\t\x12O\n\x15\x61pp_engine_http_queue\x18\x03 \x01(\x0b\x32..google.cloud.tasks.v2beta3.AppEngineHttpQueueH\x00\x12;\n\x0brate_limits\x18\x04 \x01(\x0b\x32&.google.cloud.tasks.v2beta3.RateLimits\x12=\n\x0cretry_config\x18\x05 \x01(\x0b\x32\'.google.cloud.tasks.v2beta3.RetryConfig\x12\x36\n\x05state\x18\x06 \x01(\x0e\x32\'.google.cloud.tasks.v2beta3.Queue.State\x12.\n\npurge_time\x18\x07 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12X\n\x1astackdriver_logging_config\x18\n \x01(\x0b\x32\x34.google.cloud.tasks.v2beta3.StackdriverLoggingConfig"E\n\x05State\x12\x15\n\x11STATE_UNSPECIFIED\x10\x00\x12\x0b\n\x07RUNNING\x10\x01\x12\n\n\x06PAUSED\x10\x02\x12\x0c\n\x08\x44ISABLED\x10\x03:\\\xea\x41Y\n\x1f\x63loudtasks.googleapis.com/Queue\x12\x36projects/{project}/locations/{location}/queues/{queue}B\x0c\n\nqueue_type"j\n\nRateLimits\x12!\n\x19max_dispatches_per_second\x18\x01 \x01(\x01\x12\x16\n\x0emax_burst_size\x18\x02 \x01(\x05\x12!\n\x19max_concurrent_dispatches\x18\x03 \x01(\x05"\xd1\x01\n\x0bRetryConfig\x12\x14\n\x0cmax_attempts\x18\x01 \x01(\x05\x12\x35\n\x12max_retry_duration\x18\x02 \x01(\x0b\x32\x19.google.protobuf.Duration\x12.\n\x0bmin_backoff\x18\x03 \x01(\x0b\x32\x19.google.protobuf.Duration\x12.\n\x0bmax_backoff\x18\x04 \x01(\x0b\x32\x19.google.protobuf.Duration\x12\x15\n\rmax_doublings\x18\x05 \x01(\x05"2\n\x18StackdriverLoggingConfig\x12\x16\n\x0esampling_ratio\x18\x01 \x01(\x01\x42o\n\x1e\x63om.google.cloud.tasks.v2beta3B\nQueueProtoP\x01Z?google.golang.org/genproto/googleapis/cloud/tasks/v2beta3;tasksb\x06proto3' - ), + serialized_options=b"\n\036com.google.cloud.tasks.v2beta3B\nQueueProtoP\001Z?google.golang.org/genproto/googleapis/cloud/tasks/v2beta3;tasks", + create_key=_descriptor._internal_create_key, + serialized_pb=b'\n,google/cloud/tasks_v2beta3/proto/queue.proto\x12\x1agoogle.cloud.tasks.v2beta3\x1a\x1fgoogle/api/field_behavior.proto\x1a\x19google/api/resource.proto\x1a-google/cloud/tasks_v2beta3/proto/target.proto\x1a\x1egoogle/protobuf/duration.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x1cgoogle/api/annotations.proto"\xc4\x05\n\x05Queue\x12\x0c\n\x04name\x18\x01 \x01(\t\x12O\n\x15\x61pp_engine_http_queue\x18\x03 \x01(\x0b\x32..google.cloud.tasks.v2beta3.AppEngineHttpQueueH\x00\x12;\n\x0brate_limits\x18\x04 \x01(\x0b\x32&.google.cloud.tasks.v2beta3.RateLimits\x12=\n\x0cretry_config\x18\x05 \x01(\x0b\x32\'.google.cloud.tasks.v2beta3.RetryConfig\x12\x36\n\x05state\x18\x06 \x01(\x0e\x32\'.google.cloud.tasks.v2beta3.Queue.State\x12.\n\npurge_time\x18\x07 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12X\n\x1astackdriver_logging_config\x18\n \x01(\x0b\x32\x34.google.cloud.tasks.v2beta3.StackdriverLoggingConfig\x12\x39\n\x04type\x18\x0b \x01(\x0e\x32&.google.cloud.tasks.v2beta3.Queue.TypeB\x03\xe0\x41\x05"E\n\x05State\x12\x15\n\x11STATE_UNSPECIFIED\x10\x00\x12\x0b\n\x07RUNNING\x10\x01\x12\n\n\x06PAUSED\x10\x02\x12\x0c\n\x08\x44ISABLED\x10\x03"0\n\x04Type\x12\x14\n\x10TYPE_UNSPECIFIED\x10\x00\x12\x08\n\x04PULL\x10\x01\x12\x08\n\x04PUSH\x10\x02:\\\xea\x41Y\n\x1f\x63loudtasks.googleapis.com/Queue\x12\x36projects/{project}/locations/{location}/queues/{queue}B\x0c\n\nqueue_type"j\n\nRateLimits\x12!\n\x19max_dispatches_per_second\x18\x01 \x01(\x01\x12\x16\n\x0emax_burst_size\x18\x02 \x01(\x05\x12!\n\x19max_concurrent_dispatches\x18\x03 \x01(\x05"\xd1\x01\n\x0bRetryConfig\x12\x14\n\x0cmax_attempts\x18\x01 \x01(\x05\x12\x35\n\x12max_retry_duration\x18\x02 \x01(\x0b\x32\x19.google.protobuf.Duration\x12.\n\x0bmin_backoff\x18\x03 \x01(\x0b\x32\x19.google.protobuf.Duration\x12.\n\x0bmax_backoff\x18\x04 \x01(\x0b\x32\x19.google.protobuf.Duration\x12\x15\n\rmax_doublings\x18\x05 \x01(\x05"2\n\x18StackdriverLoggingConfig\x12\x16\n\x0esampling_ratio\x18\x01 \x01(\x01\x42o\n\x1e\x63om.google.cloud.tasks.v2beta3B\nQueueProtoP\x01Z?google.golang.org/genproto/googleapis/cloud/tasks/v2beta3;tasksb\x06proto3', dependencies=[ + google_dot_api_dot_field__behavior__pb2.DESCRIPTOR, google_dot_api_dot_resource__pb2.DESCRIPTOR, google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_target__pb2.DESCRIPTOR, google_dot_protobuf_dot_duration__pb2.DESCRIPTOR, @@ -49,6 +45,7 @@ full_name="google.cloud.tasks.v2beta3.Queue.State", filename=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, values=[ _descriptor.EnumValueDescriptor( name="STATE_UNSPECIFIED", @@ -56,24 +53,79 @@ number=0, serialized_options=None, type=None, + create_key=_descriptor._internal_create_key, ), _descriptor.EnumValueDescriptor( - name="RUNNING", index=1, number=1, serialized_options=None, type=None + name="RUNNING", + index=1, + number=1, + serialized_options=None, + type=None, + create_key=_descriptor._internal_create_key, ), _descriptor.EnumValueDescriptor( - name="PAUSED", index=2, number=2, serialized_options=None, type=None + name="PAUSED", + index=2, + number=2, + serialized_options=None, + type=None, + create_key=_descriptor._internal_create_key, ), _descriptor.EnumValueDescriptor( - name="DISABLED", index=3, number=3, serialized_options=None, type=None + name="DISABLED", + index=3, + number=3, + serialized_options=None, + type=None, + create_key=_descriptor._internal_create_key, ), ], containing_type=None, serialized_options=None, - serialized_start=668, - serialized_end=737, + serialized_start=760, + serialized_end=829, ) _sym_db.RegisterEnumDescriptor(_QUEUE_STATE) +_QUEUE_TYPE = _descriptor.EnumDescriptor( + name="Type", + full_name="google.cloud.tasks.v2beta3.Queue.Type", + filename=None, + file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, + values=[ + _descriptor.EnumValueDescriptor( + name="TYPE_UNSPECIFIED", + index=0, + number=0, + serialized_options=None, + type=None, + create_key=_descriptor._internal_create_key, + ), + _descriptor.EnumValueDescriptor( + name="PULL", + index=1, + number=1, + serialized_options=None, + type=None, + create_key=_descriptor._internal_create_key, + ), + _descriptor.EnumValueDescriptor( + name="PUSH", + index=2, + number=2, + serialized_options=None, + type=None, + create_key=_descriptor._internal_create_key, + ), + ], + containing_type=None, + serialized_options=None, + serialized_start=831, + serialized_end=879, +) +_sym_db.RegisterEnumDescriptor(_QUEUE_TYPE) + _QUEUE = _descriptor.Descriptor( name="Queue", @@ -81,6 +133,7 @@ filename=None, file=DESCRIPTOR, containing_type=None, + create_key=_descriptor._internal_create_key, fields=[ _descriptor.FieldDescriptor( name="name", @@ -91,7 +144,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -99,6 +152,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="app_engine_http_queue", @@ -117,6 +171,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="rate_limits", @@ -135,6 +190,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="retry_config", @@ -153,6 +209,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="state", @@ -171,6 +228,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="purge_time", @@ -189,6 +247,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="stackdriver_logging_config", @@ -207,14 +266,32 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, + ), + _descriptor.FieldDescriptor( + name="type", + full_name="google.cloud.tasks.v2beta3.Queue.type", + index=7, + number=11, + type=14, + cpp_type=8, + label=1, + has_default_value=False, + default_value=0, + message_type=None, + enum_type=None, + containing_type=None, + is_extension=False, + extension_scope=None, + serialized_options=b"\340A\005", + file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), ], extensions=[], nested_types=[], - enum_types=[_QUEUE_STATE], - serialized_options=_b( - "\352AY\n\037cloudtasks.googleapis.com/Queue\0226projects/{project}/locations/{location}/queues/{queue}" - ), + enum_types=[_QUEUE_STATE, _QUEUE_TYPE,], + serialized_options=b"\352AY\n\037cloudtasks.googleapis.com/Queue\0226projects/{project}/locations/{location}/queues/{queue}", is_extendable=False, syntax="proto3", extension_ranges=[], @@ -224,11 +301,12 @@ full_name="google.cloud.tasks.v2beta3.Queue.queue_type", index=0, containing_type=None, + create_key=_descriptor._internal_create_key, fields=[], - ) + ), ], - serialized_start=246, - serialized_end=845, + serialized_start=279, + serialized_end=987, ) @@ -238,6 +316,7 @@ filename=None, file=DESCRIPTOR, containing_type=None, + create_key=_descriptor._internal_create_key, fields=[ _descriptor.FieldDescriptor( name="max_dispatches_per_second", @@ -256,6 +335,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="max_burst_size", @@ -274,6 +354,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="max_concurrent_dispatches", @@ -292,6 +373,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), ], extensions=[], @@ -302,8 +384,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=847, - serialized_end=953, + serialized_start=989, + serialized_end=1095, ) @@ -313,6 +395,7 @@ filename=None, file=DESCRIPTOR, containing_type=None, + create_key=_descriptor._internal_create_key, fields=[ _descriptor.FieldDescriptor( name="max_attempts", @@ -331,6 +414,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="max_retry_duration", @@ -349,6 +433,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="min_backoff", @@ -367,6 +452,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="max_backoff", @@ -385,6 +471,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="max_doublings", @@ -403,6 +490,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), ], extensions=[], @@ -413,8 +501,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=956, - serialized_end=1165, + serialized_start=1098, + serialized_end=1307, ) @@ -424,6 +512,7 @@ filename=None, file=DESCRIPTOR, containing_type=None, + create_key=_descriptor._internal_create_key, fields=[ _descriptor.FieldDescriptor( name="sampling_ratio", @@ -442,7 +531,8 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, - ) + create_key=_descriptor._internal_create_key, + ), ], extensions=[], nested_types=[], @@ -452,8 +542,8 @@ syntax="proto3", extension_ranges=[], oneofs=[], - serialized_start=1167, - serialized_end=1217, + serialized_start=1309, + serialized_end=1359, ) _QUEUE.fields_by_name[ @@ -470,7 +560,9 @@ _QUEUE.fields_by_name[ "stackdriver_logging_config" ].message_type = _STACKDRIVERLOGGINGCONFIG +_QUEUE.fields_by_name["type"].enum_type = _QUEUE_TYPE _QUEUE_STATE.containing_type = _QUEUE +_QUEUE_TYPE.containing_type = _QUEUE _QUEUE.oneofs_by_name["queue_type"].fields.append( _QUEUE.fields_by_name["app_engine_http_queue"] ) @@ -495,12 +587,13 @@ Queue = _reflection.GeneratedProtocolMessageType( "Queue", (_message.Message,), - dict( - DESCRIPTOR=_QUEUE, - __module__="google.cloud.tasks_v2beta3.proto.queue_pb2", - __doc__="""A queue is a container of related tasks. Queues are configured to + { + "DESCRIPTOR": _QUEUE, + "__module__": "google.cloud.tasks_v2beta3.proto.queue_pb2", + "__doc__": """A queue is a container of related tasks. Queues are configured to manage how those tasks are dispatched. Configurable properties include rate limits, retry options, queue types, and others. + Attributes: name: Caller-specified and required in [CreateQueue][google.cloud.ta @@ -513,7 +606,7 @@ information, see `Identifying projects `_ - ``LOCATION_ID`` - is the canonical ID for the queue's location. The list of + is the canonical ID for the queue’s location. The list of available locations can be obtained by calling [ListLocatio ns][google.cloud.location.Locations.ListLocations]. For more information, see @@ -529,24 +622,25 @@ affected by this proto. rate_limits: Rate limits for task dispatches. - [rate\_limits][google.cloud.tasks.v2beta3.Queue.rate\_limits] - and [retry\_config][google.cloud.tasks.v2beta3.Queue.retry\_co - nfig] are related because they both control task attempts. - However they control task attempts in different ways: - - [rate\_limits][google.cloud.tasks.v2beta3.Queue.rate\_limits] - controls the total rate of dispatches from a queue (i.e. all - traffic dispatched from the queue, regardless of whether - the dispatch is from a first attempt or a retry). - [retry - \_config][google.cloud.tasks.v2beta3.Queue.retry\_config] + [rate_limits][google.cloud.tasks.v2beta3.Queue.rate_limits] + and + [retry_config][google.cloud.tasks.v2beta3.Queue.retry_config] + are related because they both control task attempts. However + they control task attempts in different ways: - + [rate_limits][google.cloud.tasks.v2beta3.Queue.rate_limits] + controls the total rate of dispatches from a queue + (i.e. all traffic dispatched from the queue, regardless of + whether the dispatch is from a first attempt or a retry). - + [retry_config][google.cloud.tasks.v2beta3.Queue.retry_config] controls what happens to particular a task after its first - attempt fails. That is, [retry\_config][google.cloud.tas - ks.v2beta3.Queue.retry\_config] controls task retries (the - second attempt, third attempt, etc). The queue's actual - dispatch rate is the result of: - Number of tasks in the - queue - User-specified throttling: - [rate\_limits][google.cloud.tasks.v2beta3.Queue.rate\_limits], - [retry\_config][google.cloud.tasks.v2beta3.Queue.retry\_config - ], and the [queue's + attempt fails. That is, + [retry_config][google.cloud.tasks.v2beta3.Queue.retry_config] + controls task retries (the second attempt, third attempt, + etc). The queue’s actual dispatch rate is the result of: - + Number of tasks in the queue - User-specified throttling: + [rate_limits][google.cloud.tasks.v2beta3.Queue.rate_limits], + [retry_config][google.cloud.tasks.v2beta3.Queue.retry_config], + and the [queue’s state][google.cloud.tasks.v2beta3.Queue.state]. - System throttling due to ``429`` (Too Many Requests) or ``503`` (Service Unavailable) responses from the worker, high error @@ -573,7 +667,7 @@ purge_time: Output only. The last time this queue was purged. All tasks that were - [created][google.cloud.tasks.v2beta3.Task.create\_time] before + [created][google.cloud.tasks.v2beta3.Task.create_time] before this time were purged. A queue can be purged using [PurgeQueu e][google.cloud.tasks.v2beta3.CloudTasks.PurgeQueue], the `App Engine Task Queue SDK, or the Cloud Console `_. If this field is unset, then no logs are written. + type: + Immutable. The type of a queue (push or pull). ``Queue.type`` + is an immutable property of the queue that is set at the queue + creation time. When left unspecified, the default value of + ``PUSH`` is selected. """, # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta3.Queue) - ), + }, ) _sym_db.RegisterMessage(Queue) RateLimits = _reflection.GeneratedProtocolMessageType( "RateLimits", (_message.Message,), - dict( - DESCRIPTOR=_RATELIMITS, - __module__="google.cloud.tasks_v2beta3.proto.queue_pb2", - __doc__="""Rate limits. This message determines the maximum rate that tasks can + { + "DESCRIPTOR": _RATELIMITS, + "__module__": "google.cloud.tasks_v2beta3.proto.queue_pb2", + "__doc__": """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.v2beta3.CloudTasks.RunTask], will run a task even if the queue has reached its [RateLimits][google.cloud.tasks.v2beta3.RateLimits]. + Attributes: max_dispatches_per_second: The maximum rate at which tasks are dispatched from this @@ -624,24 +724,24 @@ bucket that holds tokens, up to the maximum specified by ``max_burst_size``. Each time a task is dispatched, a token is removed from the bucket. Tasks will be dispatched until the - queue's bucket runs out of tokens. The bucket will be - continuously refilled with new tokens based on [max\_dispatche - s\_per\_second][google.cloud.tasks.v2beta3.RateLimits.max\_dis - patches\_per\_second]. Cloud Tasks will pick the value of - ``max_burst_size`` based on the value of [max\_dispatches\_per - \_second][google.cloud.tasks.v2beta3.RateLimits.max\_dispatche - s\_per\_second]. For App Engine queues that were created or - updated using ``queue.yaml/xml``, ``max_burst_size`` is equal - to `bucket\_size `_. Since + queue’s bucket runs out of tokens. The bucket will be + continuously refilled with new tokens based on [max_dispatches + _per_second][google.cloud.tasks.v2beta3.RateLimits.max_dispatc + hes_per_second]. Cloud Tasks will pick the value of + ``max_burst_size`` based on the value of [max_dispatches_per_s + econd][google.cloud.tasks.v2beta3.RateLimits.max_dispatches_pe + r_second]. For App Engine queues that were created or updated + using ``queue.yaml/xml``, ``max_burst_size`` is equal to + `bucket_size `_. Since ``max_burst_size`` is output only, if [UpdateQueue][google.clo ud.tasks.v2beta3.CloudTasks.UpdateQueue] is called on a queue created by ``queue.yaml/xml``, ``max_burst_size`` will be - reset based on the value of [max\_dispatches\_per\_second][goo - gle.cloud.tasks.v2beta3.RateLimits.max\_dispatches\_per\_secon - d], regardless of whether [max\_dispatches\_per\_second][googl - e.cloud.tasks.v2beta3.RateLimits.max\_dispatches\_per\_second] - is updated. + reset based on the value of [max_dispatches_per_second][google + .cloud.tasks.v2beta3.RateLimits.max_dispatches_per_second], + regardless of whether [max_dispatches_per_second][google.cloud + .tasks.v2beta3.RateLimits.max_dispatches_per_second] is + updated. max_concurrent_dispatches: The maximum number of concurrent tasks that Cloud Tasks allows to be dispatched for this queue. After this threshold has been @@ -649,23 +749,24 @@ of concurrent requests decreases. If unspecified when the queue is created, Cloud Tasks will pick the default. The maximum allowed value is 5,000. This field has the same - meaning as `max\_concurrent\_requests in queue.yaml/xml `_. + meaning as `max_concurrent_requests in queue.yaml/xml `_. """, # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta3.RateLimits) - ), + }, ) _sym_db.RegisterMessage(RateLimits) RetryConfig = _reflection.GeneratedProtocolMessageType( "RetryConfig", (_message.Message,), - dict( - DESCRIPTOR=_RETRYCONFIG, - __module__="google.cloud.tasks_v2beta3.proto.queue_pb2", - __doc__="""Retry config. These settings determine when a failed task attempt is + { + "DESCRIPTOR": _RETRYCONFIG, + "__module__": "google.cloud.tasks_v2beta3.proto.queue_pb2", + "__doc__": """Retry config. These settings determine when a failed task attempt is retried. + Attributes: max_attempts: Number of attempts per task. Cloud Tasks will attempt the @@ -673,87 +774,86 @@ fails, then there will be ``max_attempts - 1`` retries). Must be >= -1. If unspecified when the queue is created, Cloud Tasks will pick the default. -1 indicates unlimited attempts. - This field has the same meaning as `task\_retry\_limit in + This field has the same meaning as `task_retry_limit in queue.yaml/xml `_. max_retry_duration: If positive, ``max_retry_duration`` specifies the time limit for retrying a failed task, measured from when the task was first attempted. Once ``max_retry_duration`` time has passed - *and* the task has been attempted [max\_attempts][google.cloud - .tasks.v2beta3.RetryConfig.max\_attempts] times, no further + *and* the task has been attempted [max_attempts][google.cloud. + tasks.v2beta3.RetryConfig.max_attempts] times, no further attempts will be made and the task will be deleted. If zero, then the task age is unlimited. If unspecified when the queue is created, Cloud Tasks will pick the default. ``max_retry_duration`` will be truncated to the nearest - second. This field has the same meaning as `task\_age\_limit - in queue.yaml/xml `_. + second. This field has the same meaning as `task_age_limit in + queue.yaml/xml `_. min_backoff: A task will be - [scheduled][google.cloud.tasks.v2beta3.Task.schedule\_time] - for retry between [min\_backoff][google.cloud.tasks.v2beta3.Re - tryConfig.min\_backoff] and [max\_backoff][google.cloud.tasks. - v2beta3.RetryConfig.max\_backoff] duration after it fails, if - the queue's - [RetryConfig][google.cloud.tasks.v2beta3.RetryConfig] + [scheduled][google.cloud.tasks.v2beta3.Task.schedule_time] for + retry between [min_backoff][google.cloud.tasks.v2beta3.RetryCo + nfig.min_backoff] and [max_backoff][google.cloud.tasks.v2beta3 + .RetryConfig.max_backoff] duration after it fails, if the + queue’s [RetryConfig][google.cloud.tasks.v2beta3.RetryConfig] specifies that the task should be retried. If unspecified when the queue is created, Cloud Tasks will pick the default. ``min_backoff`` will be truncated to the nearest second. This - field has the same meaning as `min\_backoff\_seconds in + field has the same meaning as `min_backoff_seconds in queue.yaml/xml `_. max_backoff: A task will be - [scheduled][google.cloud.tasks.v2beta3.Task.schedule\_time] - for retry between [min\_backoff][google.cloud.tasks.v2beta3.Re - tryConfig.min\_backoff] and [max\_backoff][google.cloud.tasks. - v2beta3.RetryConfig.max\_backoff] duration after it fails, if - the queue's - [RetryConfig][google.cloud.tasks.v2beta3.RetryConfig] + [scheduled][google.cloud.tasks.v2beta3.Task.schedule_time] for + retry between [min_backoff][google.cloud.tasks.v2beta3.RetryCo + nfig.min_backoff] and [max_backoff][google.cloud.tasks.v2beta3 + .RetryConfig.max_backoff] duration after it fails, if the + queue’s [RetryConfig][google.cloud.tasks.v2beta3.RetryConfig] specifies that the task should be retried. If unspecified when the queue is created, Cloud Tasks will pick the default. ``max_backoff`` will be truncated to the nearest second. This - field has the same meaning as `max\_backoff\_seconds in + field has the same meaning as `max_backoff_seconds in queue.yaml/xml `_. max_doublings: The time between retries will double ``max_doublings`` times. - A task's retry interval starts at [min\_backoff][google.cloud. - tasks.v2beta3.RetryConfig.min\_backoff], then doubles + A task’s retry interval starts at [min_backoff][google.cloud.t + asks.v2beta3.RetryConfig.min_backoff], then doubles ``max_doublings`` times, then increases linearly, and finally - retries retries at intervals of [max\_backoff][google.cloud.ta - sks.v2beta3.RetryConfig.max\_backoff] up to [max\_attempts][go - ogle.cloud.tasks.v2beta3.RetryConfig.max\_attempts] times. - For example, if [min\_backoff][google.cloud.tasks.v2beta3.Retr - yConfig.min\_backoff] is 10s, [max\_backoff][google.cloud.task - s.v2beta3.RetryConfig.max\_backoff] is 300s, and - ``max_doublings`` is 3, then the a task will first be retried - in 10s. The retry interval will double three times, and then - increase linearly by 2^3 \* 10s. Finally, the task will retry - at intervals of [max\_backoff][google.cloud.tasks.v2beta3.Retr - yConfig.max\_backoff] until the task has been attempted [max\_ - attempts][google.cloud.tasks.v2beta3.RetryConfig.max\_attempts - ] times. Thus, the requests will retry at 10s, 20s, 40s, 80s, - 160s, 240s, 300s, 300s, .... If unspecified when the queue is - created, Cloud Tasks will pick the default. This field has - the same meaning as `max\_doublings in queue.yaml/xml `_. + retries at intervals of [max_backoff][google.cloud.tasks.v2bet + a3.RetryConfig.max_backoff] up to [max_attempts][google.cloud. + tasks.v2beta3.RetryConfig.max_attempts] times. For example, + if [min_backoff][google.cloud.tasks.v2beta3.RetryConfig.min_ba + ckoff] is 10s, [max_backoff][google.cloud.tasks.v2beta3.RetryC + onfig.max_backoff] is 300s, and ``max_doublings`` is 3, then + the a task will first be retried in 10s. The retry interval + will double three times, and then increase linearly by 2^3 \* + 10s. Finally, the task will retry at intervals of [max_backoff + ][google.cloud.tasks.v2beta3.RetryConfig.max_backoff] until + the task has been attempted [max_attempts][google.cloud.tasks. + v2beta3.RetryConfig.max_attempts] times. Thus, the requests + will retry at 10s, 20s, 40s, 80s, 160s, 240s, 300s, 300s, …. + If unspecified when the queue is created, Cloud Tasks will + pick the default. This field has the same meaning as + `max_doublings in queue.yaml/xml ` + __. """, # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta3.RetryConfig) - ), + }, ) _sym_db.RegisterMessage(RetryConfig) StackdriverLoggingConfig = _reflection.GeneratedProtocolMessageType( "StackdriverLoggingConfig", (_message.Message,), - dict( - DESCRIPTOR=_STACKDRIVERLOGGINGCONFIG, - __module__="google.cloud.tasks_v2beta3.proto.queue_pb2", - __doc__="""Configuration options for writing logs to `Stackdriver Logging + { + "DESCRIPTOR": _STACKDRIVERLOGGINGCONFIG, + "__module__": "google.cloud.tasks_v2beta3.proto.queue_pb2", + "__doc__": """Configuration options for writing logs to `Stackdriver Logging `_. + Attributes: sampling_ratio: Specifies the fraction of operations to write to `Stackdriver @@ -762,11 +862,12 @@ 0.0 is the default and means that no operations are logged. """, # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta3.StackdriverLoggingConfig) - ), + }, ) _sym_db.RegisterMessage(StackdriverLoggingConfig) DESCRIPTOR._options = None +_QUEUE.fields_by_name["type"]._options = None _QUEUE._options = None # @@protoc_insertion_point(module_scope) diff --git a/google/cloud/tasks_v2beta3/proto/queue_pb2_grpc.py b/google/cloud/tasks_v2beta3/proto/queue_pb2_grpc.py index 07cb78fe..8a939394 100644 --- a/google/cloud/tasks_v2beta3/proto/queue_pb2_grpc.py +++ b/google/cloud/tasks_v2beta3/proto/queue_pb2_grpc.py @@ -1,2 +1,3 @@ # Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT! +"""Client and server classes corresponding to protobuf-defined services.""" import grpc diff --git a/google/cloud/tasks_v2beta3/proto/target.proto b/google/cloud/tasks_v2beta3/proto/target.proto index 60eccf35..cc0c5cfe 100644 --- a/google/cloud/tasks_v2beta3/proto/target.proto +++ b/google/cloud/tasks_v2beta3/proto/target.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -182,10 +181,10 @@ message AppEngineHttpQueue { // delivered to can be set at the queue-level or task-level: // // * If set, -// [app_engine_routing_override][google.cloud.tasks.v2beta3.AppEngineHttpQueue.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][google.cloud.tasks.v2beta3.AppEngineHttpRequest.app_engine_routing]. +// [app_engine_routing_override][google.cloud.tasks.v2beta3.AppEngineHttpQueue.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][google.cloud.tasks.v2beta3.AppEngineHttpRequest.app_engine_routing]. // // // The `url` that the task will be sent to is: @@ -218,14 +217,11 @@ message AppEngineHttpRequest { // The HTTP method to use for the request. The default is POST. // // The app's request handler for the task's target URL must be able to handle - // HTTP requests with this http_method, otherwise the task attempt will fail - // with error code 405 (Method Not Allowed). See - // [Writing a push task request + // HTTP requests with this http_method, otherwise the task attempt fails with + // error code 405 (Method Not Allowed). See [Writing a push task request // handler](https://cloud.google.com/appengine/docs/java/taskqueue/push/creating-handlers#writing_a_push_task_request_handler) - // and the documentation for the request handlers in the language your app is - // written in e.g. - // [Python Request - // Handler](https://cloud.google.com/appengine/docs/python/tools/webapp/requesthandlerclass). + // and the App Engine documentation for your runtime on [How Requests are + // Handled](https://cloud.google.com/appengine/docs/standard/python3/how-requests-are-handled). HttpMethod http_method = 1; // Task-level setting for App Engine routing. diff --git a/google/cloud/tasks_v2beta3/proto/target_pb2.py b/google/cloud/tasks_v2beta3/proto/target_pb2.py index 27530a15..c3df2e3a 100644 --- a/google/cloud/tasks_v2beta3/proto/target_pb2.py +++ b/google/cloud/tasks_v2beta3/proto/target_pb2.py @@ -1,10 +1,7 @@ # -*- coding: utf-8 -*- # Generated by the protocol buffer compiler. DO NOT EDIT! # source: google/cloud/tasks_v2beta3/proto/target.proto - -import sys - -_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1")) +"""Generated protocol buffer code.""" from google.protobuf.internal import enum_type_wrapper from google.protobuf import descriptor as _descriptor from google.protobuf import message as _message @@ -23,13 +20,10 @@ name="google/cloud/tasks_v2beta3/proto/target.proto", package="google.cloud.tasks.v2beta3", syntax="proto3", - serialized_options=_b( - "\n\036com.google.cloud.tasks.v2beta3B\013TargetProtoP\001Z?google.golang.org/genproto/googleapis/cloud/tasks/v2beta3;tasks" - ), - serialized_pb=_b( - '\n-google/cloud/tasks_v2beta3/proto/target.proto\x12\x1agoogle.cloud.tasks.v2beta3\x1a\x1cgoogle/api/annotations.proto"\xf0\x02\n\x0bHttpRequest\x12\x0b\n\x03url\x18\x01 \x01(\t\x12;\n\x0bhttp_method\x18\x02 \x01(\x0e\x32&.google.cloud.tasks.v2beta3.HttpMethod\x12\x45\n\x07headers\x18\x03 \x03(\x0b\x32\x34.google.cloud.tasks.v2beta3.HttpRequest.HeadersEntry\x12\x0c\n\x04\x62ody\x18\x04 \x01(\x0c\x12=\n\x0boauth_token\x18\x05 \x01(\x0b\x32&.google.cloud.tasks.v2beta3.OAuthTokenH\x00\x12;\n\noidc_token\x18\x06 \x01(\x0b\x32%.google.cloud.tasks.v2beta3.OidcTokenH\x00\x1a.\n\x0cHeadersEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\x42\x16\n\x14\x61uthorization_header"g\n\x12\x41ppEngineHttpQueue\x12Q\n\x1b\x61pp_engine_routing_override\x18\x01 \x01(\x0b\x32,.google.cloud.tasks.v2beta3.AppEngineRouting"\xc1\x02\n\x14\x41ppEngineHttpRequest\x12;\n\x0bhttp_method\x18\x01 \x01(\x0e\x32&.google.cloud.tasks.v2beta3.HttpMethod\x12H\n\x12\x61pp_engine_routing\x18\x02 \x01(\x0b\x32,.google.cloud.tasks.v2beta3.AppEngineRouting\x12\x14\n\x0crelative_uri\x18\x03 \x01(\t\x12N\n\x07headers\x18\x04 \x03(\x0b\x32=.google.cloud.tasks.v2beta3.AppEngineHttpRequest.HeadersEntry\x12\x0c\n\x04\x62ody\x18\x05 \x01(\x0c\x1a.\n\x0cHeadersEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01"T\n\x10\x41ppEngineRouting\x12\x0f\n\x07service\x18\x01 \x01(\t\x12\x0f\n\x07version\x18\x02 \x01(\t\x12\x10\n\x08instance\x18\x03 \x01(\t\x12\x0c\n\x04host\x18\x04 \x01(\t":\n\nOAuthToken\x12\x1d\n\x15service_account_email\x18\x01 \x01(\t\x12\r\n\x05scope\x18\x02 \x01(\t"<\n\tOidcToken\x12\x1d\n\x15service_account_email\x18\x01 \x01(\t\x12\x10\n\x08\x61udience\x18\x02 \x01(\t*s\n\nHttpMethod\x12\x1b\n\x17HTTP_METHOD_UNSPECIFIED\x10\x00\x12\x08\n\x04POST\x10\x01\x12\x07\n\x03GET\x10\x02\x12\x08\n\x04HEAD\x10\x03\x12\x07\n\x03PUT\x10\x04\x12\n\n\x06\x44\x45LETE\x10\x05\x12\t\n\x05PATCH\x10\x06\x12\x0b\n\x07OPTIONS\x10\x07\x42p\n\x1e\x63om.google.cloud.tasks.v2beta3B\x0bTargetProtoP\x01Z?google.golang.org/genproto/googleapis/cloud/tasks/v2beta3;tasksb\x06proto3' - ), - dependencies=[google_dot_api_dot_annotations__pb2.DESCRIPTOR], + serialized_options=b"\n\036com.google.cloud.tasks.v2beta3B\013TargetProtoP\001Z?google.golang.org/genproto/googleapis/cloud/tasks/v2beta3;tasks", + create_key=_descriptor._internal_create_key, + serialized_pb=b'\n-google/cloud/tasks_v2beta3/proto/target.proto\x12\x1agoogle.cloud.tasks.v2beta3\x1a\x1cgoogle/api/annotations.proto"\xf0\x02\n\x0bHttpRequest\x12\x0b\n\x03url\x18\x01 \x01(\t\x12;\n\x0bhttp_method\x18\x02 \x01(\x0e\x32&.google.cloud.tasks.v2beta3.HttpMethod\x12\x45\n\x07headers\x18\x03 \x03(\x0b\x32\x34.google.cloud.tasks.v2beta3.HttpRequest.HeadersEntry\x12\x0c\n\x04\x62ody\x18\x04 \x01(\x0c\x12=\n\x0boauth_token\x18\x05 \x01(\x0b\x32&.google.cloud.tasks.v2beta3.OAuthTokenH\x00\x12;\n\noidc_token\x18\x06 \x01(\x0b\x32%.google.cloud.tasks.v2beta3.OidcTokenH\x00\x1a.\n\x0cHeadersEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\x42\x16\n\x14\x61uthorization_header"g\n\x12\x41ppEngineHttpQueue\x12Q\n\x1b\x61pp_engine_routing_override\x18\x01 \x01(\x0b\x32,.google.cloud.tasks.v2beta3.AppEngineRouting"\xc1\x02\n\x14\x41ppEngineHttpRequest\x12;\n\x0bhttp_method\x18\x01 \x01(\x0e\x32&.google.cloud.tasks.v2beta3.HttpMethod\x12H\n\x12\x61pp_engine_routing\x18\x02 \x01(\x0b\x32,.google.cloud.tasks.v2beta3.AppEngineRouting\x12\x14\n\x0crelative_uri\x18\x03 \x01(\t\x12N\n\x07headers\x18\x04 \x03(\x0b\x32=.google.cloud.tasks.v2beta3.AppEngineHttpRequest.HeadersEntry\x12\x0c\n\x04\x62ody\x18\x05 \x01(\x0c\x1a.\n\x0cHeadersEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01"T\n\x10\x41ppEngineRouting\x12\x0f\n\x07service\x18\x01 \x01(\t\x12\x0f\n\x07version\x18\x02 \x01(\t\x12\x10\n\x08instance\x18\x03 \x01(\t\x12\x0c\n\x04host\x18\x04 \x01(\t":\n\nOAuthToken\x12\x1d\n\x15service_account_email\x18\x01 \x01(\t\x12\r\n\x05scope\x18\x02 \x01(\t"<\n\tOidcToken\x12\x1d\n\x15service_account_email\x18\x01 \x01(\t\x12\x10\n\x08\x61udience\x18\x02 \x01(\t*s\n\nHttpMethod\x12\x1b\n\x17HTTP_METHOD_UNSPECIFIED\x10\x00\x12\x08\n\x04POST\x10\x01\x12\x07\n\x03GET\x10\x02\x12\x08\n\x04HEAD\x10\x03\x12\x07\n\x03PUT\x10\x04\x12\n\n\x06\x44\x45LETE\x10\x05\x12\t\n\x05PATCH\x10\x06\x12\x0b\n\x07OPTIONS\x10\x07\x42p\n\x1e\x63om.google.cloud.tasks.v2beta3B\x0bTargetProtoP\x01Z?google.golang.org/genproto/googleapis/cloud/tasks/v2beta3;tasksb\x06proto3', + dependencies=[google_dot_api_dot_annotations__pb2.DESCRIPTOR,], ) _HTTPMETHOD = _descriptor.EnumDescriptor( @@ -37,6 +31,7 @@ full_name="google.cloud.tasks.v2beta3.HttpMethod", filename=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, values=[ _descriptor.EnumValueDescriptor( name="HTTP_METHOD_UNSPECIFIED", @@ -44,27 +39,63 @@ number=0, serialized_options=None, type=None, + create_key=_descriptor._internal_create_key, ), _descriptor.EnumValueDescriptor( - name="POST", index=1, number=1, serialized_options=None, type=None + name="POST", + index=1, + number=1, + serialized_options=None, + type=None, + create_key=_descriptor._internal_create_key, ), _descriptor.EnumValueDescriptor( - name="GET", index=2, number=2, serialized_options=None, type=None + name="GET", + index=2, + number=2, + serialized_options=None, + type=None, + create_key=_descriptor._internal_create_key, ), _descriptor.EnumValueDescriptor( - name="HEAD", index=3, number=3, serialized_options=None, type=None + name="HEAD", + index=3, + number=3, + serialized_options=None, + type=None, + create_key=_descriptor._internal_create_key, ), _descriptor.EnumValueDescriptor( - name="PUT", index=4, number=4, serialized_options=None, type=None + name="PUT", + index=4, + number=4, + serialized_options=None, + type=None, + create_key=_descriptor._internal_create_key, ), _descriptor.EnumValueDescriptor( - name="DELETE", index=5, number=5, serialized_options=None, type=None + name="DELETE", + index=5, + number=5, + serialized_options=None, + type=None, + create_key=_descriptor._internal_create_key, ), _descriptor.EnumValueDescriptor( - name="PATCH", index=6, number=6, serialized_options=None, type=None + name="PATCH", + index=6, + number=6, + serialized_options=None, + type=None, + create_key=_descriptor._internal_create_key, ), _descriptor.EnumValueDescriptor( - name="OPTIONS", index=7, number=7, serialized_options=None, type=None + name="OPTIONS", + index=7, + number=7, + serialized_options=None, + type=None, + create_key=_descriptor._internal_create_key, ), ], containing_type=None, @@ -91,6 +122,7 @@ filename=None, file=DESCRIPTOR, containing_type=None, + create_key=_descriptor._internal_create_key, fields=[ _descriptor.FieldDescriptor( name="key", @@ -101,7 +133,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -109,6 +141,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="value", @@ -119,7 +152,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -127,12 +160,13 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), ], extensions=[], nested_types=[], enum_types=[], - serialized_options=_b("8\001"), + serialized_options=b"8\001", is_extendable=False, syntax="proto3", extension_ranges=[], @@ -147,6 +181,7 @@ filename=None, file=DESCRIPTOR, containing_type=None, + create_key=_descriptor._internal_create_key, fields=[ _descriptor.FieldDescriptor( name="url", @@ -157,7 +192,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -165,6 +200,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="http_method", @@ -183,6 +219,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="headers", @@ -201,6 +238,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="body", @@ -211,7 +249,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b(""), + default_value=b"", message_type=None, enum_type=None, containing_type=None, @@ -219,6 +257,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="oauth_token", @@ -237,6 +276,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="oidc_token", @@ -255,10 +295,11 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), ], extensions=[], - nested_types=[_HTTPREQUEST_HEADERSENTRY], + nested_types=[_HTTPREQUEST_HEADERSENTRY,], enum_types=[], serialized_options=None, is_extendable=False, @@ -270,8 +311,9 @@ full_name="google.cloud.tasks.v2beta3.HttpRequest.authorization_header", index=0, containing_type=None, + create_key=_descriptor._internal_create_key, fields=[], - ) + ), ], serialized_start=108, serialized_end=476, @@ -284,6 +326,7 @@ filename=None, file=DESCRIPTOR, containing_type=None, + create_key=_descriptor._internal_create_key, fields=[ _descriptor.FieldDescriptor( name="app_engine_routing_override", @@ -302,7 +345,8 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, - ) + create_key=_descriptor._internal_create_key, + ), ], extensions=[], nested_types=[], @@ -323,6 +367,7 @@ filename=None, file=DESCRIPTOR, containing_type=None, + create_key=_descriptor._internal_create_key, fields=[ _descriptor.FieldDescriptor( name="key", @@ -333,7 +378,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -341,6 +386,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="value", @@ -351,7 +397,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -359,12 +405,13 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), ], extensions=[], nested_types=[], enum_types=[], - serialized_options=_b("8\001"), + serialized_options=b"8\001", is_extendable=False, syntax="proto3", extension_ranges=[], @@ -379,6 +426,7 @@ filename=None, file=DESCRIPTOR, containing_type=None, + create_key=_descriptor._internal_create_key, fields=[ _descriptor.FieldDescriptor( name="http_method", @@ -397,6 +445,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="app_engine_routing", @@ -415,6 +464,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="relative_uri", @@ -425,7 +475,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -433,6 +483,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="headers", @@ -451,6 +502,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="body", @@ -461,7 +513,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b(""), + default_value=b"", message_type=None, enum_type=None, containing_type=None, @@ -469,10 +521,11 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), ], extensions=[], - nested_types=[_APPENGINEHTTPREQUEST_HEADERSENTRY], + nested_types=[_APPENGINEHTTPREQUEST_HEADERSENTRY,], enum_types=[], serialized_options=None, is_extendable=False, @@ -490,6 +543,7 @@ filename=None, file=DESCRIPTOR, containing_type=None, + create_key=_descriptor._internal_create_key, fields=[ _descriptor.FieldDescriptor( name="service", @@ -500,7 +554,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -508,6 +562,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="version", @@ -518,7 +573,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -526,6 +581,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="instance", @@ -536,7 +592,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -544,6 +600,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="host", @@ -554,7 +611,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -562,6 +619,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), ], extensions=[], @@ -583,6 +641,7 @@ filename=None, file=DESCRIPTOR, containing_type=None, + create_key=_descriptor._internal_create_key, fields=[ _descriptor.FieldDescriptor( name="service_account_email", @@ -593,7 +652,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -601,6 +660,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="scope", @@ -611,7 +671,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -619,6 +679,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), ], extensions=[], @@ -640,6 +701,7 @@ filename=None, file=DESCRIPTOR, containing_type=None, + create_key=_descriptor._internal_create_key, fields=[ _descriptor.FieldDescriptor( name="service_account_email", @@ -650,7 +712,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -658,6 +720,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="audience", @@ -668,7 +731,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -676,6 +739,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), ], extensions=[], @@ -730,32 +794,32 @@ HttpRequest = _reflection.GeneratedProtocolMessageType( "HttpRequest", (_message.Message,), - dict( - HeadersEntry=_reflection.GeneratedProtocolMessageType( + { + "HeadersEntry": _reflection.GeneratedProtocolMessageType( "HeadersEntry", (_message.Message,), - dict( - DESCRIPTOR=_HTTPREQUEST_HEADERSENTRY, - __module__="google.cloud.tasks_v2beta3.proto.target_pb2" + { + "DESCRIPTOR": _HTTPREQUEST_HEADERSENTRY, + "__module__": "google.cloud.tasks_v2beta3.proto.target_pb2" # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta3.HttpRequest.HeadersEntry) - ), + }, ), - DESCRIPTOR=_HTTPREQUEST, - __module__="google.cloud.tasks_v2beta3.proto.target_pb2", - __doc__="""HTTP request. The task will be pushed to the worker as an HTTP + "DESCRIPTOR": _HTTPREQUEST, + "__module__": "google.cloud.tasks_v2beta3.proto.target_pb2", + "__doc__": """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.v2beta3.Queue.retry\_config], [rate - limits][google.cloud.tasks.v2beta3.Queue.rate\_limits], and the - [queue's state][google.cloud.tasks.v2beta3.Queue.state]. - System + configuration][google.cloud.tasks.v2beta3.Queue.retry_config], [rate + limits][google.cloud.tasks.v2beta3.Queue.rate_limits], and the + [queue’s state][google.cloud.tasks.v2beta3.Queue.state]. - System throttling: To prevent the worker from overloading, Cloud Tasks may - temporarily reduce the queue's effective rate. User-specified + 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.v2beta3.Queue.rate\_limits] will + in [rate limits][google.cloud.tasks.v2beta3.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 @@ -765,10 +829,11 @@ 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). + Attributes: url: Required. The full url path that the request will be sent to. - This string must begin with either "http://" or "https://". + This string must begin with either “http://” or “https://”. Some examples are: ``http://acme.com`` and ``https://acme.com/sales:8080``. Cloud Tasks will encode some characters for safety and compatibility. The maximum allowed @@ -783,15 +848,15 @@ names and values. Headers can be set when the [task is created][google.cloud.tasks.v2beta3.CloudTasks.CreateTask]. These headers represent a subset of the headers that will - accompany the task's HTTP request. Some HTTP request headers + accompany the task’s HTTP request. Some HTTP request headers will be ignored or replaced. A partial list of headers that will be ignored or replaced is: - Host: This will be computed by Cloud Tasks and derived from [HttpRequest.url][google.cloud.tasks.v2beta3.HttpRequest.url]. - Content-Length: This will be computed by Cloud Tasks. - User-Agent: This will be set to ``"Google-Cloud-Tasks"``. - - X-Google-\*: Google use only. - X-AppEngine-\*: Google use - only. ``Content-Type`` won't be set by Cloud Tasks. You can + X-Google-*: Google use only. - X-AppEngine-*: Google use + only. ``Content-Type`` won’t be set by Cloud Tasks. You can explicitly set ``Content-Type`` to a media type when the [task is created][google.cloud.tasks.v2beta3.CloudTasks.CreateTask]. For example, ``Content-Type`` can be set to @@ -802,9 +867,9 @@ body: HTTP request body. A request body is allowed only if the [HTTP - method][google.cloud.tasks.v2beta3.HttpRequest.http\_method] - is POST, PUT, or PATCH. It is an error to set body on a task - with an incompatible + method][google.cloud.tasks.v2beta3.HttpRequest.http_method] is + POST, PUT, or PATCH. It is an error to set body on a task with + an incompatible [HttpMethod][google.cloud.tasks.v2beta3.HttpMethod]. authorization_header: The mode for generating an ``Authorization`` header for HTTP @@ -813,7 +878,7 @@ eaders] field will be overridden. oauth_token: If specified, an `OAuth token - `_ + `\_ will be generated and attached as an ``Authorization`` header in the HTTP request. This type of authorization should generally only be used when calling Google APIs hosted on @@ -827,7 +892,7 @@ validate the token yourself. """, # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta3.HttpRequest) - ), + }, ) _sym_db.RegisterMessage(HttpRequest) _sym_db.RegisterMessage(HttpRequest.HeadersEntry) @@ -835,55 +900,56 @@ AppEngineHttpQueue = _reflection.GeneratedProtocolMessageType( "AppEngineHttpQueue", (_message.Message,), - dict( - DESCRIPTOR=_APPENGINEHTTPQUEUE, - __module__="google.cloud.tasks_v2beta3.proto.target_pb2", - __doc__="""App Engine HTTP queue. The task will be delivered to the App Engine + { + "DESCRIPTOR": _APPENGINEHTTPQUEUE, + "__module__": "google.cloud.tasks_v2beta3.proto.target_pb2", + "__doc__": """App Engine HTTP queue. The task will be delivered to the App Engine application hostname specified by its [AppEngineHttpQueue][google.cloud.tasks.v2beta3.AppEngineHttpQueue] and [AppEngineHttpRequest][google.cloud.tasks.v2beta3.AppEngineHttpReq uest]. The documentation for [AppEngineHttpRequest][google.cloud.tasks - .v2beta3.AppEngineHttpRequest] explains how the task's host URL is + .v2beta3.AppEngineHttpRequest] explains how the task’s host URL is constructed. Using [AppEngineHttpQueue][google.cloud.tasks.v2beta3.AppEngineHttpQueue] requires ```appengine.applications.get`` - `_ + `\_ Google IAM permission for the project and the following scope: ``https://www.googleapis.com/auth/cloud-platform`` + Attributes: app_engine_routing_override: - Overrides for the [task-level app\_engine\_routing][google.clo - ud.tasks.v2beta3.AppEngineHttpRequest.app\_engine\_routing]. - 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][google.cloud.tasks.v2beta3.AppEngi - neHttpRequest.app\_engine\_routing]. + Overrides for the [task-level app_engine_routing][google.cloud + .tasks.v2beta3.AppEngineHttpRequest.app_engine_routing]. If + set, ``app_engine_routing_override`` is used for all tasks in + the queue, no matter what the setting is for the [task-level a + pp_engine_routing][google.cloud.tasks.v2beta3.AppEngineHttpReq + uest.app_engine_routing]. """, # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta3.AppEngineHttpQueue) - ), + }, ) _sym_db.RegisterMessage(AppEngineHttpQueue) AppEngineHttpRequest = _reflection.GeneratedProtocolMessageType( "AppEngineHttpRequest", (_message.Message,), - dict( - HeadersEntry=_reflection.GeneratedProtocolMessageType( + { + "HeadersEntry": _reflection.GeneratedProtocolMessageType( "HeadersEntry", (_message.Message,), - dict( - DESCRIPTOR=_APPENGINEHTTPREQUEST_HEADERSENTRY, - __module__="google.cloud.tasks_v2beta3.proto.target_pb2" + { + "DESCRIPTOR": _APPENGINEHTTPREQUEST_HEADERSENTRY, + "__module__": "google.cloud.tasks_v2beta3.proto.target_pb2" # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta3.AppEngineHttpRequest.HeadersEntry) - ), + }, ), - DESCRIPTOR=_APPENGINEHTTPREQUEST, - __module__="google.cloud.tasks_v2beta3.proto.target_pb2", - __doc__="""App Engine HTTP request. The message defines the HTTP request that is + "DESCRIPTOR": _APPENGINEHTTPREQUEST, + "__module__": "google.cloud.tasks_v2beta3.proto.target_pb2", + "__doc__": """App Engine HTTP request. The message defines the HTTP request that is sent to an App Engine app when the task is dispatched. Using [AppEngi neHttpRequest][google.cloud.tasks.v2beta3.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 @@ -898,58 +964,59 @@ will appear to have used the HTTP protocol. The [AppEngineRouting][google.cloud.tasks.v2beta3.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\_overr - ide][google.cloud.tasks.v2beta3.AppEngineHttpQueue.app\_engine\_routin - g\_override] is used for all tasks in the queue, no matter what the - setting is for the [task-level app\_engine\_routing][google.clou - d.tasks.v2beta3.AppEngineHttpRequest.app\_engine\_routing]. The - ``url`` that the task will be sent to is: - ``url =`` + queue-level or task-level: - If set, [app_engine_routing_override + ][google.cloud.tasks.v2beta3.AppEngineHttpQueue.app_engine_routing_ove + rride] is used for all tasks in the queue, no matter what the + setting is for the [task-level app_engine_routing][google.cloud. + tasks.v2beta3.AppEngineHttpRequest.app_engine_routing]. The ``url`` + that the task will be sent to is: - ``url =`` [host][google.cloud.tasks.v2beta3.AppEngineRouting.host] ``+`` [ - relative\_uri][google.cloud.tasks.v2beta3.AppEngineHttpRequest.relativ - e\_uri] Tasks can be dispatched to secure app handlers, unsecure app + relative_uri][google.cloud.tasks.v2beta3.AppEngineHttpRequest.relative + _uri] 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 + 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 + ``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.v2beta3.Task.dispatch\_deadline]. + the [deadline][google.cloud.tasks.v2beta3.Task.dispatch_deadline]. Failed tasks will be retried according to the [retry - configuration][google.cloud.tasks.v2beta3.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. + configuration][google.cloud.tasks.v2beta3.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. + Attributes: http_method: The HTTP method to use for the request. The default is POST. - The app's request handler for the task's target URL must be - able to handle HTTP requests with this http\_method, otherwise - the task attempt will fail with error code 405 (Method Not + The app’s request handler for the task’s target URL must be + able to handle HTTP requests with this http_method, otherwise + the task attempt fails with error code 405 (Method Not Allowed). See `Writing a push task request handler `_ and the - documentation for the request handlers in the language your - app is written in e.g. `Python Request Handler `_. + handlers#writing_a_push_task_request_handler>`_ and the App + Engine documentation for your runtime on `How Requests are + Handled + `_. app_engine_routing: - Task-level setting for App Engine routing. If set, [app\_engi - ne\_routing\_override][google.cloud.tasks.v2beta3.AppEngineHtt - pQueue.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][google.cloud.tasks.v2beta3.AppEngi - neHttpRequest.app\_engine\_routing]. + Task-level setting for App Engine routing. If set, [app_engin + e_routing_override][google.cloud.tasks.v2beta3.AppEngineHttpQu + eue.app_engine_routing_override] is used for all tasks in the + queue, no matter what the setting is for the [task-level app_e + ngine_routing][google.cloud.tasks.v2beta3.AppEngineHttpRequest + .app_engine_routing]. relative_uri: - The relative URI. The relative URI must begin with "/" and + The relative URI. The relative URI must begin with “/” and must be a valid HTTP relative URI. It can contain a path and query string arguments. If the relative URI is empty, then the - root path "/" will be used. No spaces are allowed, and the + root path “/” will be used. No spaces are allowed, and the maximum length allowed is 2083 characters. headers: HTTP request headers. This map contains the header field @@ -994,7 +1061,7 @@ [HttpMethod][google.cloud.tasks.v2beta3.HttpMethod]. """, # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta3.AppEngineHttpRequest) - ), + }, ) _sym_db.RegisterMessage(AppEngineHttpRequest) _sym_db.RegisterMessage(AppEngineHttpRequest.HeadersEntry) @@ -1002,10 +1069,10 @@ AppEngineRouting = _reflection.GeneratedProtocolMessageType( "AppEngineRouting", (_message.Message,), - dict( - DESCRIPTOR=_APPENGINEROUTING, - __module__="google.cloud.tasks_v2beta3.proto.target_pb2", - __doc__="""App Engine Routing. Defines routing characteristics specific to App + { + "DESCRIPTOR": _APPENGINEROUTING, + "__module__": "google.cloud.tasks_v2beta3.proto.target_pb2", + "__doc__": """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 `_, and `App Engine Flex request routing `_. + Attributes: service: App service. By default, the task is sent to the service @@ -1067,7 +1135,7 @@ host: Output only. The host that the task is sent to. The host is constructed from the domain name of the app associated with - the queue's project ID (for example .appspot.com), and the [se + the queue’s project ID (for example .appspot.com), and the [se rvice][google.cloud.tasks.v2beta3.AppEngineRouting.service], [ version][google.cloud.tasks.v2beta3.AppEngineRouting.version], and [instance][google.cloud.tasks.v2beta3.AppEngineRouting.ins @@ -1078,20 +1146,21 @@ requests-are-routed>`_. """, # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta3.AppEngineRouting) - ), + }, ) _sym_db.RegisterMessage(AppEngineRouting) OAuthToken = _reflection.GeneratedProtocolMessageType( "OAuthToken", (_message.Message,), - dict( - DESCRIPTOR=_OAUTHTOKEN, - __module__="google.cloud.tasks_v2beta3.proto.target_pb2", - __doc__="""Contains information needed for generating an `OAuth token + { + "DESCRIPTOR": _OAUTHTOKEN, + "__module__": "google.cloud.tasks_v2beta3.proto.target_pb2", + "__doc__": """Contains information needed for generating an `OAuth token `_. This type of authorization should generally only be used when calling Google APIs hosted on \*.googleapis.com. + Attributes: service_account_email: \ `Service account email @@ -1101,25 +1170,26 @@ iam.serviceAccounts.actAs permission for the service account. scope: OAuth scope to be used for generating OAuth access token. If - not specified, "https://www.googleapis.com/auth/cloud- - platform" will be used. + not specified, “https://www.googleapis.com/auth/cloud- + platform” will be used. """, # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta3.OAuthToken) - ), + }, ) _sym_db.RegisterMessage(OAuthToken) OidcToken = _reflection.GeneratedProtocolMessageType( "OidcToken", (_message.Message,), - dict( - DESCRIPTOR=_OIDCTOKEN, - __module__="google.cloud.tasks_v2beta3.proto.target_pb2", - __doc__="""Contains information needed for generating an `OpenID Connect token + { + "DESCRIPTOR": _OIDCTOKEN, + "__module__": "google.cloud.tasks_v2beta3.proto.target_pb2", + "__doc__": """Contains information needed for generating an `OpenID Connect token `_. This type of authorization can be used for many scenarios, including calling Cloud Run, or endpoints where you intend to validate the token yourself. + Attributes: service_account_email: \ `Service account email @@ -1132,7 +1202,7 @@ specified, the URI specified in target will be used. """, # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta3.OidcToken) - ), + }, ) _sym_db.RegisterMessage(OidcToken) diff --git a/google/cloud/tasks_v2beta3/proto/target_pb2_grpc.py b/google/cloud/tasks_v2beta3/proto/target_pb2_grpc.py index 07cb78fe..8a939394 100644 --- a/google/cloud/tasks_v2beta3/proto/target_pb2_grpc.py +++ b/google/cloud/tasks_v2beta3/proto/target_pb2_grpc.py @@ -1,2 +1,3 @@ # Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT! +"""Client and server classes corresponding to protobuf-defined services.""" import grpc diff --git a/google/cloud/tasks_v2beta3/proto/task.proto b/google/cloud/tasks_v2beta3/proto/task.proto index 573cc850..96d552e0 100644 --- a/google/cloud/tasks_v2beta3/proto/task.proto +++ b/google/cloud/tasks_v2beta3/proto/task.proto @@ -1,4 +1,4 @@ -// Copyright 2019 Google LLC. +// Copyright 2020 Google LLC // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. @@ -11,7 +11,6 @@ // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. -// syntax = "proto3"; @@ -117,8 +116,8 @@ message Task { // is marked as a `DEADLINE_EXCEEDED` failure. Cloud Tasks will retry the // task according to the [RetryConfig][google.cloud.tasks.v2beta3.RetryConfig]. // - // Note that when the request is cancelled, Cloud Tasks will stop listing for - // the response, but whether the worker stops processing depends on the + // Note that when the request is cancelled, Cloud Tasks will stop listening + // for the response, but whether the worker stops processing depends on the // worker. For example, if the worker is stuck, it may not react to cancelled // requests. // diff --git a/google/cloud/tasks_v2beta3/proto/task_pb2.py b/google/cloud/tasks_v2beta3/proto/task_pb2.py index 96a27bfb..047bf30b 100644 --- a/google/cloud/tasks_v2beta3/proto/task_pb2.py +++ b/google/cloud/tasks_v2beta3/proto/task_pb2.py @@ -1,10 +1,7 @@ # -*- coding: utf-8 -*- # Generated by the protocol buffer compiler. DO NOT EDIT! # source: google/cloud/tasks_v2beta3/proto/task.proto - -import sys - -_b = sys.version_info[0] < 3 and (lambda x: x) or (lambda x: x.encode("latin1")) +"""Generated protocol buffer code.""" from google.protobuf import descriptor as _descriptor from google.protobuf import message as _message from google.protobuf import reflection as _reflection @@ -29,12 +26,9 @@ name="google/cloud/tasks_v2beta3/proto/task.proto", package="google.cloud.tasks.v2beta3", syntax="proto3", - serialized_options=_b( - "\n\036com.google.cloud.tasks.v2beta3B\tTaskProtoP\001Z?google.golang.org/genproto/googleapis/cloud/tasks/v2beta3;tasks" - ), - serialized_pb=_b( - '\n+google/cloud/tasks_v2beta3/proto/task.proto\x12\x1agoogle.cloud.tasks.v2beta3\x1a\x19google/api/resource.proto\x1a-google/cloud/tasks_v2beta3/proto/target.proto\x1a\x1egoogle/protobuf/duration.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x17google/rpc/status.proto\x1a\x1cgoogle/api/annotations.proto"\xcd\x05\n\x04Task\x12\x0c\n\x04name\x18\x01 \x01(\t\x12S\n\x17\x61pp_engine_http_request\x18\x03 \x01(\x0b\x32\x30.google.cloud.tasks.v2beta3.AppEngineHttpRequestH\x00\x12?\n\x0chttp_request\x18\x0b \x01(\x0b\x32\'.google.cloud.tasks.v2beta3.HttpRequestH\x00\x12\x31\n\rschedule_time\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12/\n\x0b\x63reate_time\x18\x05 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x34\n\x11\x64ispatch_deadline\x18\x0c \x01(\x0b\x32\x19.google.protobuf.Duration\x12\x16\n\x0e\x64ispatch_count\x18\x06 \x01(\x05\x12\x16\n\x0eresponse_count\x18\x07 \x01(\x05\x12:\n\rfirst_attempt\x18\x08 \x01(\x0b\x32#.google.cloud.tasks.v2beta3.Attempt\x12\x39\n\x0clast_attempt\x18\t \x01(\x0b\x32#.google.cloud.tasks.v2beta3.Attempt\x12\x33\n\x04view\x18\n \x01(\x0e\x32%.google.cloud.tasks.v2beta3.Task.View"1\n\x04View\x12\x14\n\x10VIEW_UNSPECIFIED\x10\x00\x12\t\n\x05\x42\x41SIC\x10\x01\x12\x08\n\x04\x46ULL\x10\x02:h\xea\x41\x65\n\x1e\x63loudtasks.googleapis.com/Task\x12\x43projects/{project}/locations/{location}/queues/{queue}/tasks/{task}B\x0e\n\x0cpayload_type"\xcf\x01\n\x07\x41ttempt\x12\x31\n\rschedule_time\x18\x01 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x31\n\rdispatch_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x31\n\rresponse_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12+\n\x0fresponse_status\x18\x04 \x01(\x0b\x32\x12.google.rpc.StatusBn\n\x1e\x63om.google.cloud.tasks.v2beta3B\tTaskProtoP\x01Z?google.golang.org/genproto/googleapis/cloud/tasks/v2beta3;tasksb\x06proto3' - ), + serialized_options=b"\n\036com.google.cloud.tasks.v2beta3B\tTaskProtoP\001Z?google.golang.org/genproto/googleapis/cloud/tasks/v2beta3;tasks", + create_key=_descriptor._internal_create_key, + serialized_pb=b'\n+google/cloud/tasks_v2beta3/proto/task.proto\x12\x1agoogle.cloud.tasks.v2beta3\x1a\x19google/api/resource.proto\x1a-google/cloud/tasks_v2beta3/proto/target.proto\x1a\x1egoogle/protobuf/duration.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x17google/rpc/status.proto\x1a\x1cgoogle/api/annotations.proto"\xcd\x05\n\x04Task\x12\x0c\n\x04name\x18\x01 \x01(\t\x12S\n\x17\x61pp_engine_http_request\x18\x03 \x01(\x0b\x32\x30.google.cloud.tasks.v2beta3.AppEngineHttpRequestH\x00\x12?\n\x0chttp_request\x18\x0b \x01(\x0b\x32\'.google.cloud.tasks.v2beta3.HttpRequestH\x00\x12\x31\n\rschedule_time\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12/\n\x0b\x63reate_time\x18\x05 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x34\n\x11\x64ispatch_deadline\x18\x0c \x01(\x0b\x32\x19.google.protobuf.Duration\x12\x16\n\x0e\x64ispatch_count\x18\x06 \x01(\x05\x12\x16\n\x0eresponse_count\x18\x07 \x01(\x05\x12:\n\rfirst_attempt\x18\x08 \x01(\x0b\x32#.google.cloud.tasks.v2beta3.Attempt\x12\x39\n\x0clast_attempt\x18\t \x01(\x0b\x32#.google.cloud.tasks.v2beta3.Attempt\x12\x33\n\x04view\x18\n \x01(\x0e\x32%.google.cloud.tasks.v2beta3.Task.View"1\n\x04View\x12\x14\n\x10VIEW_UNSPECIFIED\x10\x00\x12\t\n\x05\x42\x41SIC\x10\x01\x12\x08\n\x04\x46ULL\x10\x02:h\xea\x41\x65\n\x1e\x63loudtasks.googleapis.com/Task\x12\x43projects/{project}/locations/{location}/queues/{queue}/tasks/{task}B\x0e\n\x0cpayload_type"\xcf\x01\n\x07\x41ttempt\x12\x31\n\rschedule_time\x18\x01 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x31\n\rdispatch_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x31\n\rresponse_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12+\n\x0fresponse_status\x18\x04 \x01(\x0b\x32\x12.google.rpc.StatusBn\n\x1e\x63om.google.cloud.tasks.v2beta3B\tTaskProtoP\x01Z?google.golang.org/genproto/googleapis/cloud/tasks/v2beta3;tasksb\x06proto3', dependencies=[ google_dot_api_dot_resource__pb2.DESCRIPTOR, google_dot_cloud_dot_tasks__v2beta3_dot_proto_dot_target__pb2.DESCRIPTOR, @@ -51,6 +45,7 @@ full_name="google.cloud.tasks.v2beta3.Task.View", filename=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, values=[ _descriptor.EnumValueDescriptor( name="VIEW_UNSPECIFIED", @@ -58,12 +53,23 @@ number=0, serialized_options=None, type=None, + create_key=_descriptor._internal_create_key, ), _descriptor.EnumValueDescriptor( - name="BASIC", index=1, number=1, serialized_options=None, type=None + name="BASIC", + index=1, + number=1, + serialized_options=None, + type=None, + create_key=_descriptor._internal_create_key, ), _descriptor.EnumValueDescriptor( - name="FULL", index=2, number=2, serialized_options=None, type=None + name="FULL", + index=2, + number=2, + serialized_options=None, + type=None, + create_key=_descriptor._internal_create_key, ), ], containing_type=None, @@ -80,6 +86,7 @@ filename=None, file=DESCRIPTOR, containing_type=None, + create_key=_descriptor._internal_create_key, fields=[ _descriptor.FieldDescriptor( name="name", @@ -90,7 +97,7 @@ cpp_type=9, label=1, has_default_value=False, - default_value=_b("").decode("utf-8"), + default_value=b"".decode("utf-8"), message_type=None, enum_type=None, containing_type=None, @@ -98,6 +105,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="app_engine_http_request", @@ -116,6 +124,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="http_request", @@ -134,6 +143,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="schedule_time", @@ -152,6 +162,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="create_time", @@ -170,6 +181,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="dispatch_deadline", @@ -188,6 +200,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="dispatch_count", @@ -206,6 +219,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="response_count", @@ -224,6 +238,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="first_attempt", @@ -242,6 +257,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="last_attempt", @@ -260,6 +276,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="view", @@ -278,14 +295,13 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), ], extensions=[], nested_types=[], - enum_types=[_TASK_VIEW], - serialized_options=_b( - "\352Ae\n\036cloudtasks.googleapis.com/Task\022Cprojects/{project}/locations/{location}/queues/{queue}/tasks/{task}" - ), + enum_types=[_TASK_VIEW,], + serialized_options=b"\352Ae\n\036cloudtasks.googleapis.com/Task\022Cprojects/{project}/locations/{location}/queues/{queue}/tasks/{task}", is_extendable=False, syntax="proto3", extension_ranges=[], @@ -295,8 +311,9 @@ full_name="google.cloud.tasks.v2beta3.Task.payload_type", index=0, containing_type=None, + create_key=_descriptor._internal_create_key, fields=[], - ) + ), ], serialized_start=270, serialized_end=987, @@ -309,6 +326,7 @@ filename=None, file=DESCRIPTOR, containing_type=None, + create_key=_descriptor._internal_create_key, fields=[ _descriptor.FieldDescriptor( name="schedule_time", @@ -327,6 +345,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="dispatch_time", @@ -345,6 +364,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="response_time", @@ -363,6 +383,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), _descriptor.FieldDescriptor( name="response_status", @@ -381,6 +402,7 @@ extension_scope=None, serialized_options=None, file=DESCRIPTOR, + create_key=_descriptor._internal_create_key, ), ], extensions=[], @@ -447,10 +469,11 @@ Task = _reflection.GeneratedProtocolMessageType( "Task", (_message.Message,), - dict( - DESCRIPTOR=_TASK, - __module__="google.cloud.tasks_v2beta3.proto.task_pb2", - __doc__="""A unit of scheduled work. + { + "DESCRIPTOR": _TASK, + "__module__": "google.cloud.tasks_v2beta3.proto.task_pb2", + "__doc__": """A unit of scheduled work. + Attributes: name: Optionally caller-specified in [CreateTask][google.cloud.tasks @@ -462,7 +485,7 @@ information, see `Identifying projects `_ - ``LOCATION_ID`` - is the canonical ID for the task's location. The list of + is the canonical ID for the task’s location. The list of available locations can be obtained by calling [ListLocatio ns][google.cloud.location.Locations.ListLocations]. For more information, see @@ -470,7 +493,7 @@ 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 + (-), or underscores (_). The maximum length is 500 characters. payload_type: Required. The message to send to the worker. @@ -479,7 +502,7 @@ App Engine task is a task that has [AppEngineHttpRequest][goog le.cloud.tasks.v2beta3.AppEngineHttpRequest] set. http_request: - HTTP request that is sent to the task's target. An HTTP task + HTTP request that is sent to the task’s target. An HTTP task is a task that has [HttpRequest][google.cloud.tasks.v2beta3.HttpRequest] set. schedule_time: @@ -497,7 +520,7 @@ failure. Cloud Tasks will retry the task according to the [RetryConfig][google.cloud.tasks.v2beta3.RetryConfig]. Note that when the request is cancelled, Cloud Tasks will stop - listing for the response, but whether the worker stops + listening for the response, but whether the worker stops processing depends on the worker. For example, if the worker is stuck, it may not react to cancelled requests. The default and maximum values depend on the type of request: - For @@ -513,10 +536,10 @@ hours for standard apps with manual and basic scaling, and 60 minutes for flex apps. If the request deadline is set, it must be in the interval [15 seconds, 24 hours 15 seconds]. - Regardless of the task's ``dispatch_deadline``, the app - handler will not run for longer than than the service's + Regardless of the task’s ``dispatch_deadline``, the app + handler will not run for longer than than the service’s timeout. We recommend setting the ``dispatch_deadline`` to - at most a few seconds more than the app handler's timeout. + at most a few seconds more than the app handler’s timeout. For more information see `Timeouts `_. ``dispatch_deadline`` will be @@ -524,35 +547,36 @@ approximate deadline. dispatch_count: Output only. The number of attempts dispatched. This count - includes attempts which have been dispatched but haven't + includes attempts which have been dispatched but haven’t received a response. response_count: Output only. The number of attempts which have received a response. first_attempt: - Output only. The status of the task's first attempt. Only [di - spatch\_time][google.cloud.tasks.v2beta3.Attempt.dispatch\_tim - e] will be set. The other + Output only. The status of the task’s first attempt. Only [di + spatch_time][google.cloud.tasks.v2beta3.Attempt.dispatch_time] + will be set. The other [Attempt][google.cloud.tasks.v2beta3.Attempt] information is not retained by Cloud Tasks. last_attempt: - Output only. The status of the task's last attempt. + Output only. The status of the task’s last attempt. view: Output only. The view specifies which subset of the [Task][google.cloud.tasks.v2beta3.Task] has been returned. """, # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta3.Task) - ), + }, ) _sym_db.RegisterMessage(Task) Attempt = _reflection.GeneratedProtocolMessageType( "Attempt", (_message.Message,), - dict( - DESCRIPTOR=_ATTEMPT, - __module__="google.cloud.tasks_v2beta3.proto.task_pb2", - __doc__="""The status of a task attempt. + { + "DESCRIPTOR": _ATTEMPT, + "__module__": "google.cloud.tasks_v2beta3.proto.task_pb2", + "__doc__": """The status of a task attempt. + Attributes: schedule_time: Output only. The time that this attempt was scheduled. @@ -573,7 +597,7 @@ field is meaningless. """, # @@protoc_insertion_point(class_scope:google.cloud.tasks.v2beta3.Attempt) - ), + }, ) _sym_db.RegisterMessage(Attempt) diff --git a/google/cloud/tasks_v2beta3/proto/task_pb2_grpc.py b/google/cloud/tasks_v2beta3/proto/task_pb2_grpc.py index 07cb78fe..8a939394 100644 --- a/google/cloud/tasks_v2beta3/proto/task_pb2_grpc.py +++ b/google/cloud/tasks_v2beta3/proto/task_pb2_grpc.py @@ -1,2 +1,3 @@ # Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT! +"""Client and server classes corresponding to protobuf-defined services.""" import grpc diff --git a/google/cloud/tasks_v2beta3/types.py b/google/cloud/tasks_v2beta3/types.py index 9b41489e..6c3a9c40 100644 --- a/google/cloud/tasks_v2beta3/types.py +++ b/google/cloud/tasks_v2beta3/types.py @@ -49,7 +49,12 @@ expr_pb2, ] -_local_modules = [cloudtasks_pb2, queue_pb2, target_pb2, task_pb2] +_local_modules = [ + cloudtasks_pb2, + queue_pb2, + target_pb2, + task_pb2, +] names = [] diff --git a/noxfile.py b/noxfile.py index 091af628..f2b20939 100644 --- a/noxfile.py +++ b/noxfile.py @@ -23,14 +23,15 @@ import nox -BLACK_VERSION = "black==19.3b0" +BLACK_VERSION = "black==19.10b0" BLACK_PATHS = ["docs", "google", "tests", "noxfile.py", "setup.py"] -if os.path.exists("samples"): - BLACK_PATHS.append("samples") +DEFAULT_PYTHON_VERSION = "3.8" +SYSTEM_TEST_PYTHON_VERSIONS = ["2.7", "3.8"] +UNIT_TEST_PYTHON_VERSIONS = ["2.7", "3.5", "3.6", "3.7", "3.8"] -@nox.session(python="3.7") +@nox.session(python=DEFAULT_PYTHON_VERSION) def lint(session): """Run linters. @@ -38,7 +39,9 @@ def lint(session): serious code quality issues. """ session.install("flake8", BLACK_VERSION) - session.run("black", "--check", *BLACK_PATHS) + session.run( + "black", "--check", *BLACK_PATHS, + ) session.run("flake8", "google", "tests") @@ -53,10 +56,12 @@ def blacken(session): check the state of the `gcp_ubuntu_config` we use for that Kokoro run. """ session.install(BLACK_VERSION) - session.run("black", *BLACK_PATHS) + session.run( + "black", *BLACK_PATHS, + ) -@nox.session(python="3.7") +@nox.session(python=DEFAULT_PYTHON_VERSION) def lint_setup_py(session): """Verify that setup.py is valid (including RST check).""" session.install("docutils", "pygments") @@ -84,13 +89,13 @@ def default(session): ) -@nox.session(python=["2.7", "3.5", "3.6", "3.7", "3.8"]) +@nox.session(python=UNIT_TEST_PYTHON_VERSIONS) def unit(session): """Run the unit test suite.""" default(session) -@nox.session(python=["2.7", "3.7"]) +@nox.session(python=SYSTEM_TEST_PYTHON_VERSIONS) def system(session): """Run the system test suite.""" system_test_path = os.path.join("tests", "system.py") @@ -110,8 +115,9 @@ def system(session): # Install all test dependencies, then install this package into the # virtualenv's dist-packages. - session.install("mock", "pytest") - session.install("git+https://github.com/googleapis/python-test-utils") + session.install( + "mock", "pytest", "google-cloud-testutils", + ) session.install("-e", ".") # Run py.test against the system tests. @@ -121,7 +127,7 @@ def system(session): session.run("py.test", "--quiet", system_test_folder_path, *session.posargs) -@nox.session(python="3.7") +@nox.session(python=DEFAULT_PYTHON_VERSION) def cover(session): """Run the final coverage report. @@ -134,7 +140,7 @@ def cover(session): session.run("coverage", "erase") -@nox.session(python="3.7") +@nox.session(python=DEFAULT_PYTHON_VERSION) def docs(session): """Build the docs for this library.""" diff --git a/scripts/decrypt-secrets.sh b/scripts/decrypt-secrets.sh new file mode 100755 index 00000000..ff599eb2 --- /dev/null +++ b/scripts/decrypt-secrets.sh @@ -0,0 +1,33 @@ +#!/bin/bash + +# Copyright 2015 Google Inc. All rights reserved. +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + +DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )" +ROOT=$( dirname "$DIR" ) + +# Work from the project root. +cd $ROOT + +# Use SECRET_MANAGER_PROJECT if set, fallback to cloud-devrel-kokoro-resources. +PROJECT_ID="${SECRET_MANAGER_PROJECT:-cloud-devrel-kokoro-resources}" + +gcloud secrets versions access latest --secret="python-docs-samples-test-env" \ + > testing/test-env.sh +gcloud secrets versions access latest \ + --secret="python-docs-samples-service-account" \ + > testing/service-account.json +gcloud secrets versions access latest \ + --secret="python-docs-samples-client-secrets" \ + > testing/client-secrets.json \ No newline at end of file diff --git a/scripts/readme-gen/readme_gen.py b/scripts/readme-gen/readme_gen.py new file mode 100644 index 00000000..d309d6e9 --- /dev/null +++ b/scripts/readme-gen/readme_gen.py @@ -0,0 +1,66 @@ +#!/usr/bin/env python + +# Copyright 2016 Google Inc +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + +"""Generates READMEs using configuration defined in yaml.""" + +import argparse +import io +import os +import subprocess + +import jinja2 +import yaml + + +jinja_env = jinja2.Environment( + trim_blocks=True, + loader=jinja2.FileSystemLoader( + os.path.abspath(os.path.join(os.path.dirname(__file__), 'templates')))) + +README_TMPL = jinja_env.get_template('README.tmpl.rst') + + +def get_help(file): + return subprocess.check_output(['python', file, '--help']).decode() + + +def main(): + parser = argparse.ArgumentParser() + parser.add_argument('source') + parser.add_argument('--destination', default='README.rst') + + args = parser.parse_args() + + source = os.path.abspath(args.source) + root = os.path.dirname(source) + destination = os.path.join(root, args.destination) + + jinja_env.globals['get_help'] = get_help + + with io.open(source, 'r') as f: + config = yaml.load(f) + + # This allows get_help to execute in the right directory. + os.chdir(root) + + output = README_TMPL.render(config) + + with io.open(destination, 'w') as f: + f.write(output) + + +if __name__ == '__main__': + main() diff --git a/scripts/readme-gen/templates/README.tmpl.rst b/scripts/readme-gen/templates/README.tmpl.rst new file mode 100644 index 00000000..4fd23976 --- /dev/null +++ b/scripts/readme-gen/templates/README.tmpl.rst @@ -0,0 +1,87 @@ +{# The following line is a lie. BUT! Once jinja2 is done with it, it will + become truth! #} +.. This file is automatically generated. Do not edit this file directly. + +{{product.name}} Python Samples +=============================================================================== + +.. image:: https://gstatic.com/cloudssh/images/open-btn.png + :target: https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/GoogleCloudPlatform/python-docs-samples&page=editor&open_in_editor={{folder}}/README.rst + + +This directory contains samples for {{product.name}}. {{product.description}} + +{{description}} + +.. _{{product.name}}: {{product.url}} + +{% if required_api_url %} +To run the sample, you need to enable the API at: {{required_api_url}} +{% endif %} + +{% if required_role %} +To run the sample, you need to have `{{required_role}}` role. +{% endif %} + +{{other_required_steps}} + +{% if setup %} +Setup +------------------------------------------------------------------------------- + +{% for section in setup %} + +{% include section + '.tmpl.rst' %} + +{% endfor %} +{% endif %} + +{% if samples %} +Samples +------------------------------------------------------------------------------- + +{% for sample in samples %} +{{sample.name}} ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ + +{% if not sample.hide_cloudshell_button %} +.. image:: https://gstatic.com/cloudssh/images/open-btn.png + :target: https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/GoogleCloudPlatform/python-docs-samples&page=editor&open_in_editor={{folder}}/{{sample.file}},{{folder}}/README.rst +{% endif %} + + +{{sample.description}} + +To run this sample: + +.. code-block:: bash + + $ python {{sample.file}} +{% if sample.show_help %} + + {{get_help(sample.file)|indent}} +{% endif %} + + +{% endfor %} +{% endif %} + +{% if cloud_client_library %} + +The client library +------------------------------------------------------------------------------- + +This sample uses the `Google Cloud Client Library for Python`_. +You can read the documentation for more details on API usage and use GitHub +to `browse the source`_ and `report issues`_. + +.. _Google Cloud Client Library for Python: + https://googlecloudplatform.github.io/google-cloud-python/ +.. _browse the source: + https://github.com/GoogleCloudPlatform/google-cloud-python +.. _report issues: + https://github.com/GoogleCloudPlatform/google-cloud-python/issues + +{% endif %} + +.. _Google Cloud SDK: https://cloud.google.com/sdk/ \ No newline at end of file diff --git a/scripts/readme-gen/templates/auth.tmpl.rst b/scripts/readme-gen/templates/auth.tmpl.rst new file mode 100644 index 00000000..1446b94a --- /dev/null +++ b/scripts/readme-gen/templates/auth.tmpl.rst @@ -0,0 +1,9 @@ +Authentication +++++++++++++++ + +This sample requires you to have authentication setup. Refer to the +`Authentication Getting Started Guide`_ for instructions on setting up +credentials for applications. + +.. _Authentication Getting Started Guide: + https://cloud.google.com/docs/authentication/getting-started diff --git a/scripts/readme-gen/templates/auth_api_key.tmpl.rst b/scripts/readme-gen/templates/auth_api_key.tmpl.rst new file mode 100644 index 00000000..11957ce2 --- /dev/null +++ b/scripts/readme-gen/templates/auth_api_key.tmpl.rst @@ -0,0 +1,14 @@ +Authentication +++++++++++++++ + +Authentication for this service is done via an `API Key`_. To obtain an API +Key: + +1. Open the `Cloud Platform Console`_ +2. Make sure that billing is enabled for your project. +3. From the **Credentials** page, create a new **API Key** or use an existing + one for your project. + +.. _API Key: + https://developers.google.com/api-client-library/python/guide/aaa_apikeys +.. _Cloud Console: https://console.cloud.google.com/project?_ diff --git a/scripts/readme-gen/templates/install_deps.tmpl.rst b/scripts/readme-gen/templates/install_deps.tmpl.rst new file mode 100644 index 00000000..a0406dba --- /dev/null +++ b/scripts/readme-gen/templates/install_deps.tmpl.rst @@ -0,0 +1,29 @@ +Install Dependencies +++++++++++++++++++++ + +#. Clone python-docs-samples and change directory to the sample directory you want to use. + + .. code-block:: bash + + $ git clone https://github.com/GoogleCloudPlatform/python-docs-samples.git + +#. Install `pip`_ and `virtualenv`_ if you do not already have them. You may want to refer to the `Python Development Environment Setup Guide`_ for Google Cloud Platform for instructions. + + .. _Python Development Environment Setup Guide: + https://cloud.google.com/python/setup + +#. Create a virtualenv. Samples are compatible with Python 2.7 and 3.4+. + + .. code-block:: bash + + $ virtualenv env + $ source env/bin/activate + +#. Install the dependencies needed to run the samples. + + .. code-block:: bash + + $ pip install -r requirements.txt + +.. _pip: https://pip.pypa.io/ +.. _virtualenv: https://virtualenv.pypa.io/ diff --git a/scripts/readme-gen/templates/install_portaudio.tmpl.rst b/scripts/readme-gen/templates/install_portaudio.tmpl.rst new file mode 100644 index 00000000..5ea33d18 --- /dev/null +++ b/scripts/readme-gen/templates/install_portaudio.tmpl.rst @@ -0,0 +1,35 @@ +Install PortAudio ++++++++++++++++++ + +Install `PortAudio`_. This is required by the `PyAudio`_ library to stream +audio from your computer's microphone. PyAudio depends on PortAudio for cross-platform compatibility, and is installed differently depending on the +platform. + +* For Mac OS X, you can use `Homebrew`_:: + + brew install portaudio + + **Note**: if you encounter an error when running `pip install` that indicates + it can't find `portaudio.h`, try running `pip install` with the following + flags:: + + pip install --global-option='build_ext' \ + --global-option='-I/usr/local/include' \ + --global-option='-L/usr/local/lib' \ + pyaudio + +* For Debian / Ubuntu Linux:: + + apt-get install portaudio19-dev python-all-dev + +* Windows may work without having to install PortAudio explicitly (it will get + installed with PyAudio). + +For more details, see the `PyAudio installation`_ page. + + +.. _PyAudio: https://people.csail.mit.edu/hubert/pyaudio/ +.. _PortAudio: http://www.portaudio.com/ +.. _PyAudio installation: + https://people.csail.mit.edu/hubert/pyaudio/#downloads +.. _Homebrew: http://brew.sh diff --git a/synth.metadata b/synth.metadata index b1545284..b2eb7dd2 100644 --- a/synth.metadata +++ b/synth.metadata @@ -1,32 +1,25 @@ { "sources": [ - { - "generator": { - "name": "artman", - "version": "2.0.0", - "dockerImage": "googleapis/artman@sha256:b3b47805231a305d0f40c4bf069df20f6a2635574e6d4259fac651d3f9f6e098" - } - }, { "git": { "name": ".", "remote": "https://github.com/googleapis/python-tasks.git", - "sha": "100e9c709383848498e1e6a747fb819520a7d8c1" + "sha": "01304e72b9f4dd6091f770c08135b012075ba731" } }, { "git": { "name": "googleapis", "remote": "https://github.com/googleapis/googleapis.git", - "sha": "42ee97c1b93a0e3759bbba3013da309f670a90ab", - "internalRef": "307114445" + "sha": "b882b8e6bfcd708042ff00f7adc67ce750817dd0", + "internalRef": "318028816" } }, { "git": { "name": "synthtool", "remote": "https://github.com/googleapis/synthtool.git", - "sha": "f5e4c17dc78a966dbf29961dd01f9bbd63e20a04" + "sha": "2a29860e484695a07aa8670f9e750bfeeb308a43" } } ], @@ -37,8 +30,7 @@ "apiName": "tasks", "apiVersion": "v2beta2", "language": "python", - "generator": "gapic", - "config": "google/cloud/tasks/artman_cloudtasks_v2beta2.yaml" + "generator": "bazel" } }, { @@ -47,8 +39,7 @@ "apiName": "tasks", "apiVersion": "v2beta3", "language": "python", - "generator": "gapic", - "config": "google/cloud/tasks/artman_cloudtasks_v2beta3.yaml" + "generator": "bazel" } }, { @@ -57,8 +48,7 @@ "apiName": "tasks", "apiVersion": "v2", "language": "python", - "generator": "gapic", - "config": "google/cloud/tasks/artman_cloudtasks_v2.yaml" + "generator": "bazel" } } ] diff --git a/synth.py b/synth.py index f543cc84..74cce6d9 100644 --- a/synth.py +++ b/synth.py @@ -118,4 +118,14 @@ templated_files = common.py_library(cov_level=86) s.move(templated_files) +# TODO(busunkim): Use latest sphinx after microgenerator transition +s.replace("noxfile.py", """['"]sphinx['"]""", '"sphinx<3.0.0"') + +# Escape '_' in docstrings +s.replace( + "google/cloud/**/*_pb2.py", + """\_$""", + """\_""", +) + s.shell.run(["nox", "-s", "blacken"], hide_output=False) diff --git a/testing/.gitignore b/testing/.gitignore new file mode 100644 index 00000000..b05fbd63 --- /dev/null +++ b/testing/.gitignore @@ -0,0 +1,3 @@ +test-env.sh +service-account.json +client-secrets.json \ No newline at end of file