google-api-python-client 2.154.0__py2.py3-none-any.whl → 2.156.0__py2.py3-none-any.whl

googleapiclient/discovery_cache/documents/networkmanagement.v1.json

@@ -464,7 +464,7 @@
 "operations": {
 "methods": {
 "cancel": {
-"description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of 1, corresponding to `Code.CANCELLED`.",
+"description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.",
 "flatPath": "v1/projects/{projectsId}/locations/global/operations/{operationsId}:cancel",
 "httpMethod": "POST",
 "id": "networkmanagement.projects.locations.global.operations.cancel",
@@ -585,13 +585,180 @@
 }
 }
 }
+},
+"vpcFlowLogsConfigs": {
+"methods": {
+"create": {
+"description": "Creates a new `VpcFlowLogsConfig`. If a configuration with the exact same settings already exists (even if the ID is different), the creation fails. Notes: 1. Creating a configuration with state=DISABLED will fail 2. The following fields are not considered as `settings` for the purpose of the check mentioned above, therefore - creating another configuration with the same fields but different values for the following fields will fail as well: * name * create_time * update_time * labels * description",
+"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/vpcFlowLogsConfigs",
+"httpMethod": "POST",
+"id": "networkmanagement.projects.locations.vpcFlowLogsConfigs.create",
+"parameterOrder": [
+"parent"
+],
+"parameters": {
+"parent": {
+"description": "Required. The parent resource of the VPC Flow Logs configuration to create: `projects/{project_id}/locations/global`",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+$",
+"required": true,
+"type": "string"
+},
+"vpcFlowLogsConfigId": {
+"description": "Required. ID of the `VpcFlowLogsConfig`.",
+"location": "query",
+"type": "string"
+}
+},
+"path": "v1/{+parent}/vpcFlowLogsConfigs",
+"request": {
+"$ref": "VpcFlowLogsConfig"
+},
+"response": {
+"$ref": "Operation"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+},
+"delete": {
+"description": "Deletes a specific `VpcFlowLogsConfig`.",
+"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/vpcFlowLogsConfigs/{vpcFlowLogsConfigsId}",
+"httpMethod": "DELETE",
+"id": "networkmanagement.projects.locations.vpcFlowLogsConfigs.delete",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Required. `VpcFlowLogsConfig` resource name using the form: `projects/{project_id}/locations/global/vpcFlowLogsConfigs/{vpc_flow_logs_config}`",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+/vpcFlowLogsConfigs/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v1/{+name}",
+"response": {
+"$ref": "Operation"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+},
+"get": {
+"description": "Gets the details of a specific `VpcFlowLogsConfig`.",
+"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/vpcFlowLogsConfigs/{vpcFlowLogsConfigsId}",
+"httpMethod": "GET",
+"id": "networkmanagement.projects.locations.vpcFlowLogsConfigs.get",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Required. `VpcFlowLogsConfig` resource name using the form: `projects/{project_id}/locations/global/vpcFlowLogsConfigs/{vpc_flow_logs_config}`",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+/vpcFlowLogsConfigs/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v1/{+name}",
+"response": {
+"$ref": "VpcFlowLogsConfig"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+},
+"list": {
+"description": "Lists all `VpcFlowLogsConfigs` in a given project.",
+"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/vpcFlowLogsConfigs",
+"httpMethod": "GET",
+"id": "networkmanagement.projects.locations.vpcFlowLogsConfigs.list",
+"parameterOrder": [
+"parent"
+],
+"parameters": {
+"filter": {
+"description": "Optional. Lists the `VpcFlowLogsConfigs` that match the filter expression. A filter expression must use the supported [CEL logic operators] (https://cloud.google.com/vpc/docs/about-flow-logs-records#supported_cel_logic_operators).",
+"location": "query",
+"type": "string"
+},
+"orderBy": {
+"description": "Optional. Field to use to sort the list.",
+"location": "query",
+"type": "string"
+},
+"pageSize": {
+"description": "Optional. Number of `VpcFlowLogsConfigs` to return.",
+"format": "int32",
+"location": "query",
+"type": "integer"
+},
+"pageToken": {
+"description": "Optional. Page token from an earlier query, as returned in `next_page_token`.",
+"location": "query",
+"type": "string"
+},
+"parent": {
+"description": "Required. The parent resource of the VpcFlowLogsConfig: `projects/{project_id}/locations/global`",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v1/{+parent}/vpcFlowLogsConfigs",
+"response": {
+"$ref": "ListVpcFlowLogsConfigsResponse"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+},
+"patch": {
+"description": "Updates an existing `VpcFlowLogsConfig`. If a configuration with the exact same settings already exists (even if the ID is different), the creation fails. Notes: 1. Updating a configuration with state=DISABLED will fail. 2. The following fields are not considered as `settings` for the purpose of the check mentioned above, therefore - updating another configuration with the same fields but different values for the following fields will fail as well: * name * create_time * update_time * labels * description",
+"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/vpcFlowLogsConfigs/{vpcFlowLogsConfigsId}",
+"httpMethod": "PATCH",
+"id": "networkmanagement.projects.locations.vpcFlowLogsConfigs.patch",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Identifier. Unique name of the configuration using the form: `projects/{project_id}/locations/global/vpcFlowLogsConfigs/{vpc_flow_logs_config_id}`",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+/vpcFlowLogsConfigs/[^/]+$",
+"required": true,
+"type": "string"
+},
+"updateMask": {
+"description": "Required. Mask of fields to update. At least one path must be supplied in this field.",
+"format": "google-fieldmask",
+"location": "query",
+"type": "string"
+}
+},
+"path": "v1/{+name}",
+"request": {
+"$ref": "VpcFlowLogsConfig"
+},
+"response": {
+"$ref": "Operation"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+}
+}
 }
 }
 }
 }
 }
 },
