google-api-client 0.9 → 0.9.1

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

@@ -1554,6 +1554,7 @@ module Google
           property :network, as: 'network'
           property :self_link, as: 'selfLink'
           property :size, as: 'size'
+          property :subnetwork, as: 'subnetwork'
           property :zone, as: 'zone'
         end
       end

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

@@ -52,7 +52,7 @@ module Google
           super('https://www.googleapis.com/', 'compute/beta/projects/')
         end
         
-        # Retrieves the list of addresses grouped by scope.
+        # Retrieves an aggregated list of addresses.
         # @param [String] project
         #   Project ID for this request.
         # @param [String] filter
@@ -254,7 +254,7 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Retrieves the list of address resources contained within the specified region.
+        # Retrieves a list of address resources contained within the specified region.
         # @param [String] project
         #   Project ID for this request.
         # @param [String] region
@@ -335,7 +335,7 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Retrieves the list of autoscalers grouped by scope.
+        # Retrieves an aggregated list of autoscalers.
         # @param [String] project
         #   Project ID for this request.
         # @param [String] filter
@@ -537,7 +537,7 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Retrieves the list of autoscaler resources contained within the specified zone.
+        # Retrieves a list of autoscaler resources contained within the specified zone.
         # @param [String] project
         #   Project ID for this request.
         # @param [String] zone
@@ -825,7 +825,9 @@ module Google
         end
         
         # Creates a BackendService resource in the specified project using the data
-        # included in the request.
+        # included in the request. There are several restrictions and guidelines to keep
+        # in mind when creating a backend service. Read  Restrictions and Guidelines for
+        # more information.
         # @param [String] project
         #   Project ID for this request.
         # @param [Google::Apis::ComputeBeta::BackendService] backend_service_object
@@ -942,7 +944,9 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Update the entire content of the BackendService resource. This method supports
+        # Updates the entire content of the BackendService resource. There are several
+        # restrictions and guidelines to keep in mind when updating a backend service.
+        # Read  Restrictions and Guidelines for more information. This method supports
         # patch semantics.
         # @param [String] project
         #   Project ID for this request.
@@ -984,7 +988,9 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Update the entire content of the BackendService resource.
+        # Updates the entire content of the BackendService resource. There are several
+        # restrictions and guidelines to keep in mind when updating a backend service.
+        # Read  Restrictions and Guidelines for more information.
         # @param [String] project
         #   Project ID for this request.
         # @param [String] backend_service
@@ -1025,7 +1031,7 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Retrieves the list of disk type resources grouped by scope.
+        # Retrieves an aggregated list of disk type resources.
         # @param [String] project
         #   Project ID for this request.
         # @param [String] filter
@@ -1144,7 +1150,7 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Retrieves the list of disk type resources available to the specified project.
+        # Retrieves a list of disk type resources available to the specified project.
         # @param [String] project
         #   Project ID for this request.
         # @param [String] zone
@@ -1225,7 +1231,7 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Retrieves the list of persistent disks grouped by scope.
+        # Retrieves an aggregated list of persistent disks.
         # @param [String] project
         #   Project ID for this request.
         # @param [String] filter
@@ -1476,7 +1482,7 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Retrieves the list of persistent disks contained within the specified zone.
+        # Retrieves a list of persistent disks contained within the specified zone.
         # @param [String] project
         #   Project ID for this request.
         # @param [String] zone
@@ -1877,7 +1883,7 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Retrieves the list of forwarding rules grouped by scope.
+        # Retrieves an aggregated list of forwarding rules.
         # @param [String] project
         #   Project ID for this request.
         # @param [String] filter
@@ -2079,7 +2085,7 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Retrieves the list of ForwardingRule resources available to the specified
+        # Retrieves a list of ForwardingRule resources available to the specified
         # project and region.
         # @param [String] project
         #   Project ID for this request.
@@ -2321,7 +2327,7 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Retrieves the list of global address resources.
+        # Retrieves a list of global address resources.
         # @param [String] project
         #   Project ID for this request.
         # @param [String] filter
@@ -2514,7 +2520,7 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Retrieves the list of ForwardingRule resources available to the specified
+        # Retrieves a list of ForwardingRule resources available to the specified
         # project.
         # @param [String] project
         #   Project ID for this request.
@@ -2635,7 +2641,7 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Retrieves the list of all operations grouped by scope.
+        # Retrieves an aggregated list of all operations.
         # @param [String] project
         #   Project ID for this request.
         # @param [String] filter
