google-api-client 0.30.2 → 0.30.3

data/generated/google/apis/compute_beta.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://developers.google.com/compute/docs/reference/latest/
     module ComputeBeta
       VERSION = 'Beta'
-      REVISION = '20190528'
+      REVISION = '20190607'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

data/generated/google/apis/compute_beta/classes.rb

@@ -52,8 +52,12 @@ module Google
         end
       end
       
-      # An Accelerator Type resource. (== resource_for beta.acceleratorTypes ==) (==
-      # resource_for v1.acceleratorTypes ==)
+      # Represents an Accelerator Type resource.
+      # Google Cloud Platform provides graphics processing units (accelerators) that
+      # you can add to VM instances to improve or accelerate performance when working
+      # with intensive workloads. For more information, read GPUs on Compute Engine. (=
+      # = resource_for beta.acceleratorTypes ==) (== resource_for v1.acceleratorTypes =
+      # =)
       class AcceleratorType
         include Google::Apis::Core::Hashable
       
@@ -463,8 +467,8 @@ module Google
         attr_accessor :kind
       
         # The name of this access configuration. The default and recommended name is
-        # External NAT but you can use any arbitrary string you would like. For example,
-        # My external IP or Network Access.
+        # External NAT, but you can use any arbitrary string, such as My external IP or
+        # Network Access.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -489,13 +493,13 @@ module Google
         # @return [String]
         attr_accessor :network_tier
       
-        # The DNS domain name for the public PTR record. This field can only be set when
-        # the set_public_ptr field is enabled.
+        # The DNS domain name for the public PTR record. You can set this field only if
+        # the `setPublicPtr` field is enabled.
         # Corresponds to the JSON property `publicPtrDomainName`
         # @return [String]
         attr_accessor :public_ptr_domain_name
       
-        # Specifies whether a public DNS ?PTR? record should be created to map the
+        # Specifies whether a public DNS 'PTR' record should be created to map the
         # external IP address of the instance to a DNS domain name.
         # Corresponds to the JSON property `setPublicPtr`
         # @return [Boolean]
@@ -523,9 +527,21 @@ module Google
         end
       end
       
-      # A reserved address resource. (== resource_for beta.addresses ==) (==
-      # resource_for v1.addresses ==) (== resource_for beta.globalAddresses ==) (==
-      # resource_for v1.globalAddresses ==)
+      # Represents an IP Address resource.
+      # An address resource represents a regional internal IP address. Regional
+      # internal IP addresses are RFC 1918 addresses that come from either a primary
+      # or secondary IP range of a subnet in a VPC network. Regional external IP
+      # addresses can be assigned to GCP VM instances, Cloud VPN gateways, regional
+      # external forwarding rules for network load balancers (in either Standard or
+      # Premium Tier), and regional external forwarding rules for HTTP(S), SSL Proxy,
+      # and TCP Proxy load balancers in Standard Tier. For more information, read IP
+      # addresses.
+      # A globalAddresses resource represent a global external IP address. Global
+      # external IP addresses are IPv4 or IPv6 addresses. They can only be assigned to
+      # global forwarding rules for HTTP(S), SSL Proxy, or TCP Proxy load balancers in
+      # Premium Tier. For more information, read Global resources. (== resource_for
+      # beta.addresses ==) (== resource_for v1.addresses ==) (== resource_for beta.
+      # globalAddresses ==) (== resource_for v1.globalAddresses ==)
       class Address
         include Google::Apis::Core::Hashable
       
@@ -545,8 +561,8 @@ module Google
         # @return [String]
         attr_accessor :creation_timestamp
       
-        # An optional description of this resource. Provide this property when you
-        # create the resource.
+        # An optional description of this resource. Provide this field when you create
+        # the resource.
         # Corresponds to the JSON property `description`
         # @return [String]
         attr_accessor :description
@@ -557,7 +573,7 @@ module Google
         # @return [Fixnum]
         attr_accessor :id
       
-        # The IP Version that will be used by this address. Valid options are IPV4 or
+        # The IP version that will be used by this address. Valid options are IPV4 or
         # IPV6. This can only be specified for a global address.
         # Corresponds to the JSON property `ipVersion`
         # @return [String]
@@ -590,25 +606,25 @@ module Google
         # 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.
+        # z0-9]*[a-z0-9])?`. The first character must be a lowercase letter, and all
+        # following characters (except for the last character) must be a dash, lowercase
+        # letter, or digit. The last character must be a lowercase letter or digit.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
         # The URL of the network in which to reserve the address. This field can only be
-        # used with INTERNAL type with VPC_PEERING purpose.
+        # used with INTERNAL type with the VPC_PEERING purpose.
         # Corresponds to the JSON property `network`
         # @return [String]
         attr_accessor :network
       
-        # This signifies the networking tier used for configuring this Address and can
-        # only take the following values: PREMIUM, STANDARD. Global forwarding rules can
-        # only be Premium Tier. Regional forwarding rules can be either Premium or
+        # This signifies the networking tier used for configuring this address and can
+        # only take the following values: PREMIUM or STANDARD. Global forwarding rules
+        # can only be Premium Tier. Regional forwarding rules can be either Premium or
         # Standard Tier. Standard Tier addresses applied to regional forwarding rules
         # can be used with any external load balancer. Regional forwarding rules in
-        # Premium Tier can only be used with a Network load balancer.
+        # Premium Tier can only be used with a network load balancer.
         # If this field is not specified, it is assumed to be PREMIUM.
         # Corresponds to the JSON property `networkTier`
         # @return [String]
@@ -619,14 +635,20 @@ module Google
         # @return [Fixnum]
         attr_accessor :prefix_length
       
-        # The purpose of resource, only used with INTERNAL type.
+        # The purpose of this resource, which can be one of the following values:
+        # - `GCE_ENDPOINT` for addresses that are used by VM instances, alias IP ranges,
+        # internal load balancers, and similar resources.
+        # - `DNS_RESOLVER` for a DNS resolver address in a subnetwork
+        # - `VPC_PEERING` for addresses that are reserved for VPC peer networks.
+        # - `NAT_AUTO` for addresses that are external IP addresses automatically
+        # reserved for Cloud NAT.
         # Corresponds to the JSON property `purpose`
         # @return [String]
         attr_accessor :purpose
       
-        # [Output Only] URL of the region where the regional address resides. This field
-        # is not applicable to global addresses. You must specify this field as part of
-        # the HTTP request URL. You cannot set this field in the request body.
+        # [Output Only] The URL of the region where the regional address resides. This
+        # field is not applicable to global addresses. You must specify this field as
+        # part of the HTTP request URL.
         # Corresponds to the JSON property `region`
         # @return [String]
         attr_accessor :region
@@ -647,7 +669,7 @@ module Google
       
         # The URL of the subnetwork in which to reserve the address. If an IP address is
         # specified, it must be within the subnetwork's IP range. This field can only be
-        # used with INTERNAL type with GCE_ENDPOINT/DNS_RESOLVER purposes.
+        # used with INTERNAL type with a GCE_ENDPOINT or DNS_RESOLVER purpose.
         # Corresponds to the JSON property `subnetwork`
         # @return [String]
         attr_accessor :subnetwork