-"revision": "20241106",
+"revision": "20241210",
 "rootUrl": "https://networkmanagement.googleapis.com/",
 "schemas": {
 "AbortInfo": {
@@ -1003,6 +1170,15 @@ false
 },
 "type": "array"
 },
+"returnReachabilityDetails": {
+"$ref": "ReachabilityDetails",
+"description": "Output only. The reachability details of this test from the latest run for the return path. The details are updated when creating a new test, updating an existing test, or triggering a one-time rerun of an existing test.",
+"readOnly": true
+},
+"roundTrip": {
+"description": "Whether run analysis for the return path from destination to source. Default value is false.",
+"type": "boolean"
+},
 "source": {
 "$ref": "Endpoint",
 "description": "Required. Source specification of the Connectivity Test. You can use a combination of source IP address, virtual machine (VM) instance, or Compute Engine network to uniquely identify the source location. Examples: If the source IP address is an internal IP address within a Google Cloud Virtual Private Cloud (VPC) network, then you must also specify the VPC network. Otherwise, specify the VM instance, which already contains its internal IP address and VPC network information. If the source of the test is within an on-premises network, then you must provide the destination VPC network. If the source endpoint is a Compute Engine VM instance with multiple network interfaces, the instance itself is not sufficient to identify the endpoint. So, you must also specify the source IP address or VPC network. A reachability analysis proceeds even if the source location is ambiguous. However, the test result may include endpoints that you don't intend to test."
@@ -1881,6 +2057,31 @@ false
 },
 "type": "object"
 },
