Skip to content
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.

Commit fe0bcad

Browse files
committedSep 18, 2023
feat(cloudtasks): update the api
#### cloudtasks:v2beta2 The following keys were added: - resources.projects.resources.locations.methods.getCmekConfig (Total Keys: 11) - resources.projects.resources.locations.methods.updateCmekConfig (Total Keys: 17) - schemas.CmekConfig (Total Keys: 5)
1 parent c9d14b9 commit fe0bcad

9 files changed

+243
-108
lines changed
 

‎docs/dyn/cloudtasks_v2.projects.locations.queues.html

+30-30
Large diffs are not rendered by default.

‎docs/dyn/cloudtasks_v2.projects.locations.queues.tasks.html

+5-5
Large diffs are not rendered by default.

‎docs/dyn/cloudtasks_v2beta2.projects.locations.html

+56
Original file line numberDiff line numberDiff line change
@@ -85,12 +85,18 @@ <h2>Instance Methods</h2>
8585
<p class="toc_element">
8686
<code><a href="#get">get(name, x__xgafv=None)</a></code></p>
8787
<p class="firstline">Gets information about a location.</p>
88+
<p class="toc_element">
89+
<code><a href="#getCmekConfig">getCmekConfig(name, x__xgafv=None)</a></code></p>
90+
<p class="firstline">Gets the CMEK config. Gets the Customer Managed Encryption Key configured with the Cloud Tasks lcoation. By default there is no kms_key configured.</p>
8891
<p class="toc_element">
8992
<code><a href="#list">list(name, filter=None, pageSize=None, pageToken=None, x__xgafv=None)</a></code></p>
9093
<p class="firstline">Lists information about the supported locations for this service.</p>
9194
<p class="toc_element">
9295
<code><a href="#list_next">list_next()</a></code></p>
9396
<p class="firstline">Retrieves the next page of results.</p>
97+
<p class="toc_element">
98+
<code><a href="#updateCmekConfig">updateCmekConfig(projectsId, locationsId, body=None, updateMask=None, x__xgafv=None)</a></code></p>
99+
<p class="firstline">Creates or Updates a CMEK config. Updates the Customer Managed Encryption Key assotiated with the Cloud Tasks location (Creates if the key does not already exist). All new tasks created in the location will be encrypted at-rest with the KMS-key provided in the config.</p>
94100
<h3>Method Details</h3>
95101
<div class="method">
96102
<code class="details" id="close">close()</code>
@@ -124,6 +130,26 @@ <h3>Method Details</h3>
124130
}</pre>
125131
</div>
126132

133+
<div class="method">
134+
<code class="details" id="getCmekConfig">getCmekConfig(name, x__xgafv=None)</code>
135+
<pre>Gets the CMEK config. Gets the Customer Managed Encryption Key configured with the Cloud Tasks lcoation. By default there is no kms_key configured.
136+
137+
Args:
138+
name: string, Required. The config. For example: projects/PROJECT_ID/locations/LOCATION_ID/CmekConfig` (required)
139+
x__xgafv: string, V1 error format.
140+
Allowed values
141+
1 - v1 error format
142+
2 - v2 error format
143+
144+
Returns:
145+
An object of the form:
146+
147+
{ # CMEK, or Customer Managed Encryption Keys, enables GCP products to put control over encryption and key management in their customer’s hands.
148+
&quot;kmsKey&quot;: &quot;A String&quot;, # Resource name of the Cloud KMS key, of the form `projects/PROJECT_ID/locations/LOCATION_ID/keyRings/KEY_RING_ID/cryptoKeys/KEY_ID`, that will be used to encrypt the Queues &amp; Tasks in the region. Setting this as blank will turn off CMEK encryption.
149+
&quot;name&quot;: &quot;A String&quot;, # Output only. The config resource name which includes the project and location and must end in &#x27;cmekConfig&#x27;, in the format projects/PROJECT_ID/locations/LOCATION_ID/cmekConfig`
150+
}</pre>
151+
</div>
152+
127153
<div class="method">
128154
<code class="details" id="list">list(name, filter=None, pageSize=None, pageToken=None, x__xgafv=None)</code>
129155
<pre>Lists information about the supported locations for this service.
@@ -173,4 +199,34 @@ <h3>Method Details</h3>
173199
</pre>
174200
</div>
175201