@@ -1016,18 +1038,17 @@ module Google
       class AliasIpRange
         include Google::Apis::Core::Hashable
       
-        # The IP CIDR range represented by this alias IP range. This IP CIDR range must
+        # The IP alias ranges to allocate for this interface. This IP CIDR range must
         # belong to the specified subnetwork and cannot contain IP addresses reserved by
         # system or used by other network interfaces. This range may be a single IP
-        # address (e.g. 10.2.3.4), a netmask (e.g. /24) or a CIDR format string (e.g. 10.
-        # 1.2.0/24).
+        # address (such as 10.2.3.4), a netmask (such as /24) or a CIDR-formatted string
+        # (such as 10.1.2.0/24).
         # Corresponds to the JSON property `ipCidrRange`
         # @return [String]
         attr_accessor :ip_cidr_range
       
-        # Optional subnetwork secondary range name specifying the secondary range from
-        # which to allocate the IP CIDR range for this alias IP range. If left
-        # unspecified, the primary range of the subnetwork will be used.
+        # The name of a subnetwork secondary IP range from which to allocate an IP alias
+        # range. If not specified, the primary range of the subnetwork is used.
         # Corresponds to the JSON property `subnetworkRangeName`
         # @return [String]
         attr_accessor :subnetwork_range_name
@@ -1202,7 +1223,8 @@ module Google
         # SCSI or NVME. The default is SCSI. Persistent disks must always use SCSI and
         # the request will fail if you attempt to attach a persistent disk in any other
         # format than SCSI. Local SSDs can use either NVME or SCSI. For performance
-        # characteristics of SCSI over NVMe, see Local SSD performance.
+        # characteristics of SCSI over NVMe, see Local SSD performance. TODO(b/131765817)
+        # : Update documentation when NVME is supported.
         # Corresponds to the JSON property `interface`
         # @return [String]
         attr_accessor :interface
@@ -1485,12 +1507,15 @@ module Google
         end
       end
       
-      # Represents an Autoscaler resource. Autoscalers allow you to automatically
-      # scale virtual machine instances in managed instance groups according to an
-      # autoscaling policy that you define. For more information, read Autoscaling
-      # Groups of Instances. (== resource_for beta.autoscalers ==) (== resource_for v1.
-      # autoscalers ==) (== resource_for beta.regionAutoscalers ==) (== resource_for
-      # v1.regionAutoscalers ==)
+      # Represents an Autoscaler resource.
+      # Use autoscalers to automatically add or delete instances from a managed
+      # instance group according to your defined autoscaling policy. For more
+      # information, read Autoscaling Groups of Instances.
+      # For zonal managed instance groups resource, use the autoscaler resource.
+      # For regional managed instance groups, use the regionAutoscalers resource. (==
+      # resource_for beta.autoscalers ==) (== resource_for v1.autoscalers ==) (==
+      # resource_for beta.regionAutoscalers ==) (== resource_for v1.regionAutoscalers =
+      # =)
       class Autoscaler
         include Google::Apis::Core::Hashable
       
@@ -3462,16 +3487,12 @@ module Google
         end
       end
       
-      # Represents a Commitment resource. Creating a Commitment resource means that
-      # you are purchasing a committed use contract with an explicit start and end
-      # time. You can create commitments based on vCPUs and memory usage and receive
-      # discounted rates. For full details, read Signing Up for Committed Use
-      # Discounts.
-      # Committed use discounts are subject to Google Cloud Platform's Service
-      # Specific Terms. By purchasing a committed use discount, you agree to these
-      # terms. Committed use discounts will not renew, so you must purchase a new
-      # commitment to continue receiving discounts. (== resource_for beta.commitments =
-      # =) (== resource_for v1.commitments ==)
+      # Represents a regional Commitment resource.
+      # Creating a commitment resource means that you are purchasing a committed use
+      # contract with an explicit start and end time. You can create commitments based
+      # on vCPUs and memory usage and receive discounted rates. For full details, read
+      # Signing Up for Committed Use Discounts. (== resource_for beta.
+      # regionCommitments ==) (== resource_for v1.regionCommitments ==)
       class Commitment
         include Google::Apis::Core::Hashable
       
@@ -3557,6 +3578,13 @@ module Google
         # @return [String]
         attr_accessor :status_message
       
+        # The type of commitment, which affects the discount rate and the eligible
+        # resources. Type MEMORY_OPTIMIZED specifies a commitment that will only apply
+        # to memory optimized machines.
+        # Corresponds to the JSON property `type`
+        # @return [String]
+        attr_accessor :type
+      
         def initialize(**args)
            update!(**args)
         end
@@ -3577,6 +3605,7 @@ module Google
           @start_timestamp = args[:start_timestamp] if args.key?(:start_timestamp)
           @status = args[:status] if args.key?(:status)
           @status_message = args[:status_message] if args.key?(:status_message)
+          @type = args[:type] if args.key?(:type)
         end
       end
       
@@ -4243,7 +4272,16 @@ module Google
         end
       end
       
-      # A Disk resource. (== resource_for beta.disks ==) (== resource_for v1.disks ==)
+      # Represents a Persistent Disk resource.
+      # Persistent disks are required for running your VM instances. Create both boot
+      # and non-boot (data) persistent disks. For more information, read Persistent
+      # Disks. For more storage options, read Storage options.
+      # The disks resource represents a zonal persistent disk. For more information,
+      # read Zonal persistent disks.
+      # The regionDisks resource represents a regional persistent disk. For more
+      # information, read  Regional resources. (== resource_for beta.disks ==) (==
+      # resource_for v1.disks ==) (== resource_for v1.regionDisks ==) (== resource_for
+      # beta.regionDisks ==)
       class Disk
         include Google::Apis::Core::Hashable
       
@@ -4824,8 +4862,15 @@ module Google
         end
       end
       
-      # A DiskType resource. (== resource_for beta.diskTypes ==) (== resource_for v1.
-      # diskTypes ==)
+      # Represents a Disk Type resource.
+      # You can choose from a variety of disk types based on your needs. For more
+      # information, read Storage options.
+      # The diskTypes resource represents disk types for a zonal persistent disk. For
+      # more information, read Zonal persistent disks.
+      # The regionDiskTypes resource represents disk types for a regional persistent
+      # disk. For more information, read Regional persistent disks. (== resource_for
+      # beta.diskTypes ==) (== resource_for v1.diskTypes ==) (== resource_for v1.
+      # regionDiskTypes ==) (== resource_for beta.regionDiskTypes ==)
       class DiskType
         include Google::Apis::Core::Hashable
       
@@ -5484,7 +5529,10 @@ module Google
         # @return [String]
         attr_accessor :dest_range
       
-        # If the peering route is imported if there is no confliction.
+        # True if the peering route has been imported from a peer. The actual import
+        # happens if the field networkPeering.importCustomRoutes is true for this
+        # network, and networkPeering.exportCustomRoutes is true for the peer network,
+        # and the import does not result in a route conflict.
         # Corresponds to the JSON property `imported`
         # @return [Boolean]
         attr_accessor :imported