+"ListVpcFlowLogsConfigsResponse": {
+"description": "Response for the `ListVpcFlowLogsConfigs` method.",
+"id": "ListVpcFlowLogsConfigsResponse",
+"properties": {
+"nextPageToken": {
+"description": "Page token to fetch the next set of configurations.",
+"type": "string"
+},
+"unreachable": {
+"description": "Locations that could not be reached (when querying all locations with `-`).",
+"items": {
+"type": "string"
+},
+"type": "array"
+},
+"vpcFlowLogsConfigs": {
+"description": "List of VPC Flow Log configurations.",
+"items": {
+"$ref": "VpcFlowLogsConfig"
+},
+"type": "array"
+}
+},
+"type": "object"
+},
 "LoadBalancerBackend": {
 "description": "For display only. Metadata associated with a specific load balancer backend.",
 "id": "LoadBalancerBackend",
@@ -2525,11 +2726,12 @@ false
 "id": "RouteInfo",
 "properties": {
 "advertisedRouteNextHopUri": {
-"description": "For advertised routes, the URI of their next hop, i.e. the URI of the hybrid endpoint (VPN tunnel, Interconnect attachment, NCC router appliance) the advertised prefix is advertised through, or URI of the source peered network.",
+"deprecated": true,
+"description": "For ADVERTISED routes, the URI of their next hop, i.e. the URI of the hybrid endpoint (VPN tunnel, Interconnect attachment, NCC router appliance) the advertised prefix is advertised through, or URI of the source peered network. Deprecated in favor of the next_hop_uri field, not used in new tests.",
 "type": "string"
 },
 "advertisedRouteSourceRouterUri": {
-"description": "For advertised dynamic routes, the URI of the Cloud Router that advertised the corresponding IP prefix.",
+"description": "For ADVERTISED dynamic routes, the URI of the Cloud Router that advertised the corresponding IP prefix.",
 "type": "string"
 },
 "destIpRange": {
@@ -2537,7 +2739,7 @@ false
 "type": "string"
 },
 "destPortRanges": {
-"description": "Destination port ranges of the route. Policy based routes only.",
+"description": "Destination port ranges of the route. POLICY_BASED routes only.",
 "items": {
 "type": "string"
 },
@@ -2554,20 +2756,29 @@ false
 },
 "type": "array"
 },
+"nccHubRouteUri": {
+"description": "For PEERING_SUBNET and PEERING_DYNAMIC routes that are advertised by NCC Hub, the URI of the corresponding route in NCC Hub's routing table.",
+"type": "string"
+},
 "nccHubUri": {
-"description": "URI of a NCC Hub. NCC_HUB routes only.",
+"description": "URI of the NCC Hub the route is advertised by. PEERING_SUBNET and PEERING_DYNAMIC routes that are advertised by NCC Hub only.",
 "type": "string"
 },
 "nccSpokeUri": {
-"description": "URI of a NCC Spoke. NCC_HUB routes only.",
+"description": "URI of the destination NCC Spoke. PEERING_SUBNET and PEERING_DYNAMIC routes that are advertised by NCC Hub only.",
 "type": "string"
 },
 "networkUri": {
-"description": "URI of a Compute Engine network. NETWORK routes only.",
+"description": "URI of a VPC network where route is located.",
 "type": "string"
 },
 "nextHop": {
-"description": "Next hop of the route.",
+"deprecated": true,
+"description": "String type of the next hop of the route (for example, \"VPN tunnel\"). Deprecated in favor of the next_hop_type and next_hop_uri fields, not used in new tests.",
+"type": "string"
+},
+"nextHopNetworkUri": {
+"description": "URI of a VPC network where the next hop resource is located.",
 "type": "string"
 },
 "nextHopType": {
@@ -2592,36 +2803,49 @@ false
 "Next hop is an IP address.",
 "Next hop is a Compute Engine instance.",
 "Next hop is a VPC network gateway.",
-"Next hop is a peering VPC.",
+"Next hop is a peering VPC. This scenario only happens when the user doesn't have permissions to the project where the next hop resource is located.",
 "Next hop is an interconnect.",
 "Next hop is a VPN tunnel.",
 "Next hop is a VPN gateway. This scenario only happens when tracing connectivity from an on-premises network to Google Cloud through a VPN. The analysis simulates a packet departing from the on-premises network through a VPN tunnel and arriving at a Cloud VPN gateway.",
 "Next hop is an internet gateway.",
-"Next hop is blackhole; that is, the next hop either does not exist or is not running.",
+"Next hop is blackhole; that is, the next hop either does not exist or is unusable.",
 "Next hop is the forwarding rule of an Internal Load Balancer.",
 "Next hop is a [router appliance instance](https://cloud.google.com/network-connectivity/docs/network-connectivity-center/concepts/ra-overview).",
-"Next hop is an NCC hub."
+"Next hop is an NCC hub. This scenario only happens when the user doesn't have permissions to the project where the next hop resource is located."
 ],
 "type": "string"
 },
