Class AppEngineHttpTarget.Builder (2.29.0)

public static final class AppEngineHttpTarget.Builder extends GeneratedMessageV3.Builder<AppEngineHttpTarget.Builder> implements AppEngineHttpTargetOrBuilder

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.

Protobuf type google.cloud.scheduler.v1.AppEngineHttpTarget

Static Methods

getDescriptor()

public static final Descriptors.Descriptor getDescriptor()
Returns
TypeDescription
Descriptor

Methods

addRepeatedField(Descriptors.FieldDescriptor field, Object value)

public AppEngineHttpTarget.Builder addRepeatedField(Descriptors.FieldDescriptor field, Object value)
Parameters
NameDescription
fieldFieldDescriptor
valueObject
Returns
TypeDescription
AppEngineHttpTarget.Builder
Overrides

build()

public AppEngineHttpTarget build()
Returns
TypeDescription
AppEngineHttpTarget

buildPartial()

public AppEngineHttpTarget buildPartial()
Returns
TypeDescription
AppEngineHttpTarget

clear()

public AppEngineHttpTarget.Builder clear()
Returns
TypeDescription
AppEngineHttpTarget.Builder
Overrides

clearAppEngineRouting()

public AppEngineHttpTarget.Builder clearAppEngineRouting()

App Engine Routing setting for the job.

.google.cloud.scheduler.v1.AppEngineRouting app_engine_routing = 2;

Returns
TypeDescription
AppEngineHttpTarget.Builder

clearBody()

public AppEngineHttpTarget.Builder clearBody()

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.

bytes body = 5;

Returns
TypeDescription
AppEngineHttpTarget.Builder

This builder for chaining.

clearField(Descriptors.FieldDescriptor field)

public AppEngineHttpTarget.Builder clearField(Descriptors.FieldDescriptor field)
Parameter
NameDescription
fieldFieldDescriptor
Returns
TypeDescription
AppEngineHttpTarget.Builder
Overrides

clearHeaders()

public AppEngineHttpTarget.Builder clearHeaders()
Returns
TypeDescription
AppEngineHttpTarget.Builder

clearHttpMethod()

public AppEngineHttpTarget.Builder clearHttpMethod()

The HTTP method to use for the request. PATCH and OPTIONS are not permitted.

.google.cloud.scheduler.v1.HttpMethod http_method = 1;

Returns
TypeDescription
AppEngineHttpTarget.Builder

This builder for chaining.

clearOneof(Descriptors.OneofDescriptor oneof)

public AppEngineHttpTarget.Builder clearOneof(Descriptors.OneofDescriptor oneof)
Parameter
NameDescription
oneofOneofDescriptor
Returns
TypeDescription
AppEngineHttpTarget.Builder
Overrides

clearRelativeUri()

public AppEngineHttpTarget.Builder clearRelativeUri()

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.

string relative_uri = 3;

Returns
TypeDescription
AppEngineHttpTarget.Builder

This builder for chaining.

clone()

public AppEngineHttpTarget.Builder clone()
Returns
TypeDescription
AppEngineHttpTarget.Builder
Overrides

containsHeaders(String key)

public boolean containsHeaders(String key)

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.
  • X-CloudScheduler-JobName: This header will contain the job name.
  • X-CloudScheduler-ScheduleTime: For Cloud Scheduler jobs specified in the unix-cron format, this header will contain the job schedule time in RFC3339 UTC "Zulu" format.

    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.

map<string, string> headers = 4;

Parameter
NameDescription
keyString
Returns
TypeDescription
boolean

getAppEngineRouting()

public AppEngineRouting getAppEngineRouting()

App Engine Routing setting for the job.

.google.cloud.scheduler.v1.AppEngineRouting app_engine_routing = 2;

Returns
TypeDescription
AppEngineRouting

The appEngineRouting.

getAppEngineRoutingBuilder()

public AppEngineRouting.Builder getAppEngineRoutingBuilder()

App Engine Routing setting for the job.

.google.cloud.scheduler.v1.AppEngineRouting app_engine_routing = 2;

Returns
TypeDescription
AppEngineRouting.Builder

getAppEngineRoutingOrBuilder()

public AppEngineRoutingOrBuilder getAppEngineRoutingOrBuilder()

App Engine Routing setting for the job.

.google.cloud.scheduler.v1.AppEngineRouting app_engine_routing = 2;

Returns
TypeDescription
AppEngineRoutingOrBuilder

getBody()

public ByteString getBody()

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.

bytes body = 5;

Returns
TypeDescription
ByteString

The body.

getDefaultInstanceForType()

public AppEngineHttpTarget getDefaultInstanceForType()
Returns
TypeDescription
AppEngineHttpTarget

getDescriptorForType()

public Descriptors.Descriptor getDescriptorForType()
Returns
TypeDescription
Descriptor
Overrides

getHeaders()

public Map<String,String> getHeaders()

Use #getHeadersMap() instead.

Returns
TypeDescription
Map<String,String>

getHeadersCount()