@@ -5932,7 +5980,9 @@ module Google
         end
       end
       
-      # Represents a Firewall resource.
+      # Represents a Firewall Rule resource.
+      # Firewall rules allow or deny ingress traffic to, and egress traffic from your
+      # instances. For more information, read Firewall rules.
       class Firewall
         include Google::Apis::Core::Hashable
       
@@ -5953,30 +6003,30 @@ module Google
         # @return [Array<Google::Apis::ComputeBeta::Firewall::Denied>]
         attr_accessor :denied
       
-        # An optional description of this resource. Provide this property when you
-        # create the resource.
+        # An optional description of this resource. Provide this field when you create
+        # the resource.
         # Corresponds to the JSON property `description`
         # @return [String]
         attr_accessor :description
       
-        # If destination ranges are specified, the firewall will apply only to traffic
+        # If destination ranges are specified, the firewall rule applies only to traffic
         # that has destination IP address in these ranges. These ranges must be
         # expressed in CIDR format. Only IPv4 is supported.
         # Corresponds to the JSON property `destinationRanges`
         # @return [Array<String>]
         attr_accessor :destination_ranges
       
-        # Direction of traffic to which this firewall applies; default is INGRESS. Note:
-        # For INGRESS traffic, it is NOT supported to specify destinationRanges; For
-        # EGRESS traffic, it is NOT supported to specify sourceRanges OR sourceTags.
+        # Direction of traffic to which this firewall applies, either `INGRESS` or `
+        # EGRESS`. The default is `INGRESS`. For `INGRESS` traffic, you cannot specify
+        # the destinationRanges field, and for `EGRESS` traffic, you cannot specify the
+        # sourceRanges or sourceTags fields.
         # Corresponds to the JSON property `direction`
         # @return [String]
         attr_accessor :direction
       
-        # Denotes whether the firewall rule is disabled, i.e not applied to the network
-        # it is associated with. When set to true, the firewall rule is not enforced and
-        # the network behaves as if it did not exist. If this is unspecified, the
-        # firewall rule will be enabled.
+        # Denotes whether the firewall rule is disabled. When set to true, the firewall
+        # rule is not enforced and the network behaves as if it did not exist. If this
+        # is unspecified, the firewall rule will be enabled.
         # Corresponds to the JSON property `disabled`
         # @return [Boolean]
         attr_accessor :disabled
@@ -6009,9 +6059,9 @@ module Google
         # 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.
+        # z0-9]*[a-z0-9])?. The first character must be a lowercase letter, and all
+        # following characters (except for the last character) must be a dash, lowercase
+        # letter, or digit. The last character must be a lowercase letter or digit.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -6019,8 +6069,8 @@ module Google
         # URL of the network resource for this firewall rule. If not specified when
         # creating a firewall rule, the default network is used:
         # global/networks/default
-        # If you choose to specify this property, you can specify the network as a full
-        # or partial URL. For example, the following are all valid URLs:
+        # If you choose to specify this field, you can specify the network as a full or
+        # partial URL. For example, the following are all valid URLs:
         # - https://www.googleapis.com/compute/v1/projects/myproject/global/networks/my-
         # network
         # - projects/myproject/global/networks/my-network
@@ -6029,11 +6079,14 @@ module Google
         # @return [String]
         attr_accessor :network
       
-        # Priority for this rule. This is an integer between 0 and 65535, both inclusive.
-        # When not specified, the value assumed is 1000. Relative priorities determine
-        # precedence of conflicting rules. Lower value of priority implies higher
-        # precedence (eg, a rule with priority 0 has higher precedence than a rule with
-        # priority 1). DENY rules take precedence over ALLOW rules having equal priority.
+        # Priority for this rule. This is an integer between `0` and `65535`, both
+        # inclusive. The default value is `1000`. Relative priorities determine which
+        # rule takes effect if multiple rules apply. Lower values indicate higher
+        # priority. For example, a rule with priority `0` has higher precedence than a
+        # rule with priority `1`. DENY rules take precedence over ALLOW rules if they
+        # have equal priority. Note that VPC networks have implied rules with a priority
+        # of `65535`. To avoid conflicts with the implied rules, use a priority number
+        # less than `65535`.
         # Corresponds to the JSON property `priority`
         # @return [Fixnum]
         attr_accessor :priority
@@ -6043,26 +6096,26 @@ module Google
         # @return [String]
         attr_accessor :self_link
       
-        # If source ranges are specified, the firewall will apply only to traffic that
-        # has source IP address in these ranges. These ranges must be expressed in CIDR
-        # format. One or both of sourceRanges and sourceTags may be set. If both
-        # properties are set, the firewall will apply to traffic that has source IP
-        # address within sourceRanges OR the source IP that belongs to a tag listed in
-        # the sourceTags property. The connection does not need to match both properties
-        # for the firewall to apply. Only IPv4 is supported.
+        # If source ranges are specified, the firewall rule applies only to traffic that
+        # has a source IP address in these ranges. These ranges must be expressed in
+        # CIDR format. One or both of sourceRanges and sourceTags may be set. If both
+        # fields are set, the rule applies to traffic that has a source IP address
+        # within sourceRanges OR a source IP from a resource with a matching tag listed
+        # in the sourceTags field. The connection does not need to match both fields for
+        # the rule to apply. Only IPv4 is supported.
         # Corresponds to the JSON property `sourceRanges`
         # @return [Array<String>]
         attr_accessor :source_ranges
       
-        # If source service accounts are specified, the firewall will apply only to
+        # If source service accounts are specified, the firewall rules apply only to
         # traffic originating from an instance with a service account in this list.
         # Source service accounts cannot be used to control traffic to an instance's
         # external IP address because service accounts are associated with an instance,
         # not an IP address. sourceRanges can be set at the same time as
-        # sourceServiceAccounts. If both are set, the firewall will apply to traffic
-        # that has source IP address within sourceRanges OR the source IP belongs to an
-        # instance with service account listed in sourceServiceAccount. The connection
-        # does not need to match both properties for the firewall to apply.
+        # sourceServiceAccounts. If both are set, the firewall applies to traffic that
+        # has a source IP address within the sourceRanges OR a source IP that belongs to
+        # an instance with service account listed in sourceServiceAccount. The
+        # connection does not need to match both fields for the firewall to apply.
         # sourceServiceAccounts cannot be used at the same time as sourceTags or
         # targetTags.
         # Corresponds to the JSON property `sourceServiceAccounts`
@@ -6075,10 +6128,10 @@ module Google
         # traffic to an instance's external IP address, it only applies to traffic
         # between instances in the same virtual network. Because tags are associated
         # with instances, not IP addresses. One or both of sourceRanges and sourceTags
-        # may be set. If both properties are set, the firewall will apply to traffic
-        # that has source IP address within sourceRanges OR the source IP that belongs
-        # to a tag listed in the sourceTags property. The connection does not need to
-        # match both properties for the firewall to apply.
+        # may be set. If both fields are set, the firewall applies to traffic that has a
+        # source IP address within sourceRanges OR a source IP from a resource with a
+        # matching tag listed in the sourceTags field. The connection does not need to
+        # match both fields for the firewall to apply.
         # Corresponds to the JSON property `sourceTags`
         # @return [Array<String>]
         attr_accessor :source_tags