@@ -2787,8 +2793,7 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Retrieves the list of Operation resources contained within the specified
-        # project.
+        # Retrieves a list of Operation resources contained within the specified project.
         # @param [String] project
         #   Project ID for this request.
         # @param [String] filter
@@ -3793,7 +3798,8 @@ module Google
         end
         
         # Deletes the specified managed instance group and all of the instances in that
-        # group.
+        # group. Note that the instance group must not belong to a backend service. Read
+        # Deleting an instance group for more information.
         # @param [String] project
         #   Project ID for this request.
         # @param [String] zone
@@ -4337,8 +4343,8 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Adds a list of instances to the specified instance group. All of the instances
-        # in the instance group must be in the same network/subnetwork.
+        # Adds a list of instances to the specified instance group. Read  Adding
+        # instances for more information.
         # @param [String] project
         #   Project ID for this request.
         # @param [String] zone
@@ -4461,7 +4467,8 @@ module Google
         end
         
         # Deletes the specified instance group. The instances in the group are not
-        # deleted.
+        # deleted. Note that instance group must not belong to a backend service. Read
+        # Deleting an instance group for more information.
         # @param [String] project
         #   Project ID for this request.
         # @param [String] zone
@@ -4921,7 +4928,9 @@ module Google
         end
         
         # Creates an instance template in the specified project using the data that is
-        # included in the request.
+        # included in the request. If you are creating a new template to update an
+        # existing instance group, your new instance template must use the same network
+        # or, if applicable, the same subnetwork as the original template.
         # @param [String] project
         #   Project ID for this request.
         # @param [Google::Apis::ComputeBeta::InstanceTemplate] instance_template_object
@@ -5857,8 +5866,8 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # This method starts an instance that was stopped using the using the instances()
-        # .stop method. For more information, see Restart an instance.
+        # Starts an instance that was stopped using the using the instances().stop
+        # method. For more information, see Restart an instance.
         # @param [String] project
         #   Project ID for this request.
         # @param [String] zone
@@ -5899,12 +5908,12 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # This method stops a running instance, shutting it down cleanly, and allows you
-        # to restart the instance at a later time. Stopped instances do not incur per-
-        # minute, virtual machine usage charges while they are stopped, but any
-        # resources that the virtual machine is using, such as persistent disks and
-        # static IP addresses,will continue to be charged until they are deleted. For
-        # more information, see Stopping an instance.
+        # Stops a running instance, shutting it down cleanly, and allows you to restart
+        # the instance at a later time. Stopped instances do not incur per-minute,
+        # virtual machine usage charges while they are stopped, but any resources that
+        # the virtual machine is using, such as persistent disks and static IP addresses,
+        # will continue to be charged until they are deleted. For more information, see
+        # Stopping an instance.
         # @param [String] project
         #   Project ID for this request.
         # @param [String] zone
@@ -5983,7 +5992,7 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Retrieves the list of machine type resources grouped by scope.
+        # Retrieves an aggregated list of machine type resources.
         # @param [String] project
         #   Project ID for this request.
         # @param [String] filter
@@ -6102,8 +6111,7 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Retrieves the list of machine type resources available to the specified
-        # project.
+        # Retrieves a list of machine type resources available to the specified project.
         # @param [String] project
         #   Project ID for this request.
         # @param [String] zone
@@ -6572,7 +6580,7 @@ module Google
         # @param [String] project
         #   Project ID for this request.
         # @param [String] region
-        #   Name of the zone scoping this request.
+        #   Name of the region scoping this request.
         # @param [String] operation
         #   Name of the Operations resource to return.
         # @param [String] fields
@@ -6609,8 +6617,7 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Retrieves the list of Operation resources contained within the specified
-        # region.
+        # Retrieves a list of Operation resources contained within the specified region.
         # @param [String] project
         #   Project ID for this request.
         # @param [String] region
@@ -7353,7 +7360,7 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Retrieves the list of Subnetworks grouped by scope.
+        # Retrieves an aggregated list of subnetworks.
         # @param [String] project
         #   Project ID for this request.
         # @param [String] filter
@@ -7431,7 +7438,7 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Deletes the specified Subnetwork resource.
+        # Deletes the specified subnetwork.
         # @param [String] project
         #   Project ID for this request.
         # @param [String] region
@@ -7472,7 +7479,7 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Returns the specified Subnetwork resource.
+        # Returns the specified subnetwork.
         # @param [String] project
         #   Project ID for this request.
         # @param [String] region
