• Home
• com.google.apis
• google-api-services-compute
• beta-rev20220312-1.32.1
• source code
• UrlMap.html

×

Project download

Many resources are needed to download a project. Please understand that we have to compensate our server costs. Thank you in advance.
Project price only 1 $

You can buy this project and download/modify it how often you want.

target.apidocs.com.google.api.services.compute.model.UrlMap.html Maven / Gradle / Ivy

Skip navigation links




Overview
Package
Class
Use
Tree
Deprecated
Index
Help




Prev Class
Next Class


Frames
No Frames


All Classes






Summary: 
Nested | 
Field | 
Constr | 
Method


Detail: 
Field | 
Constr | 
Method








com.google.api.services.compute.model
Class UrlMap



java.lang.Object


java.util.AbstractMap<String,Object>


com.google.api.client.util.GenericData


com.google.api.client.json.GenericJson


com.google.api.services.compute.model.UrlMap













All Implemented Interfaces:
Cloneable, Map<String,Object>




public final class UrlMap
extends GenericJson
Represents a URL Map resource. Compute Engine has two URL Map resources: *
 [Global](/compute/docs/reference/rest/beta/urlMaps) *
 [Regional](/compute/docs/reference/rest/beta/regionUrlMaps) A URL map resource is a component of
 certain types of cloud load balancers and Traffic Director: * urlMaps are used by external
 HTTP(S) load balancers and Traffic Director. * regionUrlMaps are used by internal HTTP(S) 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 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.












Nested Class Summary




Nested classes/interfaces inherited from class com.google.api.client.util.GenericData
GenericData.Flags





Nested classes/interfaces inherited from class java.util.AbstractMap
AbstractMap.SimpleEntry<K,V>, AbstractMap.SimpleImmutableEntry<K,V>





Nested classes/interfaces inherited from interface java.util.Map
Map.Entry<K,V>








Constructor Summary

Constructors 

Constructor and Description


UrlMap() 









Method Summary

All Methods Instance Methods Concrete Methods 

Modifier and Type
Method and Description


UrlMap
clone() 


byte[]
decodeFingerprint()
Fingerprint of this resource.



UrlMap
encodeFingerprint(byte[] fingerprint)
Fingerprint of this resource.



String
getCreationTimestamp()
[Output Only] Creation timestamp in RFC3339 text format.



HttpRouteAction
getDefaultRouteAction()
defaultRouteAction takes effect when none of the hostRules match.



String
getDefaultService()
The full or partial URL of the defaultService resource to which traffic is directed if none of
 the hostRules match.



HttpRedirectAction
getDefaultUrlRedirect()
When none of the specified hostRules match, the request is redirected to a URL specified by
 defaultUrlRedirect.



String
getDescription()
An optional description of this resource.



String
getFingerprint()
Fingerprint of this resource.



HttpHeaderAction
getHeaderAction()
Specifies changes to request and response headers that need to take effect for the selected
 backendService.



List<HostRule>
getHostRules()
The list of host rules to use against the URL.



BigInteger
getId()
[Output Only] The unique identifier for the resource.



String
getKind()
[Output Only] Type of the resource.



String
getName()
Name of the resource.



List<PathMatcher>
getPathMatchers()
The list of named PathMatchers to use against the URL.



String
getRegion()
[Output Only] URL of the region where the regional URL map resides.



String
getSelfLink()
[Output Only] Server-defined URL for the resource.



List<UrlMapTest>
getTests()
The list of expected URL mapping tests.



UrlMap
set(String fieldName,
   Object value) 


UrlMap
setCreationTimestamp(String creationTimestamp)
[Output Only] Creation timestamp in RFC3339 text format.



UrlMap
setDefaultRouteAction(HttpRouteAction defaultRouteAction)
defaultRouteAction takes effect when none of the hostRules match.



UrlMap
setDefaultService(String defaultService)
The full or partial URL of the defaultService resource to which traffic is directed if none of
 the hostRules match.



UrlMap
setDefaultUrlRedirect(HttpRedirectAction defaultUrlRedirect)
When none of the specified hostRules match, the request is redirected to a URL specified by
 defaultUrlRedirect.