@@ -6134,15 +6187,16 @@ module Google
         
           # The IP protocol to which this rule applies. The protocol type is required when
           # creating a firewall rule. This value can either be one of the following well
-          # known protocol strings (tcp, udp, icmp, esp, ah, ipip, sctp), or the IP
+          # known protocol strings (tcp, udp, icmp, esp, ah, ipip, sctp) or the IP
           # protocol number.
           # Corresponds to the JSON property `IPProtocol`
           # @return [String]
           attr_accessor :ip_protocol
         
           # An optional list of ports to which this rule applies. This field is only
-          # applicable for UDP or TCP protocol. Each entry must be either an integer or a
-          # range. If not specified, this rule applies to connections through any port.
+          # applicable for the UDP or TCP protocol. Each entry must be either an integer
+          # or a range. If not specified, this rule applies to connections through any
+          # port.
           # Example inputs include: ["22"], ["80","443"], and ["12345-12349"].
           # Corresponds to the JSON property `ports`
           # @return [Array<String>]
@@ -6165,15 +6219,16 @@ module Google
         
           # The IP protocol to which this rule applies. The protocol type is required when
           # creating a firewall rule. This value can either be one of the following well
-          # known protocol strings (tcp, udp, icmp, esp, ah, ipip, sctp), or the IP
+          # known protocol strings (tcp, udp, icmp, esp, ah, ipip, sctp) or the IP
           # protocol number.
           # Corresponds to the JSON property `IPProtocol`
           # @return [String]
           attr_accessor :ip_protocol
         
           # An optional list of ports to which this rule applies. This field is only
-          # applicable for UDP or TCP protocol. Each entry must be either an integer or a
-          # range. If not specified, this rule applies to connections through any port.
+          # applicable for the UDP or TCP protocol. Each entry must be either an integer
+          # or a range. If not specified, this rule applies to connections through any
+          # port.
           # Example inputs include: ["22"], ["80","443"], and ["12345-12349"].
           # Corresponds to the JSON property `ports`
           # @return [Array<String>]
@@ -9150,8 +9205,10 @@ module Google
         end
       end
       
-      # An Image resource. (== resource_for beta.images ==) (== resource_for v1.images
-      # ==)
+      # Represents an Image resource.
+      # You can use images to create boot disks for your VM instances. For more
+      # information, read Images. (== resource_for beta.images ==) (== resource_for v1.
+      # images ==)
       class Image
         include Google::Apis::Core::Hashable
       
@@ -9535,8 +9592,10 @@ module Google
         end
       end
       
-      # An Instance resource. (== resource_for beta.instances ==) (== resource_for v1.
-      # instances ==)
+      # Represents an Instance resource.
+      # An instance is a virtual machine that is hosted on Google Cloud Platform. For
+      # more information, read Virtual Machine Instances. (== resource_for beta.
+      # instances ==) (== resource_for v1.instances ==)
       class Instance
         include Google::Apis::Core::Hashable
       
@@ -9666,13 +9725,13 @@ module Google
         # @return [Array<Google::Apis::ComputeBeta::NetworkInterface>]
         attr_accessor :network_interfaces
       
-        # AllocationAffinity is the configuration of desired allocation which this
+        # ReservationAffinity is the configuration of desired reservation which this
         # instance could take capacity from.
         # Corresponds to the JSON property `reservationAffinity`
         # @return [Google::Apis::ComputeBeta::ReservationAffinity]
         attr_accessor :reservation_affinity
       
-        # Sets the scheduling options for an Instance.
+        # Sets the scheduling options for an Instance. NextID: 9
         # Corresponds to the JSON property `scheduling`
         # @return [Google::Apis::ComputeBeta::Scheduling]
         attr_accessor :scheduling
@@ -9902,9 +9961,15 @@ module Google
         end
       end
       
-      # InstanceGroups (== resource_for beta.instanceGroups ==) (== resource_for v1.
-      # instanceGroups ==) (== resource_for beta.regionInstanceGroups ==) (==
-      # resource_for v1.regionInstanceGroups ==)
+      # Represents an unmanaged Instance Group resource.
+      # Use unmanaged instance groups if you need to apply load balancing to groups of
+      # heterogeneous instances or if you need to manage the instances yourself. For
+      # more information, read  Instance groups.
+      # For zonal unmanaged Instance Group, use instanceGroups resource.
+      # For regional unmanaged Instance Group, use regionInstanceGroups resource. (==
+      # resource_for beta.instanceGroups ==) (== resource_for v1.instanceGroups ==) (==
+      # resource_for beta.regionInstanceGroups ==) (== resource_for v1.
+      # regionInstanceGroups ==)
       class InstanceGroup
         include Google::Apis::Core::Hashable
       
@@ -10246,10 +10311,14 @@ module Google
         end
       end
       
-      # An Instance Group Manager resource. (== resource_for beta.
-      # instanceGroupManagers ==) (== resource_for v1.instanceGroupManagers ==) (==
-      # resource_for beta.regionInstanceGroupManagers ==) (== resource_for v1.
-      # regionInstanceGroupManagers ==)
+      # Represents a Managed Instance Group resource.
+      # An instance group is a collection of VM instances that you can manage as a
+      # single entity. For more information, read Instance groups.
+      # For zonal Managed Instance Group, use the instanceGroupManagers resource.
+      # For regional Managed Instance Group, use the regionInstanceGroupManagers
+      # resource. (== resource_for beta.instanceGroupManagers ==) (== resource_for v1.
+      # instanceGroupManagers ==) (== resource_for beta.regionInstanceGroupManagers ==)
+      # (== resource_for v1.regionInstanceGroupManagers ==)
       class InstanceGroupManager
         include Google::Apis::Core::Hashable
       
@@ -10941,7 +11010,11 @@ module Google
         # @return [String]
         attr_accessor :minimal_action
       
-        # 
+        # The type of update process. You can specify either PROACTIVE so that the
+        # instance group manager proactively executes actions in order to bring
+        # instances to their target versions or OPPORTUNISTIC so that no action is
+        # proactively executed but the update will be performed as part of other actions
+        # (for example, resizes or recreateInstances calls).
         # Corresponds to the JSON property `type`
         # @return [String]
         attr_accessor :type
@@ -11019,20 +11092,33 @@ module Google
       class InstanceGroupManagersApplyUpdatesRequest
         include Google::Apis::Core::Hashable
       
-        # The list of URLs of one or more instances for which we want to apply updates
-        # on this managed instance group. This can be a full URL or a partial URL, such
-        # as zones/[ZONE]/instances/[INSTANCE_NAME].
+        # The list of URLs of one or more instances for which you want to apply updates.
+        # Each URL can be a full URL or a partial URL, such as zones/[ZONE]/instances/[
+        # INSTANCE_NAME].
         # Corresponds to the JSON property `instances`
         # @return [Array<String>]
         attr_accessor :instances
       