@@ -7513,8 +7520,8 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Creates a Subnetwork resource in the specified project using the data included
-        # in the request.
+        # Creates a subnetwork in the specified project using the data included in the
+        # request.
         # @param [String] project
         #   Project ID for this request.
         # @param [String] region
@@ -7555,7 +7562,7 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Retrieves the list of Subnetwork resources available to the specified project.
+        # Retrieves a list of subnetworks available to the specified project.
         # @param [String] project
         #   Project ID for this request.
         # @param [String] region
@@ -8147,7 +8154,7 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Retrieves the list of target instances grouped by scope.
+        # Retrieves an aggregated list of target instances.
         # @param [String] project
         #   Project ID for this request.
         # @param [String] filter
@@ -8349,7 +8356,7 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Retrieves the list of TargetInstance resources available to the specified
+        # Retrieves a list of TargetInstance resources available to the specified
         # project and zone.
         # @param [String] project
         #   Project ID for this request.
@@ -8517,7 +8524,7 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Retrieves the list of target pools grouped by scope.
+        # Retrieves an aggregated list of target pools.
         # @param [String] project
         #   Project ID for this request.
         # @param [String] filter
@@ -8678,7 +8685,7 @@ module Google
         end
         
         # Gets the most recent health check results for each IP for the given instance
-        # that is referenced by given TargetPool.
+        # that is referenced by the given TargetPool.
         # @param [String] project
         # @param [String] region
         #   Name of the region scoping this request.
@@ -8763,7 +8770,7 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Retrieves the list of TargetPool resources available to the specified project
+        # Retrieves a list of TargetPool resources available to the specified project
         # and region.
         # @param [String] project
         #   Project ID for this request.
@@ -8978,7 +8985,7 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Retrieves the list of target VPN gateways grouped by scope.
+        # Retrieves an aggregated list of target VPN gateways .
         # @param [String] project
         #   Project ID for this request.
         # @param [String] filter
@@ -9180,7 +9187,7 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Retrieves the list of TargetVpnGateway resources available to the specified
+        # Retrieves a list of TargetVpnGateway resources available to the specified
         # project and region.
         # @param [String] project
         #   Project ID for this request.
@@ -9455,7 +9462,7 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Update the entire content of the UrlMap resource. This method supports patch
+        # Updates the entire content of the UrlMap resource. This method supports patch
         # semantics.
         # @param [String] project
         #   Project ID for this request.
@@ -9497,7 +9504,7 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Update the entire content of the UrlMap resource.
+        # Updates the entire content of the UrlMap resource.
         # @param [String] project
         #   Project ID for this request.
         # @param [String] url_map
@@ -9538,8 +9545,8 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Run static validation for the UrlMap. In particular, the tests of the provided
-        # UrlMap will be run. Calling this method does NOT create the UrlMap.
+        # Runs static validation for the UrlMap. In particular, the tests of the
+        # provided UrlMap will be run. Calling this method does NOT create the UrlMap.
         # @param [String] project
         #   Project ID for this request.
         # @param [String] url_map
@@ -9580,7 +9587,7 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Retrieves the list of VPN tunnels grouped by scope.
+        # Retrieves an aggregated list of VPN tunnels.
         # @param [String] project
         #   Project ID for this request.
         # @param [String] filter
@@ -9782,8 +9789,8 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Retrieves the list of VpnTunnel resources contained in the specified project
-        # and region.
+        # Retrieves a list of VpnTunnel resources contained in the specified project and
+        # region.
         # @param [String] project
         #   Project ID for this request.
         # @param [String] region
@@ -9944,7 +9951,7 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Retrieves the list of Operation resources contained within the specified zone.
+        # Retrieves a list of Operation resources contained within the specified zone.
         # @param [String] project
         #   Project ID for this request.
         # @param [String] zone

data/generated/google/apis/compute_v1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://developers.google.com/compute/docs/reference/latest/
     module ComputeV1
       VERSION = 'V1'
-      REVISION = '20160107'
+      REVISION = '20160112'
 
       # 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_v1/classes.rb

@@ -937,15 +937,17 @@ module Google
         # @return [String]
         attr_accessor :group
       
-        # The max RPS of the group. Can be used with either balancing mode, but required
-        # if RATE mode. For RATE mode, either maxRate or maxRatePerInstance must be set.
+        # The max requests per second (RPS) of the group. Can be used with either
+        # balancing mode, but required if RATE mode. For RATE mode, either maxRate or
+        # maxRatePerInstance must be set.
         # Corresponds to the JSON property `maxRate`
         # @return [Fixnum]
         attr_accessor :max_rate
       
