Clean and regen docs (#401)

diff --git a/docs/dyn/compute_alpha.regionBackendServices.html b/docs/dyn/compute_alpha.regionBackendServices.html
index fb89877..2576bc4 100644
--- a/docs/dyn/compute_alpha.regionBackendServices.html
+++ b/docs/dyn/compute_alpha.regionBackendServices.html
@@ -178,6 +178,11 @@
       "connectionDraining": { # Message containing connection draining configuration.
         "drainingTimeoutSec": 42, # Time for which instance will be drained (not accept new connections, but still work to finish started).
       },
+      "failoverRatio": 3.14, # The value of the field must be in [0, 1]. If set, 'backends[].failover' must be set. They together define the fallback behavior of the primary backend: if the ratio of the healthy VMs in the primary backend is at or below this number, traffic arriving at the load-balanced IP will be directed to the failover backend.
+          #
+          # In case where 'failoverRatio' is not set or all the VMs in the backup backend are unhealthy, the traffic will be directed back to the primary backend in the "force" mode, where traffic will be spread to the healthy VMs with the best effort, or to all VMs when no VM is healthy.
+          #
+          # This field is only used with l4 load balancing.
       "protocol": "A String", # The protocol this BackendService uses to communicate with backends.
           #
           # Possible values are HTTP, HTTPS, TCP, and SSL. The default is HTTP.
@@ -202,7 +207,7 @@
         "signedUrlKeyNames": [ # [Output Only] Names of the keys currently configured for Cloud CDN Signed URL on this backend service.
           "A String",
         ],
-        "signedUrlTtlSec": "A String", # Number of seconds up to which the response to a signed URL request will be cached in the CDN. After this time period, the Signed URL will be revalidated before being served. Defaults to 1hr (3600s). If this field is set, Cloud CDN will internally act as though all responses from this backend had a ?Cache-Control: public, max-age=[TTL]? header, regardless of any existing Cache-Control header. The actual headers served in responses will not be altered.
+        "signedUrlCacheMaxAgeSec": "A String", # Number of seconds up to which the response to a signed URL request will be cached in the CDN. After this time period, the Signed URL will be revalidated before being served. Defaults to 1hr (3600s). If this field is set, Cloud CDN will internally act as though all responses from this backend had a ?Cache-Control: public, max-age=[TTL]? header, regardless of any existing Cache-Control header. The actual headers served in responses will not be altered.
         "cacheKeyPolicy": { # Message containing what to include in the cache key for a request for Cloud CDN. # The CacheKeyPolicy for this CdnPolicy.
           "includeQueryString": True or False, # If true, include query string parameters in the cache key according to query_string_whitelist and query_string_blacklist. If neither is set, the entire query string will be included. If false, the query string will be excluded from the cache key entirely.
           "includeHost": True or False, # If true, requests to different hosts will be cached separately.
@@ -236,7 +241,7 @@
               #
               # This cannot be used for internal load balancing.
           "failover": True or False, # This field designates whether this is a failover backend. More than one failover backend can be configured for a given BackendService.
-          "maxRatePerInstance": 3.14, # The max requests per second (RPS) that a single backend instance can handle.This is used to calculate the capacity of the group. Can be used in either balancing mode. For RATE mode, either maxRate or maxRatePerInstance must be set.
+          "maxRatePerInstance": 3.14, # The max requests per second (RPS) that a single backend instance can handle. This is used to calculate the capacity of the group. Can be used in either balancing mode. For RATE mode, either maxRate or maxRatePerInstance must be set.
               #
               # This cannot be used for internal load balancing.
           "maxConnectionsPerInstance": 42, # The max number of simultaneous connections that a single backend instance can handle. This is used to calculate the capacity of the group. Can be used in either CONNECTION or UTILIZATION balancing modes. For CONNECTION mode, either maxConnections or maxConnectionsPerInstance must be set.
@@ -260,7 +265,7 @@
         "oauth2ClientId": "A String",
         "enabled": True or False,
         "oauth2ClientSecret": "A String",
-        "oauth2ClientSecretSha256": "A String",
+        "oauth2ClientSecretSha256": "A String", # [Output Only] SHA256 hash value for the field oauth2_client_secret above.
       },
       "description": "A String", # An optional description of this resource. Provide this property when you create the resource.
       "customRequestHeaders": [ # Headers that the HTTP/S load balancer should add to proxied requests.
@@ -325,6 +330,11 @@
     "connectionDraining": { # Message containing connection draining configuration.
       "drainingTimeoutSec": 42, # Time for which instance will be drained (not accept new connections, but still work to finish started).
     },
+    "failoverRatio": 3.14, # The value of the field must be in [0, 1]. If set, 'backends[].failover' must be set. They together define the fallback behavior of the primary backend: if the ratio of the healthy VMs in the primary backend is at or below this number, traffic arriving at the load-balanced IP will be directed to the failover backend.
+        # 
+        # In case where 'failoverRatio' is not set or all the VMs in the backup backend are unhealthy, the traffic will be directed back to the primary backend in the "force" mode, where traffic will be spread to the healthy VMs with the best effort, or to all VMs when no VM is healthy.
+        # 
+        # This field is only used with l4 load balancing.
     "protocol": "A String", # The protocol this BackendService uses to communicate with backends.
         # 
         # Possible values are HTTP, HTTPS, TCP, and SSL. The default is HTTP.
@@ -349,7 +359,7 @@
       "signedUrlKeyNames": [ # [Output Only] Names of the keys currently configured for Cloud CDN Signed URL on this backend service.
         "A String",
       ],
-      "signedUrlTtlSec": "A String", # Number of seconds up to which the response to a signed URL request will be cached in the CDN. After this time period, the Signed URL will be revalidated before being served. Defaults to 1hr (3600s). If this field is set, Cloud CDN will internally act as though all responses from this backend had a ?Cache-Control: public, max-age=[TTL]? header, regardless of any existing Cache-Control header. The actual headers served in responses will not be altered.
+      "signedUrlCacheMaxAgeSec": "A String", # Number of seconds up to which the response to a signed URL request will be cached in the CDN. After this time period, the Signed URL will be revalidated before being served. Defaults to 1hr (3600s). If this field is set, Cloud CDN will internally act as though all responses from this backend had a ?Cache-Control: public, max-age=[TTL]? header, regardless of any existing Cache-Control header. The actual headers served in responses will not be altered.
       "cacheKeyPolicy": { # Message containing what to include in the cache key for a request for Cloud CDN. # The CacheKeyPolicy for this CdnPolicy.
         "includeQueryString": True or False, # If true, include query string parameters in the cache key according to query_string_whitelist and query_string_blacklist. If neither is set, the entire query string will be included. If false, the query string will be excluded from the cache key entirely.
         "includeHost": True or False, # If true, requests to different hosts will be cached separately.
@@ -383,7 +393,7 @@
             #
             # This cannot be used for internal load balancing.
         "failover": True or False, # This field designates whether this is a failover backend. More than one failover backend can be configured for a given BackendService.
-        "maxRatePerInstance": 3.14, # The max requests per second (RPS) that a single backend instance can handle.This is used to calculate the capacity of the group. Can be used in either balancing mode. For RATE mode, either maxRate or maxRatePerInstance must be set.
+        "maxRatePerInstance": 3.14, # The max requests per second (RPS) that a single backend instance can handle. This is used to calculate the capacity of the group. Can be used in either balancing mode. For RATE mode, either maxRate or maxRatePerInstance must be set.
             #
             # This cannot be used for internal load balancing.
         "maxConnectionsPerInstance": 42, # The max number of simultaneous connections that a single backend instance can handle. This is used to calculate the capacity of the group. Can be used in either CONNECTION or UTILIZATION balancing modes. For CONNECTION mode, either maxConnections or maxConnectionsPerInstance must be set.
@@ -407,7 +417,7 @@
       "oauth2ClientId": "A String",
       "enabled": True or False,
       "oauth2ClientSecret": "A String",
-      "oauth2ClientSecretSha256": "A String",
+      "oauth2ClientSecretSha256": "A String", # [Output Only] SHA256 hash value for the field oauth2_client_secret above.
     },
     "description": "A String", # An optional description of this resource. Provide this property when you create the resource.
     "customRequestHeaders": [ # Headers that the HTTP/S load balancer should add to proxied requests.
@@ -511,6 +521,11 @@
           "connectionDraining": { # Message containing connection draining configuration.
             "drainingTimeoutSec": 42, # Time for which instance will be drained (not accept new connections, but still work to finish started).
           },
+          "failoverRatio": 3.14, # The value of the field must be in [0, 1]. If set, 'backends[].failover' must be set. They together define the fallback behavior of the primary backend: if the ratio of the healthy VMs in the primary backend is at or below this number, traffic arriving at the load-balanced IP will be directed to the failover backend.
+              #
+              # In case where 'failoverRatio' is not set or all the VMs in the backup backend are unhealthy, the traffic will be directed back to the primary backend in the "force" mode, where traffic will be spread to the healthy VMs with the best effort, or to all VMs when no VM is healthy.
+              #
+              # This field is only used with l4 load balancing.
           "protocol": "A String", # The protocol this BackendService uses to communicate with backends.
               #
               # Possible values are HTTP, HTTPS, TCP, and SSL. The default is HTTP.
@@ -535,7 +550,7 @@
             "signedUrlKeyNames": [ # [Output Only] Names of the keys currently configured for Cloud CDN Signed URL on this backend service.
               "A String",
             ],
-            "signedUrlTtlSec": "A String", # Number of seconds up to which the response to a signed URL request will be cached in the CDN. After this time period, the Signed URL will be revalidated before being served. Defaults to 1hr (3600s). If this field is set, Cloud CDN will internally act as though all responses from this backend had a ?Cache-Control: public, max-age=[TTL]? header, regardless of any existing Cache-Control header. The actual headers served in responses will not be altered.
+            "signedUrlCacheMaxAgeSec": "A String", # Number of seconds up to which the response to a signed URL request will be cached in the CDN. After this time period, the Signed URL will be revalidated before being served. Defaults to 1hr (3600s). If this field is set, Cloud CDN will internally act as though all responses from this backend had a ?Cache-Control: public, max-age=[TTL]? header, regardless of any existing Cache-Control header. The actual headers served in responses will not be altered.
             "cacheKeyPolicy": { # Message containing what to include in the cache key for a request for Cloud CDN. # The CacheKeyPolicy for this CdnPolicy.
               "includeQueryString": True or False, # If true, include query string parameters in the cache key according to query_string_whitelist and query_string_blacklist. If neither is set, the entire query string will be included. If false, the query string will be excluded from the cache key entirely.
               "includeHost": True or False, # If true, requests to different hosts will be cached separately.
@@ -569,7 +584,7 @@
                   #
                   # This cannot be used for internal load balancing.
               "failover": True or False, # This field designates whether this is a failover backend. More than one failover backend can be configured for a given BackendService.
-              "maxRatePerInstance": 3.14, # The max requests per second (RPS) that a single backend instance can handle.This is used to calculate the capacity of the group. Can be used in either balancing mode. For RATE mode, either maxRate or maxRatePerInstance must be set.
+              "maxRatePerInstance": 3.14, # The max requests per second (RPS) that a single backend instance can handle. This is used to calculate the capacity of the group. Can be used in either balancing mode. For RATE mode, either maxRate or maxRatePerInstance must be set.
                   #
                   # This cannot be used for internal load balancing.
               "maxConnectionsPerInstance": 42, # The max number of simultaneous connections that a single backend instance can handle. This is used to calculate the capacity of the group. Can be used in either CONNECTION or UTILIZATION balancing modes. For CONNECTION mode, either maxConnections or maxConnectionsPerInstance must be set.
@@ -593,7 +608,7 @@
             "oauth2ClientId": "A String",
             "enabled": True or False,
             "oauth2ClientSecret": "A String",
-            "oauth2ClientSecretSha256": "A String",
+            "oauth2ClientSecretSha256": "A String", # [Output Only] SHA256 hash value for the field oauth2_client_secret above.
           },
           "description": "A String", # An optional description of this resource. Provide this property when you create the resource.
           "customRequestHeaders": [ # Headers that the HTTP/S load balancer should add to proxied requests.
@@ -646,6 +661,11 @@
     "connectionDraining": { # Message containing connection draining configuration.
       "drainingTimeoutSec": 42, # Time for which instance will be drained (not accept new connections, but still work to finish started).
     },
+    "failoverRatio": 3.14, # The value of the field must be in [0, 1]. If set, 'backends[].failover' must be set. They together define the fallback behavior of the primary backend: if the ratio of the healthy VMs in the primary backend is at or below this number, traffic arriving at the load-balanced IP will be directed to the failover backend.
+        # 
+        # In case where 'failoverRatio' is not set or all the VMs in the backup backend are unhealthy, the traffic will be directed back to the primary backend in the "force" mode, where traffic will be spread to the healthy VMs with the best effort, or to all VMs when no VM is healthy.
+        # 
+        # This field is only used with l4 load balancing.
     "protocol": "A String", # The protocol this BackendService uses to communicate with backends.
         # 
         # Possible values are HTTP, HTTPS, TCP, and SSL. The default is HTTP.
@@ -670,7 +690,7 @@
       "signedUrlKeyNames": [ # [Output Only] Names of the keys currently configured for Cloud CDN Signed URL on this backend service.
         "A String",
       ],
-      "signedUrlTtlSec": "A String", # Number of seconds up to which the response to a signed URL request will be cached in the CDN. After this time period, the Signed URL will be revalidated before being served. Defaults to 1hr (3600s). If this field is set, Cloud CDN will internally act as though all responses from this backend had a ?Cache-Control: public, max-age=[TTL]? header, regardless of any existing Cache-Control header. The actual headers served in responses will not be altered.
+      "signedUrlCacheMaxAgeSec": "A String", # Number of seconds up to which the response to a signed URL request will be cached in the CDN. After this time period, the Signed URL will be revalidated before being served. Defaults to 1hr (3600s). If this field is set, Cloud CDN will internally act as though all responses from this backend had a ?Cache-Control: public, max-age=[TTL]? header, regardless of any existing Cache-Control header. The actual headers served in responses will not be altered.
       "cacheKeyPolicy": { # Message containing what to include in the cache key for a request for Cloud CDN. # The CacheKeyPolicy for this CdnPolicy.
         "includeQueryString": True or False, # If true, include query string parameters in the cache key according to query_string_whitelist and query_string_blacklist. If neither is set, the entire query string will be included. If false, the query string will be excluded from the cache key entirely.
         "includeHost": True or False, # If true, requests to different hosts will be cached separately.
@@ -704,7 +724,7 @@
             #
             # This cannot be used for internal load balancing.
         "failover": True or False, # This field designates whether this is a failover backend. More than one failover backend can be configured for a given BackendService.
-        "maxRatePerInstance": 3.14, # The max requests per second (RPS) that a single backend instance can handle.This is used to calculate the capacity of the group. Can be used in either balancing mode. For RATE mode, either maxRate or maxRatePerInstance must be set.
+        "maxRatePerInstance": 3.14, # The max requests per second (RPS) that a single backend instance can handle. This is used to calculate the capacity of the group. Can be used in either balancing mode. For RATE mode, either maxRate or maxRatePerInstance must be set.
             #
             # This cannot be used for internal load balancing.
         "maxConnectionsPerInstance": 42, # The max number of simultaneous connections that a single backend instance can handle. This is used to calculate the capacity of the group. Can be used in either CONNECTION or UTILIZATION balancing modes. For CONNECTION mode, either maxConnections or maxConnectionsPerInstance must be set.
@@ -728,7 +748,7 @@
       "oauth2ClientId": "A String",
       "enabled": True or False,
       "oauth2ClientSecret": "A String",
-      "oauth2ClientSecretSha256": "A String",
+      "oauth2ClientSecretSha256": "A String", # [Output Only] SHA256 hash value for the field oauth2_client_secret above.
     },
     "description": "A String", # An optional description of this resource. Provide this property when you create the resource.
     "customRequestHeaders": [ # Headers that the HTTP/S load balancer should add to proxied requests.
@@ -841,6 +861,11 @@
     "connectionDraining": { # Message containing connection draining configuration.
       "drainingTimeoutSec": 42, # Time for which instance will be drained (not accept new connections, but still work to finish started).
     },
+    "failoverRatio": 3.14, # The value of the field must be in [0, 1]. If set, 'backends[].failover' must be set. They together define the fallback behavior of the primary backend: if the ratio of the healthy VMs in the primary backend is at or below this number, traffic arriving at the load-balanced IP will be directed to the failover backend.
+        # 
+        # In case where 'failoverRatio' is not set or all the VMs in the backup backend are unhealthy, the traffic will be directed back to the primary backend in the "force" mode, where traffic will be spread to the healthy VMs with the best effort, or to all VMs when no VM is healthy.
+        # 
+        # This field is only used with l4 load balancing.
     "protocol": "A String", # The protocol this BackendService uses to communicate with backends.
         # 
         # Possible values are HTTP, HTTPS, TCP, and SSL. The default is HTTP.
@@ -865,7 +890,7 @@
       "signedUrlKeyNames": [ # [Output Only] Names of the keys currently configured for Cloud CDN Signed URL on this backend service.
         "A String",
       ],
-      "signedUrlTtlSec": "A String", # Number of seconds up to which the response to a signed URL request will be cached in the CDN. After this time period, the Signed URL will be revalidated before being served. Defaults to 1hr (3600s). If this field is set, Cloud CDN will internally act as though all responses from this backend had a ?Cache-Control: public, max-age=[TTL]? header, regardless of any existing Cache-Control header. The actual headers served in responses will not be altered.
+      "signedUrlCacheMaxAgeSec": "A String", # Number of seconds up to which the response to a signed URL request will be cached in the CDN. After this time period, the Signed URL will be revalidated before being served. Defaults to 1hr (3600s). If this field is set, Cloud CDN will internally act as though all responses from this backend had a ?Cache-Control: public, max-age=[TTL]? header, regardless of any existing Cache-Control header. The actual headers served in responses will not be altered.
       "cacheKeyPolicy": { # Message containing what to include in the cache key for a request for Cloud CDN. # The CacheKeyPolicy for this CdnPolicy.
         "includeQueryString": True or False, # If true, include query string parameters in the cache key according to query_string_whitelist and query_string_blacklist. If neither is set, the entire query string will be included. If false, the query string will be excluded from the cache key entirely.
         "includeHost": True or False, # If true, requests to different hosts will be cached separately.
@@ -899,7 +924,7 @@
             #
             # This cannot be used for internal load balancing.
         "failover": True or False, # This field designates whether this is a failover backend. More than one failover backend can be configured for a given BackendService.
-        "maxRatePerInstance": 3.14, # The max requests per second (RPS) that a single backend instance can handle.This is used to calculate the capacity of the group. Can be used in either balancing mode. For RATE mode, either maxRate or maxRatePerInstance must be set.
+        "maxRatePerInstance": 3.14, # The max requests per second (RPS) that a single backend instance can handle. This is used to calculate the capacity of the group. Can be used in either balancing mode. For RATE mode, either maxRate or maxRatePerInstance must be set.
             #
             # This cannot be used for internal load balancing.
         "maxConnectionsPerInstance": 42, # The max number of simultaneous connections that a single backend instance can handle. This is used to calculate the capacity of the group. Can be used in either CONNECTION or UTILIZATION balancing modes. For CONNECTION mode, either maxConnections or maxConnectionsPerInstance must be set.
@@ -923,7 +948,7 @@
       "oauth2ClientId": "A String",
       "enabled": True or False,
       "oauth2ClientSecret": "A String",
-      "oauth2ClientSecretSha256": "A String",
+      "oauth2ClientSecretSha256": "A String", # [Output Only] SHA256 hash value for the field oauth2_client_secret above.
     },
     "description": "A String", # An optional description of this resource. Provide this property when you create the resource.
     "customRequestHeaders": [ # Headers that the HTTP/S load balancer should add to proxied requests.