-        # The minimal action that should be perfomed on the instances. By default NONE.
+        # The minimal action that you want to perform on each instance during the update:
+        # 
+        # - REPLACE: At minimum, delete the instance and create it again.
+        # - RESTART: Stop the instance and start it again.
+        # - REFRESH: Do not stop the instance.
+        # - NONE: Do not disrupt the instance at all.  By default, the minimum action is
+        # NONE. If your update requires a more disruptive action than you set with this
+        # flag, the necessary action is performed to execute the update.
         # Corresponds to the JSON property `minimalAction`
         # @return [String]
         attr_accessor :minimal_action
       
-        # The most disruptive action that allowed to be performed on the instances. By
-        # default REPLACE.
+        # The most disruptive action that you want to perform on each instance during
+        # the update:
+        # - REPLACE: Delete the instance and create it again.
+        # - RESTART: Stop the instance and start it again.
+        # - REFRESH: Do not stop the instance.
+        # - NONE: Do not disrupt the instance at all.  By default, the most disruptive
+        # allowed action is REPLACE. If your update requires a more disruptive action
+        # than you set with this flag, the update request will fail.
         # Corresponds to the JSON property `mostDisruptiveAllowedAction`
         # @return [String]
         attr_accessor :most_disruptive_allowed_action
@@ -11964,13 +12050,13 @@ module Google
         # @return [Array<Google::Apis::ComputeBeta::NetworkInterface>]
         attr_accessor :network_interfaces
       
-        # AllocationAffinity is the configuration of desired allocation which this
+        # ReservationAffinity is the configuration of desired reservation which this
         # instance could take capacity from.
         # Corresponds to the JSON property `reservationAffinity`
         # @return [Google::Apis::ComputeBeta::ReservationAffinity]
         attr_accessor :reservation_affinity
       
-        # Sets the scheduling options for an Instance.
+        # Sets the scheduling options for an Instance. NextID: 9
         # Corresponds to the JSON property `scheduling`
         # @return [Google::Apis::ComputeBeta::Scheduling]
         attr_accessor :scheduling
@@ -12041,8 +12127,10 @@ module Google
         end
       end
       
-      # An Instance Template resource. (== resource_for beta.instanceTemplates ==) (==
-      # resource_for v1.instanceTemplates ==)
+      # Represents an Instance Template resource.
+      # You can use instance templates to create VM instances and managed instance
+      # groups. For more information, read Instance Templates. (== resource_for beta.
+      # instanceTemplates ==) (== resource_for v1.instanceTemplates ==)
       class InstanceTemplate
         include Google::Apis::Core::Hashable
       
@@ -12556,10 +12644,11 @@ module Google
         end
       end
       
-      # Represents an Interconnects resource. The Interconnects resource is a
-      # dedicated connection between Google's network and your on-premises network.
-      # For more information, see the  Dedicated overview page. (== resource_for v1.
-      # interconnects ==) (== resource_for beta.interconnects ==)
+      # Represents an Interconnect resource.
+      # An Interconnect resource is a dedicated connection between the GCP network and
+      # your on-premises network. For more information, read the  Dedicated
+      # Interconnect Overview. (== resource_for v1.interconnects ==) (== resource_for
+      # beta.interconnects ==)
       class Interconnect
         include Google::Apis::Core::Hashable
       
@@ -12772,8 +12861,10 @@ module Google
         end
       end
       
-      # Represents an InterconnectAttachment (VLAN attachment) resource. For more
-      # information, see  Creating VLAN Attachments. (== resource_for beta.
+      # Represents an Interconnect Attachment (VLAN) resource.
+      # You can use Interconnect attachments (VLANS) to connect your Virtual Private
+      # Cloud networks to your on-premises networks through an Interconnect. For more
+      # information, read  Creating VLAN Attachments. (== resource_for beta.
       # interconnectAttachments ==) (== resource_for v1.interconnectAttachments ==)
       class InterconnectAttachment
         include Google::Apis::Core::Hashable
@@ -12851,7 +12942,8 @@ module Google
         attr_accessor :edge_availability_domain
       
         # [Output Only] Google reference ID, to be used when raising support tickets
-        # with Google or otherwise to debug backend connectivity issues.
+        # with Google or otherwise to debug backend connectivity issues. [Deprecated]
+        # This field is not used.
         # Corresponds to the JSON property `googleReferenceId`
         # @return [String]
         attr_accessor :google_reference_id
@@ -13754,9 +13846,10 @@ module Google
         end
       end
       
-      # Represents an InterconnectLocations resource. The InterconnectLocations
-      # resource describes the locations where you can connect to Google's networks.
-      # For more information, see  Colocation Facilities.
+      # Represents an Interconnect Attachment (VLAN) Location resource.
+      # You can use this resource to find location details about an Interconnect
+      # attachment (VLAN). For more information about interconnect attachments, read
+      # Creating VLAN Attachments.
       class InterconnectLocation
         include Google::Apis::Core::Hashable
       
@@ -14574,8 +14667,10 @@ module Google
         end
       end
       
-      # A Machine Type resource. (== resource_for v1.machineTypes ==) (== resource_for
-      # beta.machineTypes ==)
+      # Represents a Machine Type resource.
+      # You can use specific machine types for your VM instances based on performance
+      # and pricing requirements. For more information, read Machine Types. (==
+      # resource_for v1.machineTypes ==) (== resource_for beta.machineTypes ==)
       class MachineType
         include Google::Apis::Core::Hashable
       
@@ -15341,9 +15436,10 @@ module Google
         end
       end
       
-      # Represents a Network resource. Read Virtual Private Cloud (VPC) Network
-      # Overview for more information. (== resource_for v1.networks ==) (==
-      # resource_for beta.networks ==)
+      # Represents a VPC Network resource.
+      # Networks connect resources to each other and to the internet. For more
+      # information, read Virtual Private Cloud (VPC) Network. (== resource_for v1.
+      # networks ==) (== resource_for beta.networks ==)
       class Network
         include Google::Apis::Core::Hashable
       
@@ -15368,14 +15464,14 @@ module Google
         # @return [String]
         attr_accessor :creation_timestamp
       
-        # An optional description of this resource. Provide this property when you
-        # create the resource.
+        # An optional description of this resource. Provide this field when you create
+        # the resource.
         # Corresponds to the JSON property `description`
         # @return [String]
         attr_accessor :description
       
-        # [Output Only] The gateway address for default routing out of the network. This
-        # value is read only and is selected by GCP.
+        # [Output Only] The gateway address for default routing out of the network,
+        # selected by GCP.
         # Corresponds to the JSON property `gatewayIPv4`
         # @return [String]
         attr_accessor :gateway_i_pv4
@@ -15394,9 +15490,9 @@ module Google
         # 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.
+        # z0-9]*[a-z0-9])?. The first character must be a lowercase letter, and all
+        # following characters (except for the last character) must be a dash, lowercase
+        # letter, or digit. The last character must be a lowercase letter or digit.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -16165,8 +16261,8 @@ module Google
         # @return [Array<Google::Apis::ComputeBeta::AccessConfig>]
         attr_accessor :access_configs
       