public int getHeadersCount()

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.
  • X-CloudScheduler-JobName: This header will contain the job name.
  • X-CloudScheduler-ScheduleTime: For Cloud Scheduler jobs specified in the unix-cron format, this header will contain the job schedule time in RFC3339 UTC "Zulu" format.

    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.

map<string, string> headers = 4;

Returns
TypeDescription
int

getHeadersMap()

public Map<String,String> getHeadersMap()

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.
  • X-CloudScheduler-JobName: This header will contain the job name.
  • X-CloudScheduler-ScheduleTime: For Cloud Scheduler jobs specified in the unix-cron format, this header will contain the job schedule time in RFC3339 UTC "Zulu" format.

    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.

map<string, string> headers = 4;

Returns
TypeDescription
Map<String,String>

getHeadersOrDefault(String key, String defaultValue)

public String getHeadersOrDefault(String key, String defaultValue)

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.
  • X-CloudScheduler-JobName: This header will contain the job name.
  • X-CloudScheduler-ScheduleTime: For Cloud Scheduler jobs specified in the unix-cron format, this header will contain the job schedule time in RFC3339 UTC "Zulu" format.

    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.

map<string, string> headers = 4;

Parameters
NameDescription
keyString
defaultValueString
Returns
TypeDescription
String

getHeadersOrThrow(String key)

public String getHeadersOrThrow(String key)

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.
  • X-CloudScheduler-JobName: This header will contain the job name.
  • X-CloudScheduler-ScheduleTime: For Cloud Scheduler jobs specified in the unix-cron format, this header will contain the job schedule time in RFC3339 UTC "Zulu" format.

    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.

map<string, string> headers = 4;

Parameter
NameDescription
keyString
Returns
TypeDescription
String

getHttpMethod()

public HttpMethod getHttpMethod()

The HTTP method to use for the request. PATCH and OPTIONS are not permitted.

.google.cloud.scheduler.v1.HttpMethod http_method = 1;

Returns
TypeDescription
HttpMethod

The httpMethod.

getHttpMethodValue()

public int getHttpMethodValue()

The HTTP method to use for the request. PATCH and OPTIONS are not permitted.

.google.cloud.scheduler.v1.HttpMethod http_method = 1;

Returns
TypeDescription
int

The enum numeric value on the wire for httpMethod.

getMutableHeaders()

public Map<String,String> getMutableHeaders()

Use alternate mutation accessors instead.

Returns
TypeDescription
Map<String,String>

getRelativeUri()

public String getRelativeUri()

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.

string relative_uri = 3;

Returns
TypeDescription
String

The relativeUri.

getRelativeUriBytes()

public ByteString getRelativeUriBytes()

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.

string relative_uri = 3;

Returns
TypeDescription
ByteString

The bytes for relativeUri.

hasAppEngineRouting()

public boolean hasAppEngineRouting()

App Engine Routing setting for the job.

.google.cloud.scheduler.v1.AppEngineRouting app_engine_routing = 2;

Returns
TypeDescription
boolean

Whether the appEngineRouting field is set.

internalGetFieldAccessorTable()

protected GeneratedMessageV3.FieldAccessorTable internalGetFieldAccessorTable()
Returns
TypeDescription
FieldAccessorTable
Overrides

internalGetMapField(int number)

protected MapField internalGetMapField(int number)
Parameter
NameDescription
numberint
Returns
TypeDescription
MapField
Overrides

internalGetMutableMapField(int number)

protected MapField internalGetMutableMapField(int number)
Parameter
NameDescription
numberint
Returns
TypeDescription
MapField
Overrides

isInitialized()

public final boolean isInitialized()
Returns
TypeDescription
boolean
Overrides

mergeAppEngineRouting(AppEngineRouting value)

public AppEngineHttpTarget.Builder mergeAppEngineRouting(AppEngineRouting value)

App Engine Routing setting for the job.

.google.cloud.scheduler.v1.AppEngineRouting app_engine_routing = 2;

Parameter
NameDescription
valueAppEngineRouting
Returns
TypeDescription
AppEngineHttpTarget.Builder

mergeFrom(AppEngineHttpTarget other)

public AppEngineHttpTarget.Builder mergeFrom(AppEngineHttpTarget other)
Parameter
NameDescription
otherAppEngineHttpTarget
Returns
TypeDescription
AppEngineHttpTarget.Builder

mergeFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)

public AppEngineHttpTarget.Builder mergeFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)
Parameters
NameDescription
inputCodedInputStream
extensionRegistryExtensionRegistryLite
Returns
TypeDescription
AppEngineHttpTarget.Builder
Overrides
Exceptions
TypeDescription
IOException

mergeFrom(Message other)

public AppEngineHttpTarget.Builder mergeFrom(Message other)
Parameter
NameDescription
otherMessage
Returns
TypeDescription
AppEngineHttpTarget.Builder
Overrides

mergeUnknownFields(UnknownFieldSet unknownFields)

public final AppEngineHttpTarget.Builder mergeUnknownFields(UnknownFieldSet unknownFields)
Parameter
NameDescription
unknownFieldsUnknownFieldSet
Returns
TypeDescription
AppEngineHttpTarget.Builder
Overrides

putAllHeaders(Map<String,String> values)

