Get

Returns the specified UrlMap resource

2 variables
24 variables

Returns the specified UrlMap resource. Gets a list of available URL maps by making a list() request

Authorization

To use this building block you will have to grant access to at least one of the following scopes:

  • View and manage your data across Google Cloud Platform services
  • View and manage your Google Compute Engine resources
  • View your Google Compute Engine resources

Input

This building block consumes 2 input parameters

  = Parameter name
  = Format

project STRING Required

Project ID for this request

urlMap STRING Required

Name of the UrlMap resource to return

Output

This building block provides 24 output parameters

  = Parameter name
  = Format

creationTimestamp STRING

[Output Only] Creation timestamp in RFC3339 text format

defaultService STRING

The full or partial URL of the defaultService resource to which traffic is directed if none of the hostRules match. If defaultRouteAction is additionally specified, advanced routing actions like URL Rewrites, etc. take effect prior to 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

description STRING

An optional description of this resource. Provide this property when you create the resource

fingerprint BINARY

Fingerprint of this resource. A hash of the contents stored in this object. This field is used in optimistic locking. This field will be 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

hostRules[] OBJECT

UrlMaps A host-matching rule for a URL. If matched, will use the named PathMatcher to select the BackendService

hostRules[].description STRING

An optional description of this resource. Provide this property when you create the resource

hostRules[].hosts[] STRING

hostRules[].pathMatcher STRING

The name of the PathMatcher to use to match the path portion of the URL if the hostRule matches the URL's host portion

id INTEGER

[Output Only] The unique identifier for the resource. This identifier is defined by the server

kind STRING

[Output Only] Type of the resource. Always compute#urlMaps for url maps

name STRING

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

pathMatchers[] OBJECT

A matcher for the path portion of the URL. The BackendService from the longest-matched rule will serve the URL. If no rule was matched, the default service will be used

pathMatchers[].defaultService STRING

The full or partial URL to the BackendService resource. This will be used if none of the pathRules or routeRules defined by this PathMatcher are matched. For example, the following are all valid URLs to a BackendService resource:

  • https://www.googleapis.com/compute/v1/projects/project/global/backendServices/backendService
  • compute/v1/projects/project/global/backendServices/backendService
  • global/backendServices/backendService If defaultRouteAction is additionally specified, advanced routing actions like URL Rewrites, etc. take effect prior to sending the request to the backend. However, if defaultService is specified, defaultRouteAction cannot contain any weightedBackendServices. Conversely, if defaultRouteAction specifies any weightedBackendServices, defaultService must not be specified. Only one of defaultService, defaultUrlRedirect or defaultRouteAction.weightedBackendService must be set. Authorization requires one or more of the following Google IAM permissions on the specified resource default_service:
  • compute.backendBuckets.use
  • compute.backendServices.use

pathMatchers[].description STRING

An optional description of this resource. Provide this property when you create the resource

pathMatchers[].name STRING

The name to which this PathMatcher is referred by the HostRule

pathMatchers[].pathRules[] OBJECT

A path-matching rule for a URL. If matched, will use the specified BackendService to handle the traffic arriving at this URL

pathMatchers[].pathRules[].paths[] STRING

pathMatchers[].pathRules[].service STRING

The full or partial URL of the backend service resource to which traffic is directed if this rule is matched. If routeAction is additionally specified, advanced routing actions like URL Rewrites, etc. take effect prior to sending the request to the backend. However, if service is specified, routeAction cannot contain any weightedBackendService s. Conversely, if routeAction specifies any weightedBackendServices, service must not be specified. Only one of urlRedirect, service or routeAction.weightedBackendService must be set

selfLink STRING

[Output Only] Server-defined URL for the resource

tests[] OBJECT

Message for the expected URL mappings

tests[].description STRING

Description of this test case

tests[].host STRING

Host portion of the URL

tests[].path STRING

Path portion of the URL

tests[].service STRING

Expected BackendService resource the given URL should be mapped to