-        # An array of alias IP ranges for this network interface. Can only be specified
-        # for network interfaces on subnet-mode networks.
+        # An array of alias IP ranges for this network interface. You can only specify
+        # this field for network interfaces in VPC networks.
         # Corresponds to the JSON property `aliasIpRanges`
         # @return [Array<Google::Apis::ComputeBeta::AliasIpRange>]
         attr_accessor :alias_ip_ranges
@@ -16186,8 +16282,8 @@ module Google
         # @return [String]
         attr_accessor :kind
       
-        # [Output Only] The name of the network interface, generated by the server. For
-        # network devices, these are eth0, eth1, etc.
+        # [Output Only] The name of the network interface, which is generated by the
+        # server. For network devices, these are eth0, eth1, etc.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -16196,8 +16292,6 @@ module Google
         # neither the network nor the subnetwork is specified, the default network
         # global/networks/default is used; if the network is not specified but the
         # subnetwork is specified, the network is inferred.
-        # This field is optional when creating a firewall rule. If not specified when
-        # creating a firewall rule, the default network global/networks/default is used.
         # If you specify this property, you can specify the network as a full or partial
         # URL. For example, the following are all valid URLs:
         # - https://www.googleapis.com/compute/v1/projects/project/global/networks/
@@ -16208,7 +16302,7 @@ module Google
         # @return [String]
         attr_accessor :network
       
-        # An IPv4 internal network address to assign to the instance for this network
+        # An IPv4 internal IP address to assign to the instance for this network
         # interface. If not specified by the user, an unused internal IP is assigned by
         # the system.
         # Corresponds to the JSON property `networkIP`
@@ -16216,9 +16310,9 @@ module Google
         attr_accessor :network_ip
       
         # The URL of the Subnetwork resource for this instance. If the network resource
-        # is in legacy mode, do not provide this property. If the network is in auto
-        # subnet mode, providing the subnetwork is optional. If the network is in custom
-        # subnet mode, then this field should be specified. If you specify this property,
+        # is in legacy mode, do not specify this field. If the network is in auto subnet
+        # mode, specifying the subnetwork is optional. If the network is in custom
+        # subnet mode, specifying the subnetwork is required. If you specify this field,
         # you can specify the subnetwork as a full or partial URL. For example, the
         # following are all valid URLs:
         # - https://www.googleapis.com/compute/v1/projects/project/regions/region/
@@ -16369,7 +16463,7 @@ module Google
       class NetworkPeering
         include Google::Apis::Core::Hashable
       
-        # This field will be deprecated soon. Prefer using exchange_subnet_routes
+        # This field will be deprecated soon. Use the exchange_subnet_routes field
         # instead. Indicates whether full mesh connectivity is created and managed
         # automatically. When it is set to true, Google Compute Engine will
         # automatically create and manage the routes between two networks when the state
@@ -16403,10 +16497,10 @@ module Google
       
         # Name of this peering. Provided by the client when the peering is created. The
         # name must comply with RFC1035. Specifically, the name must be 1-63 characters
-        # long and match regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the
-        # first character must be a lowercase letter, and all the following characters
-        # must be a dash, lowercase letter, or digit, except the last character, which
-        # cannot be a dash.
+        # long and match regular expression `[a-z]([-a-z0-9]*[a-z0-9])?`. The first
+        # character must be a lowercase letter, and all the 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`
         # @return [String]
         attr_accessor :name
@@ -16419,7 +16513,8 @@ module Google
         # @return [String]
         attr_accessor :network
       
-        # [Output Only] State for the peering.
+        # [Output Only] State for the peering, either `ACTIVE` or `INACTIVE`. The
+        # peering is `ACTIVE` when there's a matching configuration in the peer network.
         # Corresponds to the JSON property `state`
         # @return [String]
         attr_accessor :state
@@ -16452,9 +16547,9 @@ module Google
       class NetworkRoutingConfig
         include Google::Apis::Core::Hashable
       
-        # The network-wide routing mode to use. If set to REGIONAL, this network's cloud
-        # routers will only advertise routes with subnets of this network in the same
-        # region as the router. If set to GLOBAL, this network's cloud routers will
+        # The network-wide routing mode to use. If set to REGIONAL, this network's Cloud
+        # Routers will only advertise routes with subnets of this network in the same
+        # region as the router. If set to GLOBAL, this network's Cloud Routers will
         # advertise routes with all subnets of this network, across regions.
         # Corresponds to the JSON property `routingMode`
         # @return [String]
@@ -16474,7 +16569,7 @@ module Google
       class NetworksAddPeeringRequest
         include Google::Apis::Core::Hashable
       
-        # This field will be deprecated soon. Prefer using exchange_subnet_routes in
+        # This field will be deprecated soon. Use exchange_subnet_routes in
         # network_peering instead. Whether Google Compute Engine manages the routes
         # automatically.
         # Corresponds to the JSON property `autoCreateRoutes`
@@ -16555,10 +16650,13 @@ module Google
         end
       end
       
-      # A NodeGroup resource. To create a node group, you must first create a node
-      # templates. To learn more about node groups and sole-tenant nodes, read the
-      # Sole-tenant nodes documentation. (== resource_for beta.nodeGroups ==) (==
-      # resource_for v1.nodeGroups ==)
+      # Represent a sole-tenant Node Group resource.
+      # A sole-tenant node is a physical server that is dedicated to hosting VM
+      # instances only for your specific project. Use sole-tenant nodes to keep your
+      # instances physically separated from instances in other projects, or to group
+      # your instances together on the same host hardware. For more information, read
+      # Sole-tenant nodes. (== resource_for beta.nodeGroups ==) (== resource_for v1.
+      # nodeGroups ==) NextID: 15
       class NodeGroup
         include Google::Apis::Core::Hashable
       
@@ -17187,9 +17285,10 @@ module Google
         end
       end
       
-      # A Node Template resource. To learn more about node templates and sole-tenant
-      # nodes, read the Sole-tenant nodes documentation. (== resource_for beta.
-      # nodeTemplates ==) (== resource_for v1.nodeTemplates ==)
+      # Represent a sole-tenant Node Template resource.
+      # You can use a template to define properties for nodes in a node group. For
+      # more information, read Creating node groups and instances. (== resource_for
+      # beta.nodeTemplates ==) (== resource_for v1.nodeTemplates ==) (== NextID: 16 ==)
       class NodeTemplate
         include Google::Apis::Core::Hashable
       
@@ -17256,7 +17355,12 @@ module Google
         # @return [String]
         attr_accessor :self_link
       
-        # Binding properties for the physical server.
+        # Sets the binding properties for the physical server. Valid values include:
+        # - [Default] RESTART_NODE_ON_ANY_SERVER: Restarts VMs on any available physical
+        # server
+        # - RESTART_NODE_ON_MINIMAL_SERVER: Restarts VMs on the same physical server
+        # whenever possible
+        # See Sole-tenant node options for more information.
         # Corresponds to the JSON property `serverBinding`
         # @return [Google::Apis::ComputeBeta::ServerBinding]
         attr_accessor :server_binding
@@ -17652,7 +17756,12 @@ module Google
         end
       end
       