public AppEngineHttpTarget.Builder putAllHeaders(Map<String,String> values)

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.
  • X-CloudScheduler-JobName: This header will contain the job name.
  • X-CloudScheduler-ScheduleTime: For Cloud Scheduler jobs specified in the unix-cron format, this header will contain the job schedule time in RFC3339 UTC "Zulu" format.

    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.

map<string, string> headers = 4;

Parameter
NameDescription
valuesMap<String,String>
Returns
TypeDescription
AppEngineHttpTarget.Builder

putHeaders(String key, String value)

public AppEngineHttpTarget.Builder putHeaders(String key, String value)

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.
  • X-CloudScheduler-JobName: This header will contain the job name.
  • X-CloudScheduler-ScheduleTime: For Cloud Scheduler jobs specified in the unix-cron format, this header will contain the job schedule time in RFC3339 UTC "Zulu" format.

    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.

map<string, string> headers = 4;

Parameters
NameDescription
keyString
valueString
Returns
TypeDescription
AppEngineHttpTarget.Builder

removeHeaders(String key)

public AppEngineHttpTarget.Builder removeHeaders(String key)

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.
  • X-CloudScheduler-JobName: This header will contain the job name.
  • X-CloudScheduler-ScheduleTime: For Cloud Scheduler jobs specified in the unix-cron format, this header will contain the job schedule time in RFC3339 UTC "Zulu" format.

    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.

map<string, string> headers = 4;

Parameter
NameDescription
keyString
Returns
TypeDescription
AppEngineHttpTarget.Builder

setAppEngineRouting(AppEngineRouting value)

public AppEngineHttpTarget.Builder setAppEngineRouting(AppEngineRouting value)

App Engine Routing setting for the job.

.google.cloud.scheduler.v1.AppEngineRouting app_engine_routing = 2;

Parameter
NameDescription
valueAppEngineRouting
Returns
TypeDescription
AppEngineHttpTarget.Builder

setAppEngineRouting(AppEngineRouting.Builder builderForValue)

public AppEngineHttpTarget.Builder setAppEngineRouting(AppEngineRouting.Builder builderForValue)

App Engine Routing setting for the job.

.google.cloud.scheduler.v1.AppEngineRouting app_engine_routing = 2;

Parameter
NameDescription
builderForValueAppEngineRouting.Builder
Returns
TypeDescription
AppEngineHttpTarget.Builder

setBody(ByteString value)

public AppEngineHttpTarget.Builder setBody(ByteString value)

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.

bytes body = 5;

Parameter
NameDescription
valueByteString

The body to set.

Returns
TypeDescription
AppEngineHttpTarget.Builder

This builder for chaining.

setField(Descriptors.FieldDescriptor field, Object value)

public AppEngineHttpTarget.Builder setField(Descriptors.FieldDescriptor field, Object value)
Parameters
NameDescription
fieldFieldDescriptor
valueObject
Returns
TypeDescription
AppEngineHttpTarget.Builder
Overrides

setHttpMethod(HttpMethod value)

public AppEngineHttpTarget.Builder setHttpMethod(HttpMethod value)

The HTTP method to use for the request. PATCH and OPTIONS are not permitted.

.google.cloud.scheduler.v1.HttpMethod http_method = 1;

Parameter
NameDescription
valueHttpMethod

The httpMethod to set.

Returns
TypeDescription
AppEngineHttpTarget.Builder

This builder for chaining.

setHttpMethodValue(int value)

public AppEngineHttpTarget.Builder setHttpMethodValue(int value)

The HTTP method to use for the request. PATCH and OPTIONS are not permitted.

.google.cloud.scheduler.v1.HttpMethod http_method = 1;

Parameter
NameDescription
valueint

The enum numeric value on the wire for httpMethod to set.

Returns
TypeDescription
AppEngineHttpTarget.Builder

This builder for chaining.

setRelativeUri(String value)

public AppEngineHttpTarget.Builder setRelativeUri(String value)

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.

string relative_uri = 3;

Parameter
NameDescription
valueString

The relativeUri to set.

Returns
TypeDescription
AppEngineHttpTarget.Builder

This builder for chaining.

setRelativeUriBytes(ByteString value)

public AppEngineHttpTarget.Builder setRelativeUriBytes(ByteString value)

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.

string relative_uri = 3;

Parameter
NameDescription
valueByteString

The bytes for relativeUri to set.

Returns
TypeDescription
AppEngineHttpTarget.Builder

This builder for chaining.

setRepeatedField(Descriptors.FieldDescriptor field, int index, Object value)

public AppEngineHttpTarget.Builder setRepeatedField(Descriptors.FieldDescriptor field, int index, Object value)
Parameters
NameDescription
fieldFieldDescriptor
indexint
valueObject
Returns
TypeDescription
AppEngineHttpTarget.Builder
Overrides

setUnknownFields(UnknownFieldSet unknownFields)

public final AppEngineHttpTarget.Builder setUnknownFields(UnknownFieldSet unknownFields)
Parameter
NameDescription
unknownFieldsUnknownFieldSet
Returns
TypeDescription
AppEngineHttpTarget.Builder
Overrides