Api-roll 22: 2015-08-17

discovery/googleapis/compute__v1.json

 {
     "auth": {
         "oauth2": {
             "scopes": {
                 "https://www.googleapis.com/auth/cloud-platform": {
                     "description": "View and manage your data across Google Cloud Platform services"
                 },
                 "https://www.googleapis.com/auth/compute": {
                     "description": "View and manage your Google Compute Engine resources"
                 },
@@ skipping 11 matching lines @@
                 }
             }
         }
     },
     "basePath": "/compute/v1/projects/",
     "baseUrl": "https://www.googleapis.com/compute/v1/projects/",
     "batchPath": "batch",
     "description": "API for the Google Compute Engine service.",
     "discoveryVersion": "v1",
     "documentationLink": "https://developers.google.com/compute/docs/reference/latest/",
-    "etag": "\"ye6orv2F-1npMW3u9suM3a7C5Bo/9hN2u4BIyPfYCs0vlKKKfL8-TdM\"",
+    "etag": "\"ye6orv2F-1npMW3u9suM3a7C5Bo/qMCHMKeJQxbErur94_YIqV8WAbQ\"",
     "icons": {
         "x16": "https://www.google.com/images/icons/product/compute_engine-16.png",
         "x32": "https://www.google.com/images/icons/product/compute_engine-32.png"
     },
     "id": "compute:v1",
     "kind": "discovery#restDescription",
     "name": "compute",
     "ownerDomain": "google.com",
     "ownerName": "Google",
     "parameters": {
@@ skipping 7186 matching lines @@
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform",
                         "https://www.googleapis.com/auth/compute",
                         "https://www.googleapis.com/auth/compute.readonly"
                     ]
                 }
             }
         }
     },