-        # The max RPS that a single backed 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.
+        # The max requests per second (RPS) that a single backed 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.
         # Corresponds to the JSON property `maxRatePerInstance`
         # @return [Float]
         attr_accessor :max_rate_per_instance
@@ -973,7 +975,7 @@ module Google
       end
       
       # A BackendService resource. This resource defines a group of backend virtual
-      # machines together with their serving capacity.
+      # machines and their serving capacity.
       class BackendService
         include Google::Apis::Core::Hashable
       
@@ -1030,7 +1032,7 @@ module Google
         # @return [String]
         attr_accessor :name
       
-        # Deprecated in favor of port name. The TCP port to connect on the backend. The
+        # Deprecated in favor of portName. The TCP port to connect on the backend. The
         # default value is 80.
         # Corresponds to the JSON property `port`
         # @return [Fixnum]
@@ -1900,9 +1902,8 @@ module Google
         # @return [String]
         attr_accessor :name
       
-        # URL of the network resource for this firewall rule. This field is required for
-        # creating an instance but optional when creating a firewall rule. If not
-        # specified when creating a firewall rule, the default network is used:
+        # 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:
@@ -2120,7 +2121,9 @@ module Google
         # The URL of the target resource to receive the matched traffic. For regional
         # forwarding rules, this target must live in the same region as the forwarding
         # rule. For global forwarding rules, this target must be a global
-        # TargetHttpProxy or TargetHttpsProxy resource.
+        # TargetHttpProxy or TargetHttpsProxy resource. The forwarded traffic must be of
+        # a type appropriate to the target object. For example, TargetHttpProxy requires
+        # HTTP traffic, and TargetHttpsProxy requires HTTPS traffic.
         # Corresponds to the JSON property `target`
         # @return [String]
         attr_accessor :target
@@ -2955,8 +2958,8 @@ module Google
         # @return [String]
         attr_accessor :creation_timestamp
       
-        # An optional textual description of the resource; provided by the client when
-        # the resource is created.
+        # An optional description of this resource. Provide this property when you
+        # create the resource.
         # Corresponds to the JSON property `description`
         # @return [String]
         attr_accessor :description
@@ -2967,8 +2970,8 @@ module Google
         # @return [Array<Google::Apis::ComputeV1::AttachedDisk>]
         attr_accessor :disks
       
-        # [Output Only] Unique identifier for the resource. This identifier is defined
-        # by the server.
+        # [Output Only] The unique identifier for the resource. This identifier is
+        # defined by the server.
         # Corresponds to the JSON property `id`
         # @return [String]
         attr_accessor :id
@@ -3000,12 +3003,12 @@ module Google
         # @return [Google::Apis::ComputeV1::Metadata]
         attr_accessor :metadata
       
-        # 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.
+        # The name of the resource, provided by the client when initially creating the
+        # resource. The resource name must be 1-63 characters long, and comply with
+        # RFC1035. Specifically, the name must be 1-63 characters long and match the
+        # regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character
+        # must be a lowercase letter, and all following characters must be a dash,
+        # lowercase letter, or digit, except the last character, which cannot be a dash.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -3022,7 +3025,7 @@ module Google
         # @return [Google::Apis::ComputeV1::Scheduling]
         attr_accessor :scheduling
       
-        # [Output Only] Server defined URL for this resource.
+        # [Output Only] Server-defined URL for this resource.
         # Corresponds to the JSON property `selfLink`
         # @return [String]
         attr_accessor :self_link
@@ -3104,12 +3107,16 @@ module Google
         # @return [String]
         attr_accessor :kind
       
-        # [Output Only] A token used to continue a truncated list request.
+        # [Output Only] This token allows you to get the next page of results for list
+        # requests. If the number of results is larger than maxResults, use the
+        # nextPageToken as a value for the query parameter pageToken in the next list
+        # request. Subsequent list requests will have their own nextPageToken to
+        # continue paging through the results.
         # Corresponds to the JSON property `nextPageToken`
         # @return [String]
         attr_accessor :next_page_token
       
-        # [Output Only] Server defined URL for this resource.
+        # [Output Only] Server-defined URL for this resource.
         # Corresponds to the JSON property `selfLink`
         # @return [String]
         attr_accessor :self_link
@@ -3452,7 +3459,9 @@ module Google
         attr_accessor :abandoning
       
         # [Output Only] The number of instances in the managed instance group that are
