docs: update docs (#916)
* fix: re-run script
* test: fix noxfile
diff --git a/docs/dyn/cloudscheduler_v1beta1.projects.locations.jobs.html b/docs/dyn/cloudscheduler_v1beta1.projects.locations.jobs.html
index 6f25992..7ae7e30 100644
--- a/docs/dyn/cloudscheduler_v1beta1.projects.locations.jobs.html
+++ b/docs/dyn/cloudscheduler_v1beta1.projects.locations.jobs.html
@@ -114,6 +114,20 @@
{ # Configuration for a job.
# The maximum allowed size for a job is 100KB.
+ "timeZone": "A String", # Specifies the time zone to be used in interpreting
+ # 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).
+ "description": "A String", # Optionally caller-specified in CreateJob or
+ # UpdateJob.
+ #
+ # A human-readable description for the job. This string must not contain
+ # more than 500 characters.
"appEngineHttpTarget": { # App Engine target. The job will be pushed to a job handler by means # App Engine HTTP target.
# of an HTTP request via an http_method such
# as HTTP POST, HTTP GET, etc. The job is acknowledged by means of an
@@ -179,19 +193,6 @@
# 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).
- "instance": "A 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).
"version": "A String", # App version.
#
# By default, the job is sent to the version which is the default
@@ -258,6 +259,19 @@
#
# By default, the job is sent to the service which is the default
# service when the job is attempted.
+ "instance": "A 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).
},
"httpMethod": "A String", # The HTTP method to use for the request. PATCH and OPTIONS are not
# permitted.
@@ -269,6 +283,9 @@
#
# You can find out more about this error model and how to work with it in the
# [API Design Guide](https://cloud.google.com/apis/design/errors).
+ "message": "A String", # A developer-facing error message, which should be in English. Any
+ # user-facing error message should be localized and sent in the
+ # google.rpc.Status.details field, or localized by the client.
"details": [ # A list of messages that carry the error details. There is a common set of
# message types for APIs to use.
{
@@ -276,9 +293,6 @@
},
],
"code": 42, # The status code, which should be an enum value of google.rpc.Code.
- "message": "A String", # A developer-facing error message, which should be in English. Any
- # user-facing error message should be localized and sent in the
- # google.rpc.Status.details field, or localized by the client.
},
"state": "A String", # Output only. State of the job.
"retryConfig": { # Settings that determine the retry behavior. # Settings that determine the retry behavior.
@@ -286,33 +300,6 @@
# 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 RetryConfig.
- "maxDoublings": 42, # The time between retries will double `max_doublings` times.
- #
- # A job's retry interval starts at
- # min_backoff_duration, then doubles
- # `max_doublings` times, then increases linearly, and finally
- # retries at intervals of
- # max_backoff_duration up to
- # retry_count times.
- #
- # For example, if min_backoff_duration is
- # 10s, 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
- # max_backoff_duration until the job has
- # been attempted 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.
- "maxBackoffDuration": "A String", # The maximum amount of time to wait before retrying a job after
- # it fails.
- #
- # The default value of this field is 1 hour.
- "minBackoffDuration": "A String", # The minimum amount of time to wait before retrying a job after
- # it fails.
- #
- # The default value of this field is 5 seconds.
"maxRetryDuration": "A String", # The time limit for retrying a failed job, measured from time when an
# execution was first attempted. If specified with
# retry_count, the job will be retried until both
@@ -336,6 +323,33 @@
# whichever comes first.
#
# Values greater than 5 and negative values are not allowed.
+ "maxDoublings": 42, # The time between retries will double `max_doublings` times.
+ #
+ # A job's retry interval starts at
+ # min_backoff_duration, then doubles
+ # `max_doublings` times, then increases linearly, and finally
+ # retries at intervals of
+ # max_backoff_duration up to
+ # retry_count times.
+ #
+ # For example, if min_backoff_duration is
+ # 10s, 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
+ # max_backoff_duration until the job has
+ # been attempted 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.
+ "minBackoffDuration": "A String", # The minimum amount of time to wait before retrying a job after
+ # it fails.
+ #
+ # The default value of this field is 5 seconds.
+ "maxBackoffDuration": "A String", # The maximum amount of time to wait before retrying a job after
+ # it fails.
+ #
+ # The default value of this field is 1 hour.
},
"name": "A String", # Optionally caller-specified in CreateJob, after
# which it becomes output only.
@@ -400,27 +414,6 @@
# 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.
- "oidcToken": { # Contains information needed for generating an # 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.
- # [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.
- "audience": "A String", # Audience to be used when generating OIDC token. If not specified, the URI
- # specified in target will be used.
- "serviceAccountEmail": "A 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.
- },
- "httpMethod": "A String", # Which HTTP method to use for the request.
"body": "A 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 HttpMethod.
@@ -465,6 +458,27 @@
# The total size of headers must be less than 80KB.
"a_key": "A String",
},
+ "oidcToken": { # Contains information needed for generating an # 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.
+ # [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.
+ "audience": "A String", # Audience to be used when generating OIDC token. If not specified, the URI
+ # specified in target will be used.
+ "serviceAccountEmail": "A 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.
+ },
+ "httpMethod": "A String", # Which HTTP method to use for the request.
},
"pubsubTarget": { # Pub/Sub target. The job will be delivered by publishing a message to # Pub/Sub target.
# the given Pub/Sub topic.
@@ -486,20 +500,6 @@
# Pubsub message must contain either non-empty data, or at least one
# attribute.
},
- "timeZone": "A String", # Specifies the time zone to be used in interpreting
- # 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).
- "description": "A String", # Optionally caller-specified in CreateJob or
- # UpdateJob.
- #
- # A human-readable description for the job. This string must not contain
- # more than 500 characters.
}
x__xgafv: string, V1 error format.
@@ -512,6 +512,20 @@
{ # Configuration for a job.
# The maximum allowed size for a job is 100KB.
+ "timeZone": "A String", # Specifies the time zone to be used in interpreting
+ # 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).
+ "description": "A String", # Optionally caller-specified in CreateJob or
+ # UpdateJob.
+ #
+ # A human-readable description for the job. This string must not contain
+ # more than 500 characters.
"appEngineHttpTarget": { # App Engine target. The job will be pushed to a job handler by means # App Engine HTTP target.
# of an HTTP request via an http_method such
# as HTTP POST, HTTP GET, etc. The job is acknowledged by means of an
@@ -577,19 +591,6 @@
# 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).
- "instance": "A 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).
"version": "A String", # App version.
#
# By default, the job is sent to the version which is the default
@@ -656,6 +657,19 @@
#
# By default, the job is sent to the service which is the default
# service when the job is attempted.
+ "instance": "A 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).
},
"httpMethod": "A String", # The HTTP method to use for the request. PATCH and OPTIONS are not
# permitted.
@@ -667,6 +681,9 @@
#
# You can find out more about this error model and how to work with it in the
# [API Design Guide](https://cloud.google.com/apis/design/errors).
+ "message": "A String", # A developer-facing error message, which should be in English. Any
+ # user-facing error message should be localized and sent in the
+ # google.rpc.Status.details field, or localized by the client.
"details": [ # A list of messages that carry the error details. There is a common set of
# message types for APIs to use.
{
@@ -674,9 +691,6 @@
},
],
"code": 42, # The status code, which should be an enum value of google.rpc.Code.
- "message": "A String", # A developer-facing error message, which should be in English. Any
- # user-facing error message should be localized and sent in the
- # google.rpc.Status.details field, or localized by the client.
},
"state": "A String", # Output only. State of the job.
"retryConfig": { # Settings that determine the retry behavior. # Settings that determine the retry behavior.
@@ -684,33 +698,6 @@
# 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 RetryConfig.
- "maxDoublings": 42, # The time between retries will double `max_doublings` times.
- #
- # A job's retry interval starts at
- # min_backoff_duration, then doubles
- # `max_doublings` times, then increases linearly, and finally
- # retries at intervals of
- # max_backoff_duration up to
- # retry_count times.
- #
- # For example, if min_backoff_duration is
- # 10s, 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
- # max_backoff_duration until the job has
- # been attempted 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.
- "maxBackoffDuration": "A String", # The maximum amount of time to wait before retrying a job after
- # it fails.
- #
- # The default value of this field is 1 hour.
- "minBackoffDuration": "A String", # The minimum amount of time to wait before retrying a job after
- # it fails.
- #
- # The default value of this field is 5 seconds.
"maxRetryDuration": "A String", # The time limit for retrying a failed job, measured from time when an
# execution was first attempted. If specified with
# retry_count, the job will be retried until both
@@ -734,6 +721,33 @@
# whichever comes first.
#
# Values greater than 5 and negative values are not allowed.
+ "maxDoublings": 42, # The time between retries will double `max_doublings` times.
+ #
+ # A job's retry interval starts at
+ # min_backoff_duration, then doubles
+ # `max_doublings` times, then increases linearly, and finally
+ # retries at intervals of
+ # max_backoff_duration up to
+ # retry_count times.
+ #
+ # For example, if min_backoff_duration is
+ # 10s, 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
+ # max_backoff_duration until the job has
+ # been attempted 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.
+ "minBackoffDuration": "A String", # The minimum amount of time to wait before retrying a job after
+ # it fails.
+ #
+ # The default value of this field is 5 seconds.
+ "maxBackoffDuration": "A String", # The maximum amount of time to wait before retrying a job after
+ # it fails.
+ #
+ # The default value of this field is 1 hour.
},
"name": "A String", # Optionally caller-specified in CreateJob, after
# which it becomes output only.
@@ -798,27 +812,6 @@
# 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.
- "oidcToken": { # Contains information needed for generating an # 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.
- # [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.
- "audience": "A String", # Audience to be used when generating OIDC token. If not specified, the URI
- # specified in target will be used.
- "serviceAccountEmail": "A 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.
- },
- "httpMethod": "A String", # Which HTTP method to use for the request.
"body": "A 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 HttpMethod.
@@ -863,6 +856,27 @@
# The total size of headers must be less than 80KB.
"a_key": "A String",
},
+ "oidcToken": { # Contains information needed for generating an # 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.
+ # [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.
+ "audience": "A String", # Audience to be used when generating OIDC token. If not specified, the URI
+ # specified in target will be used.
+ "serviceAccountEmail": "A 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.
+ },
+ "httpMethod": "A String", # Which HTTP method to use for the request.
},
"pubsubTarget": { # Pub/Sub target. The job will be delivered by publishing a message to # Pub/Sub target.
# the given Pub/Sub topic.
@@ -884,20 +898,6 @@
# Pubsub message must contain either non-empty data, or at least one
# attribute.
},
- "timeZone": "A String", # Specifies the time zone to be used in interpreting
- # 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).
- "description": "A String", # Optionally caller-specified in CreateJob or
- # UpdateJob.
- #
- # A human-readable description for the job. This string must not contain
- # more than 500 characters.
}</pre>
</div>
@@ -945,6 +945,20 @@
{ # Configuration for a job.
# The maximum allowed size for a job is 100KB.
+ "timeZone": "A String", # Specifies the time zone to be used in interpreting
+ # 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).
+ "description": "A String", # Optionally caller-specified in CreateJob or
+ # UpdateJob.
+ #
+ # A human-readable description for the job. This string must not contain
+ # more than 500 characters.
"appEngineHttpTarget": { # App Engine target. The job will be pushed to a job handler by means # App Engine HTTP target.
# of an HTTP request via an http_method such
# as HTTP POST, HTTP GET, etc. The job is acknowledged by means of an
@@ -1010,19 +1024,6 @@
# 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).
- "instance": "A 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).
"version": "A String", # App version.
#
# By default, the job is sent to the version which is the default
@@ -1089,6 +1090,19 @@
#
# By default, the job is sent to the service which is the default
# service when the job is attempted.
+ "instance": "A 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).
},
"httpMethod": "A String", # The HTTP method to use for the request. PATCH and OPTIONS are not
# permitted.
@@ -1100,6 +1114,9 @@
#
# You can find out more about this error model and how to work with it in the
# [API Design Guide](https://cloud.google.com/apis/design/errors).
+ "message": "A String", # A developer-facing error message, which should be in English. Any
+ # user-facing error message should be localized and sent in the
+ # google.rpc.Status.details field, or localized by the client.
"details": [ # A list of messages that carry the error details. There is a common set of
# message types for APIs to use.
{
@@ -1107,9 +1124,6 @@
},
],
"code": 42, # The status code, which should be an enum value of google.rpc.Code.
- "message": "A String", # A developer-facing error message, which should be in English. Any
- # user-facing error message should be localized and sent in the
- # google.rpc.Status.details field, or localized by the client.
},
"state": "A String", # Output only. State of the job.
"retryConfig": { # Settings that determine the retry behavior. # Settings that determine the retry behavior.
@@ -1117,33 +1131,6 @@
# 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 RetryConfig.
- "maxDoublings": 42, # The time between retries will double `max_doublings` times.
- #
- # A job's retry interval starts at
- # min_backoff_duration, then doubles
- # `max_doublings` times, then increases linearly, and finally
- # retries at intervals of
- # max_backoff_duration up to
- # retry_count times.
- #
- # For example, if min_backoff_duration is
- # 10s, 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
- # max_backoff_duration until the job has
- # been attempted 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.
- "maxBackoffDuration": "A String", # The maximum amount of time to wait before retrying a job after
- # it fails.
- #
- # The default value of this field is 1 hour.
- "minBackoffDuration": "A String", # The minimum amount of time to wait before retrying a job after
- # it fails.
- #
- # The default value of this field is 5 seconds.
"maxRetryDuration": "A String", # The time limit for retrying a failed job, measured from time when an
# execution was first attempted. If specified with
# retry_count, the job will be retried until both
@@ -1167,6 +1154,33 @@
# whichever comes first.
#
# Values greater than 5 and negative values are not allowed.
+ "maxDoublings": 42, # The time between retries will double `max_doublings` times.
+ #
+ # A job's retry interval starts at
+ # min_backoff_duration, then doubles
+ # `max_doublings` times, then increases linearly, and finally
+ # retries at intervals of
+ # max_backoff_duration up to
+ # retry_count times.
+ #
+ # For example, if min_backoff_duration is
+ # 10s, 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
+ # max_backoff_duration until the job has
+ # been attempted 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.
+ "minBackoffDuration": "A String", # The minimum amount of time to wait before retrying a job after
+ # it fails.
+ #
+ # The default value of this field is 5 seconds.
+ "maxBackoffDuration": "A String", # The maximum amount of time to wait before retrying a job after
+ # it fails.
+ #
+ # The default value of this field is 1 hour.
},
"name": "A String", # Optionally caller-specified in CreateJob, after
# which it becomes output only.
@@ -1231,27 +1245,6 @@
# 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.
- "oidcToken": { # Contains information needed for generating an # 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.
- # [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.
- "audience": "A String", # Audience to be used when generating OIDC token. If not specified, the URI
- # specified in target will be used.
- "serviceAccountEmail": "A 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.
- },
- "httpMethod": "A String", # Which HTTP method to use for the request.
"body": "A 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 HttpMethod.
@@ -1296,6 +1289,27 @@
# The total size of headers must be less than 80KB.
"a_key": "A String",
},
+ "oidcToken": { # Contains information needed for generating an # 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.
+ # [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.
+ "audience": "A String", # Audience to be used when generating OIDC token. If not specified, the URI
+ # specified in target will be used.
+ "serviceAccountEmail": "A 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.
+ },
+ "httpMethod": "A String", # Which HTTP method to use for the request.
},
"pubsubTarget": { # Pub/Sub target. The job will be delivered by publishing a message to # Pub/Sub target.
# the given Pub/Sub topic.
@@ -1317,20 +1331,6 @@
# Pubsub message must contain either non-empty data, or at least one
# attribute.
},
- "timeZone": "A String", # Specifies the time zone to be used in interpreting
- # 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).
- "description": "A String", # Optionally caller-specified in CreateJob or
- # UpdateJob.
- #
- # A human-readable description for the job. This string must not contain
- # more than 500 characters.
}</pre>
</div>
@@ -1373,6 +1373,20 @@
"jobs": [ # The list of jobs.
{ # Configuration for a job.
# The maximum allowed size for a job is 100KB.
+ "timeZone": "A String", # Specifies the time zone to be used in interpreting
+ # 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).
+ "description": "A String", # Optionally caller-specified in CreateJob or
+ # UpdateJob.
+ #
+ # A human-readable description for the job. This string must not contain
+ # more than 500 characters.
"appEngineHttpTarget": { # App Engine target. The job will be pushed to a job handler by means # App Engine HTTP target.
# of an HTTP request via an http_method such
# as HTTP POST, HTTP GET, etc. The job is acknowledged by means of an
@@ -1438,19 +1452,6 @@
# 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).
- "instance": "A 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).
"version": "A String", # App version.
#
# By default, the job is sent to the version which is the default
@@ -1517,6 +1518,19 @@
#
# By default, the job is sent to the service which is the default
# service when the job is attempted.
+ "instance": "A 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).
},
"httpMethod": "A String", # The HTTP method to use for the request. PATCH and OPTIONS are not
# permitted.
@@ -1528,6 +1542,9 @@
#
# You can find out more about this error model and how to work with it in the
# [API Design Guide](https://cloud.google.com/apis/design/errors).
+ "message": "A String", # A developer-facing error message, which should be in English. Any
+ # user-facing error message should be localized and sent in the
+ # google.rpc.Status.details field, or localized by the client.
"details": [ # A list of messages that carry the error details. There is a common set of
# message types for APIs to use.
{
@@ -1535,9 +1552,6 @@
},
],
"code": 42, # The status code, which should be an enum value of google.rpc.Code.
- "message": "A String", # A developer-facing error message, which should be in English. Any
- # user-facing error message should be localized and sent in the
- # google.rpc.Status.details field, or localized by the client.
},
"state": "A String", # Output only. State of the job.
"retryConfig": { # Settings that determine the retry behavior. # Settings that determine the retry behavior.
@@ -1545,33 +1559,6 @@
# 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 RetryConfig.
- "maxDoublings": 42, # The time between retries will double `max_doublings` times.
- #
- # A job's retry interval starts at
- # min_backoff_duration, then doubles
- # `max_doublings` times, then increases linearly, and finally
- # retries at intervals of
- # max_backoff_duration up to
- # retry_count times.
- #
- # For example, if min_backoff_duration is
- # 10s, 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
- # max_backoff_duration until the job has
- # been attempted 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.
- "maxBackoffDuration": "A String", # The maximum amount of time to wait before retrying a job after
- # it fails.
- #
- # The default value of this field is 1 hour.
- "minBackoffDuration": "A String", # The minimum amount of time to wait before retrying a job after
- # it fails.
- #
- # The default value of this field is 5 seconds.
"maxRetryDuration": "A String", # The time limit for retrying a failed job, measured from time when an
# execution was first attempted. If specified with
# retry_count, the job will be retried until both
@@ -1595,6 +1582,33 @@
# whichever comes first.
#
# Values greater than 5 and negative values are not allowed.
+ "maxDoublings": 42, # The time between retries will double `max_doublings` times.
+ #
+ # A job's retry interval starts at
+ # min_backoff_duration, then doubles
+ # `max_doublings` times, then increases linearly, and finally
+ # retries at intervals of
+ # max_backoff_duration up to
+ # retry_count times.
+ #
+ # For example, if min_backoff_duration is
+ # 10s, 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
+ # max_backoff_duration until the job has
+ # been attempted 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.
+ "minBackoffDuration": "A String", # The minimum amount of time to wait before retrying a job after
+ # it fails.
+ #
+ # The default value of this field is 5 seconds.
+ "maxBackoffDuration": "A String", # The maximum amount of time to wait before retrying a job after
+ # it fails.
+ #
+ # The default value of this field is 1 hour.
},
"name": "A String", # Optionally caller-specified in CreateJob, after
# which it becomes output only.
@@ -1659,27 +1673,6 @@
# 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.
- "oidcToken": { # Contains information needed for generating an # 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.
- # [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.
- "audience": "A String", # Audience to be used when generating OIDC token. If not specified, the URI
- # specified in target will be used.
- "serviceAccountEmail": "A 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.
- },
- "httpMethod": "A String", # Which HTTP method to use for the request.
"body": "A 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 HttpMethod.
@@ -1724,6 +1717,27 @@
# The total size of headers must be less than 80KB.
"a_key": "A String",
},
+ "oidcToken": { # Contains information needed for generating an # 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.
+ # [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.
+ "audience": "A String", # Audience to be used when generating OIDC token. If not specified, the URI
+ # specified in target will be used.
+ "serviceAccountEmail": "A 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.
+ },
+ "httpMethod": "A String", # Which HTTP method to use for the request.
},
"pubsubTarget": { # Pub/Sub target. The job will be delivered by publishing a message to # Pub/Sub target.
# the given Pub/Sub topic.
@@ -1745,20 +1759,6 @@
# Pubsub message must contain either non-empty data, or at least one
# attribute.
},
- "timeZone": "A String", # Specifies the time zone to be used in interpreting
- # 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).
- "description": "A String", # Optionally caller-specified in CreateJob or
- # UpdateJob.
- #
- # A human-readable description for the job. This string must not contain
- # more than 500 characters.
},
],
}</pre>
@@ -1813,6 +1813,20 @@
{ # Configuration for a job.
# The maximum allowed size for a job is 100KB.
+ "timeZone": "A String", # Specifies the time zone to be used in interpreting
+ # 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).
+ "description": "A String", # Optionally caller-specified in CreateJob or
+ # UpdateJob.
+ #
+ # A human-readable description for the job. This string must not contain
+ # more than 500 characters.
"appEngineHttpTarget": { # App Engine target. The job will be pushed to a job handler by means # App Engine HTTP target.
# of an HTTP request via an http_method such
# as HTTP POST, HTTP GET, etc. The job is acknowledged by means of an
@@ -1878,19 +1892,6 @@
# 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).
- "instance": "A 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).
"version": "A String", # App version.
#
# By default, the job is sent to the version which is the default
@@ -1957,6 +1958,19 @@
#
# By default, the job is sent to the service which is the default
# service when the job is attempted.
+ "instance": "A 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).
},
"httpMethod": "A String", # The HTTP method to use for the request. PATCH and OPTIONS are not
# permitted.
@@ -1968,6 +1982,9 @@
#
# You can find out more about this error model and how to work with it in the
# [API Design Guide](https://cloud.google.com/apis/design/errors).
+ "message": "A String", # A developer-facing error message, which should be in English. Any
+ # user-facing error message should be localized and sent in the
+ # google.rpc.Status.details field, or localized by the client.
"details": [ # A list of messages that carry the error details. There is a common set of
# message types for APIs to use.
{
@@ -1975,9 +1992,6 @@
},
],
"code": 42, # The status code, which should be an enum value of google.rpc.Code.
- "message": "A String", # A developer-facing error message, which should be in English. Any
- # user-facing error message should be localized and sent in the
- # google.rpc.Status.details field, or localized by the client.
},
"state": "A String", # Output only. State of the job.
"retryConfig": { # Settings that determine the retry behavior. # Settings that determine the retry behavior.
@@ -1985,33 +1999,6 @@
# 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 RetryConfig.
- "maxDoublings": 42, # The time between retries will double `max_doublings` times.
- #
- # A job's retry interval starts at
- # min_backoff_duration, then doubles
- # `max_doublings` times, then increases linearly, and finally
- # retries at intervals of
- # max_backoff_duration up to
- # retry_count times.
- #
- # For example, if min_backoff_duration is
- # 10s, 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
- # max_backoff_duration until the job has
- # been attempted 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.
- "maxBackoffDuration": "A String", # The maximum amount of time to wait before retrying a job after
- # it fails.
- #
- # The default value of this field is 1 hour.
- "minBackoffDuration": "A String", # The minimum amount of time to wait before retrying a job after
- # it fails.
- #
- # The default value of this field is 5 seconds.
"maxRetryDuration": "A String", # The time limit for retrying a failed job, measured from time when an
# execution was first attempted. If specified with
# retry_count, the job will be retried until both
@@ -2035,6 +2022,33 @@
# whichever comes first.
#
# Values greater than 5 and negative values are not allowed.
+ "maxDoublings": 42, # The time between retries will double `max_doublings` times.
+ #
+ # A job's retry interval starts at
+ # min_backoff_duration, then doubles
+ # `max_doublings` times, then increases linearly, and finally
+ # retries at intervals of
+ # max_backoff_duration up to
+ # retry_count times.
+ #
+ # For example, if min_backoff_duration is
+ # 10s, 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
+ # max_backoff_duration until the job has
+ # been attempted 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.
+ "minBackoffDuration": "A String", # The minimum amount of time to wait before retrying a job after
+ # it fails.
+ #
+ # The default value of this field is 5 seconds.
+ "maxBackoffDuration": "A String", # The maximum amount of time to wait before retrying a job after
+ # it fails.
+ #
+ # The default value of this field is 1 hour.
},
"name": "A String", # Optionally caller-specified in CreateJob, after
# which it becomes output only.
@@ -2099,27 +2113,6 @@
# 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.
- "oidcToken": { # Contains information needed for generating an # 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.
- # [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.
- "audience": "A String", # Audience to be used when generating OIDC token. If not specified, the URI
- # specified in target will be used.
- "serviceAccountEmail": "A 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.
- },
- "httpMethod": "A String", # Which HTTP method to use for the request.
"body": "A 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 HttpMethod.
@@ -2164,6 +2157,27 @@
# The total size of headers must be less than 80KB.
"a_key": "A String",
},
+ "oidcToken": { # Contains information needed for generating an # 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.
+ # [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.
+ "audience": "A String", # Audience to be used when generating OIDC token. If not specified, the URI
+ # specified in target will be used.
+ "serviceAccountEmail": "A 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.
+ },
+ "httpMethod": "A String", # Which HTTP method to use for the request.
},
"pubsubTarget": { # Pub/Sub target. The job will be delivered by publishing a message to # Pub/Sub target.
# the given Pub/Sub topic.
@@ -2185,20 +2199,6 @@
# Pubsub message must contain either non-empty data, or at least one
# attribute.
},
- "timeZone": "A String", # Specifies the time zone to be used in interpreting
- # 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).
- "description": "A String", # Optionally caller-specified in CreateJob or
- # UpdateJob.
- #
- # A human-readable description for the job. This string must not contain
- # more than 500 characters.
}
updateMask: string, A mask used to specify which fields of the job are being updated.
@@ -2212,6 +2212,20 @@
{ # Configuration for a job.
# The maximum allowed size for a job is 100KB.
+ "timeZone": "A String", # Specifies the time zone to be used in interpreting
+ # 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).
+ "description": "A String", # Optionally caller-specified in CreateJob or
+ # UpdateJob.
+ #
+ # A human-readable description for the job. This string must not contain
+ # more than 500 characters.
"appEngineHttpTarget": { # App Engine target. The job will be pushed to a job handler by means # App Engine HTTP target.
# of an HTTP request via an http_method such
# as HTTP POST, HTTP GET, etc. The job is acknowledged by means of an
@@ -2277,19 +2291,6 @@
# 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).
- "instance": "A 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).
"version": "A String", # App version.
#
# By default, the job is sent to the version which is the default
@@ -2356,6 +2357,19 @@
#
# By default, the job is sent to the service which is the default
# service when the job is attempted.
+ "instance": "A 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).
},
"httpMethod": "A String", # The HTTP method to use for the request. PATCH and OPTIONS are not
# permitted.
@@ -2367,6 +2381,9 @@
#
# You can find out more about this error model and how to work with it in the
# [API Design Guide](https://cloud.google.com/apis/design/errors).
+ "message": "A String", # A developer-facing error message, which should be in English. Any
+ # user-facing error message should be localized and sent in the
+ # google.rpc.Status.details field, or localized by the client.
"details": [ # A list of messages that carry the error details. There is a common set of
# message types for APIs to use.
{
@@ -2374,9 +2391,6 @@
},
],
"code": 42, # The status code, which should be an enum value of google.rpc.Code.
- "message": "A String", # A developer-facing error message, which should be in English. Any
- # user-facing error message should be localized and sent in the
- # google.rpc.Status.details field, or localized by the client.
},
"state": "A String", # Output only. State of the job.
"retryConfig": { # Settings that determine the retry behavior. # Settings that determine the retry behavior.
@@ -2384,33 +2398,6 @@
# 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 RetryConfig.
- "maxDoublings": 42, # The time between retries will double `max_doublings` times.
- #
- # A job's retry interval starts at
- # min_backoff_duration, then doubles
- # `max_doublings` times, then increases linearly, and finally
- # retries at intervals of
- # max_backoff_duration up to
- # retry_count times.
- #
- # For example, if min_backoff_duration is
- # 10s, 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
- # max_backoff_duration until the job has
- # been attempted 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.
- "maxBackoffDuration": "A String", # The maximum amount of time to wait before retrying a job after
- # it fails.
- #
- # The default value of this field is 1 hour.
- "minBackoffDuration": "A String", # The minimum amount of time to wait before retrying a job after
- # it fails.
- #
- # The default value of this field is 5 seconds.
"maxRetryDuration": "A String", # The time limit for retrying a failed job, measured from time when an
# execution was first attempted. If specified with
# retry_count, the job will be retried until both
@@ -2434,6 +2421,33 @@
# whichever comes first.
#
# Values greater than 5 and negative values are not allowed.
+ "maxDoublings": 42, # The time between retries will double `max_doublings` times.
+ #
+ # A job's retry interval starts at
+ # min_backoff_duration, then doubles
+ # `max_doublings` times, then increases linearly, and finally
+ # retries at intervals of
+ # max_backoff_duration up to
+ # retry_count times.
+ #
+ # For example, if min_backoff_duration is
+ # 10s, 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
+ # max_backoff_duration until the job has
+ # been attempted 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.
+ "minBackoffDuration": "A String", # The minimum amount of time to wait before retrying a job after
+ # it fails.
+ #
+ # The default value of this field is 5 seconds.
+ "maxBackoffDuration": "A String", # The maximum amount of time to wait before retrying a job after
+ # it fails.
+ #
+ # The default value of this field is 1 hour.
},
"name": "A String", # Optionally caller-specified in CreateJob, after
# which it becomes output only.
@@ -2498,27 +2512,6 @@
# 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.
- "oidcToken": { # Contains information needed for generating an # 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.
- # [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.
- "audience": "A String", # Audience to be used when generating OIDC token. If not specified, the URI
- # specified in target will be used.
- "serviceAccountEmail": "A 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.
- },
- "httpMethod": "A String", # Which HTTP method to use for the request.
"body": "A 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 HttpMethod.
@@ -2563,6 +2556,27 @@
# The total size of headers must be less than 80KB.
"a_key": "A String",
},
+ "oidcToken": { # Contains information needed for generating an # 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.
+ # [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.
+ "audience": "A String", # Audience to be used when generating OIDC token. If not specified, the URI
+ # specified in target will be used.
+ "serviceAccountEmail": "A 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.
+ },
+ "httpMethod": "A String", # Which HTTP method to use for the request.
},
"pubsubTarget": { # Pub/Sub target. The job will be delivered by publishing a message to # Pub/Sub target.
# the given Pub/Sub topic.
@@ -2584,20 +2598,6 @@
# Pubsub message must contain either non-empty data, or at least one
# attribute.
},
- "timeZone": "A String", # Specifies the time zone to be used in interpreting
- # 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).
- "description": "A String", # Optionally caller-specified in CreateJob or
- # UpdateJob.
- #
- # A human-readable description for the job. This string must not contain
- # more than 500 characters.
}</pre>
</div>
@@ -2630,6 +2630,20 @@
{ # Configuration for a job.
# The maximum allowed size for a job is 100KB.
+ "timeZone": "A String", # Specifies the time zone to be used in interpreting
+ # 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).
+ "description": "A String", # Optionally caller-specified in CreateJob or
+ # UpdateJob.
+ #
+ # A human-readable description for the job. This string must not contain
+ # more than 500 characters.
"appEngineHttpTarget": { # App Engine target. The job will be pushed to a job handler by means # App Engine HTTP target.
# of an HTTP request via an http_method such
# as HTTP POST, HTTP GET, etc. The job is acknowledged by means of an
@@ -2695,19 +2709,6 @@
# 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).
- "instance": "A 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).
"version": "A String", # App version.
#
# By default, the job is sent to the version which is the default
@@ -2774,6 +2775,19 @@
#
# By default, the job is sent to the service which is the default
# service when the job is attempted.
+ "instance": "A 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).
},
"httpMethod": "A String", # The HTTP method to use for the request. PATCH and OPTIONS are not
# permitted.
@@ -2785,6 +2799,9 @@
#
# You can find out more about this error model and how to work with it in the
# [API Design Guide](https://cloud.google.com/apis/design/errors).
+ "message": "A String", # A developer-facing error message, which should be in English. Any
+ # user-facing error message should be localized and sent in the
+ # google.rpc.Status.details field, or localized by the client.
"details": [ # A list of messages that carry the error details. There is a common set of
# message types for APIs to use.
{
@@ -2792,9 +2809,6 @@
},
],
"code": 42, # The status code, which should be an enum value of google.rpc.Code.
- "message": "A String", # A developer-facing error message, which should be in English. Any
- # user-facing error message should be localized and sent in the
- # google.rpc.Status.details field, or localized by the client.
},
"state": "A String", # Output only. State of the job.
"retryConfig": { # Settings that determine the retry behavior. # Settings that determine the retry behavior.
@@ -2802,33 +2816,6 @@
# 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 RetryConfig.
- "maxDoublings": 42, # The time between retries will double `max_doublings` times.
- #
- # A job's retry interval starts at
- # min_backoff_duration, then doubles
- # `max_doublings` times, then increases linearly, and finally
- # retries at intervals of
- # max_backoff_duration up to
- # retry_count times.
- #
- # For example, if min_backoff_duration is
- # 10s, 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
- # max_backoff_duration until the job has
- # been attempted 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.
- "maxBackoffDuration": "A String", # The maximum amount of time to wait before retrying a job after
- # it fails.
- #
- # The default value of this field is 1 hour.
- "minBackoffDuration": "A String", # The minimum amount of time to wait before retrying a job after
- # it fails.
- #
- # The default value of this field is 5 seconds.
"maxRetryDuration": "A String", # The time limit for retrying a failed job, measured from time when an
# execution was first attempted. If specified with
# retry_count, the job will be retried until both
@@ -2852,6 +2839,33 @@
# whichever comes first.
#
# Values greater than 5 and negative values are not allowed.
+ "maxDoublings": 42, # The time between retries will double `max_doublings` times.
+ #
+ # A job's retry interval starts at
+ # min_backoff_duration, then doubles
+ # `max_doublings` times, then increases linearly, and finally
+ # retries at intervals of
+ # max_backoff_duration up to
+ # retry_count times.
+ #
+ # For example, if min_backoff_duration is
+ # 10s, 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
+ # max_backoff_duration until the job has
+ # been attempted 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.
+ "minBackoffDuration": "A String", # The minimum amount of time to wait before retrying a job after
+ # it fails.
+ #
+ # The default value of this field is 5 seconds.
+ "maxBackoffDuration": "A String", # The maximum amount of time to wait before retrying a job after
+ # it fails.
+ #
+ # The default value of this field is 1 hour.
},
"name": "A String", # Optionally caller-specified in CreateJob, after
# which it becomes output only.
@@ -2916,27 +2930,6 @@
# 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.
- "oidcToken": { # Contains information needed for generating an # 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.
- # [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.
- "audience": "A String", # Audience to be used when generating OIDC token. If not specified, the URI
- # specified in target will be used.
- "serviceAccountEmail": "A 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.
- },
- "httpMethod": "A String", # Which HTTP method to use for the request.
"body": "A 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 HttpMethod.
@@ -2981,6 +2974,27 @@
# The total size of headers must be less than 80KB.
"a_key": "A String",
},
+ "oidcToken": { # Contains information needed for generating an # 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.
+ # [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.
+ "audience": "A String", # Audience to be used when generating OIDC token. If not specified, the URI
+ # specified in target will be used.
+ "serviceAccountEmail": "A 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.
+ },
+ "httpMethod": "A String", # Which HTTP method to use for the request.
},
"pubsubTarget": { # Pub/Sub target. The job will be delivered by publishing a message to # Pub/Sub target.
# the given Pub/Sub topic.
@@ -3002,20 +3016,6 @@
# Pubsub message must contain either non-empty data, or at least one
# attribute.
},
- "timeZone": "A String", # Specifies the time zone to be used in interpreting
- # 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).
- "description": "A String", # Optionally caller-specified in CreateJob or
- # UpdateJob.
- #
- # A human-readable description for the job. This string must not contain
- # more than 500 characters.
}</pre>
</div>
@@ -3047,6 +3047,20 @@
{ # Configuration for a job.
# The maximum allowed size for a job is 100KB.
+ "timeZone": "A String", # Specifies the time zone to be used in interpreting
+ # 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).
+ "description": "A String", # Optionally caller-specified in CreateJob or
+ # UpdateJob.
+ #
+ # A human-readable description for the job. This string must not contain
+ # more than 500 characters.
"appEngineHttpTarget": { # App Engine target. The job will be pushed to a job handler by means # App Engine HTTP target.
# of an HTTP request via an http_method such
# as HTTP POST, HTTP GET, etc. The job is acknowledged by means of an
@@ -3112,19 +3126,6 @@
# 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).
- "instance": "A 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).
"version": "A String", # App version.
#
# By default, the job is sent to the version which is the default
@@ -3191,6 +3192,19 @@
#
# By default, the job is sent to the service which is the default
# service when the job is attempted.
+ "instance": "A 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).
},
"httpMethod": "A String", # The HTTP method to use for the request. PATCH and OPTIONS are not
# permitted.
@@ -3202,6 +3216,9 @@
#
# You can find out more about this error model and how to work with it in the
# [API Design Guide](https://cloud.google.com/apis/design/errors).
+ "message": "A String", # A developer-facing error message, which should be in English. Any
+ # user-facing error message should be localized and sent in the
+ # google.rpc.Status.details field, or localized by the client.
"details": [ # A list of messages that carry the error details. There is a common set of
# message types for APIs to use.
{
@@ -3209,9 +3226,6 @@
},
],
"code": 42, # The status code, which should be an enum value of google.rpc.Code.
- "message": "A String", # A developer-facing error message, which should be in English. Any
- # user-facing error message should be localized and sent in the
- # google.rpc.Status.details field, or localized by the client.
},
"state": "A String", # Output only. State of the job.
"retryConfig": { # Settings that determine the retry behavior. # Settings that determine the retry behavior.
@@ -3219,33 +3233,6 @@
# 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 RetryConfig.
- "maxDoublings": 42, # The time between retries will double `max_doublings` times.
- #
- # A job's retry interval starts at
- # min_backoff_duration, then doubles
- # `max_doublings` times, then increases linearly, and finally
- # retries at intervals of
- # max_backoff_duration up to
- # retry_count times.
- #
- # For example, if min_backoff_duration is
- # 10s, 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
- # max_backoff_duration until the job has
- # been attempted 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.
- "maxBackoffDuration": "A String", # The maximum amount of time to wait before retrying a job after
- # it fails.
- #
- # The default value of this field is 1 hour.
- "minBackoffDuration": "A String", # The minimum amount of time to wait before retrying a job after
- # it fails.
- #
- # The default value of this field is 5 seconds.
"maxRetryDuration": "A String", # The time limit for retrying a failed job, measured from time when an
# execution was first attempted. If specified with
# retry_count, the job will be retried until both
@@ -3269,6 +3256,33 @@
# whichever comes first.
#
# Values greater than 5 and negative values are not allowed.
+ "maxDoublings": 42, # The time between retries will double `max_doublings` times.
+ #
+ # A job's retry interval starts at
+ # min_backoff_duration, then doubles
+ # `max_doublings` times, then increases linearly, and finally
+ # retries at intervals of
+ # max_backoff_duration up to
+ # retry_count times.
+ #
+ # For example, if min_backoff_duration is
+ # 10s, 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
+ # max_backoff_duration until the job has
+ # been attempted 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.
+ "minBackoffDuration": "A String", # The minimum amount of time to wait before retrying a job after
+ # it fails.
+ #
+ # The default value of this field is 5 seconds.
+ "maxBackoffDuration": "A String", # The maximum amount of time to wait before retrying a job after
+ # it fails.
+ #
+ # The default value of this field is 1 hour.
},
"name": "A String", # Optionally caller-specified in CreateJob, after
# which it becomes output only.
@@ -3333,27 +3347,6 @@
# 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.
- "oidcToken": { # Contains information needed for generating an # 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.
- # [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.
- "audience": "A String", # Audience to be used when generating OIDC token. If not specified, the URI
- # specified in target will be used.
- "serviceAccountEmail": "A 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.
- },
- "httpMethod": "A String", # Which HTTP method to use for the request.
"body": "A 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 HttpMethod.
@@ -3398,6 +3391,27 @@
# The total size of headers must be less than 80KB.
"a_key": "A String",
},
+ "oidcToken": { # Contains information needed for generating an # 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.
+ # [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.
+ "audience": "A String", # Audience to be used when generating OIDC token. If not specified, the URI
+ # specified in target will be used.
+ "serviceAccountEmail": "A 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.
+ },
+ "httpMethod": "A String", # Which HTTP method to use for the request.
},
"pubsubTarget": { # Pub/Sub target. The job will be delivered by publishing a message to # Pub/Sub target.
# the given Pub/Sub topic.
@@ -3419,20 +3433,6 @@
# Pubsub message must contain either non-empty data, or at least one
# attribute.
},
- "timeZone": "A String", # Specifies the time zone to be used in interpreting
- # 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).
- "description": "A String", # Optionally caller-specified in CreateJob or
- # UpdateJob.
- #
- # A human-readable description for the job. This string must not contain
- # more than 500 characters.
}</pre>
</div>
@@ -3463,6 +3463,20 @@
{ # Configuration for a job.
# The maximum allowed size for a job is 100KB.
+ "timeZone": "A String", # Specifies the time zone to be used in interpreting
+ # 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).
+ "description": "A String", # Optionally caller-specified in CreateJob or
+ # UpdateJob.
+ #
+ # A human-readable description for the job. This string must not contain
+ # more than 500 characters.
"appEngineHttpTarget": { # App Engine target. The job will be pushed to a job handler by means # App Engine HTTP target.
# of an HTTP request via an http_method such
# as HTTP POST, HTTP GET, etc. The job is acknowledged by means of an
@@ -3528,19 +3542,6 @@
# 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).
- "instance": "A 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).
"version": "A String", # App version.
#
# By default, the job is sent to the version which is the default
@@ -3607,6 +3608,19 @@
#
# By default, the job is sent to the service which is the default
# service when the job is attempted.
+ "instance": "A 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).
},
"httpMethod": "A String", # The HTTP method to use for the request. PATCH and OPTIONS are not
# permitted.
@@ -3618,6 +3632,9 @@
#
# You can find out more about this error model and how to work with it in the
# [API Design Guide](https://cloud.google.com/apis/design/errors).
+ "message": "A String", # A developer-facing error message, which should be in English. Any
+ # user-facing error message should be localized and sent in the
+ # google.rpc.Status.details field, or localized by the client.
"details": [ # A list of messages that carry the error details. There is a common set of
# message types for APIs to use.
{
@@ -3625,9 +3642,6 @@
},
],
"code": 42, # The status code, which should be an enum value of google.rpc.Code.
- "message": "A String", # A developer-facing error message, which should be in English. Any
- # user-facing error message should be localized and sent in the
- # google.rpc.Status.details field, or localized by the client.
},
"state": "A String", # Output only. State of the job.
"retryConfig": { # Settings that determine the retry behavior. # Settings that determine the retry behavior.
@@ -3635,33 +3649,6 @@
# 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 RetryConfig.
- "maxDoublings": 42, # The time between retries will double `max_doublings` times.
- #
- # A job's retry interval starts at
- # min_backoff_duration, then doubles
- # `max_doublings` times, then increases linearly, and finally
- # retries at intervals of
- # max_backoff_duration up to
- # retry_count times.
- #
- # For example, if min_backoff_duration is
- # 10s, 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
- # max_backoff_duration until the job has
- # been attempted 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.
- "maxBackoffDuration": "A String", # The maximum amount of time to wait before retrying a job after
- # it fails.
- #
- # The default value of this field is 1 hour.
- "minBackoffDuration": "A String", # The minimum amount of time to wait before retrying a job after
- # it fails.
- #
- # The default value of this field is 5 seconds.
"maxRetryDuration": "A String", # The time limit for retrying a failed job, measured from time when an
# execution was first attempted. If specified with
# retry_count, the job will be retried until both
@@ -3685,6 +3672,33 @@
# whichever comes first.
#
# Values greater than 5 and negative values are not allowed.
+ "maxDoublings": 42, # The time between retries will double `max_doublings` times.
+ #
+ # A job's retry interval starts at
+ # min_backoff_duration, then doubles
+ # `max_doublings` times, then increases linearly, and finally
+ # retries at intervals of
+ # max_backoff_duration up to
+ # retry_count times.
+ #
+ # For example, if min_backoff_duration is
+ # 10s, 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
+ # max_backoff_duration until the job has
+ # been attempted 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.
+ "minBackoffDuration": "A String", # The minimum amount of time to wait before retrying a job after
+ # it fails.
+ #
+ # The default value of this field is 5 seconds.
+ "maxBackoffDuration": "A String", # The maximum amount of time to wait before retrying a job after
+ # it fails.
+ #
+ # The default value of this field is 1 hour.
},
"name": "A String", # Optionally caller-specified in CreateJob, after
# which it becomes output only.
@@ -3749,27 +3763,6 @@
# 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.
- "oidcToken": { # Contains information needed for generating an # 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.
- # [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.
- "audience": "A String", # Audience to be used when generating OIDC token. If not specified, the URI
- # specified in target will be used.
- "serviceAccountEmail": "A 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.
- },
- "httpMethod": "A String", # Which HTTP method to use for the request.
"body": "A 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 HttpMethod.
@@ -3814,6 +3807,27 @@
# The total size of headers must be less than 80KB.
"a_key": "A String",
},
+ "oidcToken": { # Contains information needed for generating an # 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.
+ # [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.
+ "audience": "A String", # Audience to be used when generating OIDC token. If not specified, the URI
+ # specified in target will be used.
+ "serviceAccountEmail": "A 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.
+ },
+ "httpMethod": "A String", # Which HTTP method to use for the request.
},
"pubsubTarget": { # Pub/Sub target. The job will be delivered by publishing a message to # Pub/Sub target.
# the given Pub/Sub topic.
@@ -3835,20 +3849,6 @@
# Pubsub message must contain either non-empty data, or at least one
# attribute.
},
- "timeZone": "A String", # Specifies the time zone to be used in interpreting
- # 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).
- "description": "A String", # Optionally caller-specified in CreateJob or
- # UpdateJob.
- #
- # A human-readable description for the job. This string must not contain
- # more than 500 characters.
}</pre>
</div>