create method
Creates a queue.
Queues created with this method allow tasks to live for a maximum of 31
days. After a task is 31 days old, the task will be deleted regardless of
whether it was dispatched or not. WARNING: Using this method may have
unintended side effects if you are using an App Engine queue.yaml
or
queue.xml
file to manage your queues. Read
Overview of Queue Management and queue.yaml
before using this method.
request
- The metadata request object.
Request parameters:
parent
- Required. The location name in which the queue will be created.
For example: projects/PROJECT_ID/locations/LOCATION_ID
The list of
allowed locations can be obtained by calling Cloud Tasks' implementation
of ListLocations.
Value must have pattern ^projects/\[^/\]+/locations/\[^/\]+$
.
$fields
- Selector specifying which fields to include in a partial
response.
Completes with a Queue.
Completes with a commons.ApiRequestError if the API endpoint returned an error.
If the used http.Client
completes with an error when making a REST call,
this method will complete with the same error.
Implementation
async.Future<Queue> create(
Queue request,
core.String parent, {
core.String? $fields,
}) async {
final body_ = convert.json.encode(request);
final queryParams_ = <core.String, core.List<core.String>>{
if ($fields != null) 'fields': [$fields],
};
final url_ = 'v2/' + core.Uri.encodeFull('$parent') + '/queues';
final response_ = await _requester.request(
url_,
'POST',
body: body_,
queryParams: queryParams_,
);
return Queue.fromJson(response_ as core.Map<core.String, core.dynamic>);
}