feat(networkconnectivity): update the API

#### networkconnectivity:v1alpha1 The following keys were changed: - schemas.InternalRange.properties.ipCidrRange.description - schemas.InternalRange.properties.prefixLength.description #### networkconnectivity:v1 The following keys were added: - schemas.ConsumerPscConfig.properties.producerInstanceId.deprecated - schemas.ConsumerPscConfig.properties.producerInstanceMetadata.additionalProperties.type - schemas.ConsumerPscConfig.properties.producerInstanceMetadata.description - schemas.ConsumerPscConfig.properties.producerInstanceMetadata.type - schemas.ConsumerPscConnection.properties.errorType.deprecated - schemas.ConsumerPscConnection.properties.producerInstanceId.deprecated - schemas.ConsumerPscConnection.properties.producerInstanceMetadata.additionalProperties.type - schemas.ConsumerPscConnection.properties.producerInstanceMetadata.description - schemas.ConsumerPscConnection.properties.producerInstanceMetadata.type - schemas.InternalRange.properties.migration.$ref - schemas.InternalRange.properties.migration.description - schemas.LinkedProducerVpcNetwork.description - schemas.LinkedProducerVpcNetwork.id - schemas.LinkedProducerVpcNetwork.properties.excludeExportRanges.description - schemas.LinkedProducerVpcNetwork.properties.excludeExportRanges.items.type - schemas.LinkedProducerVpcNetwork.properties.excludeExportRanges.type - schemas.LinkedProducerVpcNetwork.properties.network.description - schemas.LinkedProducerVpcNetwork.properties.network.type - schemas.LinkedProducerVpcNetwork.properties.peering.description - schemas.LinkedProducerVpcNetwork.properties.peering.type - schemas.LinkedProducerVpcNetwork.properties.producerNetwork.description - schemas.LinkedProducerVpcNetwork.properties.producerNetwork.readOnly - schemas.LinkedProducerVpcNetwork.properties.producerNetwork.type - schemas.LinkedProducerVpcNetwork.properties.serviceConsumerVpcSpoke.description - schemas.LinkedProducerVpcNetwork.properties.serviceConsumerVpcSpoke.readOnly - schemas.LinkedProducerVpcNetwork.properties.serviceConsumerVpcSpoke.type - schemas.LinkedProducerVpcNetwork.type - schemas.Migration.description - schemas.Migration.id - schemas.Migration.properties.source.description - schemas.Migration.properties.source.type - schemas.Migration.properties.target.description - schemas.Migration.properties.target.type - schemas.Migration.type - schemas.PscConnection.properties.errorType.deprecated - schemas.PscConnection.properties.producerInstanceId.deprecated - schemas.PscConnection.properties.producerInstanceMetadata.additionalProperties.type - schemas.PscConnection.properties.producerInstanceMetadata.description - schemas.PscConnection.properties.producerInstanceMetadata.type - schemas.PscConnection.properties.serviceClass.description - schemas.PscConnection.properties.serviceClass.readOnly - schemas.PscConnection.properties.serviceClass.type - schemas.Spoke.properties.linkedProducerVpcNetwork.$ref - schemas.Spoke.properties.linkedProducerVpcNetwork.description The following keys were changed: - schemas.ConsumerPscConfig.properties.producerInstanceId.description - schemas.ConsumerPscConnection.properties.producerInstanceId.description - schemas.ConsumerPscConnection.properties.state.enumDescriptions - schemas.InternalRange.properties.ipCidrRange.description - schemas.InternalRange.properties.prefixLength.description - schemas.InternalRange.properties.usage.enum - schemas.InternalRange.properties.usage.enumDescriptions - schemas.LinkedInterconnectAttachments.properties.includeImportRanges.description - schemas.LinkedRouterApplianceInstances.properties.includeImportRanges.description - schemas.LinkedVpnTunnels.properties.includeImportRanges.description - schemas.PscConnection.properties.error.description - schemas.PscConnection.properties.producerInstanceId.description - schemas.PscConnection.properties.state.enumDescriptions - schemas.ServiceConnectionPolicy.properties.createTime.description - schemas.ServiceConnectionPolicy.properties.updateTime.description - schemas.Spoke.properties.spokeType.enum - schemas.Spoke.properties.spokeType.enumDescriptions - schemas.SpokeTypeCount.properties.spokeType.enum - schemas.SpokeTypeCount.properties.spokeType.enumDescriptions
googleapis · Oct 10, 2024 · 748ab35 · 748ab35
1 parent ccafbfe
commit 748ab35
Show file tree