-        # scheduled to be created or are currently being created.
+        # scheduled to be created or are currently being created. If the group fails to
+        # create one of these instances, it tries again until it creates the instance
+        # successfully.
         # Corresponds to the JSON property `creating`
         # @return [Fixnum]
         attr_accessor :creating
@@ -4079,12 +4088,16 @@ module Google
         # @return [String]
         attr_accessor :kind
       
-        # [Output Only] A token used to continue a truncated list request.
+        # [Output Only] This token allows you to get the next page of results for list
+        # requests. If the number of results is larger than maxResults, use the
+        # nextPageToken as a value for the query parameter pageToken in the next list
+        # request. Subsequent list requests will have their own nextPageToken to
+        # continue paging through the results.
         # Corresponds to the JSON property `nextPageToken`
         # @return [String]
         attr_accessor :next_page_token
       
-        # [Output Only] Server defined URL for this resource.
+        # [Output Only] Server-defined URL for this resource.
         # Corresponds to the JSON property `selfLink`
         # @return [String]
         attr_accessor :self_link
@@ -4827,7 +4840,11 @@ module Google
         # for the instance. Possible values:
         # - NONE The instance is running, and the managed instance group does not have
         # any scheduled actions for this instance.
-        # - CREATING The managed instance group is creating this instance.
+        # - CREATING The managed instance group is creating this instance. If the group
+        # fails to create this instance, it will try again until it is successful.
+        # - CREATING_WITHOUT_RETRIES The managed instance group is attempting to create
+        # this instance only once. If the group fails to create this instance, it does
+        # not try again and the group's target_size value is decreased.
         # - RECREATING The managed instance group is recreating this instance.
         # - DELETING The managed instance group is permanently deleting this instance.
         # - ABANDONING The managed instance group is abandoning this instance. The
@@ -5254,7 +5271,8 @@ module Google
         attr_accessor :http_error_message
       
         # [Output Only] If the operation fails, this field contains the HTTP error
-        # message that was returned. For example, a 404 means the resource was not found.
+        # status code that was returned. For example, a 404 means the resource was not
+        # found.
         # Corresponds to the JSON property `httpErrorStatusCode`
         # @return [Fixnum]
         attr_accessor :http_error_status_code
@@ -5289,14 +5307,14 @@ module Google
       
         # [Output Only] An optional progress indicator that ranges from 0 to 100. There
         # is no requirement that this be linear or support any granularity of operations.
-        # This should not be used to guess at when the operation will be complete. This
+        # This should not be used to guess when the operation will be complete. This
         # number should monotonically increase as the operation progresses.
         # Corresponds to the JSON property `progress`
         # @return [Fixnum]
         attr_accessor :progress
       
-        # [Output Only] URL of the region where the operation resides. Only applicable
-        # for regional resources.
+        # [Output Only] URL of the region where the operation resides. Only available
+        # when performing regional operations.
         # Corresponds to the JSON property `region`
         # @return [String]
         attr_accessor :region
@@ -5346,7 +5364,8 @@ module Google
         # @return [Array<Google::Apis::ComputeV1::Operation::Warning>]
         attr_accessor :warnings
       
-        # [Output Only] URL of the zone where the operation resides.
+        # [Output Only] URL of the zone where the operation resides. Only available when
+        # performing per-zone operations.
         # Corresponds to the JSON property `zone`
         # @return [String]
         attr_accessor :zone
@@ -5694,8 +5713,14 @@ module Google
       class PathMatcher
         include Google::Apis::Core::Hashable
       
-        # The URL to the BackendService resource. This will be used if none of the
-        # pathRules defined by this PathMatcher is met by the URL's path portion.
+        # The full or partial URL to the BackendService resource. This will be used if
+        # none of the pathRules defined by this PathMatcher is matched by the URL's path
+        # portion. For example, the following are all valid URLs to a BackendService
+        # resource:
+        # - https://www.googleapis.com/compute/v1/projects/project/global/
+        # backendServices/backendService
+        # - compute/v1/projects/project/global/backendServices/backendService
+        # - global/backendServices/backendService
         # Corresponds to the JSON property `defaultService`
         # @return [String]
         attr_accessor :default_service
@@ -6011,7 +6036,7 @@ module Google
       
       # The route resource. A Route is a rule that specifies how certain packets
       # should be handled by the virtual network. Routes are associated with instances
-      # by tag and the set of Routes for a particular instance is called its routing
+      # by tags and the set of Routes for a particular instance is called its routing
       # table. For each packet leaving a 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