-      # A Node Type resource.
+      # Represent a sole-tenant Node Type resource.
+      # Each node within a node group must have a node type. A node type specifies the
+      # total amount of cores and memory for that node. Currently, the only available
+      # node type is n1-node-96-624 node type that has 96 vCPUs and 624 GB of memory,
+      # available in multiple zones. For more information read Node types. (==
+      # resource_for beta.nodeTypes ==) (== resource_for v1.nodeTypes ==)
       class NodeType
         include Google::Apis::Core::Hashable
       
@@ -18067,7 +18176,14 @@ module Google
         end
       end
       
-      # An Operation resource, used to manage asynchronous API requests. (==
+      # Represents an Operation resource.
+      # You can use an operation resource to manage asynchronous API requests. For
+      # more information, read Handling API responses.
+      # Operations can be global, regional or zonal.
+      # - For global operations, use the globalOperations resource.
+      # - For regional operations, use the regionOperations resource.
+      # - For zonal operations, use the zonalOperations resource.
+      # For more information, read  Global, Regional, and Zonal Resources. (==
       # resource_for v1.globalOperations ==) (== resource_for beta.globalOperations ==)
       # (== resource_for v1.regionOperations ==) (== resource_for beta.
       # regionOperations ==) (== resource_for v1.zoneOperations ==) (== resource_for
@@ -18155,9 +18271,7 @@ module Google
         attr_accessor :progress
       
         # [Output Only] The URL of the region where the operation resides. Only
-        # available when performing regional operations. You must specify this field as
-        # part of the HTTP request URL. It is not settable as a field in the request
-        # body.
+        # applicable when performing regional operations.
         # Corresponds to the JSON property `region`
         # @return [String]
         attr_accessor :region
@@ -18209,9 +18323,8 @@ module Google
         # @return [Array<Google::Apis::ComputeBeta::Operation::Warning>]
         attr_accessor :warnings
       
-        # [Output Only] The URL of the zone where the operation resides. Only available
-        # when performing per-zone operations. You must specify this field as part of
-        # the HTTP request URL. It is not settable as a field in the request body.
+        # [Output Only] The URL of the zone where the operation resides. Only applicable
+        # when performing per-zone operations.
         # Corresponds to the JSON property `zone`
         # @return [String]
         attr_accessor :zone
@@ -19053,8 +19166,10 @@ module Google
         end
       end
       
-      # A Project resource. For an overview of projects, see  Cloud Platform Resource
-      # Hierarchy. (== resource_for v1.projects ==) (== resource_for beta.projects ==)
+      # Represents a Project resource.
+      # A project is used to organize resources in a Google Cloud Platform environment.
+      # For more information, read about the  Resource Hierarchy. (== resource_for v1.
+      # projects ==) (== resource_for beta.projects ==)
       class Project
         include Google::Apis::Core::Hashable
       
@@ -19344,8 +19459,10 @@ module Google
         end
       end
       
-      # Region resource. (== resource_for beta.regions ==) (== resource_for v1.regions
-      # ==)
+      # Represents a Region resource.
+      # A region is a geographical area where a resource is located. For more
+      # information, read Regions and Zones. (== resource_for beta.regions ==) (==
+      # resource_for v1.regions ==)
       class Region
         include Google::Apis::Core::Hashable
       
@@ -19992,19 +20109,33 @@ module Google
       class RegionInstanceGroupManagersApplyUpdatesRequest
         include Google::Apis::Core::Hashable
       
-        # The list of instances for which we want to apply changes on this managed
-        # instance group.
+        # The list of URLs of one or more instances for which you want to apply updates.
+        # Each URL can be a full URL or a partial URL, such as zones/[ZONE]/instances/[
+        # INSTANCE_NAME].
         # Corresponds to the JSON property `instances`
         # @return [Array<String>]
         attr_accessor :instances
       
-        # The minimal action that should be perfomed on the instances. By default NONE.
+        # The minimal action that you want to perform on each instance during the update:
+        # 
+        # - REPLACE: At minimum, delete the instance and create it again.
+        # - RESTART: Stop the instance and start it again.
+        # - REFRESH: Do not stop the instance.
+        # - NONE: Do not disrupt the instance at all.  By default, the minimum action is
+        # NONE. If your update requires a more disruptive action than you set with this
+        # flag, the necessary action is performed to execute the update.
         # Corresponds to the JSON property `minimalAction`
         # @return [String]
         attr_accessor :minimal_action
       
-        # The most disruptive action that allowed to be performed on the instances. By
-        # default REPLACE.
+        # The most disruptive action that you want to perform on each instance during
+        # the update:
+        # - REPLACE: Delete the instance and create it again.
+        # - RESTART: Stop the instance and start it again.
+        # - REFRESH: Do not stop the instance.
+        # - NONE: Do not disrupt the instance at all.  By default, the most disruptive
+        # allowed action is REPLACE. If your update requires a more disruptive action
+        # than you set with this flag, the update request will fail.
         # Corresponds to the JSON property `mostDisruptiveAllowedAction`
         # @return [String]
         attr_accessor :most_disruptive_allowed_action
@@ -20595,7 +20726,7 @@ module Google
         end
       end
       
-      # Reservation resource
+      # Reservation resource NextID: 13
       class Reservation
         include Google::Apis::Core::Hashable
       
@@ -20657,6 +20788,11 @@ module Google
         attr_accessor :specific_reservation_required
         alias_method :specific_reservation_required?, :specific_reservation_required
       
+        # [Output Only] The status of the reservation.
+        # Corresponds to the JSON property `status`
+        # @return [String]
+        attr_accessor :status
+      
         # Zone in which the reservation resides, must be provided if reservation is
         # created with commitment creation.
         # Corresponds to the JSON property `zone`
@@ -20678,11 +20814,12 @@ module Google
           @self_link = args[:self_link] if args.key?(:self_link)
           @specific_reservation = args[:specific_reservation] if args.key?(:specific_reservation)
           @specific_reservation_required = args[:specific_reservation_required] if args.key?(:specific_reservation_required)
+          @status = args[:status] if args.key?(:status)
           @zone = args[:zone] if args.key?(:zone)
         end
       end
       
-      # AllocationAffinity is the configuration of desired allocation which this
+      # ReservationAffinity is the configuration of desired reservation which this
       # instance could take capacity from.
       class ReservationAffinity
         include Google::Apis::Core::Hashable
@@ -21778,20 +21915,11 @@ module Google
         end
       end
       
-      # Represents a Route resource. A route specifies how certain packets should be
-      # handled by the network. Routes are associated with instances by tags and the
-      # set of routes for a particular instance is called its routing table.
-      # For each packet leaving an instance, the system searches that instance's
-      # routing table for a single best matching route. Routes match packets by
-      # destination IP address, preferring smaller or more specific ranges over larger
-      # ones. If there is a tie, the system selects the route with the smallest
-      # priority value. If there is still a tie, it uses the layer three and four
-      # packet headers to select just one of the remaining matching routes. The packet
-      # is then forwarded as specified by the nextHop field of the winning route -
-      # either to another instance destination, an instance gateway, or a Google
-      # Compute Engine-operated gateway.
-      # Packets that do not match any route in the sending instance's routing table
-      # are dropped. (== resource_for beta.routes ==) (== resource_for v1.routes ==)
+      # Represents a Route resource.
+      # A route defines a path from VM instances in the VPC network to a specific
+      # destination. This destination can be inside or outside the VPC network. For
+      # more information, read the Routes overview. (== resource_for beta.routes ==) (=
+      # = resource_for v1.routes ==)
       class Route
         include Google::Apis::Core::Hashable
       
