google-cloud-scheduler-v1beta1 0.1.0

data/proto_docs/google/cloud/scheduler/v1beta1/job.rb

@@ -0,0 +1,231 @@
+# frozen_string_literal: true
+
+# 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.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Cloud
+    module Scheduler
+      module V1beta1
+        # Configuration for a job.
+        # The maximum allowed size for a job is 100KB.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Optionally caller-specified in {::Google::Cloud::Scheduler::V1beta1::CloudScheduler::Client#create_job CreateJob}, after
+        #     which it becomes output only.
+        #
+        #     The job name. For example:
+        #     `projects/PROJECT_ID/locations/LOCATION_ID/jobs/JOB_ID`.
+        #
+        #     * `PROJECT_ID` can contain letters ([A-Za-z]), numbers ([0-9]),
+        #        hyphens (-), colons (:), or periods (.).
+        #        For more information, see
+        #        [Identifying
+        #        projects](https://cloud.google.com/resource-manager/docs/creating-managing-projects#identifying_projects)
+        #     * `LOCATION_ID` is the canonical ID for the job'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/.
+        #     * `JOB_ID` can contain only letters ([A-Za-z]), numbers ([0-9]),
+        #        hyphens (-), or underscores (_). The maximum length is 500 characters.
+        # @!attribute [rw] description
+        #   @return [::String]
+        #     Optionally caller-specified in {::Google::Cloud::Scheduler::V1beta1::CloudScheduler::Client#create_job CreateJob} or
+        #     {::Google::Cloud::Scheduler::V1beta1::CloudScheduler::Client#update_job UpdateJob}.
+        #
+        #     A human-readable description for the job. This string must not contain
+        #     more than 500 characters.
+        # @!attribute [rw] pubsub_target
+        #   @return [::Google::Cloud::Scheduler::V1beta1::PubsubTarget]
+        #     Pub/Sub target.
+        # @!attribute [rw] app_engine_http_target
+        #   @return [::Google::Cloud::Scheduler::V1beta1::AppEngineHttpTarget]
+        #     App Engine HTTP target.
+        # @!attribute [rw] http_target
+        #   @return [::Google::Cloud::Scheduler::V1beta1::HttpTarget]
+        #     HTTP target.
+        # @!attribute [rw] schedule
+        #   @return [::String]
+        #     Required, except when used with {::Google::Cloud::Scheduler::V1beta1::CloudScheduler::Client#update_job UpdateJob}.
+        #
+        #     Describes the schedule on which the job will be executed.
+        #
+        #     The schedule can be either of the following types:
+        #
+        #     * [Crontab](http://en.wikipedia.org/wiki/Cron#Overview)
+        #     * English-like
+        #     [schedule](https://cloud.google.com/scheduler/docs/configuring/cron-job-schedules)
+        #
+        #     As a general rule, execution `n + 1` of a job will not begin
+        #     until execution `n` has finished. Cloud Scheduler will never
+        #     allow two simultaneously outstanding executions. For example,
+        #     this implies that if the `n+1`th execution is scheduled to run at
+        #     16:00 but the `n`th execution takes until 16:15, the `n+1`th
+        #     execution will not start until `16:15`.
+        #     A scheduled start time will be delayed if the previous
+        #     execution has not ended when its scheduled time occurs.
+        #
+        #     If {::Google::Cloud::Scheduler::V1beta1::RetryConfig#retry_count retry_count} > 0 and a job attempt fails,
+        #     the job will be tried a total of {::Google::Cloud::Scheduler::V1beta1::RetryConfig#retry_count retry_count}
+        #     times, with exponential backoff, until the next scheduled start
+        #     time.
+        # @!attribute [rw] time_zone
+        #   @return [::String]
+        #     Specifies the time zone to be used in interpreting
+        #     {::Google::Cloud::Scheduler::V1beta1::Job#schedule schedule}. The value of this field must be a time
+        #     zone name from the [tz database](http://en.wikipedia.org/wiki/Tz_database).
+        #
+        #     Note that some time zones include a provision for
+        #     daylight savings time. The rules for daylight saving time are
+        #     determined by the chosen tz. For UTC use the string "utc". If a
+        #     time zone is not specified, the default will be in UTC (also known
+        #     as GMT).
+        # @!attribute [rw] user_update_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Output only. The creation time of the job.
+        # @!attribute [rw] state
+        #   @return [::Google::Cloud::Scheduler::V1beta1::Job::State]
+        #     Output only. State of the job.
+        # @!attribute [rw] status
+        #   @return [::Google::Rpc::Status]
+        #     Output only. The response from the target for the last attempted execution.
+        # @!attribute [rw] schedule_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Output only. The next time the job is scheduled. Note that this may be a
+        #     retry of a previously failed attempt or the next execution time
+        #     according to the schedule.
+        # @!attribute [rw] last_attempt_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Output only. The time the last job attempt started.
+        # @!attribute [rw] retry_config
+        #   @return [::Google::Cloud::Scheduler::V1beta1::RetryConfig]
+        #     Settings that determine the retry behavior.
+        # @!attribute [rw] attempt_deadline
+        #   @return [::Google::Protobuf::Duration]
+        #     The deadline for job attempts. If the request handler does not respond by
+        #     this deadline then the request is cancelled and the attempt is marked as a
+        #     `DEADLINE_EXCEEDED` failure. The failed attempt can be viewed in
+        #     execution logs. Cloud Scheduler will retry the job according
+        #     to the {::Google::Cloud::Scheduler::V1beta1::RetryConfig RetryConfig}.
+        #
+        #     The allowed duration for this deadline is:
+        #
+        #     * For {::Google::Cloud::Scheduler::V1beta1::Job#http_target HTTP targets}, between 15 seconds and 30 minutes.
+        #     * For {::Google::Cloud::Scheduler::V1beta1::Job#app_engine_http_target App Engine HTTP targets}, between 15
+        #       seconds and 24 hours.
+        #     * For {::Google::Cloud::Scheduler::V1beta1::Job#pubsub_target PubSub targets}, this field is ignored.
+        class Job
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # State of the job.
+          module State
+            # Unspecified state.
+            STATE_UNSPECIFIED = 0
+
+            # The job is executing normally.
+            ENABLED = 1
+
+            # The job is paused by the user. It will not execute. A user can
+            # intentionally pause the job using
+            # {::Google::Cloud::Scheduler::V1beta1::PauseJobRequest PauseJobRequest}.
+            PAUSED = 2
+
+            # The job is disabled by the system due to error. The user
+            # cannot directly set a job to be disabled.
+            DISABLED = 3
+
+            # The job state resulting from a failed {::Google::Cloud::Scheduler::V1beta1::CloudScheduler::Client#update_job CloudScheduler.UpdateJob}
+            # operation. To recover a job from this state, retry
+            # {::Google::Cloud::Scheduler::V1beta1::CloudScheduler::Client#update_job CloudScheduler.UpdateJob} until a successful response is received.
+            UPDATE_FAILED = 4
+          end
+        end
+
+        # Settings that determine the retry behavior.
+        #
+        # By default, if a job does not complete successfully (meaning that
+        # an acknowledgement is not received from the handler, then it will be retried
+        # with exponential backoff according to the settings in {::Google::Cloud::Scheduler::V1beta1::RetryConfig RetryConfig}.
+        # @!attribute [rw] retry_count
+        #   @return [::Integer]
+        #     The number of attempts that the system will make to run a job using the
+        #     exponential backoff procedure described by
+        #     {::Google::Cloud::Scheduler::V1beta1::RetryConfig#max_doublings max_doublings}.
+        #
+        #     The default value of retry_count is zero.
+        #
+        #     If retry_count is zero, a job attempt will *not* be retried if
+        #     it fails. Instead the Cloud Scheduler system will wait for the
+        #     next scheduled execution time.
+        #
+        #     If retry_count is set to a non-zero number then Cloud Scheduler
+        #     will retry failed attempts, using exponential backoff,
+        #     retry_count times, or until the next scheduled execution time,
+        #     whichever comes first.
+        #
+        #     Values greater than 5 and negative values are not allowed.
+        # @!attribute [rw] max_retry_duration
+        #   @return [::Google::Protobuf::Duration]
+        #     The time limit for retrying a failed job, measured from time when an
+        #     execution was first attempted. If specified with
+        #     {::Google::Cloud::Scheduler::V1beta1::RetryConfig#retry_count retry_count}, the job will be retried until both
+        #     limits are reached.
+        #
+        #     The default value for max_retry_duration is zero, which means retry
+        #     duration is unlimited.
+        # @!attribute [rw] min_backoff_duration
+        #   @return [::Google::Protobuf::Duration]
+        #     The minimum amount of time to wait before retrying a job after
+        #     it fails.
+        #
+        #     The default value of this field is 5 seconds.
+        # @!attribute [rw] max_backoff_duration
+        #   @return [::Google::Protobuf::Duration]
+        #     The maximum amount of time to wait before retrying a job after
+        #     it fails.
+        #
+        #     The default value of this field is 1 hour.
+        # @!attribute [rw] max_doublings
+        #   @return [::Integer]
+        #     The time between retries will double `max_doublings` times.
+        #
+        #     A job's retry interval starts at
+        #     {::Google::Cloud::Scheduler::V1beta1::RetryConfig#min_backoff_duration min_backoff_duration}, then doubles
+        #     `max_doublings` times, then increases linearly, and finally
+        #     retries retries at intervals of
+        #     {::Google::Cloud::Scheduler::V1beta1::RetryConfig#max_backoff_duration max_backoff_duration} up to
+        #     {::Google::Cloud::Scheduler::V1beta1::RetryConfig#retry_count retry_count} times.
+        #
+        #     For example, if {::Google::Cloud::Scheduler::V1beta1::RetryConfig#min_backoff_duration min_backoff_duration} is
+        #     10s, {::Google::Cloud::Scheduler::V1beta1::RetryConfig#max_backoff_duration max_backoff_duration} is 300s, and
+        #     `max_doublings` is 3, then the a job will first be retried in 10s. The
+        #     retry interval will double three times, and then increase linearly by
+        #     2^3 * 10s.  Finally, the job will retry at intervals of
+        #     {::Google::Cloud::Scheduler::V1beta1::RetryConfig#max_backoff_duration max_backoff_duration} until the job has
+        #     been attempted {::Google::Cloud::Scheduler::V1beta1::RetryConfig#retry_count retry_count} times. Thus, the
+        #     requests will retry at 10s, 20s, 40s, 80s, 160s, 240s, 300s, 300s, ....
+        #
+        #     The default value of this field is 5.
+        class RetryConfig
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+      end
+    end
+  end
+end