+"nextHopUri": {
+"description": "URI of the next hop resource.",
+"type": "string"
+},
+"originatingRouteDisplayName": {
+"description": "For PEERING_SUBNET, PEERING_STATIC and PEERING_DYNAMIC routes, the name of the originating SUBNET/STATIC/DYNAMIC route.",
+"type": "string"
+},
+"originatingRouteUri": {
+"description": "For PEERING_SUBNET and PEERING_STATIC routes, the URI of the originating SUBNET/STATIC route.",
+"type": "string"
+},
 "priority": {
 "description": "Priority of the route.",
 "format": "int32",
 "type": "integer"
 },
 "protocols": {
-"description": "Protocols of the route. Policy based routes only.",
+"description": "Protocols of the route. POLICY_BASED routes only.",
 "items": {
 "type": "string"
 },
 "type": "array"
 },
 "region": {
-"description": "Region of the route (if applicable).",
+"description": "Region of the route. DYNAMIC, PEERING_DYNAMIC, POLICY_BASED and ADVERTISED routes only. If set for POLICY_BASED route, this is a region of VLAN attachments for Cloud Interconnect the route applies to.",
 "type": "string"
 },
 "routeScope": {
-"description": "Indicates where route is applicable.",
+"deprecated": true,
+"description": "Indicates where route is applicable. Deprecated, routes with NCC_HUB scope are not included in the trace in new tests.",
 "enum": [
 "ROUTE_SCOPE_UNSPECIFIED",
 "NETWORK",
@@ -2652,27 +2876,27 @@ false
 "Route is a subnet route automatically created by the system.",
 "Static route created by the user, including the default route to the internet.",
 "Dynamic route exchanged between BGP peers.",
-"A subnet route received from peering network.",
+"A subnet route received from peering network or NCC Hub.",
 "A static route received from peering network.",
-"A dynamic route received from peering network.",
+"A dynamic route received from peering network or NCC Hub.",
 "Policy based route.",
 "Advertised route. Synthetic route which is used to transition from the StartFromPrivateNetwork state in Connectivity tests."
 ],
 "type": "string"
 },
 "srcIpRange": {
-"description": "Source IP address range of the route. Policy based routes only.",
+"description": "Source IP address range of the route. POLICY_BASED routes only.",
 "type": "string"
 },
 "srcPortRanges": {
-"description": "Source port ranges of the route. Policy based routes only.",
+"description": "Source port ranges of the route. POLICY_BASED routes only.",
 "items": {
 "type": "string"
 },
 "type": "array"
 },
 "uri": {
-"description": "URI of a route (if applicable).",
+"description": "URI of a route. SUBNET, STATIC, PEERING_SUBNET (only for peering network) and POLICY_BASED routes only.",
 "type": "string"
 }
 },
@@ -3053,6 +3277,131 @@ false
 },
 "type": "object"
 },