@@ -21800,8 +21928,8 @@ module Google
         # @return [String]
         attr_accessor :creation_timestamp
       
-        # An optional description of this resource. Provide this property when you
-        # create the resource.
+        # An optional description of this resource. Provide this field when you create
+        # the resource.
         # Corresponds to the JSON property `description`
         # @return [String]
         attr_accessor :description
@@ -21826,9 +21954,9 @@ module Google
         # 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.
+        # z0-9]*[a-z0-9])?`. The first character must be a lowercase letter, and all
+        # following characters (except for the last character) must be a dash, lowercase
+        # letter, or digit. The last character must be a lowercase letter or digit.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -21839,7 +21967,7 @@ module Google
         attr_accessor :network
       
         # The URL to a gateway that should handle matching packets. You can only specify
-        # the internet gateway using a full or partial valid URL:  projects/<project-id>/
+        # the internet gateway using a full or partial valid URL:  projects/project/
         # global/gateways/default-internet-gateway
         # Corresponds to the JSON property `nextHopGateway`
         # @return [String]
@@ -21893,9 +22021,10 @@ module Google
         attr_accessor :next_hop_vpn_tunnel
       
         # The priority of this route. Priority is used to break ties in cases where
-        # there is more than one matching route of equal prefix length. In the case of
-        # two routes with equal prefix length, the one with the lowest-numbered priority
-        # value wins. Default value is 1000. Valid range is 0 through 65535.
+        # there is more than one matching route of equal prefix length. In cases where
+        # multiple routes have equal prefix length, the one with the lowest-numbered
+        # priority value wins. The default value is `1000`. The priority value must be
+        # from `0` to `65535`, inclusive.
         # Corresponds to the JSON property `priority`
         # @return [Fixnum]
         attr_accessor :priority
@@ -22125,7 +22254,8 @@ module Google
         end
       end
       
-      # Router resource.
+      # Represents a Cloud Router resource.
+      # For more information about Cloud Router, read the the Cloud Router overview.
       class Router
         include Google::Apis::Core::Hashable
       
@@ -23048,7 +23178,8 @@ module Google
       class RoutersPreviewResponse
         include Google::Apis::Core::Hashable
       
-        # Router resource.
+        # Represents a Cloud Router resource.
+        # For more information about Cloud Router, read the the Cloud Router overview.
         # Corresponds to the JSON property `resource`
         # @return [Google::Apis::ComputeBeta::Router]
         attr_accessor :resource
@@ -23287,7 +23418,7 @@ module Google
         end
       end
       
-      # Sets the scheduling options for an Instance.
+      # Sets the scheduling options for an Instance. NextID: 9
       class Scheduling
         include Google::Apis::Core::Hashable
       
@@ -24104,8 +24235,10 @@ module Google
         end
       end
       
-      # A persistent disk snapshot resource. (== resource_for beta.snapshots ==) (==
-      # resource_for v1.snapshots ==)
+      # Represents a Persistent Disk Snapshot resource.
+      # You can use snapshots to back up data on a regular interval. For more
+      # information, read  Creating persistent disk snapshots. (== resource_for beta.
+      # snapshots ==) (== resource_for v1.snapshots ==)
       class Snapshot
         include Google::Apis::Core::Hashable
       
@@ -25238,8 +25371,11 @@ module Google
         end
       end
       
-      # A Subnetwork resource. (== resource_for beta.subnetworks ==) (== resource_for
-      # v1.subnetworks ==)
+      # Represents a Subnetwork resource.
+      # A subnetwork (also known as a subnet) is a logical partition of a Virtual
+      # Private Cloud network with one primary IP range and zero or more secondary IP
+      # ranges. For more information, read  Virtual Private Cloud (VPC) Network. (==
+      # resource_for beta.subnetworks ==) (== resource_for v1.subnetworks ==)
       class Subnetwork
         include Google::Apis::Core::Hashable
       
@@ -25687,9 +25823,9 @@ module Google
         # @return [Float]
         attr_accessor :flow_sampling
       
-        # Can only be specified if VPC flow logging for this subnetwork is enabled.
-        # Configures whether metadata fields should be added to the reported VPC flow
-        # logs. Default is INCLUDE_ALL_METADATA.
+        # Can only be specified if VPC flow logs for this subnetwork is enabled.
+        # Configures whether all, none or a subset of metadata fields should be added to
+        # the reported VPC flow logs. Default is INCLUDE_ALL_METADATA.
         # Corresponds to the JSON property `metadata`
         # @return [String]
         attr_accessor :metadata
@@ -26843,9 +26979,12 @@ module Google
         end
       end
       
-      # A TargetInstance resource. This resource defines an endpoint instance that
-      # terminates traffic of certain protocols. (== resource_for beta.targetInstances
-      # ==) (== resource_for v1.targetInstances ==)
+      # Represents a Target Instance resource.
+      # You can use a target instance to handle traffic for one or more forwarding
+      # rules, which is ideal for forwarding protocol traffic that is managed by a
+      # single source. For example, ESP, AH, TCP, or UDP. For more information, read
+      # Target instances. (== resource_for beta.targetInstances ==) (== resource_for
+      # v1.targetInstances ==)
       class TargetInstance
         include Google::Apis::Core::Hashable
       
@@ -28327,7 +28466,9 @@ module Google
         end
       end
       
-      # Represents a Target VPN gateway resource. (== resource_for beta.
+      # Represents a Target VPN Gateway resource.
+      # The target VPN gateway resource represents a Classic Cloud VPN gateway. For
+      # more information, read the the Cloud VPN Overview. (== resource_for beta.
       # targetVpnGateways ==) (== resource_for v1.targetVpnGateways ==)
       class TargetVpnGateway
         include Google::Apis::Core::Hashable
@@ -30467,8 +30608,9 @@ module Google
         end
       end
       
-      # VPN tunnel resource. (== resource_for beta.vpnTunnels ==) (== resource_for v1.
-      # vpnTunnels ==)
+      # Represents a Cloud VPN Tunnel resource.
+      # For more information about VPN, read the the Cloud VPN Overview. (==
+      # resource_for beta.vpnTunnels ==) (== resource_for v1.vpnTunnels ==)
       class VpnTunnel
         include Google::Apis::Core::Hashable
       
@@ -31241,8 +31383,11 @@ module Google
         end
       end
       
-      # A Zone resource. (== resource_for beta.zones ==) (== resource_for v1.zones ==)
-      # Next ID: 17
+      # Represents a Zone resource.
+      # A zone is a deployment area. These deployment areas are subsets of a region.
+      # For example the zone us-east1-a is located in the us-east1 region. For more
+      # information, read Regions and Zones. (== resource_for beta.zones ==) (==
+      # resource_for v1.zones ==)
       class Zone
         include Google::Apis::Core::Hashable