UrlMap
setDescription(String description)
An optional description of this resource.



UrlMap
setFingerprint(String fingerprint)
Fingerprint of this resource.



UrlMap
setHeaderAction(HttpHeaderAction headerAction)
Specifies changes to request and response headers that need to take effect for the selected
 backendService.



UrlMap
setHostRules(List<HostRule> hostRules)
The list of host rules to use against the URL.



UrlMap
setId(BigInteger id)
[Output Only] The unique identifier for the resource.



UrlMap
setKind(String kind)
[Output Only] Type of the resource.



UrlMap
setName(String name)
Name of the resource.



UrlMap
setPathMatchers(List<PathMatcher> pathMatchers)
The list of named PathMatchers to use against the URL.



UrlMap
setRegion(String region)
[Output Only] URL of the region where the regional URL map resides.



UrlMap
setSelfLink(String selfLink)
[Output Only] Server-defined URL for the resource.



UrlMap
setTests(List<UrlMapTest> tests)
The list of expected URL mapping tests.







Methods inherited from class com.google.api.client.json.GenericJson
getFactory, setFactory, toPrettyString, toString





Methods inherited from class com.google.api.client.util.GenericData
entrySet, equals, get, getClassInfo, getUnknownKeys, hashCode, put, putAll, remove, setUnknownKeys





Methods inherited from class java.util.AbstractMap
clear, containsKey, containsValue, isEmpty, keySet, size, values





Methods inherited from class java.lang.Object
finalize, getClass, notify, notifyAll, wait, wait, wait





Methods inherited from interface java.util.Map
compute, computeIfAbsent, computeIfPresent, forEach, getOrDefault, merge, putIfAbsent, remove, replace, replace, replaceAll














Constructor Detail





UrlMap
public UrlMap()









Method Detail





getCreationTimestamp
public String getCreationTimestamp()
[Output Only] Creation timestamp in RFC3339 text format.

Returns:
value or null for none








setCreationTimestamp
public UrlMap setCreationTimestamp(String creationTimestamp)
[Output Only] Creation timestamp in RFC3339 text format.

Parameters:
creationTimestamp - creationTimestamp or null for none








getDefaultRouteAction
public HttpRouteAction getDefaultRouteAction()
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. If defaultRouteAction specifies any
 weightedBackendServices, defaultService must not be set. Conversely if defaultService is set,
 defaultRouteAction cannot contain any weightedBackendServices. Only one of defaultRouteAction
 or defaultUrlRedirect must be set. UrlMaps for external HTTP(S) load balancers support only 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.

Returns:
value or null for none