202+
<div class="method">
203+
<code class="details" id="updateCmekConfig">updateCmekConfig(projectsId, locationsId, body=None, updateMask=None, x__xgafv=None)</code>
204+
<pre>Creates or Updates a CMEK config. Updates the Customer Managed Encryption Key assotiated with the Cloud Tasks location (Creates if the key does not already exist). All new tasks created in the location will be encrypted at-rest with the KMS-key provided in the config.
205+
206+
Args:
207+
projectsId: string, A parameter (required)
208+
locationsId: string, A parameter (required)
209+
body: object, The request body.
210+
The object takes the form of:
211+
212+
{ # CMEK, or Customer Managed Encryption Keys, enables GCP products to put control over encryption and key management in their customer’s hands.
213+
&quot;kmsKey&quot;: &quot;A String&quot;, # Resource name of the Cloud KMS key, of the form `projects/PROJECT_ID/locations/LOCATION_ID/keyRings/KEY_RING_ID/cryptoKeys/KEY_ID`, that will be used to encrypt the Queues &amp; Tasks in the region. Setting this as blank will turn off CMEK encryption.
214+
&quot;name&quot;: &quot;A String&quot;, # Output only. The config resource name which includes the project and location and must end in &#x27;cmekConfig&#x27;, in the format projects/PROJECT_ID/locations/LOCATION_ID/cmekConfig`
215+
}
216+
217+
updateMask: string, List of fields to be updated in this request.
218+
x__xgafv: string, V1 error format.
219+
Allowed values
220+
1 - v1 error format
221+
2 - v2 error format
222+
223+
Returns:
224+
An object of the form:
225+
226+
{ # CMEK, or Customer Managed Encryption Keys, enables GCP products to put control over encryption and key management in their customer’s hands.
227+
&quot;kmsKey&quot;: &quot;A String&quot;, # Resource name of the Cloud KMS key, of the form `projects/PROJECT_ID/locations/LOCATION_ID/keyRings/KEY_RING_ID/cryptoKeys/KEY_ID`, that will be used to encrypt the Queues &amp; Tasks in the region. Setting this as blank will turn off CMEK encryption.
228+
&quot;name&quot;: &quot;A String&quot;, # Output only. The config resource name which includes the project and location and must end in &#x27;cmekConfig&#x27;, in the format projects/PROJECT_ID/locations/LOCATION_ID/cmekConfig`
229+
}</pre>
230+
</div>
231+
176232
</body></html>

‎docs/dyn/cloudtasks_v2beta2.projects.locations.queues.html

+5-5
Large diffs are not rendered by default.

‎docs/dyn/cloudtasks_v2beta3.projects.locations.queues.html

+48-48
Large diffs are not rendered by default.

‎docs/dyn/cloudtasks_v2beta3.projects.locations.queues.tasks.html

+6-6
Large diffs are not rendered by default.

‎googleapiclient/discovery_cache/documents/cloudtasks.v2.json

