feat(compute): update the API

#### compute:alpha The following keys were added: - schemas.AccessConfig.properties.externalIpv6.description - schemas.AccessConfig.properties.externalIpv6.type - schemas.AccessConfig.properties.externalIpv6PrefixLength.description - schemas.AccessConfig.properties.externalIpv6PrefixLength.format - schemas.AccessConfig.properties.externalIpv6PrefixLength.type - schemas.AllocationSpecificSKUAllocationReservedInstanceProperties.properties.maintenanceInterval.description - schemas.AllocationSpecificSKUAllocationReservedInstanceProperties.properties.maintenanceInterval.enum - schemas.AllocationSpecificSKUAllocationReservedInstanceProperties.properties.maintenanceInterval.enumDescriptions - schemas.AllocationSpecificSKUAllocationReservedInstanceProperties.properties.maintenanceInterval.type - schemas.FirewallPolicyRule.properties.targetSecureLabels.description - schemas.FirewallPolicyRule.properties.targetSecureLabels.items.type - schemas.FirewallPolicyRule.properties.targetSecureLabels.type - schemas.FirewallPolicyRuleMatcher.properties.srcSecureLabels.description - schemas.FirewallPolicyRuleMatcher.properties.srcSecureLabels.items.type - schemas.FirewallPolicyRuleMatcher.properties.srcSecureLabels.type - schemas.NetworkInterface.properties.internalIpv6PrefixLength.description - schemas.NetworkInterface.properties.internalIpv6PrefixLength.format - schemas.NetworkInterface.properties.internalIpv6PrefixLength.type - schemas.NetworkInterface.properties.ipv6AccessConfigs.description - schemas.NetworkInterface.properties.ipv6AccessConfigs.items.$ref - schemas.NetworkInterface.properties.ipv6AccessConfigs.type - schemas.NetworkInterface.properties.nicType.description - schemas.NetworkInterface.properties.nicType.enum - schemas.NetworkInterface.properties.nicType.enumDescriptions - schemas.NetworkInterface.properties.nicType.type - schemas.NetworkInterface.properties.stackType.description - schemas.NetworkInterface.properties.stackType.enum - schemas.NetworkInterface.properties.stackType.enumDescriptions - schemas.NetworkInterface.properties.stackType.type - schemas.Router.properties.encryptedInterconnectRouter.description - schemas.Router.properties.encryptedInterconnectRouter.type - schemas.Scheduling.properties.maintenanceInterval.description - schemas.Scheduling.properties.maintenanceInterval.enum - schemas.Scheduling.properties.maintenanceInterval.enumDescriptions - schemas.Scheduling.properties.maintenanceInterval.type - schemas.Subnetwork.properties.externalIpv6Prefix.description - schemas.Subnetwork.properties.externalIpv6Prefix.type - schemas.Subnetwork.properties.ipv6AccessType.description - schemas.Subnetwork.properties.ipv6AccessType.enum - schemas.Subnetwork.properties.ipv6AccessType.enumDescriptions - schemas.Subnetwork.properties.ipv6AccessType.type - schemas.Subnetwork.properties.stackType.description - schemas.Subnetwork.properties.stackType.enum - schemas.Subnetwork.properties.stackType.enumDescriptions - schemas.Subnetwork.properties.stackType.type The following keys were changed: - resources.instances.methods.insert.parameters.sourceMachineImage.description - schemas.AccessConfig.properties.type.enum - schemas.AccessConfig.properties.type.enumDescriptions - schemas.Address.properties.purpose.description - schemas.HealthCheck.description - schemas.InterconnectAttachment.properties.encryption.description - schemas.NetworkEndpointGroupAppEngine.properties.service.description - schemas.NetworkEndpointGroupAppEngine.properties.version.description #### compute:beta The following keys were changed: - resources.instances.methods.insert.parameters.sourceMachineImage.description - schemas.Address.properties.purpose.description - schemas.HealthCheck.description - schemas.NetworkEndpointGroupAppEngine.properties.service.description - schemas.NetworkEndpointGroupAppEngine.properties.version.description #### compute:v1 The following keys were changed: - schemas.Address.properties.purpose.description - schemas.HealthCheck.description - schemas.NetworkEndpointGroupAppEngine.properties.service.description - schemas.NetworkEndpointGroupAppEngine.properties.version.description
googleapis · Oct 21, 2020 · a5848ec · a5848ec
1 parent 077a891
commit a5848ec
Show file tree