setDefaultRouteAction
public UrlMap setDefaultRouteAction(HttpRouteAction 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. If defaultRouteAction specifies any
 weightedBackendServices, defaultService must not be set. Conversely if defaultService is set,
 defaultRouteAction cannot contain any weightedBackendServices. Only one of defaultRouteAction
 or defaultUrlRedirect must be set. UrlMaps for external HTTP(S) load balancers support only 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.

Parameters:
defaultRouteAction - defaultRouteAction or null for none








getDefaultService
public String getDefaultService()
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. However, if defaultService
 is specified, defaultRouteAction cannot contain any weightedBackendServices. Conversely, if
 routeAction specifies any weightedBackendServices, service must not be specified. Only one of
 defaultService, defaultUrlRedirect , or defaultRouteAction.weightedBackendService must 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.

Returns:
value or null for none








setDefaultService
public UrlMap setDefaultService(String 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. However, if defaultService
 is specified, defaultRouteAction cannot contain any weightedBackendServices. Conversely, if
 routeAction specifies any weightedBackendServices, service must not be specified. Only one of
 defaultService, defaultUrlRedirect , or defaultRouteAction.weightedBackendService must 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.

Parameters:
defaultService - defaultService or null for none








getDefaultUrlRedirect
public HttpRedirectAction getDefaultUrlRedirect()
When none of the specified hostRules match, the request is redirected to a URL specified by
 defaultUrlRedirect. If defaultUrlRedirect is specified, defaultService or defaultRouteAction
 must not be set. Not supported when the URL map is bound to a target gRPC proxy.

Returns:
value or null for none








setDefaultUrlRedirect
public UrlMap setDefaultUrlRedirect(HttpRedirectAction defaultUrlRedirect)
When none of the specified hostRules match, the request is redirected to a URL specified by
 defaultUrlRedirect. If defaultUrlRedirect is specified, defaultService or defaultRouteAction
 must not be set. Not supported when the URL map is bound to a target gRPC proxy.

Parameters:
defaultUrlRedirect - defaultUrlRedirect or null for none








getDescription
public String getDescription()
An optional description of this resource. Provide this property when you create the resource.

Returns:
value or null for none








setDescription
public UrlMap setDescription(String description)
An optional description of this resource. Provide this property when you create the resource.

Parameters:
description - description or null for none








getFingerprint
public String getFingerprint()
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.

Returns:
value or null for none
See Also:
decodeFingerprint()








decodeFingerprint
public byte[] decodeFingerprint()
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.

Returns:
Base64 decoded value or null for none
Since:
1.14
See Also:
getFingerprint()








setFingerprint
public UrlMap setFingerprint(String 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.

Parameters:
fingerprint - fingerprint or null for none
See Also:
#encodeFingerprint()








encodeFingerprint
public UrlMap encodeFingerprint(byte[] 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.

Since:
1.14
See Also:

 The value is encoded Base64 or {@code null} for none.
 








getHeaderAction
public HttpHeaderAction getHeaderAction()
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.

Returns:
value or null for none








setHeaderAction
public UrlMap setHeaderAction(HttpHeaderAction 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.

Parameters:
headerAction - headerAction or null for none








getHostRules
public List<HostRule> getHostRules()
The list of host rules to use against the URL.

Returns:
value or null for none








setHostRules
public UrlMap setHostRules(List<HostRule> hostRules)
The list of host rules to use against the URL.

Parameters:
hostRules - hostRules or null for none








getId
public BigInteger getId()
[Output Only] The unique identifier for the resource. This identifier is defined by the server.

Returns:
value or null for none








setId
public UrlMap setId(BigInteger id)
[Output Only] The unique identifier for the resource. This identifier is defined by the server.

Parameters:
id - id or null for none








getKind
public String getKind()
[Output Only] Type of the resource. Always compute#urlMaps for url maps.

Returns:
value or null for none








setKind
public UrlMap setKind(String kind)
[Output Only] Type of the resource. Always compute#urlMaps for url maps.

Parameters:
kind - kind or null for none








getName
public String getName()
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.

Returns:
value or null for none








setName
public UrlMap setName(String 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.

Parameters:
name - name or null for none








getPathMatchers
public List<PathMatcher> getPathMatchers()
The list of named PathMatchers to use against the URL.

Returns:
value or null for none








setPathMatchers
public UrlMap setPathMatchers(List<PathMatcher> pathMatchers)
The list of named PathMatchers to use against the URL.

Parameters:
pathMatchers - pathMatchers or null for none








getRegion
public String getRegion()
[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.

Returns:
value or null for none








setRegion
public UrlMap setRegion(String 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.

Parameters:
region - region or null for none








getSelfLink
public String getSelfLink()
[Output Only] Server-defined URL for the resource.

Returns:
value or null for none








setSelfLink
public UrlMap setSelfLink(String selfLink)
[Output Only] Server-defined URL for the resource.

Parameters:
selfLink - selfLink or null for none








getTests
public List<UrlMapTest> getTests()
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.

Returns:
value or null for none








setTests
public UrlMap setTests(List<UrlMapTest> 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.

Parameters:
tests - tests or null for none








set
public UrlMap set(String fieldName,
                  Object value)

Overrides:
set in class GenericJson








clone
public UrlMap clone()

Overrides:
clone in class GenericJson














Skip navigation links




Overview
Package
Class
Use
Tree
Deprecated
Index
Help




Prev Class
Next Class


Frames
No Frames


All Classes






Summary: 
Nested | 
Field | 
Constr | 
Method


Detail: 
Field | 
Constr | 
Method






Copyright © 2011–2022 Google. All rights reserved.