data/proto_docs/google/cloud/scheduler/v1beta1/target.rb

@@ -0,0 +1,385 @@
+# frozen_string_literal: true
+
+# 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.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Cloud
+    module Scheduler
+      module V1beta1
+        # Http target. The job will be pushed to the job handler by means of
+        # an HTTP request via an {::Google::Cloud::Scheduler::V1beta1::HttpTarget#http_method http_method} such as HTTP
+        # POST, HTTP GET, etc. The job is acknowledged by means of an HTTP
+        # response code in the range [200 - 299]. A failure to receive a response
+        # constitutes a failed execution. For a redirected request, the response
+        # returned by the redirected request is considered.
+        # @!attribute [rw] uri
+        #   @return [::String]
+        #     Required. The full URI path that the request will be sent to. This string
+        #     must begin with either "http://" or "https://". Some examples of
+        #     valid values for {::Google::Cloud::Scheduler::V1beta1::HttpTarget#uri uri} are:
+        #     `http://acme.com` and `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.
+        # @!attribute [rw] http_method
+        #   @return [::Google::Cloud::Scheduler::V1beta1::HttpMethod]
+        #     Which HTTP method to use for the request.
+        # @!attribute [rw] headers
+        #   @return [::Google::Protobuf::Map{::String => ::String}]
+        #     The user can specify HTTP request headers to send with the job's
+        #     HTTP request. This map contains the header field names and
+        #     values. Repeated headers are not supported, but a header value can
+        #     contain commas. These headers represent a subset of the headers
+        #     that will accompany the job's HTTP request. Some HTTP request
+        #     headers will be ignored or replaced. A partial list of headers that
+        #     will be ignored or replaced is below:
+        #     - Host: This will be computed by Cloud Scheduler and derived from
+        #     {::Google::Cloud::Scheduler::V1beta1::HttpTarget#uri uri}.
+        #     * `Content-Length`: This will be computed by Cloud Scheduler.
+        #     * `User-Agent`: This will be set to `"Google-Cloud-Scheduler"`.
+        #     * `X-Google-*`: Google internal use only.
+        #     * `X-AppEngine-*`: Google internal use only.
+        #
+        #     The total size of headers must be less than 80KB.
+        # @!attribute [rw] body
+        #   @return [::String]
+        #     HTTP request body. A request body is allowed only if the HTTP
+        #     method is POST, PUT, or PATCH. It is an error to set body on a job with an
+        #     incompatible {::Google::Cloud::Scheduler::V1beta1::HttpMethod HttpMethod}.
+        # @!attribute [rw] oauth_token
+        #   @return [::Google::Cloud::Scheduler::V1beta1::OAuthToken]
+        #     If specified, an
+        #     [OAuth token](https://developers.google.com/identity/protocols/OAuth2)
+        #     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 *.googleapis.com.
+        # @!attribute [rw] oidc_token
+        #   @return [::Google::Cloud::Scheduler::V1beta1::OidcToken]
+        #     If specified, an
+        #     [OIDC](https://developers.google.com/identity/protocols/OpenIDConnect)
+        #     token will be generated and attached as an `Authorization` header in the
+        #     HTTP request.
+        #
+        #     This type of authorization can be used for many scenarios, including
+        #     calling Cloud Run, or endpoints where you intend to validate the token
+        #     yourself.
+        class HttpTarget
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # @!attribute [rw] key
+          #   @return [::String]
+          # @!attribute [rw] value
+          #   @return [::String]
+          class HeadersEntry
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+        end
+
+        # App Engine target. The job will be pushed to a job handler by means
+        # of an HTTP request via an {::Google::Cloud::Scheduler::V1beta1::AppEngineHttpTarget#http_method http_method} such
+        # as HTTP POST, HTTP GET, etc. The job is acknowledged by means of an
+        # HTTP response code in the range [200 - 299]. Error 503 is
+        # considered an App Engine system error instead of an application
+        # error. Requests returning error 503 will be retried regardless of
+        # retry configuration and not counted against retry counts. Any other
+        # response code, or a failure to receive a response before the
+        # deadline, constitutes a failed attempt.
+        # @!attribute [rw] http_method
+        #   @return [::Google::Cloud::Scheduler::V1beta1::HttpMethod]
+        #     The HTTP method to use for the request. PATCH and OPTIONS are not
+        #     permitted.
+        # @!attribute [rw] app_engine_routing
+        #   @return [::Google::Cloud::Scheduler::V1beta1::AppEngineRouting]
+        #     App Engine Routing setting for the job.
+        # @!attribute [rw] relative_uri
+        #   @return [::String]
+        #     The relative URI.
+        #
+        #     The relative URL must begin with "/" and must be a valid HTTP relative URL.
+        #     It can contain a path, query string arguments, and `#` fragments.
+        #     If the relative URL is empty, then the root path "/" will be used.
+        #     No spaces are allowed, and the maximum length allowed is 2083 characters.
+        # @!attribute [rw] headers
+        #   @return [::Google::Protobuf::Map{::String => ::String}]
+        #     HTTP request headers.
+        #
+        #     This map contains the header field names and values. Headers can be set
+        #     when the job is created.
+        #
+        #     Cloud Scheduler sets some headers to default values:
+        #
+        #     * `User-Agent`: By default, this header is
+        #       `"AppEngine-Google; (+http://code.google.com/appengine)"`.
+        #       This header can be modified, but Cloud Scheduler will append
+        #       `"AppEngine-Google; (+http://code.google.com/appengine)"` to the
+        #       modified `User-Agent`.
+        #     * `X-CloudScheduler`: This header will be set to true.
+        #
+        #     If the job has an {::Google::Cloud::Scheduler::V1beta1::AppEngineHttpTarget#body body}, Cloud Scheduler sets
+        #     the following headers:
+        #
+        #     * `Content-Type`: By default, the `Content-Type` header is set to
+        #       `"application/octet-stream"`. The default can be overridden by explictly
+        #       setting `Content-Type` to a particular media type when the job is
+        #       created.
+        #       For example, `Content-Type` can be set to `"application/json"`.
+        #     * `Content-Length`: This is computed by Cloud Scheduler. This value is
+        #       output only. It cannot be changed.
+        #
+        #     The headers below are output only. They cannot be set or overridden:
+        #
+        #     * `X-Google-*`: For Google internal use only.
+        #     * `X-AppEngine-*`: For Google internal use only.
+        #
+        #     In addition, some App Engine headers, which contain
+        #     job-specific information, are also be sent to the job handler.
+        # @!attribute [rw] body
+        #   @return [::String]
+        #     Body.
+        #
+        #     HTTP request body. A request body is allowed only if the HTTP method is
+        #     POST or PUT. It will result in invalid argument error to set a body on a
+        #     job with an incompatible {::Google::Cloud::Scheduler::V1beta1::HttpMethod HttpMethod}.
+        class AppEngineHttpTarget
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # @!attribute [rw] key
+          #   @return [::String]
+          # @!attribute [rw] value
+          #   @return [::String]
+          class HeadersEntry
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+        end
+
+        # Pub/Sub target. The job will be delivered by publishing a message to
+        # the given Pub/Sub topic.
+        # @!attribute [rw] topic_name
+        #   @return [::String]
+        #     Required. The name of the Cloud Pub/Sub topic to which messages will
+        #     be published when a job is delivered. The topic name must be in the
+        #     same format as required by PubSub's
+        #     [PublishRequest.name](https://cloud.google.com/pubsub/docs/reference/rpc/google.pubsub.v1#publishrequest),
+        #     for example `projects/PROJECT_ID/topics/TOPIC_ID`.
+        #
+        #     The topic must be in the same project as the Cloud Scheduler job.
+        # @!attribute [rw] data
+        #   @return [::String]
+        #     The message payload for PubsubMessage.
+        #
+        #     Pubsub message must contain either non-empty data, or at least one
+        #     attribute.
+        # @!attribute [rw] attributes
+        #   @return [::Google::Protobuf::Map{::String => ::String}]
+        #     Attributes for PubsubMessage.
+        #
+        #     Pubsub message must contain either non-empty data, or at least one
+        #     attribute.
+        class PubsubTarget
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # @!attribute [rw] key
+          #   @return [::String]
+          # @!attribute [rw] value
+          #   @return [::String]
+          class AttributesEntry
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+        end
+
+        # App Engine Routing.
+        #
+        # For more information about services, versions, and instances see
+        # [An Overview of App
+        # Engine](https://cloud.google.com/appengine/docs/python/an-overview-of-app-engine),
+        # [Microservices Architecture on Google App
+        # Engine](https://cloud.google.com/appengine/docs/python/microservices-on-app-engine),
+        # [App Engine Standard request
+        # routing](https://cloud.google.com/appengine/docs/standard/python/how-requests-are-routed),
+        # and [App Engine Flex request
+        # routing](https://cloud.google.com/appengine/docs/flexible/python/how-requests-are-routed).
+        # @!attribute [rw] service
+        #   @return [::String]
+        #     App service.
+        #
+        #     By default, the job is sent to the service which is the default
+        #     service when the job is attempted.
+        # @!attribute [rw] version
+        #   @return [::String]
+        #     App version.
+        #
+        #     By default, the job is sent to the version which is the default
+        #     version when the job is attempted.
+        # @!attribute [rw] instance
+        #   @return [::String]
+        #     App instance.
+        #
+        #     By default, the job is sent to an instance which is available when
+        #     the job is attempted.
+        #
+        #     Requests can only be sent to a specific instance if
+        #     [manual scaling is used in App Engine
+        #     Standard](https://cloud.google.com/appengine/docs/python/an-overview-of-app-engine?hl=en_US#scaling_types_and_instance_classes).
+        #     App Engine Flex does not support instances. For more information, see
+        #     [App Engine Standard request
+        #     routing](https://cloud.google.com/appengine/docs/standard/python/how-requests-are-routed)
+        #     and [App Engine Flex request
+        #     routing](https://cloud.google.com/appengine/docs/flexible/python/how-requests-are-routed).
+        # @!attribute [rw] host
+        #   @return [::String]
+        #     Output only. The host that the job is sent to.
+        #
+        #     For more information about how App Engine requests are routed, see
+        #     [here](https://cloud.google.com/appengine/docs/standard/python/how-requests-are-routed).
+        #
+        #     The host is constructed as:
+        #
+        #
+        #     * `host = [application_domain_name]`</br>
+        #       `| [service] + '.' + [application_domain_name]`</br>
+        #       `| [version] + '.' + [application_domain_name]`</br>
+        #       `| [version_dot_service]+ '.' + [application_domain_name]`</br>
+        #       `| [instance] + '.' + [application_domain_name]`</br>
+        #       `| [instance_dot_service] + '.' + [application_domain_name]`</br>
+        #       `| [instance_dot_version] + '.' + [application_domain_name]`</br>
+        #       `| [instance_dot_version_dot_service] + '.' + [application_domain_name]`
+        #
+        #     * `application_domain_name` = The domain name of the app, for
+        #       example <app-id>.appspot.com, which is associated with the
+        #       job's project ID.
+        #
+        #     * `service =` {::Google::Cloud::Scheduler::V1beta1::AppEngineRouting#service service}
+        #
+        #     * `version =` {::Google::Cloud::Scheduler::V1beta1::AppEngineRouting#version version}
+        #
+        #     * `version_dot_service =`
+        #       {::Google::Cloud::Scheduler::V1beta1::AppEngineRouting#version version} `+ '.' +`
+        #       {::Google::Cloud::Scheduler::V1beta1::AppEngineRouting#service service}
+        #
+        #     * `instance =` {::Google::Cloud::Scheduler::V1beta1::AppEngineRouting#instance instance}
+        #
+        #     * `instance_dot_service =`
+        #       {::Google::Cloud::Scheduler::V1beta1::AppEngineRouting#instance instance} `+ '.' +`
+        #       {::Google::Cloud::Scheduler::V1beta1::AppEngineRouting#service service}
+        #
+        #     * `instance_dot_version =`
+        #       {::Google::Cloud::Scheduler::V1beta1::AppEngineRouting#instance instance} `+ '.' +`
+        #       {::Google::Cloud::Scheduler::V1beta1::AppEngineRouting#version version}
+        #
+        #     * `instance_dot_version_dot_service =`
+        #       {::Google::Cloud::Scheduler::V1beta1::AppEngineRouting#instance instance} `+ '.' +`
+        #       {::Google::Cloud::Scheduler::V1beta1::AppEngineRouting#version version} `+ '.' +`
+        #       {::Google::Cloud::Scheduler::V1beta1::AppEngineRouting#service service}
+        #
+        #
+        #     If {::Google::Cloud::Scheduler::V1beta1::AppEngineRouting#service service} is empty, then the job will be sent
+        #     to the service which is the default service when the job is attempted.
+        #
+        #     If {::Google::Cloud::Scheduler::V1beta1::AppEngineRouting#version version} is empty, then the job will be sent
+        #     to the version which is the default version when the job is attempted.
+        #
+        #     If {::Google::Cloud::Scheduler::V1beta1::AppEngineRouting#instance instance} is empty, then the job will be
+        #     sent to an instance which is available when the job is attempted.
+        #
+        #     If {::Google::Cloud::Scheduler::V1beta1::AppEngineRouting#service service},
+        #     {::Google::Cloud::Scheduler::V1beta1::AppEngineRouting#version version}, or
+        #     {::Google::Cloud::Scheduler::V1beta1::AppEngineRouting#instance instance} is invalid, then the job will be sent
+        #     to the default version of the default service when the job is attempted.
+        class AppEngineRouting
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Contains information needed for generating an
+        # [OAuth token](https://developers.google.com/identity/protocols/OAuth2).
+        # This type of authorization should generally only be used when calling Google
+        # APIs hosted on *.googleapis.com.
+        # @!attribute [rw] service_account_email
+        #   @return [::String]
+        #     [Service account email](https://cloud.google.com/iam/docs/service-accounts)
+        #     to be used for generating OAuth token.
+        #     The service account must be within the same project as the job. The caller
+        #     must have iam.serviceAccounts.actAs permission for the service account.
+        # @!attribute [rw] scope
+        #   @return [::String]
+        #     OAuth scope to be used for generating OAuth access token.
+        #     If not specified, "https://www.googleapis.com/auth/cloud-platform"
+        #     will be used.
+        class OAuthToken
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Contains information needed for generating an
+        # [OpenID Connect
+        # token](https://developers.google.com/identity/protocols/OpenIDConnect).
+        # This type of authorization can be used for many scenarios, including
+        # calling Cloud Run, or endpoints where you intend to validate the token
+        # yourself.
+        # @!attribute [rw] service_account_email
+        #   @return [::String]
+        #     [Service account email](https://cloud.google.com/iam/docs/service-accounts)
+        #     to be used for generating OIDC token.
+        #     The service account must be within the same project as the job. The caller
+        #     must have iam.serviceAccounts.actAs permission for the service account.
+        # @!attribute [rw] audience
+        #   @return [::String]
+        #     Audience to be used when generating OIDC token. If not specified, the URI
+        #     specified in target will be used.
+        class OidcToken
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # The HTTP method used to execute the job.
+        module HttpMethod
+          # HTTP method unspecified. Defaults to POST.
+          HTTP_METHOD_UNSPECIFIED = 0
+
+          # HTTP POST
+          POST = 1
+
+          # HTTP GET
+          GET = 2
+
+          # HTTP HEAD
+          HEAD = 3
+
+          # HTTP PUT
+          PUT = 4
+
+          # HTTP DELETE
+          DELETE = 5
+
+          # HTTP PATCH
+          PATCH = 6
+
+          # HTTP OPTIONS
+          OPTIONS = 7
+        end
+      end
+    end
+  end
+end