- HTTP request
- Path parameters
- Request body
- Response body
- Authorization scopes
- IAM Permissions
- Try it!
Returns the specified TargetHttpProxy resource in the specified region.
HTTP request
GET https://compute.googleapis.com/compute/beta/projects/{project}/regions/{region}/targetHttpProxies/{targetHttpProxy}
The URL uses gRPC Transcoding syntax.
Path parameters
Parameters | |
---|---|
project
|
Project ID for this request. |
region
|
Name of the region scoping this request. |
targetHttpProxy
|
Name of the TargetHttpProxy resource to return. |
Request body
The request body must be empty.
Response body
Represents a Target HTTP Proxy resource.
Google Compute Engine has two Target HTTP Proxy resources:
A target HTTP proxy is a component of Google Cloud HTTP load balancers.
- targetHttpProxies are used by global external Application Load Balancers, classic Application Load Balancers, cross-region internal Application Load Balancers, and Traffic Director.
- regionTargetHttpProxies are used by regional internal Application Load Balancers and regional external Application Load Balancers.
Forwarding rules reference a target HTTP proxy, and the target proxy then references a URL map. For more information, read Using Target Proxies and Forwarding rule concepts .
If successful, the response body contains data with the following structure:
JSON representation |
---|
{ "kind" : string , "id" : string , "creationTimestamp" : string , "name" : string , "description" : string , "selfLink" : string , "urlMap" : string , "region" : string , "proxyBind" : boolean , "httpFilters" : [ string ] , "fingerprint" : string , "httpKeepAliveTimeoutSec" : integer } |
Fields | |
---|---|
kind
|
[Output Only] Type of resource. Always |
id
|
[Output Only] The unique identifier for the resource. This identifier is defined by the server. |
creationTimestamp
|
[Output Only] Creation timestamp in RFC3339 text format. |
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 |
description
|
An optional description of this resource. Provide this property when you create the resource. |
selfLink
|
[Output Only] Server-defined URL for the resource. |
urlMap
|
URL to the UrlMap resource that defines the mapping from URL to the BackendService. |
region
|
[Output Only] URL of the region where the regional Target HTTP Proxy resides. This field is not applicable to global Target HTTP Proxies. |
proxyBind
|
This field only applies when the forwarding rule that references this target proxy has a When this field is set to The default is |
httpFilters[]
|
URLs to |
fingerprint
|
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 A base64-encoded string. |
httpKeepAliveTimeoutSec
|
Specifies how long to keep a connection open, after completing a response, while there is no matching traffic (in seconds). If an HTTP keep-alive is not specified, a default value (610 seconds) will be used. For global external Application Load Balancers, the minimum allowed value is 5 seconds and the maximum allowed value is 1200 seconds. For classic Application Load Balancers, this option is not supported. |
Authorization scopes
Requires one of the following OAuth scopes:
-
https://www.googleapis.com/auth/compute.readonly
-
https://www.googleapis.com/auth/compute
-
https://www.googleapis.com/auth/cloud-platform
For more information, see the Authentication Overview .
IAM Permissions
In addition to any permissions specified on the fields above, authorization requires one or more of the following IAM permissions:
-
compute.regionTargetHttpProxies.get
To find predefined roles that contain those permissions, see Compute Engine IAM Roles .