Class: Google::Apis::ComputeV1::TargetHttpsProxy
- Inherits:
-
Object
- Object
- Google::Apis::ComputeV1::TargetHttpsProxy
- Includes:
- Google::Apis::Core::Hashable, Google::Apis::Core::JsonObjectSupport
- Defined in:
- lib/google/apis/compute_v1/classes.rb,
lib/google/apis/compute_v1/representations.rb,
lib/google/apis/compute_v1/representations.rb
Overview
Represents a Target HTTPS Proxy resource. Google Compute Engine has two Target HTTPS Proxy resources: * Global * Regional A target HTTPS proxy is a component of GCP HTTPS 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 HTTPS proxy, and the target proxy then references a URL map. For more information, read Using Target Proxies and Forwarding rule concepts.
Instance Attribute Summary collapse
-
#authorization_policy ⇒ String
Optional.
-
#certificate_map ⇒ String
URL of a certificate map that identifies a certificate map associated with the given target proxy.
-
#creation_timestamp ⇒ String
[Output Only] Creation timestamp in RFC3339 text format.
-
#description ⇒ String
An optional description of this resource.
-
#fingerprint ⇒ String
Fingerprint of this resource.
-
#http_keep_alive_timeout_sec ⇒ Fixnum
Specifies how long to keep a connection open, after completing a response, while there is no matching traffic (in seconds).
-
#id ⇒ Fixnum
[Output Only] The unique identifier for the resource.
-
#kind ⇒ String
[Output Only] Type of resource.
-
#name ⇒ String
Name of the resource.
-
#proxy_bind ⇒ Boolean
(also: #proxy_bind?)
This field only applies when the forwarding rule that references this target proxy has a loadBalancingScheme set to INTERNAL_SELF_MANAGED.
-
#quic_override ⇒ String
Specifies the QUIC override policy for this TargetHttpsProxy resource.
-
#region ⇒ String
[Output Only] URL of the region where the regional TargetHttpsProxy resides.
-
#self_link ⇒ String
[Output Only] Server-defined URL for the resource.
-
#server_tls_policy ⇒ String
Optional.
-
#ssl_certificates ⇒ Array<String>
URLs to SslCertificate resources that are used to authenticate connections between users and the load balancer.
-
#ssl_policy ⇒ String
URL of SslPolicy resource that will be associated with the TargetHttpsProxy resource.
-
#tls_early_data ⇒ String
Specifies whether TLS 1.3 0-RTT Data ("Early Data") should be accepted for this service.
-
#url_map ⇒ String
A fully-qualified or valid partial URL to the UrlMap resource that defines the mapping from URL to the BackendService.
Instance Method Summary collapse
-
#initialize(**args) ⇒ TargetHttpsProxy
constructor
A new instance of TargetHttpsProxy.
-
#update!(**args) ⇒ Object
Update properties of this object.
Constructor Details
#initialize(**args) ⇒ TargetHttpsProxy
Returns a new instance of TargetHttpsProxy.
43744 43745 43746 |
# File 'lib/google/apis/compute_v1/classes.rb', line 43744 def initialize(**args) update!(**args) end |
Instance Attribute Details
#authorization_policy ⇒ String
Optional. A URL referring to a networksecurity.AuthorizationPolicy resource
that describes how the proxy should authorize inbound traffic. If left blank,
access will not be restricted by an authorization policy. Refer to the
AuthorizationPolicy resource for additional details. authorizationPolicy only
applies to a global TargetHttpsProxy attached to globalForwardingRules with
the loadBalancingScheme set to INTERNAL_SELF_MANAGED. Note: This field
currently has no impact.
Corresponds to the JSON property authorizationPolicy
43588 43589 43590 |
# File 'lib/google/apis/compute_v1/classes.rb', line 43588 def @authorization_policy end |
#certificate_map ⇒ String
URL of a certificate map that identifies a certificate map associated with the
given target proxy. This field can only be set for global target proxies. If
set, sslCertificates will be ignored. Accepted format is //certificatemanager.
googleapis.com/projects/project
/locations/location
/certificateMaps/
resourceName
.
Corresponds to the JSON property certificateMap
43597 43598 43599 |
# File 'lib/google/apis/compute_v1/classes.rb', line 43597 def certificate_map @certificate_map end |
#creation_timestamp ⇒ String
[Output Only] Creation timestamp in RFC3339 text format.
Corresponds to the JSON property creationTimestamp
43602 43603 43604 |
# File 'lib/google/apis/compute_v1/classes.rb', line 43602 def @creation_timestamp end |
#description ⇒ String
An optional description of this resource. Provide this property when you
create the resource.
Corresponds to the JSON property description
43608 43609 43610 |
# File 'lib/google/apis/compute_v1/classes.rb', line 43608 def description @description end |
#fingerprint ⇒ String
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 TargetHttpsProxy. An up-to-date fingerprint must be provided in
order to patch the TargetHttpsProxy; otherwise, the request will fail with
error 412 conditionNotMet. To see the latest fingerprint, make a get() request
to retrieve the TargetHttpsProxy.
Corresponds to the JSON property fingerprint
NOTE: Values are automatically base64 encoded/decoded in the client library.
43619 43620 43621 |
# File 'lib/google/apis/compute_v1/classes.rb', line 43619 def fingerprint @fingerprint end |
#http_keep_alive_timeout_sec ⇒ Fixnum
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.
Corresponds to the JSON property httpKeepAliveTimeoutSec
43629 43630 43631 |
# File 'lib/google/apis/compute_v1/classes.rb', line 43629 def http_keep_alive_timeout_sec @http_keep_alive_timeout_sec end |
#id ⇒ Fixnum
[Output Only] The unique identifier for the resource. This identifier is
defined by the server.
Corresponds to the JSON property id
43635 43636 43637 |
# File 'lib/google/apis/compute_v1/classes.rb', line 43635 def id @id end |
#kind ⇒ String
[Output Only] Type of resource. Always compute#targetHttpsProxy for target
HTTPS proxies.
Corresponds to the JSON property kind
43641 43642 43643 |
# File 'lib/google/apis/compute_v1/classes.rb', line 43641 def kind @kind end |
#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.
Corresponds to the JSON property name
43651 43652 43653 |
# File 'lib/google/apis/compute_v1/classes.rb', line 43651 def name @name end |
#proxy_bind ⇒ Boolean Also known as: proxy_bind?
This field only applies when the forwarding rule that references this target
proxy has a loadBalancingScheme set to INTERNAL_SELF_MANAGED. When this field
is set to true, Envoy proxies set up inbound traffic interception and bind to
the IP address and port specified in the forwarding rule. This is generally
useful when using Traffic Director to configure Envoy as a gateway or middle
proxy (in other words, not a sidecar proxy). The Envoy proxy listens for
inbound requests and handles requests when it receives them. The default is
false.
Corresponds to the JSON property proxyBind
43663 43664 43665 |
# File 'lib/google/apis/compute_v1/classes.rb', line 43663 def proxy_bind @proxy_bind end |
#quic_override ⇒ String
Specifies the QUIC override policy for this TargetHttpsProxy resource. This
setting determines whether the load balancer attempts to negotiate QUIC with
clients. You can specify NONE, ENABLE, or DISABLE. - When quic-override is set
to NONE, Google manages whether QUIC is used. - When quic-override is set to
ENABLE, the load balancer uses QUIC when possible. - When quic-override is set
to DISABLE, the load balancer doesn't use QUIC. - If the quic-override flag is
not specified, NONE is implied.
Corresponds to the JSON property quicOverride
43675 43676 43677 |
# File 'lib/google/apis/compute_v1/classes.rb', line 43675 def quic_override @quic_override end |
#region ⇒ String
[Output Only] URL of the region where the regional TargetHttpsProxy resides.
This field is not applicable to global TargetHttpsProxies.
Corresponds to the JSON property region
43681 43682 43683 |
# File 'lib/google/apis/compute_v1/classes.rb', line 43681 def region @region end |
#self_link ⇒ String
[Output Only] Server-defined URL for the resource.
Corresponds to the JSON property selfLink
43686 43687 43688 |
# File 'lib/google/apis/compute_v1/classes.rb', line 43686 def self_link @self_link end |
#server_tls_policy ⇒ String
Optional. A URL referring to a networksecurity.ServerTlsPolicy resource that
describes how the proxy should authenticate inbound traffic. serverTlsPolicy
only applies to a global TargetHttpsProxy attached to globalForwardingRules
with the loadBalancingScheme set to INTERNAL_SELF_MANAGED or EXTERNAL or
EXTERNAL_MANAGED. For details which ServerTlsPolicy resources are accepted
with INTERNAL_SELF_MANAGED and which with EXTERNAL, EXTERNAL_MANAGED
loadBalancingScheme consult ServerTlsPolicy documentation. If left blank,
communications are not encrypted.
Corresponds to the JSON property serverTlsPolicy
43698 43699 43700 |
# File 'lib/google/apis/compute_v1/classes.rb', line 43698 def server_tls_policy @server_tls_policy end |
#ssl_certificates ⇒ Array<String>
URLs to SslCertificate resources that are used to authenticate connections
between users and the load balancer. At least one SSL certificate must be
specified. Currently, you may specify up to 15 SSL certificates.
sslCertificates do not apply when the load balancing scheme is set to
INTERNAL_SELF_MANAGED.
Corresponds to the JSON property sslCertificates
43707 43708 43709 |
# File 'lib/google/apis/compute_v1/classes.rb', line 43707 def ssl_certificates @ssl_certificates end |
#ssl_policy ⇒ String
URL of SslPolicy resource that will be associated with the TargetHttpsProxy
resource. If not set, the TargetHttpsProxy resource has no SSL policy
configured.
Corresponds to the JSON property sslPolicy
43714 43715 43716 |
# File 'lib/google/apis/compute_v1/classes.rb', line 43714 def ssl_policy @ssl_policy end |
#tls_early_data ⇒ String
Specifies whether TLS 1.3 0-RTT Data ("Early Data") should be accepted for
this service. Early Data allows a TLS resumption handshake to include the
initial application payload (a HTTP request) alongside the handshake, reducing
the effective round trips to "zero". This applies to TLS 1.3 connections over
TCP (HTTP/2) as well as over UDP (QUIC/h3). This can improve application
performance, especially on networks where interruptions may be common, such as
on mobile. Requests with Early Data will have the "Early-Data" HTTP header set
on the request, with a value of "1", to allow the backend to determine whether
Early Data was included. Note: TLS Early Data may allow requests to be
replayed, as the data is sent to the backend before the handshake has fully
completed. Applications that allow idempotent HTTP methods to make non-
idempotent changes, such as a GET request updating a database, should not
accept Early Data on those requests, and reject requests with the "Early-Data:
1" HTTP header by returning a HTTP 425 (Too Early) status code, in order to
remain RFC compliant. The default value is DISABLED.
Corresponds to the JSON property tlsEarlyData
43733 43734 43735 |
# File 'lib/google/apis/compute_v1/classes.rb', line 43733 def tls_early_data @tls_early_data end |
#url_map ⇒ String
A fully-qualified or valid partial URL to the UrlMap resource that defines the
mapping from URL to the BackendService. For example, the following are all
valid URLs for specifying a URL map: - https://www.googleapis.compute/v1/
projects/project/global/urlMaps/ url-map - projects/project/global/urlMaps/url-
map - global/urlMaps/url-map
Corresponds to the JSON property urlMap
43742 43743 43744 |
# File 'lib/google/apis/compute_v1/classes.rb', line 43742 def url_map @url_map end |
Instance Method Details
#update!(**args) ⇒ Object
Update properties of this object
43749 43750 43751 43752 43753 43754 43755 43756 43757 43758 43759 43760 43761 43762 43763 43764 43765 43766 43767 43768 |
# File 'lib/google/apis/compute_v1/classes.rb', line 43749 def update!(**args) @authorization_policy = args[:authorization_policy] if args.key?(:authorization_policy) @certificate_map = args[:certificate_map] if args.key?(:certificate_map) @creation_timestamp = args[:creation_timestamp] if args.key?(:creation_timestamp) @description = args[:description] if args.key?(:description) @fingerprint = args[:fingerprint] if args.key?(:fingerprint) @http_keep_alive_timeout_sec = args[:http_keep_alive_timeout_sec] if args.key?(:http_keep_alive_timeout_sec) @id = args[:id] if args.key?(:id) @kind = args[:kind] if args.key?(:kind) @name = args[:name] if args.key?(:name) @proxy_bind = args[:proxy_bind] if args.key?(:proxy_bind) @quic_override = args[:quic_override] if args.key?(:quic_override) @region = args[:region] if args.key?(:region) @self_link = args[:self_link] if args.key?(:self_link) @server_tls_policy = args[:server_tls_policy] if args.key?(:server_tls_policy) @ssl_certificates = args[:ssl_certificates] if args.key?(:ssl_certificates) @ssl_policy = args[:ssl_policy] if args.key?(:ssl_policy) @tls_early_data = args[:tls_early_data] if args.key?(:tls_early_data) @url_map = args[:url_map] if args.key?(:url_map) end |