+"VpcFlowLogsConfig": {
+"description": "A configuration to generate VPC Flow Logs.",
+"id": "VpcFlowLogsConfig",
+"properties": {
+"aggregationInterval": {
+"description": "Optional. The aggregation interval for the logs. Default value is INTERVAL_5_SEC.",
+"enum": [
+"AGGREGATION_INTERVAL_UNSPECIFIED",
+"INTERVAL_5_SEC",
+"INTERVAL_30_SEC",
+"INTERVAL_1_MIN",
+"INTERVAL_5_MIN",
+"INTERVAL_10_MIN",
+"INTERVAL_15_MIN"
+],
+"enumDescriptions": [
+"If not specified, will default to INTERVAL_5_SEC.",
+"Aggregate logs in 5s intervals.",
+"Aggregate logs in 30s intervals.",
+"Aggregate logs in 1m intervals.",
+"Aggregate logs in 5m intervals.",
+"Aggregate logs in 10m intervals.",
+"Aggregate logs in 15m intervals."
+],
+"type": "string"
+},
+"createTime": {
+"description": "Output only. The time the config was created.",
+"format": "google-datetime",
+"readOnly": true,
+"type": "string"
+},
+"description": {
+"description": "Optional. The user-supplied description of the VPC Flow Logs configuration. Maximum of 512 characters.",
+"type": "string"
+},
+"filterExpr": {
+"description": "Optional. Export filter used to define which VPC Flow Logs should be logged.",
+"type": "string"
+},
+"flowSampling": {
+"description": "Optional. The value of the field must be in (0, 1]. The sampling rate of VPC Flow Logs where 1.0 means all collected logs are reported. Setting the sampling rate to 0.0 is not allowed. If you want to disable VPC Flow Logs, use the state field instead. Default value is 1.0.",
+"format": "float",
+"type": "number"
+},
+"interconnectAttachment": {
+"description": "Traffic will be logged from the Interconnect Attachment. Format: projects/{project_id}/regions/{region}/interconnectAttachments/{name}",
+"type": "string"
+},
+"labels": {
+"additionalProperties": {
+"type": "string"
+},
+"description": "Optional. Resource labels to represent user-provided metadata.",
+"type": "object"
+},
+"metadata": {
+"description": "Optional. Configures whether all, none or a subset of metadata fields should be added to the reported VPC flow logs. Default value is INCLUDE_ALL_METADATA.",
+"enum": [
+"METADATA_UNSPECIFIED",
+"INCLUDE_ALL_METADATA",
+"EXCLUDE_ALL_METADATA",
+"CUSTOM_METADATA"
+],
+"enumDescriptions": [
+"If not specified, will default to INCLUDE_ALL_METADATA.",
+"Include all metadata fields.",
+"Exclude all metadata fields.",
+"Include only custom fields (specified in metadata_fields)."
+],
+"type": "string"
+},
+"metadataFields": {
+"description": "Optional. Custom metadata fields to include in the reported VPC flow logs. Can only be specified if \"metadata\" was set to CUSTOM_METADATA.",
+"items": {
+"type": "string"
+},
+"type": "array"
+},
+"name": {
+"description": "Identifier. Unique name of the configuration using the form: `projects/{project_id}/locations/global/vpcFlowLogsConfigs/{vpc_flow_logs_config_id}`",
+"type": "string"
+},
+"state": {
+"description": "Optional. The state of the VPC Flow Log configuration. Default value is ENABLED. When creating a new configuration, it must be enabled.",
+"enum": [
+"STATE_UNSPECIFIED",
+"ENABLED",
+"DISABLED"
+],
+"enumDescriptions": [
+"If not specified, will default to ENABLED.",
+"When ENABLED, this configuration will generate logs.",
+"When DISABLED, this configuration will not generate logs."
+],
+"type": "string"
+},
+"targetResourceState": {
+"description": "Output only. A diagnostic bit - describes the state of the configured target resource for diagnostic purposes.",
+"enum": [
+"TARGET_RESOURCE_STATE_UNSPECIFIED",
+"TARGET_RESOURCE_EXISTS",
+"TARGET_RESOURCE_DOES_NOT_EXIST"
+],
+"enumDescriptions": [
+"Unspecified target resource state.",
+"Indicates that the target resource exists.",
+"Indicates that the target resource does not exist."
+],
+"readOnly": true,
+"type": "string"
+},
+"updateTime": {
+"description": "Output only. The time the config was updated.",
+"format": "google-datetime",
+"readOnly": true,
+"type": "string"
+},
+"vpnTunnel": {
+"description": "Traffic will be logged from the VPN Tunnel. Format: projects/{project_id}/regions/{region}/vpnTunnels/{name}",
+"type": "string"
+}
+},
+"type": "object"
+},
 "VpnGatewayInfo": {
 "description": "For display only. Metadata associated with a Compute Engine VPN gateway.",
 "id": "VpnGatewayInfo",