Hide file tree

Showing 6 changed files with 245 additions and 42 deletions.
diff --git a/discovery/compute-alpha.json b/discovery/compute-alpha.json
@@ -29,7 +29,7 @@
   "description": "Creates and runs virtual machines on Google Cloud Platform.",
   "discoveryVersion": "v1",
   "documentationLink": "https://developers.google.com/compute/docs/reference/latest/",
-  "etag": "\"-2NioU2H8y8siEzrBOV_qzRI6kQ/P8MoXM68pkNOBgwDFCH_3k_cHb8\"",
+  "etag": "\"-2NioU2H8y8siEzrBOV_qzRI6kQ/XD27oxKM8_o-p7tt2_RX1-WnTjg\"",
   "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"
@@ -9324,7 +9324,7 @@
               "type": "string"
             },
             "sourceMachineImage": {
-              "description": "Specifies instance machine to create the instance.\n\nThis field is optional. It can be a full or partial URL. For example, the following are all valid URLs to an instance template:  \n- https://www.googleapis.com/compute/v1/projects/project/global/global/machineImages/machineImage \n- projects/project/global/global/machineImages/machineImage \n- global/machineImages/machineImage",
+              "description": "Specifies the machine image to use to create the instance.\n\nThis field is optional. It can be a full or partial URL. For example, the following are all valid URLs to a machine image:  \n- https://www.googleapis.com/compute/v1/projects/project/global/global/machineImages/machineImage \n- projects/project/global/global/machineImages/machineImage \n- global/machineImages/machineImage",
               "location": "query",
               "type": "string"
             },
@@ -33252,7 +33252,7 @@
       }
     }
   },