+5-5
Original file line numberDiff line numberDiff line change
@@ -685,7 +685,7 @@
685685
}
686686
}
687687
},
688-
"revision": "20230809",
688+
"revision": "20230906",
689689
"rootUrl": "https://cloudtasks.googleapis.com/",
690690
"schemas": {
691691
"AppEngineHttpRequest": {
@@ -1182,7 +1182,7 @@
11821182
"type": "integer"
11831183
},
11841184
"maxBackoff": {
1185-
"description": "A task will be scheduled for retry between min_backoff and max_backoff duration after it fails, if the queue's RetryConfig specifies that the task should be retried. If unspecified when the queue is created, Cloud Tasks will pick the default. `max_backoff` will be truncated to the nearest second. This field has the same meaning as [max_backoff_seconds in queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/python/config/queueref#retry_parameters).",
1185+
"description": "A task will be scheduled for retry between min_backoff and max_backoff duration after it fails, if the queue's RetryConfig specifies that the task should be retried. If unspecified when the queue is created, Cloud Tasks will pick the default. The value must be given as a string that indicates the length of time (in seconds) followed by `s` (for \"seconds\"). For more information on the format, see the documentation for [Duration](https://protobuf.dev/reference/protobuf/google.protobuf/#duration). `max_backoff` will be truncated to the nearest second. This field has the same meaning as [max_backoff_seconds in queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/python/config/queueref#retry_parameters).",
11861186
"format": "google-duration",
11871187
"type": "string"
11881188
},
@@ -1192,12 +1192,12 @@
11921192
"type": "integer"
11931193
},
11941194
"maxRetryDuration": {
1195-
"description": "If positive, `max_retry_duration` specifies the time limit for retrying a failed task, measured from when the task was first attempted. Once `max_retry_duration` time has passed *and* the task has been attempted max_attempts times, no further attempts will be made and the task will be deleted. If zero, then the task age is unlimited. If unspecified when the queue is created, Cloud Tasks will pick the default. `max_retry_duration` will be truncated to the nearest second. This field has the same meaning as [task_age_limit in queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/python/config/queueref#retry_parameters).",
1195+
"description": "If positive, `max_retry_duration` specifies the time limit for retrying a failed task, measured from when the task was first attempted. Once `max_retry_duration` time has passed *and* the task has been attempted max_attempts times, no further attempts will be made and the task will be deleted. If zero, then the task age is unlimited. If unspecified when the queue is created, Cloud Tasks will pick the default. The value must be given as a string that indicates the length of time (in seconds) followed by `s` (for \"seconds\"). For the maximum possible value or the format, see the documentation for [Duration](https://protobuf.dev/reference/protobuf/google.protobuf/#duration). `max_retry_duration` will be truncated to the nearest second. This field has the same meaning as [task_age_limit in queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/python/config/queueref#retry_parameters).",
11961196
"format": "google-duration",
11971197
"type": "string"
11981198
},
11991199
"minBackoff": {
1200-
"description": "A task will be scheduled for retry between min_backoff and max_backoff duration after it fails, if the queue's RetryConfig specifies that the task should be retried. If unspecified when the queue is created, Cloud Tasks will pick the default. `min_backoff` will be truncated to the nearest second. This field has the same meaning as [min_backoff_seconds in queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/python/config/queueref#retry_parameters).",
1200+
"description": "A task will be scheduled for retry between min_backoff and max_backoff duration after it fails, if the queue's RetryConfig specifies that the task should be retried. If unspecified when the queue is created, Cloud Tasks will pick the default. The value must be given as a string that indicates the length of time (in seconds) followed by `s` (for \"seconds\"). For more information on the format, see the documentation for [Duration](https://protobuf.dev/reference/protobuf/google.protobuf/#duration). `min_backoff` will be truncated to the nearest second. This field has the same meaning as [min_backoff_seconds in queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/python/config/queueref#retry_parameters).",
12011201
"format": "google-duration",
12021202
"type": "string"
12031203
}
@@ -1294,7 +1294,7 @@
12941294
"type": "integer"
12951295
},
12961296
"dispatchDeadline": {
1297-
"description": "The deadline for requests sent to the worker. If the worker does not respond by this deadline then the request is cancelled and the attempt is marked as a `DEADLINE_EXCEEDED` failure. Cloud Tasks will retry the task according to the RetryConfig. Note that when the request is cancelled, Cloud Tasks will stop listening for the response, but whether the worker stops processing depends on the worker. For example, if the worker is stuck, it may not react to cancelled requests. The default and maximum values depend on the type of request: * For HTTP tasks, the default is 10 minutes. The deadline must be in the interval [15 seconds, 30 minutes]. * For App Engine tasks, 0 indicates that the request has the default deadline. The default deadline depends on the [scaling type](https://cloud.google.com/appengine/docs/standard/go/how-instances-are-managed#instance_scaling) of the service: 10 minutes for standard apps with automatic scaling, 24 hours for standard apps with manual and basic scaling, and 60 minutes for flex apps. If the request deadline is set, it must be in the interval [15 seconds, 24 hours 15 seconds]. Regardless of the task's `dispatch_deadline`, the app handler will not run for longer than than the service's timeout. We recommend setting the `dispatch_deadline` to at most a few seconds more than the app handler's timeout. For more information see [Timeouts](https://cloud.google.com/tasks/docs/creating-appengine-handlers#timeouts). `dispatch_deadline` will be truncated to the nearest millisecond. The deadline is an approximate deadline.",
1297+
"description": "The deadline for requests sent to the worker. If the worker does not respond by this deadline then the request is cancelled and the attempt is marked as a `DEADLINE_EXCEEDED` failure. Cloud Tasks will retry the task according to the RetryConfig. Note that when the request is cancelled, Cloud Tasks will stop listening for the response, but whether the worker stops processing depends on the worker. For example, if the worker is stuck, it may not react to cancelled requests. The default and maximum values depend on the type of request: * For HTTP tasks, the default is 10 minutes. The deadline must be in the interval [15 seconds, 30 minutes]. * For App Engine tasks, 0 indicates that the request has the default deadline. The default deadline depends on the [scaling type](https://cloud.google.com/appengine/docs/standard/go/how-instances-are-managed#instance_scaling) of the service: 10 minutes for standard apps with automatic scaling, 24 hours for standard apps with manual and basic scaling, and 60 minutes for flex apps. If the request deadline is set, it must be in the interval [15 seconds, 24 hours 15 seconds]. Regardless of the task's `dispatch_deadline`, the app handler will not run for longer than than the service's timeout. We recommend setting the `dispatch_deadline` to at most a few seconds more than the app handler's timeout. For more information see [Timeouts](https://cloud.google.com/tasks/docs/creating-appengine-handlers#timeouts). The value must be given as a string that indicates the length of time (in seconds) followed by `s` (for \"seconds\"). For more information on the format, see the documentation for [Duration](https://protobuf.dev/reference/protobuf/google.protobuf/#duration). `dispatch_deadline` will be truncated to the nearest millisecond. The deadline is an approximate deadline.",
12981298
"format": "google-duration",
12991299
"type": "string"
13001300
},

