| // This is a generated file (see the discoveryapis_generator project). |
| |
| // ignore_for_file: camel_case_types |
| // ignore_for_file: comment_references |
| // ignore_for_file: file_names |
| // ignore_for_file: library_names |
| // ignore_for_file: lines_longer_than_80_chars |
| // ignore_for_file: non_constant_identifier_names |
| // ignore_for_file: prefer_expression_function_bodies |
| // ignore_for_file: prefer_interpolation_to_compose_strings |
| // ignore_for_file: unnecessary_brace_in_string_interps |
| // ignore_for_file: unnecessary_lambdas |
| // ignore_for_file: unnecessary_string_interpolations |
| |
| /// Cloud Scheduler API - v1 |
| /// |
| /// Creates and manages jobs run on a regular recurring schedule. |
| /// |
| /// For more information, see <https://cloud.google.com/scheduler/> |
| /// |
| /// Create an instance of [CloudSchedulerApi] to access these resources: |
| /// |
| /// - [ProjectsResource] |
| /// - [ProjectsLocationsResource] |
| /// - [ProjectsLocationsJobsResource] |
| library cloudscheduler.v1; |
| |
| import 'dart:async' as async; |
| import 'dart:convert' as convert; |
| import 'dart:core' as core; |
| |
| import 'package:_discoveryapis_commons/_discoveryapis_commons.dart' as commons; |
| import 'package:http/http.dart' as http; |
| |
| import '../src/user_agent.dart'; |
| |
| export 'package:_discoveryapis_commons/_discoveryapis_commons.dart' |
| show ApiRequestError, DetailedApiRequestError; |
| |
| /// Creates and manages jobs run on a regular recurring schedule. |
| class CloudSchedulerApi { |
| /// View and manage your data across Google Cloud Platform services |
| static const cloudPlatformScope = |
| 'https://www.googleapis.com/auth/cloud-platform'; |
| |
| final commons.ApiRequester _requester; |
| |
| ProjectsResource get projects => ProjectsResource(_requester); |
| |
| CloudSchedulerApi(http.Client client, |
| {core.String rootUrl = 'https://cloudscheduler.googleapis.com/', |
| core.String servicePath = ''}) |
| : _requester = |
| commons.ApiRequester(client, rootUrl, servicePath, requestHeaders); |
| } |
| |
| class ProjectsResource { |
| final commons.ApiRequester _requester; |
| |
| ProjectsLocationsResource get locations => |
| ProjectsLocationsResource(_requester); |
| |
| ProjectsResource(commons.ApiRequester client) : _requester = client; |
| } |
| |
| class ProjectsLocationsResource { |
| final commons.ApiRequester _requester; |
| |
| ProjectsLocationsJobsResource get jobs => |
| ProjectsLocationsJobsResource(_requester); |
| |
| ProjectsLocationsResource(commons.ApiRequester client) : _requester = client; |
| |
| /// Gets information about a location. |
| /// |
| /// Request parameters: |
| /// |
| /// [name] - Resource name for the location. |
| /// Value must have pattern `^projects/\[^/\]+/locations/\[^/\]+$`. |
| /// |
| /// [$fields] - Selector specifying which fields to include in a partial |
| /// response. |
| /// |
| /// Completes with a [Location]. |
| /// |
| /// 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. |
| async.Future<Location> get( |
| core.String name, { |
| core.String? $fields, |
| }) async { |
| final _queryParams = <core.String, core.List<core.String>>{ |
| if ($fields != null) 'fields': [$fields], |
| }; |
| |
| final _url = 'v1/' + core.Uri.encodeFull('$name'); |
| |
| final _response = await _requester.request( |
| _url, |
| 'GET', |
| queryParams: _queryParams, |
| ); |
| return Location.fromJson(_response as core.Map<core.String, core.dynamic>); |
| } |
| |
| /// Lists information about the supported locations for this service. |
| /// |
| /// Request parameters: |
| /// |
| /// [name] - The resource that owns the locations collection, if applicable. |
| /// Value must have pattern `^projects/\[^/\]+$`. |
| /// |
| /// [filter] - The standard list filter. |
| /// |
| /// [pageSize] - The standard list page size. |
| /// |
| /// [pageToken] - The standard list page token. |
| /// |
| /// [$fields] - Selector specifying which fields to include in a partial |
| /// response. |
| /// |
| /// Completes with a [ListLocationsResponse]. |
| /// |
| /// 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. |
| async.Future<ListLocationsResponse> list( |
| core.String name, { |
| core.String? filter, |
| core.int? pageSize, |
| core.String? pageToken, |
| core.String? $fields, |
| }) async { |
| final _queryParams = <core.String, core.List<core.String>>{ |
| if (filter != null) 'filter': [filter], |
| if (pageSize != null) 'pageSize': ['${pageSize}'], |
| if (pageToken != null) 'pageToken': [pageToken], |
| if ($fields != null) 'fields': [$fields], |
| }; |
| |
| final _url = 'v1/' + core.Uri.encodeFull('$name') + '/locations'; |
| |
| final _response = await _requester.request( |
| _url, |
| 'GET', |
| queryParams: _queryParams, |
| ); |
| return ListLocationsResponse.fromJson( |
| _response as core.Map<core.String, core.dynamic>); |
| } |
| } |
| |
| class ProjectsLocationsJobsResource { |
| final commons.ApiRequester _requester; |
| |
| ProjectsLocationsJobsResource(commons.ApiRequester client) |
| : _requester = client; |
| |
| /// Creates a job. |
| /// |
| /// [request] - The metadata request object. |
| /// |
| /// Request parameters: |
| /// |
| /// [parent] - Required. The location name. For example: |
| /// `projects/PROJECT_ID/locations/LOCATION_ID`. |
| /// Value must have pattern `^projects/\[^/\]+/locations/\[^/\]+$`. |
| /// |
| /// [$fields] - Selector specifying which fields to include in a partial |
| /// response. |
| /// |
| /// Completes with a [Job]. |
| /// |
| /// 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. |
| async.Future<Job> create( |
| Job request, |
| core.String parent, { |
| core.String? $fields, |
| }) async { |
| final _body = convert.json.encode(request.toJson()); |
| final _queryParams = <core.String, core.List<core.String>>{ |
| if ($fields != null) 'fields': [$fields], |
| }; |
| |
| final _url = 'v1/' + core.Uri.encodeFull('$parent') + '/jobs'; |
| |
| final _response = await _requester.request( |
| _url, |
| 'POST', |
| body: _body, |
| queryParams: _queryParams, |
| ); |
| return Job.fromJson(_response as core.Map<core.String, core.dynamic>); |
| } |
| |
| /// Deletes a job. |
| /// |
| /// Request parameters: |
| /// |
| /// [name] - Required. The job name. For example: |
| /// `projects/PROJECT_ID/locations/LOCATION_ID/jobs/JOB_ID`. |
| /// Value must have pattern |
| /// `^projects/\[^/\]+/locations/\[^/\]+/jobs/\[^/\]+$`. |
| /// |
| /// [$fields] - Selector specifying which fields to include in a partial |
| /// response. |
| /// |
| /// Completes with a [Empty]. |
| /// |
| /// 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. |
| async.Future<Empty> delete( |
| core.String name, { |
| core.String? $fields, |
| }) async { |
| final _queryParams = <core.String, core.List<core.String>>{ |
| if ($fields != null) 'fields': [$fields], |
| }; |
| |
| final _url = 'v1/' + core.Uri.encodeFull('$name'); |
| |
| final _response = await _requester.request( |
| _url, |
| 'DELETE', |
| queryParams: _queryParams, |
| ); |
| return Empty.fromJson(_response as core.Map<core.String, core.dynamic>); |
| } |
| |
| /// Gets a job. |
| /// |
| /// Request parameters: |
| /// |
| /// [name] - Required. The job name. For example: |
| /// `projects/PROJECT_ID/locations/LOCATION_ID/jobs/JOB_ID`. |
| /// Value must have pattern |
| /// `^projects/\[^/\]+/locations/\[^/\]+/jobs/\[^/\]+$`. |
| /// |
| /// [$fields] - Selector specifying which fields to include in a partial |
| /// response. |
| /// |
| /// Completes with a [Job]. |
| /// |
| /// 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. |
| async.Future<Job> get( |
| core.String name, { |
| core.String? $fields, |
| }) async { |
| final _queryParams = <core.String, core.List<core.String>>{ |
| if ($fields != null) 'fields': [$fields], |
| }; |
| |
| final _url = 'v1/' + core.Uri.encodeFull('$name'); |
| |
| final _response = await _requester.request( |
| _url, |
| 'GET', |
| queryParams: _queryParams, |
| ); |
| return Job.fromJson(_response as core.Map<core.String, core.dynamic>); |
| } |
| |
| /// Lists jobs. |
| /// |
| /// Request parameters: |
| /// |
| /// [parent] - Required. The location name. For example: |
| /// `projects/PROJECT_ID/locations/LOCATION_ID`. |
| /// Value must have pattern `^projects/\[^/\]+/locations/\[^/\]+$`. |
| /// |
| /// [pageSize] - Requested page size. The maximum page size is 500. If |
| /// unspecified, the page size will be the maximum. Fewer jobs than requested |
| /// might be returned, even if more jobs exist; use next_page_token to |
| /// determine if more jobs exist. |
| /// |
| /// [pageToken] - A token identifying a page of results the server will |
| /// return. To request the first page results, page_token must be empty. To |
| /// request the next page of results, page_token must be the value of |
| /// next_page_token returned from the previous call to ListJobs. It is an |
| /// error to switch the value of filter or order_by while iterating through |
| /// pages. |
| /// |
| /// [$fields] - Selector specifying which fields to include in a partial |
| /// response. |
| /// |
| /// Completes with a [ListJobsResponse]. |
| /// |
| /// 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. |
| async.Future<ListJobsResponse> list( |
| core.String parent, { |
| core.int? pageSize, |
| core.String? pageToken, |
| core.String? $fields, |
| }) async { |
| final _queryParams = <core.String, core.List<core.String>>{ |
| if (pageSize != null) 'pageSize': ['${pageSize}'], |
| if (pageToken != null) 'pageToken': [pageToken], |
| if ($fields != null) 'fields': [$fields], |
| }; |
| |
| final _url = 'v1/' + core.Uri.encodeFull('$parent') + '/jobs'; |
| |
| final _response = await _requester.request( |
| _url, |
| 'GET', |
| queryParams: _queryParams, |
| ); |
| return ListJobsResponse.fromJson( |
| _response as core.Map<core.String, core.dynamic>); |
| } |
| |
| /// Updates a job. |
| /// |
| /// If successful, the updated Job is returned. If the job does not exist, |
| /// `NOT_FOUND` is returned. If UpdateJob does not successfully return, it is |
| /// possible for the job to be in an Job.State.UPDATE_FAILED state. A job in |
| /// this state may not be executed. If this happens, retry the UpdateJob |
| /// request until a successful response is received. |
| /// |
| /// [request] - The metadata request object. |
| /// |
| /// Request parameters: |
| /// |
| /// [name] - Optionally caller-specified in CreateJob, after which it becomes |
| /// output only. The job name. For example: |
| /// `projects/PROJECT_ID/locations/LOCATION_ID/jobs/JOB_ID`. * `PROJECT_ID` |
| /// can contain letters (\[A-Za-z\]), numbers (\[0-9\]), hyphens (-), colons |
| /// (:), or periods (.). For more information, see |
| /// [Identifying projects](https://cloud.google.com/resource-manager/docs/creating-managing-projects#identifying_projects) |
| /// * `LOCATION_ID` is the canonical ID for the job's location. The list of |
| /// available locations can be obtained by calling ListLocations. For more |
| /// information, see https://cloud.google.com/about/locations/. * `JOB_ID` can |
| /// contain only letters (\[A-Za-z\]), numbers (\[0-9\]), hyphens (-), or |
| /// underscores (_). The maximum length is 500 characters. |
| /// Value must have pattern |
| /// `^projects/\[^/\]+/locations/\[^/\]+/jobs/\[^/\]+$`. |
| /// |
| /// [updateMask] - A mask used to specify which fields of the job are being |
| /// updated. |
| /// |
| /// [$fields] - Selector specifying which fields to include in a partial |
| /// response. |
| /// |
| /// Completes with a [Job]. |
| /// |
| /// 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. |
| async.Future<Job> patch( |
| Job request, |
| core.String name, { |
| core.String? updateMask, |
| core.String? $fields, |
| }) async { |
| final _body = convert.json.encode(request.toJson()); |
| final _queryParams = <core.String, core.List<core.String>>{ |
| if (updateMask != null) 'updateMask': [updateMask], |
| if ($fields != null) 'fields': [$fields], |
| }; |
| |
| final _url = 'v1/' + core.Uri.encodeFull('$name'); |
| |
| final _response = await _requester.request( |
| _url, |
| 'PATCH', |
| body: _body, |
| queryParams: _queryParams, |
| ); |
| return Job.fromJson(_response as core.Map<core.String, core.dynamic>); |
| } |
| |
| /// Pauses a job. |
| /// |
| /// If a job is paused then the system will stop executing the job until it is |
| /// re-enabled via ResumeJob. The state of the job is stored in state; if |
| /// paused it will be set to Job.State.PAUSED. A job must be in |
| /// Job.State.ENABLED to be paused. |
| /// |
| /// [request] - The metadata request object. |
| /// |
| /// Request parameters: |
| /// |
| /// [name] - Required. The job name. For example: |
| /// `projects/PROJECT_ID/locations/LOCATION_ID/jobs/JOB_ID`. |
| /// Value must have pattern |
| /// `^projects/\[^/\]+/locations/\[^/\]+/jobs/\[^/\]+$`. |
| /// |
| /// [$fields] - Selector specifying which fields to include in a partial |
| /// response. |
| /// |
| /// Completes with a [Job]. |
| /// |
| /// 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. |
| async.Future<Job> pause( |
| PauseJobRequest request, |
| core.String name, { |
| core.String? $fields, |
| }) async { |
| final _body = convert.json.encode(request.toJson()); |
| final _queryParams = <core.String, core.List<core.String>>{ |
| if ($fields != null) 'fields': [$fields], |
| }; |
| |
| final _url = 'v1/' + core.Uri.encodeFull('$name') + ':pause'; |
| |
| final _response = await _requester.request( |
| _url, |
| 'POST', |
| body: _body, |
| queryParams: _queryParams, |
| ); |
| return Job.fromJson(_response as core.Map<core.String, core.dynamic>); |
| } |
| |
| /// Resume a job. |
| /// |
| /// This method reenables a job after it has been Job.State.PAUSED. The state |
| /// of a job is stored in Job.state; after calling this method it will be set |
| /// to Job.State.ENABLED. A job must be in Job.State.PAUSED to be resumed. |
| /// |
| /// [request] - The metadata request object. |
| /// |
| /// Request parameters: |
| /// |
| /// [name] - Required. The job name. For example: |
| /// `projects/PROJECT_ID/locations/LOCATION_ID/jobs/JOB_ID`. |
| /// Value must have pattern |
| /// `^projects/\[^/\]+/locations/\[^/\]+/jobs/\[^/\]+$`. |
| /// |
| /// [$fields] - Selector specifying which fields to include in a partial |
| /// response. |
| /// |
| /// Completes with a [Job]. |
| /// |
| /// 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. |
| async.Future<Job> resume( |
| ResumeJobRequest request, |
| core.String name, { |
| core.String? $fields, |
| }) async { |
| final _body = convert.json.encode(request.toJson()); |
| final _queryParams = <core.String, core.List<core.String>>{ |
| if ($fields != null) 'fields': [$fields], |
| }; |
| |
| final _url = 'v1/' + core.Uri.encodeFull('$name') + ':resume'; |
| |
| final _response = await _requester.request( |
| _url, |
| 'POST', |
| body: _body, |
| queryParams: _queryParams, |
| ); |
| return Job.fromJson(_response as core.Map<core.String, core.dynamic>); |
| } |
| |
| /// Forces a job to run now. |
| /// |
| /// When this method is called, Cloud Scheduler will dispatch the job, even if |
| /// the job is already running. |
| /// |
| /// [request] - The metadata request object. |
| /// |
| /// Request parameters: |
| /// |
| /// [name] - Required. The job name. For example: |
| /// `projects/PROJECT_ID/locations/LOCATION_ID/jobs/JOB_ID`. |
| /// Value must have pattern |
| /// `^projects/\[^/\]+/locations/\[^/\]+/jobs/\[^/\]+$`. |
| /// |
| /// [$fields] - Selector specifying which fields to include in a partial |
| /// response. |
| /// |
| /// Completes with a [Job]. |
| /// |
| /// 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. |
| async.Future<Job> run( |
| RunJobRequest request, |
| core.String name, { |
| core.String? $fields, |
| }) async { |
| final _body = convert.json.encode(request.toJson()); |
| final _queryParams = <core.String, core.List<core.String>>{ |
| if ($fields != null) 'fields': [$fields], |
| }; |
| |
| final _url = 'v1/' + core.Uri.encodeFull('$name') + ':run'; |
| |
| final _response = await _requester.request( |
| _url, |
| 'POST', |
| body: _body, |
| queryParams: _queryParams, |
| ); |
| return Job.fromJson(_response as core.Map<core.String, core.dynamic>); |
| } |
| } |
| |
| /// App Engine target. |
| /// |
| /// The job will be pushed to a job handler by means of an HTTP request via an |
| /// http_method such as HTTP POST, HTTP GET, etc. The job is acknowledged by |
| /// means of an HTTP response code in the range \[200 - 299\]. Error 503 is |
| /// considered an App Engine system error instead of an application error. |
| /// Requests returning error 503 will be retried regardless of retry |
| /// configuration and not counted against retry counts. Any other response code, |
| /// or a failure to receive a response before the deadline, constitutes a failed |
| /// attempt. |
| class AppEngineHttpTarget { |
| /// App Engine Routing setting for the job. |
| AppEngineRouting? appEngineRouting; |
| |
| /// Body. |
| /// |
| /// HTTP request body. A request body is allowed only if the HTTP method is |
| /// POST or PUT. It will result in invalid argument error to set a body on a |
| /// job with an incompatible HttpMethod. |
| core.String? body; |
| core.List<core.int> get bodyAsBytes => convert.base64.decode(body!); |
| |
| set bodyAsBytes(core.List<core.int> _bytes) { |
| body = |
| convert.base64.encode(_bytes).replaceAll('/', '_').replaceAll('+', '-'); |
| } |
| |
| /// HTTP request headers. |
| /// |
| /// This map contains the header field names and values. Headers can be set |
| /// when the job is created. Cloud Scheduler sets some headers to default |
| /// values: * `User-Agent`: By default, this header is `"AppEngine-Google; |
| /// (+http://code.google.com/appengine)"`. This header can be modified, but |
| /// Cloud Scheduler will append `"AppEngine-Google; |
| /// (+http://code.google.com/appengine)"` to the modified `User-Agent`. * |
| /// `X-CloudScheduler`: This header will be set to true. If the job has an |
| /// body, Cloud Scheduler sets the following headers: * `Content-Type`: By |
| /// default, the `Content-Type` header is set to `"application/octet-stream"`. |
| /// The default can be overridden by explictly setting `Content-Type` to a |
| /// particular media type when the job is created. For example, `Content-Type` |
| /// can be set to `"application/json"`. * `Content-Length`: This is computed |
| /// by Cloud Scheduler. This value is output only. It cannot be changed. The |
| /// headers below are output only. They cannot be set or overridden: * |
| /// `X-Google-*`: For Google internal use only. * `X-AppEngine-*`: For Google |
| /// internal use only. In addition, some App Engine headers, which contain |
| /// job-specific information, are also be sent to the job handler. |
| core.Map<core.String, core.String>? headers; |
| |
| /// The HTTP method to use for the request. |
| /// |
| /// PATCH and OPTIONS are not permitted. |
| /// Possible string values are: |
| /// - "HTTP_METHOD_UNSPECIFIED" : HTTP method unspecified. Defaults to POST. |
| /// - "POST" : HTTP POST |
| /// - "GET" : HTTP GET |
| /// - "HEAD" : HTTP HEAD |
| /// - "PUT" : HTTP PUT |
| /// - "DELETE" : HTTP DELETE |
| /// - "PATCH" : HTTP PATCH |
| /// - "OPTIONS" : HTTP OPTIONS |
| core.String? httpMethod; |
| |
| /// The relative URI. |
| /// |
| /// The relative URL must begin with "/" and must be a valid HTTP relative |
| /// URL. It can contain a path, query string arguments, and `#` fragments. If |
| /// the relative URL is empty, then the root path "/" will be used. No spaces |
| /// are allowed, and the maximum length allowed is 2083 characters. |
| core.String? relativeUri; |
| |
| AppEngineHttpTarget(); |
| |
| AppEngineHttpTarget.fromJson(core.Map _json) { |
| if (_json.containsKey('appEngineRouting')) { |
| appEngineRouting = AppEngineRouting.fromJson( |
| _json['appEngineRouting'] as core.Map<core.String, core.dynamic>); |
| } |
| if (_json.containsKey('body')) { |
| body = _json['body'] as core.String; |
| } |
| if (_json.containsKey('headers')) { |
| headers = (_json['headers'] as core.Map<core.String, core.dynamic>).map( |
| (key, item) => core.MapEntry( |
| key, |
| item as core.String, |
| ), |
| ); |
| } |
| if (_json.containsKey('httpMethod')) { |
| httpMethod = _json['httpMethod'] as core.String; |
| } |
| if (_json.containsKey('relativeUri')) { |
| relativeUri = _json['relativeUri'] as core.String; |
| } |
| } |
| |
| core.Map<core.String, core.dynamic> toJson() => { |
| if (appEngineRouting != null) |
| 'appEngineRouting': appEngineRouting!.toJson(), |
| if (body != null) 'body': body!, |
| if (headers != null) 'headers': headers!, |
| if (httpMethod != null) 'httpMethod': httpMethod!, |
| if (relativeUri != null) 'relativeUri': relativeUri!, |
| }; |
| } |
| |
| /// App Engine Routing. |
| /// |
| /// For more information about services, versions, and instances see |
| /// [An Overview of App Engine](https://cloud.google.com/appengine/docs/python/an-overview-of-app-engine), |
| /// [Microservices Architecture on Google App Engine](https://cloud.google.com/appengine/docs/python/microservices-on-app-engine), |
| /// [App Engine Standard request routing](https://cloud.google.com/appengine/docs/standard/python/how-requests-are-routed), |
| /// and |
| /// [App Engine Flex request routing](https://cloud.google.com/appengine/docs/flexible/python/how-requests-are-routed). |
| class AppEngineRouting { |
| /// The host that the job is sent to. |
| /// |
| /// For more information about how App Engine requests are routed, see |
| /// [here](https://cloud.google.com/appengine/docs/standard/python/how-requests-are-routed). |
| /// The host is constructed as: * `host = [application_domain_name]` `| |
| /// [service] + '.' + [application_domain_name]` `| [version] + '.' + |
| /// [application_domain_name]` `| [version_dot_service]+ '.' + |
| /// [application_domain_name]` `| [instance] + '.' + |
| /// [application_domain_name]` `| [instance_dot_service] + '.' + |
| /// [application_domain_name]` `| [instance_dot_version] + '.' + |
| /// [application_domain_name]` `| [instance_dot_version_dot_service] + '.' + |
| /// [application_domain_name]` * `application_domain_name` = The domain name |
| /// of the app, for example .appspot.com, which is associated with the job's |
| /// project ID. * `service =` service * `version =` version * |
| /// `version_dot_service =` version `+ '.' +` service * `instance =` instance |
| /// * `instance_dot_service =` instance `+ '.' +` service * |
| /// `instance_dot_version =` instance `+ '.' +` version * |
| /// `instance_dot_version_dot_service =` instance `+ '.' +` version `+ '.' +` |
| /// service If service is empty, then the job will be sent to the service |
| /// which is the default service when the job is attempted. If version is |
| /// empty, then the job will be sent to the version which is the default |
| /// version when the job is attempted. If instance is empty, then the job will |
| /// be sent to an instance which is available when the job is attempted. If |
| /// service, version, or instance is invalid, then the job will be sent to the |
| /// default version of the default service when the job is attempted. |
| /// |
| /// Output only. |
| core.String? host; |
| |
| /// 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). |
| core.String? instance; |
| |
| /// App service. |
| /// |
| /// By default, the job is sent to the service which is the default service |
| /// when the job is attempted. |
| core.String? service; |
| |
| /// App version. |
| /// |
| /// By default, the job is sent to the version which is the default version |
| /// when the job is attempted. |
| core.String? version; |
| |
| AppEngineRouting(); |
| |
| AppEngineRouting.fromJson(core.Map _json) { |
| if (_json.containsKey('host')) { |
| host = _json['host'] as core.String; |
| } |
| if (_json.containsKey('instance')) { |
| instance = _json['instance'] as core.String; |
| } |
| if (_json.containsKey('service')) { |
| service = _json['service'] as core.String; |
| } |
| if (_json.containsKey('version')) { |
| version = _json['version'] as core.String; |
| } |
| } |
| |
| core.Map<core.String, core.dynamic> toJson() => { |
| if (host != null) 'host': host!, |
| if (instance != null) 'instance': instance!, |
| if (service != null) 'service': service!, |
| if (version != null) 'version': version!, |
| }; |
| } |
| |
| /// A generic empty message that you can re-use to avoid defining duplicated |
| /// empty messages in your APIs. |
| /// |
| /// A typical example is to use it as the request or the response type of an API |
| /// method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns |
| /// (google.protobuf.Empty); } The JSON representation for `Empty` is empty JSON |
| /// object `{}`. |
| class Empty { |
| Empty(); |
| |
| Empty.fromJson( |
| // ignore: avoid_unused_constructor_parameters |
| core.Map _json); |
| |
| core.Map<core.String, core.dynamic> toJson() => {}; |
| } |
| |
| /// Http target. |
| /// |
| /// The job will be pushed to the job handler by means of an HTTP request via an |
| /// http_method such as HTTP POST, HTTP GET, etc. The job is acknowledged by |
| /// means of an HTTP response code in the range \[200 - 299\]. A failure to |
| /// receive a response constitutes a failed execution. For a redirected request, |
| /// the response returned by the redirected request is considered. |
| class HttpTarget { |
| /// 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. |
| core.String? body; |
| core.List<core.int> get bodyAsBytes => convert.base64.decode(body!); |
| |
| set bodyAsBytes(core.List<core.int> _bytes) { |
| body = |
| convert.base64.encode(_bytes).replaceAll('/', '_').replaceAll('+', '-'); |
| } |
| |
| /// The user can specify HTTP request headers to send with the job's HTTP |
| /// request. |
| /// |
| /// This map contains the header field names and values. Repeated headers are |
| /// not supported, but a header value can contain commas. These headers |
| /// represent a subset of the headers that will accompany the job's HTTP |
| /// request. Some HTTP request headers will be ignored or replaced. A partial |
| /// list of headers that will be ignored or replaced is below: - Host: This |
| /// will be computed by Cloud Scheduler and derived from uri. * |
| /// `Content-Length`: This will be computed by Cloud Scheduler. * |
| /// `User-Agent`: This will be set to `"Google-Cloud-Scheduler"`. * |
| /// `X-Google-*`: Google internal use only. * `X-AppEngine-*`: Google internal |
| /// use only. The total size of headers must be less than 80KB. |
| core.Map<core.String, core.String>? headers; |
| |
| /// Which HTTP method to use for the request. |
| /// Possible string values are: |
| /// - "HTTP_METHOD_UNSPECIFIED" : HTTP method unspecified. Defaults to POST. |
| /// - "POST" : HTTP POST |
| /// - "GET" : HTTP GET |
| /// - "HEAD" : HTTP HEAD |
| /// - "PUT" : HTTP PUT |
| /// - "DELETE" : HTTP DELETE |
| /// - "PATCH" : HTTP PATCH |
| /// - "OPTIONS" : HTTP OPTIONS |
| core.String? httpMethod; |
| |
| /// If specified, an |
| /// [OAuth token](https://developers.google.com/identity/protocols/OAuth2) |
| /// will be generated and attached as an `Authorization` header in the HTTP |
| /// request. |
| /// |
| /// This type of authorization should generally only be used when calling |
| /// Google APIs hosted on *.googleapis.com. |
| OAuthToken? oauthToken; |
| |
| /// 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. |
| OidcToken? oidcToken; |
| |
| /// The full URI path that the request will be sent to. |
| /// |
| /// This string must begin with either "http://" or "https://". Some examples |
| /// of valid values for uri are: `http://acme.com` and |
| /// `https://acme.com/sales:8080`. Cloud Scheduler will encode some characters |
| /// for safety and compatibility. The maximum allowed URL length is 2083 |
| /// characters after encoding. |
| /// |
| /// Required. |
| core.String? uri; |
| |
| HttpTarget(); |
| |
| HttpTarget.fromJson(core.Map _json) { |
| if (_json.containsKey('body')) { |
| body = _json['body'] as core.String; |
| } |
| if (_json.containsKey('headers')) { |
| headers = (_json['headers'] as core.Map<core.String, core.dynamic>).map( |
| (key, item) => core.MapEntry( |
| key, |
| item as core.String, |
| ), |
| ); |
| } |
| if (_json.containsKey('httpMethod')) { |
| httpMethod = _json['httpMethod'] as core.String; |
| } |
| if (_json.containsKey('oauthToken')) { |
| oauthToken = OAuthToken.fromJson( |
| _json['oauthToken'] as core.Map<core.String, core.dynamic>); |
| } |
| if (_json.containsKey('oidcToken')) { |
| oidcToken = OidcToken.fromJson( |
| _json['oidcToken'] as core.Map<core.String, core.dynamic>); |
| } |
| if (_json.containsKey('uri')) { |
| uri = _json['uri'] as core.String; |
| } |
| } |
| |
| core.Map<core.String, core.dynamic> toJson() => { |
| if (body != null) 'body': body!, |
| if (headers != null) 'headers': headers!, |
| if (httpMethod != null) 'httpMethod': httpMethod!, |
| if (oauthToken != null) 'oauthToken': oauthToken!.toJson(), |
| if (oidcToken != null) 'oidcToken': oidcToken!.toJson(), |
| if (uri != null) 'uri': uri!, |
| }; |
| } |
| |
| /// Configuration for a job. |
| /// |
| /// The maximum allowed size for a job is 100KB. |
| class Job { |
| /// App Engine HTTP target. |
| AppEngineHttpTarget? appEngineHttpTarget; |
| |
| /// The deadline for job attempts. |
| /// |
| /// If the request handler does not respond by this deadline then the request |
| /// is cancelled and the attempt is marked as a `DEADLINE_EXCEEDED` failure. |
| /// The failed attempt can be viewed in execution logs. Cloud Scheduler will |
| /// retry the job according to the RetryConfig. The allowed duration for this |
| /// deadline is: * For HTTP targets, between 15 seconds and 30 minutes. * For |
| /// App Engine HTTP targets, between 15 seconds and 24 hours. |
| core.String? attemptDeadline; |
| |
| /// Optionally caller-specified in CreateJob or UpdateJob. |
| /// |
| /// A human-readable description for the job. This string must not contain |
| /// more than 500 characters. |
| core.String? description; |
| |
| /// HTTP target. |
| HttpTarget? httpTarget; |
| |
| /// The time the last job attempt started. |
| /// |
| /// Output only. |
| core.String? lastAttemptTime; |
| |
| /// Optionally caller-specified in CreateJob, after which it becomes output |
| /// only. |
| /// |
| /// The job name. For example: |
| /// `projects/PROJECT_ID/locations/LOCATION_ID/jobs/JOB_ID`. * `PROJECT_ID` |
| /// can contain letters (\[A-Za-z\]), numbers (\[0-9\]), hyphens (-), colons |
| /// (:), or periods (.). For more information, see |
| /// [Identifying projects](https://cloud.google.com/resource-manager/docs/creating-managing-projects#identifying_projects) |
| /// * `LOCATION_ID` is the canonical ID for the job's location. The list of |
| /// available locations can be obtained by calling ListLocations. For more |
| /// information, see https://cloud.google.com/about/locations/. * `JOB_ID` can |
| /// contain only letters (\[A-Za-z\]), numbers (\[0-9\]), hyphens (-), or |
| /// underscores (_). The maximum length is 500 characters. |
| core.String? name; |
| |
| /// Pub/Sub target. |
| PubsubTarget? pubsubTarget; |
| |
| /// Settings that determine the retry behavior. |
| RetryConfig? retryConfig; |
| |
| /// Required, except when used with UpdateJob. |
| /// |
| /// Describes the schedule on which the job will be executed. The schedule can |
| /// be either of the following types: * |
| /// [Crontab](http://en.wikipedia.org/wiki/Cron#Overview) * English-like |
| /// [schedule](https://cloud.google.com/scheduler/docs/configuring/cron-job-schedules) |
| /// As a general rule, execution `n + 1` of a job will not begin until |
| /// execution `n` has finished. Cloud Scheduler will never allow two |
| /// simultaneously outstanding executions. For example, this implies that if |
| /// the `n+1`th execution is scheduled to run at 16:00 but the `n`th execution |
| /// takes until 16:15, the `n+1`th execution will not start until `16:15`. A |
| /// scheduled start time will be delayed if the previous execution has not |
| /// ended when its scheduled time occurs. If retry_count > 0 and a job attempt |
| /// fails, the job will be tried a total of retry_count times, with |
| /// exponential backoff, until the next scheduled start time. |
| core.String? schedule; |
| |
| /// The next time the job is scheduled. |
| /// |
| /// Note that this may be a retry of a previously failed attempt or the next |
| /// execution time according to the schedule. |
| /// |
| /// Output only. |
| core.String? scheduleTime; |
| |
| /// State of the job. |
| /// |
| /// Output only. |
| /// Possible string values are: |
| /// - "STATE_UNSPECIFIED" : Unspecified state. |
| /// - "ENABLED" : The job is executing normally. |
| /// - "PAUSED" : The job is paused by the user. It will not execute. A user |
| /// can intentionally pause the job using PauseJobRequest. |
| /// - "DISABLED" : The job is disabled by the system due to error. The user |
| /// cannot directly set a job to be disabled. |
| /// - "UPDATE_FAILED" : The job state resulting from a failed |
| /// CloudScheduler.UpdateJob operation. To recover a job from this state, |
| /// retry CloudScheduler.UpdateJob until a successful response is received. |
| core.String? state; |
| |
| /// The response from the target for the last attempted execution. |
| /// |
| /// Output only. |
| Status? status; |
| |
| /// 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). |
| core.String? timeZone; |
| |
| /// The creation time of the job. |
| /// |
| /// Output only. |
| core.String? userUpdateTime; |
| |
| Job(); |
| |
| Job.fromJson(core.Map _json) { |
| if (_json.containsKey('appEngineHttpTarget')) { |
| appEngineHttpTarget = AppEngineHttpTarget.fromJson( |
| _json['appEngineHttpTarget'] as core.Map<core.String, core.dynamic>); |
| } |
| if (_json.containsKey('attemptDeadline')) { |
| attemptDeadline = _json['attemptDeadline'] as core.String; |
| } |
| if (_json.containsKey('description')) { |
| description = _json['description'] as core.String; |
| } |
| if (_json.containsKey('httpTarget')) { |
| httpTarget = HttpTarget.fromJson( |
| _json['httpTarget'] as core.Map<core.String, core.dynamic>); |
| } |
| if (_json.containsKey('lastAttemptTime')) { |
| lastAttemptTime = _json['lastAttemptTime'] as core.String; |
| } |
| if (_json.containsKey('name')) { |
| name = _json['name'] as core.String; |
| } |
| if (_json.containsKey('pubsubTarget')) { |
| pubsubTarget = PubsubTarget.fromJson( |
| _json['pubsubTarget'] as core.Map<core.String, core.dynamic>); |
| } |
| if (_json.containsKey('retryConfig')) { |
| retryConfig = RetryConfig.fromJson( |
| _json['retryConfig'] as core.Map<core.String, core.dynamic>); |
| } |
| if (_json.containsKey('schedule')) { |
| schedule = _json['schedule'] as core.String; |
| } |
| if (_json.containsKey('scheduleTime')) { |
| scheduleTime = _json['scheduleTime'] as core.String; |
| } |
| if (_json.containsKey('state')) { |
| state = _json['state'] as core.String; |
| } |
| if (_json.containsKey('status')) { |
| status = Status.fromJson( |
| _json['status'] as core.Map<core.String, core.dynamic>); |
| } |
| if (_json.containsKey('timeZone')) { |
| timeZone = _json['timeZone'] as core.String; |
| } |
| if (_json.containsKey('userUpdateTime')) { |
| userUpdateTime = _json['userUpdateTime'] as core.String; |
| } |
| } |
| |
| core.Map<core.String, core.dynamic> toJson() => { |
| if (appEngineHttpTarget != null) |
| 'appEngineHttpTarget': appEngineHttpTarget!.toJson(), |
| if (attemptDeadline != null) 'attemptDeadline': attemptDeadline!, |
| if (description != null) 'description': description!, |
| if (httpTarget != null) 'httpTarget': httpTarget!.toJson(), |
| if (lastAttemptTime != null) 'lastAttemptTime': lastAttemptTime!, |
| if (name != null) 'name': name!, |
| if (pubsubTarget != null) 'pubsubTarget': pubsubTarget!.toJson(), |
| if (retryConfig != null) 'retryConfig': retryConfig!.toJson(), |
| if (schedule != null) 'schedule': schedule!, |
| if (scheduleTime != null) 'scheduleTime': scheduleTime!, |
| if (state != null) 'state': state!, |
| if (status != null) 'status': status!.toJson(), |
| if (timeZone != null) 'timeZone': timeZone!, |
| if (userUpdateTime != null) 'userUpdateTime': userUpdateTime!, |
| }; |
| } |
| |
| /// Response message for listing jobs using ListJobs. |
| class ListJobsResponse { |
| /// The list of jobs. |
| core.List<Job>? jobs; |
| |
| /// A token to retrieve next page of results. |
| /// |
| /// Pass this value in the page_token field in the subsequent call to ListJobs |
| /// to retrieve the next page of results. If this is empty it indicates that |
| /// there are no more results through which to paginate. The page token is |
| /// valid for only 2 hours. |
| core.String? nextPageToken; |
| |
| ListJobsResponse(); |
| |
| ListJobsResponse.fromJson(core.Map _json) { |
| if (_json.containsKey('jobs')) { |
| jobs = (_json['jobs'] as core.List) |
| .map<Job>((value) => |
| Job.fromJson(value as core.Map<core.String, core.dynamic>)) |
| .toList(); |
| } |
| if (_json.containsKey('nextPageToken')) { |
| nextPageToken = _json['nextPageToken'] as core.String; |
| } |
| } |
| |
| core.Map<core.String, core.dynamic> toJson() => { |
| if (jobs != null) 'jobs': jobs!.map((value) => value.toJson()).toList(), |
| if (nextPageToken != null) 'nextPageToken': nextPageToken!, |
| }; |
| } |
| |
| /// The response message for Locations.ListLocations. |
| class ListLocationsResponse { |
| /// A list of locations that matches the specified filter in the request. |
| core.List<Location>? locations; |
| |
| /// The standard List next-page token. |
| core.String? nextPageToken; |
| |
| ListLocationsResponse(); |
| |
| ListLocationsResponse.fromJson(core.Map _json) { |
| if (_json.containsKey('locations')) { |
| locations = (_json['locations'] as core.List) |
| .map<Location>((value) => |
| Location.fromJson(value as core.Map<core.String, core.dynamic>)) |
| .toList(); |
| } |
| if (_json.containsKey('nextPageToken')) { |
| nextPageToken = _json['nextPageToken'] as core.String; |
| } |
| } |
| |
| core.Map<core.String, core.dynamic> toJson() => { |
| if (locations != null) |
| 'locations': locations!.map((value) => value.toJson()).toList(), |
| if (nextPageToken != null) 'nextPageToken': nextPageToken!, |
| }; |
| } |
| |
| /// A resource that represents Google Cloud Platform location. |
| class Location { |
| /// The friendly name for this location, typically a nearby city name. |
| /// |
| /// For example, "Tokyo". |
| core.String? displayName; |
| |
| /// Cross-service attributes for the location. |
| /// |
| /// For example {"cloud.googleapis.com/region": "us-east1"} |
| core.Map<core.String, core.String>? labels; |
| |
| /// The canonical id for this location. |
| /// |
| /// For example: `"us-east1"`. |
| core.String? locationId; |
| |
| /// Service-specific metadata. |
| /// |
| /// For example the available capacity at the given location. |
| /// |
| /// The values for Object must be JSON objects. It can consist of `num`, |
| /// `String`, `bool` and `null` as well as `Map` and `List` values. |
| core.Map<core.String, core.Object>? metadata; |
| |
| /// Resource name for the location, which may vary between implementations. |
| /// |
| /// For example: `"projects/example-project/locations/us-east1"` |
| core.String? name; |
| |
| Location(); |
| |
| Location.fromJson(core.Map _json) { |
| if (_json.containsKey('displayName')) { |
| displayName = _json['displayName'] as core.String; |
| } |
| if (_json.containsKey('labels')) { |
| labels = (_json['labels'] as core.Map<core.String, core.dynamic>).map( |
| (key, item) => core.MapEntry( |
| key, |
| item as core.String, |
| ), |
| ); |
| } |
| if (_json.containsKey('locationId')) { |
| locationId = _json['locationId'] as core.String; |
| } |
| if (_json.containsKey('metadata')) { |
| metadata = (_json['metadata'] as core.Map<core.String, core.dynamic>).map( |
| (key, item) => core.MapEntry( |
| key, |
| item as core.Object, |
| ), |
| ); |
| } |
| if (_json.containsKey('name')) { |
| name = _json['name'] as core.String; |
| } |
| } |
| |
| core.Map<core.String, core.dynamic> toJson() => { |
| if (displayName != null) 'displayName': displayName!, |
| if (labels != null) 'labels': labels!, |
| if (locationId != null) 'locationId': locationId!, |
| if (metadata != null) 'metadata': metadata!, |
| if (name != null) 'name': name!, |
| }; |
| } |
| |
| /// Contains information needed for generating an |
| /// [OAuth token](https://developers.google.com/identity/protocols/OAuth2). |
| /// |
| /// This type of authorization should generally only be used when calling Google |
| /// APIs hosted on *.googleapis.com. |
| class OAuthToken { |
| /// OAuth scope to be used for generating OAuth access token. |
| /// |
| /// If not specified, "https://www.googleapis.com/auth/cloud-platform" will be |
| /// used. |
| core.String? scope; |
| |
| /// [Service account email](https://cloud.google.com/iam/docs/service-accounts) |
| /// to be used for generating OAuth token. |
| /// |
| /// The service account must be within the same project as the job. The caller |
| /// must have iam.serviceAccounts.actAs permission for the service account. |
| core.String? serviceAccountEmail; |
| |
| OAuthToken(); |
| |
| OAuthToken.fromJson(core.Map _json) { |
| if (_json.containsKey('scope')) { |
| scope = _json['scope'] as core.String; |
| } |
| if (_json.containsKey('serviceAccountEmail')) { |
| serviceAccountEmail = _json['serviceAccountEmail'] as core.String; |
| } |
| } |
| |
| core.Map<core.String, core.dynamic> toJson() => { |
| if (scope != null) 'scope': scope!, |
| if (serviceAccountEmail != null) |
| 'serviceAccountEmail': serviceAccountEmail!, |
| }; |
| } |
| |
| /// Contains information needed for generating an |
| /// [OpenID Connect token](https://developers.google.com/identity/protocols/OpenIDConnect). |
| /// |
| /// This type of authorization can be used for many scenarios, including calling |
| /// Cloud Run, or endpoints where you intend to validate the token yourself. |
| class OidcToken { |
| /// Audience to be used when generating OIDC token. |
| /// |
| /// If not specified, the URI specified in target will be used. |
| core.String? audience; |
| |
| /// [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. |
| core.String? serviceAccountEmail; |
| |
| OidcToken(); |
| |
| OidcToken.fromJson(core.Map _json) { |
| if (_json.containsKey('audience')) { |
| audience = _json['audience'] as core.String; |
| } |
| if (_json.containsKey('serviceAccountEmail')) { |
| serviceAccountEmail = _json['serviceAccountEmail'] as core.String; |
| } |
| } |
| |
| core.Map<core.String, core.dynamic> toJson() => { |
| if (audience != null) 'audience': audience!, |
| if (serviceAccountEmail != null) |
| 'serviceAccountEmail': serviceAccountEmail!, |
| }; |
| } |
| |
| /// Request message for PauseJob. |
| class PauseJobRequest { |
| PauseJobRequest(); |
| |
| PauseJobRequest.fromJson( |
| // ignore: avoid_unused_constructor_parameters |
| core.Map _json); |
| |
| core.Map<core.String, core.dynamic> toJson() => {}; |
| } |
| |
| /// A message that is published by publishers and consumed by subscribers. |
| /// |
| /// The message must contain either a non-empty data field or at least one |
| /// attribute. Note that client libraries represent this object differently |
| /// depending on the language. See the corresponding |
| /// [client library documentation](https://cloud.google.com/pubsub/docs/reference/libraries) |
| /// for more information. See |
| /// [quotas and limits](https://cloud.google.com/pubsub/quotas) for more |
| /// information about message limits. |
| class PubsubMessage { |
| /// Attributes for this message. |
| /// |
| /// If this field is empty, the message must contain non-empty data. This can |
| /// be used to filter messages on the subscription. |
| core.Map<core.String, core.String>? attributes; |
| |
| /// The message data field. |
| /// |
| /// If this field is empty, the message must contain at least one attribute. |
| core.String? data; |
| core.List<core.int> get dataAsBytes => convert.base64.decode(data!); |
| |
| set dataAsBytes(core.List<core.int> _bytes) { |
| data = |
| convert.base64.encode(_bytes).replaceAll('/', '_').replaceAll('+', '-'); |
| } |
| |
| /// ID of this message, assigned by the server when the message is published. |
| /// |
| /// Guaranteed to be unique within the topic. This value may be read by a |
| /// subscriber that receives a `PubsubMessage` via a `Pull` call or a push |
| /// delivery. It must not be populated by the publisher in a `Publish` call. |
| core.String? messageId; |
| |
| /// If non-empty, identifies related messages for which publish order should |
| /// be respected. |
| /// |
| /// If a `Subscription` has `enable_message_ordering` set to `true`, messages |
| /// published with the same non-empty `ordering_key` value will be delivered |
| /// to subscribers in the order in which they are received by the Pub/Sub |
| /// system. All `PubsubMessage`s published in a given `PublishRequest` must |
| /// specify the same `ordering_key` value. |
| core.String? orderingKey; |
| |
| /// The time at which the message was published, populated by the server when |
| /// it receives the `Publish` call. |
| /// |
| /// It must not be populated by the publisher in a `Publish` call. |
| core.String? publishTime; |
| |
| PubsubMessage(); |
| |
| PubsubMessage.fromJson(core.Map _json) { |
| if (_json.containsKey('attributes')) { |
| attributes = |
| (_json['attributes'] as core.Map<core.String, core.dynamic>).map( |
| (key, item) => core.MapEntry( |
| key, |
| item as core.String, |
| ), |
| ); |
| } |
| if (_json.containsKey('data')) { |
| data = _json['data'] as core.String; |
| } |
| if (_json.containsKey('messageId')) { |
| messageId = _json['messageId'] as core.String; |
| } |
| if (_json.containsKey('orderingKey')) { |
| orderingKey = _json['orderingKey'] as core.String; |
| } |
| if (_json.containsKey('publishTime')) { |
| publishTime = _json['publishTime'] as core.String; |
| } |
| } |
| |
| core.Map<core.String, core.dynamic> toJson() => { |
| if (attributes != null) 'attributes': attributes!, |
| if (data != null) 'data': data!, |
| if (messageId != null) 'messageId': messageId!, |
| if (orderingKey != null) 'orderingKey': orderingKey!, |
| if (publishTime != null) 'publishTime': publishTime!, |
| }; |
| } |
| |
| /// Pub/Sub target. |
| /// |
| /// The job will be delivered by publishing a message to the given Pub/Sub |
| /// topic. |
| class PubsubTarget { |
| /// Attributes for PubsubMessage. |
| /// |
| /// Pubsub message must contain either non-empty data, or at least one |
| /// attribute. |
| core.Map<core.String, core.String>? attributes; |
| |
| /// The message payload for PubsubMessage. |
| /// |
| /// Pubsub message must contain either non-empty data, or at least one |
| /// attribute. |
| core.String? data; |
| core.List<core.int> get dataAsBytes => convert.base64.decode(data!); |
| |
| set dataAsBytes(core.List<core.int> _bytes) { |
| data = |
| convert.base64.encode(_bytes).replaceAll('/', '_').replaceAll('+', '-'); |
| } |
| |
| /// The name of the Cloud Pub/Sub topic to which messages will be published |
| /// when a job is delivered. |
| /// |
| /// The topic name must be in the same format as required by PubSub's |
| /// [PublishRequest.name](https://cloud.google.com/pubsub/docs/reference/rpc/google.pubsub.v1#publishrequest), |
| /// for example `projects/PROJECT_ID/topics/TOPIC_ID`. The topic must be in |
| /// the same project as the Cloud Scheduler job. |
| /// |
| /// Required. |
| core.String? topicName; |
| |
| PubsubTarget(); |
| |
| PubsubTarget.fromJson(core.Map _json) { |
| if (_json.containsKey('attributes')) { |
| attributes = |
| (_json['attributes'] as core.Map<core.String, core.dynamic>).map( |
| (key, item) => core.MapEntry( |
| key, |
| item as core.String, |
| ), |
| ); |
| } |
| if (_json.containsKey('data')) { |
| data = _json['data'] as core.String; |
| } |
| if (_json.containsKey('topicName')) { |
| topicName = _json['topicName'] as core.String; |
| } |
| } |
| |
| core.Map<core.String, core.dynamic> toJson() => { |
| if (attributes != null) 'attributes': attributes!, |
| if (data != null) 'data': data!, |
| if (topicName != null) 'topicName': topicName!, |
| }; |
| } |
| |
| /// Request message for ResumeJob. |
| class ResumeJobRequest { |
| ResumeJobRequest(); |
| |
| ResumeJobRequest.fromJson( |
| // ignore: avoid_unused_constructor_parameters |
| core.Map _json); |
| |
| core.Map<core.String, core.dynamic> toJson() => {}; |
| } |
| |
| /// Settings that determine the retry behavior. |
| /// |
| /// By default, if a job does not complete successfully (meaning that an |
| /// acknowledgement is not received from the handler, then it will be retried |
| /// with exponential backoff according to the settings in RetryConfig. |
| class RetryConfig { |
| /// The maximum amount of time to wait before retrying a job after it fails. |
| /// |
| /// The default value of this field is 1 hour. |
| core.String? maxBackoffDuration; |
| |
| /// 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. |
| core.int? maxDoublings; |
| |
| /// 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 limits |
| /// are reached. The default value for max_retry_duration is zero, which means |
| /// retry duration is unlimited. |
| core.String? maxRetryDuration; |
| |
| /// The minimum amount of time to wait before retrying a job after it fails. |
| /// |
| /// The default value of this field is 5 seconds. |
| core.String? minBackoffDuration; |
| |
| /// The number of attempts that the system will make to run a job using the |
| /// exponential backoff procedure described by max_doublings. |
| /// |
| /// The default value of retry_count is zero. If retry_count is zero, a job |
| /// attempt will *not* be retried if it fails. Instead the Cloud Scheduler |
| /// system will wait for the next scheduled execution time. If retry_count is |
| /// set to a non-zero number then Cloud Scheduler will retry failed attempts, |
| /// using exponential backoff, retry_count times, or until the next scheduled |
| /// execution time, whichever comes first. Values greater than 5 and negative |
| /// values are not allowed. |
| core.int? retryCount; |
| |
| RetryConfig(); |
| |
| RetryConfig.fromJson(core.Map _json) { |
| if (_json.containsKey('maxBackoffDuration')) { |
| maxBackoffDuration = _json['maxBackoffDuration'] as core.String; |
| } |
| if (_json.containsKey('maxDoublings')) { |
| maxDoublings = _json['maxDoublings'] as core.int; |
| } |
| if (_json.containsKey('maxRetryDuration')) { |
| maxRetryDuration = _json['maxRetryDuration'] as core.String; |
| } |
| if (_json.containsKey('minBackoffDuration')) { |
| minBackoffDuration = _json['minBackoffDuration'] as core.String; |
| } |
| if (_json.containsKey('retryCount')) { |
| retryCount = _json['retryCount'] as core.int; |
| } |
| } |
| |
| core.Map<core.String, core.dynamic> toJson() => { |
| if (maxBackoffDuration != null) |
| 'maxBackoffDuration': maxBackoffDuration!, |
| if (maxDoublings != null) 'maxDoublings': maxDoublings!, |
| if (maxRetryDuration != null) 'maxRetryDuration': maxRetryDuration!, |
| if (minBackoffDuration != null) |
| 'minBackoffDuration': minBackoffDuration!, |
| if (retryCount != null) 'retryCount': retryCount!, |
| }; |
| } |
| |
| /// Request message for forcing a job to run now using RunJob. |
| class RunJobRequest { |
| RunJobRequest(); |
| |
| RunJobRequest.fromJson( |
| // ignore: avoid_unused_constructor_parameters |
| core.Map _json); |
| |
| core.Map<core.String, core.dynamic> toJson() => {}; |
| } |
| |
| /// The `Status` type defines a logical error model that is suitable for |
| /// different programming environments, including REST APIs and RPC APIs. |
| /// |
| /// It is used by [gRPC](https://github.com/grpc). Each `Status` message |
| /// contains three pieces of data: error code, error message, and error details. |
| /// 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). |
| class Status { |
| /// The status code, which should be an enum value of google.rpc.Code. |
| core.int? code; |
| |
| /// A list of messages that carry the error details. |
| /// |
| /// There is a common set of message types for APIs to use. |
| /// |
| /// The values for Object must be JSON objects. It can consist of `num`, |
| /// `String`, `bool` and `null` as well as `Map` and `List` values. |
| core.List<core.Map<core.String, core.Object>>? details; |
| |
| /// 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. |
| core.String? message; |
| |
| Status(); |
| |
| Status.fromJson(core.Map _json) { |
| if (_json.containsKey('code')) { |
| code = _json['code'] as core.int; |
| } |
| if (_json.containsKey('details')) { |
| details = (_json['details'] as core.List) |
| .map<core.Map<core.String, core.Object>>( |
| (value) => (value as core.Map<core.String, core.dynamic>).map( |
| (key, item) => core.MapEntry( |
| key, |
| item as core.Object, |
| ), |
| )) |
| .toList(); |
| } |
| if (_json.containsKey('message')) { |
| message = _json['message'] as core.String; |
| } |
| } |
| |
| core.Map<core.String, core.dynamic> toJson() => { |
| if (code != null) 'code': code!, |
| if (details != null) 'details': details!, |
| if (message != null) 'message': message!, |
| }; |
| } |