-  "revision": "20200910",
+  "revision": "20201005",
   "rootUrl": "https://compute.googleapis.com/",
   "schemas": {
     "AcceleratorConfig": {
@@ -33657,6 +33657,15 @@
       "description": "An access configuration attached to an instance's network interface. Only one access config per instance is supported.",
       "id": "AccessConfig",
       "properties": {
+        "externalIpv6": {
+          "description": "[Output Only] The first IPv6 address of the external IPv6 range associated with this instance, prefix length is stored in externalIpv6PrefixLength in ipv6AccessConfig. The field is output only, an IPv6 address from a subnetwork associated with the instance will be allocated dynamically.",
+          "type": "string"
+        },
+        "externalIpv6PrefixLength": {
+          "description": "[Output Only] The prefix length of the external IPv6 range.",
+          "format": "int32",
+          "type": "integer"
+        },
         "kind": {
           "default": "compute#accessConfig",
           "description": "[Output Only] Type of the resource. Always compute#accessConfig for access configs.",
@@ -33704,9 +33713,11 @@
           "default": "ONE_TO_ONE_NAT",
           "description": "The type of configuration. The default and only option is ONE_TO_ONE_NAT.",
           "enum": [
+            "DIRECT_IPV6",
             "ONE_TO_ONE_NAT"
           ],
           "enumDescriptions": [
+            "",
             ""
           ],
           "type": "string"
@@ -33816,7 +33827,7 @@
           "type": "integer"
         },
         "purpose": {
-          "description": "The purpose of this resource, which can be one of the following values:  \n- `GCE_ENDPOINT` for addresses that are used by VM instances, alias IP ranges, internal load balancers, and similar resources. \n- `DNS_RESOLVER` for a DNS resolver address in a subnetwork \n- `VPC_PEERING` for addresses that are reserved for VPC peer networks. \n- `NAT_AUTO` for addresses that are external IP addresses automatically reserved for Cloud NAT.",
+          "description": "The purpose of this resource, which can be one of the following values:  \n- `GCE_ENDPOINT` for addresses that are used by VM instances, alias IP ranges, internal load balancers, and similar resources. \n- `DNS_RESOLVER` for a DNS resolver address in a subnetwork \n- `VPC_PEERING` for addresses that are reserved for VPC peer networks. \n- `NAT_AUTO` for addresses that are external IP addresses automatically reserved for Cloud NAT. \n- `IPSEC_INTERCONNECT` for addresses created from a private IP range reserved for a VLAN attachment in an IPsec over Interconnect configuration. These addresses are regional resources.",
           "enum": [
             "DNS_RESOLVER",
             "GCE_ENDPOINT",
@@ -34297,6 +34308,16 @@
           "format": "int32",
           "type": "integer"
         },
+        "maintenanceInterval": {
+          "description": "Specifies whether this VM may be a stable fleet VM. Setting this to \"Periodic\" designates this VM as a Stable Fleet VM.\n\nSee go/stable-fleet-ug for more details.",
+          "enum": [
+            "PERIODIC"
+          ],
+          "enumDescriptions": [
+            ""
+          ],
+          "type": "string"
+        },
         "minCpuPlatform": {
           "description": "Minimum cpu platform the reservation.",
           "type": "string"
@@ -39841,6 +39862,13 @@
           },
           "type": "array"
         },
+        "targetSecureLabels": {
+          "description": "A list of secure labels that controls which instances the firewall rule applies to. If targetSecureLabel are specified, then the firewall rule applies only to instances in the VPC network that have one of those secure labels. targetSecureLabel may not be set at the same time as targetServiceAccounts. If neither targetServiceAccounts nor targetSecureLabel are specified, the firewall rule applies to all instances on the specified network. Maximum number of target label values allowed is 256.",
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        },
         "targetServiceAccounts": {
           "description": "A list of service accounts indicating the sets of instances that are applied with this rule.",
           "items": {
@@ -39875,6 +39903,13 @@
             "type": "string"
           },
           "type": "array"
+        },
+        "srcSecureLabels": {
+          "description": "List of firewall label values, which should be matched at the source of the traffic. Maximum number of source label values allowed is 256.",
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
         }
       },
       "type": "object"
@@ -40851,7 +40886,7 @@
       "type": "object"
     },
     "HealthCheck": {
-      "description": "Represents a Health Check resource.\n\nGoogle Compute Engine has two Health Check resources:\n\n* [Global](/compute/docs/reference/rest/{$api_version}/healthChecks) * [Regional](/compute/docs/reference/rest/{$api_version}/regionHealthChecks)\n\nInternal HTTP(S) load balancers must use regional health checks. Internal TCP/UDP load balancers can use either regional or global health checks. All other types of GCP load balancers and managed instance group auto-healing must use global health checks. For more information, read Health Check Concepts.\n\nTo perform health checks on network load balancers, you must use either httpHealthChecks or httpsHealthChecks.",
+      "description": "Represents a Health Check resource.\n\nGoogle Compute Engine has two Health Check resources:\n\n* [Global](/compute/docs/reference/rest/{$api_version}/healthChecks) * [Regional](/compute/docs/reference/rest/{$api_version}/regionHealthChecks)\n\nInternal HTTP(S) load balancers must use regional health checks (`compute.v1.regionHealthChecks`).\n\nTraffic Director must use global health checks (`compute.v1.HealthChecks`).\n\nInternal TCP/UDP load balancers can use either regional or global health checks (`compute.v1.regionHealthChecks` or `compute.v1.HealthChecks`).\n\nExternal HTTP(S), TCP proxy, and SSL proxy load balancers as well as managed instance group auto-healing must use global health checks (`compute.v1.HealthChecks`).\n\nNetwork load balancers must use legacy HTTP health checks (httpHealthChecks).\n\nFor more information, see Health checks overview.",
       "id": "HealthCheck",
       "properties": {
         "checkIntervalSec": {
@@ -46415,7 +46450,7 @@
           "type": "string"
         },
         "encryption": {
-          "description": "Indicates the user-supplied encryption option of this interconnect attachment.",
+          "description": "Indicates the user-supplied encryption option of this interconnect attachment: \n- NONE is the default value, which means that the attachment carries unencrypted traffic. VMs can send traffic to, or receive traffic from, this type of attachment. \n- IPSEC indicates that the attachment carries only traffic encrypted by an IPsec device such as an HA VPN gateway. VMs cannot directly send traffic to, or receive traffic from, such an attachment. To use IPsec over Interconnect, create the attachment using this option.",
           "enum": [
             "IPSEC",
             "NONE"
@@ -49592,15 +49627,15 @@
       "id": "NetworkEndpointGroupAppEngine",
       "properties": {
         "service": {
-          "description": "Optional serving service.\n\nThe service name must be 1-63 characters long, and comply with RFC1035.\n\nExample value: \"default\", \"my-service\".",
+          "description": "Optional serving service.\n\nThe service name is case-sensitive and must be 1-63 characters long.\n\nExample value: \"default\", \"my-service\".",
           "type": "string"
         },
         "urlMask": {
           "description": "A template to parse service and version fields from a request URL. URL mask allows for routing to multiple App Engine services without having to create multiple Network Endpoint Groups and backend services.\n\nFor example, the request URLs \"foo1-dot-appname.appspot.com/v1\" and \"foo1-dot-appname.appspot.com/v2\" can be backed by the same Serverless NEG with URL mask \"-dot-appname.appspot.com/\". The URL mask will parse them to { service = \"foo1\", version = \"v1\" } and { service = \"foo1\", version = \"v2\" } respectively.",
           "type": "string"
         },
         "version": {
-          "description": "Optional serving version.\n\nThe version must be 1-63 characters long, and comply with RFC1035.\n\nExample value: \"v1\", \"v2\".",
+          "description": "Optional serving version.\n\nThe version name is case-sensitive and must be 1-100 characters long.\n\nExample value: \"v1\", \"v2\".",
           "type": "string"
         }
       },
@@ -50082,6 +50117,18 @@
           "format": "byte",
           "type": "string"
         },
+        "internalIpv6PrefixLength": {
+          "description": "[Output Only] The prefix length of the primary internal IPv6 range.",
+          "format": "int32",
+          "type": "integer"
+        },
+        "ipv6AccessConfigs": {
+          "description": "An array of IPv6 access configurations for this interface. Currently, only one IPv6 access config, DIRECT_IPV6, is supported. If there is no ipv6AccessConfig specified, then this instance will have no external IPv6 Internet access.",
+          "items": {
+            "$ref": "AccessConfig"
+          },
+          "type": "array"
+        },
         "ipv6Address": {
           "description": "[Output Only] An IPv6 internal network address for this network interface.",
           "type": "string"
@@ -50103,11 +50150,39 @@
           "description": "An IPv4 internal IP address to assign to the instance for this network interface. If not specified by the user, an unused internal IP is assigned by the system.",
           "type": "string"
         },
+        "nicType": {
+          "description": "The type of vNIC to be used on this interface. This may be gVNIC or VirtioNet.",
+          "enum": [
+            "GVNIC",
+            "UNSPECIFIED_NIC_TYPE",
+            "VIRTIO_NET"
+          ],
+          "enumDescriptions": [
+            "",
+            "",
+            ""
+          ],
+          "type": "string"
+        },
         "queueCount": {
           "description": "The networking queue count for the network interface. Both Rx and Tx queues will be set to this number. If it's not specified by the user, a default number of queues will be assigned. For Virtio-net, each interface will get (min(#vCPU, 32) / #vNIC) queues. For gVNIC, each interface will get (min(#vCPU / 2, 16) / #vNIC) qeueus.",
           "format": "int32",
           "type": "integer"
         },
+        "stackType": {
+          "description": "The stack type for this network interface to identify whether the IPv6 feature is enabled or not. If not specified, IPV4_ONLY will be used.\n\nThis field can be both set at instance creation and update network interface operations.",
+          "enum": [
+            "IPV4_IPV6",
+            "IPV4_ONLY",
+            "UNSPECIFIED_STACK_TYPE"
+          ],
+          "enumDescriptions": [
+            "",
+            "",
+            ""
+          ],
+          "type": "string"
+        },
         "subnetwork": {
           "description": "The URL of the Subnetwork resource for this instance. If the network resource is in legacy mode, do not specify this field. If the network is in auto subnet mode, specifying the subnetwork is optional. If the network is in custom subnet mode, specifying the subnetwork is required. If you specify this field, you can specify the subnetwork as a full or partial URL. For example, the following are all valid URLs:  \n- https://www.googleapis.com/compute/v1/projects/project/regions/region/subnetworks/subnetwork \n- regions/region/subnetworks/subnetwork",
           "type": "string"
@@ -57759,6 +57834,10 @@
           "description": "An optional description of this resource. Provide this property when you create the resource.",
           "type": "string"
         },
+        "encryptedInterconnectRouter": {
+          "description": "Field to indicate if a router is dedicated to use with encrypted Interconnect Attachment (Encrypted Interconnect feature).",
+          "type": "boolean"
+        },
         "id": {
           "description": "[Output Only] The unique identifier for the resource. This identifier is defined by the server.",
           "format": "uint64",
@@ -59154,6 +59233,16 @@
           "format": "int32",
           "type": "integer"
         },
+        "maintenanceInterval": {
+          "description": "Specifies whether this VM may be a stable fleet VM. Setting this to \"Periodic\" designates this VM as a Stable Fleet VM.\n\nSee go/stable-fleet-ug for more details.",
+          "enum": [
+            "PERIODIC"
+          ],
+          "enumDescriptions": [
+            ""
+          ],
+          "type": "string"
+        },
         "minNodeCpus": {
           "description": "The minimum number of virtual CPUs this instance will consume when running on a sole-tenant node.",
           "format": "int32",
@@ -61496,6 +61585,10 @@
           "description": "Deprecated in favor of enable in PrivateIpv6GoogleAccess. Whether the VMs in this subnet can directly access Google services via internal IPv6 addresses. This field can be both set at resource creation time and updated using patch.",
           "type": "boolean"
         },
+        "externalIpv6Prefix": {
+          "description": "[Output Only] The range of external IPv6 addresses that are owned by this subnetwork.",
+          "type": "string"
+        },
         "fingerprint": {
           "description": "Fingerprint of this resource. A hash of the contents stored in this object. This field is used in optimistic locking. This field will be ignored when inserting a Subnetwork. An up-to-date fingerprint must be provided in order to update the Subnetwork, otherwise the request will fail with error 412 conditionNotMet.\n\nTo see the latest fingerprint, make a get() request to retrieve a Subnetwork.",
           "format": "byte",
@@ -61519,6 +61612,20 @@
           "description": "The range of internal addresses that are owned by this subnetwork. Provide this property when you create the subnetwork. For example, 10.0.0.0/8 or 100.64.0.0/10. Ranges must be unique and non-overlapping within a network. Only IPv4 is supported. This field is set at resource creation time. This may be a RFC 1918 IP range, or a privately routed, non-RFC 1918 IP range, not belonging to Google. The range can be expanded after creation using expandIpCidrRange.",
           "type": "string"
         },
+        "ipv6AccessType": {
+          "description": "The access type of IPv6 address this subnet holds. It's immutable and can only be specified during creation or the first time the subnet is updated into IPV4_IPV6 dual stack. If the ipv6_type is EXTERNAL then this subnet cannot enable direct path.",
+          "enum": [
+            "EXTERNAL",
+            "INTERNAL",
+            "UNSPECIFIED_IPV6_ACCESS_TYPE"
+          ],
+          "enumDescriptions": [
+            "",
+            "",
+            ""
+          ],
+          "type": "string"
+        },
         "ipv6CidrRange": {
           "description": "[Output Only] The range of internal IPv6 addresses that are owned by this subnetwork.",
           "type": "string"
@@ -61629,6 +61736,20 @@
           "description": "[Output Only] Server-defined URL for this resource with the resource id.",
           "type": "string"
         },
+        "stackType": {
+          "description": "The stack type for this subnet to identify whether the IPv6 feature is enabled or not. If not specified IPV4_ONLY will be used.\n\nThis field can be both set at resource creation time and updated using patch.",
+          "enum": [
+            "IPV4_IPV6",
+            "IPV4_ONLY",
+            "UNSPECIFIED_STACK_TYPE"
+          ],
+          "enumDescriptions": [
+            "",
+            "",
+            ""
+          ],
+          "type": "string"
+        },
         "state": {
           "description": "[Output Only] The state of the subnetwork, which can be one of READY or DRAINING. A subnetwork that is READY is ready to be used. The state of DRAINING is only applicable to subnetworks that have the purpose set to INTERNAL_HTTPS_LOAD_BALANCER and indicates that connections to the load balancer are being drained. A subnetwork that is draining cannot be used or modified until it reaches a status of READY.",
           "enum": [