‎googleapiclient/discovery_cache/documents/cloudtasks.v2beta2.json

+81-2
Original file line numberDiff line numberDiff line change
@@ -166,6 +166,31 @@
166166
"https://www.googleapis.com/auth/cloud-platform"
167167
]
168168
},
169+
"getCmekConfig": {
170+
"description": "Gets the CMEK config. Gets the Customer Managed Encryption Key configured with the Cloud Tasks lcoation. By default there is no kms_key configured.",
171+
"flatPath": "v2beta2/projects/{projectsId}/locations/{locationsId}/cmekConfig",
172+
"httpMethod": "GET",
173+
"id": "cloudtasks.projects.locations.getCmekConfig",
174+
"parameterOrder": [
175+
"name"
176+
],
177+
"parameters": {
178+
"name": {
179+
"description": "Required. The config. For example: projects/PROJECT_ID/locations/LOCATION_ID/CmekConfig`",
180+
"location": "path",
181+
"pattern": "^projects/[^/]+/locations/[^/]+/cmekConfig$",
182+
"required": true,
183+
"type": "string"
184+
}
185+
},
186+
"path": "v2beta2/{+name}",
187+
"response": {
188+
"$ref": "CmekConfig"
189+
},
190+
"scopes": [
191+
"https://www.googleapis.com/auth/cloud-platform"
192+
]
193+
},
169194
"list": {
170195
"description": "Lists information about the supported locations for this service.",
171196
"flatPath": "v2beta2/projects/{projectsId}/locations",
@@ -206,6 +231,44 @@
206231
"scopes": [
207232
"https://www.googleapis.com/auth/cloud-platform"
208233
]
234+
},
235+
"updateCmekConfig": {
236+
"description": "Creates or Updates a CMEK config. Updates the Customer Managed Encryption Key assotiated with the Cloud Tasks location (Creates if the key does not already exist). All new tasks created in the location will be encrypted at-rest with the KMS-key provided in the config.",
237+
"flatPath": "v2beta2/projects/{projectsId}/locations/{locationsId}/cmekConfig",
238+
"httpMethod": "PATCH",
239+
"id": "cloudtasks.projects.locations.updateCmekConfig",
240+
"parameterOrder": [
241+
"projectsId",
242+
"locationsId"
243+
],
244+
"parameters": {
245+
"locationsId": {
246+
"location": "path",
247+
"required": true,
248+
"type": "string"
249+
},
250+
"projectsId": {
251+
"location": "path",
252+
"required": true,
253+
"type": "string"
254+
},
255+
"updateMask": {
256+
"description": "List of fields to be updated in this request.",
257+
"format": "google-fieldmask",
258+
"location": "query",
259+
"type": "string"
260+
}
261+
},
262+
"path": "v2beta2/projects/{projectsId}/locations/{locationsId}/cmekConfig",
263+
"request": {
264+
"$ref": "CmekConfig"
265+
},
266+
"response": {
267+
"$ref": "CmekConfig"
268+
},
269+
"scopes": [
270+
"https://www.googleapis.com/auth/cloud-platform"
271+
]
209272
}
210273
},
211274
"resources": {
@@ -240,7 +303,7 @@
240303
]
241304
},
242305
"delete": {
243-
"description": "Deletes a queue. This command will delete the queue even if it has tasks in it. Note: If you delete a queue, a queue with the same name can't be created for 7 days. WARNING: Using this method may have unintended side effects if you are using an App Engine `queue.yaml` or `queue.xml` file to manage your queues. Read [Overview of Queue Management and queue.yaml](https://cloud.google.com/tasks/docs/queue-yaml) before using this method.",
306+
"description": "Deletes a queue. This command will delete the queue even if it has tasks in it. Note: If you delete a queue, you may be prevented from creating a new queue with the same name as the deleted queue for a tombstone window of up to 3 days. During this window, the CreateQueue operation may appear to recreate the queue, but this can be misleading. If you attempt to create a queue with the same name as one that is in the tombstone window, run GetQueue to confirm that the queue creation was successful. If GetQueue returns 200 response code, your queue was successfully created with the name of the previously deleted queue. Otherwise, your queue did not successfully recreate. WARNING: Using this method may have unintended side effects if you are using an App Engine `queue.yaml` or `queue.xml` file to manage your queues. Read [Overview of Queue Management and queue.yaml](https://cloud.google.com/tasks/docs/queue-yaml) before using this method.",
244307
"flatPath": "v2beta2/projects/{projectsId}/locations/{locationsId}/queues/{queuesId}",
245308
"httpMethod": "DELETE",
246309
"id": "cloudtasks.projects.locations.queues.delete",
@@ -876,7 +939,7 @@
876939
}
877940
}
878941
},
879-
"revision": "20230809",
942+
"revision": "20230906",
880943
"rootUrl": "https://cloudtasks.googleapis.com/",
881944
"schemas": {
882945
"AcknowledgeTaskRequest": {
@@ -1072,6 +1135,22 @@
10721135
},
10731136
"type": "object"
10741137
},
1138+
"CmekConfig": {
1139+
"description": "CMEK, or Customer Managed Encryption Keys, enables GCP products to put control over encryption and key management in their customer\u2019s hands.",
1140+
"id": "CmekConfig",
1141+
"properties": {
1142+
"kmsKey": {
1143+
"description": "Resource name of the Cloud KMS key, of the form `projects/PROJECT_ID/locations/LOCATION_ID/keyRings/KEY_RING_ID/cryptoKeys/KEY_ID`, that will be used to encrypt the Queues & Tasks in the region. Setting this as blank will turn off CMEK encryption.",
1144+
"type": "string"
1145+
},
1146+
"name": {
1147+
"description": "Output only. The config resource name which includes the project and location and must end in 'cmekConfig', in the format projects/PROJECT_ID/locations/LOCATION_ID/cmekConfig`",
1148+
"readOnly": true,
1149+
"type": "string"
1150+
}
1151+
},
1152+
"type": "object"
1153+
},
10751154
"CreateTaskRequest": {
10761155
"description": "Request message for CreateTask.",
10771156
"id": "CreateTaskRequest",

‎googleapiclient/discovery_cache/documents/cloudtasks.v2beta3.json

+7-7
Original file line numberDiff line numberDiff line change
@@ -732,7 +732,7 @@
732732
}
733733
}
734734
},
735-
"revision": "20230809",
735+
"revision": "20230906",
736736
"rootUrl": "https://cloudtasks.googleapis.com/",
737737
"schemas": {
738738
"AppEngineHttpQueue": {
@@ -1372,12 +1372,12 @@
13721372
"readOnly": true
13731373
},
13741374
"taskTtl": {
1375-
"description": "The maximum amount of time that a task will be retained in this queue. Queues created by Cloud Tasks have a default `task_ttl` of 31 days. After a task has lived for `task_ttl`, the task will be deleted regardless of whether it was dispatched or not. The `task_ttl` for queues created via queue.yaml/xml is equal to the maximum duration because there is a [storage quota](https://cloud.google.com/appengine/quotas#Task_Queue) for these queues. To view the maximum valid duration, see the documentation for Duration.",
1375+
"description": "The maximum amount of time that a task will be retained in this queue. After a task has lived for `task_ttl`, the task will be deleted regardless of whether it was dispatched or not. The minimum value is 10 days. The maximum value is 10 years. The value must be given as a string that indicates the length of time (in seconds) followed by `s` (for \"seconds\"). For more information on the format, see the documentation for [Duration](https://protobuf.dev/reference/protobuf/google.protobuf/#duration). Queues created by Cloud Tasks have a default `task_ttl` of 31 days. . Queues created by queue.yaml/xml have a fixed `task_ttl` of the maximum duration, because there is a [storage quota](https://cloud.google.com/appengine/quotas#Task_Queue) for these queues.",
13761376
"format": "google-duration",
13771377
"type": "string"
13781378
},
13791379
"tombstoneTtl": {
1380-
"description": "The task tombstone time to live (TTL). After a task is deleted or executed, the task's tombstone is retained for the length of time specified by `tombstone_ttl`. The tombstone is used by task de-duplication; another task with the same name can't be created until the tombstone has expired. For more information about task de-duplication, see the documentation for CreateTaskRequest. Queues created by Cloud Tasks have a default `tombstone_ttl` of 1 hour.",
1380+
"description": "The task tombstone time to live (TTL). After a task is deleted or executed, the task's tombstone is retained for the length of time specified by `tombstone_ttl`. The tombstone is used by task de-duplication; another task with the same name can't be created until the tombstone has expired. For more information about task de-duplication, see the documentation for CreateTaskRequest. The minimum value is 1 hour. The maximum value is 9 days. The value must be given as a string that indicates the length of time (in seconds) followed by `s` (for \"seconds\"). For more information on the format, see the documentation for [Duration](https://protobuf.dev/reference/protobuf/google.protobuf/#duration). Queues created by Cloud Tasks have a default `tombstone_ttl` of 1 hour.",
13811381
"format": "google-duration",
13821382
"type": "string"
13831383
},
@@ -1473,7 +1473,7 @@
14731473
"type": "integer"
14741474
},
14751475
"maxBackoff": {
1476-
"description": "A task will be scheduled for retry between min_backoff and max_backoff duration after it fails, if the queue's RetryConfig specifies that the task should be retried. If unspecified when the queue is created, Cloud Tasks will pick the default. `max_backoff` will be truncated to the nearest second. This field has the same meaning as [max_backoff_seconds in queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/python/config/queueref#retry_parameters).",
1476+
"description": "A task will be scheduled for retry between min_backoff and max_backoff duration after it fails, if the queue's RetryConfig specifies that the task should be retried. If unspecified when the queue is created, Cloud Tasks will pick the default. The value must be given as a string that indicates the length of time (in seconds) followed by `s` (for \"seconds\"). For more information on the format, see the documentation for [Duration](https://protobuf.dev/reference/protobuf/google.protobuf/#duration). `max_backoff` will be truncated to the nearest second. This field has the same meaning as [max_backoff_seconds in queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/python/config/queueref#retry_parameters).",
14771477
"format": "google-duration",
14781478
"type": "string"
14791479
},
@@ -1483,12 +1483,12 @@
14831483
"type": "integer"
14841484
},
14851485
"maxRetryDuration": {
1486-
"description": "If positive, `max_retry_duration` specifies the time limit for retrying a failed task, measured from when the task was first attempted. Once `max_retry_duration` time has passed *and* the task has been attempted max_attempts times, no further attempts will be made and the task will be deleted. If zero, then the task age is unlimited. If unspecified when the queue is created, Cloud Tasks will pick the default. `max_retry_duration` will be truncated to the nearest second. This field has the same meaning as [task_age_limit in queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/python/config/queueref#retry_parameters).",
1486+
"description": "If positive, `max_retry_duration` specifies the time limit for retrying a failed task, measured from when the task was first attempted. Once `max_retry_duration` time has passed *and* the task has been attempted max_attempts times, no further attempts will be made and the task will be deleted. If zero, then the task age is unlimited. If unspecified when the queue is created, Cloud Tasks will pick the default. The value must be given as a string that indicates the length of time (in seconds) followed by `s` (for \"seconds\"). For the maximum possible value or the format, see the documentation for [Duration](https://protobuf.dev/reference/protobuf/google.protobuf/#duration). `max_retry_duration` will be truncated to the nearest second. This field has the same meaning as [task_age_limit in queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/python/config/queueref#retry_parameters).",
14871487
"format": "google-duration",
14881488
"type": "string"
14891489
},
14901490
"minBackoff": {
1491-
"description": "A task will be scheduled for retry between min_backoff and max_backoff duration after it fails, if the queue's RetryConfig specifies that the task should be retried. If unspecified when the queue is created, Cloud Tasks will pick the default. `min_backoff` will be truncated to the nearest second. This field has the same meaning as [min_backoff_seconds in queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/python/config/queueref#retry_parameters).",
1491+
"description": "A task will be scheduled for retry between min_backoff and max_backoff duration after it fails, if the queue's RetryConfig specifies that the task should be retried. If unspecified when the queue is created, Cloud Tasks will pick the default. The value must be given as a string that indicates the length of time (in seconds) followed by `s` (for \"seconds\"). For more information on the format, see the documentation for [Duration](https://protobuf.dev/reference/protobuf/google.protobuf/#duration). `min_backoff` will be truncated to the nearest second. This field has the same meaning as [min_backoff_seconds in queue.yaml/xml](https://cloud.google.com/appengine/docs/standard/python/config/queueref#retry_parameters).",
14921492
"format": "google-duration",
14931493
"type": "string"
14941494
}
@@ -1585,7 +1585,7 @@
15851585
"type": "integer"
15861586
},
15871587
"dispatchDeadline": {
1588-
"description": "The deadline for requests sent to the worker. If the worker does not respond by this deadline then the request is cancelled and the attempt is marked as a `DEADLINE_EXCEEDED` failure. Cloud Tasks will retry the task according to the RetryConfig. Note that when the request is cancelled, Cloud Tasks will stop listening for the response, but whether the worker stops processing depends on the worker. For example, if the worker is stuck, it may not react to cancelled requests. The default and maximum values depend on the type of request: * For HTTP tasks, the default is 10 minutes. The deadline must be in the interval [15 seconds, 30 minutes]. * For App Engine tasks, 0 indicates that the request has the default deadline. The default deadline depends on the [scaling type](https://cloud.google.com/appengine/docs/standard/go/how-instances-are-managed#instance_scaling) of the service: 10 minutes for standard apps with automatic scaling, 24 hours for standard apps with manual and basic scaling, and 60 minutes for flex apps. If the request deadline is set, it must be in the interval [15 seconds, 24 hours 15 seconds]. Regardless of the task's `dispatch_deadline`, the app handler will not run for longer than than the service's timeout. We recommend setting the `dispatch_deadline` to at most a few seconds more than the app handler's timeout. For more information see [Timeouts](https://cloud.google.com/tasks/docs/creating-appengine-handlers#timeouts). `dispatch_deadline` will be truncated to the nearest millisecond. The deadline is an approximate deadline.",
1588+
"description": "The deadline for requests sent to the worker. If the worker does not respond by this deadline then the request is cancelled and the attempt is marked as a `DEADLINE_EXCEEDED` failure. Cloud Tasks will retry the task according to the RetryConfig. Note that when the request is cancelled, Cloud Tasks will stop listening for the response, but whether the worker stops processing depends on the worker. For example, if the worker is stuck, it may not react to cancelled requests. The default and maximum values depend on the type of request: * For HTTP tasks, the default is 10 minutes. The deadline must be in the interval [15 seconds, 30 minutes]. * For App Engine tasks, 0 indicates that the request has the default deadline. The default deadline depends on the [scaling type](https://cloud.google.com/appengine/docs/standard/go/how-instances-are-managed#instance_scaling) of the service: 10 minutes for standard apps with automatic scaling, 24 hours for standard apps with manual and basic scaling, and 60 minutes for flex apps. If the request deadline is set, it must be in the interval [15 seconds, 24 hours 15 seconds]. Regardless of the task's `dispatch_deadline`, the app handler will not run for longer than than the service's timeout. We recommend setting the `dispatch_deadline` to at most a few seconds more than the app handler's timeout. For more information see [Timeouts](https://cloud.google.com/tasks/docs/creating-appengine-handlers#timeouts). The value must be given as a string that indicates the length of time (in seconds) followed by `s` (for \"seconds\"). For more information on the format, see the documentation for [Duration](https://protobuf.dev/reference/protobuf/google.protobuf/#duration). `dispatch_deadline` will be truncated to the nearest millisecond. The deadline is an approximate deadline.",
15891589
"format": "google-duration",
15901590
"type": "string"
15911591
},

0 commit comments

Comments
 (0)
Please sign in to comment.