@@ -6067,15 +6092,15 @@ module Google
         # @return [String]
         attr_accessor :network
       
-        # The URL to a gateway that should handle matching packets. Currently, this is
-        # only the internet gateway:  projects/<project-id>/global/gateways/default-
-        # internet-gateway
+        # 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>/
+        # global/gateways/default-internet-gateway
         # Corresponds to the JSON property `nextHopGateway`
         # @return [String]
         attr_accessor :next_hop_gateway
       
-        # The fully-qualified URL to an instance that should handle matching packets.
-        # For example:
+        # The URL to an instance that should handle matching packets. You can specify
+        # this as a full or partial URL. For example:
         # https://www.googleapis.com/compute/v1/projects/project/zones/zone/instances/
         # Corresponds to the JSON property `nextHopInstance`
         # @return [String]
@@ -6096,9 +6121,10 @@ module Google
         # @return [String]
         attr_accessor :next_hop_vpn_tunnel
       
-        # Breaks ties between Routes of equal specificity. Routes with smaller values
-        # win when tied with routes with larger values. Default value is 1000. A valid
-        # range is between 0 and 65535.
+        # 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.
         # Corresponds to the JSON property `priority`
         # @return [Fixnum]
         attr_accessor :priority
@@ -6217,7 +6243,7 @@ module Google
         # @return [String]
         attr_accessor :id
       
-        # A list of Route resources.
+        # [Output Only] A list of Route resources.
         # Corresponds to the JSON property `items`
         # @return [Array<Google::Apis::ComputeV1::Route>]
         attr_accessor :items
@@ -6309,7 +6335,7 @@ module Google
         # @return [String]
         attr_accessor :kind
       
-        # [Output Only] Server defined URL for the resource.
+        # [Output Only] Server-defined URL for the resource.
         # Corresponds to the JSON property `selfLink`
         # @return [String]
         attr_accessor :self_link
@@ -6403,7 +6429,7 @@ module Google
         # @return [String]
         attr_accessor :self_link
       
-        # The source disk used to create this snapshot.
+        # [Output Only] The source disk used to create this snapshot.
         # Corresponds to the JSON property `sourceDisk`
         # @return [String]
         attr_accessor :source_disk
@@ -6465,7 +6491,7 @@ module Google
         # @return [String]
         attr_accessor :id
       
-        # A list of Snapshot resources.
+        # [Output Only] A list of Snapshot resources.
         # Corresponds to the JSON property `items`
         # @return [Array<Google::Apis::ComputeV1::Snapshot>]
         attr_accessor :items
@@ -6504,8 +6530,8 @@ module Google
       end
       
       # An SslCertificate resource. This resource provides a mechanism to upload an
-      # SSL key and certificate to global HTTPS loadbalancer to serve secure
-      # connections.
+      # SSL key and certificate to the load balancer to serve secure connections from
+      # the user.
       class SslCertificate
         include Google::Apis::Core::Hashable
       
@@ -6830,8 +6856,9 @@ module Google
         # @return [String]
         attr_accessor :self_link
       
-        # URLs to SslCertificate resources that are used to authenticate connections to
-        # Backends. Currently exactly one SSL certificate must be specified.
+        # URLs to SslCertificate resources that are used to authenticate connections
+        # between users and the load balancer. Currently exactly one SSL certificate
+        # must be specified.
         # Corresponds to the JSON property `sslCertificates`
         # @return [Array<String>]
         attr_accessor :ssl_certificates
@@ -8197,8 +8224,9 @@ module Google
       
         # The name of an existing bucket in Cloud Storage where the usage report object
         # is stored. The Google Service Account is granted write access to this bucket.
-        # This is just the bucket name, with no gs:// or https://storage.googleapis.com/
-        # in front of it.
+        # This can either be the bucket name by itself, such as example-bucket, or the
+        # bucket name with gs:// or https://storage.googleapis.com/ in front of it, such
+        # as gs://example-bucket.
         # Corresponds to the JSON property `bucketName`
         # @return [String]
         attr_accessor :bucket_name
@@ -8285,7 +8313,7 @@ module Google
         # @return [String]
         attr_accessor :self_link
       
-        # Shared secret used to set the secure session between the GCE VPN gateway and
+        # Shared secret used to set the secure session between the Cloud VPN gateway and
         # the peer VPN gateway.
         # Corresponds to the JSON property `sharedSecret`
         # @return [String]