feat: Add new gcloud commands, API clients, and third-party libraries across various services.

gcloud auth application-default login/google-cloud-sdk/lib/surface/scheduler/jobs/update/__init__.py

@@ -0,0 +1,25 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2019 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.
+"""Command group for Cloud Scheduler jobs."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.calliope import base
+
+
+class Update(base.Group):
+  """Update Cloud Scheduler jobs for various types of targets."""

gcloud auth application-default login/google-cloud-sdk/lib/surface/scheduler/jobs/update/app_engine.yaml

@@ -0,0 +1,123 @@
+- help_text:
+    brief: Update a Cloud Scheduler job with an App Engine target.
+    description: Update a Cloud Scheduler job with an App Engine target.
+    examples: |
+      Update my-job's retry attempt limit:
+
+        $ {command} my-job --max-retry-attempts=2
+
+  request:
+    collection: cloudscheduler.projects.locations.jobs
+    method: patch
+    modify_request_hooks:
+    - googlecloudsdk.command_lib.scheduler.util:SetRequestJobName
+    - googlecloudsdk.command_lib.scheduler.util:SetAppEngineRequestMessageBody
+    - googlecloudsdk.command_lib.scheduler.util:SetAppEngineRequestUpdateHeaders
+    - googlecloudsdk.command_lib.scheduler.util:UpdateAppEngineMaskHook
+
+  arguments:
+    resource:
+      help_text: Job to update.
+      spec: !REF googlecloudsdk.command_lib.scheduler.resources:job
+    params:
+    - _REF_: googlecloudsdk.command_lib.scheduler.flags:schedule
+    - _REF_: googlecloudsdk.command_lib.scheduler.flags:clearable_timezone
+    - _REF_: googlecloudsdk.command_lib.scheduler.flags:description
+    - _REF_: googlecloudsdk.command_lib.scheduler.flags:attempt_deadline
+    - _REF_: googlecloudsdk.command_lib.scheduler.flags:clearable_retry_attempts
+    - _REF_: googlecloudsdk.command_lib.scheduler.flags:clearable_retry_duration
+    - _REF_: googlecloudsdk.command_lib.scheduler.flags:clearable_min_backoff
+    - _REF_: googlecloudsdk.command_lib.scheduler.flags:clearable_max_backoff
+    - _REF_: googlecloudsdk.command_lib.scheduler.flags:clearable_max_doublings
+    - group:
+        mutex: true
+        params:
+        - api_field: job.appEngineHttpTarget.relativeUri
+          arg_name: relative-url
+          default: /
+          type: googlecloudsdk.calliope.arg_parsers:RegexpValidator:pattern=^/.*,description=Must
+            begin with [/].)
+          help_text: |
+            Relative URL to use for the request (beginning with "/").
+        - arg_name: clear-relative-url
+          action: store_true
+          processor: googlecloudsdk.command_lib.scheduler.util:ClearFlag
+          help_text: |
+            Clear the field corresponding to `--relative-url`.
+    - api_field: job.appEngineHttpTarget.httpMethod
+      arg_name: http-method
+      default: post
+      choices:
+      - arg_value: post
+        enum_value: POST
+      - arg_value: head
+        enum_value: HEAD
+      - arg_value: get
+        enum_value: GET
+      - arg_value: put
+        enum_value: PUT
+      - arg_value: delete
+        enum_value: DELETE
+      help_text: |
+        HTTP method to use for the request.
+    # TODO(b/113588592) Convert --version and --service to a resource arg.
+    - api_field: job.appEngineHttpTarget.appEngineRouting.version
+      arg_name: version
+      help_text: |
+        Version of the App Engine service to send the request to.
+    - group:
+        mutex: true
+        params:
+        - arg_name: clear-service
+          action: store_true
+          processor: googlecloudsdk.command_lib.scheduler.util:ClearFlag
+          help_text: |
+            Clear the field corresponding to `--service`.
+        - api_field: job.appEngineHttpTarget.appEngineRouting.service
+          arg_name: service
+          default: default
+          help_text: |
+            ID of the App Engine service to send the request to.
+    - group:
+        mutex: true
+        params:
+        - arg_name: clear-headers
+          action: store_true
+          processor: googlecloudsdk.command_lib.scheduler.util:ClearFlag
+          help_text: |
+            Clear the list of HTTP headers.
+        - group:
+            params:
+            - arg_name: update-headers
+              metavar: KEY=VALUE
+              type: "googlecloudsdk.calliope.arg_parsers:ArgDict:"
+              help_text: |
+                KEY=VALUE pairs of HTTP headers to include in the request.
+                *Cannot be repeated*. For example:
+                `--update-headers Accept-Language=en-us,Accept=text/plain`
+            - arg_name: remove-headers
+              type: "googlecloudsdk.calliope.arg_parsers:ArgList:"
+              help_text: |
+                KEY1,KEY2 list of HTTP headers to remove from the request.
+                `--remove-headers Accept-Language,Accept`
+    - group:
+        mutex: true
+        params:
+        - api_field: job.appEngineHttpTarget.body
+          arg_name: message-body
+          help_text: |
+            Data payload to be included as the body of the HTTP
+            request. May only be given with compatible HTTP methods (PUT
+            or POST).
+        - api_field: job.appEngineHttpTarget.body
+          arg_name: message-body-from-file
+          type: "googlecloudsdk.calliope.arg_parsers:FileContents:binary=True"
+          help_text: |
+            Path to file containing the data payload to be included as the
+            body of the HTTP request. May only be given with compatible HTTP
+            methods (PUT or POST).
+        - arg_name: clear-message-body
+          action: store_true
+          processor: googlecloudsdk.command_lib.scheduler.util:ClearFlag
+          help_text: |
+            Clear the field corresponding to `--message-body` or `--message-body-from-file`.

gcloud auth application-default login/google-cloud-sdk/lib/surface/scheduler/jobs/update/http.yaml

@@ -0,0 +1,119 @@
+- help_text:
+    brief: Update a Cloud Scheduler job that triggers an action via HTTP.
+    description: Update a Cloud Scheduler job that triggers an action via HTTP.
+    examples: |
+      Update my-job's retry attempt limit:
+
+        $ {command} my-job --max-retry-attempts=2
+
+  request:
+    collection: cloudscheduler.projects.locations.jobs
+    method: patch
+    modify_request_hooks:
+    - googlecloudsdk.command_lib.scheduler.util:SetRequestJobName
+    - googlecloudsdk.command_lib.scheduler.util:SetHTTPRequestMessageBody
+    - googlecloudsdk.command_lib.scheduler.util:SetHTTPRequestUpdateHeaders
+    - googlecloudsdk.command_lib.scheduler.util:UpdateHTTPMaskHook
+
+  arguments:
+    resource:
+      help_text: Job to update.
+      spec: !REF googlecloudsdk.command_lib.scheduler.resources:job
+    params:
+    - _REF_: googlecloudsdk.command_lib.scheduler.flags:schedule
+    - _REF_: googlecloudsdk.command_lib.scheduler.flags:clearable_timezone
+    - _REF_: googlecloudsdk.command_lib.scheduler.flags:description
+    - _REF_: googlecloudsdk.command_lib.scheduler.flags:clearable_retry_attempts
+    - _REF_: googlecloudsdk.command_lib.scheduler.flags:clearable_retry_duration
+    - _REF_: googlecloudsdk.command_lib.scheduler.flags:clearable_min_backoff
+    - _REF_: googlecloudsdk.command_lib.scheduler.flags:clearable_max_backoff
+    - _REF_: googlecloudsdk.command_lib.scheduler.flags:clearable_max_doublings
+    - api_field: job.httpTarget.uri
+      arg_name: uri
+      # Can't use : in argument hooks so omit it both from regex and help
+      # message.
+      type:
+        googlecloudsdk.calliope.arg_parsers:RegexpValidator:pattern=^https?.//.*,description=Must
+        be a valid HTTP or HTTPS URL.
+      help_text: |
+        The full URI path that the request will be sent to. This string must
+        begin with either "http://" or "https://". For example,
+        `http://acme.com` or `https://acme.com/sales:8080`. Cloud Scheduler will
+        encode some characters for safety and compatibility. The maximum allowed
+        URL length is 2083 characters after encoding.
+    - api_field: job.httpTarget.httpMethod
+      arg_name: http-method
+      default: post
+      choices:
+      - arg_value: post
+        enum_value: POST
+      - arg_value: head
+        enum_value: HEAD
+      - arg_value: get
+        enum_value: GET
+      - arg_value: put
+        enum_value: PUT
+      - arg_value: delete
+        enum_value: DELETE
+      help_text: |
+        HTTP method to use for the request.
+    - _REF_: googlecloudsdk.command_lib.scheduler.flags:attempt_deadline
+    - group:
+        mutex: true
+        params:
+        - arg_name: clear-headers
+          action: store_true
+          processor: googlecloudsdk.command_lib.scheduler.util:ClearFlag
+          help_text: |
+            Clear the list of HTTP headers.
+        - group:
+            params:
+            - arg_name: update-headers
+              metavar: KEY=VALUE
+              type: "googlecloudsdk.calliope.arg_parsers:ArgDict:"
+              help_text: |
+                KEY=VALUE pairs of HTTP headers to include in the request.
+                *Cannot be repeated*. For example:
+                `--update-headers Accept-Language=en-us,Accept=text/plain`
+            - arg_name: remove-headers
+              type: "googlecloudsdk.calliope.arg_parsers:ArgList:"
+              help_text: |
+                KEY1,KEY2 list of HTTP headers to remove from the request.
+                `--remove-headers Accept-Language,Accept`
+    - group:
+        mutex: true
+        params:
+        - api_field: job.httpTarget.body
+          arg_name: message-body
+          help_text: |
+            Data payload to be included as the body of the HTTP
+            request. May only be given with compatible HTTP methods (PUT
+            or POST).
+        - api_field: job.httpTarget.body
+          arg_name: message-body-from-file
+          type:
+            googlecloudsdk.calliope.arg_parsers:FileContents:binary=True
+          help_text: |
+            Path to file containing the data payload to be included as the
+            body of the HTTP request. May only be given with compatible HTTP
+            methods (PUT or POST).
+        - arg_name: clear-message-body
+          action: store_true
+          processor: googlecloudsdk.command_lib.scheduler.util:ClearFlag
+          help_text: |
+            Clear the field corresponding to `--message-body` or `--message-body-from-file`.
+    - group:
+        help_text: |
+          How the request sent to the target when executing the job should be
+          authenticated.
+        mutex: true
+        params:
+        - _REF_: googlecloudsdk.command_lib.scheduler.flags:auth_token_openid
+        - _REF_: googlecloudsdk.command_lib.scheduler.flags:auth_token_oauth
+        - arg_name: clear-auth-token
+          action: store_true
+          processor: googlecloudsdk.command_lib.scheduler.util:ClearFlag
+          help_text: |
+            Clear the auth token fields: `--oidc-service-account-email`,
+            `--oidc-token-audience`, `--oauth-service-account-email`,
+            and `--oauth-token-scope`.

gcloud auth application-default login/google-cloud-sdk/lib/surface/scheduler/jobs/update/pubsub.yaml

@@ -0,0 +1,65 @@
+- help_text:
+    brief: Update a Cloud Scheduler job with a Pub/Sub target.
+    description: Update a Cloud Scheduler job with a Pub/Sub target.
+    examples: |
+      Update my-job's retry attempt limit:
+
+        $ {command} my-job --max-retry-attempts=2
+
+  request:
+    collection: cloudscheduler.projects.locations.jobs
+    method: patch
+    modify_request_hooks:
+    - googlecloudsdk.command_lib.scheduler.util:SetRequestJobName
+    - googlecloudsdk.command_lib.scheduler.util:SetPubsubRequestMessageBody
+    - googlecloudsdk.command_lib.scheduler.util:SetPubsubRequestUpdateAttributes
+    - googlecloudsdk.command_lib.scheduler.util:UpdatePubSubMaskHook
+
+  arguments:
+    resource:
+      help_text: Job to update.
+      spec: !REF googlecloudsdk.command_lib.scheduler.resources:job
+    params:
+    - _REF_: googlecloudsdk.command_lib.scheduler.flags:schedule
+    - _REF_: googlecloudsdk.command_lib.scheduler.flags:clearable_timezone
+    - _REF_: googlecloudsdk.command_lib.scheduler.flags:description
+    - _REF_: googlecloudsdk.command_lib.scheduler.flags:clearable_retry_attempts
+    - _REF_: googlecloudsdk.command_lib.scheduler.flags:clearable_retry_duration
+    - _REF_: googlecloudsdk.command_lib.scheduler.flags:clearable_min_backoff
+    - _REF_: googlecloudsdk.command_lib.scheduler.flags:clearable_max_backoff
+    - _REF_: googlecloudsdk.command_lib.scheduler.flags:clearable_max_doublings
+    - _REF_: googlecloudsdk.command_lib.scheduler.flags:pubsub_topic
+    - group:
+        mutex: true
+        help_text: |
+          Body of the message to publish to the given topic name. Information on
+          message formatting and size limits can be found at:
+          https://cloud.google.com/pubsub/docs/publisher#publish
+        params:
+        - arg_name: message-body
+          help_text: Body of the message.
+        - arg_name: message-body-from-file
+          type: "googlecloudsdk.calliope.arg_parsers:FileContents:"
+          help_text: Path to a file containing the body of the message.
+    - group:
+        mutex: true
+        params:
+        - arg_name: clear-attributes
+          api_field: job.pubsubTarget.attributes
+          action: store_true
+          processor: googlecloudsdk.command_lib.scheduler.util:ClearFlag
+          help_text: |
+            Clear the field corresponding to `--attributes`.
+        - group:
+            params:
+            - arg_name: update-attributes
+              metavar: KEY=VALUE
+              type: "googlecloudsdk.calliope.arg_parsers:ArgDict:"
+              help_text: |
+                Comma-separated list of attributes. Each attribute has the form
+                "NAME=VALUE". You can specify up to 100 attributes.
+            - arg_name: remove-attributes
+              type: "googlecloudsdk.calliope.arg_parsers:ArgList:"
+              help_text: |
+                Comma-separated list of attribute keys to remove with the form
+                "KEY1,KEY2".