Hide file tree

Showing 4 changed files with 190 additions and 36 deletions.
diff --git a/discovery/networkconnectivity-v1.json b/discovery/networkconnectivity-v1.json
@@ -2812,7 +2812,7 @@
       }
     }
   },
-  "revision": "20240807",
+  "revision": "20240923",
   "rootUrl": "https://networkconnectivity.googleapis.com/",
   "schemas": {
     "AcceptHubSpokeRequest": {
@@ -2942,9 +2942,17 @@
           "type": "string"
         },
         "producerInstanceId": {
-          "description": "Immutable. An immutable identifier for the producer instance.",
+          "deprecated": true,
+          "description": "Immutable. Deprecated. Use producer_instance_metadata instead. An immutable identifier for the producer instance.",
           "type": "string"
         },
+        "producerInstanceMetadata": {
+          "additionalProperties": {
+            "type": "string"
+          },
+          "description": "Immutable. An immutable map for the producer instance metadata.",
+          "type": "object"
+        },
         "project": {
           "description": "The consumer project where PSC connections are allowed to be created in.",
           "type": "string"
@@ -2994,6 +3002,7 @@
           "readOnly": true
         },
         "errorType": {
+          "deprecated": true,
           "description": "The error type indicates whether the error is consumer facing, producer facing or system internal.",
           "enum": [
             "CONNECTION_ERROR_TYPE_UNSPECIFIED",
@@ -3026,9 +3035,17 @@
           "type": "string"
         },
         "producerInstanceId": {
-          "description": "Immutable. An immutable identifier for the producer instance.",
+          "deprecated": true,
+          "description": "Immutable. Deprecated. Use producer_instance_metadata instead. An immutable identifier for the producer instance.",
           "type": "string"
         },
+        "producerInstanceMetadata": {
+          "additionalProperties": {
+            "type": "string"
+          },
+          "description": "Immutable. An immutable map for the producer instance metadata.",
+          "type": "object"
+        },
         "project": {
           "description": "The consumer project whose PSC forwarding rule is connected to the service attachments in this service connection map.",
           "type": "string"
@@ -3057,7 +3074,7 @@
           ],
           "enumDescriptions": [
             "An invalid state as the default case.",
-            "The connection is fully established and ready to use.",
+            "The connection has been created successfully. However, for the up-to-date connection status, please use the service attachment's \"ConnectedEndpoint.status\" as the source of truth.",
             "The connection is not functional since some resources on the connection fail to be created.",
             "The connection is being created.",
             "The connection is being deleted."
@@ -3451,7 +3468,7 @@
           "type": "string"
         },
         "ipCidrRange": {
-          "description": "The IP range that this internal range defines.",
+          "description": "The IP range that this internal range defines. NOTE: IPv6 ranges are limited to usage=EXTERNAL_TO_VPC and peering=FOR_SELF. NOTE: For IPv6 Ranges this field is compulsory, i.e. the address range must be specified explicitly.",
           "type": "string"
         },
         "labels": {
@@ -3461,6 +3478,10 @@
           "description": "User-defined labels.",
           "type": "object"
         },
+        "migration": {
+          "$ref": "Migration",
+          "description": "Optional. Should be present if usage is set to FOR_MIGRATION."
+        },
         "name": {
           "description": "Immutable. The name of an internal range. Format: projects/{project}/locations/{location}/internalRanges/{internal_range} See: https://google.aip.dev/122#fields-representing-resource-names",
           "type": "string"
@@ -3503,7 +3524,7 @@
           "type": "string"
         },
         "prefixLength": {
-          "description": "An alternate to ip_cidr_range. Can be set when trying to create a reservation that automatically finds a free range of the given size. If both ip_cidr_range and prefix_length are set, there is an error if the range sizes do not match. Can also be used during updates to change the range size.",
+          "description": "An alternate to ip_cidr_range. Can be set when trying to create an IPv4 reservation that automatically finds a free range of the given size. If both ip_cidr_range and prefix_length are set, there is an error if the range sizes do not match. Can also be used during updates to change the range size. NOTE: For IPv6 this field only works if ip_cidr_range is set as well, and both fields must match. In other words, with IPv6 this field only works as a redundant parameter.",
           "format": "int32",
           "type": "integer"
         },
@@ -3524,12 +3545,14 @@
           "enum": [
             "USAGE_UNSPECIFIED",
             "FOR_VPC",
-            "EXTERNAL_TO_VPC"
+            "EXTERNAL_TO_VPC",
+            "FOR_MIGRATION"
           ],
           "enumDescriptions": [
             "Unspecified usage is allowed in calls which identify the resource by other fields and do not need Usage set to complete. These are, i.e.: GetInternalRange and DeleteInternalRange. Usage needs to be specified explicitly in CreateInternalRange or UpdateInternalRange calls.",
             "A VPC resource can use the reserved CIDR block by associating it with the internal range resource if usage is set to FOR_VPC.",
-            "Ranges created with EXTERNAL_TO_VPC cannot be associated with VPC resources and are meant to block out address ranges for various use cases, like for example, usage on-prem, with dynamic route announcements via interconnect."
+            "Ranges created with EXTERNAL_TO_VPC cannot be associated with VPC resources and are meant to block out address ranges for various use cases, like for example, usage on-prem, with dynamic route announcements via interconnect.",
+            "Ranges created FOR_MIGRATION can be used to lock a CIDR range between a source and target subnet. If usage is set to FOR_MIGRATION the peering value has to be set to FOR_SELF or default to FOR_SELF when unset."
           ],
           "type": "string"
         },
@@ -3549,7 +3572,7 @@
       "id": "LinkedInterconnectAttachments",
       "properties": {
         "includeImportRanges": {
-          "description": "Optional. IP ranges allowed to be included during import from hub.(does not control transit connectivity) The only allowed value for now is \"ALL_IPV4_RANGES\".",
+          "description": "Optional. IP ranges allowed to be included during import from hub (does not control transit connectivity). The only allowed value for now is \"ALL_IPV4_RANGES\".",
           "items": {
             "type": "string"
           },
@@ -3574,12 +3597,44 @@
       },
       "type": "object"
     },
+    "LinkedProducerVpcNetwork": {
+      "description": "Next ID: 7",
+      "id": "LinkedProducerVpcNetwork",
+      "properties": {
+        "excludeExportRanges": {
+          "description": "Optional. IP ranges encompassing the subnets to be excluded from peering.",
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        },
+        "network": {
+          "description": "Immutable. The URI of the Service Consumer VPC that the Producer VPC is peered with.",
+          "type": "string"
+        },
+        "peering": {
+          "description": "Immutable. The name of the VPC peering between the Service Consumer VPC and the Producer VPC (defined in the Tenant project) which is added to the NCC hub. This peering must be in ACTIVE state.",
+          "type": "string"
+        },
+        "producerNetwork": {
+          "description": "Output only. The URI of the Producer VPC.",
+          "readOnly": true,
+          "type": "string"
+        },
+        "serviceConsumerVpcSpoke": {
+          "description": "Output only. The Service Consumer Network spoke.",
+          "readOnly": true,
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
     "LinkedRouterApplianceInstances": {
       "description": "A collection of router appliance instances. If you configure multiple router appliance instances to receive data from the same set of sites outside of Google Cloud, we recommend that you associate those instances with the same spoke.",
       "id": "LinkedRouterApplianceInstances",
       "properties": {
         "includeImportRanges": {
-          "description": "Optional. IP ranges allowed to be included during import from hub.(does not control transit connectivity) The only allowed value for now is \"ALL_IPV4_RANGES\".",
+          "description": "Optional. IP ranges allowed to be included during import from hub (does not control transit connectivity). The only allowed value for now is \"ALL_IPV4_RANGES\".",
           "items": {
             "type": "string"
           },
@@ -3642,7 +3697,7 @@
       "id": "LinkedVpnTunnels",
       "properties": {
         "includeImportRanges": {
-          "description": "Optional. IP ranges allowed to be included during import from hub.(does not control transit connectivity) The only allowed value for now is \"ALL_IPV4_RANGES\".",
+          "description": "Optional. IP ranges allowed to be included during import from hub (does not control transit connectivity). The only allowed value for now is \"ALL_IPV4_RANGES\".",
           "items": {
             "type": "string"
           },
@@ -4068,6 +4123,21 @@
       },
       "type": "object"
     },
+    "Migration": {
+      "description": "Specification for migration with source and target resource names.",
+      "id": "Migration",
+      "properties": {
+        "source": {
+          "description": "Immutable. Resource path as an URI of the source resource, for example a subnet. The project for the source resource should match the project for the InternalRange. An example: /projects/{project}/regions/{region}/subnetworks/{subnet}",
+          "type": "string"
+        },
+        "target": {
+          "description": "Immutable. Resource path of the target resource. The target project can be different, as in the cases when migrating to peer networks. The resource For example: /projects/{project}/regions/{region}/subnetworks/{subnet}",
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
     "NextHopInterconnectAttachment": {
       "description": "A route next hop that leads to an interconnect attachment resource.",
       "id": "NextHopInterconnectAttachment",
@@ -4367,14 +4437,15 @@
         "error": {
           "$ref": "GoogleRpcStatus",
           "deprecated": true,
-          "description": "The most recent error during operating this connection."
+          "description": "The most recent error during operating this connection. Deprecated, please use error_info instead."
         },
         "errorInfo": {
           "$ref": "GoogleRpcErrorInfo",
           "description": "Output only. The error info for the latest error during operating this connection.",
           "readOnly": true
         },
         "errorType": {
+          "deprecated": true,
           "description": "The error type indicates whether the error is consumer facing, producer facing or system internal.",
           "enum": [
             "CONNECTION_ERROR_TYPE_UNSPECIFIED",
@@ -4395,9 +4466,17 @@
           "type": "string"
         },
         "producerInstanceId": {
-          "description": "Immutable. An immutable identifier for the producer instance.",
+          "deprecated": true,
+          "description": "Immutable. Deprecated. Use producer_instance_metadata instead. An immutable identifier for the producer instance.",
           "type": "string"
         },
+        "producerInstanceMetadata": {
+          "additionalProperties": {
+            "type": "string"
+          },
+          "description": "Immutable. An immutable map for the producer instance metadata.",
+          "type": "object"
+        },
         "pscConnectionId": {
           "description": "The PSC connection id of the PSC forwarding rule.",
           "type": "string"
@@ -4407,6 +4486,11 @@
           "readOnly": true,
           "type": "string"
         },
+        "serviceClass": {
+          "description": "Output only. [Output only] The service class associated with this PSC Connection. The value is derived from the SCPolicy and matches the service class name provided by the customer.",
+          "readOnly": true,
+          "type": "string"
+        },
         "state": {
           "description": "State of the PSC Connection",
           "enum": [
@@ -4418,7 +4502,7 @@
           ],
           "enumDescriptions": [
             "An invalid state as the default case.",
-            "The connection is fully established and ready to use.",
+            "The connection has been created successfully. However, for the up-to-date connection status, please use the created forwarding rule's \"PscConnectionStatus\" as the source of truth.",
             "The connection is not functional since some resources on the connection fail to be created.",
             "The connection is being created.",
             "The connection is being deleted."
@@ -4882,7 +4966,7 @@
       "id": "ServiceConnectionPolicy",
       "properties": {
         "createTime": {
-          "description": "Output only. Time when the ServiceConnectionMap was created.",
+          "description": "Output only. Time when the ServiceConnectionPolicy was created.",
           "format": "google-datetime",
           "readOnly": true,
           "type": "string"
@@ -4940,7 +5024,7 @@
           "type": "string"
         },
         "updateTime": {
-          "description": "Output only. Time when the ServiceConnectionMap was updated.",
+          "description": "Output only. Time when the ServiceConnectionPolicy was updated.",
           "format": "google-datetime",
           "readOnly": true,
           "type": "string"
@@ -5050,6 +5134,10 @@
           "$ref": "LinkedInterconnectAttachments",
           "description": "VLAN attachments that are associated with the spoke."
         },
+        "linkedProducerVpcNetwork": {
+          "$ref": "LinkedProducerVpcNetwork",
+          "description": "Optional. The linked producer VPC that is associated with the spoke."
+        },
         "linkedRouterApplianceInstances": {
           "$ref": "LinkedRouterApplianceInstances",
           "description": "Router appliance instances that are associated with the spoke."
@@ -5081,14 +5169,16 @@
             "VPN_TUNNEL",
             "INTERCONNECT_ATTACHMENT",
             "ROUTER_APPLIANCE",
-            "VPC_NETWORK"
+            "VPC_NETWORK",
+            "PRODUCER_VPC_NETWORK"
           ],
           "enumDescriptions": [
             "Unspecified spoke type.",
             "Spokes associated with VPN tunnels.",
             "Spokes associated with VLAN attachments.",
             "Spokes associated with router appliance instances.",
-            "Spokes associated with VPC networks."
+            "Spokes associated with VPC networks.",
+            "Spokes that are backed by a producer VPC network."
           ],
           "readOnly": true,
           "type": "string"
@@ -5254,14 +5344,16 @@
             "VPN_TUNNEL",
             "INTERCONNECT_ATTACHMENT",
             "ROUTER_APPLIANCE",
-            "VPC_NETWORK"
+            "VPC_NETWORK",
+            "PRODUCER_VPC_NETWORK"
           ],
           "enumDescriptions": [
             "Unspecified spoke type.",
             "Spokes associated with VPN tunnels.",
             "Spokes associated with VLAN attachments.",
             "Spokes associated with router appliance instances.",
-            "Spokes associated with VPC networks."
+            "Spokes associated with VPC networks.",
+            "Spokes that are backed by a producer VPC network."
           ],
           "readOnly": true,
           "type": "string"

diff --git a/discovery/networkconnectivity-v1alpha1.json b/discovery/networkconnectivity-v1alpha1.json
@@ -1116,7 +1116,7 @@
       }
     }
   },
-  "revision": "20240807",
+  "revision": "20240911",
   "rootUrl": "https://networkconnectivity.googleapis.com/",
   "schemas": {
     "AuditConfig": {
@@ -1383,7 +1383,7 @@
           "type": "string"
         },
         "ipCidrRange": {
-          "description": "IP range that this internal range defines.",
+          "description": "IP range that this internal range defines. NOTE: IPv6 ranges are limited to usage=EXTERNAL_TO_VPC and peering=FOR_SELF. NOTE: For IPv6 Ranges this field is compulsory, i.e. the address range must be specified explicitly.",
           "type": "string"
         },
         "labels": {
@@ -1439,7 +1439,7 @@
           "type": "string"
         },
         "prefixLength": {
-          "description": "An alternative to ip_cidr_range. Can be set when trying to create a reservation that automatically finds a free range of the given size. If both ip_cidr_range and prefix_length are set, there is an error if the range sizes do not match. Can also be used during updates to change the range size.",
+          "description": "An alternative to ip_cidr_range. Can be set when trying to create an IPv4 reservation that automatically finds a free range of the given size. If both ip_cidr_range and prefix_length are set, there is an error if the range sizes do not match. Can also be used during updates to change the range size. NOTE: For IPv6 this field only works if ip_cidr_range is set as well, and both fields must match. In other words, with IPv6 this field only works as a redundant parameter.",
           "format": "int32",
           "type": "integer"
         },