-    "revision": "20150723",
+    "revision": "20150807",
     "rootUrl": "https://www.googleapis.com/",
     "schemas": {
         "AccessConfig": {
             "description": "An access configuration attached to an instance's network interface.",
             "id": "AccessConfig",
             "properties": {
                 "kind": {
                     "default": "compute#accessConfig",
                     "description": "[Output Only] Type of the resource. Always compute#accessConfig for access configs.",
                     "type": "string"
@@ skipping 54 matching lines @@
                     },
                     "description": "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.",
                     "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                     "type": "string"
                 },
                 "region": {
                     "description": "[Output Only] URL of the region where the regional address resides. This field is not applicable to global addresses.",
                     "type": "string"
                 },
                 "selfLink": {
-                    "description": "[Output Only] Server defined URL for the resource.",
+                    "description": "[Output Only] Server-defined URL for the resource.",
                     "type": "string"
                 },
                 "status": {
                     "description": "[Output Only] The status of the address, which can be either IN_USE or RESERVED. An address that is RESERVED is currently reserved and available to use. An IN_USE address is currently being used by another resource and is not available.",
                     "enum": [
                         "IN_USE",
                         "RESERVED"
                     ],
                     "enumDescriptions": [
                         "",
@@ skipping 29 matching lines @@
                 "kind": {
                     "default": "compute#addressAggregatedList",
                     "description": "[Output Only] Type of resource. Always compute#addressAggregatedList for aggregated lists of addresses.",
                     "type": "string"
                 },
                 "nextPageToken": {
                     "description": "[Output Only] A token used to continue a truncated list request.",
                     "type": "string"
                 },
                 "selfLink": {
-                    "description": "[Output Only] Server defined URL for this resource.",
+                    "description": "[Output Only] Server-defined URL for this resource.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "AddressList": {
             "description": "Contains a list of address resources.",
             "id": "AddressList",
             "properties": {
                 "id": {
@@ skipping 10 matching lines @@
                 "kind": {
                     "default": "compute#addressList",
                     "description": "[Output Only] Type of resource. Always compute#addressList for lists of addresses.",
                     "type": "string"
                 },
                 "nextPageToken": {
                     "description": "[Output Only] A token used to continue a truncated list request.",
                     "type": "string"
                 },
                 "selfLink": {
-                    "description": "[Output Only] Server defined URL for the resource.",
+                    "description": "[Output Only] Server-defined URL for the resource.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "AddressesScopedList": {
             "id": "AddressesScopedList",
             "properties": {
                 "addresses": {
                     "description": "[Output Only] List of addresses contained in this scope.",
@@ skipping 74 matching lines @@
             "properties": {
                 "autoDelete": {
                     "description": "Specifies whether the disk will be auto-deleted when the instance is deleted (but not when the disk is detached from the instance).",
                     "type": "boolean"
                 },
                 "boot": {
                     "description": "Indicates that this is a boot disk. The virtual machine will use the first partition of the disk for its root filesystem.",
                     "type": "boolean"
                 },
                 "deviceName": {
-                    "description": "Specifies a unique device name of your choice that is reflected into the /dev/ tree of a Linux operating system running within the instance. This name can be used to reference the device for mounting, resizing, and so on, from within the instance.\n\nIf not specified, the server chooses a default device name to apply to this disk, in the form persistent-disks-x, where x is a number assigned by Google Compute Engine. This field is only applicable for persistent disks.",
+                    "description": "Specifies a unique device name of your choice that is reflected into the /dev/disk/by-id/google-* tree of a Linux operating system running within the instance. This name can be used to reference the device for mounting, resizing, and so on, from within the instance.\n\nIf not specified, the server chooses a default device name to apply to this disk, in the form persistent-disks-x, where x is a number assigned by Google Compute Engine. This field is only applicable for persistent disks.",
                     "type": "string"
                 },
                 "index": {
                     "description": "Assigns a zero-based index to this disk, where 0 is reserved for the boot disk. For example, if you have many disks attached to an instance, each disk would have a unique index number. If not specified, the server will choose an appropriate value.",
                     "format": "int32",
                     "type": "integer"
                 },
                 "initializeParams": {
                     "$ref": "AttachedDiskInitializeParams",
                     "description": "[Input Only] Specifies the parameters for a new disk that will be created alongside the new instance. Use initialization parameters to create boot disks or local SSDs attached to the new instance.\n\nThis property is mutually exclusive with the source property; you can only define one or the other, but not both."
@@ skipping 82 matching lines @@
             "type": "object"
         },
         "Autoscaler": {
             "id": "Autoscaler",
             "properties": {
                 "autoscalingPolicy": {
                     "$ref": "AutoscalingPolicy",
                     "description": "Autoscaling configuration."
                 },
                 "creationTimestamp": {
-                    "description": "Creation timestamp in RFC3339 text format (output only).",
+                    "description": "[Output Only] Creation timestamp in RFC3339 text format.",
                     "type": "string"
                 },
                 "description": {
                     "description": "An optional textual description of the resource; provided by the client when the resource is created.",
                     "type": "string"
                 },
                 "id": {
-                    "description": "Unique identifier for the resource; defined by the server (output only).",
+                    "description": "[Output Only] Unique identifier for the resource; defined by the server.",
                     "format": "uint64",
                     "type": "string"
                 },
                 "kind": {
                     "default": "compute#autoscaler",
                     "description": "Type of the resource.",
                     "type": "string"
                 },
                 "name": {
                     "annotations": {
                         "required": [
                             "compute.instanceGroups.insert"
                         ]
                     },
-                    "description": "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.",
+                    "description": "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.",
                     "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                     "type": "string"
                 },
                 "selfLink": {
-                    "description": "Server defined URL for the resource (output only).",
+                    "description": "[Output Only] Server-defined URL for the resource.",
                     "type": "string"
                 },
                 "target": {
                     "description": "URL of Instance Group Manager or Replica Pool which will be controlled by Autoscaler.",
                     "type": "string"
                 },
                 "zone": {
-                    "description": "URL of the zone where the instance group resides (output only).",
+                    "description": "[Output Only] URL of the zone where the instance group resides.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "AutoscalerAggregatedList": {
             "id": "AutoscalerAggregatedList",
             "properties": {
                 "id": {
-                    "description": "Unique identifier for the resource; defined by the server (output only).",
+                    "description": "[Output Only] Unique identifier for the resource; defined by the server.",
                     "type": "string"
                 },
                 "items": {
                     "additionalProperties": {
                         "$ref": "AutoscalersScopedList",
                         "description": "Name of the scope containing this set of autoscalers."
                     },
                     "description": "A map of scoped autoscaler lists.",
                     "type": "object"
                 },
                 "kind": {
                     "default": "compute#autoscalerAggregatedList",
                     "description": "Type of resource.",
                     "type": "string"
                 },
                 "nextPageToken": {
-                    "description": "A token used to continue a truncated list request (output only).",
+                    "description": "[Output Only] A token used to continue a truncated list request.",
                     "type": "string"
                 },
                 "selfLink": {
-                    "description": "Server defined URL for this resource (output only).",
+                    "description": "[Output Only] Server-defined URL for this resource.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "AutoscalerList": {
             "description": "Contains a list of persistent autoscaler resources.",
             "id": "AutoscalerList",
             "properties": {
                 "id": {
-                    "description": "Unique identifier for the resource; defined by the server (output only).",
+                    "description": "[Output Only] Unique identifier for the resource; defined by the server.",
                     "type": "string"
                 },
                 "items": {
                     "description": "A list of Autoscaler resources.",
                     "items": {
                         "$ref": "Autoscaler"
                     },
                     "type": "array"
                 },
                 "kind": {
                     "default": "compute#autoscalerList",
                     "description": "Type of resource.",
                     "type": "string"
                 },
                 "nextPageToken": {
-                    "description": "A token used to continue a truncated list request (output only).",
+                    "description": "[Output Only] A token used to continue a truncated list request.",
                     "type": "string"
                 },
                 "selfLink": {
-                    "description": "Server defined URL for this resource (output only).",
+                    "description": "[Output Only] Server-defined URL for this resource.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "AutoscalersScopedList": {
             "id": "AutoscalersScopedList",
             "properties": {
                 "autoscalers": {
                     "description": "List of autoscalers contained in this scope.",
@@ skipping 200 matching lines @@
                 },
                 "maxUtilization": {
                     "description": "Used when balancingMode is UTILIZATION. This ratio defines the CPU utilization target for the group. The default is 0.8. Valid range is [0.0, 1.0].",
                     "format": "float",
                     "type": "number"
                 }
             },
             "type": "object"
         },
         "BackendService": {
-            "description": "A BackendService resource. This resource defines a group of backend VMs together with their serving capacity.",
+            "description": "A BackendService resource. This resource defines a group of backend virtual machines together with their serving capacity.",
             "id": "BackendService",
             "properties": {
                 "backends": {
                     "description": "The list of backends that serve this BackendService.",
                     "items": {
                         "$ref": "Backend"
                     },
                     "type": "array"
                 },
                 "creationTimestamp": {
@@ skipping 43 matching lines @@
                 "protocol": {
                     "enum": [
                         "HTTP"
                     ],
                     "enumDescriptions": [
                         ""
                     ],
                     "type": "string"
                 },
                 "selfLink": {
-                    "description": "[Output Only] Server defined URL for the resource.",
+                    "description": "[Output Only] Server-defined URL for the resource.",
                     "type": "string"
                 },
                 "timeoutSec": {
                     "description": "How many seconds to wait for the backend before considering it a failed request. Default is 30 seconds.",
                     "format": "int32",
                     "type": "integer"
                 }
             },
             "type": "object"
         },
@@ skipping 210 matching lines @@
                 "kind": {
                     "default": "compute#diskAggregatedList",
                     "description": "[Output Only] Type of resource. Always compute#diskAggregatedList for aggregated lists of persistent disks.",
                     "type": "string"
                 },
                 "nextPageToken": {
                     "description": "[Output Only] A token used to continue a truncated list request.",
                     "type": "string"
                 },
                 "selfLink": {
-                    "description": "[Output Only] Server defined URL for this resource.",
+                    "description": "[Output Only] Server-defined URL for this resource.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "DiskList": {
             "description": "A list of Disk resources.",
             "id": "DiskList",
             "properties": {
                 "id": {
@@ skipping 10 matching lines @@
                 "kind": {
                     "default": "compute#diskList",
                     "description": "[Output Only] Type of resource. Always compute#diskList for lists of disks.",
                     "type": "string"
                 },
                 "nextPageToken": {
                     "description": "[Output Only] A token used to continue a truncated list request.",
                     "type": "string"
                 },
                 "selfLink": {
-                    "description": "[Output Only] Server defined URL for this resource.",
+                    "description": "[Output Only] Server-defined URL for this resource.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "DiskMoveRequest": {
             "id": "DiskMoveRequest",
             "properties": {
                 "destinationZone": {
                     "description": "The URL of the destination zone to move the disk to. This can be a full or partial URL. For example, the following are all valid URLs to a zone:  \n- https://www.googleapis.com/compute/v1/projects/project/zones/zone \n- projects/project/zones/zone \n- zones/zone",
                     "type": "string"
                 },
                 "targetDisk": {
                     "description": "The URL of the target disk to move. This can be a full or partial URL. For example, the following are all valid URLs to a disk:  \n- https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk \n- projects/project/zones/zone/disks/disk \n- zones/zone/disks/disk",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "DiskType": {
             "description": "A disk type resource.",
             "id": "DiskType",
             "properties": {
                 "creationTimestamp": {
                     "description": "[Output Only] Creation timestamp in RFC3339 text format.",
                     "type": "string"
                 },
                 "defaultDiskSizeGb": {
-                    "description": "[Output Only] Server defined default disk size in GB.",
+                    "description": "[Output Only] Server-defined default disk size in GB.",
                     "format": "int64",
                     "type": "string"
                 },
                 "deprecated": {
                     "$ref": "DeprecationStatus",
                     "description": "[Output Only] The deprecation status associated with this disk type."
                 },
                 "description": {
                     "description": "[Output Only] An optional textual description of the resource.",
                     "type": "string"
                 },
                 "id": {
                     "description": "[Output Only] Unique identifier for the resource; defined by the server.",
                     "format": "uint64",
                     "type": "string"
                 },
                 "kind": {
                     "default": "compute#diskType",
                     "description": "[Output Only] Type of the resource. Always compute#diskType for disk types.",
                     "type": "string"
                 },
                 "name": {
                     "description": "[Output Only] Name of the resource.",
                     "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                     "type": "string"
                 },
                 "selfLink": {
-                    "description": "[Output Only] Server defined URL for the resource.",
+                    "description": "[Output Only] Server-defined URL for the resource.",
                     "type": "string"
                 },
                 "validDiskSize": {
                     "description": "[Output Only] An optional textual description of the valid disk size, such as \"10GB-10TB\".",
                     "type": "string"
                 },
                 "zone": {
                     "description": "[Output Only] URL of the zone where the disk type resides.",
                     "type": "string"
                 }
@@ skipping 18 matching lines @@
                 "kind": {
                     "default": "compute#diskTypeAggregatedList",
                     "description": "[Output Only] Type of resource. Always compute#diskTypeAggregatedList.",
                     "type": "string"
                 },
                 "nextPageToken": {
                     "description": "[Output Only] A token used to continue a truncated list request.",
                     "type": "string"
                 },
                 "selfLink": {
-                    "description": "[Output Only] Server defined URL for this resource.",
+                    "description": "[Output Only] Server-defined URL for this resource.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "DiskTypeList": {
             "description": "Contains a list of disk type resources.",
             "id": "DiskTypeList",
             "properties": {
                 "id": {
@@ skipping 10 matching lines @@
                 "kind": {
                     "default": "compute#diskTypeList",
                     "description": "[Output Only] Type of resource. Always compute#diskTypeList for disk types.",
                     "type": "string"
                 },
                 "nextPageToken": {
                     "description": "[Output Only] A token used to continue a truncated list request.",
                     "type": "string"
                 },
                 "selfLink": {
-                    "description": "[Output Only] Server defined URL for this resource.",
+                    "description": "[Output Only] Server-defined URL for this resource.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "DiskTypesScopedList": {
             "id": "DiskTypesScopedList",
             "properties": {
                 "diskTypes": {
                     "description": "[Output Only] List of disk types contained in this scope.",
@@ skipping 195 matching lines @@
                     },
                     "description": "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.",
                     "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                     "type": "string"
                 },
                 "network": {
                     "description": "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:\nglobal/networks/default\nIf 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:  \n- https://www.googleapis.com/compute/v1/projects/myproject/global/networks/my-network \n- projects/myproject/global/networks/my-network \n- global/networks/default",
                     "type": "string"
                 },
                 "selfLink": {
-                    "description": "[Output Only] Server defined URL for the resource.",
+                    "description": "[Output Only] Server-defined URL for the resource.",
                     "type": "string"
                 },
                 "sourceRanges": {
                     "description": "The IP address blocks that this rule applies to, expressed in CIDR format. One or both of sourceRanges and sourceTags may be set.\n\nIf both properties are set, an inbound connection is allowed if the range matches the sourceRanges OR the tag of the source matches the sourceTags property. The connection does not need to match both properties.",
                     "items": {
                         "type": "string"
                     },
                     "type": "array"
                 },
                 "sourceTags": {
@@ skipping 31 matching lines @@
                 "kind": {
                     "default": "compute#firewallList",
                     "description": "[Output Only] Type of resource. Always compute#firewallList for lists of firewalls.",
                     "type": "string"
                 },
                 "nextPageToken": {
                     "description": "[Output Only] A token used to continue a truncated list request.",
                     "type": "string"
                 },
                 "selfLink": {
-                    "description": "[Output Only] Server defined URL for this resource.",
+                    "description": "[Output Only] Server-defined URL for this resource.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "ForwardingRule": {
-            "description": "A ForwardingRule resource. A ForwardingRule resource specifies which pool of target VMs to forward a packet to if it matches the given [IPAddress, IPProtocol, portRange] tuple.",
+            "description": "A ForwardingRule resource. A ForwardingRule resource specifies which pool of target virtual machines to forward a packet to if it matches the given [IPAddress, IPProtocol, portRange] tuple.",
             "id": "ForwardingRule",
             "properties": {
                 "IPAddress": {
                     "description": "Value of the reserved IP address that this forwarding rule is serving on behalf of. For global forwarding rules, the address must be a global IP; for regional forwarding rules, the address must live in the same region as the forwarding rule. If left empty (default value), an ephemeral IP from the same scope (global or regional) will be assigned.",
                     "type": "string"
                 },
                 "IPProtocol": {
-                    "description": "The IP protocol to which this rule applies, valid options are TCP, UDP, ESP, AH or SCTP.",
+                    "description": "The IP protocol to which this rule applies. Valid options are TCP, UDP, ESP, AH or SCTP.",
                     "enum": [
                         "AH",
                         "ESP",
                         "SCTP",
                         "TCP",
                         "UDP"
                     ],
                     "enumDescriptions": [
                         "",
                         "",
@@ skipping 63 matching lines @@
                 "kind": {
                     "default": "compute#forwardingRuleAggregatedList",
                     "description": "Type of resource.",
                     "type": "string"
                 },
                 "nextPageToken": {
                     "description": "[Output Only] A token used to continue a truncated list request.",
                     "type": "string"
                 },
                 "selfLink": {
-                    "description": "[Output Only] Server defined URL for this resource.",
+                    "description": "[Output Only] Server-defined URL for this resource.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "ForwardingRuleList": {
             "description": "Contains a list of ForwardingRule resources.",
             "id": "ForwardingRuleList",
             "properties": {
                 "id": {
@@ skipping 10 matching lines @@
                 "kind": {
                     "default": "compute#forwardingRuleList",
                     "description": "Type of resource.",
                     "type": "string"
                 },
                 "nextPageToken": {
                     "description": "[Output Only] A token used to continue a truncated list request.",
                     "type": "string"
                 },
                 "selfLink": {
-                    "description": "[Output Only] Server defined URL for this resource.",
+                    "description": "[Output Only] Server-defined URL for this resource.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "ForwardingRulesScopedList": {
             "id": "ForwardingRulesScopedList",
             "properties": {
                 "forwardingRules": {
                     "description": "List of forwarding rules contained in this scope.",
@@ skipping 124 matching lines @@
                     "type": "array"
                 },
                 "pathMatcher": {
                     "description": "The name of the PathMatcher to match the path portion of the URL, if the this hostRule matches the URL's host portion.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "HttpHealthCheck": {
-            "description": "An HttpHealthCheck resource. This resource defines a template for how individual VMs should be checked for health, via HTTP.",
+            "description": "An HttpHealthCheck resource. This resource defines a template for how individual instances should be checked for health, via HTTP.",
             "id": "HttpHealthCheck",
             "properties": {
                 "checkIntervalSec": {
                     "description": "How often (in seconds) to send a health check. The default value is 5 seconds.",
                     "format": "int32",
                     "type": "integer"
                 },
                 "creationTimestamp": {
-                    "description": "Creation timestamp in RFC3339 text format (output only).",
+                    "description": "[Output Only] Creation timestamp in RFC3339 text format.",
                     "type": "string"
                 },
                 "description": {
                     "description": "An optional textual description of the resource; provided by the client when the resource is created.",
                     "type": "string"
                 },
                 "healthyThreshold": {
-                    "description": "A so-far unhealthy VM will be marked healthy after this many consecutive successes. The default value is 2.",
+                    "description": "A so-far unhealthy instance will be marked healthy after this many consecutive successes. The default value is 2.",
                     "format": "int32",
                     "type": "integer"
                 },
                 "host": {
                     "description": "The value of the host header in the HTTP health check request. If left empty (default value), the public IP on behalf of which this health check is performed will be used.",
                     "type": "string"
                 },
                 "id": {
-                    "description": "Unique identifier for the resource; defined by the server (output only).",
+                    "description": "[Output Only] Unique identifier for the resource. Defined by the server.",
                     "format": "uint64",
                     "type": "string"
                 },
                 "kind": {
                     "default": "compute#httpHealthCheck",
                     "description": "Type of the resource.",
                     "type": "string"
                 },
                 "name": {
-                    "description": "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.",
+                    "description": "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.",
                     "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                     "type": "string"
                 },
                 "port": {
                     "description": "The TCP port number for the HTTP health check request. The default value is 80.",
                     "format": "int32",
                     "type": "integer"
                 },
                 "requestPath": {
                     "description": "The request path of the HTTP health check request. The default value is \"/\".",
                     "type": "string"
                 },
                 "selfLink": {
-                    "description": "Server defined URL for the resource (output only).",
+                    "description": "[Output Only] Server-defined URL for the resource.",
                     "type": "string"
                 },
                 "timeoutSec": {
                     "description": "How long (in seconds) to wait before claiming failure. The default value is 5 seconds. It is invalid for timeoutSec to have greater value than checkIntervalSec.",
                     "format": "int32",
                     "type": "integer"
                 },
                 "unhealthyThreshold": {
-                    "description": "A so-far healthy VM will be marked unhealthy after this many consecutive failures. The default value is 2.",
+                    "description": "A so-far healthy instance will be marked unhealthy after this many consecutive failures. The default value is 2.",
                     "format": "int32",
                     "type": "integer"
                 }
             },
             "type": "object"
         },
         "HttpHealthCheckList": {
             "description": "Contains a list of HttpHealthCheck resources.",
             "id": "HttpHealthCheckList",
             "properties": {
                 "id": {
-                    "description": "Unique identifier for the resource; defined by the server (output only).",
+                    "description": "[Output Only] Unique identifier for the resource. Defined by the server.",
                     "type": "string"
                 },
                 "items": {
                     "description": "A list of HttpHealthCheck resources.",
                     "items": {
                         "$ref": "HttpHealthCheck"
                     },
                     "type": "array"
                 },
                 "kind": {
                     "default": "compute#httpHealthCheckList",
                     "description": "Type of resource.",
                     "type": "string"
                 },
                 "nextPageToken": {
-                    "description": "A token used to continue a truncated list request (output only).",
+                    "description": "[Output Only] A token used to continue a truncated list request.",
                     "type": "string"
                 },
                 "selfLink": {
-                    "description": "Server defined URL for this resource (output only).",
+                    "description": "[Output Only] Server-defined URL for this resource.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "Image": {
             "description": "An Image resource.",
             "id": "Image",
             "properties": {
                 "archiveSizeBytes": {
@@ skipping 69 matching lines @@
                                     "compute.images.insert"
                                 ]
                             },
                             "description": "The full Google Cloud Storage URL where the disk image is stored. You must provide either this property or the sourceDisk property but not both.",
                             "type": "string"
                         }
                     },
                     "type": "object"
                 },
                 "selfLink": {
-                    "description": "[Output Only] Server defined URL for the resource.",
+                    "description": "[Output Only] Server-defined URL for the resource.",
                     "type": "string"
                 },
                 "sourceDisk": {
                     "description": "URL of the The source disk used to create this image. This can be a full or valid partial URL. You must provide either this property or the rawDisk.source property but not both to create an image. For example, the following are valid values:  \n- https://www.googleapis.com/compute/v1/projects/project/zones/zone/disk/disk \n- projects/project/zones/zone/disk/disk \n- zones/zone/disks/disk",
                     "type": "string"
                 },
                 "sourceDiskId": {
                     "description": "The ID value of the disk used to create this image. This value may be used to determine whether the image was taken from the current or a previous instance of a given disk name.",
                     "type": "string"
                 },
@@ skipping 23 matching lines @@
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "ImageList": {
             "description": "Contains a list of Image resources.",
             "id": "ImageList",
             "properties": {
                 "id": {
-                    "description": "Unique identifier for the resource; defined by the server (output only).",
+                    "description": "[Output Only] Unique identifier for the resource; defined by the server.",
                     "type": "string"
                 },
                 "items": {
                     "description": "A list of Image resources.",
                     "items": {
                         "$ref": "Image"
                     },
                     "type": "array"
                 },
                 "kind": {
                     "default": "compute#imageList",
                     "description": "Type of resource.",
                     "type": "string"
                 },
                 "nextPageToken": {
-                    "description": "A token used to continue a truncated list request (output only).",
+                    "description": "[Output Only] A token used to continue a truncated list request.",
                     "type": "string"
                 },
                 "selfLink": {
-                    "description": "Server defined URL for this resource (output only).",
+                    "description": "[Output Only] Server-defined URL for this resource.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "Instance": {
             "description": "An Instance resource.",
             "id": "Instance",
             "properties": {
                 "canIpForward": {
@@ skipping 51 matching lines @@
                     "items": {
                         "$ref": "NetworkInterface"
                     },
                     "type": "array"
                 },
                 "scheduling": {
                     "$ref": "Scheduling",
                     "description": "Scheduling options for this instance."
                 },
                 "selfLink": {
-                    "description": "[Output Only] Server defined URL for this resource.",
+                    "description": "[Output Only] Server-defined URL for this resource.",
                     "type": "string"
                 },
                 "serviceAccounts": {
                     "description": "A list of service accounts, with their specified scopes, authorized for this instance. Service accounts generate access tokens that can be accessed through the metadata server and used to authenticate applications on the instance. See Authenticating from Google Compute Engine for more information.",
                     "items": {
                         "$ref": "ServiceAccount"
                     },
                     "type": "array"
                 },
                 "status": {
@@ skipping 53 matching lines @@
                 "kind": {
                     "default": "compute#instanceAggregatedList",
                     "description": "[Output Only] Type of resource. Always compute#instanceAggregatedList for aggregated lists of Instance resources.",
                     "type": "string"
                 },
                 "nextPageToken": {
                     "description": "[Output Only] A token used to continue a truncated list request.",
                     "type": "string"
                 },
                 "selfLink": {
-                    "description": "[Output Only] Server defined URL for this resource.",
+                    "description": "[Output Only] Server-defined URL for this resource.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "InstanceGroup": {
             "id": "InstanceGroup",
             "properties": {
                 "creationTimestamp": {
                     "description": "[Output Only] The creation timestamp for this instance group in RFC3339 text format.",
@@ skipping 182 matching lines @@
                     "annotations": {
                         "required": [
                             "compute.instanceGroupManagers.insert"
                         ]
                     },
                     "description": "The name of the managed instance group. The name must be 1-63 characters long, and comply with RFC1035.",
                     "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                     "type": "string"
                 },
                 "selfLink": {
-                    "description": "[Output Only] Server defined URL for this managed instance group.",
+                    "description": "[Output Only] Server-defined URL for this managed instance group.",
                     "type": "string"
                 },
                 "targetPools": {
                     "description": "The URLs of all TargetPool resources to which new instances in the instanceGroup field are added. Updating the target pool values does not affect existing instances.",
                     "items": {
                         "type": "string"
                     },
                     "type": "array"
                 },
                 "targetSize": {
@@ skipping 344 matching lines @@
                     "description": "A filter for the state of the instances in the instance group. Valid options are ALL or RUNNING. If you do not specify this parameter the list includes all instances regardless of their state.",
                     "enum": [
                         "ALL",
                         "RUNNING"
                     ],
                     "enumDescriptions": [
                         "",
                         ""
                     ],
                     "type": "string"
-                },
-                "portName": {
-                    "description": "A filter for the named ports that are associated with instances in the instance group. If you specify this parameter, the generated list includes only instances that are associated with the specified named ports. If you do not specify this parameter, the generated list includes all instances regardless of their named ports.",
-                    "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
-                    "type": "string"
                 }
             },
             "type": "object"
         },
         "InstanceGroupsRemoveInstancesRequest": {
             "id": "InstanceGroupsRemoveInstancesRequest",
             "properties": {
                 "instances": {
                     "description": "The instances to remove from the instance group.",
                     "items": {
@@ skipping 116 matching lines @@
                 "kind": {
                     "default": "compute#instanceList",
                     "description": "[Output Only] Type of resource. Always compute#instanceList for lists of Instance resources.",
                     "type": "string"
                 },
                 "nextPageToken": {
                     "description": "[Output Only] A token used to continue a truncated list request.",
                     "type": "string"
                 },
                 "selfLink": {
-                    "description": "[Output Only] Server defined URL for this resource.",
+                    "description": "[Output Only] Server-defined URL for this resource.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "InstanceMoveRequest": {
             "id": "InstanceMoveRequest",
             "properties": {
                 "destinationZone": {
                     "description": "The URL of the destination zone to move the instance to. This can be a full or partial URL. For example, the following are all valid URLs to a zone:  \n- https://www.googleapis.com/compute/v1/projects/project/zones/zone \n- projects/project/zones/zone \n- zones/zone",
@@ skipping 275 matching lines @@
                     "default": "compute#license",
                     "description": "[Output Only] Type of resource. Always compute#license for licenses.",
                     "type": "string"
                 },
                 "name": {
                     "annotations": {
                         "required": [
                             "compute.images.insert"
                         ]
                     },
-                    "description": "Name of the resource. The name must be 1-63 characters long, and comply with RCF1035.",
+                    "description": "Name of the resource. The name must be 1-63 characters long, and comply with RFC1035.",
                     "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                     "type": "string"
                 },
                 "selfLink": {
-                    "description": "[Output Only] Server defined URL for the resource.",
+                    "description": "[Output Only] Server-defined URL for the resource.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "MachineType": {
             "description": "A Machine Type resource.",
             "id": "MachineType",
             "properties": {
                 "creationTimestamp": {
@@ skipping 56 matching lines @@
                                 "description": "Size of the scratch disk, defined in GB.",
                                 "format": "int32",
                                 "type": "integer"
                             }
                         },
                         "type": "object"
                     },
                     "type": "array"
                 },
                 "selfLink": {
-                    "description": "[Output Only] Server defined URL for the resource.",
+                    "description": "[Output Only] Server-defined URL for the resource.",
                     "type": "string"
                 },
                 "zone": {
                     "description": "[Output Only] The name of the zone where the machine type resides, such as us-central1-a.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "MachineTypeAggregatedList": {
@@ skipping 14 matching lines @@
                 "kind": {
                     "default": "compute#machineTypeAggregatedList",
                     "description": "[Output Only] Type of resource. Always compute#machineTypeAggregatedList for aggregated lists of machine types.",
                     "type": "string"
                 },
                 "nextPageToken": {
                     "description": "[Output Only] A token used to continue a truncated list request.",
                     "type": "string"
                 },
                 "selfLink": {
-                    "description": "[Output Only] Server defined URL for this resource.",
+                    "description": "[Output Only] Server-defined URL for this resource.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "MachineTypeList": {
             "description": "Contains a list of Machine Type resources.",
             "id": "MachineTypeList",
             "properties": {
                 "id": {
@@ skipping 10 matching lines @@
                 "kind": {
                     "default": "compute#machineTypeList",
                     "description": "[Output Only] Type of resource. Always compute#machineTypeList for lists of machine types.",
                     "type": "string"
                 },
                 "nextPageToken": {
                     "description": "[Output Only] A token used to continue a truncated list request.",
                     "type": "string"
                 },
                 "selfLink": {
-                    "description": "[Output Only] Server defined URL for this resource.",
+                    "description": "[Output Only] Server-defined URL for this resource.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "MachineTypesScopedList": {
             "id": "MachineTypesScopedList",
             "properties": {
                 "machineTypes": {
                     "description": "[Output Only] List of machine types contained in this scope.",
@@ skipping 271 matching lines @@
                     "annotations": {
                         "required": [
                             "compute.networks.insert"
                         ]
                     },
                     "description": "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.",
                     "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                     "type": "string"
                 },
                 "selfLink": {
-                    "description": "[Output Only] Server defined URL for the resource.",
+                    "description": "[Output Only] Server-defined URL for the resource.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "NetworkInterface": {
             "description": "A network interface resource attached to an instance.",
             "id": "NetworkInterface",
             "properties": {
                 "accessConfigs": {
@@ skipping 41 matching lines @@
                 "kind": {
                     "default": "compute#networkList",
                     "description": "[Output Only] Type of resource. Always compute#networkList for lists of networks.",
                     "type": "string"
                 },
                 "nextPageToken": {
                     "description": "[Output Only] A token used to continue a truncated list request.",
                     "type": "string"
                 },
                 "selfLink": {
-                    "description": "[Output Only] Server defined URL for this resource .",
+                    "description": "[Output Only] Server-defined URL for this resource .",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "Operation": {
             "description": "An Operation resource, used to manage asynchronous API requests.",
             "id": "Operation",
             "properties": {
                 "clientOperationId": {
@@ skipping 69 matching lines @@
                 "progress": {
                     "description": "[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 number should monotonically increase as the operation progresses.",
                     "format": "int32",
                     "type": "integer"
                 },
                 "region": {
                     "description": "[Output Only] URL of the region where the operation resides. Only applicable for regional resources.",
                     "type": "string"
                 },
                 "selfLink": {
-                    "description": "[Output Only] Server defined URL for the resource.",
+                    "description": "[Output Only] Server-defined URL for the resource.",
                     "type": "string"
                 },
                 "startTime": {
                     "description": "[Output Only] The time that this operation was started by the server. This is in RFC3339 text format.",
                     "type": "string"
                 },
                 "status": {
                     "description": "[Output Only] Status of the operation. Can be one of the following: PENDING, RUNNING, or DONE.",
                     "enum": [
                         "DONE",
@@ skipping 115 matching lines @@
                 "kind": {
                     "default": "compute#operationAggregatedList",
                     "description": "[Output Only] Type of resource. Always compute#operationAggregatedList for aggregated lists of operations.",
                     "type": "string"
                 },
                 "nextPageToken": {
                     "description": "[Output Only] A token used to continue a truncated list request.",
                     "type": "string"
                 },
                 "selfLink": {
-                    "description": "[Output Only] Server defined URL for this resource.",
+                    "description": "[Output Only] Server-defined URL for this resource.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "OperationList": {
             "description": "Contains a list of Operation resources.",
             "id": "OperationList",
             "properties": {
                 "id": {
@@ skipping 10 matching lines @@
                 "kind": {
                     "default": "compute#operationList",
                     "description": "[Output Only] Type of resource. Always compute#operations for Operations resource.",
                     "type": "string"
                 },
                 "nextPageToken": {
                     "description": "[Output Only] A token used to continue a truncate.",
                     "type": "string"
                 },
                 "selfLink": {
-                    "description": "[Output Only] Server defined URL for this resource.",
+                    "description": "[Output Only] Server-defined URL for this resource.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "OperationsScopedList": {
             "id": "OperationsScopedList",
             "properties": {
                 "operations": {
                     "description": "[Output Only] List of operations contained in this scope.",
@@ skipping 121 matching lines @@
                     "description": "Metadata key/value pairs available to all instances contained in this project. See Custom metadata for more information."
                 },
                 "creationTimestamp": {
                     "description": "[Output Only] Creation timestamp in RFC3339 text format.",
                     "type": "string"
                 },
                 "description": {
                     "description": "An optional textual description of the resource.",
                     "type": "string"
                 },
+                "enabledFeatures": {
+                    "description": "Restricted features enabled for use on this project.",
+                    "items": {
+                        "type": "string"
+                    },
+                    "type": "array"
+                },
                 "id": {
                     "description": "[Output Only] Unique identifier for the resource; defined by the server.",
                     "format": "uint64",
                     "type": "string"
                 },
                 "kind": {
                     "default": "compute#project",
                     "description": "[Output Only] Type of the resource. Always compute#project for projects.",
                     "type": "string"
                 },
                 "name": {
                     "description": "Name of the resource.",
                     "type": "string"
                 },
                 "quotas": {
                     "description": "[Output Only] Quotas assigned to this project.",
                     "items": {
                         "$ref": "Quota"
                     },
                     "type": "array"
                 },
                 "selfLink": {
-                    "description": "[Output Only] Server defined URL for the resource.",
+                    "description": "[Output Only] Server-defined URL for the resource.",
                     "type": "string"
                 },
                 "usageExportLocation": {
                     "$ref": "UsageExportLocation",
                     "description": "The location in Cloud Storage and naming method of the daily usage report."
                 }
             },
             "type": "object"
         },
         "Quota": {
@@ skipping 100 matching lines @@
                     "type": "string"
                 },
                 "quotas": {
                     "description": "[Output Only] Quotas assigned to this region.",
                     "items": {
                         "$ref": "Quota"
                     },
                     "type": "array"
                 },
                 "selfLink": {
-                    "description": "[Output Only] Server defined URL for the resource.",
+                    "description": "[Output Only] Server-defined URL for the resource.",
                     "type": "string"
                 },
                 "status": {
                     "description": "[Output Only] Status of the region, either UP or DOWN.",
                     "enum": [
                         "DOWN",
                         "UP"
                     ],
                     "enumDescriptions": [
                         "",
@@ skipping 29 matching lines @@
                 "kind": {
                     "default": "compute#regionList",
                     "description": "[Output Only] Type of resource. Always compute#regionList for lists of regions.",
                     "type": "string"
                 },
                 "nextPageToken": {
                     "description": "[Output Only] A token used to continue a truncated list request.",
                     "type": "string"
                 },
                 "selfLink": {
-                    "description": "[Output Only] Server defined URL for this resource.",
+                    "description": "[Output Only] Server-defined URL for this resource.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "ResourceGroupReference": {
             "id": "ResourceGroupReference",
             "properties": {
                 "group": {
                     "description": "A URI referencing one of the resource views listed in the backend service.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "Route": {
-            "description": "The route resource. A Route is a rule that specifies how certain packets should be handled by the virtual network. Routes are associated with VMs by tag and the set of Routes for a particular VM is called its routing table. For each packet leaving a VM, the system searches that VM'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 VM destination, a VM gateway or a GCE operated gateway. Packets that do not match any Route in the sending VM's routing table are dropped.",
+            "description": "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 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 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, a instance gateway or a Google Compute Engien-operated gateway. Packets that do not match any Route in the sending instance's routing table are dropped.",
             "id": "Route",
             "properties": {
                 "creationTimestamp": {
                     "description": "[Output Only] Creation timestamp in RFC3339 text format.",
                     "type": "string"
                 },
                 "description": {
                     "description": "An optional textual description of the resource. Provided by the client when the resource is created.",
                     "type": "string"
                 },
@@ skipping 168 matching lines @@
                 "kind": {
                     "default": "compute#routeList",
                     "description": "Type of resource.",
                     "type": "string"
                 },
                 "nextPageToken": {
                     "description": "[Output Only] A token used to continue a truncated list request.",
                     "type": "string"
                 },
                 "selfLink": {
-                    "description": "[Output Only] Server defined URL for this resource.",
+                    "description": "[Output Only] Server-defined URL for this resource.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "Scheduling": {
             "description": "Sets the scheduling options for an Instance.",
             "id": "Scheduling",
             "properties": {
                 "automaticRestart": {
@@ skipping 26 matching lines @@
                 "contents": {
                     "description": "[Output Only] The contents of the console output.",
                     "type": "string"
                 },
                 "kind": {
                     "default": "compute#serialPortOutput",
                     "description": "[Output Only] Type of the resource. Always compute#serialPortOutput for serial port output.",
                     "type": "string"
                 },
                 "selfLink": {
-                    "description": "[Output Only] Server defined URL for the resource.",
+                    "description": "[Output Only] Server-defined URL for the resource.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "ServiceAccount": {
             "description": "A service account.",
             "id": "ServiceAccount",
             "properties": {
                 "email": {
@@ skipping 97 matching lines @@
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "SnapshotList": {
             "description": "Contains a list of Snapshot resources.",
             "id": "SnapshotList",
             "properties": {
                 "id": {
-                    "description": "Unique identifier for the resource; defined by the server (output only).",
+                    "description": "[Output Only] Unique identifier for the resource. Defined by the server.",
                     "type": "string"
                 },
                 "items": {
                     "description": "A list of Snapshot resources.",
                     "items": {
                         "$ref": "Snapshot"
                     },
                     "type": "array"
                 },
                 "kind": {
                     "default": "compute#snapshotList",
                     "description": "Type of resource.",
                     "type": "string"
                 },
                 "nextPageToken": {
-                    "description": "A token used to continue a truncated list request (output only).",
+                    "description": "[Output Only] A token used to continue a truncated list request.",
                     "type": "string"
                 },
                 "selfLink": {
-                    "description": "Server defined URL for this resource (output only).",
+                    "description": "[Output Only] Server-defined URL for this resource.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "Tags": {
             "description": "A set of instance tags.",
             "id": "Tags",
             "properties": {
                 "fingerprint": {
@@ skipping 32 matching lines @@
                     "default": "compute#targetHttpProxy",
                     "description": "[Output Only] Type of resource. Always compute#Operation for Operation resources.",
                     "type": "string"
                 },
                 "name": {
                     "description": "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.",
                     "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                     "type": "string"
                 },
                 "selfLink": {
-                    "description": "[Output Only] Server defined URL for the resource.",
+                    "description": "[Output Only] Server-defined URL for the resource.",
                     "type": "string"
                 },
                 "urlMap": {
                     "description": "URL to the UrlMap resource that defines the mapping from URL to the BackendService.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "TargetHttpProxyList": {
@@ skipping 21 matching lines @@
                     "type": "string"
                 },
                 "selfLink": {
                     "description": "[Output Only] Server-defined URL for this resource.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "TargetInstance": {
-            "description": "A TargetInstance resource. This resource defines an endpoint VM that terminates traffic of certain protocols.",
+            "description": "A TargetInstance resource. This resource defines an endpoint instance that terminates traffic of certain protocols.",
             "id": "TargetInstance",
             "properties": {
                 "creationTimestamp": {
-                    "description": "Creation timestamp in RFC3339 text format (output only).",
+                    "description": "[Output Only] Creation timestamp in RFC3339 text format.",
                     "type": "string"
                 },
                 "description": {
                     "description": "An optional textual description of the resource; provided by the client when the resource is created.",
                     "type": "string"
                 },
                 "id": {
-                    "description": "Unique identifier for the resource; defined by the server (output only).",
+                    "description": "[Output Only] Unique identifier for the resource; defined by the server.",
                     "format": "uint64",
                     "type": "string"
                 },
                 "instance": {
                     "description": "The URL to the instance that terminates the relevant traffic.",
                     "type": "string"
                 },
                 "kind": {
                     "default": "compute#targetInstance",
                     "description": "Type of the resource.",
                     "type": "string"
                 },
                 "name": {
-                    "description": "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.",
+                    "description": "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.",
                     "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                     "type": "string"
                 },
                 "natPolicy": {
-                    "description": "NAT option controlling how IPs are NAT'ed to the VM. Currently only NO_NAT (default value) is supported.",
+                    "description": "NAT option controlling how IPs are NAT'ed to the instance. Currently only NO_NAT (default value) is supported.",
                     "enum": [
                         "NO_NAT"
                     ],
                     "enumDescriptions": [
                         ""
                     ],
                     "type": "string"
                 },
                 "selfLink": {
-                    "description": "Server defined URL for the resource (output only).",
+                    "description": "[Output Only] Server-defined URL for the resource.",
                     "type": "string"
                 },
                 "zone": {
-                    "description": "URL of the zone where the target instance resides (output only).",
+                    "description": "[Output Only] URL of the zone where the target instance resides.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "TargetInstanceAggregatedList": {
             "id": "TargetInstanceAggregatedList",
             "properties": {
                 "id": {
-                    "description": "Unique identifier for the resource; defined by the server (output only).",
+                    "description": "[Output Only] Unique identifier for the resource; defined by the server.",
                     "type": "string"
                 },
                 "items": {
                     "additionalProperties": {
                         "$ref": "TargetInstancesScopedList",
                         "description": "Name of the scope containing this set of target instances."
                     },
                     "description": "A map of scoped target instance lists.",
                     "type": "object"
                 },
                 "kind": {
                     "default": "compute#targetInstanceAggregatedList",
                     "description": "Type of resource.",
                     "type": "string"
                 },
                 "nextPageToken": {
-                    "description": "A token used to continue a truncated list request (output only).",
+                    "description": "[Output Only] A token used to continue a truncated list request.",
                     "type": "string"
                 },
                 "selfLink": {
-                    "description": "Server defined URL for this resource (output only).",
+                    "description": "[Output Only] Server-defined URL for this resource.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "TargetInstanceList": {
             "description": "Contains a list of TargetInstance resources.",
             "id": "TargetInstanceList",
             "properties": {
                 "id": {
-                    "description": "Unique identifier for the resource; defined by the server (output only).",
+                    "description": "[Output Only] Unique identifier for the resource; defined by the server.",
                     "type": "string"
                 },
                 "items": {
                     "description": "A list of TargetInstance resources.",
                     "items": {
                         "$ref": "TargetInstance"
                     },
                     "type": "array"
                 },
                 "kind": {
                     "default": "compute#targetInstanceList",
                     "description": "Type of resource.",
                     "type": "string"
                 },
                 "nextPageToken": {
-                    "description": "A token used to continue a truncated list request (output only).",
+                    "description": "[Output Only] A token used to continue a truncated list request.",
                     "type": "string"
                 },
                 "selfLink": {
-                    "description": "Server defined URL for this resource (output only).",
+                    "description": "[Output Only] Server-defined URL for this resource.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "TargetInstancesScopedList": {
             "id": "TargetInstancesScopedList",
             "properties": {
                 "targetInstances": {
                     "description": "List of target instances contained in this scope.",
@@ skipping 62 matching lines @@
                             "description": "[Output Only] Optional human-readable details for this warning.",
                             "type": "string"
                         }
                     },
                     "type": "object"
                 }
             },
             "type": "object"
         },
         "TargetPool": {
-            "description": "A TargetPool resource. This resource defines a pool of VMs, associated HttpHealthCheck resources, and the fallback TargetPool.",
+            "description": "A TargetPool resource. This resource defines a pool of instances, associated HttpHealthCheck resources, and the fallback TargetPool.",
             "id": "TargetPool",
             "properties": {
                 "backupPool": {
-                    "description": "This field is applicable only when the containing target pool is serving a forwarding rule as the primary pool, and its 'failoverRatio' field is properly set to a value between [0, 1].\n\n'backupPool' and 'failoverRatio' together define the fallback behavior of the primary target pool: if the ratio of the healthy VMs in the primary pool is at or below 'failoverRatio', traffic arriving at the load-balanced IP will be directed to the backup pool.\n\nIn case where 'failoverRatio' and 'backupPool' are not set, or all the VMs in the backup pool are unhealthy, the traffic will be directed back to the primary pool in the \"force\" mode, where traffic will be spread to the healthy VMs with the best effort, or to all VMs when no VM is healthy.",
+                    "description": "This field is applicable only when the containing target pool is serving a forwarding rule as the primary pool, and its failoverRatio field is properly set to a value between [0, 1].\n\nbackupPool and failoverRatio together define the fallback behavior of the primary target pool: if the ratio of the healthy instances in the primary pool is at or below failoverRatio, traffic arriving at the load-balanced IP will be directed to the backup pool.\n\nIn case where failoverRatio and backupPool are not set, or all the instances in the backup pool are unhealthy, the traffic will be directed back to the primary pool in the \"force\" mode, where traffic will be spread to the healthy instances with the best effort, or to all instances when no instance is healthy.",
                     "type": "string"
                 },
                 "creationTimestamp": {
-                    "description": "Creation timestamp in RFC3339 text format (output only).",
+                    "description": "[Output Only] Creation timestamp in RFC3339 text format.",
                     "type": "string"
                 },
                 "description": {
                     "description": "An optional textual description of the resource; provided by the client when the resource is created.",
                     "type": "string"
                 },
                 "failoverRatio": {
-                    "description": "This field is applicable only when the containing target pool is serving a forwarding rule as the primary pool (i.e., not as a backup pool to some other target pool). The value of the field must be in [0, 1].\n\nIf set, 'backupPool' must also be set. They together define the fallback behavior of the primary target pool: if the ratio of the healthy VMs in the primary pool is at or below this number, traffic arriving at the load-balanced IP will be directed to the backup pool.\n\nIn case where 'failoverRatio' is not set or all the VMs in the backup pool are unhealthy, the traffic will be directed back to the primary pool in the \"force\" mode, where traffic will be spread to the healthy VMs with the best effort, or to all VMs when no VM is healthy.",
+                    "description": "This field is applicable only when the containing target pool is serving a forwarding rule as the primary pool (i.e., not as a backup pool to some other target pool). The value of the field must be in [0, 1].\n\nIf set, backupPool must also be set. They together define the fallback behavior of the primary target pool: if the ratio of the healthy instances in the primary pool is at or below this number, traffic arriving at the load-balanced IP will be directed to the backup pool.\n\nIn case where failoverRatio is not set or all the instances in the backup pool are unhealthy, the traffic will be directed back to the primary pool in the \"force\" mode, where traffic will be spread to the healthy instances with the best effort, or to all instances when no instance is healthy.",
                     "format": "float",
                     "type": "number"
                 },
                 "healthChecks": {
-                    "description": "A list of URLs to the HttpHealthCheck resource. A member VM in this pool is considered healthy if and only if all specified health checks pass. An empty list means all member VMs will be considered healthy at all times.",
+                    "description": "A list of URLs to the HttpHealthCheck resource. A member instance in this pool is considered healthy if and only if all specified health checks pass. An empty list means all member instances will be considered healthy at all times.",
                     "items": {
                         "type": "string"
                     },
                     "type": "array"
                 },
                 "id": {
-                    "description": "Unique identifier for the resource; defined by the server (output only).",
+                    "description": "[Output Only] Unique identifier for the resource; defined by the server.",
                     "format": "uint64",
                     "type": "string"
                 },
                 "instances": {
-                    "description": "A list of resource URLs to the member VMs serving this pool. They must live in zones contained in the same region as this pool.",
+                    "description": "A list of resource URLs to the member virtual machines serving this pool. They must live in zones contained in the same region as this pool.",
                     "items": {
                         "type": "string"
                     },
                     "type": "array"
                 },
                 "kind": {
                     "default": "compute#targetPool",
                     "description": "Type of the resource.",
                     "type": "string"
                 },
                 "name": {
-                    "description": "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.",
+                    "description": "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.",
                     "pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
                     "type": "string"
                 },
                 "region": {
-                    "description": "URL of the region where the target pool resides (output only).",
+                    "description": "[Output Only] URL of the region where the target pool resides.",
                     "type": "string"
                 },
                 "selfLink": {
-                    "description": "Server defined URL for the resource (output only).",
+                    "description": "[Output Only] Server-defined URL for the resource.",
                     "type": "string"
                 },
                 "sessionAffinity": {
-                    "description": "Sesssion affinity option, must be one of the following values: 'NONE': Connections from the same client IP may go to any VM in the pool; 'CLIENT_IP': Connections from the same client IP will go to the same VM in the pool while that VM remains healthy. 'CLIENT_IP_PROTO': Connections from the same client IP with the same IP protocol will go to the same VM in the pool while that VM remains healthy.",
+                    "description": "Sesssion affinity option, must be one of the following values: NONE: Connections from the same client IP may go to any instance in the pool; CLIENT_IP: Connections from the same client IP will go to the same instance in the pool while that instance remains healthy. CLIENT_IP_PROTO: Connections from the same client IP with the same IP protocol will go to the same instance in the pool while that instance remains healthy.",
                     "enum": [
                         "CLIENT_IP",
                         "CLIENT_IP_PROTO",
                         "NONE"
                     ],
                     "enumDescriptions": [
                         "",
                         "",
                         ""
                     ],
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "TargetPoolAggregatedList": {
             "id": "TargetPoolAggregatedList",
             "properties": {
                 "id": {
-                    "description": "Unique identifier for the resource; defined by the server (output only).",
+                    "description": "[Output Only] Unique identifier for the resource. Defined by the server.",
                     "type": "string"
                 },
                 "items": {
                     "additionalProperties": {
                         "$ref": "TargetPoolsScopedList",
                         "description": "Name of the scope containing this set of target pools."
                     },
                     "description": "A map of scoped target pool lists.",
                     "type": "object"
                 },
                 "kind": {
                     "default": "compute#targetPoolAggregatedList",
                     "description": "Type of resource.",
                     "type": "string"
                 },
                 "nextPageToken": {
-                    "description": "A token used to continue a truncated list request (output only).",
+                    "description": "[Output Only] A token used to continue a truncated list request.",
                     "type": "string"
                 },
                 "selfLink": {
-                    "description": "Server defined URL for this resource (output only).",
+                    "description": "[Output Only] Server-defined URL for this resource.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "TargetPoolInstanceHealth": {
             "id": "TargetPoolInstanceHealth",
             "properties": {
                 "healthStatus": {
                     "items": {
                         "$ref": "HealthStatus"
                     },
                     "type": "array"
                 },
                 "kind": {
                     "default": "compute#targetPoolInstanceHealth",
                     "description": "Type of resource.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "TargetPoolList": {
             "description": "Contains a list of TargetPool resources.",
             "id": "TargetPoolList",
             "properties": {
                 "id": {
-                    "description": "Unique identifier for the resource; defined by the server (output only).",
+                    "description": "[Output Only] Unique identifier for the resource. Defined by the server.",
                     "type": "string"
                 },
                 "items": {
                     "description": "A list of TargetPool resources.",
                     "items": {
                         "$ref": "TargetPool"
                     },
                     "type": "array"
                 },
                 "kind": {
                     "default": "compute#targetPoolList",
                     "description": "Type of resource.",
                     "type": "string"
                 },
                 "nextPageToken": {
-                    "description": "A token used to continue a truncated list request (output only).",
+                    "description": "[Output Only] A token used to continue a truncated list request.",
                     "type": "string"
                 },
                 "selfLink": {
-                    "description": "Server defined URL for this resource (output only).",
+                    "description": "[Output Only] Server-defined URL for this resource.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "TargetPoolsAddHealthCheckRequest": {
             "id": "TargetPoolsAddHealthCheckRequest",
             "properties": {
                 "healthChecks": {
                     "description": "Health check URLs to be added to targetPool.",
@@ skipping 410 matching lines @@
                     "type": "string"
                 },
                 "pathMatchers": {
                     "description": "The list of named PathMatchers to use against the URL.",
                     "items": {
                         "$ref": "PathMatcher"
                     },
                     "type": "array"
                 },
                 "selfLink": {
-                    "description": "[Output Only] Server defined URL for the resource.",
+                    "description": "[Output Only] Server-defined URL for the resource.",
                     "type": "string"
                 },
                 "tests": {
                     "description": "The list of expected URL mappings. Request to update this UrlMap will succeed only all of the test cases pass.",
                     "items": {
                         "$ref": "UrlMapTest"
                     },
                     "type": "array"
                 }
             },
@@ skipping 17 matching lines @@
                 "kind": {
                     "default": "compute#urlMapList",
                     "description": "Type of resource.",
                     "type": "string"
                 },
                 "nextPageToken": {
                     "description": "[Output Only] A token used to continue a truncated list request.",
                     "type": "string"
                 },
                 "selfLink": {
-                    "description": "[Output Only] Server defined URL for this resource.",
+                    "description": "[Output Only] Server-defined URL for this resource.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "UrlMapReference": {
             "id": "UrlMapReference",
             "properties": {
                 "urlMap": {
                     "type": "string"
@@ skipping 127 matching lines @@
                 },
                 "peerIp": {
                     "description": "IP address of the peer VPN gateway.",
                     "type": "string"
                 },
                 "region": {
                     "description": "[Output Only] URL of the region where the VPN tunnel resides.",
                     "type": "string"
                 },
                 "selfLink": {
-                    "description": "[Output Only] Server defined URL for the resource.",
+                    "description": "[Output Only] Server-defined URL for the resource.",
                     "type": "string"
                 },
                 "sharedSecret": {
                     "description": "Shared secret used to set the secure session between the GCE VPN gateway and the peer VPN gateway.",
                     "type": "string"
                 },
                 "sharedSecretHash": {
                     "description": "Hash of the shared secret.",
                     "type": "string"
                 },
@@ skipping 57 matching lines @@
                 "kind": {
                     "default": "compute#vpnTunnelAggregatedList",
                     "description": "[Output Only] Type of resource. Always compute#vpnTunnel for VPN tunnels.",
                     "type": "string"
                 },
                 "nextPageToken": {
                     "description": "[Output Only] A token used to continue a truncated list request.",
                     "type": "string"
                 },
                 "selfLink": {
-                    "description": "[Output Only] Server defined URL for this resource.",
+                    "description": "[Output Only] Server-defined URL for this resource.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "VpnTunnelList": {
             "description": "Contains a list of VpnTunnel resources.",
             "id": "VpnTunnelList",
             "properties": {
                 "id": {
@@ skipping 152 matching lines @@
                 },
                 "name": {
                     "description": "[Output Only] Name of the resource.",
                     "type": "string"
                 },
                 "region": {
                     "description": "[Output Only] Full URL reference to the region which hosts the zone.",
                     "type": "string"
                 },
                 "selfLink": {
-                    "description": "[Output Only] Server defined URL for the resource.",
+                    "description": "[Output Only] Server-defined URL for the resource.",
                     "type": "string"
                 },
                 "status": {
                     "description": "[Output Only] Status of the zone, either UP or DOWN.",
                     "enum": [
                         "DOWN",
                         "UP"
                     ],
                     "enumDescriptions": [
                         "",
@@ skipping 22 matching lines @@
                 "kind": {
                     "default": "compute#zoneList",
                     "description": "Type of resource.",
                     "type": "string"
                 },
                 "nextPageToken": {
                     "description": "[Output Only] A token used to continue a truncated list request.",
                     "type": "string"
                 },
                 "selfLink": {
-                    "description": "Server defined URL for this resource (output only).",
+                    "description": "[Output Only] Server-defined URL for this resource.",
                     "type": "string"
                 }
             },
             "type": "object"
         }
     },
     "servicePath": "compute/v1/projects/",
     "title": "Compute Engine API",
     "version": "v1"
 }