com.google.api.services.compute.model.UrlMap Maven / Gradle / Ivy
The newest version!
/*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except
* in compliance with the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software distributed under the License
* is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express
* or implied. See the License for the specific language governing permissions and limitations under
* the License.
*/
/*
* This code was generated by https://github.com/googleapis/google-api-java-client-services/
* Modify at your own risk.
*/
package com.google.api.services.compute.model;
/**
* Represents a URL Map resource. Compute Engine has two URL Map resources: *
* [Global](/compute/docs/reference/rest/v1/urlMaps) *
* [Regional](/compute/docs/reference/rest/v1/regionUrlMaps) A URL map resource is a component of
* certain types of cloud load balancers and Traffic Director: * urlMaps are used by global external
* Application Load Balancers, classic Application Load Balancers, and cross-region internal
* Application Load Balancers. * regionUrlMaps are used by internal Application Load Balancers,
* regional external Application Load Balancers and regional internal Application Load Balancers.
* For a list of supported URL map features by the load balancer type, see the Load balancing
* features: Routing and traffic management table. For a list of supported URL map features for
* Traffic Director, see the Traffic Director features: Routing and traffic management table. This
* resource defines mappings from hostnames and URL paths to either a backend service or a backend
* bucket. To use the global urlMaps resource, the backend service must have a loadBalancingScheme
* of either EXTERNAL, EXTERNAL_MANAGED, or INTERNAL_SELF_MANAGED. To use the regionUrlMaps
* resource, the backend service must have a loadBalancingScheme of INTERNAL_MANAGED. For more
* information, read URL Map Concepts.
*
* This is the Java data model class that specifies how to parse/serialize into the JSON that is
* transmitted over HTTP when working with the Compute Engine API. For a detailed explanation see:
* https://developers.google.com/api-client-library/java/google-http-java-client/json
*
*
* @author Google, Inc.
*/
@SuppressWarnings("javadoc")
public final class UrlMap extends com.google.api.client.json.GenericJson {
/**
* [Output Only] Creation timestamp in RFC3339 text format.
* The value may be {@code null}.
*/
@com.google.api.client.util.Key
private java.lang.String creationTimestamp;
/**
* defaultCustomErrorResponsePolicy specifies how the Load Balancer returns error responses when
* BackendServiceor BackendBucket responds with an error. This policy takes effect at the load
* balancer level and applies only when no policy has been defined for the error code at lower
* levels like PathMatcher, RouteRule and PathRule within this UrlMap. For example, consider a
* UrlMap with the following configuration: - defaultCustomErrorResponsePolicy containing policies
* for responding to 5xx and 4xx errors - A PathMatcher configured for *.example.com has
* defaultCustomErrorResponsePolicy for 4xx. If a request for http://www.example.com/ encounters a
* 404, the policy in pathMatcher.defaultCustomErrorResponsePolicy will be enforced. When the
* request for http://www.example.com/ encounters a 502, the policy in
* UrlMap.defaultCustomErrorResponsePolicy will be enforced. When a request that does not match
* any host in *.example.com such as http://www.myotherexample.com/, encounters a 404,
* UrlMap.defaultCustomErrorResponsePolicy takes effect. When used in conjunction with
* defaultRouteAction.retryPolicy, retries take precedence. Only once all retries are exhausted,
* the defaultCustomErrorResponsePolicy is applied. While attempting a retry, if load balancer is
* successful in reaching the service, the defaultCustomErrorResponsePolicy is ignored and the
* response from the service is returned to the client. defaultCustomErrorResponsePolicy is
* supported only for global external Application Load Balancers.
* The value may be {@code null}.
*/
@com.google.api.client.util.Key
private CustomErrorResponsePolicy defaultCustomErrorResponsePolicy;
/**
* defaultRouteAction takes effect when none of the hostRules match. The load balancer performs
* advanced routing actions, such as URL rewrites and header transformations, before forwarding
* the request to the selected backend. Only one of defaultUrlRedirect, defaultService or
* defaultRouteAction.weightedBackendService can be set. URL maps for classic Application Load
* Balancers only support the urlRewrite action within defaultRouteAction. defaultRouteAction has
* no effect when the URL map is bound to a target gRPC proxy that has the validateForProxyless
* field set to true.
* The value may be {@code null}.
*/
@com.google.api.client.util.Key
private HttpRouteAction defaultRouteAction;
/**
* The full or partial URL of the defaultService resource to which traffic is directed if none of
* the hostRules match. If defaultRouteAction is also specified, advanced routing actions, such as
* URL rewrites, take effect before sending the request to the backend. Only one of
* defaultUrlRedirect, defaultService or defaultRouteAction.weightedBackendService can be set.
* defaultService has no effect when the URL map is bound to a target gRPC proxy that has the
* validateForProxyless field set to true.
* The value may be {@code null}.
*/
@com.google.api.client.util.Key
private java.lang.String defaultService;
/**
* When none of the specified hostRules match, the request is redirected to a URL specified by
* defaultUrlRedirect. Only one of defaultUrlRedirect, defaultService or
* defaultRouteAction.weightedBackendService can be set. Not supported when the URL map is bound
* to a target gRPC proxy.
* The value may be {@code null}.
*/
@com.google.api.client.util.Key
private HttpRedirectAction defaultUrlRedirect;
/**
* An optional description of this resource. Provide this property when you create the resource.
* The value may be {@code null}.
*/
@com.google.api.client.util.Key
private java.lang.String description;
/**
* Fingerprint of this resource. A hash of the contents stored in this object. This field is used
* in optimistic locking. This field is ignored when inserting a UrlMap. An up-to-date fingerprint
* must be provided in order to update the UrlMap, otherwise the request will fail with error 412
* conditionNotMet. To see the latest fingerprint, make a get() request to retrieve a UrlMap.
* The value may be {@code null}.
*/
@com.google.api.client.util.Key
private java.lang.String fingerprint;
/**
* Specifies changes to request and response headers that need to take effect for the selected
* backendService. The headerAction specified here take effect after headerAction specified under
* pathMatcher. headerAction is not supported for load balancers that have their
* loadBalancingScheme set to EXTERNAL. Not supported when the URL map is bound to a target gRPC
* proxy that has validateForProxyless field set to true.
* The value may be {@code null}.
*/
@com.google.api.client.util.Key
private HttpHeaderAction headerAction;
/**
* The list of host rules to use against the URL.
* The value may be {@code null}.
*/
@com.google.api.client.util.Key
private java.util.List hostRules;
static {
// hack to force ProGuard to consider HostRule used, since otherwise it would be stripped out
// see https://github.com/google/google-api-java-client/issues/543
com.google.api.client.util.Data.nullOf(HostRule.class);
}
/**
* [Output Only] The unique identifier for the resource. This identifier is defined by the server.
* The value may be {@code null}.
*/
@com.google.api.client.util.Key @com.google.api.client.json.JsonString
private java.math.BigInteger id;
/**
* [Output Only] Type of the resource. Always compute#urlMaps for url maps.
* The value may be {@code null}.
*/
@com.google.api.client.util.Key
private java.lang.String kind;
/**
* Name of the resource. Provided by the client when the resource is created. The name must be
* 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters
* long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first
* character must be a lowercase letter, and all following characters must be a dash, lowercase
* letter, or digit, except the last character, which cannot be a dash.
* The value may be {@code null}.
*/
@com.google.api.client.util.Key
private java.lang.String name;
/**
* The list of named PathMatchers to use against the URL.
* The value may be {@code null}.
*/
@com.google.api.client.util.Key
private java.util.List pathMatchers;
static {
// hack to force ProGuard to consider PathMatcher used, since otherwise it would be stripped out
// see https://github.com/google/google-api-java-client/issues/543
com.google.api.client.util.Data.nullOf(PathMatcher.class);
}
/**
* [Output Only] URL of the region where the regional URL map resides. This field is not
* applicable to global URL maps. You must specify this field as part of the HTTP request URL. It
* is not settable as a field in the request body.
* The value may be {@code null}.
*/
@com.google.api.client.util.Key
private java.lang.String region;
/**
* [Output Only] Server-defined URL for the resource.
* The value may be {@code null}.
*/
@com.google.api.client.util.Key
private java.lang.String selfLink;
/**
* The list of expected URL mapping tests. Request to update the UrlMap succeeds only if all test
* cases pass. You can specify a maximum of 100 tests per UrlMap. Not supported when the URL map
* is bound to a target gRPC proxy that has validateForProxyless field set to true.
* The value may be {@code null}.
*/
@com.google.api.client.util.Key
private java.util.List tests;
/**
* [Output Only] Creation timestamp in RFC3339 text format.
* @return value or {@code null} for none
*/
public java.lang.String getCreationTimestamp() {
return creationTimestamp;
}
/**
* [Output Only] Creation timestamp in RFC3339 text format.
* @param creationTimestamp creationTimestamp or {@code null} for none
*/
public UrlMap setCreationTimestamp(java.lang.String creationTimestamp) {
this.creationTimestamp = creationTimestamp;
return this;
}
/**
* defaultCustomErrorResponsePolicy specifies how the Load Balancer returns error responses when
* BackendServiceor BackendBucket responds with an error. This policy takes effect at the load
* balancer level and applies only when no policy has been defined for the error code at lower
* levels like PathMatcher, RouteRule and PathRule within this UrlMap. For example, consider a
* UrlMap with the following configuration: - defaultCustomErrorResponsePolicy containing policies
* for responding to 5xx and 4xx errors - A PathMatcher configured for *.example.com has
* defaultCustomErrorResponsePolicy for 4xx. If a request for http://www.example.com/ encounters a
* 404, the policy in pathMatcher.defaultCustomErrorResponsePolicy will be enforced. When the
* request for http://www.example.com/ encounters a 502, the policy in
* UrlMap.defaultCustomErrorResponsePolicy will be enforced. When a request that does not match
* any host in *.example.com such as http://www.myotherexample.com/, encounters a 404,
* UrlMap.defaultCustomErrorResponsePolicy takes effect. When used in conjunction with
* defaultRouteAction.retryPolicy, retries take precedence. Only once all retries are exhausted,
* the defaultCustomErrorResponsePolicy is applied. While attempting a retry, if load balancer is
* successful in reaching the service, the defaultCustomErrorResponsePolicy is ignored and the
* response from the service is returned to the client. defaultCustomErrorResponsePolicy is
* supported only for global external Application Load Balancers.
* @return value or {@code null} for none
*/
public CustomErrorResponsePolicy getDefaultCustomErrorResponsePolicy() {
return defaultCustomErrorResponsePolicy;
}
/**
* defaultCustomErrorResponsePolicy specifies how the Load Balancer returns error responses when
* BackendServiceor BackendBucket responds with an error. This policy takes effect at the load
* balancer level and applies only when no policy has been defined for the error code at lower
* levels like PathMatcher, RouteRule and PathRule within this UrlMap. For example, consider a
* UrlMap with the following configuration: - defaultCustomErrorResponsePolicy containing policies
* for responding to 5xx and 4xx errors - A PathMatcher configured for *.example.com has
* defaultCustomErrorResponsePolicy for 4xx. If a request for http://www.example.com/ encounters a
* 404, the policy in pathMatcher.defaultCustomErrorResponsePolicy will be enforced. When the
* request for http://www.example.com/ encounters a 502, the policy in
* UrlMap.defaultCustomErrorResponsePolicy will be enforced. When a request that does not match
* any host in *.example.com such as http://www.myotherexample.com/, encounters a 404,
* UrlMap.defaultCustomErrorResponsePolicy takes effect. When used in conjunction with
* defaultRouteAction.retryPolicy, retries take precedence. Only once all retries are exhausted,
* the defaultCustomErrorResponsePolicy is applied. While attempting a retry, if load balancer is
* successful in reaching the service, the defaultCustomErrorResponsePolicy is ignored and the
* response from the service is returned to the client. defaultCustomErrorResponsePolicy is
* supported only for global external Application Load Balancers.
* @param defaultCustomErrorResponsePolicy defaultCustomErrorResponsePolicy or {@code null} for none
*/
public UrlMap setDefaultCustomErrorResponsePolicy(CustomErrorResponsePolicy defaultCustomErrorResponsePolicy) {
this.defaultCustomErrorResponsePolicy = defaultCustomErrorResponsePolicy;
return this;
}
/**
* defaultRouteAction takes effect when none of the hostRules match. The load balancer performs
* advanced routing actions, such as URL rewrites and header transformations, before forwarding
* the request to the selected backend. Only one of defaultUrlRedirect, defaultService or
* defaultRouteAction.weightedBackendService can be set. URL maps for classic Application Load
* Balancers only support the urlRewrite action within defaultRouteAction. defaultRouteAction has
* no effect when the URL map is bound to a target gRPC proxy that has the validateForProxyless
* field set to true.
* @return value or {@code null} for none
*/
public HttpRouteAction getDefaultRouteAction() {
return defaultRouteAction;
}
/**
* defaultRouteAction takes effect when none of the hostRules match. The load balancer performs
* advanced routing actions, such as URL rewrites and header transformations, before forwarding
* the request to the selected backend. Only one of defaultUrlRedirect, defaultService or
* defaultRouteAction.weightedBackendService can be set. URL maps for classic Application Load
* Balancers only support the urlRewrite action within defaultRouteAction. defaultRouteAction has
* no effect when the URL map is bound to a target gRPC proxy that has the validateForProxyless
* field set to true.
* @param defaultRouteAction defaultRouteAction or {@code null} for none
*/
public UrlMap setDefaultRouteAction(HttpRouteAction defaultRouteAction) {
this.defaultRouteAction = defaultRouteAction;
return this;
}
/**
* The full or partial URL of the defaultService resource to which traffic is directed if none of
* the hostRules match. If defaultRouteAction is also specified, advanced routing actions, such as
* URL rewrites, take effect before sending the request to the backend. Only one of
* defaultUrlRedirect, defaultService or defaultRouteAction.weightedBackendService can be set.
* defaultService has no effect when the URL map is bound to a target gRPC proxy that has the
* validateForProxyless field set to true.
* @return value or {@code null} for none
*/
public java.lang.String getDefaultService() {
return defaultService;
}
/**
* The full or partial URL of the defaultService resource to which traffic is directed if none of
* the hostRules match. If defaultRouteAction is also specified, advanced routing actions, such as
* URL rewrites, take effect before sending the request to the backend. Only one of
* defaultUrlRedirect, defaultService or defaultRouteAction.weightedBackendService can be set.
* defaultService has no effect when the URL map is bound to a target gRPC proxy that has the
* validateForProxyless field set to true.
* @param defaultService defaultService or {@code null} for none
*/
public UrlMap setDefaultService(java.lang.String defaultService) {
this.defaultService = defaultService;
return this;
}
/**
* When none of the specified hostRules match, the request is redirected to a URL specified by
* defaultUrlRedirect. Only one of defaultUrlRedirect, defaultService or
* defaultRouteAction.weightedBackendService can be set. Not supported when the URL map is bound
* to a target gRPC proxy.
* @return value or {@code null} for none
*/
public HttpRedirectAction getDefaultUrlRedirect() {
return defaultUrlRedirect;
}
/**
* When none of the specified hostRules match, the request is redirected to a URL specified by
* defaultUrlRedirect. Only one of defaultUrlRedirect, defaultService or
* defaultRouteAction.weightedBackendService can be set. Not supported when the URL map is bound
* to a target gRPC proxy.
* @param defaultUrlRedirect defaultUrlRedirect or {@code null} for none
*/
public UrlMap setDefaultUrlRedirect(HttpRedirectAction defaultUrlRedirect) {
this.defaultUrlRedirect = defaultUrlRedirect;
return this;
}
/**
* An optional description of this resource. Provide this property when you create the resource.
* @return value or {@code null} for none
*/
public java.lang.String getDescription() {
return description;
}
/**
* An optional description of this resource. Provide this property when you create the resource.
* @param description description or {@code null} for none
*/
public UrlMap setDescription(java.lang.String description) {
this.description = description;
return this;
}
/**
* Fingerprint of this resource. A hash of the contents stored in this object. This field is used
* in optimistic locking. This field is ignored when inserting a UrlMap. An up-to-date fingerprint
* must be provided in order to update the UrlMap, otherwise the request will fail with error 412
* conditionNotMet. To see the latest fingerprint, make a get() request to retrieve a UrlMap.
* @see #decodeFingerprint()
* @return value or {@code null} for none
*/
public java.lang.String getFingerprint() {
return fingerprint;
}
/**
* Fingerprint of this resource. A hash of the contents stored in this object. This field is used
* in optimistic locking. This field is ignored when inserting a UrlMap. An up-to-date fingerprint
* must be provided in order to update the UrlMap, otherwise the request will fail with error 412
* conditionNotMet. To see the latest fingerprint, make a get() request to retrieve a UrlMap.
* @see #getFingerprint()
* @return Base64 decoded value or {@code null} for none
*
* @since 1.14
*/
public byte[] decodeFingerprint() {
return com.google.api.client.util.Base64.decodeBase64(fingerprint);
}
/**
* Fingerprint of this resource. A hash of the contents stored in this object. This field is used
* in optimistic locking. This field is ignored when inserting a UrlMap. An up-to-date fingerprint
* must be provided in order to update the UrlMap, otherwise the request will fail with error 412
* conditionNotMet. To see the latest fingerprint, make a get() request to retrieve a UrlMap.
* @see #encodeFingerprint()
* @param fingerprint fingerprint or {@code null} for none
*/
public UrlMap setFingerprint(java.lang.String fingerprint) {
this.fingerprint = fingerprint;
return this;
}
/**
* Fingerprint of this resource. A hash of the contents stored in this object. This field is used
* in optimistic locking. This field is ignored when inserting a UrlMap. An up-to-date fingerprint
* must be provided in order to update the UrlMap, otherwise the request will fail with error 412
* conditionNotMet. To see the latest fingerprint, make a get() request to retrieve a UrlMap.
* @see #setFingerprint()
*
*
* The value is encoded Base64 or {@code null} for none.
*
*
* @since 1.14
*/
public UrlMap encodeFingerprint(byte[] fingerprint) {
this.fingerprint = com.google.api.client.util.Base64.encodeBase64URLSafeString(fingerprint);
return this;
}
/**
* Specifies changes to request and response headers that need to take effect for the selected
* backendService. The headerAction specified here take effect after headerAction specified under
* pathMatcher. headerAction is not supported for load balancers that have their
* loadBalancingScheme set to EXTERNAL. Not supported when the URL map is bound to a target gRPC
* proxy that has validateForProxyless field set to true.
* @return value or {@code null} for none
*/
public HttpHeaderAction getHeaderAction() {
return headerAction;
}
/**
* Specifies changes to request and response headers that need to take effect for the selected
* backendService. The headerAction specified here take effect after headerAction specified under
* pathMatcher. headerAction is not supported for load balancers that have their
* loadBalancingScheme set to EXTERNAL. Not supported when the URL map is bound to a target gRPC
* proxy that has validateForProxyless field set to true.
* @param headerAction headerAction or {@code null} for none
*/
public UrlMap setHeaderAction(HttpHeaderAction headerAction) {
this.headerAction = headerAction;
return this;
}
/**
* The list of host rules to use against the URL.
* @return value or {@code null} for none
*/
public java.util.List getHostRules() {
return hostRules;
}
/**
* The list of host rules to use against the URL.
* @param hostRules hostRules or {@code null} for none
*/
public UrlMap setHostRules(java.util.List hostRules) {
this.hostRules = hostRules;
return this;
}
/**
* [Output Only] The unique identifier for the resource. This identifier is defined by the server.
* @return value or {@code null} for none
*/
public java.math.BigInteger getId() {
return id;
}
/**
* [Output Only] The unique identifier for the resource. This identifier is defined by the server.
* @param id id or {@code null} for none
*/
public UrlMap setId(java.math.BigInteger id) {
this.id = id;
return this;
}
/**
* [Output Only] Type of the resource. Always compute#urlMaps for url maps.
* @return value or {@code null} for none
*/
public java.lang.String getKind() {
return kind;
}
/**
* [Output Only] Type of the resource. Always compute#urlMaps for url maps.
* @param kind kind or {@code null} for none
*/
public UrlMap setKind(java.lang.String kind) {
this.kind = kind;
return this;
}
/**
* Name of the resource. Provided by the client when the resource is created. The name must be
* 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters
* long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first
* character must be a lowercase letter, and all following characters must be a dash, lowercase
* letter, or digit, except the last character, which cannot be a dash.
* @return value or {@code null} for none
*/
public java.lang.String getName() {
return name;
}
/**
* Name of the resource. Provided by the client when the resource is created. The name must be
* 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters
* long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first
* character must be a lowercase letter, and all following characters must be a dash, lowercase
* letter, or digit, except the last character, which cannot be a dash.
* @param name name or {@code null} for none
*/
public UrlMap setName(java.lang.String name) {
this.name = name;
return this;
}
/**
* The list of named PathMatchers to use against the URL.
* @return value or {@code null} for none
*/
public java.util.List getPathMatchers() {
return pathMatchers;
}
/**
* The list of named PathMatchers to use against the URL.
* @param pathMatchers pathMatchers or {@code null} for none
*/
public UrlMap setPathMatchers(java.util.List pathMatchers) {
this.pathMatchers = pathMatchers;
return this;
}
/**
* [Output Only] URL of the region where the regional URL map resides. This field is not
* applicable to global URL maps. You must specify this field as part of the HTTP request URL. It
* is not settable as a field in the request body.
* @return value or {@code null} for none
*/
public java.lang.String getRegion() {
return region;
}
/**
* [Output Only] URL of the region where the regional URL map resides. This field is not
* applicable to global URL maps. You must specify this field as part of the HTTP request URL. It
* is not settable as a field in the request body.
* @param region region or {@code null} for none
*/
public UrlMap setRegion(java.lang.String region) {
this.region = region;
return this;
}
/**
* [Output Only] Server-defined URL for the resource.
* @return value or {@code null} for none
*/
public java.lang.String getSelfLink() {
return selfLink;
}
/**
* [Output Only] Server-defined URL for the resource.
* @param selfLink selfLink or {@code null} for none
*/
public UrlMap setSelfLink(java.lang.String selfLink) {
this.selfLink = selfLink;
return this;
}
/**
* The list of expected URL mapping tests. Request to update the UrlMap succeeds only if all test
* cases pass. You can specify a maximum of 100 tests per UrlMap. Not supported when the URL map
* is bound to a target gRPC proxy that has validateForProxyless field set to true.
* @return value or {@code null} for none
*/
public java.util.List getTests() {
return tests;
}
/**
* The list of expected URL mapping tests. Request to update the UrlMap succeeds only if all test
* cases pass. You can specify a maximum of 100 tests per UrlMap. Not supported when the URL map
* is bound to a target gRPC proxy that has validateForProxyless field set to true.
* @param tests tests or {@code null} for none
*/
public UrlMap setTests(java.util.List tests) {
this.tests = tests;
return this;
}
@Override
public UrlMap set(String fieldName, Object value) {
return (UrlMap) super.set(fieldName, value);
}
@Override
public UrlMap clone() {
return (UrlMap) super.clone();
}
}
© 2015 - 2025 Weber Informatics LLC | Privacy Policy